Use the Command Line to Deploy Agents

  • Article

Applies To: Operations Manager 2007 R2, Operations Manager 2007 SP1

You can use the MOMAgent.msi executable to deploy agents from the command line. Deploying agents from the command line is also referred to as a manual install.

Before you begin deployment, ensure the following conditions have been met:

  • The account that is used to run MOMAgent.msi must have administrative privileges on the targeted computers.

  • A management group (or single management server) must be configured to accept agents installed with MOMAgent.msi or they will be automatically rejected and therefore not display in the Operations console. For more information, see Process Manual Agent Installations in Operations Manager 2007. If the management group or server is configured to accept manually installed agents after the agents have been manually installed, the agents will display in the console after approximately one hour.

  • If an agent is manually deployed to a domain controller and an Active Directory management pack is later deployed, errors might occur during deployment of the management pack. To prevent errors from occurring before deploying the Active Directory management pack or to recover from errors that might have already occurred, you need to deploy the Active Directory management pack helper object by deploying the file Oomads.msi on the affected domain controller. The file Oomads.msi is on the computer that is hosting the agent at C:\Program Files\System Center Operations Manager 2007\HelperObjects. For more information, see the section "Agent-Managed Domain Controllers" in the topic Process Manual Agent Installations in Operations Manager 2007

  • Each agent that is installed with MOMAgent.msi must be approved for a management group. For more information, see Process Manual Agent Installations in Operations Manager 2007.

MOMAgent.msi can be found in the Microsoft System Center Operations Manager 2007 installation media and the management server installation directory.

Use the following procedure to deploy an agent. For examples of ways in which you can customize the MOMAgent.msi command, see MOMAgent.msi command examples.

To deploy the Operations Manager 2007 agent from the command line

  1. Log on to the computer where you want to install the agent by using an account with local administrator privileges.

  2. Open a command window.

  3. Run the following command:

%WinDir%*\System32\msiexec.exe /i \\path\Directory\MOMAgent.msi /qn USE_SETTINGS_FROM_AD={0|1} MANAGEMENT_GROUP= MGname MANAGEMENT_SERVER_DNS= MSname SECURE_PORT= PortNumber ACTIONS_USE_COMPUTER_ACCOUNT={0|1} ACTIONSUSER= UserName ACTIONSDOMAIN= DomainName ACTIONSPASSWORD= *Password

where:

USE_SETTINGS_FROM_AD=[0|1]

Indicates whether the management group settings properties will be set on the command line. Use 0 if you want to set the properties at the command line. Otherwise, if you use 1, the management group settings are taken from Active Directory.

MANAGEMENT_GROUP=MGname

Specifies the management group that will manage the computer.

MANAGEMENT_SERVER_DNS=MSname

Specifies the fully qualified domain name for the management server. To use a gateway server, enter the gateway server FQDN as MANAGEMENT_SERVER_DNS.

SECURE_PORT=PortNumber

Sets the health service port number.

ACTIONS_USE_COMPUTER_ACCOUNT={0|1}

Indicates whether to use a specified user account (0) or the Local System account (1).

ACTIONSUSER=UserName

Sets the Agent Action account to UserName. This parameter is required if you specified ACTIONS_USE_COMPUTER_ACCOUNT=0.

ACTIONSDOMAIN= DomainName

Sets the domain for the Agent Action account identified with the ACTIONSUSER parameter.

ACTIONSPASSWORD= Password

The password for the user identified with the ACTIONSUSER parameter.

Important

If the computer's DNS and Active Directory names differ, the MANAGEMENT_SERVER_AD_NAME property also needs to be set to the fully qualified Active Directory Domain Services name.