10 Installing, Upgrading, and Removing Software Components

This chapter describes procedures to follow when upgrading or removing the various components associated with ACSLS HA.

Installing Patches for ACSLS

To install patches for the STKacsls package:

Suspend cluster control.
```
# clrg suspend acsls-rg
```
Download the patch to the /opt directory and unzip the package.
Go into the /opt/ACSLS_8.x.x directory and follow the instructions in the patch README.txt file.

Disable ACSLS operation and switch control to the adjacent node.

# su - acsss
$ acsss shutdown
$ exit
# cd /opt/ACSLSHA/util
# acsAgt nodeSwitch

Install the ACSLS patch on the new node.
Apply ACSLS HA changes to the updated ACSLS structure.
```
# cd /opt/ACSLSHA/util
# ./copyUtils.sh
```
Enable the ACSLS services
```
# su - acsss
# acsss enable
```
Resume cluster control of the acsls-rg resource group.
```
# clrg resume acsls-rg
```

Removing the ACSLS Package

Removal of the ACSLS package may be necessary in cases of an ACSLS upgrade. To do so, it is necessary to disable cluster control, halt ACSLS services on both nodes, then remove the package on each node. Use the following procedure:

Suspend Cluster control.
```
node1:# clrg suspend acsls-rg
```

On the active node, shutdown ACSLS.

node1:# su - acsss
node1:$ acsss shutdown
node1:$ exit
node1:#

Export the file system on the shared disk array.
```
node1:# cd /
node1:# zpool export acslspool
```
This operation fails when logged in as user acsss.
Log in to the alternate node and import the shared disk array.
```
node1:# ssh <alternate node>
node2:# zpool import acslspool
```

Shutdown ACSLS

node2:# su - acsss
node2:$ acsss shutdown
node2:$ exit
node2:#

Remove the STKacsls package.
```
node2:# pkgrm STKacsls
```
Return to the original node and remove the STKacsls package.
```
node2:# exit
node1:# pkgrm STKacsls
```

Installing Upgrade Releases of ACSLS

It is necessary to remove the STKacsls package on both nodes before installing a new release of ACSLS. Refer to the procedure detailed in the section above. To install a new package, follow this procedure:

Download the STKacsls package to the /opt directory and unzip the package. Repeat this step on the alternate node.
With Solaris Cluster suspended, ensure that the shared disk array (acslspool) is mounted to the current node.
```
node1:# zpool list
```
If the acslspool is not mounted, login to the alternate node. If it is not mounted to either node, import the acslspool.
Go into the /opt/ACSLS_8.x.x directory and follow the instructions in the README.txt file.
Export the acslspool.
```
node1:# zpool export acslspool
```
This operation fails if logged in as user acsss.
Log in to the alternate node and repeat steps 1 through 3.
Go to the /opt/ACSLSHA/util directory and run copyUtils.sh.
```
node2:# cd /opt/ACSLSHA/util
node2:# ./copyUtils.sh
```

Start up ACSLS library control.

node2:# su - acsss
node2:$ acsss enable
node2:$ exit
node2:#

Resume cluster control of the acsls resource group.
```
node2:# clrg resume acsls-rg
```

Reinstalling ACSLS HA or Installing Upgrades

Reinstalling the SUNWscacsls package requires the halting of ACSLS library operation and taking the acsls-rg resource group offline.

Shutdown ACSLS.
```
# su - acsss
$ acsss shutdown
$ exit
#
```

Save any customized changes to ha_list.txt and pingpong_interval.

# cd $ACS_HOME/acslsha
# cp ha_list.txt ha_list.save
# cp pingpong_interval pingpong_interval.save

Bring the acsls-rg resource group offline.
```
# clrg offline acsls-rg
```
This action unmounts the acslspool from the ZFS file system

Unconfigure the acsls-rg resource group.

# cd /opt/ACSLSHA/util
# ./acsAgt unconfigure

Download and unzip the updated SUNWscacsls package to both nodes.
Remount the acslspool to either of the two nodes.
```
# zpool import -f acslspool
```
Start ACSLS to verify proper functionality.
```
# su - acsss
$ acsss enable
$ exit
#
```
Run the copyUtils.sh utility.
```
# cd /opt/ACSLSHA/uti
# ./copyUtils.sh
```

Restore any customized files you saved in step 2.

# cd $ACS_HOME/acslsha
# cp ha_list.save ha_list.txt
# cp pingpong_interval.save pingpong_interval

Configure the acsls-rg resource group.
```
# cd /opt/ACSLSHA/util
# ./acsAgt configure
```
This action stops and restarts ACSLS

Within minutes, the command clrg status should reveal that the acsls-rg resource group is back online and ACSLS is operational.

Upgrading Solaris Cluster

Before removing or upgrading Solaris Cluster, bring down ACSLS and unconfigure the acsls-rg resource group.

# su - acsss
$ acsss shutdown
$ exit
# cd /opt/ACSLSHA/util
# ./acsAgt unconfigure

Consult the current Solaris Cluster documentation for specific upgrade procedures. The general command to upgrade Solaris Cluster is:

# scinstall -u

Once your Solaris Cluster installation has been updated, configure the acsls-rg resource group:

# cd /opt/ACSLSHA/util
# ./acsAgt configure

Removing Solaris Cluster

Bring down ACSLS and the acsls-rg resource group.

# su - acsss
$ acsss shutdown
$ exit
# cd /opt/ACSLSHA/util
# ./acsAgt unconfigure

Reboot both nodes into a non-cluster mode.
```
# reboot -- -x
```
When both nodes are up, log in from either node and remove the Solaris Cluster package.
```
# scinstall -r
```