Configuring the Object Migration log

The export and import processes in Object Migration generate informational messages when an object’s dependent object names cannot be determined or verified. The messages are sent to a log file named ObjectMigration.log.

About this task

The messages in the log identify the name of the object that has an issue and lists its invalid references by type and where they are referenced. The log is in the log directory of your IBM TRIRIGA installation, for example, at C:\Tririga\log\ ObjectMigration.log.

You configure the ObjectMigration.log file in the log4j.xml file in the config directory of your installation, for example, at C:\Tririga\config\log4j.xml. Be sure to review these settings and edit them as you want before you do Object Migration. Also, it is important to review the ObjectMigration.log after each Object Migration event.

The default Object Migration entries in log4j.xml follow.

===================================================================
Append messages to the ObjectMigration.log file
===================================================================
<appender name=“OM” class=“org.apache.log4j.DailyRollingFileAppender”>
    <param name=“File” value=“C:/Tririga/log/ObjectMigration.log”/>
    <param name=“Append” value=“true”/>
    <param name=“Threshold” value=“INFO”/>
    <param name=“DatePattern” value=“‘.’yyyy-MM-dd”/>

    <layout class=“org.apache.log4j.PatternLayout”>
        <param name=“ConversionPattern” value=“%d %-5p %m%n”/>
    </layout>
</appender>
...

<
| Additivity is set to false so OM will not log with the root elements.
| This allows only OM to log in the ObjectMigration.log file.
-->
<category name=“com.tririga.om.logger.OMLogger” additivity=“false”>
    <appender-ref ref=“OM”/>
</category>
<category name=“com.tririga.platform.om.logger.OMLogger” additivity=“false”>
    <priority value=“INFO”/> <!-- Set to DEBUG to enable logging -->
    <appender-ref ref=“OM”/>
</category>

com.tririga.om.logger.OMLogger is for versions 2.1 to 2.5 of Object Migration. com.tririga.platform.om.logger.OMLogger is for versions 2.6+ of Object Migration.