Pandora: QuickGuides EN: Update version 7.0NG
Contents
1 Pandora FMS Enterprise 7.0NG Quick Update Guide
1.1 Introduction
Pandora FMS is structured based on three main elements:
- Pandora FMS Console
- Pandora FMS Server
- Database
These make up the application core and must be updated along each Pandora FMS version, where our developers add new features, improve the application and make it more stable.
The first element to be updated is Pandora FMS console, both its Community version as well as its Enterprise version. The database must be updated along this process. And once these two steps are completed, the Pandora FMS server must be updated to the same version applied to the Console.
1.2 Web Console + Database updating
The main recommended procedure to update the Web console and the database is through the Update Manager Online component.
1.2.1 Update Manager Online
It is necessary for Pandora FMS server to have connection to your Update Manager Online located at licensing.artica.es in order to apply the update by means of this method. If it does not, perform the process through the Update Manager Offline component.
To proceed with the update through these means, go to the Update Manager Online window from Pandora FMS console menu.
You will see a message that shows your current version and whether there are new versions available. Click on Update.
The following available version to the one installed on your environment will be downloaded from the update server. A message will inform you of a new available update. Click on Ok.
If there is a database update on that version, the wizard will notify you of a new available database update. Click on Apply MR.
If the MR was correctly applied, a message informing about the correct database update will be shown.
Finally, you will see a message saying that the console and database were correctly updated to the specified version.
If there is some problem throughout the whole process, carry out the installation process Console and database guide.
1.2.2 Update Manager Offline
The update process through Update Manager Offline is the same as the Online one but in this case for environments that have limited access to our update server. First of all, it is necessary to access the Update Manager Offline window from Pandora FMS console menu.
Here is when you have to know the Pandora FMS version you have installed. To find out, look at Pandora FMS console footer that will show the installed version. Download the OUM package corresponding to the next version to the one shown in the footer. If it shows you have the Pandora FMS v7.0NG.737 - Build 737 - MR 30 version, apply the OUM 738 package that you may download from the Downloads section in Pandora FMS support website. If it is necessary to apply more than one version, download all OUMs and apply them on this section in ascending order.
To apply the new OUM, click on Browse It and upload the .oum file of the version you wish to update to.
It will indicate the package was uploaded correctly. Click on the green check at the bottom right corner to apply it.
A message will indicate there is a new version available for updating. Click on OK.
If there is a database update, the wizard will indicate there is a new database update available. Click on Apply MR.
A message indicating the database was correctly updated will appear.
Finally, a message indicating the console was correctly updated to the desired version will appear.
If there is any problem along the process, carry out the installation process Console and database guide.
1.2.3 Manual console and database update
Follow this process only if updating was not possible through Update Manager due to some error throughout the process.
First, download the console packages. Download the community packages from Sourceforge and the Enterprise packages from the Downloads section in Pandora FMS official support website.
Choose the packages that match your Operative System and follow the process that corresponds to the downloaded packages:
1.2.3.1 From rpm packages ( CentOS / RedHat / SUSE )
rpm -U <open_console_package_name> .rpm rpm -U <enterprise_console_package_name> .rpm
1.2.3.2 From deb packages ( Debian / Ubuntu )
dpkg -i <open_console_package_name> .deb dpkg -i <enterprise_console_package_name> .deb
1.2.3.3 From tarball / sources ( Any OS )
tar xvzf <open_console_package_name> .tar.gz yes | cp -rf pandora_console/* /var/www/html/pandora_console tar xvzf <enterprise_console_package_name> .tar.gz yes | cp -rf enterprise/* /var/www/html/pandora_console/enterprise chown -R apache:apache /var/www/html/pandora_console
Once the Console update process is completed, proceed to database manual update.
1.2.3.4 Database update
Apply manually the MR files (minor release) one by one from the current version to that of the updated Web console. You may find the corresponding version in the following link :
cd /var/www/html/pandora_console/extras/mr/ cat <mr_number>.sql | mysql -u <db_user> -p -D <pandora_db_name>
Once the MRs are applied, modify the MR fields and current_package_enterprise in the tconfig table, where the versioning for Update Manager proper working is stored.
mysql -u -u<db_user> -p -D <pandora_db_name> UPDATE tconfig SET value = '<mr_number>' WHERE token = 'MR'; UPDATE tconfig SET value = '<pandora_version>' WHERE token = 'current_package_enterprise'; exit
Once applied, move all files to the folder "<APACHE_PATH>/pandora_console/extras/mr/updated/"
mv /var/www/html/pandora_console/extras/mr/*.sql /var/www/html/pandora_console/extras/mr/updated/
1.3 Pandora FMS server update
Once the console and database are updated, the last step is server updating.
1.3.1 Community server
Pandora FMS Community version corresponding packages can be downloaded from Sourceforge and updated through their corresponding execution:
1.3.1.1 From .rpm packages ( CentOS / RedHat / SUSE )
rpm -U <open_server_package_name> .rpm
1.3.1.2 From .deb packages ( Debian / Ubuntu )
dpkg -i <open_server_package_name> .deb
1.3.1.3 From tarball/sources (cualquier distribución )
tar -xvzf <open_server_package_name> .tar.gz cd pandora_server/ ./pandora_server_installer --install
1.3.2 Enterprise server
Once the Community version update is finished, install the Enterprise version that can be downloaded from the Downloads section in Pandora FMS official support website.
For Pandora FMS Enterprise version, in version 7.0, the Enterprise package is installed as binary.
[[email protected] tmp]# tar -xvzf pandorafms_server_enterprise_7.0NG_x86_64.tar.gz pandora_server/pandora_server pandora_server/pandora_server_installer pandora_server/PandoraFMS-Enterprise/bin/braa pandora_server/PandoraFMS-Enterprise/bin/pandora_db pandora_server/PandoraFMS-Enterprise/bin/braa pandora_server/PandoraFMS-Enterprise/bin/pandora_manage pandora_server/README [[email protected] tmp]# cd pandora_server/ [[email protected] pandora_server]# ./pandora_server_installer --install Pandora FMS Server Enterprise installer for GENERIC. (c) 2014-2016 Artica ST. >Installing the Pandora FMS Server Enterprise binary to /usr/bin... >Installing the pandora_exec binary to /usr/bin... >Copying missing perl libraries to the /usr/lib/perl5/PandoraFMS... >Copying missing scripts to /usr/share/pandora_server/util... >Installing the tentacle_server binary to /usr/bin... >Copying extra encoding definitions to /usr/share/pandora_server/enc... >Installing the pandora_db binary to /usr/bin... >Installing the pandora_manage binary to /usr/bin... >Installing the pandora_revent binary to /usr/bin... >Installing the pandora_encrypt_db binary to /usr/bin... >Installing the braa binary to /usr/bin... >Installing the enterprise recon scripts... >Executing Pandora Server Open installation script... >... Pandora FMS Server Installer 7.0NG 170324 (c) 2008-2016 Artica ST This program is licensed under GPL2 Terms. http://pandorafms.com GENERIC distribution detected Creating common Pandora FMS directories uid=500(pandora) gid=0(root) grupos=0(root) User pandora does exist, make sure the SSH directories are correct Giving proper permission to /var/spool/pandora Creating setup directory in /etc/pandora cp conf/pandora_server.conf.new /etc/pandora Installing Pandora Server manual Copying the daemon script into /etc/init.d Linking startup script to /etc/rc.d/rc5.d/S90pandora_server ln: creating symbolic link «/etc/rc.d/rc5.d/S90pandora_server»: El fichero ya existe Creating logrotate.d entry for Pandora FMS log management Copying the daemon script into /etc/init.d Linking startup script to /etc/rc.d/rc5.d/S80tentacle_serverd Installing Tentacle Server manual Creating Pandora FMS distribution directory in /usr/share/pandora_server Creating the Cron script to run Pandora DB tool each hour Now you have to edit your /etc/pandora/pandora_server.conf file to change the database password (default is pandora) with the one set in include/config.php of your Pandora FMS Console. After setting password you can start your Pandora FMS Server!! >... >Installed Open Pandora Server >Adding pandora_db to the crontab... Restart Pandora FMS Server.
Then restart the stopped processes.
#sytemctl restart pandora_server.service Pandora FMS Server 7.0NG Build 170324 Copyright (c) 2004-2015 ArticaST This program is OpenSource, licensed under the terms of GPL License version 2. You can download latest versions and documentation at http://www.pandorafms.org [*] Backgrounding Pandora FMS Server process. Pandora Server is now running with PID 8407 #sytemctl restart tentacle_serverd.service