Documentation AND architecture of the software

 
 

GRAPHICAL INTERFACE


  1. 1.INSTALLATION:


  2. Presently, installation of the Graphical Interface can’t be made otherwise than using packages built for some Linux distributions because I haven’t finished the script who can permit to install the Graphical Interface from the sources of the software.

  3. Beside, before installing the interface, you need to satisfy there following dependencies:


  4. -IDE Language Gambas v1.0.x (all packages are needed)

  5. -RRDtool v1.x

  6. -SNMP commands

  7. -SSHPASS


  8. Recall of installation commands:


  9.     Package RPM

  10.         rpm -ivh <filename .rpm>


  11.     Package Debian

  12.         dpkg -i <filename .deb>


              Installation directory:


                By default, the gbRRDGraphix  graphical interface itself in the directory:


                    /opt/Monitoring/gbRRDGraphix


              Configuration file: /opt/Monitoring/gbRRDGraphix/gbrrdgraphix.ini

                                    


  1. 2.CONFIGURATION:


  1. This is not necessary to modify the configuration file manually at the first stratup of the interface. Il at the startup of the software, a needed command was not found, an information panel will be displayed. Once the interface is started, It’s recommended to verify the Preferences Panel, available in the menu, if the interface is correctly configured.

  2. However, if you have installed some required components, not in the common directory, you will be obligate to modify manually. So, in this case, be careful, respect the syntax this file.



  1. 3.USAGE:



SCHEDULER (Updated):


  1. 4.INSTALLATION:


  2. For the moment, as the same of graphical interface installation, only the packages for some  Linux distributions are available to instal the Scheduler because I did not time to finish the script who can permit to instal it from the sources of  logiciels.

  3. Installation can be processed  only after satisfy all following dependencies:


  4. -RRDtool v1.x (command ‘rrdtool update’)

  5. -SNMP commands (command ‘snmpget’)


  6. Recall of installation commands:


                    Cf Graphical Interface Installation


              Installation directory:


                By default, the Scheduler ‘Updated itself in the directory:


                    /opt/Monitoring/Updated


              Configuration file: /opt/Monitoring/Updated/Updated.conf


              Start of the service: /etc/init.d/UpdatedScheduler start


              Stop then service: /etc/init.d/UpdatedScheduler stop



  1. 5.CONFIGURATION:


  1. The configuration file contain the list of all requests to process by the Scheduler.

  2. You can configure it manually respecting the syntax described in the header of the file, using the graphical interface, in the tab reserved to this case (Cf Panel of Scheduler management).

         

  1. For the moment, only SNMP requests are authorized over the Scheduler, but next It will be possible to update the ‘rrdtool’ databases by Unix scripts or by connection on remote machines by SSH protocol.



  1. 6.USAGE:



WEB SITE:


  1. 7.INSTALLATION:


  2. Installation of  Web interface is very easy and can be summarized by putting a directory on the hard drive with all the Web Site files.

  3.     

  4. The Web Site is  developed principally to work with Apache HTTP Server but you can use others Web Servers (using CGI scripts).

  5. If you have some difficulties during usage of the Web Site with a particular Web Server, contact me so that I can help you.

  6.     

  7. It’s possible to instal many Web  Sites on the same computer, simply by copying the origine directory to another directory as you choosed.

  8.     

  9. The number of Web Site is unlimited. But the directory where the CGI scripts are is common for all Web Site and it’s not necessary to duplicate it each time.

  10.     

  11. So, This is the necessary prerequisites:

  12.     

  13. -Apache HTTP Server or Other Web Server (+ CGI scripts)

  14.     

              Installation directory:


                By default, the Web Interface is installed in the directory:


                    /opt/Monitoring/www


              Configuration file: /opt/Monitoring/www/configuration_web


              CGI Scripts: /opt/Monitoring/cgi-bin/


              Web Site files: /opt/Monitoring/html/Web/   (Directory needed to be copied for multiple

                                                                                   Web Site)


              Login/Password file for Web Site: /opt/Monitoring/html/Web/config/.passwdaccess

                                                                                      

                    By default:

                            login: admin

                            Password: admin


             Script to generate password:

 

                                                        /opt/Monitoring/html/Web/config/passwordgenerate.pl




  1. 8.CONFIGURATION:


  1. The configuration file ‘configuration_web.conf must be moved in the directory of the Apache  HTTP Server (or others HTTP servers).


  2. The configuration of files of the Web Site can be realised with the gbRRDGraphix Graphical Interface (Tab ‘Gestion Site Web’).

  3.     

  4.      Impacted files:

  5.     

                   /opt/Monitoring/www/Web/config/cgi.conf

                   /opt/Monitoring/www/Web/config/equipement_details.conf


                   /opt/Monitoring/www/Web/js/Arbre.js


                   /opt/Monitoring/www/Web/index.html



  1.    Configuration of file rights for the Web Site:


  1. A) All of the Web Site should belong to the user associated Apache HTTP Server to respect the securities.


                   Example:

  1. User           Group        Other


  1. apache        apache


  1. RWX             RWX         -- -- --

 

  1. B)So that the Graphical Interface gbRRDGraphix can update some files of the Web Site, it’s necessary to belong to the User who lunch the Graphical Interface, the group’s Unix Users Apache.




                                                                UNDER CONSTRUCTION...

        SUMMARY

  1. 1.Installation

  2. 2.Configuration

  3. 3.Usage

  1. 4.Installation

  2. 5.Configuration

  3. 6.Usage

  1. 7.Installation

  2. 8.Configuration

  1. -Internal architecture schema of the gbRRDGraphix Pack

  2. -Schema of possibilities to Install all the gbRRDGraphix Pack

Internal architecture schema of the gbRRDGraphix Pack

Schema of possibilities to install all the gbRRDGraphix Pack