WebSphere Application Server - Express includes a Qshell script that collects information about your WebSphere Application Server - Express installation and packages it in a JAR file that you can send to IBM Customer Support to assist in problem determination and analysis. The information includes logs, property files, configuration files, operating system and Java data, and prerequisite software presence and levels. For information on running Qshell scripts, see Configure Qshell to run WebSphere Application Server - Express scripts.
To collect as much data as possible, the collector script is designed to run to completion regardless of errors such as files or commands not found.
Note: You should only run the collector tool when requested to by IBM Service personnel.
Authority
To run this script, your user profile must have *ALLOBJ authority.
Usage
To run the collector script, follow these steps:
On the CL command line, run the STRQSH (Start Qshell) command.
Run the cd command to change to the directory that contains the script:
cd /home/myprofile
Run the collector script:
/QIBM/ProdData/WebASE/ASE5/bin/collector -instance myInstance JarOutName jarfile
where myInstance is the name of the instance for which you want to collect information.
Syntax
The syntax of the collector script is:
[fully_qualified_directory]/collector -instance instance [ -JarOutName jarfile ] [ -Summary ] [ -IncludeInstalledApps ]
where fully_qualified_directory is the directory that contains the script.
Parameters
The parameters of the collector script are:
-instance
This is a required parameter. The value instance specifies the
name of the WebSphere Application Server - Express instance for which you
want to collect information.
-JarOutName
This is an optional parameter. The value jarfile specifies the
fully qualified path name of the JAR file to which the collector tool writes
the output. The location of the JAR file must be outside of the /QIBM/ProdData/WebASE/ASE5
directory structure for the product. By default, the script creates a JAR
file in the current working directory. The default file name is WASenv.jar.
It is recommended that you specify the -JarOutName parameter.
Notes:
If you specify a jar file name that exceeds sixty characters, it is truncated to the first sixty characters of the name.
The QEJBSVR user profile must have *RWX authority to the directory to contain the output jar file.
-Summary
This optional parameter is supported in versions 5.0.2 and later. If you specify this option, the script generates a summary report of the WebSphere Application Server - Express version and fix level, in addition to information about the i5/OS release level and Java Development Kit level. The summary report is written to the display as well as to file Collector_Summary.txt in the current working directory. When you report a problem to IBM Support, include the Collector_Summary.txt file or output. When you run the collector script with the -Summary parameter, the script does not generate a JAR file.
-IncludeInstalledApps
This optional parameter is supported in versions 5.0.2 and later. By default, the installedApps directory for your instance is not included in the JAR file that the collector tool generates. Specify the -IncludeInstalledApps parameter if you want to include the installedApps directory the generated JAR file.
Example
collector -instance testinst -JarOutName /home/myprofile/testinst_svc.jar
This example collects information on the instance testinst and writes the output to testinst_svc.jar in the /home/myprofile directory.