Installation and migration logs

Installation and migration logs

Learn about the different log file that WebSphere Portal provides to help administrators identify and correct pr/oblems with installation and migration.

Installation log files

The IBM Installation Manager controls the WebSphere Portal installation log files. The IBM Installation Manager records any errors or warnings that occur during the installation. The IBM Installation Manager stores all logs in a centralized location and the logs pertaining to WebSphere Portal can be found there. Typically these logs are found in the following directory:

Manager\logs /var/ibm/InstallationManager/logs

The IBM Installation Manager retains logs from all installations and uninstallatione that it performs for all products. We can review the entire history. The IBM Installation Manager has a built-in function used to view the logs. On the IBM Installation Manager main page, click File > View log. We can also use the web browser to view the index.xml file in the log directory.

Migration log files

Unless noted otherwise, migration log files are located in the following directory:

WP_PROFILE /logs
Files in this directory are stored only on the local System i5 machine. You may be able to view them from a Windows machine by mapping a network drive to the System i5 machine.

The table lists each file, describes the file content, and recommends when to check the file for information that might assist in troubleshooting migration problems.

Log file name Description Problem symptoms
ConfigTrace.log Contains information generated each time a ConfigEngine task is executed, including trace information generated during migration from WebSphere Portal V6.1.x. This file is located in WP_PROFILE/ConfigEngine/log. Check this log if migration from Version 6.1.x stops before successful completion.
upgradeConfigEngineTrace.log Contains trace information generated when the ConfigEngine tool is upgraded from Version 6.1. This file is located in WP_PROFILE/ConfigEngine/log Check this log if errors occur when you run the upgradeConfigEngine tool.

Log file name Description Problem symptoms
Job logs of migration jobs. Contain trace information generated during the execution of the migration jobs. Check these files if there are problems with a specific migration step.
en.runningNumber.log, trace.runningNumber.log Contains trace messages of the Web Content Manager migration tasks. These files are located in the directory: PORTAL_HOME/wcm/migration/log. Check this log for errors generated during migration.
ConfigTrace.log Contains trace information generated during migration from Version 6.1 or later. This file is located in WP_PROFILE/ConfigEngine/log. Check this log if migration from Version 6.1 or later stops before successful completion.
upgradeConfigEngineTrace.log Contains trace information generated when the ConfigEngine tool is upgraded from Version 6.1. This file is located in WP_PROFILE/ConfigEngine/log. Check this log if errors occur when you run the upgradeConfigEngine tool.

To set tracing for the migration plug-in (com.ibm.wp.was.plugin.jar, which we use to migrate the dmgr and nodes from Version 6.1 to v8), specify: com.ibm.wp.migration.*=all

Parent: Logging and tracing

Log file name	Description	Problem symptoms
ConfigTrace.log	Contains information generated each time a ConfigEngine task is executed, including trace information generated during migration from WebSphere Portal V6.1.x. This file is located in WP_PROFILE/ConfigEngine/log.	Check this log if migration from Version 6.1.x stops before successful completion.
upgradeConfigEngineTrace.log	Contains trace information generated when the ConfigEngine tool is upgraded from Version 6.1. This file is located in WP_PROFILE/ConfigEngine/log	Check this log if errors occur when you run the upgradeConfigEngine tool.

Log file name	Description	Problem symptoms
Job logs of migration jobs.	Contain trace information generated during the execution of the migration jobs.	Check these files if there are problems with a specific migration step.
en.runningNumber.log, trace.runningNumber.log	Contains trace messages of the Web Content Manager migration tasks. These files are located in the directory: PORTAL_HOME/wcm/migration/log.	Check this log for errors generated during migration.
ConfigTrace.log	Contains trace information generated during migration from Version 6.1 or later. This file is located in WP_PROFILE/ConfigEngine/log.	Check this log if migration from Version 6.1 or later stops before successful completion.
upgradeConfigEngineTrace.log	Contains trace information generated when the ConfigEngine tool is upgraded from Version 6.1. This file is located in WP_PROFILE/ConfigEngine/log.	Check this log if errors occur when you run the upgradeConfigEngine tool.