Upgrade and Maintenance#

This topic covers the upgrade of Dashboard, Arbitrator and DS-9, as well as maintenance tasks such as DS9 Database Password Management.

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 security updates have updated various operating system components, the total upgrade time is more than the averages for previous releases (doubled for DS9).

Averages:

  • 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.

DS9 Database Password Management#

DS9 is installed with a default, hidden password and Dashboard user lxpublic.

This database password can however be modified, as indicated below.

Maintain DS9 Database Password on DS9#

  1. On the DS9 server, log in as admin from the console and from the Administration menu, select Change Passwords.

  2. Select Change DS9 Public Database Password and modify the password. (Note: only alphanumeric characters are allowed)

../../../_images/ds9-password_menu.png
  1. Verify the credential configuration on the Arbitrator - see below.

  2. Update the Dashboard Data Sources password for the DS9 server - see below.

Maintain DS9 Database Password on Arbitrator#

  1. Log in as admin from the console and from the Administration menu, select Change Passwords.

  2. Select Change DS9 Public Database Password.

../../../_images/arb-password_menu.png
  1. Enter the DS9 IP address on the console and modify the password. (Note: only alphanumeric characters are allowed)

A change from the default credentials will also reflect on the Arbitrator menu: CREDENTIAL CONFIGURATION.

../../../_images/arb-credential-config-ds9-passw.png

If this entry is removed, the DS9 credentials revert to the default, hidden credentials. While this entry can also be modified, it is advised to carry ou the task from the console Change DS9 Public Database Password menu.

Maintain DS9 Database Password on Dashboard#

When a DS9 server password is modified on DS9 or the Arbitrator as indicated above, the modified password needs to be updated on Dashboard the Data Sources entry.

  1. From the System Configuration icon on the dashboard, select Data Sources.

  2. Update the Password field for all Data Sources that match the related DS9 host.

../../../_images/dashb-data-sources-DS9-passw.png