Update

Introduction

There are two main ways to update Pandora FMS environment:

  • Warp Update.
  • Manually.

Warp Update is in charge of updating Pandora FMS Console, server and database automatically by means of wizards. It is the recommended option to update Pandora FMS.

In case you need to update Pandora FMS manually, you may apply the updates manually, just by following a more detailed and demanding but equally valid procedure.

Warp Update

Updates through Warp Update may be applied by means of two different wizards:

  • Warp Update Online: It is responsible for downloading and updating Pandora FMS server, console and database automatically. It requires internet connection to Pandora FMS repositories.
  • Warp Update Offline: It is responsible for updating Pandora FMS server, console and database automatically. Pandora FMS Server and Console packages should be entered manually in the console wizard to carry out the update. This is the best option for updating in environments with restricted and/or limited connections with Pandora FMS repositories.

This section will only be visible if Enable Warp Update is enabled in menu Management → Settings → System Settings → Advanced → Enable update manager.

Warp Update Online

To use the Warp Update Online, access the Management → Warp Update → Update Online menu. For its operation, Pandora FMS Console must have access to the official Pandora FMS online repositories.

To update through Warp Update Online, sign up with an e-mail address.

Once these previous requirements are met, it will show the current Pandora FMS version installed and the new versions to which it is possible to upgrade:

The release notes for each version available for upgrade will also be available through the Show details.

Only LTS versions and/or consecutive versions will be displayed depending on Warp configuration.

Once the version to be upgraded is selected, the wizard will start downloading and installing automatically.

Warp Update Offline

To use Warp Offline, access the Management → Warp Update → Update Offline menu. The Warp Offline does not require internet connection to perform updates. The administrator must manually download the packages and upload them to the wizard to perform the update.

When accessing this section, you will be prompted to enter an e-mail address and a unique access code related to the applied license will be displayed. It must be copied by clicking on the icon. The indicated link is accessed to open in a new tab of the web browser and enter the repository, pasting the code will log in to download the necessary files.

After logging in, it will indicate which Pandora FMS version is installed, which is the next available version and the last available version.

When you select the desired version, a dialog box will open to download the files needed to perform the upgrade.

  • File package_XXX_XXX.fms: It is responsible for updating the console and the database schema.
  • File pandorafms_server-XXXXX.tar.gz: It is responsible for updating the server.
  • File .sig: Signature of the above files used to corroborate that the package has not been modified.

Once the files have been downloaded, access the Warp Update Offline menu again and click Browse it to select file by file. Review the information displayed on the screen to see if it matches the updates and/or corrections. To process, click on the green icon in the lower right corner and wait for the Web Console to display the results of each process.

The size of each file must be smaller than specified in the token post_max_size and upload_max_filesize in the /etc/php.ini file.

It is recommended to update first the Console and Pandora FMS database schema and then the server. To finish off, check the update.

Warp Update Journal

To access the Warp Update Journal, access the Management → Warp Update → Warp journal menu.

It will display a log of updates performed by Warp Update where it indicates:

  • The updated version.
  • The type of update (server or Console).
  • The source (online or offline).
  • The user who carried out the update.
  • The update timestamp.

Warp Setup (Options)

To access the Warp Setup, access the Management → Warp Update → Options menu.

Different configurations are available for Warp Update:

  • Limit to LTS updates (offline and online): This allows you to update only LTS versions (Long Term Support), which are more stable versions with extended support.
  • Allow no-consecutive patches (únicamente offline): Based on the previous token setting, this allows you to install non-sequential version updates. It is disabled by default and is the recommended option.

It is recommended to contact the support department before changing any of the following fields:

  • Warp Update URL.
  • Use secured Warp Update.
  • Proxy server.
  • Proxy port.
  • Proxy user.
  • Proxy password.

Manual update

If you choose to update Pandora FMS without Warp Update, you will have to perform a manual update for each system component. This approach allows to supervise each step of the process, executing the necessary steps individually. It is a process that requires full attention and control by the user.

When updating Pandora FMS manually, it is important to take into account the correct order to update Pandora FMS:

  • Web console.
  • Database schema.
  • Server.

To carry out the update of these components, you must have the .tar.gz package from the server and .fms from the Console, of the desired Pandora FMS version to update to.

To download these packages, see Warp Update Offline, where it is explained how to download them.

It is strongly recommended to take a snapshot or backup of the whole Pandora FMS machine, or otherwise a backup copy of all PFMS components before carrying out any intervention, so that in case of failure, the application may be restored in a simple way.

To perform the full Pandora FMS update, you need to connect to Pandora FMS server terminal by means of the root user. This procedure is supported by EL 7, EL 8, EL 9 and Ubuntu 22.04 LTS systems.

Console Update

Move file package_XXX.XXX.fms to the Console path: 

mv package_XXX.XXX.fms /var/www/html/pandora_console/

Change to working directory: 

cd /var/www/html/pandora_console/

Unzip file package_XXX.XXX.fms: 

unzip package_XXX.XXX.fms

When running it, you will be asked which action to perform for the files to be replaced. In this case, select A: 

replace .gitignore? [y]es, [n]o, [A]ll, [N]one, [r]ename: A

Update the Console version in the database, replacing XXX by the Pandora FMS version to which it has been updated: 

mysql -u root -p -D pandora -e "UPDATE tconfig SET value=XXX WHERE token='current_package'"

Database schema update

To update Pandora FMS database schema, the script to update the MR must be manually executed: 

/usr/bin/php /var/www/html/pandora_console/godmode/um_client/updateMR.php

Server update

Decompress the tar.gz of Pandora FMS server pandorafms_server-XXXXX.tar.gz: 

tar -xzvf pandorafms_server-XXXXX.tar.gz

Access the unzipped folder: 

cd pandora_server/

Execute the installer: 

./pandora_server_installer --install

Restart Pandora FMS server: 

systemctl restart pandora_server

Checking the update

Access the Management → About section from Pandora FMS console. There you will be able to correctly see the console version in Information → Current Package and that of the database schema in MR:

Access the Management → Servers → Manage Server section from Pandora FMS console. See the correct server version in the Version column of all servers.

←Back to Pandora FMS documentation index