Troubleshooting Docs Migration plug-in issues

Use the Docs Migration plug-in to convert an old Knowledge ManagementSystem (7.1/7.2/7.5 non-AR System based) article to a AR System-based RKM article.

Related topics

Docs-Migration-plug-in-configuration

Enabling-plug-ins

To troubleshoot Docs Migration plug-in issues

  1. Verify the Docs Migration plug-in configuration.
    For more information, see Docs-Migration-plug-in-configuration.
    For more information about the AR System Administration: Plugin Server Configuration form and AR System Administration: AR System Configuration Generic UI form, see Configuring Java plug-in servers and Updating-configuration-settings-by-using-the-AR-System-Configuration-Generic-UI-form.
  2. Troubleshoot common plug-in-related issues. For more information, see the General-approach-for-troubleshooting-plug-in-issues.
  3. To further investigate the issue, enable the following logs:
    • Server-side logs. For more information, see Enabling-server-side-AR-System-logs.
    • Plug-in specific logs. For more information, see Enabling logging for the Docs Migration plug-in.

Enabling logging for the Docs Migration plug-in

To troubleshoot plug-in-related issues, you must enable plug-in logging by changing the plug-in log level in the System Configuration form, or by editing the plug-in log level in the log4j_pluginsvr.xml file.

To enable logs by using the System Configuration form

  1. Open the Knowledge Management System Configuration form.
  2. From the Plugin Log Level list, select DEBUG.
  3. Select the Article Conversion (RMDY.ITSM.RKM.DOCSMIGRATION) check box.
  4. Click Search, and then click Save.

The arjavaplugin.log file generates the debug logging for the Docs Migration plug-in without restarting AR System server.

To enable logs by using the Plugin Server Configuration form

  1. In a browser, open the AR System Administration Console, and select System > General > Plugin Server Configuration.
  2. On the Plugin Server Configuration form, from the Plugin Server Instance list, select the instance for which you want to enable logs.
  3. Go to the Plugin Server Configuration tab.
  4. In the Logging Configurations area, from the Log Level list, select DEBUG.
  5. Click Apply. 
    The arjavaplugin.log file generates the debug logs for the Docs Migration plug-in.


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*