Skip to main content

Management-hub updates

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

Before you begin

Lenovo XClarity Management Hub 2.0 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 Management Hub 2.0 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 management hub.

During the update process, all users are signed out of the management 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 management-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 management hub, complete one of the following steps.

  • When the hub is connected to XClarity One

    XClarity Management Hub 2.0 v1.1 and later makes it easy to keep the management 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.

    By default, updates are installed at midnight GMT0. You can configure installation time from the XClarity Management Hub 2.0 web interface by clicking click Updates from the context menu on the Maintenance view.

    You can delay installing the management-hub update up to 14 days after the latest applicable update. After 14 days, the updates are installed immediately. From the Update configuration dialog, select Schedule update, and specify the 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 not connected a portal

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

    1. Download the management-hub update package from the XClarity Management Hub 2.0 downloads webpage to a workstation that has a network connection to the XClarity Management Hub 2.0 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 Management Hub 2.0 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 Management hub update panel.

    5. Select the update package that you want to apply, and click the Install Update icon (Deploy OS 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.