Installing the UCP Advisor software on a virtual machine

Deploy the UCP Advisor OVA, and then run the installation script on the UCP Advisor VM to install the UCP Advisor software on a virtual machine.

1. Log on to vSphere Client using your credentials, and then navigate to the ESXi host where you want to deploy the OVA file.
2. Right-click the host, and then select Deploy OVF Template.
   
   

   

   
   
3. Select the Local file option, and then click Upload Files.
   
   

   

   
   
4. Navigate to the Advisor4.6\Software\Hitachi-UCP-Advisor-Standalone-VM-OVA\Hitachi-UCPAdvisor-4.6.0.ova. Click Open, and then click Next.
5. Enter a unique name for the virtual machine, or accept the default name. The target location is selected by default. Click Next.
   
   

   

   
   
6. The compute resource is selected by default. Click Next.
   
   

   

   
   
7. Review the deployment details, and then click Next.
   
   

   

   
   

   Note: Click Ignore to ignore the certificate warnings.
8. Select a datastore, review the virtual disk format, and then click Next.
   
   

   

   
   
9. Select the VM Network, and then click Next.
   
   

   

   
   
10. Enter the UCP Advisor VM settings, and then click Next.
    
    

    

    
    

    Important:

    • Verify that the host name does not include an underscore (_).
    • The ucpadmin user SSH password for logging on to the UCP Advisor VM must not contain a dollar sign ($) or an ampersand (&).
11. Review the UCP Advisor VM settings, and then click Finish to deploy the OVA.
    
    

    

    
    

    Wait for the OVA deployment to complete.

12. Power on the UCP Advisor VM.
    Wait approximately 10 minutes while the UCP Advisor VM is being configured and the IP address become reachable over the network.
13. Power off the UCP Advisor VM.
14. (Optional) Attach the command devices to the UCP Advisor VM. See Provisioning a command device for the UCP Advisor VM before installing UCP Advisor.
    Note: This is not applicable for a UCP hyperconverged (HC) system.
15. Take a VMware snapshot of the UCP Advisor VM.
16. Power on the UCP Advisor VM.
17. Log on to the UCP Advisor VM as ucpadmin.
18. Verify that the disk attribute property for the command device that you are trying to add is set to OPEN-V-CM. Enter:
    lsscsi -i

    Sample output:

    [ucpadmin@UCPAdvisorMasterHost105 ~]$ lsscsi -i
    [1:0:0:0]    disk    VMware   Virtual disk     2.0   /dev/sda   -
    [1:0:1:0]    disk    VMware   Virtual disk     2.0   /dev/sdb   -
    [1:0:2:0]    disk    HITACHI  OPEN-V-CM        5001  /dev/sdc   360060e80282742005080274200000049
    [1:0:3:0]    disk    HITACHI  OPEN-V-CM        A301  /dev/sdd   360060e8028273e005080273e0000000a

    If the disk attribute property for the command device that you are trying to add is set to OPEN-V, you cannot provision it. Re-create the command device:

    1. Remove the command device from the UCP Advisor VM and the ESXi host.
    2. Create a new command device on the storage device, and assign it to ESXi host.
    3. Add the command device as a RDM disk to the UCP Advisor VM.
    4. Verify the disk attribute property of the command device again.
19. Navigate to the Advisor4.6\Software folder and copy the ucpadvisor-air-gapped-v4.6.0-141.tar.gz file to the /home/ucpadmin folder on the UCP Advisor VM, and then extract the installer package. Enter:

    tar -xvzf ucpadvisor-air-gapped-v4.6.0-141.tar.gz

20. Navigate to the /installer folder, and then install UCP Advisor. Enter:

    sudo ./installer -m <UCP Advisor VM IP address> [-P|<-u <username> -p <password>] [-c <command devices list>] -s <SCP server IP address> [-lsd SDX]

    where:

    • -m: UCP AdvisorVM IP address
    • -P | <-u -p>: If you use the -u -p flags, you must enter the username and password in the command. However, if you use the -P flag, then you must enter the username and password when prompted.
    • -c: (Optional) Specify the list of command devices that must be used.
      Note: This is not applicable for a UCP hyperconverged (HC) system.
    • -s: Enter a free IP address to configure the SCP server.
      Note: The SCP server will be used for UCP Advisor internal operations such as switch back up and restore and switch firmware upgrade.
    • -lsd: (Optional) Specify if you want to use LVM to back up or restore the /root disk partition. Use the 200 GB Linux device to create the LVM snapshot.

    For example:

    sudo ./installer -m 192.168.10.10 -u ucpadmin -p Password -c sdc sdd -s 192.168.10.20 -lsd sdb

    Note:

    • Command devices that are already attached to the UCP Advisor VM are automatically detected during UCP Advisor installation.
    • By default the installer script installs a new instance of UCP Advisor. Any previous or existing UCP Advisor installations are removed.
    • If you want to install UCP Advisor as a root user, you must log on to the UCP Advisor VM with the root user credentials.
    After UCP Advisor is successfully installed, the following message is displayed:

    Congratulations, the installation is successful. The UCP Advisor console UI should be available at https://<UCP Advisor VM IP address>
    In future, if user wants to add or remove command device, must do it on <UCP Advisor VM IP address>

    Note:

    • The LVM snapshot is automatically deleted after a successful UCP Advisor installation.
    • If you see socket error during UCP Advisor installation, revert the VMware snapshot, verify that the status of the vCenter resources are Normal, and then retry installing UCP Advisor.