Upgrading IBM Spectrum Control in a single-server AIX or Linux environment by using the installation program

You can upgrade IBM Spectrum® Control as a root user or non-root user on an AIX® or Linux® operating system by using the IBM Spectrum Control installation program. To upgrade IBM Spectrum Control as a non-root user, you must have sudo privileges on the target AIX or Linux server.

Before you upgrade, you must back up the entire IBM Spectrum Control system.

Ensure that X Window System is installed on the target AIX or Linux server. The X Window System is required to upgrade IBM Spectrum Control by using the installation program.

If you want to upgrade IBM Spectrum Control as a non-root user, have your system administrator complete the following tasks on the target server before you begin the upgrade:

If you are upgrading IBM Spectrum Control on an AIX server, install sudo on the server. The default AIX distribution does not include sudo privileges. To get the sudo installation package, go to http://www.ibm.com/systems/power/software/aix/linux/toolbox/date.html. Find sudo-version in the Package column, and click RPM to download the package.
Ensure that the non-root user has sudo privileges for the following commands on the server:
- xauth (Enables the non-root user to provide access to their X Window System display for the root user.)
- setup.bin (Enables the non-root user to launch the IBM Spectrum Control installation program.)
You must enter the full path to the commands when you configure the sudo privileges. For example:
```
username	ALL=(root)	SETENV: /usr/bin/xauth, /home/username/Downloads/IBMSC/SC/setup.bin
```
If the sudo environment on the server uses the secure_path option, ensure that the following directories are included in the secure_path value for the non-root user who is upgrading IBM Spectrum Control:
- DB2_instance_owner_home_directory/sqllib/bin (Example: /home/db2inst1/sqllib/bin)
- DB2_instance_owner_home_directory/sqllib/adm (Example: /home/db2inst1/sqllib/adm)
- DB2_instance_owner_home_directory/sqllib/misc (Example: /home/db2inst1/sqllib/misc)
Ensure that the following requirements are met to enable the upgrade of IBM Spectrum Control by using the installation program:
- The non-root user is able to use the X Window System on the target server and the X Window System DISPLAY environment variable is set correctly for the not-root user.
- The DISPLAY environment variable is preserved in the sudo environment.
- The root user has access to the X Window System display that is owned by the non-root user.
These display requirements do not apply if you upgrade IBM Spectrum Control in silent mode.
If you are upgrading IBM Spectrum Control on an AIX server, ensure that the ODMDIR environment variable is preserved in the sudo environment.

Note: If FIPS is enabled on RHEL, run the export JAVA_TOOL_OPTIONS="-Djdk.nativeDigest=false" command before starting the upgrading program.

Log on to the IBM Spectrum Control computer as the root user or as the non-root user who has sudo privileges.
Start the IBM Spectrum Control installation program.
1. Create a directory. Enter:
```
mkdir /SpectrumControl 
```
2. Download the image into the SpectrumControl directory.
3. Extract the IBM Spectrum Control installation image files on the server.
  Linux:
  - Navigate to the directory where the package is located
  - Extract the IBM Spectrum Control installation package
```
tar -xvf SpectrumControl_5.x.x.x_linux_x86_64.tar.gz
```
  AIX:
  AIX 7.3 TL1 or later: Use the native tar command to extract the IBM Spectrum Control installation packages.
  1. Go to the directory that contains the packages.
  2. Extract the installation and license packages:
    gunzip SC_5.x.x.x_aix.tar.gz tar -xvf SpectrumControl_5.x.x.x_aix.tar
  Note: AIX 7.3 TL0 and earlier: Use GNU tar (version 1.14 or later) instead of the native AIX tar. The AIX tar command can truncate long file names and cause installation errors.
  1. Go to the directory that contains the packages.
  2. Extract the installation and license packages with GNU tar:
    /opt/freeware/bin/tar -xvf SC_5.x.x.x_aix.tar.gz
  If GNU tar is not available: Prefer to upgrade the operating system to AIX 7.3 TL1 or later. As a temporary workaround, use the native pax command:
  gunzip -c SC_5.x.x.x_aix.tar.gz | pax -r
4. Ensure that the user name that you plan to use as the IBM Spectrum Control common user is in the system group and the db2iadm1 group.
  If the user name is not in a group, you can add the user as shown in the following command example. In this example, the user name is db2inst1:
```
usermod -G system db2inst1
```
  Tip: If the user is already a member of secondary groups, the usermod command removes the db2inst1 user name from all the secondary groups except for the system group. To preserve the existing secondary group memberships, provide a comma separated list of secondary groups after the -G flag. For more information, enter man usermod at the command prompt.
5. Go to the /SpectrumControl/SC directory:
```
cd /SpectrumControl/SC
```
6. Set up your shell environment to point to the instance where the database repository is installed. Source the db2profile for the instance that you want. For example, if the Db2® instance is db2inst1, you can source the db2profile by entering:
```
. /home/db2inst1/sqllib/db2profile 
```
  Remember: There is a space between . and /home.
7. Start the installation program by running the ./setup.bin or sudo -E ./setup.bin command from the same command shell that you used in the previous step.
Follow the prompts in the installation program to upgrade IBM Spectrum Control.
After the upgrade is finished, review the message log to ensure that no errors occurred.