Skip to main content

Hub updates

It is important to keep Lenovo XClarity One Hub up to date with the latest release.

Before you begin

Lenovo XClarity One Hub v1.1 and later supports automated updates. You must manually update from v1.0 to v1.1 to get this feature by following the steps in the When the hub is not connected to a portal section below.

You can update Lenovo XClarity One Hub to only the next ordinal release, for example from v1.0 to v1.1 or v1.1 to v1.2. You cannot skip releases when updating the hub.

During the update process, all users are signed out of the hub when the hub restarts. Wait several minutes until the restart completes. Then, clear the web browser cache and refresh the web browser before signing in again.

Note
If you encounter a 413 error (entity too large) when you attempt to upload the hub update package, increase the number of processors on the VM. For example, if your VM has 2 processors, increase the VM to 4 processors.

Procedure

To update the hub, complete one of the following steps.

  • When the hub is connected to XClarity One in the cloud

    XClarity One Hub makes it easy to keep the hub software up to date by retrieving the latest updates packages as soon as a new update is released and then automatically installing updates at the preferred time.

    You can choose a different start time from the XClarity One Hub web interface from the Hub Updates panel on the Maintenance view.

    You can delay installing the hub update up to 14 days after the latest applicable update. After 14 days, the updates are installed immediately. From the Maintenance view on XClarity One Hub web interface, select Schedule the update from the Hub Updates panel, and then specify the desired date and time.

    An event is raised an hour before the installation process starts.

    After the update completes, clear the web browser cache, and refresh the web browser.

  • When the hub is connected to XClarity One as a local VM

    XClarity One Hub makes it easy to keep the hub software up to date by retrieving the latest updates packages as soon as a new update is released. However, by default, automatic updates are disabled when the hub is connected to XClarity One running as a local VM. You need to manually update the hub when new versions are available by selecting the update package that you want to apply from the Maintenance view on the XClarity One Hub web interface by clicking the Install Update icon (Deploy template icon) from the from the Hub Updates panel.

    You can configure the hub to update automatically as soon as an update is available or on a specific schedule from the Hub Updates panel.

    • If you select Automatic update, updates are installed automatically at your chosen start time. By default, updates are installed at midnight UTC+0 after the update is released.

    • If you select Schedule the update, you can delay installing hub updates up to 14 days after the latest applicable update. After 14 days, the updates are installed immediately at the selected time.

    An event is raised an hour before the installation process starts.

    After the update completes, clear the web browser cache, and refresh the web browser.

  • When the hub is not connected a portal

    When the hub is not connected to a portal, you can manually update the hub, by completing the following steps.

    1. Download the hub update package from the XClarity One downloads webpage to a workstation that has a network connection to the XClarity One Hub host server.

      The update package is a .tar.gz or .tgz archive. This archive file contains the four required update files: update image (.tgz or .tar.gz), metadata (.xml), change log (.chg), and readme (.txt).

    2. From the XClarity One Hub web interface, click Updates from the context menu on the Maintenance view.

    3. Import the update package by clicking Import an update (if there are no updates in the repository) or the Import icon (Import icon) to display the Import an update dialog

    4. Select the update package, and click Import.

      Importing the update files might take a while. When the import is complete, the update package is listed in the table on the Hub update panel.

    5. Select the update package that you want to apply, and click the Install Update icon (Deploy template icon).

    6. Wait for the update to complete. The update process might take a while.

    7. Clear the web browser cache, and refresh the web browser.

      When completed, the Status column changes to Installed.