Updating the Appliance


Updating the Appliance

When there is a system update or a new release of the Portal, the Engine or the Web Console, update all your Nexthink Appliances to take advantage of the new features, bug fixes and security updates.

Online update (recommended)

If your appliances have access to the Internet, this is the recommended method to do the update. Follow the procedure below to update each appliance:

  1. Log in to the Web Console of the Appliance as administrator. In your browser, type the URL https://<appliance.dns.or.ip>:99.
  2. In the section Appliance, select the tab Update.
  3. Optional: Click the circular arrows in the Last check for update row to see if there is a new system update or any update of the installed Nexthink components: Portal, Engine or Web Console. If there is any update available, it is displayed in the cell on the right hand side. For each released component, find here a direct link to its release notes.
  4. Optional: Check the box Enable of the Automatic update row to get the updates from the Nexthink repository as soon as they are published.
  5. Optional: Press the button Start connectivity test to verify your connection to the Nexthink repository (updates.nexthink.com). If the repository is reachable, a message of success is displayed.
  6. Click the button Start update to trigger the update procedure. You can follow the status of the update in the Last update installation row. At the end of the procedure, the message Update complete is displayed at the top of the tab.

Some updates require rebooting the Appliance to be complete. Refer to the chapter on rebooting the Appliance below for more information.

Offline update

The Appliance relies on yum to manage the upgrade of its components. When the appliance is connected to the Internet, the Web Console instructs the yum utility to get the upgrades from the Nexthink repository. In the case that your appliances are not connected to the Internet, you must download the offline migration package and, if there is any system update, the Appliance ISO. You must then manually update the Appliance using yum from the command line.

The Appliance ISO contains the operating system, auxiliary packages and security updates of the Appliance; whereas the offline migration package is a tgz file that holds the Nexthink components: Portal, Engine and Web Conosole. For updating each one of your appliances offline, follow the steps below.

Applying system updates

To manually update the system packages of each Appliance, using yum and the Appliance ISO:

  1. Attach the Appliance ISO to the physical or virtual system that hosts.
  2. Log in to the command line interface (CLI) of the Appliance.
  3. Mount the ISO with the following commands:
    sudo mkdir -p /media/cdrom
    sudo mount -t iso9660 /dev/cdrom /media/cdrom
    sudo yum --disablerepo=* --enablerepo=c6-media --nogpgcheck update
  4. Wait for the operation to finish and then disconnect the ISO from the system using the following command:
    sudo umount /media/cdrom

If the system updates include a modification of the kernel of the operating system, you need to reboot the Appliance to load the new kernel. Refer to the chapter on rebooting the Appliance below.

Updating Engine, Portal and Web Console

To manually update the Nexthink components of each Appliance:

  1. Connect to the Portal Appliance with any SCP client and copy the offline migration package (tgz file) to /home/nexthink/. Make sure that you copy the offline migration package and not the offline installation package. The latter is designed for a clean install only, not for an update.
  2. Untar the offline migration package:
    tar –xzvf Nexthink-migration-5.x.tgz
  3. Run the installation script:
    sudo ./install_Nexthink_v5.sh
  4. Log in to the Web Console as administrator.
  5. Check that the update was correctly by verifying the versions of the installed components in the Information tab of the Appliance section.

Rebooting the Appliance

Usually, you do not need to reboot the Appliance after an update. In the case of system updates that install a new kernel for the operating system, however, it is necessary to reboot the Appliance to load the new kernel. This condition will be made clear in the release notes of the update.

To reboot the Appliance after an update:

  1. Log in to the Web Console as administrator.
  2. In the Appliance section, go to the Reboot tab.
  3. To the question Are you sure you want to reboot the Appliance?, answer by clicking the Yes button.