For details on upgrading your syslog-ng Store Box (SSB) installation to 7.4.0, see the following procedures.
Preface
Prerequisites and Notes
Version numbering in SSB
Upgrade paths to SSB
Upgrading to SSB 7.4.0
Troubleshooting
Guidelines and support for direct upgrade paths in SSB
Possible upgrade path scenarios, and their recommended upgrade paths
Upgrade paths to the current version of SSB
Upgrade checklist
Upgrading to SSB 7.4.0
Upgrading to SSB 7.4.0
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.4.0
-
Stop SSB from accepting the incoming log traffic. Navigate to Basic Settings > System > Service control and click Disable.
-
Update the firmware of SSB using the web interface.
-
Navigate to Basic Settings > System > Upgrade.
-
Upload the new .ISO file.
-
When the upload is finished, click Upgrade and reboot node.
-
-
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.
-
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.
-
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.
-
Upload the new license file. For details, see Updating the SSB license.
-
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
-
Stop SSB from accepting the incoming log traffic. Navigate to Basic Settings > System > Service control and click Disable.
-
Update the firmware of SSB using the web interface.
-
Navigate to Basic Settings > System > Upgrade.
-
Upload the new .ISO file.
-
When the upload is finished, click Upgrade, reboot master, and shut down slave.
-
-
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. If you encounter any problem, you can find common troubleshooting steps in Troubleshooting.
-
Upload the new license file. For details, see Updating the SSB license.
-
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.
-
Navigate to Basic Settings > High Availability > High availability & Nodes, then verify that the secondary node is connected, it has the same firmware versions as the primary node, and that they both operate in HA state.
NOTE: When upgrading an SSB cluster, the upgrade process on the slave node will be completed only once a takeover has been performed.
-
Enable SSB to receive the incoming log traffic. Navigate to Basic Settings > System > Service control and click Enable.
Updating the SSB license
You can update an existing syslog-ng Store Box (SSB) license with the following procedure.
To update the syslog-ng Store Box (SSB) license
-
Download the new 7.4.0 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.4.0 under your account, contact our Licensing Team and Request a license key for a new version.
-
Navigate to Basic Settings > System > License.
-
Click Browse and select the new license file.
You can upload compressed licenses (for example, .zip archives).
-
Click
, then
.