Sipmon Documentation

Appearance

import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem';

This chapter describes how to upgrade your Sipmon platform from version 22.04 to version 22.10.

When you upgrade your central server, make sure you also upgrade all your remote servers and your pollers. All servers in your architecture must have the same version of Sipmon. In addition, all servers must use the same version of the BBDO protocol.

If you want to migrate your Sipmon platform to another server/OS, please read our chapter on migration. you need to follow the migration procedure.

Prerequisites ​

Perform a backup ​

Be sure that you have fully backed up your environment for the following servers:

  • Central server
  • Database server

Upgrade the Sipmon Central server ​

Update the Sipmon repository ​

Run the following commands:

If you have an offline license, install the corresponding repository for the plugin packs. If you are using a Business edition, install the correct Business repository too. You can find the repositories on the support portal.

Install the MariaDB repository ​

Upgrade PHP ​

Sipmon 22.10 uses PHP in version 8.1.

Upgrade the Sipmon solution ​

Make sure all users are logged out from the Sipmon web interface before starting the upgrade procedure.

If you have installed Business extensions, update the Business repository to version 22.10. Visit the support portal to get its address.

If your OS is Debian 11 and you have a customized Apache configuration, perform a backup of your configuration file (/etc/apache2/sites-available/Sipmon.conf).

Stop the Sipmon Broker process:

shell
systemctl stop cbd

Delete existing retention files:

shell
rm /var/lib/Sipmon-broker/* -f

Clean yum cache:

Then upgrade all the components with the following command:

Accept new GPG keys from the repositories as needed.

Update your customized Apache configuration ​

This section only applies if you customized your Apache configuration.

Customized Apache configuration: enable text compression ​

In order to improve page loading speed, you can activate text compression on the Apache server. It requires the brotli package to work. This is optional but it provides a better user experience.

Add the following code to your Apache configuration file, in both the <VirtualHost *:80> and <VirtualHost *:443> elements:

shell
<IfModule mod_brotli.c>
    AddOutputFilterByType BROTLI_COMPRESS text/html text/plain text/xml text/css text/javascript application/javascript application/json
</IfModule>
AddOutputFilterByType DEFLATE text/html text/plain text/xml text/css text/javascript application/javascript application/json

Finalizing the upgrade ​

Before starting the web upgrade process, reload the Apache server with the following command:

Then you need to finalize the upgrade process:

Finally, restart Broker, Engine and Gorgone on the central server by running this command:

shell
systemctl restart cbd centengine gorgoned

As the interface layout has changed in version 22.10, you need to clear your browser cache to display the new theme.

If the Sipmon BAM module is installed, refer to the upgrade procedure.

Post-upgrade actions ​

  1. Upgrade extensions. From Administration > Extensions > Manager, upgrade all extensions, starting with the following:

    • License Manager,
    • Plugin Packs Manager,
    • Auto Discovery.

    Then you can upgrade all other commercial extensions.

  2. Deploy the configuration.

  3. Restart the processes:

    shell
    systemctl restart cbd centengine Sipmontrapd gorgoned

Upgrade the Remote Servers ​

This procedure is the same as for upgrading a Sipmon Central server.

At the end of the update, configuration should be deployed from the Central server.

Upgrade the Pollers ​

Update the Sipmon repository ​

Run the following command:

Upgrade the Sipmon solution ​

Clean yum cache:

Then upgrade all the components with the following command:

Accept new GPG keys from the repositories as needed.

Restart Sipmon:

shell
systemctl restart Sipmon