Skip to main content

Installing XClarity Management Hub 2.0

Lenovo XClarity Management Hub 2.0 is set up as virtual appliance on a host system on premises in your local datacenter.

Before you begin

Ensure that you have reviewed the prerequisites, including hardware requirements and recommendations, for XClarity Management Hub 2.0 (see Hardware and software requirements for XClarity Management Hub 2.0).

Ensure that the devices that you intend to manage are supported and are at the required version levels (see XClarity Management Hub 2.0 Support for Servers webpage).

For optimal performance, consider installing the management hub instance in the same location as the devices that you intend to manage. If you have devices in multiple locations, you can install a management hub in each location.

You can set up XClarity Management Hub 2.0 on any device that meets the requirements, including a managed server. If you use a managed server for the management-hub host:
  • Ensure that the host server is set to automatically power on.

  • Do not use the XClarity One portal to apply firmware updates to the host server. Even when only some firmware is applied with immediate activation, XClarity One forces the host server to restart, which would restart the XClarity Management Hub 2.0 and make the management-hub unavailable to complete the updates on the host system. When applied with deferred activation, only some firmware is applied when the host server is restarted.

About this task

You can assign the virtual-appliance IP address using a static IP address on the eth0 port during configuration.

If you do not assign the IP address during configuration, IP settings are assigned using Dynamic Host Configuration Protocol (DHCP) by default when you initially start the virtual appliance. You can configure the XClarity Management Hub 2.0 IP settings when you initially start the virtual appliance. Ensure that you have the required IP information before starting. You have a maximum of 60 seconds to enter settings at each prompt.

  • For static IPv4 settings, you can change the IP address, subnet mask, gateway IP address, DNS 1 IP address (optional), and DNS 2 IP address (optional).
  • For DHCP settings, you can change the primary and loopback interface settings (auto lo, iface lo inet loopback, auto eth0, and iface eth0 inet dhcp).
Attention
Changing the IP address of the XClarity Management Hub 2.0 virtual-appliance after the management hub is up and running will cause connectivity issues with the XClarity One portal and all managed devices. If you need to change the IP address, disconnect management hub from the portal, and unmanage all managed devices before changing the IP address. After the IP address change is complete, reconnect management hub to the portal and re-manage the devices. For more information about setting IP addresses, see Configuring the management hub network.

Procedure

To install the XClarity Management Hub 2.0 virtual appliance, complete the following steps.

  1. Download the XClarity Management Hub 2.0 image to a client workstation from the XClarity One portal.
    1. From the XClarity One portal, click the Organization management view to display the Overview page.

    2. Click the Add icon (Add icon) on the Management Hub panel to display the Add hub dialog.

    3. Click Download XClarity Management Hub to download the hub image to your local system.

    4. Copy the image to the host system where you want to install the management hub.

  2. Install and configure the virtual appliance on the host system.
    • For ESXi using VMware vSphere
      1. Connect to the host through VMware vSphere Client.
      2. Right-click Virtual Machines > Create/Register VM > Deploy a virtual machine from an OVF or OVA file.
      3. Complete each step in the virtual-appliance deployment wizard. Keep the following considerations in mind as you progress through the wizard.
        • Appliance Name. Choose a name that is unique to this host.
        • Storage. Choose a datastore that has at least 420 GB storage available.
        • Disk Format. Choose the disk format that meets the needs of your organization. If you are not sure which format to choose, select Thin Provision.
        • Additional Settings. Optionally update the network configuration for the virtual-appliance to set the static IP address for the eth0 interface.
    • For ESXi using VMware vCenter
      1. Connect to the host through VMware vCenter.
      2. Under "Hosts and groups" or "VMs and Templates," right-click the host, and click File > Deploy OVF Template.
      3. Complete each step in the virtual-appliance deployment wizard. Keep the following considerations in mind as you progress through the wizard.
        • Appliance Name. Choose a name that is unique to this host.
        • Storage. Choose a datastore that has at least 420 GB storage available.
        • Disk Format. Choose the disk format that meets the needs of your organization. If you are not sure which format to choose, select Thin Provision.
        • Customize template. Optionally update the network configuration for the virtual-appliance to set the static IP address for the eth0 interface.
      4. If you chose to set the static IP address for the virtual appliance, complete the following steps.
        1. Select the VM in the Inventory.
        2. Click Configure > vApp, and then select Enable vApp Options.
        3. After it is enabled, select OVF environment for the IP allocation scheme.
        4. On the OVF Details tab, select “VMware Tools” for the OVF environment transport.
    • For ESXi using VMware vCenter
      1. From the Server Manager Dashboard, click Hyper-V.

      2. Right-click the server, and click Hyper-V Manager.

      3. Under Actions, click New > Virtual Machine to begin the @New Virtual Machine Wizard.

      4. Complete each step in the virtual-appliance deployment wizard. Keep the following considerations in mind as you progress through the wizard.

        1. Specify Name and Location. Enter a name for the new virtual machine (for example, xc1h-v<version>).

        2. Specify Generation. Select Generation 1.

        3. Assign Memory. Select at least 8 GB of memory to use for this virtual machine.

        4. Configure Networking. Choose the virtual switch that you created when you installed and configured the host.

        5. Connect Virtual Hard Disk. Click Use an existing virtual hard disk, browse to the location where you downloaded the XClarity Management Hub 2.0 VHDX disk and select it (for example, lnvgy_sw_lxmh_<version>-1.0.0_winsrvr_x86_64.vhdx).

      5. Right-click on the virtual machine that you just created, and click Settings.

      6. Configure the number of processors to assign to the virtual machine. Select Processor, and specify at least 1 virtual processors to use for this virtual machine (see Hardware and software requirements for XClarity Management Hub 2.0 in the online documentation). Click Apply, and then click OK.

      7. (Optional) You can optionally set a static MAC address for each network adapter by expanding Network Adapter for the virtual switch, clicking Advanced Features, clicking Static under MAC address, and then specifying the MAC address.

  3. Power on the virtual appliance.

    When the virtual appliance is started, the IPv4 address that was assigned by DHCP is listed for the eth0 network interface, as shown in the example below.

    The eth0 management port uses a DHCP IP address by default. At the end of the management-hub boot process, you can choose to set a static IP address for the eth0 management port by entering 1 when prompted. The prompt is available for 150 seconds, until the login prompt is displayed. To proceed to the login prompt without delay, enter x at the prompt.

    Important
    • If you specify invalid values when changing an option, an error is returned. You have up to four attempts to enter valid values.

    • When changing the static IP address settings, you have a maximum of 60 seconds to enter the new settings. Ensure that you have the required IP information before continuing (IPv4 address, subnet mask, and gateway IP address).

    • If you change the IP address settings from the console, XClarity Management Hub 2.0 is restarted to apply the new settings.

    • By default, XClarity Management Hub 2.0 uses subnet 192.168.255.0/24 for its internal network (CNI). If this subnet overlaps with the host network, change the subnet to one of the following choices to avoid networking issues.
      • 192.168.252.0/24
      • 172.31.252.0/24
      • 10.255.252.0/24
    • No action is required to log in from the console. Ignore the console login message. The console interface is not for customer use.

    ------------------------------------------
    Lenovo XClarity Management Hub 2.0 Version x.x.x
    ------------------------------------------

    eth0 flags=4163<UP,BROADCAST,RUNNING,MULTICAST> mtu 1500 metric 1
    inet 192.0.2.10 netmask 255.255.255.0 broadcast 192.0.2.55

    ===========================================================================
    ===========================================================================

    You have 150 seconds to change IP settings. Enter one of the following:
    1. To set a static IP address for Lenovo XClarity virtual appliance eth0 port
    2. To use a DHCP address for Lenovo XClarity virtual appliance eth0 port
    3. To select subnet for Lenovo XClarity virtual appliance internal network
    x. To continue without changing IP settings
    ... ...

  4. Optional: Configure the virtual-appliance IP settings. If you do not make a selection within the specified time or if you enter x, the initial startup continues using the IP settings that are assigned by default.
    • Assign static IP addresses for the eth0 port. Enter 1, and then follow the prompts to change the settings.
    • Assign new IP addresses for the eth0 port using DHCP. Enter 2, and then follow the prompts to change the settings.
    • Select the subnet for the virtual appliance internal network. Enter 3, and then follow the prompts to change the settings.

    Important
    If you specify invalid values, an error is returned. You have up to four attempts to enter valid values.
  5. Log in and configure XClarity Management Hub 2.0 (see Configuring XClarity Management Hub 2.0).