WebSphere Application Server Network Deployment, Version 6.0.x     Operating Systems: AIX, HP-UX, Linux, Solaris, Windows

Analyzing collector tool output

The first step in using the collector tool on your WebSphere Application Server product is to run the tool to produce a Java archive (JAR) file as output. The second step in using the collector tool is to analyze its output. The preferred method of performing this analysis is to send the JAR file to IBM Support for analysis. However, you can use this topic to understand the content of the JAR file if you perform your own analysis.

You can view the files contained in the JAR file without extracting the files from the JAR file. However, it is easier to extract all files and view the contents of each file individually. To extract the files, use one of the following commands:

Wasenv.jar stands for the name of the JAR file that the collector tool creates.

The JAR file contains:

Tips and suggestions

  • Unzip the JAR file to an empty directory for easy access to the gathered files and for simplified cleanup.
  • Check the collector.log file for errors:
    • Some errors might be normal or expected. For example, when the collector attempts to gather files or directories that do not exist for your specific installation, it logs an error about the missing files.
    • A non-zero return code means that a command that the collector tool attempted to run does not exist. This might be expected in some cases. If this type of error occurs repeatedly, there might actually be a problem.
  • On Linux and UNIX-based systems, the file OS/commands has the location of all commands used. If you are missing command output, check this file to see if the command was found.
  • On Linux and UNIX-based systems, the collector runs some shell scripts. The shell script output is saved in files in the OS directory, while the corresponding debug information is saved in the debug directory. If the output of a shell script is missing, check the corresponding file in the debug directory.
  • When you issue the collector command when there are multiple installation instances, the tool that runs depends on what is in the PATH statement. For example, if you install both the base WebSphere Application Server and the Deployment Manager product on the same machine, the bin directory that first appears in the PATH variable is the one that furnishes the collector tool. To work around this problem, use a fully qualified file path when calling the collector tool as shown in this example for a Windows platform:
    c:\WebSphere\AppServer\bin\collector.bat
  • On Windows systems, the OS directory contains a file named installed.out. This file contains a list of programs found in the Add/Remove Programs list. This same information is contained in the file Desktop\My Computer\Control Panel\Add/Remove Programs\Install/Uninstall.



Related concepts
Gathering information with the Collector tool
Collector tool

Related tasks
Running the collector tool

Related reference
Collector summary

Concept topic    

Terms of Use | Feedback

Last updated: Mar 17, 2005 4:28:29 AM CST
http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp?topic=/com.ibm.websphere.nd.doc/info/ae/ae/ctrb_readct.html

© Copyright IBM Corporation 2002, 2005. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)