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