Chat now with support
Chat with Support

syslog-ng Store Box 7.0 LTS - Upgrade Guide

Upgrading to SSB 7.0 LTS

For details on upgrading your syslog-ng Store Box (SSB) installation to 7.0 LTS, see the following procedures.

Topics:

Upgrading SSB

If you want to upgrade a SSB cluster, see Upgrading an SSB cluster.

Prerequisites

Read the following warnings before starting the upgrade process.

To upgrade a standalone SSB node to version 7.0 LTS

  1. Stop SSB from accepting the incoming log traffic. Navigate to Basic Settings > System > Service control and click Disable.

  2. Update the firmware of SSB using the web interface.

    1. Navigate to Basic Settings > System > Upgrade.

    2. Upload the new .ISO file.

    3. When the upload is finished, click Upgrade and reboot node.

  3. Navigate to Basic Settings > System > System Control > This node, and choose Reboot.

    SSB attempts to boot with the new firmware. Wait for the process to complete.

  4. Recommended step. To help troubleshoot potential issues following the upgrade, collect and save system information (create a debug bundle) now.

    Navigate to Basic Settings > Troubleshooting > System debug and choose Collect and save current system state info.

  5. Navigate to Basic Settings > System > Version details and check the version numbers of SSB. In case you encounter problems, you can find common troubleshooting steps in Troubleshooting.

  6. Upload the new license file. For details, see Updating the SSB license.

  7. Enable SSB to receive the incoming log traffic. Navigate to Basic Settings > System > Service control and click Enable.

Upgrading an SSB cluster

Prerequisites

Make sure that you have physically connected the IPMI interface to the network and that it is properly configured. This is important because you can only power the secondary node on through the IPMI interface. For details on configuring the IPMI interface, see "Out-of-band management of SSB" in the Administration Guide.

To upgrade an SSB cluster

  1. Stop SSB from accepting the incoming log traffic. Navigate to Basic Settings > System > Service control and click Disable.

  2. Update the firmware of SSB using the web interface.

    1. Navigate to Basic Settings > System > Upgrade.

    2. Upload the new .ISO file.

    3. When the upload is finished, click Upgrade, reboot master, and shut down slave.

  3. Log in to the SSB web interface to verify that the primary node upgrade was successful.

    Navigate to Basic Settings > System > Version details and check the version numbers of SSB. In case you encounter problems, you can find common troubleshooting steps in Troubleshooting.

  4. Upload the new license file. For details, see Updating the SSB license.

  5. Use the IPMI interface to start the secondary node.

    The secondary node attempts to boot with the new firmware, and reconnects to the primary node to sync data. During the sync process, certain services (including Heartbeat) are not available. Wait for the process to finish, and the secondary node to boot fully.

  6. Navigate to Basic Settings > System > High availability & Nodes and verify that the secondary node is connected, and has the same firmware versions as the primary node.

    NOTE:

    When upgrading an SSB cluster, the upgrade process on the slave node will only be completed once a takeover has been performed.

  7. Enable SSB to receive the incoming log traffic. Navigate to Basic Settings > System > Service control and click Enable.

Updating the SSB license

To update the syslog-ng Store Box (SSB) license

  1. Download the new 7.0 LTS license file from support portal.

    You need a new license file for every long-term-supported release. If there is no license file for SSB 7.0 LTS under your account, contact our Licensing Team and Request a license key for a new version.

  2. Navigate to Basic Settings > System > License.

  3. Click Browse and select the new license file.

    You can upload compressed licenses (for example, .zip archives).

  4. Click , then .

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating