Preparing for the upgrade

Unified Compute Platform (UCP) Advisor Software Installation Guide

Version

4.6.x

Audience

anonymous

Part Number

MK-92UCP120-15

Perform the following procedure on the UCP Advisor VM:

Take a snapshot of the UCP Advisor VM and verify that the datastore has approximately 300 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.
From the Hitachi Support Connect Portal (login required), download the UCP Advisor upgrade package, Upgrade-Advisor4.6.zip to a local directory on your laptop.
Extract the Upgrade-Advisor4.6.zip file, which includes the following files:
- ucpadvisor-air-gapped-v4.6.0-141.tar.gz
- ucpadvisor-gateway-air-gapped-v4.6.0.141.tar.gz.
- Hitachi-UCP-Advisor-Gateway-9.4.0.ova
Log on to the UCP Advisor VM as a ucpadmin user.
Copy the ucpadvisor-air-gapped-v4.6.0-141.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-air-gapped-v4.6.0-141.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.
From the Hitachi Support Connect Portal (login required), download the UCP Advisor Oracle Linux OS Upgrade Package, ucpa_os_upgrade_pkg_4.6-0423.tar.gz, and then copy it to the /home/ucpadmin folder on the UCP Advisor VM.
Navigate to the /home/ucpadmin folder on the UCP Advisor VM and run the following commands to update the UCP Advisor VM with Oracle Linux 8.9 update:
```
tar –xvzf ucpa_os_upgrade_pkg_4.6-0423.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.
Run the following command to update the kernel to the latest version:
```
sudo grubby --set-default /boot/vmlinuz-4.18.0-513.24.1.el8_9.x86_64
```

Reboot the UCP Advisor VM:

sudo /opt/ekco/shutdown.sh && sudo reboot now

(Optional) Generate and download the log bundle and any reports that you want to keep.
(Optional) Identify the node for the command device. Enter the following command on the UCP Advisor VM:
```
kubectl get node -o wide -l app=ucp
```
(Optional) Provision a new command device or update the existing command device on the UCP Advisor VM obtained in step 16. 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.