A new IBM Support Assistant data collector exists in the IBM Business Process Manager (BPM) Version 8.5 products

News


Abstract

The new data collector in IBM Business Process Manager V8.5 is designed for ease of use to gather some of the standard information that is needed to debug IBM Business Process Manager issues. This command-line tool can gather log file or configuration information and upload it to a Problem Management Record (PMR).

Content

The script gathers various product information, compresses it into a .zip file, and can optionally send the compressed file to IBM for a PMR. You can also use this tool to compress the data without sending it to IBM. The command is profile_root/bin/bpmdc

Where profile_root is the base profile directory for the profile from which you want to get data.


For example: C:/MyProfileDirectory/bin/bpmdc -PMR=12345.678.901 -uploadToIBM=yes

Command Line Parameter Default Value Description
PMR None This parameter is the 11-digit PMR number to which the data is associated. Use one of the following forms for this value: 12345.678.901 or "12345,678,901"
Note: Comma characters can be an issue on the Microsoft Windows command-line if you do not surround the value with the double quote characters.
uploadToIBM no This parameter specifies whether to upload the data to the IBM ECURep site for a particular PMR. You can set this value to yes or no.
outputDirectory install_root/BPM/isadc This parameter specifies the path to the directory where the output collection .zip file will be stored.
type General This parameter specifies which type of collection to run. The valid values are General or Install.
config no With a general collection, when you set this parameter to yes, the config directory is included. You can set this value to yes or no.
help No values When you include this parameter with the command, a description of the command options is displayed.


You can run the command without any parameters, which results in the general collection being run and the logs directory is compressed into a .zip file.


The output file name has the following format: PMRnumber . type _ timeStampValue .zip


The data gathered is based on the profile where the command is run. If it is run from the installation directory, then the default profile is used.


Note: Be sure to run the command from the profile you wish to gather data from.


General collection
The "General" collection gathers the following information:
  • Profile logs directory (profile_root/logs). The collected files include all of the server log files and trace under this profile directory.
  • The results the versionInfo -maintenancePackages command.
  • (Optionally) The profile config directory (profile_root/config). This directory is only collected when the -config=yes option is used.

Note: The limitation with this collection is that it does not gather log files and trace if it goes to a custom directory outside of the Profile logs directory. It is not recommend to change the log file locations from the default as it makes it more difficult for others to find them.



Install collection
The "Install" collection gathers the following information that is listed in the Collect troubleshooting data for installation or upgrade problems with IBM Business Process Manager products document:

  • Any temporary launchpad log files.
  • Installation Manager Data directory
  • The results of the versionInfo -maintenancePackages command
  • Installation logs directory
  • Profile logs directory
  • Database upgrade script log files
  • Various configuration files that are related to the installation process


Common usage

The following list provides some common usage scenarios for this command:

  • After an issue occurs, use the basic bpmdc command to compress the log files for the profile into a .zip file.
  • Recreate your issue after setting a trace string using the administrative console or wsadmin.
    Then run the bpmdc command to collect the logs and send to IBM.
  • After opening a PMR, use bpmdc -PMR=PMRnumber -uploadToIBM=yes with the most relevant type options to upload data.
  • IBM Support provides a specific command or set of commands to run for your environment that gets the needed data.
  • IBM Support provides a traces string that needs to be gathered with the commands. With trace enabled, you recreate the issue or wait for a reoccurrence before running the provided commands to gather and upload the data to IBM.

Related information

A simplified Chinese translation is available

Cross reference information
Segment Product Component Platform Version Edition
Business Integration IBM Business Process Manager Standard General AIX, Linux, Linux zSeries, Solaris, Windows 8.5
Business Integration IBM Business Process Manager Express General Linux, Linux zSeries, Windows 8.5

Product Alias/Synonym

BPM

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

IBM Business Process Manager Advanced
General

Software version:

8.5

Operating system(s):

AIX, Linux, Linux zSeries, Solaris, Windows

Reference #:

1641516

Modified date:

2013-07-08

Translate my page

Machine Translation

Content navigation