Updating the Appliance

Contents

Updating the Appliance

Overview

Starting from Nexthink V6.6, the Appliance offers a simplified auto-update mechanism that requires minimal intervention. For a stricter control over the moment of the update, manual updates are still possible. Whether automated or manual, not only does the new update mechanism update all your Appliances at once, but also provides updates for the Finder and the Collector.

When updating from Nexthink V6.5 or a previous version, update of your Appliances as usual, using either the online or the offline update described below. At the end of the process, your updated Appliances get into an intermediate state called compatibility mode. In compatibility mode, you can still work and update your Appliances individually. Federate your Appliances to enable the new update mechanism, along with many other advantages.

When updating from Nexthink V6.16 or a previous version to V6.17 or above, the Appliance undertakes a process of content centralization, during which most of the content that was previously local to each Engine becomes shared by all Engines. The centralization of content offers users a unified experience across all Engines when connecting to them with the Finder, without the need to manually export and import content from one Engine to each other.

Online update

If your appliances have access to the Internet, this is the recommended method to do the update from V6.5 or below. For V6.6 and above, prefer automatic updates. 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 process. By the end stages of the update, the Web Console shows its new user interface.
  7. Wait for the message Everything is up-to-date. The update of the Appliance has been completed.

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 update package and, if there is any system update, the Appliance ISO. You must then manually update the Appliance using yum from the command line.

If the Appliance ISO of a particular version of Nexthink is not yet available for download, but the offline update package is already downloadable and you need to install it, ensure at least that you update your appliances to the latest available ISO (usually the ISO of the previous version) before updating the rest of the Nexthink components.

The Appliance ISO contains the operating system, the Web Console, other auxiliary packages, and the security updates for the Appliance; whereas the offline update package is a tgz file that holds the Nexthink components: Portal, Engine, Finder, and Collector. 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
  4. Update the system packages (ignore any message about already installed packages):
    sudo rpm -Uvh /media/cdrom/CentOS/centos-release-*.rpm
    sudo yum --disablerepo=* --enablerepo=c7-media --nogpgcheck \
    --exclude=nxconsole update
  5. 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 update package (tgz file) to /home/nexthink/. Make sure that you copy the offline update package and not the offline installation package. The latter is designed for a clean install only, not for an update.
  2. Untar the offline update package:
    tar -xzvf Nexthink-offline-update-6.x.tgz
  3. Ensure that the installation script is executable:
    sudo chmod a+x install_Nexthink_v6.sh
  4. Run the installation script:
    sudo ./install_Nexthink_v6.sh
  5. Log in to the Web Console as administrator.
  6. Check that the update was correctly by verifying the versions of the installed components in the Information tab of the Appliance section.

Automatic updates

The automatic update of the Appliances helps you maintain your Nexthink software up-to-date in a centralized and comfortable way. Choose the day of the week and the hour of the day when updating your Portal and Engines is more convenient for you. The automatic update requires your Appliances to be federated.

To enable the automatic update of your Appliances:

  1. Log in to Web Console of the Appliance that hosts the Portal (the master) as admin.
  2. Click the Appliance tab at the top of the window.
  3. Select the section Update from the left-hand side menu.
  4. Tick the box Automatically update Nexthink Appliance and installed components, the subsection Update on shows up below with a couple of selection lists.
    1. Select the day of the week when you want to do the update. Choose the default value any day if you do not have a preferred day.
    2. Select the hour of the day when you want the update to start. Choose the default value any time if you do not have a preferred time.

At least one week must have passed between the availability of the update and the actual update of your Appliances. For instance, if you selected your preferred day of the update to be on Friday, and the update is available since Wednesday, the actual update will take place on Friday of the next week.

Verifying the running version of the Appliance

To verify the version of the Appliance and of the installed components that are currently running on your machine:

  1. Log in to the Web Console.
  2. In the APPLIANCE tab, select General from the left-hand side menu.
  3. Find the versions of the installed components on the table under Versions.

The versions displayed in the Web Console must match the versions advertised in the Release Notes of the corresponding update. Check the update process otherwise.

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, select the General tab.
  3. Under Status, click the button REBOOT APPLIANCE.
  4. To the question Are you sure you want to reboot the Appliance?, answer by clicking OK.