pandorafms/pandora_doc/fr/man/pandora_console

.TH pandora_console

.SH NAME

pandora_console - PandoraFMS web application

.SH AVAILABILITY

Linux, AIX, Solaris

.SH DESCRIPTION

The Web Console is a web application that allows to see graphical reports, state of every agent, also to
access to the information sent by the agent, to see every monitored parameter and to see its evolution
throughout the time, to form the different nodes, groups and users of the system. It is the part that
interacts with the final user, and that will allows you to administer the system.

The Web Console is written in PHP and no plug-in, Flash, Java or ActiveX is needed to access the
console, only a browser that supports HTML and CSS (IE5+ or Mozilla 4+). Pandora Web Console can
run in several servers, the only thing you need is to be allow to access Pandora Database, where Pandora
stores all the information.


.SH SYPNOSIS
.B Pandora Console and Pandora database
.br

.I  Pandora database install

Please look at MySQL install and management guide (http://dev.mysql.com/doc) to obtain information
about how to create a MySQL database, how to manage mysql users and give him/her privileges to
read/write in Pandora database. Remember that you must write the password of the root user in MySQL
database to enter mysql command line. This user is not the same of the Operating System. The root
password in MySQL is in blank by default (within almost all distributions), you must changed this
password with the MySQL command mysqladmin. Please be careful with this.
You need a database with name "pandora", you could rename it, but you need to reconfigure in server too.
To create the structure of Pandora database in MySQL Server you have the SQL script "pandoradb.sql".
It creates tables and indexes needed to insert information into Pandora database.
You MUST populate database with SQL script "pandoradb_data.sql",
it inserts data needed to run Web Console and default user (login: admin, pass: pandora) to access Pandora Web Console.
First create a database called "pandora", and set an user to be able to access this database:
.I mysql> create database pandora;
.br
Later, execute the next commands using a user with enough privileges to create tables and indexes for
pandora Database into your MySQL Server:
Designed to be open, modular, multiplattform and easy to customize.

.I cat pandoradb.sql | mysql -D pandora -u root -p

.I cat pandoradb_data.sql | mysql -D pandora -u root -p

You can also use the source command, if you are connected to MySQL, from the MySQL prompt:

.I  mysql> use pandora
.br
.I  mysql> source path_to_pandora_dbstruct.sql
.br
.I  mysql> source path_to_pandora_dbdata.sql

This example is valid using root user in MySQL
Now we will create an user "pandora" and will be given to it privileges from the localhost:

.I mysql> grant all on pandora.* to ’pandora’@’localhost’ identified by ’pandora’;

Keep in mind that users need access from Pandora WEB Console and from Pandora Server, if your
deployment has many subcomponents in different physical machines, you need to setup a MySQL user
with privileges to access from different locations.

If you get the error "Warning: mysql_connect() [function.mysql-connect]: client does not support
authentication protocol requested by server; consider upgrading" when authenticating Web Console, you
have to change the way the password is stored into the database:

.I mysql> set password for ’pandora’@’localhost’ = old_password(’pandora’);

Please note this user will be used by several pandora subcomponents (Pandora Server, Pandora Web
Console) to access database.

.B Pandora console install 

Prior to install Pandora console, you need the following dependencies and software needed:

.I Web server. Apache2 is recommended

.I PHP 4.3.x, or PHP 5.x. Both has been tested for Pandora 1.2

.I PHP Modules for MySQL, GD, session management and SNMP.

.I JpGraph, it is necesary to generate graphics. It has an open source license, you can download it in
http://www.aditus.nu/jpgraph/

To install Pandora Console, simply untar in your HTTP server publishing directory and set perms to
www-data or http user.

To setup Pandora Console, you only need to modify a file, include/config.php, where the following
variables are included in .php code:
.I $dbname="pandora";             // name of database for pandora)
.br
.I $dbuser="pandora";             // mysql user to access db
.br
.I $dbpassword="pandora";               // Password for mysql user
.br
.I $dbhost="pandora";             // Hostname or IP of mySQL server

If database is define and was correctly installed, you can now access:

.I    http://host:port/installdir/index.php

The first time you log there is a default admin user "admin" and password "pandora". It’s worth to say
that YOU MUST CHANGE CREDENTIALS BEFORE LOGIN FIRST TIME, change it or create another
account, give it administrator privileges, and disable this one.

If you cannot see the pandora console login page, it’s possible that you have problems with PHP instalation. When you
installed the Web, please check that PHP engine its running. Fist try to access to the server IP with a
browser. You must see the Welcome Apache page.

Remember that alter installing the PHP and the PHP module for Apache you must stop and start the
Server Apache. As an example, Ubuntu with Apache2:

.I     /etc/init.d/apache2 stop
  
.I   /etc/init.d/apache2 start
To verify the PHP and Apache integration you can create the file test.php with the following lines:

.I   <?PHP
.br 
.I    echo "<h1>TEST</h1>";
.br
.I     phpinfo();
.br
.I     ?>

Now, copy this file in the Apache HTTPDOC directory. This directory depend of the Operating System
or Linux Distribution, for example in Ubuntu this directory is /var/www and in SUSE is
/srv/www/htdocs), RedHat based distributions uses /var/www/html as well.

To check this integration, please use your browser to open the following URL:
.I     http://IP/test.php

Where IP is IP Address of your Apache server. If the integration is correct you will see in the browser a
text string with big font: “TEST” and a big table with a lot of info about your PHP installation.
2.3.2.1. Graphic reporting instalation

For correct graphic generation, you need to enter the full path to a TrueType font installed in your
system. By default a free truetype font is distributed with Pandora Console package, and placed in
./reporting/FreeSans.ttf file. Please check that setup directive $config_fontpath is well
configured.
Pandora 1.2 uses JpGraph for viewing graphics. JpGraph is a different project and has no relationship
with Pandora, so you need to install it. You can find at http://www.aditus.nu/jpgraph/.
Download last version (2.x), and place all .php files from src directory into reporting/jpgraph
Pandora Console directory.

.SH AUTHOR

Pandora Free Monitoring System is made and copyrighted by Sancho Lerena <sancho.lerena@artica.es>
Pandora is a project initiated and mainly developed by Sancho Lerena, at present other people is working
on it: Raul Mateos, David Villanueva, Esteban Sanchez, Jose Navarro, Jonathan Barajas and Manuel Arostegui We want to
thank many other people who help us with translation, graphic design, bugs reporting and interesting
ideas.
.br


.SH SEE ALSO

.B pandora
.br
.B pandora_server
.br
.B pandora_agents 
.br
.B pandora_console