Guide for configuring adapter logging.


Overview

NetLD provides a logging mechanism to assist with diagnosing problems with device backups and tool execution.


When to use

When reporting an issue to support related to backups or other device operations support will often ask for additional logging information for the operations failures. For 95% of backup failures, these logs are sufficient for support to be able to diagnose the failure.


Enable Adapter Logging

  1. Select the desired network on the top right corner of the UI (if you do not have multiple networks you can ignore this step). Make sure you enable adapter logging for the same network that the device lives in.
  2. In the NetLD web UI, go to the Help -> About screen
  3. Select Adapter Logging
  4. Enter the IP address of the device and click OK
  5. Perform the desired operation (backup, tool, smart change, etc.) against the device.
  6. In the scratch/logs directory of the server there should be a *.log file for the device.


Adapter logging will be automatically disabled 5 minutes after this setting is enabled, so be sure to run the operation within 5 minutes.


Log Files

When performing an operation with adapter logging enabled one or more files will be written into the scratch/logs directory.


<adapter>_<operation>_<ipaddress>.log

 This log contains the details for commands sent and responses that were received from the device, as well as other debug logging that is useful for diagnosing problems.

All operations will create a log of this form.

<adapter>_<operation>_<ipaddress>.ipcrun.log

 This log contains byte by byte information about data that was sent to and received from the device for SSH.

This log is only created for operations that use SSH.
<adapter>_<operation>_<ipaddress>.telnet.log
 This log contains byte by byte information about data that was sent to and received from the device for Telnet.

This log is only created for operations that use Telnet.


For example, an SSH backup of a Cisco IOS device will produce two logs: IOS_backup_10.0.0.250.log and IOS_backup_10.0.0.250.ipcrun.log


Log File Location

The log files will be saved to the scratch/logs folder of the netLD installation directory.


Note: When SmartBridges are in use, the log file will be saved on the SmartBridge on which the operation is actually performed.


Windows

C:\Program Files\Net LineDancer\scratch\logs\


Linux

/usr/share/netld/scratch/logs/