Install mustgather

• Known issues to check for first

• Installation frequently asked questions

• Collecting the Must-gather

Known issues to check for first

Step 1: Ensure that you are using a supported operating system level

Missing operating system prerequisites frequently cause installation failures.Consult this information to find the required operating system levels:

• Check for operating system prerequisites

Step 2: Check to see if you are encountering a common problem with known solution

Problems applying fixpacks to IHS instances with interim fixes applied

• Users who meet ALL of the criteria below may be prevented from applying a later fixpack.

  • Currently on cumulative fixpack: 8.5.5.10, or 8.0.0.11-8.0.0.12 .

  • Installed interim fixes for both PI73984 and PI66849.

  • The build date of the PI73984 interim fix (bin/versionInfo.sh -ifixes) is prior to April 2017.

• The fixpack installation error will resemble the message below:

  CRIMA1020E ERROR: Failed to extract zip com.ibm.websphere.IHS.ihsonly.... File ../lib/libexpat.so.1 already exists.

  The cause is a packaging error in PI73984. Manual recovery of the installation is required to proceed. The steps are the same whether the install of the subsequent fixpack has already failed on this system or not.

  1. Remove all interim fixes in preparation for the fixpack. IM performs this step implicitly, but we'll need to take action between this uninstall and the install of the fixpack.

     Below is an example of scripting Installation Managers "imcl" tool to list and remove installed interim fixes. You'll need to use your own IIM and IHS installation paths.

     #!/bin/sh
     IFIXES=`/opt/IBM/InstallationManager/eclipse/tools/imcl listInstalledPackages  -installationDirectory /opt/IHS8 |grep WS- | xargs`
     for FIX in $IFIXES; do
       /opt/IBM/InstallationManager/eclipse/tools/imcl uninstall $FIX -installationDirectory /opt/IHS8
     done
     

  2. Remove lib/libexpat.so.1 and lib/libexpat.so.1.6.2 from the IHS installation root if they still exist

     • Depending on the original installation order and how the interim fixes are uninstalled, they may have been deleted by the preceding step

     • This removal is safe because a fixpack is a full replacement. If the fixpack contains PI66849, it will replace the files. If it does not contain PI66849, it will not depend on them.

  3. Proceed with the fixpack install.

Install FAQs

• Does the Java installed with IHS get updated when a fixpack is installed?

  For IHS 8.0 and newer, the Java that is installed under the IHS install directory is updated when an IHS fixpack is installed.

  For earlier versions (IHS 7.0, 6.1, etc.), you must separately apply a WAS SDK fixpack/iFix to update the Java that is installed with IHS.

Collecting the Must-gather

Information to send to support

• A zip of the $IHSROOT/logs directory.

• The output of the DescribeConfig mustgather tool.