Skip to main content

Restarting XClarity Administrator

You can restart Lenovo XClarity Administrator from the web interface or from the hypervisor after a shutdown.

Before you begin

You must have lxc-supervisor or lxc-admin authority to restart XClarity Administrator.

Ensure that no jobs are currently running. Any jobs that are currently running are canceled during the restart process. To view the jobs log, see Monitoring jobs.

About this task

There are certain situations when you are required to restart Lenovo XClarity Administrator:
  • When regenerating a server certificate
  • When uploading a new server certificate

Procedure

Complete one of the following procedures to restart Lenovo XClarity Administrator.

  • Containers

    Run the following commands to stop and then start the container, where <env_filename> is the name of the environment variables file.
    docker-compose -p ${CONTAINER_NAME} down
    <span className="ph">COMPOSE_HTTP_TIMEOUT=300</span> docker-compose -p ${CONTAINER_NAME} ––env-file <ENV_FILENAME> up -d

  • Virtual appliances

    • Restart Lenovo XClarity Administrator from the web interface:

      1. From the Lenovo XClarity Administrator menu bar, click Administration > Shut Down Management Server.

        A confirmation dialog is displayed with a list of jobs that are currently running. When you restart Lenovo XClarity Administrator, the jobs are canceled.

      2. Click Restart.

        When Lenovo XClarity Administrator shuts down, connectivity to Lenovo XClarity Administrator is lost.

      3. Wait a few minutes for Lenovo XClarity Administrator to restart, and then log in again.

    • Restart Lenovo XClarity Administrator from the hypervisor after a shutdown:

      • Microsoft Hyper-V

        1. From the Server Manager Dashboard, click Hyper-V.
        2. Right-click the server, and click Hyper-V Manager.
        3. Right-click the virtual machine, and click Start.

          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
            ... ...


        4. Log in to Lenovo XClarity Administrator (see Logging in to XClarity Administrator).

      • VMware ESXi

        1. Connect to the host through VMware vSphere Client.
        2. Right-click the virtual machine, and click Power > Power on.
        3. Click the Console tab.

          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
            ... ...


        4. Log in to Lenovo XClarity Administrator (see Logging in to XClarity Administrator).

After you finish

When Lenovo XClarity Administrator restarts, it recollects inventory for each managed device. Wait approximately 30-45 minutes, depending upon the number of managed devices, before attempting firmware updates, configuration pattern deployments, or operating-system deployments.