====== Update ======

{{indexmenu_n>2}}

===== Warp Update =====

  * This section will only be visible if **Enable Warp Update** is activated in the [[:en:documentation:pandorafms:management_and_operation:12_console_setup#enterprise|General Configuration]].
   * You must have [[:en:documentation:pandorafms:technical_annexes:15_security_architecture#keep_your_system_up_to_date|Internet access]] in Web Console and in Pandora FMS server.
   * **Warp Update** will contact you to find the latest version available.
   * Updates are automatic and in 99% of cases it works successfully if the environment is correctly configured.
   * You can also [[#warp_update_offline|update offline (offline)]] if the PFMS server to be updated is in a restricted and/or limited environment.

==== Warp Update Online ====

   * To update by **Warp Update** online you must be registered.
   * Warp Update will connect and analyze what updates are needed.
   * If it is up to date, it will show the current active version, without the need to perform any other action.

==== Warp Update Offline ====

Before upgrade offline, [[https://pandorafms.com/en/contact/|contact]] support for download files.

Warp Update Offline also serves to install patches of different types: console (**OUM**), server (''tar.gz'') and manual combined patches (''tar.gz'').

<WRAP center round important 60%>

Applying patches and/or updates offline may make your Web Console unusable, it is recommended to perform a [[:en:documentation:pandorafms:technical_annexes:07_backup_and_restore_procedures|full backup]] beforehand.

</WRAP>

  * In the case of a version upgrade, you must download the corresponding **OUM** and ''tar.gz'', install the **OUM** first and then the //tarball//.
  * Once the file(s) have been downloaded, access the **Warp Update** → **Warp Update Offline** menu and click the **Browse it** button to select file by file.
  * Review the information displayed on the screen and check if it matches the updates and/or corrections. To process click on the green icon in the lower right corner, wait for the console to display the results of each process.
==== Warp Update Journal ====

Go to the **Warp Update** menu → **Warp Update Journal** to know the updates made, version, date and time of application, user who requested and applied it, etc.

==== Warp Update Setup ====

<WRAP center round tip 60%>

[[https://pandorafms.com/en/contact/|Please contact]] support before changing any of the following fields:

   * **Warp Update URL**.
   * **Use secured Warp Update**.
   * **Proxy server**.
   * **Proxy port**.
   * **Proxy user**.
   * **Proxy password**.
</WRAP>

   * **Allow no-consecutive patches**: Allows non-consecutive updates to be installed. Off by default and is the recommended option.
   * **Limit to LTS updates**: Allows you to update only long-term versions, active by default.
===== Manual update =====

  * Pandora FMS consists of: Server, Database and Console web.
  * Updates will **always** include console changes, **occasionally** server changes (minor updates) and **rare** database changes (major updates).
  * [[https://pandorafms.com/en/contact/|Contact]] support for download files.

==== Update a minor version ====

1. A [[:en:documentation:pandorafms:technical_annexes:07_backup_and_restore_procedures|database backup]] must be performed. Example:
<code>

mysqldump -u root -p pandora> backup_pfms_X.Y.sql

</code>

2. A backup of the configuration files must be made: ''pandora_server.conf'', ''config.php'', ''pandora_agent.conf''.

3. A backup of the Server and Agent plugins must be made, located at:

<code>
/etc/pandora/plugins
pandora_console/attachment/plugin
/usr/share/pandora_server/util/plugin

</code>

4. The services: ''pandora_server'', ''tentacle_serverd'', ''httpd'', ''pandora_agent'' and ''mysqld'' must be stopped.

5. **You can proceed with the update**.

6. Remember to restart the services stopped in point 4.

=== From RPM packages ===

  * Update of the Console web:

<code>

rpm -U pandorafms_console_enterprise_package.rpm

</code>

  * PFMS server update with tar.gz:

<code>

tar -xvzf pandorafms_server_enterprise_package.tar.gz
cd pandora_server
./pandora_server_installer --install

</code>

   * Software Agent Update:

<code>
rpm -U pandorafms_agent_*.rpm

</code>

At all times, before and after the update, you will be able to know your installed versions by running the command:

<code>
rpm -qa | grep -i pandora

</code>

=== From Tarball / Sources ===

  * Change ''package'' to the name of the downloaded version and ''yourconsolepath'' to the full path of the installed console.
  * Update of the Console web:

<code bash>
tar xvzf pandorafms_console_enterprise_'package'.tar.gz
cd pandora_console
./pandora_console_upgrade -p /'yourconsolepath'

</code>

  * PFMS Server update:

<code bash>
tar xvzf pandorafms_server_enterprise_'package'.tar.gz
cd pandora_server
./pandora_server_installer --upgrade

</code>

  * Software Agent Update:

<code bash>
tar xvzf pandorafms_agent_'package'.tar.gz
cd pandora_agent
./pandora_agent_installer --force-install

</code>

==== Major Update ====

It is always recommended to update the Console using **Warp Update**. If the database is out of date, the web console will show a notice with the title **Minor release/s available.**

To solve this problem, you must enter through a shell to the server where the Pandora FMS Console is located and go to the directory:

<code>
cd /var/www/html/pandora_console/extras/mr

</code>

Inside this directory will appear another directory named ''updated''. All the MR that are applied must be stored there and those that are not must be stored outside of it. Example of executing the file ''1.sql'' (MR 1):
<code>
cat 1.sql | mysql -u root -p pandora

</code>

Once the **sql**(s) have been applied to the database, they must be moved to the ''updated'' directory.

<code>
mkdir -p updated
mv1.sql updated/

</code>

Then you have to update the value of **MR** inside the MySQL table ''tconfig'':
<code>
mysql -u root -p pandora> use pandora;> update tconfig set value=XX where token='MR';

</code>

To know the MR to be applied, please go to the following [[:en:documentation:pandorafms:technical_reference:10_versions|link.]]




===== Downgrade =====

==== From RPM packages ====

  * Console web update:

<code>
rpm -i --force pandorafms_console__enterprise_package.rpm

</code>

==== From Tarball/Sources ====

  * Console web update:

<code bash>
tar -xvzf pandorafms_console_package.tar.gz
mv --force ./enterprise /yourconsolepath

</code>

[[:en:documentation:start| Back to Pandora FMS documentation index]]