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 PureApplication® System, 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, PureApplication System 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 7.1 is ae-install-package-aix-version.tgz. Follow these steps to install the enablement package for your system:

1. Obtain the enablement package from its public download site and put it in a designated location that is accessible from deployed virtual machines.
2. Before installing the enablement package, you must add the following products if they are not currently installed:
   1. Perform the following steps to install the rpm.rte file set:
      • Download the rpm.rte file set from the following location:

        ftp://public.dhe.ibm.com/aix/freeSoftware/aixtoolbox/INSTALLP/ppc/rpm.rte

      • Check if the file set has been installed on the system:

        # lslpp -l fileset-name

        For example:

        # lslpp -l rpm.rte

        If you see the returned message,

        Fileset fileset-name not installed

        issue the following command to install the file set:

        # installp -d fileset-path -acgXY rpm.rte

        For example:

        # installp -d /var/tmp/rpm.rte -acgXY rpm.rte

   2. Perform the following steps to install the gcc-4.8.5-1.aix7.1.ppc.rpmfile:
      • Download gcc-4.8.5-1.aix7.1.ppc.rpm from http://www-03.ibm.com/systems/power/software/aix/linux/toolbox/alpha.html
      • Install the rpm file. For example:

        # rpm -ihv gcc-4.8.5-1.aix7.1.ppc.rpm

      • rpm.rte
      • gcc-4.8.5-1.aix7.1.ppc.rpm
3. Perform the following steps to install the enablement package:
   1. On the VM, download the IBM OS Pattern Kit from DeveloperWorks: http://www.ibm.com/developerworks/downloads/ibm/ospatternkit/index.html.
   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 ae-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
        # ./ae-installer-aix.sh 2>&1 | tee ae-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 AE_installation
        # ./ae-installer-aix.sh -skipAE 2>&1 | tee ae-installer-aix.sh.log

      Installation progress displays on the screen. It is also recorded in the ae-installer-aix.sh.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/ae/uninstall/ae-uninstall-aix.sh. You can run this script independently to remove the enablement environment. For example,

      # /opt/ibm/ae/uninstall/ae-uninstall-aix.sh 2>&1 | tee /tmp/ae-uninstall-aix.sh.log

   2. The enablement package install script, ae-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.