Preparing for the upgrade

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

Perform the following procedure on the UCP Advisor VM:

Take a snapshot of the UCP Advisor VM and verify that the datastore has approximately 360 GB of additional available space to manage the snapshots.
Verify that there is SSH connectivity to the UCP Advisor VM to ensure the VM is up and running.
Verify that the UCP Advisor VM meets the resource requirements. See UCP Advisor resource requirements.
Verify that the UCP Advisor VM and the SCP server are configured with their respective IP addresses. No other custom IP addresses should be configured.
Verify that the required ports on the UCP Advisor VM is not blocked by the firewall. See Firewall configuration required by the management node.
Delete any old firmware bundles from the UCP Advisor VM.
Upgrade the Remote Gateway VM. See Upgrading the Remote Gateway VM
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 UCP Advisor VM as a ucpadmin user.
Copy the ucpadvisor-air-gapped-v4.8.0.dev-96.tar.gz file to /tmp folder.

Navigate to the /tmp 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-air-gapped-v4.8.0.dev-96.tar.gz

On a baremetal server: Add the bare metal server IP address to the apiserver_advertise_address parameter. Perform the following steps:
1. Log on to the bare metal server.
2. Navigate to the /installer folder.
3. Open the config.toml file in edit mode. Enter:
```
vi config.toml
```
4. Add the bare metal server IP address to the apiserver_advertise_address parameter. Enter:
```
apiserver_advertise_address=Bare_Metal_Server_IP Address"
```
5. Exit the edit mode. Press the Esc key.
6. Save the changes: Enter:
```
:wq
```
Relogin to the UCP Advisor VM as a root user.
Navigate to the /root folder and delete the os_upgrade folder, if present.
Relogin to the UCP Advisor VM as a ucpadmin user.
Update the UCP Advisor 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 UCP Advisor 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 <UCP Advisor VM IP address> -u <Node username> -p <Node password>
```
  After the UCP Advisor VM is successfully updated, the following message is displayed:
```
RPMs installed on master node <UCP Advisor VM IP address>
Time taken xxx Minutes
```
  On a baremetal server, you must set permissions for the ucpadmin user to perform the upgrade. Enter the following commands as a root user:
```
chmod 777 set_Permissions_pre_OS_upgrade.sh
./set_Permissions_pre_OS_upgrade.sh 
```
  Enter the UCP Advisor username and password when prompted.
3. Reboot the UCP Advisor VM:
```
sudo /opt/ekco/shutdown.sh && sudo reboot now
```
4. Verify the kernel version: Enter:
```
$ uname -r
4.18.0-553.79.1.el8_10.x86_64
```
(Optional) Generate and download the log bundle and any reports that you want to keep.
(Optional) Provision a new command device or update the existing command device on the UCP Advisor VM. See Provisioning a command device for the UCP Advisor VM before installing UCP Advisor.
If you have an external Gateway VM configured, then you must update it to the latest version before upgrading the UCP Advisor management software. See Updating the external Gateway VM.
(Optional) If you want to provision an operating system on a server, you must add and mount a hard disk of 150 GB to the UCP Advisor VM. See Partitioning additional hard disk on UCP Advisor VM.