5.1 Debugging Logs

This section describes procedure to collect the logs for Device Service on the following platforms:

5.1.1 Debugging Logs on Linux

On Linux, to enable the logs for the Device Service, perform the following steps:

  1. Create a text file config.properties file in the /opt/NetIQ/Logging/ path.

  2. Add a string to the file: logEnabled=True that ends with a line break.

  3. Save the changes.

  4. Create a folder Logs in the /opt/NetIQ/Logging/ path.

  5. Run the following command in the terminal to stop the service:

    sudo service deviceservice stop

  6. Run the following command to start the service:

    sudo service deviceservice start

The generated logs are stored in the /opt/NetIQ/Logging/Logs path.

5.1.2 Debugging Logs on Mac OS

On Mac OS, you can collect the logs for Advanced Authentication Mac OS X Client and Device Service in one of the following ways:

NOTE:You can find the Diagnostic Tool component in the Advanced Authentication appliance distributive package.

Using the Diagnostic Tool

To collect the logs using the Diagnostic tool, perform the following steps:

  1. Run the file DiagTool.app.

  2. Click Enable.

  3. Restart your system.

  4. Reproduce the issue.

  5. Run the file DiagTool.app.

  6. Click Save in the Debug logs tab.

    The logs file is saved in the logs-year-month-date-hour:minute:seconds.zip format in the /tmp directory.

    For example, logs file is saved as logs-2017-10-23-15:30:20.zip.

  7. Click Save.

You can perform the following actions in the Debug logs tab:

  • Disable to disable the logging.

  • Refresh to update the logs list.

  • Open to open any specific log.

  • Clear All to delete the existing logs.

Manual

  1. Create a text file config.properties in the directory /Library/Logs/NetIQ/.

  2. Add a string to the file logEnabled=True that ends with a line break.

  3. Create a directory named Logs in the path /Library/Logs/NetIQ/.

  4. Restart the system.

  5. Reproduce the issue.

  6. Compress the logs located in the path /Library/Logs/NetIQ/Logs/ into a zip file.

  7. Change logEnabled=True to logEnabled=False in the file /Library/Logs/NetIQ/config.properties.

5.1.3 Debugging Logs on Windows

On Windows, you can collect the logs for Advanced Authentication Windows Client and Device Service in one of the following ways:

NOTE:You can find the Diagnostic Tool component in the Advanced Authentication appliance distributive package.

Using a Diagnostic Tool

Before you use the Diagnositic tool, ensure that the following requirements are met as prerequisites:

  • Microsoft .NET Framework 3.5 installed

  • The DiagTool.exe file is available with the following files in the same directory:

    • DiagTool.exe.config

    • Ionic.Zip.dll

    • JHSoftware.DNSClient.dll

To collect the logs using the Diagnostic tool, perform the following steps:

  1. Run DiagTool.exe.

  2. Click Clear All (if applicable) in the Debug logs tab.

  3. Click Enable.

  4. Restart the Windows system.

  5. Reproduce your problem.

  6. Run DiagTool.exe.

  7. Click Save logs in the Debug logs tab.

  8. Specify a file name and path.

  9. Click Save to save the logs.

  10. Click Disable to disable the logging.

  11. Click Clear All.

Manual

If you do not have the Diagnostic tool, you can collect the logs using the following steps:

  1. Create a text file C:\ProgramData\NetIQ\Logging\config.properties.

  2. Add a string to the file: logEnabled=True that ends by a line break.

  3. Create a directory: C:\ProgramData\NetIQ\Logging\Logs\.

  4. Restart the system.

  5. Reproduce your problem.

  6. Compress the logs located in the path C:\ProgramData\NetIQ\Logging\Logs\ into a zip package.

  7. Change logEnabled=True to logEnabled=False in the file C:\ProgramData\NetIQ\Logging\config.properties.