Remedy - Data Import - How to enable java debug logging for Data Import

Knowledge Article

Remedy - Data Import - How to enable java debug logging for Data Import
How to enable java debug logging for Data Import
Remedy AR System Server
AR System
Remedy AR System Data Import v.8.x, v.9.x
Remedy AR System Server
AR System
Remedy AR System Data Import v.8.x, v.9.x
How to enable java debug logging for Data Import Tool.
This knowledge article may contain information that does not apply to version 21.05 or later which runs in a container environment. Please refer to Article Number 000385088 for more information about troubleshooting BMC products in containers.

Follow these steps:

1- Go to the installation <ARSystemInstallDir>\dataimporttool\plugins\com.bmc.arsys.studio.api_<version>.build001 directory directory where:
com.bmc.arsys.studio.api_<version>.build001 will depend of the version of Data Import you are using. Check below a reference:

          - In v8.1, v8.1.01 and 8.1.02:...\dataimporttool\plugins\com.bmc.arsys.studio.api_8.1.0.build001
          - In v9.0: ...\dataimporttool\plugins\com.bmc.arsys.studio.api_9.0.0.build001
          - In v9.1: ...\dataimporttool\plugins\com.bmc.arsys.studio.api_9.1.0.build001
          - In v9.1.02:...\dataimporttool\plugins\com.bmc.arsys.studio.api_9.1.2.build001
          - In v9.1.03:...\dataimporttool\plugins\com.bmc.arsys.studio.api_9.1.3.build002

2- Locate the file called: log4j.xml

3- Backup this file and rename it to: log4j.xml.bak

          User-added image




4- Additional changes:
          Replace the fatal value with the value: all
          Original:
          <!-- Print only messages of level fatal in the package com.bmc.arsys -->
              <logger name="com.bmc.arsys">
                 <level     value="fatal" />
              </logger>
              <logger name="com.bmc.arsys.api">
                 <level     value="fatal" />
               </logger>
               <logger name="com.bmc.arsys.arrpc">
                  <level     value="fatal" />
               </logger>

              <!--Set root category priority to fatal -->
              <root>
              <priority value ="fatal" />

          Replaced value:
          <!-- Print only messages of level fatal in the package com.bmc.arsys -->
              <logger name="com.bmc.arsys">
                 <level     value="all" />
              </logger>
              <logger name="com.bmc.arsys.api">
                 <level     value="all" />
               </logger>
               <logger name="com.bmc.arsys.arrpc">
                  <level     value="all" />
               </logger>

              <!--Set root category priority to fatal -->
              <root>
              <priority value ="all" />

5- And lastly enable the logging to be appended into the log file as well as the console (default) by removing the "comment" tags.
          Original:
          <!-- use FileLog as the appender for logging to the log file -->
          <!--
          <appender-ref ref="FileLog" />
          -->
          <appender-ref ref="Console" />
       
          Tags removed:
          <!-- use FileLog as the appender for logging to the log file -->
          <appender-ref ref="FileLog" />    
          <appender-ref ref="Console" />

6- Save the XML file.

7- When starting Data Import the file javaapi.log will be created in  <ARSystemInstallDir>\dataimporttool

          User-added image




Related information
Remedy - Data Import - How to enable API logging for Data Import
 
Remedy AR System Server
AR System
Remedy AR System Data Import v.8.x, v.9.x
Attachment(s):