Kaspersky Secure Mail Gateway

Upgrading a cluster node to KSMG 2.1

July 10, 2024

ID 239459

We strongly recommend to back up the KSMG virtual machine (make a snapshot of the virtual machine in the hypervisor) of the cluster node before upgrading KSMG. This will let you go back to the previous version of KSMG if the installation of the new version fails.

Before upgrading using the KSMG web interface, you must download the ZIP archive with the upgrade package from the Kaspersky website or a partner company website and extract the KTGZ update file from the archive.

To upgrade KSMG to version 2.1 on a cluster node:

  1. In the web interface of the previous Control node, go to the Message queue section, click Manage settings for sending/receiving, select the node for which you want to install the update, and disable the reception of messages on that node. For details, see Enabling and disabling the transmission and reception of messages.
  2. In the table of messages in the queue, filter the messages by node then wait until messages from all queues are sent.
  3. Remove the load from the node in the load balancer settings.
  4. If you have edited KSMG settings in Technical Support Mode, run the script for detecting incompatible objects in the system. If necessary, delete or edit the detected objects.

    If unknown objects are detected on your computer during the upgrade, upgrade installation is stopped.

  5. In the web interface of the node being upgraded, click Install patch and install the upgrade package: ksmg_upgrade_2.0.1.6960_2.1.0.7854.ktgz.
  6. Wait for the web interface page to reload.
  7. In the web interface of the updated node, in the lower part of the left menu pane, click the name of the current user, then select About and in the displayed window, make sure that the Version line displays 2.1.
  8. If necessary, transfer the saved configuration files of the operating system or built-in MTA that you copied before installing the update.
  9. In the web interface of the new Control node:
    1. Update the databases.
    2. If a connection with the LDAP server was configured, update the LDAP cache.

      If a LDAP server connection was not configured, synchronize with an Active Directory domain controller.

    3. Turn on the receipt of messages on the node with the updated application. To do so, go to the Message queue section, click Manage settings for sending/receiving, select the node for which you want to install the update, and disable the reception of messages on that node. For details, see Enabling and disabling the transmission and reception of messages.
    4. Check if messages can pass through. To do so, send a test message through the node and confirm if it was delivered to the recipient.
    5. Restore the load on the node in the load balancer settings.

As a result, the KSMG application on the cluster node is upgraded to version 2.1.

Did you find this article helpful?
What can we do better?
Thank you for your feedback! You're helping us improve.
Thank you for your feedback! You're helping us improve.