Updating XClarity Orchestrator

To XClarity Orchestrator v2.1

XClarity Orchestrator v2.1 requires a minimum of 8 virtual processor cores. If you are managing 1,000 or more devices, ensure that you increase the number of virtual processor cores before starting the update process.

This update takes more time than usual due to a database upgrade. If you receive a time-out message or are unable to reach the page when attempting to go the user interface, the update has not completed.

To XClarity Orchestrator v2.0

The minimum storage required for the virtual appliance is a total of 551 GB across three attached disks. You must also attach a third disk (disk 2) with a minimum of 200 GB.

The XClarity Orchestrator virtual appliance must be powered off before adding a new hard disk.

To add a new hard disk to the virtual appliance, complete the following steps.

• For ESXi using VMware vSphere
  1. Connect to the host through VMware vSphere Client.
  2. Power off the XClarity Orchestrator virtual machine.
  3. Right-click the virtual machine, and click Edit Settings.
  4. Select Add a new Device > Hard Disk.
  5. Change the size to 200 GB.
  6. Click OK.
  7. Power on the XClarity Orchestrator virtual machine.
• For ESXi using VMware vCenter
  1. Connect to the host through VMware vCenter.
  2. Power off the virtual machine.
  3. Open the virtual machine’s settings, and click Add.
  4. Click Hard Disk > Create a new Virtual Disk.
  5. Select SCSI for the disk format.
  6. Configure the HDD capacity to 200 GB.
  7. Click OK.
  8. Power on the virtual machine.
• For Microsoft Hyper-V
  1. From the Server Manager Dashboard, click Hyper-V.
  2. Right-click the server, and click Hyper-V Manager.
  3. Select the XClarity Orchestrator virtual machine, and click Shut Down in the Actions pane.
  4. Click Settings to display the Settings dialog.
  5. Select IDE Controller 1.
  6. From the right pane, select Hard Drive, and then click Add to add a new hard disk.
  7. From the right pane, select Virtual hard disk (.vhd) file, and then click New to display the New Virtual Hard Disk Wizard.
  8. Complete the wizard as prompted. Ensure that you specify a disk-drive name using .vhd format (for example, LXCO-disk3.vhd) and set the size to 200 GB.
  9. Select the XClarity Orchestrator virtual machine, and click Start in the Actions pane.

• Updating to XClarity Orchestrator v1.3 might take two hours or more to complete. To determine whether the update is complete, click Maintenance > Orchestrator Server Updates, and verify that the new release is listed and that the Applied Status is no longer “Applying”.
• Attention: Before updating XClarity Orchestrator to v1.3, ensure that the XClarity Orchestrator virtual appliance hostname is lxco and no domain name set on the DNS Configuration card on the Administration () > Networking page.
• Users that are assigned the Supervisor role are added to the SupervisorGroup user group during the update (see Creating user groups).
• Users that are assigned the Operator role are added to the OperatorLegacyGroup user group during the update. The OperatorLegacyGroup user group is associated with the Operator Legacy role, which gives users the same privileges as the Operator role in the previous releases. The Operator Legacy role and OperatorLegacyGroup user group will be deprecated in a future release (see Creating user groups).

  Existing user groups are assigned to the Operator role during the update (see Controlling access to functions).

• Creating rules for raising custom analytics alerts is simplified in XClarity Orchestrator v1.3. Existing custom alert rules are not migrated to the new format and will be lost after the update completes.

• Users that are assigned the Supervisor role are added to the SupervisorGroup user group during the update (see Creating user groups).
• Users that are assigned the Operator role are added to the OperatorLegacyGroup user group during the update. The OperatorLegacyGroup user group is associated with the Operator Legacy role, which gives users the same privileges as the Operator role in the previous releases. The Operator Legacy role and OperatorLegacyGroup user group will be deprecated in a future release (see Creating user groups).

  Existing user groups are assigned to the Operator role during the update (see Controlling access to functions).

• Creating rules for raising custom analytics alerts is simplified in XClarity Orchestrator v1.3. Existing custom alert rules are not migrated to the new format and will be lost after the update completes.
• The minimum storage required for the virtual appliance is a total of 301 GB across two attached disks. You must increase the storage for the disk 0 to a minimum of 251 GB. You must also attach a second disk (disk 1) with a minimum of 100 GB.

  The XClarity Orchestrator virtual appliance must be powered off before adding a new hard disk.

  To add a new hard disk to the virtual appliance, complete the following steps.

  • For ESXi using VMware vSphere
    1. Connect to the host through VMware vSphere Client.
    2. Power off the XClarity Orchestrator virtual machine.
    3. Right-click the virtual machine, and click Edit Settings.
    4. Select Add a new Device > Hard Disk.
    5. Change the size to 100 GB.
    6. Click OK.
    7. Power on the XClarity Orchestrator virtual machine.
  • For ESXi using VMware vCenter
    1. Connect to the host through VMware vCenter.
    2. Power off the virtual machine.
    3. Open the virtual machine’s settings, and click Add.
    4. Click Hard Disk > Create a new Virtual Disk.
    5. Select SCSI for the disk format.
    6. Configure the HDD capacity to 100 GB.
    7. Click OK.
    8. Power on the virtual machine.
  • For Microsoft Hyper-V
    1. From the Server Manager Dashboard, click Hyper-V.
    2. Right-click the server, and click Hyper-V Manager.
    3. Select the XClarity Orchestrator virtual machine, and click Shut Down in the Actions pane.
    4. Click Settings to display the Settings dialog.
    5. Select IDE Controller 0.
    6. From the right pane, select Hard Drive, and then click Add to add a new hard disk.
    7. From the right pane, select Virtual hard disk (.vhd) file, and then click New to display the New Virtual Hard Disk Wizard.
    8. Complete the wizard as prompted. Ensure that you specify a disk-drive name using .vhd format (for example, LXCO-disk2.vhd) and set the size to 100 GB.
    9. Select the XClarity Orchestrator virtual machine, and click Start in the Actions pane.

• All users are automatically added to the SupervisorGroup user group. All users have supervisor privileges by default after the update completes. A supervisor user can remove supervisor privileges for other users that should not have those privileges (see Creating user groups).
• Existing external LDAP configurations are removed. You must reconfigure external LDAP authentication servers after the update completes (see Setting up an external LDAP authentication server).