Cluster Upgrade

There are 2 main scenarios that affect the way a cluster can be upgraded. Where the engineer has access to the root account and where they do not have access to the root account. Cloudian Certified Engineers must be familiar with both methods

Root Account Enabled Upgrade

Download Upgrade Contents

Info

In a real world scenario you need to use your existing HyperStore license when extracting the binaries, this will be available for download from the customer portal or on your running system. Care must be taken to ensure you select the correct license from those available to you.

Instructions

To simplify matters we will download all files required for the upgrade
Login using SSH to your puppet master using root credentials
Change to the CloudianPackages folder
```
cd /root/CloudianPackages/
```

Create an upgrade directory and change to this new directory

mkdir binaries7.5.3
cd binaries7.5.3

Download the following files:
Cloudian HyperStore binary
Cloudian lab mem74 script

wget --user=admin --password=cloudian123 http://10.150.1.252:8080/images/CloudianHyperStore-7.5.3.bin  
wget --user=admin --password=cloudian123 http://10.150.1.252:8080/infra/mem74.sh

We also need to use the actual system license to extract the binaries. As we know the exact name of the license used in the lab we can go ahead and copy this now
In a live environment you muct ensure that the correct license is used to prevent overwriting the existing one.
```
cp /opt/cloudian/conf/cloudian_license.lic .
```

Extract the binaries

Instructions

Use the chmod command to make the Cloudian HyperStore binary executable
For the lab only, we will also make the mem74 script executable

chmod +x *.bin *.sh

1. Ensure the file is executable

ll

1. Extract binary against the downloaded current license key

./CloudianHyperStore-7.5.3.bin cloudian_12345.lic

Rerun Memory Tunables (LAB ONLY!)

Warning

As mentioned in previous labs, it is critical that mem74.sh is run immediately after unpacking and before running the installer. Failure to run this script may make your lab environment unresponsive and likely require the nodes to be terminated and recreated requiring you to setup all your networking again

Instructions

Run the shell mem74.sh script and check the tuneables have been set by viewing the relavent line in the common.csv file

./mem74.sh
grep heap /etc/cloudian-*-puppet/manifests/extdata/common.csv

Hyperstore upgrade

Instructions

Once extracted, run the cloudianInstall.sh from the extracted contents from the /opt/cloudian-staging/7.5.3/ directory
```
/opt/cloudian-staging/7.5.3/cloudianInstall.sh
```
You will be presented with a menu, and an option to upgrade from 7.5.2 to 7.5.3
Select this option (3)
When asked to run basic tests, type no
When asked if you want to proceed with upgrade, type yes
Monitor the upgrade

Root Account Disabled Upgrade

Configure HSH if not already completed

Instructions

SSH into your Config / Installer node (Node 1) as root
Check / Ensure HSH is currently disabled by running
```
hsctl config get hsh.enabled
```
Enable HSH by running
```
hsctl config set hsh.enabled=true
```
Apply the new config to all nodes in the cluster
```
hsctl config apply hsh
```
Exit the root ssh session. We will not disable the root account yet as we have other tasks coming later that require root access.
```
exit
```

Download Upgrade Contents

Info

Within the labs we have mounted some external media which houses the required files. You will need to mount your own drive or copy over the files using SCP or similar.

Additionally in a real world scenario you need to use your existing HyperStore license when extracting the binaries, this will be available for download from the customer portal. Care must be taken to ensure you select the correct license from those available to you.

Instructions

SSH into your Config / Installer node (Node 1) as sa_admin
look at your working directory by running
```
pwd
```
create a new directory for the files required for the upgrade
```
mkdir CloudianPackages7.5.3
```
Change to that new directory
```
cd CloudianPackages7.5.3
```

copy the following files

cp /studentfiles/CloudianHyperStore-7.5.3.bin .
cp /studentfiles/CloudianHyperStore-7.5.3.bin.sig . 
cp /studentfiles/cloudian_12345.lic .

Make the Binary file executable
```
chmod +x CloudianHyperStore-7.5.3.bin
```
Ensure file is executable
```
ls -l
```

Software Upgrade

Instructions

Extract binary by executing

hsrun --root CloudianHyperStore-7.5.3.bin cloudian_12345.lic

Warning

Ensure that the version you are unpacking is the version you are upgrading to. Unpacking an older binary version (such as your current deployment version) will cause problems with your cluster.

Instructions

Once extracted, you will get an output such as the one in the screenshot above.
Exit your legacy SSH session

Instructions

SSH into your Config / Installer node (Node 1) as sa_admin and select "0" to start a new session or "s" to Start a Sessionless Shell using the newly updated HyperStoreShell
Run the suggested command hspkg install
```
hspkg install
```

Instructions

You will be presented with a menu, and an option to upgrade from 7.5.2 to 7.5.3
Type '3' to select the option to upgrade then press Enter
If asked to run basic tests, type No
When asked if you want to proceed with upgrade, type yes

The upgrade will take about 45 minutes to complete.

Instructions

Once the upgrade finishes, you will return to the menu of the cloudianInstall.sh script
Select 'x' to exit the script

Warning

It is important to exit out of the cloudianInstall.sh script when you are done, as other operations done through the CMC will also utilize the same script. If there is a process using the script (such as your terminal), other operations will fail.