Upgrading the Remote Gateway VM

Unified Compute Platform UCP Advisor Software Installation Guide

Version

4.8.x

File Size

6776 KB

Audience

anonymous

Part Number

MK-92UCP120-18

ft:lastEdition

2025-11-06

Take a snapshot of the Remote Gateway VM.
Verify that there is SSH connectivity to the Remote Gateway VM to ensure the VM is up and running.

From the Hitachi Support Connect Portal (login required), download the UCP Advisor upgrade package, Upgrade-Advisor4.8.zip to a local directory on your laptop.
Extract the Upgrade-Advisor4.8.zip file, which includes the following files:
- ucpadvisor-air-gapped-v4.8.0.dev-96.tar.gz
- ucpadvisor-gateway-air-gapped-v4.8.0.dev-96.tar.gz.
Log on to the Remote Gateway VM as a ucpadmin user.
Copy the ucpadvisor-gateway-air-gapped-v4.8.0.dev-96.tar.gz file to /home/ucpadmin folder.
Navigate to the /home/ucpadmin folder, and delete any previous installer folder, if present.
For example:
```
[ucpadmin@<username> ~]sudo rm -rf installer
[sudo] password for ucpadmin:
[ucpadmin@<username> ~]$
```

Extract the upgrade package. Enter:

tar -xvzf ucpadvisor-gateway-air-gapped-v4.8.0.dev-96.tar.gz

Update the Remote Gateway VM with Oracle Linux 8.10:
1. From the Hitachi Support Connect Portal (login required), download the UCP Advisor Oracle Linux OS Upgrade Package, ucpa_os_upgrade_pkg_4.8_10_21_2025.tar.gz, and then copy it to the /home/ucpadmin folder on the Remote Gateway VM.
2. Navigate to the /home/ucpadmin folder on the UCP Advisor VM and run the following commands:
```
tar –xvzf ucpa_os_upgrade_pkg_4.8_10_21_2025.tar.gz
cd os_upgrade
sudo ./upgrade_rpm -m <Remote Gateway VM IP address> -u <Node username> -p <Node password>
```
  After the Remote Gateway VM is successfully updated, the following message is displayed:
```
RPMs installed on master node <Remote Gateway VM IP address>
Time taken xxx Minutes
```
3. Reboot the Remote Gateway VM:
```
sudo reboot
```
4. Verify the kernel version: Enter:
```
$ uname -r
4.18.0-553.79.1.el8_10.x86_64
```
Using SSH, log on to the Remote Gateway VM.
Navigate to the installer directory, and then run the following command to upgrade. At the prompt, enter y.
```
sudo ./installer -U -m <Remote Gateway IP address> -u <Node username> -p <Node password>
```
Note:
- The newly added or existing command devices are automatically provisioned during the Remote Gateway upgrade.
- After upgrading Remote Gateway, it takes about 20 to 25 minutes for the canonical-mass pod to return to the Running state. During this time, the SSH might get disconnected.
After the Remote Gateway is successfully upgraded, the following message is displayed:
```
"Congratulations, the upgrade was successful."
```