Agent Remote Installation Algorithm

Step-by-step description of what happens when you choose to install an ManageEngine OS Deployer Agent through ManageEngine OS Deployer Management Console to a remote machine

Description

When you choose to install an ManageEngine OS Deployer Agent on a remote machine through ManageEngine OS Deployer Management Console, the following procedure takes place:

  1. ManageEngine OS Deployer copies two files to the Admin$ share on the remote computer (e.g. \\computer_name\Admin$):
    • msi_setup.exe
    • ManageEngine OS Deployer Agent installation file

    (!) By default the Admin$ share is set to C:\Windows, but it can be reconfigured to a different folder or even deleted completely. One can check whether Admin$ share exists and what folder it is set to it with the use of the net share command in the Windows Command Line interface.

  2. Then ManageEngine OS Deployer copies acroinst.exe to the same location on the remote computer, and executes it as a service named ManageEngine Install Service;

    (!) The service is supposed to run under the user account one specified in the Remote Install Wizard. Sometimes however it fails to start under the specified account even though the correct username and password are provided. In this case one may receive The service did not start due to a logon failure (0xFFF0) or other similarly worded error message. The workaround is to manually change the Log on as setting for ManageEngine Install Service to Local System account and restart the service:

    • Change the Log on as setting:
      • Click Start -> Run;
      • Type in services.msc and hit Enter;
      • Right-click on ManageEngine Install Service and choose Properties;
      • Click the Log On tab;
      • Under Log on as choose Local System account and click OK.
    • Restart ManageEngine Install Service:
      • In the Service window right-click on ManageEngine Install Service;
      • Choose Restart in the pop-up menu.
  3. After this ManageEngine Install Service creates a process that runs the following command:

    msi_setup.exe /msi-db:ManageEngineAgent.msi /silent /install:TrueImageAgent /ALLUSERS:1 /PIDKEY:XXXXX-XXXXX-XXXXX-XXXXX-XXXXX"

    (!) The directory in which this command will be executed is determined by the %SystemRoot% environment variable, which by default is set to C:\Windows (just like the Admin$ share). Also, just like the Admin$ share, the %SystemRoot% environment variable can be reconfigured to a different folder. One can check what folder the %SystemRoot% environment variable is currently set to with the use of the set command in the Windows Command Line interface.

  4. After this ManageEngine OS Deployer Agent is installed.

More information

If ManageEngine Install Service is unable to run the installation command, it returns to ManageEngine OS Deployer Management Console the following error code:

System cannot find the file specified (0xFFF0)

To troubleshoot this, one will need to: 

  1. Make sure that the Admin$ share exists and the following files are copied there:
    • msi_setup.exe
    • ManageEngine OS Deployer Agent installation file (e.g. ManageEngineAgent.msi)
    • acroinst.exe
  2. Make sure that ManageEngine Install Service is executed by checking event logs on the remote machine for service start failures;
  3. Make sure that both Admin$ and %SystemRoot% are set to the same folder (default is C:\Windows).

If the remote computer runs Windows XP, the option Control panel -> Folder options -> View -> Use simple file sharing must be disabled on that computer.

If the remote computer runs Windows XP with Service Pack 2 or Windows 2003 Server, the option Control panel -> Windows Firewall -> Exceptions -> File and Printer Sharing must be enabled on that computer.

Imaging and Deployment Software trusted by