5 Installing ACSLS 8.4

ACSLS 8.4 installation is covered in detail in the StorageTek Automated Cartridge System Library Software 8.4 Installation Guide. To install ACSLS 8.4, follow this high level procedure.

Installing on the First Node

Download ACSLS 8.4 to the /opt directory on each server.
Unzip the downloaded zip file.

Confirm that the acslspool is mounted on the current node

# zfs list
NAME                     USED  AVAIL  REFER  MOUNTPOINT
acslspool               1.60G  47.4G  1.60G  /export/home
rpool                   6.97G  60.0G  4.58M  /rpool
rpool/ROOT              4.39G  60.0G    31K  legacy
rpool/ROOT/solaris      4.39G  60.0G  3.17G  /
rpool/ROOT/solaris/var  1.22G  60.0G  1.21G  /var
rpool/VARSHARE          95.5K  60.0G  95.5K  /var/share
rpool/dump              1.55G  60.0G  1.50G  -
rpool/swap              1.03G  60.0G  1.00G  -
node2:# clrg resume acsls-rg

Go into the ACSLS installation directory and run the package installation script:
```
# cd /opt/ACSLS_8.4.0
# ./pkg_install.sh
```
Observe /etc/passwd on this node. Take note of the user and group id numbers assigned to users acsss, acssa, and acsdb.
```
# tail -3 /etc/passwd
# grep acsls /etc/group
```
When installing on the adjacent node, confirm that the assigned user id numbers on the second node agree with the corresponding id numbers listed here.
Source the ACSLS environment and run the package installation script.
```
# . /var/tmp/acsls/.acsls_env
# cd $ACS_HOME/install
# ./install.sh
```
Note:
When the install script prompts for the database backup directory, specify a directory that is mounted to the shared disk array. Use any path under the ACSLS installation directory ($installDir). For example, if installing ACSLS in /export/home, use /export/home/backup for the database backup files.

Confirm that the attached library is connected.

# su - acsss
$ testlmutcp <library ip address>

Run the library configuration routine.
```
$ acsss_config
```
Check for any patch update to ACSLS 8.4. If a patch exists, download and install it as directed.
Export the acslspool from the current node.
```
$ exit
# cd /
# zpool export acslspool
```
This operation fails if any users or operations are currently active in the ACSLS file system.

Installing on the Adjacent Node

While most of the files in the STKacsls package are extracted to the shared disk array (where these files have already been installed), it remains necessary to install ACSLS 8.4 on the adjacent node since ACSLS users are added to each node and numerous system files (such as SMF start/stop scripts, cron jobs) must be installed on each node.

Log in to the adjacent node and import the acslspool.
```
# zpool import acslspool
```
If this operation fails, try zpool import -f acslspool.
Go into the ACSLS package installation directory and install the package.
```
# cd /opt/ACSLS_8.4.0
# ./pkg_install.sh
```
The install routine advises you that some ACSLS files already exist in the installation directory (on the shared drive). You can choose to over-write them.
Observe the user and group ids that were assigned on this node for users acsss, acssa, and acsdb.
```
# tail -3 /etc/passwd
# grep acsls /etc/group
```
Confirm that these numbers agree with those assigned on the first node. By default the GID should be 100, but this number will change if GID 100 is already in use.

It is important that the UID and GID numbers agree between the two nodes. If these numbers are different on the second node, edit the /etc/passwd file so that the UID and GID numbers on the second node agree with those on the first node.

Now confirm that the group id of the files in $ACS_HOME have group ownership of acsls. If they do not, then it is necessary to uninstall and reinstall the STKacsls package.
```
# pkgrm STKacsls
# pkgadd STKacsls
```
Inherit the ACSLS environment and run the install shell script.
```
# . /var/tmp/acsls/.acsls_env
# cd $ACS_HOME/install
# ./install.sh
```
Note 1: When the install script prompts for the database backup directory, specify a directory that is mounted to the shared disk array. Use any path under the ACSLS installation directory ($installDir). For example, if installing ACSLS in /export/home, use /export/home/backup for the database backup files.

Note 2: When running install.sh on the second node, it is not necessary to reinstall the ACSLS GUI. When the install script advises that the Acsls GUI Domain already exists for the GUI, simply say no to the prompt to reinstall the GUI, and be sure to say no to the prompt to remove the GUI.
If a patch to ACSLS 8.4 was added on the first node, repeat the patch install on this node.

Confirm that the attached library is connected.

# su - acsss
$ testlmutcp <library ip address>

Run the library configuration routine.
```
$ acsss_config
```
To enable redundancy between the HA server and the library, refer to Figure 2-1, "Single HBCr Library Interface Card Connected to Two Ethernet Ports on each Server Node" or Figure 2-2, "Dual-HBC Configuration on a Library with Redundant Electronics". When running acsss_config (option-8), be sure to define two connections to each ACS and enter the library IP address for each connection.