IBM Collect troubleshooting data for the IBM Business Process Manager products - United States install; mustgather; bpm; v7.5; collect; logs; troubleshooting; v8.5 TECHNOTE (TROUBLESHOOTING)

PROBLEM(ABSTRACT)
 You are having a problem with the IBM Business Process Manager (BPM) products. You would like to know what information you must collect (MustGather) so that the IBM Business Process Manager Support team can diagnose your problem. If you gather this documentation before contacting support, it will expedite the troubleshooting process and save you time. 

DIAGNOSING THE PROBLEM
Start the problem analysis: 

 * Review the SystemOut.log file at install_​​root​​/profiles/​​profile​​_​​name​​/​​logs​​/server​​_​​name and look for error messages that have been logged around the time stamp when the issue showed up. 
 * Search the [http://www.ibm.com/software/htp/cics/tserver/support/]appropriate product support site from the following list for known problems using symptoms such as the message number and error codes:  * IBM Business Process Manager Advanced [http://www.ibm.com/support/entry/portal/Overview/Software/WebSphere/IBM_Business_Process_Manager_Advanced] 
    * IBM Business Process Manager Standard [http://www.ibm.com/support/entry/portal/Overview/Software/WebSphere/IBM_Business_Process_Manager_Standard] 
    * IBM Business Process Manager Express [http://www.ibm.com/support/entry/portal/Overview/Software/WebSphere/IBM_Business_Process_Manager_Express] 
    * IBM BPM Advanced Pattern for Red Hat Enterprise Linux Server [http://www.ibm.com/support/entry/portal/search_results?sn=spe&q=&filter=DC.Subject:SSV2LR]
   
   
 * Use theIBM Support Assistant [http://www.ibm.com/software/support/isa/]to search for known problems in the product documentation, forums, technotes, and so on. 
 * Search the IBM dW Answers [https://developer.ibm.com/answers/topics/bpm/] or IBM Business Process Manager developerWorks community [http://www.ibm.com/developerworks/forums/forum.jspa?forumID=2382] pages for known problems. 
 * If a fix is found that fits the symptoms, search Fix Central [http://www.ibm.com/support/fixcentral/] for the appropriate interim fix.

RESOLVING THE PROBLEM
Collect the following troubleshooting data if you need help from IBM Business Process Manager Support to resolve the problem. 



GENERAL DIAGNOSTIC INFORMATION

Environment description: 

 * IBM Business Process Manager product and version  * In Business Process Manager V7.5.x, run the versionInfo -maintenancePackages command from the bin directory of your IBM Business Process Manager product installation and redirect the output to a file. 
    * In Business Process Manager V8.x, run the versionInfo -fixpacks -ifixes command from the bin directory of your IBM Business Process Manager product installation and redirect the output to a file.
   
   
 * Operating system and version 
 * Database vendor and version 
 * Information about other involved software 
 * Production / Test / QA environment 
 * If you are running in a cluster, describe the topology that you have in place. If you have a topology diagram, provide it including host names, ports, and so on. 
 * Is your IBM Business Process Manager product running in a virtual machine? If yes, provide more details on the software that you are using and its version.


Detailed problem description: 
Provide a precise description of the issue and add every detail that might be related. 
This could include:  * Which symptoms do you see? 
 * Which component or application is involved? 
 * Do you see any error messages? 
 * What is the time stamp when the problem occurs? 
 * Did the current scenario work previously? If yes, what has been changed? 
 * Is this issue reproducible at will? How often does this problem occur? Do you see any indicators on why this happens? 
 * Provide screen shots if applicable (if an error message is not shown or if the specific error is not seen in the log files, and so on)


Additional details needed: 
Provide the complete log directories:  * install​​_​​root/​​profiles/profile​​_​​name​​/​​logs​​/server​​_​​name 
 * install_​​root/​​profiles/profile​​_​​name/​logs​​/ffdc


Provide the configuration files:  * TeamWorksConfiguration.running.xml file, which is located in the following locations:  * Process Center profile:
      install_​​root/​​profiles/profile​​_​​name/config/cells/cell_name/nodes/
      node_name/servers/server_name/process-center 
    * Process Server profile:
      install_​​root​​/​​profiles/profile​​_​​name/config/cells/cell_name/nodes/
      node_name/servers/server_name/process-server
   
   
 * The complete install_​​root/​​profiles/profile​​_​​name/configdirectory if requested by the support team.


Test case:  * Simplified and isolated test case without any custom dependencies and without access to external customer systems 
 * *.twx export from IBM Process Designer 
 * Project Interchange (PI) and enterprise archive (EAR) file from the involved Advanced Integration Services, if applicable 
 * Exact, detailed steps to reproduce the problem, including timestamp of the problem occurrence.


If you have not provided it already, supply the business impact this issue is having on your company, including:​  * Any upcoming deadlines and dates​ 
 * Any realized or potential effect on customers​

COMPONENT-SPECIFIC DIAGNOSTIC INFORMATION
 

 * Advanced Integration Service (AIS) [http://www.ibm.com/support/docview.wss?uid=swg21669894] [http://www.ibm.com/support/docview.wss?uid=swg21618716] 
 * Application deployment [http://www.ibm.com/support/docview.wss?uid=swg21618716] 
 * Application deployment (EAR file / Advanced content) [http://www.ibm.com/support/docview.wss?uid=swg21959495] 
 * Business Process Choreographer (BPC) [http://www.ibm.com/support/docview.wss?uid=swg21270939] 
 * Business Process Definition (BPD) [http://www.ibm.com/support/docview.wss?uid=swg21680148] 
 * IBM Business Process Manager Advanced Pattern for AIX and Linux [http://www.ibm.com/support/docview.wss?uid=swg21642204] 
 * IBM Business Process Manager document store [http://www.ibm.com/support/docview.wss?uid=swg21640607] (for IBM Business Process Manager V8.5.x) 
 * IBM Business Process Manager on Cloud [http://www.ibm.com/support/docview.wss?uid=swg21664113] 
 * Business Rules [http://www.ibm.com/support/docview.wss?uid=swg21663864] 
 * Business Space [http://www.ibm.com/support/docview.wss?uid=swg21578516] 
 * Coaches [http://www.ibm.com/support/docview.wss?uid=swg21666382] 
 * Common Event Infrastructure (CEI) [http://www.ibm.com/support/docview.wss?uid=swg21670009] 
 * Connection to Process Center [http://www.ibm.com/support/docview.wss?uid=swg21666261] 
 * Data Map, Data Object and XML Serialization [http://www.ibm.com/support/docview.wss?uid=swg21664250] 
 * Database [http://www.ibm.com/support/docview.wss?uid=swg21610455] 
 * Dynamic Event Framework (DEF) [http://www.ibm.com/support/docview.wss?uid=swg21679783] 
 * Installation and upgrade [http://www.ibm.com/support/docview.wss?uid=swg21506937] 
 * Integration between IBM Business Process Manager (BPM) and IBM ILOG or IBM WebSphere Operational Decision Management [http://www.ibm.com/support/docview.wss?uid=swg21644787] 
 * Message import and export (MQ and JMS related) [http://www.ibm.com/support/docview.wss?uid=swg21667053] 
 * Migration [http://www.ibm.com/support/docview.wss?uid=swg21663802] 
 * Out-of-memory, hangs, crashes [http://www.ibm.com/support/docview.wss?uid=swg21666135] 
 * Performance [http://www.ibm.com/support/docview.wss?uid=swg21611603] 
 * Performance Data Warehouse [http://www.ibm.com/support/docview.wss?uid=swg21609319] 
 * Process Admin console [http://www.ibm.com/support/docview.wss?uid=swg21661316] 
 * Process Designer [http://www.ibm.com/support/docview.wss?uid=swg21611598] 
 * Process Inspector [http://www.ibm.com/support/docview.wss?uid=swg21666266] 
 * Process Portal [http://www.ibm.com/support/docview.wss?uid=swg21656267] 
 * REST API [http://www.ibm.com/support/docview.wss?uid=swg21666278] 
 * Secure Sockets Layer (SSL), Java Secure Socket Extension (JSSE) or Java Cryptography Extensions (JCE) [http://www.ibm.com/support/docview.wss?uid=swg21162961] 
 * Security [http://www.ibm.com/support/docview.wss?uid=swg21609418] 
 * Service Component Architecture (SCA), Service Integration Bus (SIB) or Failed Event Manager (FEM) [http://www.ibm.com/support/docview.wss?uid=swg21669111] 
 * Undercover Agent (UCA) [http://www.ibm.com/support/docview.wss?uid=swg21660915] 
 * Web services [http://www.ibm.com/support/docview.wss?uid=swg21593461] 
   


Note: In the previous information, the install_root refers to the location in which you installed the product. The profile_name is the name of the profile that is specific to your configuration. The cell_name, node_name and server_name are the names of the cell, the node and the server that are specific to your configuration. 
AUTOMATIC DATA COLLECTION VIA THE BPM DATA COLLECTOR

You can also use the BPM Data Collector [http://www.ibm.com/support/docview.wss?uid=swg21641516] to automatically collect basic MustGather data like logs, version info and so on. Verify the created package if any requested information is missing prior to sending it to IBM Support for problem analysis.
This tool can be used with IBM Business Process Manager V8.0.1 Fix Pack 3 and with IBM Business Process Manager V8.5.x.

RELATED INFORMATION
 Exchange data with IBM Technical Support [http://www.ibm.com/de/support/ecurep/index.html]
BPM Advanced - System requirements [http://www.ibm.com/support/docview.wss?uid=swg27023005]
BPM Standard - System requirements [http://www.ibm.com/support/docview.wss?uid=swg27023007]
BPM Express - System requirements [http://www.ibm.com/support/docview.wss?uid=swg27023008]
Recommended fixes for IBM BPM [http://www.ibm.com/support/docview.wss?uid=swg27022299]
Configuration file overview [http://www.ibm.com/support/docview.wss?uid=swg21439614]
MustGather for WebSphere Application Server [http://www.ibm.com/support/docview.wss?uid=swg21145599]
Troubleshooting data: WebSphere Process Server [http://www.ibm.com/support/docview.wss?uid=swg21239895]
Troubleshooting data: IBM Integration Designer [http://www.ibm.com/support/docview.wss?uid=swg21566742]
Troubleshooting data: WebSphere ESB [http://www.ibm.com/support/docview.wss?uid=swg21268473]
Troubleshooting data: WebSphere Lombardi Edition [http://www.ibm.com/support/docview.wss?uid=swg21440086]
Troubleshooting data: IBM Business Monitor [http://www.ibm.com/support/docview.wss?uid=swg21498803]
A Japanese translation is available [http://www.ibm.com/support/docview.wss?uid=swg21620654]
A simplified Chinese translation is available [http://www.ibm.com/support/docview.wss?uid=swg21634198]





Cross reference information Segment Product Component Platform Version Edition Business Integration IBM Business Process Manager Standard Documentation AIX, Linux, Solaris, Windows 8.5.7, 8.5.6, 8.5.5, 8.5, 8.0.1, 8.0, 7.5.1, 7.5 Business Integration IBM Business Process Manager Express Documentation Linux, Windows 8.5.7, 8.5.6, 8.5.5, 8.5, 8.0.1, 8.0, 7.5.1, 7.5 Business Integration IBM BPM Advanced Pattern on Red Hat Enterprise Linux Server Documentation Linux 8.5.0.1, 8.0.1, 8.0 Business Integration IBM Business Process Manager Advanced Pattern on AIX Documentation AIX 8.0.1 
PRODUCT ALIAS/SYNONYM
 BPM

Question: What is the best practice for working with BPM support When working with the BPM product set there are a lot of configuration files, logs and applications which can be exported for analysis by the support team. What are the best practices for working with the BPM support team? 

Answer: Collect the following troubleshooting data if you need help from IBM Business Process Manager Support to resolve the problem.