Blog Posts tagged with K1000 Agent 5

Ask a question

KACE::'MacUtil.class error prevents agent inventory updates to KBOX with 5.3' Workaround

In some instances, when inventorying Mac agents running the 5.3 agent, a MacUtil.class error message will occur similar to this:


This error occurs because the agent was unable to gather all of the necessary data from SystemProfiler.  First, update the Mac agent to the latest 5.3 agent. Then follow these instructions to resolve this error.

  1. Create a manual inventory.xml file by running /Library/Application\ Support/Dell/KACE/bin/MacInventoryU > inventory.xml .
  2. View the new inventory.xml file.  If it shows a complete inventory of the system without containing any errors, then it will automatically update to the KBOX and the inventory issue will go away.

If an error message similar to this is in the inventory.xml file instead:

ash-3.2# /Library/Application\ Support/Dell/KACE/bin/MacInventoryU > inventory.xml 
2012-03-05 15:02:02.224 MacInventoryU[4599:903] *** Terminating app due to uncaught exception 'NSInvalidArgumentException', reason: '*** -[NSCFString appendString:]: nil argument' 
*** Call stack at first throw: 

0 CoreFoundation 0x99a556ca __raiseError + 410 
1 libobjc.A.dylib 0x908245a9 objc_exception_throw + 56 
2 CoreFoundation 0x99a553f8 +[NSException raise:format:arguments:] + 136 
3 CoreFoundation 0x99a5536a +[NSException raise:format:] + 58 
4 Foundation 0x943b5dc6 mutateError + 156 
5 MacInventoryU 0x00002eb7 -[SystemProfiler runProfileForDataTypes:detailLevel:] + 1423 
6 MacInventoryU 0x000027b9 -[SystemProfiler runProfileForDataTypes:] + 301 
7 MacInventoryU 0x00002017 main + 1017 
8 MacInventoryU 0x00001c02 _start + 216 
9 MacInventoryU 0x00001b29 start + 41 
10 ??? 0x00000001 0x0 + 1 

Trace/BPT trap 

The problem is related to either Spotlight being disabled on the Mac system or its Metadata is corrupt. SystemProfiler depends on Spotlight to populate its data. To resolve this conflict, the metadata file on the Mac agent will need to be rebuilt. To do this, Open Terminal (/Applications/Utilities/Terminal.app) and run sudo mdutil -i on -E /

This will rebuild the metadata file on the Mac system and it will inventory successfully in the KBOX. In some cases, this rebuild will resolve the problem permanently. However, a customer's environment may contain a few Macs that will need this process conducted on a regular basis.  To eliminate time and the need to add this workaround to the increasing daily requirements our IT customers are currently responsible for in each of their work environments, a script has been developed to impliment this task for you.

Below is the XML version of the script you can run from your KBOX:

<?xml version="1.0" encoding="utf-8" ?>
<kbots xmlns="http://kace.com/Kbots.xsd">
<config name="Clear MacOS Spotlight Metadata" type="policy" id="69" version="1331252818" description="This script can be used to help resolve issues dealing with problems uploading MacOS inventory to the appliance. Some of the symptoms can include incomplete inventory upload to the appliance, or getting the &quot;MacUtil.class&quot; error in the comments section of a MacOS inventory detail page.">
<execute disconnected="false" logged_off="false">
<verify on_failure="break" attempts="1">
<file_exists path="/Library/Application Support/Dell/KACE/data/" file="spotlight.com" />
<log_message type="status" message="Clear Spotlight Metadata script has already been run on this machine" />
<launch_program path="/usr/bin" program="mdutil" wait="true" parms="-i off" />
<launch_program path="/usr/bin" program="mdutil" wait="true" parms="-i on -E /" />
<launch_program path="/usr/bin" program="touch" wait="true" parms="/Library/Application\ Support/Dell/KACE/data/spotlight.com" />
<log_message type="status" message="Clear Spotlight Metadata script successfully completed" />
<log_message type="status" message="Clear Spotlight Metadata script failed to run" />

It will default to an Offline Kscript.

This script will create a file called "spotlight.com" in the agent log directory (/Library/Application Support/Dell/KACE/data).  If it detects that this file exists, it will not run again.

NOTE:  This workaround will not remove the MacUtil.class error message displayed on an Inventoried Mac agent summary page.  The MacUtil.class error message will be resolved in the 5.4 release. The responsibility of this workaround is to allow you to inventory your Mac units if you are faced with this problem.

If you discover that the above script only inventories your Mac units for a only a day or two and you find yourself back to the original problem, you can run the below script which will run the metadata clean even if spotlight.com is detected. This script will also update the timestamp on the last modified date on the "spotlight.com" file when it touches it again.


Note: IF you have upgraded to 5.4 from 5.3 and had this problem originally, the issue is fixed and the scripts are no longer needed.  However, the MacUtil error note will remain on the system in inventory.  To remove, open notes, delete the message and save.

View comments (3)

KACE::Familiarizing Yourself with the 5.3 KBOX Agent on a Mac

Where to find the Mac agent if you are currently running Agent 5.3

'/Library/Application Support/Dell/KACE' will contain both the /bin and /data directories.  The applications are found in '/bin' while the logs are located in '/data'. The SMMP.conf file has been renamed to AMP.conf.

Applications listed in the bin directory:

  • AMPAgent
  • AMPctl
  • Inventory
  • kagentlogonscript
  • kagentbootupscript
  • kagentctl
  • kpatch
  • KUserAlert
  • MacInventoryU
  • pluginDesktopAlerts.so
  • pluginRunProcess.so
  • PluginWeb.so
  • runkbot

Items found in the Data directory:

  • amp.conf
  • amp.log
  • default_config.yaml
  • kbot_service.wsdl
  • kbots_cache
  • KLocalExecutionState.dat
  • kuid.txt
  • packages

Debug logs will display in the /data directory when enabled.  To enable debug, Follow these steps:

  1. sudo /Library/Application\ Support/Dell/KACE/bin/AMPctl stop
  2. Edit the Amp.conf file found in /Library/Application\ Support/Dell/KACE/data and add a new line at the bottom with debug=true (all lowercase).
  3. sudo /Library/Application\ Support/Dell/KACE/bin/AMPctl start

To edit the hosts file:

  1. Open Terminal.app found in /Applications/Utilities
  2. Type sudo nano /private/etc/hosts
  3. Type your user password when prompted.
  4. The hosts file contains some comments (lines starting with the # symbol), as well as some default hostname mappings (e.g. - localhost). Type in your new mapping IP address underneath the default ones or edit one of the default values if you know what you are doing.
  5. When done editing the hosts file, press control-o to save the file.
  6. Press enter on the filename prompt, and control-x to exit the editor.
  7. For the changes to take an immediate affect, flush the DNS cache by 'dscacheutil -flushcache'

To install the 5.3 agent by script:

hdiutil attach ./ampagent-5.3.53053-all.dmg
mkdir -p /Library/Application\ Support/Dell/KACE/data
echo host=KBOX.kace.com > /Library/Application\
sudo installer -pkg '/Volumes/Dell KACE/AMPAgent.pkg' -target /
hdiutil detach '/Volumes/Dell KACE'

To manually remove the 5.3 agent:

  1. sudo /etc/rc.d/init.d/AMPctl stop
  2. sudo rpm -e ampagent
  3. rm -rf /var/dell/kace/
Be the first to comment

KACE::Processes That Use Admin Usernames and passwords

Summary:  A list of processes that use admin usernames and passwords: 

  1. Scripting
  1. Provisioning schedules
  1. Replication
  1. File synchronization
  2. User authentication (LDAP)
  3. Proxy settings
  4. LDAP labels


Be the first to comment

KACE :Provisioning stuck in "Not Started" or "Running"


Summary:  What to do if you provisioning is stuck in "Not Started" or "Running" and never finishes.


To confirm this is the problem, you can go to Settings > Support > Troubleshooting Tools.

Click Edit Mode, then in the drop down box that says "Ping" under  Network Utilities, select Top, then click the Test button.

You should see a process called something like "kbrsl.7.0=amd64" several times, and WCPU is at 100%.



If this is the case, follow the below steps:



  1. Delete all the currently running configurations by either:
    1. Deleting the entire configuration itself.
    2. Deleting just the systems that are running by going to Provisioned Configurations > number of systems under respective column > Select all checkbox > Choose Action Dropdown > Delete Selected Items.



Note: 5.2 and up KBOX Agent is renamed K1000 Agent




2.  Reboot the KBOX.


What this does is stop any configuration that's trying to run, and rebooting essentially restarts the provisioning service.

Once the reboot is complete, try and provision your system again.


Be the first to comment

KACE:: Disabling KBOX Agent Splash Screen

Summary:  How to disable the Agent splash screen: 



Hklm\software\kace !disablebootupsplash





"" disable login splash



View comments (3)
Showing 1 - 5 of 5 results

Top Contributors

Talk About KACE 1000