The Dell KACE Appliance, and the service desk, has dramatically reduced my workload. Instead of being reactive, I am now very much proactive in the work that I do.
Jacob Lee, IT Help Desk Manager
US Synthetic

Troubleshooting Managed Installs

Here is a list of items to check with a Managed Installation (MI) when it is unable to deploy or to uninstall from a client machine.

Check the setup of the managed installation application:

  • Download the "Silent Install Guide" from the Kace Support site for referencing sample setups of few applications: (Examples include: Adobe Acrobat, Microsoft Office,Citrix Presentation Server, Microsoft Internet Explorer and Mozilla Firefox).
    http://www.kace.com/support/customer/doc/SilentInstallationWhitepaper.pdf 
  • On the Software Detail Page of the specific application, make sure the following parameters are checked:
    • The correct operating system is selected!
    • You are using the correct software item that was detected by a test install OR your custom inventory field is being detected. In either case your test /reference machine that has the software successfully installed is shown at the bottom on the software detail page -- this means that you are using the correct software item that is being detected by inventory
       
    • If attaching a zip file...does the zip file include a directory when it is unzipped? Modify the full command line in the managed install correctly
      Example of zip file with no folder (command line would bedotnetfx3setup.exe):

      Example of zip file with no folder (command line is .\folder\dotnetfx3setup.exe):

      Example: setup.exe OR .~/softwareABC/setup.exe
  • MI is not set to "disabled"
  • When viewing the inventory detail of one of the targeted machine, where the package is not yet installed, the "To Install List" will show that this MI is listed.
  • The command used to install or uninstall works outside of the K1000 appliance (use a CMD console to execute the parameters) and does not require any user interaction. The current directoy when MI's are copied, unpacked and launched is the sub-folder where MI packages get downloaded. i.e. c:\program files\kace\kbox\downloads\XX (XX is the MI number)
  • Does the installation work for the LOCAL SYSTEM user?
    Use the following FAQ which details how to mimic the LOCAL SYSTEM USER to install the application: http://www.kace.com/support/resources/kb/article/How-to-mimic-running-a-script-as-Local-System-User-Scripting

Check on the K1000 Client:

  • The K1000 Agent is checking in successfully. MI's are done after a successful inventory. Even if AMP (i.e. "green-light" is connected by the machine is not checking-in then an MI will not run.
  • When the client checks in, does it download the application into the c:\Program Files\Kace\kbox\downloads\XXXX directory?
    To Find out the actual XXXX number do the following:
    • Browse to http://kbox/adminui
    • Go to the Distribution -> Software Item listing
    • Hover over the managed installation title, see the bottom of the browser for the full URL:
      Example: http://kbox/adminui/mi.php?ID=1736
    • Check c:\Program Files\Kace\kbox\download\1736 to see if the application installer has been downloaded.
    • Is a process from a previous attempt still running on the machine? Check task manager and kill any process that is hung/suspended. Eg. msiexec.exe that error out may hang

Turn on client debugging

Check Replication Settings

  • If a replication share is being used then test the MI in a simpler set-up. Once it is working on a machine that does not use replication then proceed to attempt to install it on another machine.
  • Check the following on the Replication Share:
    • Is the package uploaded to the replication share? Has it completed copying? You can check the bottom of server replication details page and inspect the physical location in the filesystem on the replication share
    • Is the Replication share working correctly for other files?
    • Is it able to download file to the clients?

If you need technical support

Please send the following to KACE Support:
  • Reproducible case
  • Version number of server and agents
  • Screenshot of the Managed Installation setup and the command line used to install or uninstall the application
  • Screenshot of software inventory item showing that it's detected on a test system
  • Check if the application is being downloaded to the client under the c:\Program Files\Kace\KBOX\Download\XXXX directory
  • Results of all tests above
  • Log files when debugging is turned on. Please note timestamps of your test.
    • debug.log
    • kbots_log.txt
    • kblxlog.txt
    • error.log

The most common problem

The install keeps happening over and over again as shown in the asset history of the machine OR the "to install list" never goes to 0.

This is the same problem and happens because you did not associate the managed install with the right software item. Please review the first 3 minutes of this video (http://downloads.kace.com/support/tutorials/distribution_config.html) and this document again.

Updated on: 4/21/2011