How to change the Logging Level on various components of Data Synchronizer for troubleshooting

  • 7006823
  • 09-Sep-2010
  • 09-Nov-2016

Environment

Novell Data Synchronizer
Novell Data Synchronizer Connector for GroupWise
Novell Data Synchronizer Connector for Mobility
Novell GroupWise Mobility Service (GMS)

Situation

How to change the Logging Level on various components of Data Synchronizer for troubleshooting
How to set the Log Level to debug or verbose

Resolution

Data Synchronizer has various components and depending on the nature of the issue, logging level may need to be increased on some or all components. Also be aware that increasing the logging level will cause more disk space to be taken by the log files.
 
Config Engine:
  1. Edit /etc/datasync/configengine/configengine.xml .
  2. Change the following statement from
    <level>info</level>
    to
    <level>debug</level>
  3. Save the file.
  4. Type "rcdatasync-configengine restart ".

    Log file for Config Engine is /var/log/datasync/configengine/configengine.log .
Web Admin:
  1. Edit /etc/datasync/webadmin/server.xml .
  2. Change the following statement from
    <level>info</level>
    to
    <level>debug</level>
  3. Save the file.
  4. Type "rcdatasync-webadmin restart ".

    Log file for Web Admin is /var/log/datasync/webadmin/server.log .
Sync Engine:
 
Changing the Log Level through WebAdmin:
  1. Launch Web Admin by going to https://ipaddress:8120/
  2. Login to Web Admin.
  3. Under Manage Engines, click the Engine or click the icon for Edit Config.
  4. Scroll down to the Logging section.
  5. Change the Level field to Debug and select Verbose.
  6. Click Save Log Settings.
  7. Click "Edit XML Source" on the top right and search for section that looks similar to following and change it to
        <log>
          <level>debug</level>
          <file>engine.log</file>
          <verbose>diagnostic</verbose>
          <failures>off</failures>
        </log>
  8. Click Save XML.
  9. Click Home button on the top left.
  10. Type "rcdatasync restart " on the terminal session to restart datasync services.
OR
 
Changing the Log Level by manually modifying the file. Manually modifying the file may help in cases if WebAdmin cannot be reached for some reason.
  1. Edit /etc/datasync/configengine/engines/default/engine.xml .
  2. Search for the section that looks similar to the following and change it to
        <log>
          <level>debug</level>
          <file>engine.log</file>
          <verbose>diagnostic</verbose>
          <failures>off</failures>
        </log>
  3. Save the file.
  4. Type "rcdatasync restart " on the terminal session to restart datasync services.

Log file for Sync Engine is /var/log/datasync/engine.log

GroupWise Connector:
 
Changing the Log Level through WebAdmin:
  1. Launch Web Admin by going to https://IPAddress:8120
  2. Login to Web Admin.
  3. Click GroupWise Connector. By default it is named groupwise .
  4. Scroll to the very bottom.
  5. Change the "Set Logging Level " field to Debug and select Verbose.
  6. Click Save Log Settings.
  7. Click "Edit XML Source" on the top right and search for section that looks similar to following and change it to
          <log>
            <failures>on</failures>
            <verbose>diagnostic</verbose>
            <file>default.pipeline1.groupwise.log</file>
            <level>debug</level>
          </log>
  8. Click Save Custom Settings.
  9. Click Home button on the top left.
  10. Stop and start the GroupWise Connector.
 OR
 
Changing the Log Level by manually modifying the file. Manually modifying the file may help in cases if WebAdmin cannot be reached for some reason.
  1. Edit /etc/datasync/configengine/engines/default/pipelines/pipeline1/connectors/groupwise/connector.xml.
  2. Search for the section that looks similar to the following and change it to follows 
          <log>
            <failures>on</failures>
            <verbose>diagnostic</verbose>
            <file>default.pipeline1.groupwise.log</file>
            <level>debug</level>
          </log>
  3. Save the file.
  4. Stop and Start the connector for the settings to take effect.
 
Log files for GroupWise Connectors are /var/log/datasync/connectors/default.pipeline1.groupwise.log and /var/log/datasync/connectors/default.pipeline1.groupwise-Appinterface.log
 
Mobility Connector:
 
Changing the Log Level through WebAdmin:
  1. Launch Web Admin by going to https://ipaddress:8120/
  2. Login to Web Admin.
  3. Click Mobility Connector. By default it is named mobility.
  4. Scroll to the very bottom.
  5. Change the "Set Logging Level " field to Debug and select Verbose.
  6. Click Save Log Settings.
  7. Click "Edit XML Source" on the top right and search for section that looks similar to following and change it to
          <log>
            <failures>on</failures>
            <verbose>diagnostic</verbose>
            <file>default.pipeline1.mobility.log</file>
            <level>debug</level>
          </log>
  8. Click Save Custom Settings.
  9. Click Home button on the top left.
  10. Stop and start the Mobility Connector.

    Log files for Mobility Connectors are /var/log/datasync/connectors/default.pipeline1.mobility.log and /var/log/datasync/connectors/default.pipeline1.mobility-Appinterface.log .
OR
 
Changing the Log Level by manually modifying the file. Manually modifying the file may help in cases if WebAdmin cannot be reached for some reason.
  1. Edit /etc/datasync/configengine/engines/default/pipelines/pipeline1/connectors/mobility/connector.xml.
  2. Search for the section that looks similar to the following and change it to follows 
          <log>
            <failures>on</failures>
            <verbose>diagnostic</verbose>
            <file>default.pipeline1.mobility.log</file>
            <level>debug</level>
          </log>
  3. Save the file.
  4. Stop and Start the connector for the settings to take effect.

Additional Information

Log file names and locations.

Internal Mobility          Log File Subdirectory        Log File Name
Service Component          under /var/log/datasync
Sync Engine                syncengine                   engine.log
Config Engine              configengine                 configengine.log
Web Admin                  webadmin                     server.log
Connector Manager          syncengine                   connectorManager.log
Sync Agents                connectors                   groupwise-agent.log
                                                        groupwise.log
                                                        mobility-agent.log
                                                        mobility.log