Deploying the UCP Advisor Gateway VM to a remote site

Unified Compute Platform (UCP) Advisor Software Installation Guide

Version
4.6.x
Audience
anonymous
Part Number
MK-92UCP120-15
Deploy a UCP Advisor Gateway VM on each remote site in your multisite environment.
Note: If you have already downloaded the Upgrade-Advisor4.6.zip package to upgrade UCP Advisor, you can skip downloading the UCP Advisor Remote Gateway as the Upgrade-Advisor4.6.zip package also contains the following files:
  • ucpadvisor-gateway-air-gapped-v4.6.0.141.tar.gz.
  • Hitachi-UCP-Advisor-Gateway-9.4.0.ova
Download the following files from the Hitachi Support Connect Portal:
  1. Ensure that you have a flat management networking scheme or that there is a route between the hardware management VLAN and the management VM VLAN.
  2. Log on to Hitachi Support Connect Portal using your credentials.
  3. On the Software Download tab, select UCP Advisor.
  4. From the Versions list, select version 4.6.0.
  5. Locate and download the UCP Advisor Remote Gateway , Remote-Gateway-Advisor4.6.zip to a local directory on your laptop.
  6. Extract the Remote-Gateway-Advisor4.6.zip file, which includes the following files:
    • ucpadvisor-gateway-air-gapped-v4.6.0.141.tar.gz.
    • Hitachi-UCP-Advisor-Gateway-9.4.0.ova
  1. Right-click the host, and then select Deploy OVF Template.

    Deploy OVF template

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

    Select the OVF template

  3. Navigate to the Remote-Gateway-Advisor4.6\Multi-site-GatewayOVA\Hitachi-UCP-Advisor-Gateway-9.4.0.ova.
    Note: If you are using the Hitachi-UCP-Advisor-Gateway-9.4.0.ova file from the upgrade package, navigate to the Upgrade-Advisor4.6\Multi-site-GatewayOVA\Hitachi-UCP-Advisor-Gateway-9.4.0.ova folder.
  4. Click Open, and then click Next.

    OVF template selected

  5. Enter a unique name for the remote gateway VM, or accept the default name. The target location is selected by default. Click Next.

    Select the name and target folder

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

    Select a compute resource

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

    Review the deployment details

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

    Select storage

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

    Select the VM network

  10. Enter the remote gateway VM settings, and then click Next.

    Enter the remote gateway VM settings

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

    Review the UCP Advisor Gateway VM settings

    Wait for the OVA deployment to complete.

  12. Power on the remote gateway VM.
    Wait approximately 5 minutes while the remote gateway VM is being configured and the IP address become reachable over the network.
  13. Take a VMware snapshot of the remote gateway VM.
  14. (Optional) Attach the command devices to the remote gateway VM.
  15. Log on to the remote gateway VM as ucpadmin.
  16. Navigate to the Remote-Gateway-Advisor4.6 folder and copy the ucpadvisor-gateway-air-gapped-v4.6.0-141.tar.gz file to the /home/ucpadmin folder on the remote gateway VM, and then extract the installer package. Enter:
    tar -xzvf ucpadvisor-gateway-air-gapped-v4.6.0.141.tar.gz
    Note: If you are using the ucpadvisor-gateway-air-gapped-v4.6.0-141.tar.gz file from the upgrade package, navigate to the Upgrade-Advisor4.6\ucpadvisor-gateway-air-gapped-v4.6.0-141.tar.gz folder.
  17. Navigate to the /installer folder.
  18. Install the remote gateway VM. Enter one of the following commands:
    To enter the username and password in the command :
    ./installer -m <Remote Gateway VM IP address> -u <username> -p <password>
    Note: This command will also detect all the provisoned command devices and attach them during installation.
    To attach specific command devices during installation:
    ./installer -m <remote gateway IP address> -u <username> -p <password> -c sda sdb
    To enter the username and password when prompted:
    ./installer -m <remote gateway IP address> -P -c sda sdb
    After a successful installation, the following mesaage is displayed:
    Removing footprints of deployment on node <Node IP Address>
     1. Congratulations, the installation is successful.
     2. Current SSH session is only used for installation. Please open another SSH session for other operations, such as kubectl/helm operation.
Verify that the pods are in the Running state.
  1. Using SSH, log on to the remote gateway VM.
  2. Run the following command:
    kubectl get pods -n ucp
    Sample output:
    NAME                                                  READY   STATUS RESTARTS   AGE
    ucpadvisor-cert-manager-cainjector-588658dff9-wvw9b             1/1     Running     0   12m
    ucpadvisor-cert-manager-7bdb7cc6d-skslf                         1/1     Running     0   12m
    ucpadvisor-postgresql-0                                         1/1     Running     0   12m
    ucpadvisor-cert-manager-webhook-559d5d454b-s7qfb                1/1     Running     0   12m
    ucpadvisor-postgresql-keycloak-0                                1/1     Running     0   12m
    redis-master-0                                                  1/1     Running     0   12m
    ucpadvisor-kong-init-migrations-ztfsn                           0/1     Completed   0   12m
    timescaledb-0                                                   1/1     Running     0   12m
    hv-sdi-gateway-vssb-6c68877cdc-r7gvp                            1/1     Running     0   12m
    hv-sdi-gateway-compute-metrics-7ff7989b5b-wf27b                 1/1     Running     0   12m
    scp-server-6779965669-zv4nm                                     1/1     Running     0   12m
    sdi-gateway-network-6f48b6c9cf-cff62                            1/1     Running     0   12m
    sdi-gateway-compute-84ff49955c-hprxd                            1/1     Running     0   12m
    ucpadvisor-kong-df449cfc9-lps7s                                 2/2     Running     0   12m
    ucpadvisor-metrics-server-76bbdbd8bc-znd7c                      1/1     Running     0   12m
    filemanager-66655f8f78-tdrhl                                    1/1     Running     0   12m
    sdi-gateway-block-5844cf89f4-qfp8v                              1/1     Running     0   12m
    monitoring-6c775cddf9-rlcgj                                     1/1     Running     0   12m
    day0-656bcf44bc-qxzfn                                           2/2     Running     0   12m
  3. (Optional) Log on to https://<Remote Gateway VM IP address>:8444/services/cmd-devices to verify that the command devices are attached to the remote gateway VM.