Skip to main content

How To Enable Debug Logging For The CID Key Agent (Connector ID Key)

Lukasz Mikosz
  • Created:
  • Updated:

Problem:

Liquidware Labs Support requested that I turn on debug logging for the Connector ID Key agent.

 

Possible Resolution(s):

 

Windows CID agent:

1. Log into the Windows desktops that is experiencing issues using credentials that have administrative privileges.

 

2. Navigate to the Control Panel and open the Connector ID applet.

 

3. In the Connector ID applet, navigate to the Status tab. If the Connector ID services are running, click on the Stop Connector ID button to stop all Connector ID Key services.

 

 

3. Using the Windows Start button, navigate to the Notepad application, right-click on it and select Run as Administrator.

 

4. In Notepad, click on File > Open menu to browse to and open:

  • 6.6.5-x and older: "C:\Program Files (x86)\Liquidware Labs\Connector ID\logconfig"
  • 6.6.7-x and newer: "C:\Program Files\Liquidware Labs\Connector ID\logconfig"

a. Change the default LOGLEVEL: 1 line to LOGLEVEL: 7

      • LOGLEVEL: 6 = Only Last Callback Collected
      • LOGLEVEL: 7 = All Callbacks Collected. (Preferred, this generates SummaryReports & ReportRequest files also needed during collection)

 

5. Save the file. If you have not used Run as Administrator, Windows may NOT allow you to save the changes to the file.

 

6. Using Windows Explorer, navigate to:

  • 6.6.5-x and older: "C:\Program Files (x86)\Liquidware Labs\Connector ID"
  • 6.6.7-x and newer: "C:\Program Files\Liquidware Labs\Connector ID"

... and delete all .txt files. These files will be recreated when the CID Key services are restarted.

 

 

7. In the Connector ID control panel applet’s Status tab, click on Start Connector ID button to start all CID Key services.

 

8. Please wait for at least 1 or 2 callback intervals to collect enough logs. In most cases, the default callback interval is 60 minutes.

a. Feel free to change the Connector ID Key Properties individually for the target machine.

b. Navigate to HUB Administration > Inventory > (Search for the machine) > Select the check box & "edit" > Enable CID Key Properties in the tab> Change callback for this one machine to 10 minutes.

 

9. After waiting for at least 1 callback interval, use the Connector ID control panel applet to stop CID Key services by clicking on the Stop Connector ID button again. Once stopped, please copy all the .txt files along with lwldatasvc.log to another folder like the Desktop, zip them up and send them to your Liquidware Labs contact for analysis.

 

IMPORTANT NOTE: Be sure to change the logging value back to 1 and restart the services after testing period is over. The files will continue to grow rapidly if that value is not changed back to 1.

(PDF with detailed instructions attached)

 

*See this KB for scripts to enable DEBUG mode remotely on a larger scale: 

https://www.liquidware.com/support/articles/211754766-How-to-mass-enable-Connector-ID-Key-DEBUG-Logging

 

MAC TERMINAL COMMANDS

 

Debug on:


/usr/bin/sudo /bin/launchctl unload "/Library/LaunchDaemons/com.liquidwarelabs.connectorID.plist"
/Applications/Connector\ ID.app/Contents/MacOS/idenq -L 10
/usr/bin/sudo /bin/launchctl load "/Library/LaunchDaemons/com.liquidwarelabs.connectorID.plist"

 

Compress log (tgz file, send Liquidware Support /var/log/debug.tgz):

 

tar -cvzf /var/log/debug.tgz /var/log/grd.log

 

 Debug off:


/usr/bin/sudo /bin/launchctl unload "/Library/LaunchDaemons/com.liquidwarelabs.connectorID.plist"
/Applications/Connector\ ID.app/Contents/MacOS/idenq -L 1
/usr/bin/sudo /bin/launchctl load "/Library/LaunchDaemons/com.liquidwarelabs.connectorID.plist"

 

Product: Stratusphere FIT/UX       

Product Version: N/A

Expires on: 365 days from publish date

Updated: Jan. 23rd, 2025

 

 

Related articles