4.0 Troubleshooting

This chapter provides information about troubleshooting Device Service.

To investigate the possible issues, you may be asked to provide the debug logs. The following information helps you to enable logging on different platforms.

Microsoft Windows

To enable debug logging for all Client components, follow the steps:

  1. Run DiagTool.exe (the tool must have Microsoft .NET Framework 3.5 installed).

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

  3. Click Enable.

  4. Restart the machine.

  5. Reproduce your problem.

  6. Run DiagTool.exe.

  7. Click Save logs in the Debug logs tab.

  8. Specify a file name and path. Click Save to save the logs.

  9. Click Disable to disable the logging.

  10. Click Clear All.

If you do not have the Diagnostic Tool, you can perform the steps manually:

  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 workstation.

  5. Reproduce your problem.

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

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

Apple Mac OS X

To collect the debug logs using the Diagnostic Tool, perform the following steps:

  1. Run the file DiagTool.app.

  2. Click Enable.

  3. Restart your system.

  4. Repeat 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 in the Debug logs tab:

  • Use Disable to disable the logging.

  • Use Refresh to update the logs list.

  • Use Open to open any specific log.

  • Use Clear All to delete the existing logs.

To identify the Advanced Authentication servers on the domain, perform the following steps:

  1. Run the file DiagTool.app.

  2. Click Servers.

  3. Specify the domain name in Domain and click Search. A list of servers is displayed, if the IP is either IPv4 or IPv6.

If you do not have the Diagnostic Tool, perform the following steps to collect the debug logs manually:

  1. Create a directory NetIQ in the /Library/Logs/ folder.

  2. Create a text file config.properties in /Library/Logs/NetIQ/.

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

  4. Create a directory Logs in /Library/Logs/NetIQ/.

  5. Restart the system.

  6. Repeat the issue.

  7. Pack the logs located in /Library/Logs/NetIQ/Logs/ into a zip file.

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

Linux

To enable logging for the component, perform the following steps:

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

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

  3. Save changes.

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

  5. Stop the service by running the command in the terminal: sudo service deviceservice stop.

  6. Start the service: sudo service deviceservice start.

Logs are generated in the /opt/NetIQ/Logging/Logs directory.