IBM Support

MustGather: Installation and update issues with Liberty Profile in WebSphere Application Server

Troubleshooting


Problem

Collecting data (MustGather) for when installation or updates of Liberty Profile in WebSphere Application Server does not complete successfully. Gathering this information before calling IBM support will help familiarize you with the troubleshooting process and save you time.

Resolving The Problem

Gather data depending on the method of install.

Method 1: Installation Manager

  1. What part number did you obtain for this installation?

  2. Collect data as requested in the MustGather for WebSphere Application Server V8.0, V8.5, and V9.0 Installation Manager.

  3. Obtain a complete file listing of the WSAS_HOME directory; following the examples below, please provide the filelist.txt file.
    • Windows: From a command prompt, navigate to the product installation directory and run:

      dir /s >filelist.txt

    • AIX, HP-UX, Linux, and Solaris: From a terminal session, navigate to the product installation directory and run:

      ls -ltR >filelist.txt

  4. Follow directions in MustGather: Read First for opening a PMR and sending data to IBM Support.

Method 2: Job Manager
  1. Enable the following trace on JobManager:

    com.ibm.ws.management.liberty.*=all:com.ibm.ws.cimplus.*=all:com.ibm.ws.management.system.*=all

    Note: The preceding trace specification is a single line of information.

    For advice on enabling traces, see Setting up trace.

  2. Recreate the problem with the trace enabled. Then, gather the following:
    1. A complete collector, using the ISA Data Collector (isadc utility) on the Job Manager Profile.

    2. A file listing of the parent directory of the location to which Liberty is deployed.
      • Windows: From a command prompt, navigate to the target's parent directory and run:

        dir /s >filelist.txt

      • AIX, HP-UX, Linux, and Solaris: From a terminal session, navigate to the target's parent directory and run:

        ls -ltR >filelist.txt

    3. Send the complete zip file (the Liberty profile payload) that Job Manager is sending to the target system.

  3. Follow directions in MustGather: Read First for opening a PMR and sending data to IBM Support.

Method 3: Archive Install
  1. Provide a complete file listing of the directory where the Liberty jar file is extracted:
    • Windows: From a command prompt, navigate to that directory and run:

      dir /s >filelist.txt

    • AIX, HP-UX, Linux, and Solaris: From a terminal session, navigate to that directory and run:

      ls -ltR >filelist.txt

  2. Provide a copy of the output to the console when running the jar file extraction.

  3. Tell us where the Liberty archive jar file was obtained.

  4. Provide the Java version information from the copy of Java used to extract the Libery archive jar file.

    For example, navigate to JAVA_HOME/bin, and run this command:
    • Windows:

      java.exe -version

    • AIX, HP-UX, Linux, and Solaris:

      ./java -version

  5. Follow directions in MustGather: Read First for opening a PMR and sending data to IBM Support.

[{"Product":{"code":"SSEQTP","label":"WebSphere Application Server"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Install","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"9.0;8.5.5;8.5","Edition":"Base;Express;Liberty;Network Deployment","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
15 June 2018

UID

swg21596720