Installing AIX enablement package

After you have logged into your virtual machine, you can begin installing the AIX® enablement package.

About this task

When you deploy a pattern in Cloud Pak System Software, the launched virtual machine instance goes through an activation process that configures system settings such as network IP addresses, password, NTP server, and so on. In addition, Cloud Pak System Software installs an agent and related services in the launched virtual machine instance that orchestrate and execute software configuration. A set of prerequisites are required in the virtual image in order to successfully activate and bootstrap the virtual machine instance. The enablement package is used to install and configure the prerequisites in your virtual image to make it suitable for pattern deployment. The enablement package includes Activation Engine with operating system activation utilities, Java™ Development Kit (JDK), pattern engine bootstrap utilities, and an automated installer script.

You must run all commands using the root user ID. The name of the enablement package for AIX 7.2 is ci-install-package-aix-version.tgz. Follow these steps to install the enablement package for your system:

Procedure

Obtain the enablement package from its public download site and put it in a designated location that is accessible from deployed virtual machines.
Before installing the enablement package, you must add the following products if they are not currently installed:
1. Do the following steps to install the rpm.rte file set:
  - Check if the rpm.rte file is installed on the system:
```
# lslpp -l rpm.rte
```
Complete the following steps to install the enablement package:
1. Download the Pattern Kit for AIX. Go to the Cloud Pak System Software Welcome page and click Download tooling > Download OS Pattern Kit for AIX.
2. Copy it to a newly created directory.
  For example,
```
# mkdir /var/tmp/ena-pkg
# cd /var/tmp/ena-pkg
```
3. Extract the enablement package.
  For example:
```
# gunzip -c ci-install-package-aix-version.tgz | tar xpvf -
```
4. Use one of the following methods to install the enablement package:
  - To install a new virtual application enablement environment, issue the following commands:
```
# cd AE_installation
# ./ci-installer-aix.sh 2>&1 | tee ci-installer-aix.sh.log
```
  - To preserve the previously installed Activation Engine base components (such as, Activation Engine, Jython and VMC extension) while reinstalling the remaining components (such as, Activation Engine extension for AIX, virtual application platform and tooling), issue the following commands:
```
# cd CI_installation
# ./ci-installer-aix.sh -skipCI 2>&1 | tee ci-installer-aix.sh.log
```
  Installation progress displays on the screen. It is also recorded in the ci-installer-aix.sh.log log file located in the current directory. Examine the log file to confirm successful installation. Once the installation has completed, a status report is printed.
5. Optional: Remove the workspace once you have verified the installation.
  For example:
```
# cd /var/tmp
# rm -rf ena-pkg/
```
Tip:
1. The installation also generates the uninstallation script, /opt/ibm/CI/uninstall/ci-uninstall-aix.sh. You can run this script independently to remove the enablement environment. For example,
```
# /opt/ibm/ci/uninstall/ci-uninstall-aix.sh 2>&1 | tee /tmp/ci-uninstall-aix.sh.log
```
2. The enablement package install script, ci-installer-aix.sh also runs the uninstallation script prior to the installation. If the uninstallation script does not exist, a default uninstallation procedure will be performed.