Upgrade#

Pre Checks#

  1. Verify your access to the UI, then verify the application version via the profile menu (your username), for example, admin (top right).

  2. Verify available storage of the disk of the server, via system/stats dashboards.

Backup VM Before Upgrade#

If the application is a Virtual Machine (VM), then a pre-upgrade snapshot is recommended.

Backup Dashboards Before Upgrade#

This procedure backs up dashboards before you start the upgrade.

  1. Log in to the Dashboard user interface as admin (superuser).

  2. Click on the System Configuration icon (Cog), then select Import/Export Wizard.

  3. On the Export tab, select all the dashboards.

  4. Select all the dashboards.

  5. Click the Export .lxtr button on the top right.

  6. Click Download.

  7. Save the file to your local computer or to a secure network location.

Backup Arbitrator Before Upgrade#

  1. Log in to the Arbitrator user interface as admin.

  2. Click on the System Configuration icon (Cog), then select Import/Export.

  3. Drag the following items from the Configuration Items pane to the Export pane:

    • Asset Entries

    • Asset Groups

    • Controls

    • Policy Modules

    • Probe Groups

    • Response Procedures

    ../../../_images/VAA-upgrade-image3.png
  1. Click Export

  2. Click Download, then save to your local computer or a secure network location.

    VAA-upgrade-image5

Admin Menu Backup (Arbitrator or Dashboard)#

  1. Log in to server using Putty via the admin account.

  2. Go to the Administration menu (either Arbitrator or Dashboard):

    • Arbitrator

      ../../../_images/arb-cli-menu-administration.png
    • Dashboard

      ../../../_images/dash-cli-menu-administration.png
  3. Select Backup Restore, and then choose Create a backup.

    ../../../_images/arb-cli-menu-backup.png

    Note

    • This backup creates a backup tar.bz2 file in the lxt_archive/ directory. If required, the Administration menu can be used to restore a selected backup.

      ../../../_images/arb-cli-menu-restore.png
    • Any themes that were present on the system are also backed up and will also be available from the restore list.

      ../../../_images/arb-cli-restore-menu.png

Upgrade#

Upgrade Timings#

Note

Since various operating system components are updated during release 24.1, the total upgrade time is more than the averages for previous releases.

  • Arbitrator = Approx 40-60 Mins

  • Dashboard = Approx 40-120 Mins

  • DS9 = Approx 10-20 Mins

Upgrade Arbitrator or Dashboard#

  1. Using Winscp and the drop account, copy the file (example file for the arbitrator insights-arbitrator-<from>-<to>.lxsp) to the lxt_upgrade directory.

    Note

    The drop account username is “drop”. You can set the password via the Administration menu.

    ../../../_images/insights-change-drop-acc-password.png
  2. Log in to the server using Putty via the Admin account.

  3. From the Administration menu, select Upgrade.

    ../../../_images/insights-upgrade-admin-upgrade-menu.png
  4. On VOSS Upgrade, select Check and Upgrade, click OK.

    ../../../_images/insights-upgrade-check-and-upgrade.png

Upgrade DS9#

This procedure upgrades DS9.

Pre-requisites:

  • Using Winscp and the drop account, copy the *.lxsp file to be used for the upgrade into the drop account’s lxt_upgrade sub-directory.

    Note

    • The naming convention for Insights upgrade files means that the system is able to detect the file to use for the upgrade. For Insights products, *.lxsp file is copied into the drop account’s lxt_upgrade sub-directory, and the system fetches the file from that location.

    • The drop account username is “drop”. You can set the password via the Administration menu.

      ../../../_images/insights-change-drop-acc-password.png
  1. Connect to the DS9 server using an SSH client on port 22 and login using the admin credentials to access the Administration menu.

    ../../../_images/Ds9-upgrade-admin-menu.png
  2. Select System > Software Upgrade.

    ../../../_images/Ds9-upgrade-software-upgrade.png
  3. Select Check and Upgrade.

    ../../../_images/Ds9-upgrade-check-and-upgrade.png

Patch Install Steps#

  1. Using Winscp and the drop account, copy the file (example file for the arbitrator insights-arbitrator-<from>-<to>.lxsp) to the lxt_upgrade directory.

  2. Log on to the server using Putty and the admin user credentials

  3. From the Administration menu, select Upgrade

    ../../../_images/insights-upgrade-admin-upgrade-menu.png
  4. Select Check and Upgrade:

    VAA-upgrade-image7

    (Optional) Select Perform Checksum and enter the downloaded filename. This step will verify the downloaded file against its .sha256 file.

  5. Once the upgrade completes, reboot the server then log in again to verify.

Post Checks#

Verify that the version of your system is updated. To do this via the GUI, click the System Configuration icon (Cog), then select About.

../../../_images/insights-upgrade-gui-about-menu.png

Note

If the version does not appear to be updated, clear your browser’s cache and reconnect.