Enable Agent Retention logs:
- With Orgs enabled:
- From the K1000 Admin console, click the Organization drop-down box in the upper right hand corner and then click System.
- If fast-switching is not enabled and System is not an available choice, use the web URL to access the system level. Example: http://kbox/systemui
- From the System org, Click Organizations | Name of desired org(s) and access selected org(s) details.
- Scroll down over to Communication Settings section.
- Check the 'Enabled' box under Agent Logging to enable the K1000 appliance to store scripting results provided by Agents installed on managed devices.
- Click Save
- Without Orgs enabled:
- From the K1000 Admin console, click Settings | Provisioning | Communication Settings
- Check the 'Enabled' box under Agent Logging to enable the K1000 appliance to store scripting results provided by Agents installed on managed devices.
- Click Save
Script XMLs and dependencies are stored in a subfolder of the KACE program directory. It is possible to ensure that the script XML and dependencies are downloaded to the system as expected.
Check if the script XML and dependencies are on the agent (system):
- In Windows:
- Go to C:\ProgramData\Dell\KACE\kbots_cache
- Review this location to see if the XML exists for the script ID number
- Open the corresponding XML ID and review the tasks to ensure this is the correct script
- Go to C:\ProgramData\Dell\KACE\kbots_cache\packages\kbots\xxx (where xxx is the ID number of the script)
- Ensure that any/all dependencies have downloaded (if there are no dependencies, this directory may not exist)
- In iOS:
- Go to /Library/Application Support/Dell/KACE/data/kbots_cache
- Review this location to see if the XML exists for the script ID number
- Open the corresponding XML ID and review the tasks to ensure this is the correct script
- Go to /Library/Application Support/Dell/KACE/data/kbots_cache/packages/kbots/XX (where XX is the ID number of the script).
- Ensure that any/all dependencies have downloaded (if there are no dependencies, this directory may not exist)
If the script XML and dependencies are downloaded, it is possible to review logs to see if the script ran successfully.
(Optional) Force the Script to Run:
- In Windows:
- Open a CMD prompt by clicking on Start and typing CMD in search
- Navigate to the following directory:
- If 32bit: C:\Program Files\Dell\KACE
- If 64bit: C:\Program Files (x86)\Dell\KACE
- Use the following command: runkbot X 0 (where X is the script ID number)
- In iOS (Mac):
- Open Terminal by going to Launchpad | Other | Terminal
- Use the following command: sudo /Library/Application\ Support/Dell/KACE/bin/runkbot X 0 (where X is the script ID number)
To review logs:
- In Windows:
- Go to C:\ProgramData\Dell\KACE\user
- Open the KAgent.log with a text editor (eg. notepad.exe or notepad++)
- Scroll to the bottom (most recent event) or to the timestamp the script was run
- Review logs line by line for clues or possible errors
- In iOS (Mac):
- Go to /Library/Application Support/Dell/KACE/data/user
- Open the KAgent.log with a text editor (eg. textedit)
- Scroll to the bottom (most recent event) or to the timestamp the script was run
- Review logs line by line for clues or possible errors
Example logs for script with ID 35:
[2016-10-22.21:38:43][runkbot:ParseCommandLine ] runkbot ----- Starting runkbot.exe-----
[2016-10-22.21:38:43][runkbot:DumpState ] Dump State: kbotid=35 kbotId Version=1477190312 -noLogUpload=0 -event= -launchType=KLT_SYSTEM credentials=
[2016-10-22.21:38:43][runkbot:InitLog ] Logging to [/var/tmp/tmp.0.Hy8e1I]
[2016-10-22.21:38:44][runkbot:GetKbot ] Kbot [35-1477190312] not found locally, downloading ...
[2016-10-22.21:38:44][runkbot:DownloadUsingCurl ] DownloadFile: Downloaded /Library/Application Support/Dell/KACE/data/kbots_cache/35-1477190312.xml from http://192.168.2.210/service/kbot_service_notsoap.php?METHOD=getkbot&KUID=BC6449B7-DECB-4581-ADC1-4286096483BA&KBOT_ID=35&KBOT_VERSION=1477190312&CLIENT_VERSION=6.4.522 Download speed: 10620.000000 bytes/second
[2016-10-22.21:38:44][runkbot:KCopyFile ] copy of http://192.168.2.210/service/kbot_service_notsoap.php?METHOD=getkbot&KUID=BC6449B7-DECB-4581-ADC1-4286096483BA&KBOT_ID=35&KBOT_VERSION=1477190312&CLIENT_VERSION=6.4.522 to /Library/Application Support/Dell/KACE/data/kbots_cache/35-1477190312.xml succeeds
[2016-10-22.21:38:44][runkbot:DownloadDependency ] Downloading dependency from KBOX location [http://kbox.test.local/packages/kbots/35/setdebug.sh.9a26059e014246c644cdd8cba8da8a73]
[2016-10-22.21:38:44][runkbot:DownloadUsingCurl ] DownloadFile: Downloaded /Library/Application Support/Dell/KACE/data/kbots_cache/packages/kbots/35/setdebug.sh from http://kbox.test.local/packages/kbots/35/setdebug.sh.9a26059e014246c644cdd8cba8da8a73 Download speed: 87567.000000 bytes/second
[2016-10-22.21:38:44][runkbot:KCopyFile ] copy of http://kbox.test.local/packages/kbots/35/setdebug.sh.9a26059e014246c644cdd8cba8da8a73 to /Library/Application Support/Dell/KACE/data/kbots_cache/packages/kbots/35/setdebug.sh succeeds
[2016-10-22.21:38:45][runkbot:UploadUsingCurl ] UploadFile: Uploaded to http://kbox.test.local/service/kbot_upload.php?checksum=76e6c594a833e5593b0f979fcfcec603a2265d3bd222dbf0e0308dfb810320405ab6f7a3cfff80411f23932f972b72a5c501dfa8bef9f7dbdf60fce1ecad101d&kbotId=35 Upload speed: 5256.000000 bytes/second
* Trying 192.168.2.210...
* Connected to kbox.test.local (192.168.2.210) port 80 (#0)
> PUT /service/kbot_upload.php?checksum=76e6c594a833e5593b0f979fcfcec603a2265d3bd222dbf0e0308dfb810320405ab6f7a3cfff80411f23932f972b72a5c501dfa8bef9f7dbdf60fce1ecad101d&kbotId=35 HTTP/1.1
User-Agent: Mozilla/5.0 (Darwin/15.6.0) libcurl/7.40.0 OpenSSL/1.0.1l zlib/1.2.8 DellKACE-Agent/6.4.522
The last line above is the line of the logs being placed on the appliance. To confirm that the appliance received the same logs:
- Go to Settings | Logs | Access
- Search for the checksum number in the last log line to confirm that the logs were received by the K1000:
- [2016-10-22 21:38:44 -0500] 192.168.2.23 - "PUT /service/kbot_upload.php?checksum=76e6c594a833e5593b0f979fcfcec603a2265d3bd222dbf0e0308dfb810320405ab6f7a3cfff80411f23932f972b72a5c501dfa8bef9f7dbdf60fce1ecad101d&kbotId=35 HTTP/1.1" 200 - 1992 627 0
Gathering information for contacting Kace Support:
If the above troubleshooting does not lead to clues about the script run, please contact support for assistance. When opening a request with support, including the items below can help with a speedy resolution.
From the system:
From the K1000 server:
- Screenshot of the script or an export of the XML (screenshot is preferred).
- Version of the KBOX Server.
- Version of the Agent.
- Time of the test.
- Screenshot of your Agent settings.