Pandora: QuickGuides EN: Update version 7.0NG

From Pandora FMS Wiki
Revision as of 13:05, 12 February 2020 by Laura.cano (talk | contribs) (Update Manager Offline)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

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.



QG Update1.png


You will see a message that shows your current version and whether there are new versions available. Click on Update.


QG Update2.png


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.


QG Update3.png


If there is a database update on that version, the wizard will notify you of a new available database update. Click on Apply MR.



QG Update4.png


If the MR was correctly applied, a message informing about the correct database update will be shown.


QG Update5.png


Finally, you will see a message saying that the console and database were correctly updated to the specified version.


QG Update6.png


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.



QG Update7.png


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.



QG Update8.png


It will indicate the package was uploaded correctly. Click on the green check at the bottom right corner to apply it.


QG Update9.png


A message will indicate there is a new version available for updating. Click on OK.


QG Update10.png


If there is a database update, the wizard will indicate there is a new database update available. Click on Apply MR.


QG Update11.png


A message indicating the database was correctly updated will appear.


QG Update13.png


Finally, a message indicating the console was correctly updated to the desired version will appear.


QG Update12.png


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


Template warning.png

To ensure the tool's proper working, both console and server must be in the same version.

 



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