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).
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.
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.
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
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.
|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|