Skip to main content

Step 6. Install and configure the Lenovo XClarity Administrator virtual appliance (Ubuntu)

Install the XClarity Administrator virtual appliance on the Ubuntu host, and configure Lenovo XClarity Administrator.

Before you begin

You must be logged in to Ubuntu as a user with root authority to install the virtual appliance.

If you intend to implement a high-availability environment, see Implementing high availability (Ubuntu) for more information about setting up the Ubuntu cluster.

Ensure that the host meets the prerequisites that are defined in Hardware and software prerequisites.

Ensure that the host system is in the same network as the devices that you want to manage.

Procedure

To install the XClarity Administrator virtual appliance, complete the following steps.

  1. Download the XClarity Administrator virtual-appliance image from the XClarity Administrator download webpage to a client workstation. Log on to the Web site, and then use the access key that was given to you to download the image.

    For Red Hat KVM, download the image in qcow2 format.

    Note
    Ensure that the client workstation is on the same network as the host.
  2. Install and configure the virtual appliance on the host.
    1. Log in to the server.
    2. Copy the virtual disk image to the server.
    3. From the Virtual Machine Manager window, click QEMU/KVM, and then click New. The New VM dialog is displayed.
    4. Select Import existing disk image, and click Forward.
    5. Browse to the location where you copied the XClarity Administrator image. Select that image.
    6. Select Generic for the OS type and version.
    7. Click Forward.
    8. Select at least 8192 MB for the memory.
    9. Select at least 2 processors.
    10. Click Forward.
    11. Enter a name for the new virtual machine, such as XClarity Administrator.
    12. If you are not using a DHCP server, select Customize configuration before install.
    13. Expand Advanced options and configure the following settings:
      1. Specify virbr0 for the bridge name.

      2. Select kvm as the virtual type.

      3. Select x86_64 for the architecture.

    14. Click Finish.
    15. Click Finish.

      When the virtual machine is started, the IPv4 and IPv6 addresses are listed for each interface, as shown in the following example.

      The XClarity Administrator eth0 management port uses a DHCP IP address by default. At the end of the XClarity Administrator boot process, you can choose to set a static IP address for the eth0 management port by entering 1 when prompted, as shown in the example below. 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
      • 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.

        • For IPv4 settings, you must have the IP address, subnet mask, and gateway IP address

        • For IPv6 settings, you must have the IP address and prefix length

      • If you are not using a DHCP server, you can use a configuration file to specify the IP settings for the XClarity Administrator eth0 management port. that you want to use to access the XClarity Administrator. For more information, see the What to do next section below.

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

      • No action is required to log in. Ignore the console login message. The console interface is not for customer use.

      • You might see the message TCP: eth0: Driver has suspect GRO implementation, TCP performance may be compromised on the console. The performance of the virtual machine is not impacted, and you can ignore this warning.

      Attention
      Changing the IP address of the XClarity Administrator management port after managing devices might cause the devices to be placed in offline state in XClarity Administrator. If you choose to change the IP address after XClarity Administrator is up and running, ensure that all devices are unmanaged before changing the IP address.
      ------------------------------------------
      Lenovo XClarity Administrator 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
      inet6 2001:db8:56ff:fe80:bea3 prefixlen 64 scopeid 0x20<link>
      ether 00:15:5d:0c:d1:92 txqueuelen 1000 (Ethernet)
      RX errors 0 dropped 0 overruns 0 frame 0

      eth1 flags=4163<UP,BROADCAST,RUNNING,MULTICAST> mtu 1500 metric 1
      inet 192.0.2.20 netmask 255.255.255.0 broadcast 192.0.2.130
      inet6 2001:db8:56ff:fe80:bea3 prefixlen 64 scopeid 0x20<link>

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

      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
      x. To continue without changing IP settings
      ... ...


  3. Create a second virtual network.
    1. From Virtual Machine Manager, select the XClarity Administrator virtual machine, and then click Edit > Virtual Machine Details.
    2. Click Overview from the left navigation, and then click the Details tab.
    3. Click Add Hardware at the bottom left corner. The Add New Virtual Hardware dialog is displayed.
    4. Click Network in the left navigation, and modify the network settings.
      • Select macvtapas the network source.

      • Select Bridge the source mode.

      • Select e1000 the device model.

      • Do not modify the MAC address.

    5. Click Finish.