IBM Support

Collect troubleshooting data for migration problems in IBM Business Automation Workflow (BAW)

Troubleshooting


Problem

You have encountered a problem in a migration scenario where a version of IBM Business Automation Workflow is involved as the migration target. You would like to know what documentation you must collect (MustGather) so that the IBM Business Automation Workflow 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

General diagnostic information

Note: Before collecting the troubleshooting data, take a look at the Support forum to search for migration problems in the IBM Business Automation Workflow product. If that does not help, provide the following MustGather data:
  • If you have not done it already, specify the Business Impact that the issue is having on your company, including:​
    • Any known deadlines or due dates​
    • Any existing or potential effects on your customers​

Environment description:
  • IBM Business Automation Workflow product and version of your source and target environment
    • Run the versionInfo -fixpacks -ifixes command from the bin directory of your product installation and redirect the output to a file.
  • Operating system and version
  • Database details:
    • Database vendor and version
    • Database design file, if used
    • Diagram of the database layout (source and target environment)
    • BAW_install​​_​​root/​​profiles/dmgr_profile​​_​​name​​/​​dbscripts
  • Information about other involved software
  • Production / Test / QA environment
  • Describe the topology that you have in place, which includes the source and target environment. If a topology diagram exists, make it available to IBM Support along with a list of host names, port numbers, and other settings in use.
  • Is your IBM Business Automation Workflow installation on a virtual machine? If yes, provide details on the virtualization software that you are using and its corresponding version.


Detailed problem description:
  • What kind of migration did you attempt?
  • Which migration instructions did you follow? Provide the document or the link to the online resource and name the point at which you ran into problems.
  • Was any specific error message displayed or did you observe any special behavior?
    Provide screen shots where appropriate. For example, provide them if the specific error is only visible in a graphical user interface but it is not found in any of the log files.
  • Can you name the exact time stamp when the problem occurred for the first time?
  • If the migration problem occurred during the execution of a certain command, provide the history of the commands that you issued for the migration, the complete command that failed including all parameters, and collect the command output.
  • Had you tried the same migration before (maybe in another environment) and had it worked previously? If yes, what was changed afterwards?
  • Provide the following complete log directories from the target environment for any profile that was already created during the failed migration attempt:
    • BAW_install_​​root/​​​logs​​
    • BAW_install​​_​​root/​​profiles/dmgr_profile​​_​​name​​/​​logs​
    • BAW_install​​_​​root/​​profiles/profile​​_​​name​​/​​logs​
    • snapshot_directory/logs
  • For any of the IBM Business Automation Workflow migration commands, you can enable tracing. See the Troubleshooting migration pages in the product documentation and follow the instructions there if you encounter problems during the execution of any command.
  • Provide the migration.properties file that you used during your migration.
  • Provide the sample BPMConfig properties file that is used to create the deployment environment, if applicable.
  • Provide the snapshot_directory/cell_name/Configurations/100SourceCustomMerged.xml file.
  • For any version-to-version migration, did you verify that the installation of the target environment was successful?
  • Have you checked the results of your migration attempt? In some cases, migrations succeed despite minor problems during the process. See the applicable pages in the product documentation for your target environment.  What to do next
  1. Review the log files and traces at the time of the problem and try to determine the source of the problem.
  2. Use Business Automation Workflow documentation or the Support Forums to search for known problems.
  3. If your investigation does not yield any helpful results and you cannot solve the problem on your own, send all the previously collected data to IBM Support by uploading to your case.  Alternatively, you can upload files to ECURep. For more information, see Enhanced Customer Data Repository (ECURep) - Overview.

Related Information

[{"Type":"MASTER","Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SS8JB4","label":"IBM Business Automation Workflow"},"ARM Category":[{"code":"a8m50000000Cca0AAC","label":"Upgrade and Migration"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]

Product Synonym

BAW

Document Information

Modified date:
18 May 2022

UID

swg21663802