MOMAgent.msi command examples

Applies To: Operations Manager 2007 R2

The following examples show different ways in which you can use the MOMAgent command. You can use this command to perform new installations of agents, upgrade agents from previous releases of Operations Manager 2007, or change the configuration of an agent (such as the management group or management server associated with the agent).

Agent installation using a specific Action Account

The following example shows a fresh installation of an agent and uses a specific Action Account.

msiexec.exe /i \\path\Directory\MOMAgent.msi /qn /l*v %temp% MOMAgentinstall.log USE_SETTINGS_FROM_AD=0 MANAGEMENT_GROUP=<MG_Name> MANAGEMENT_SERVER_DNS=<MSDNSName> ACTIONS_USE_COMPUTER_ACCOUNT=0 ACTIONSUSER=<AccountUser> ACTIONSDOMAIN=<AccountDomain> ACTIONSPASSWORD=<AccountPassword> USE_MANUALLY_SPECIFIED_SETTINGS=1 SET_ACTIONS_ACCOUNT=1

Agent installation using the Local System account

The following example shows a fresh installation of an agent and uses the Local System for the Action Account.

msiexec.exe /i \\path\Directory\MOMAgent.msi /qn /l*v %temp%\MOMAgentinstall.log USE_SETTINGS_FROM_AD=0 MANAGEMENT_GROUP=<MG_Name> MANAGEMENT_SERVER_DNS=<MSDNSName> ACTIONS_USE_COMPUTER_ACCOUNT=1 USE_MANUALLY_SPECIFIED_SETTINGS=1 SET_ACTIONS_ACCOUNT=1

Agent installation with Active Directory integration and using a specific Action Account

The following example installs an agent by using Active Directory and a specific Action Account.

msiexec /i \\path\Directory\MOMAgent.msi  /qn /l*v %temp%mominst.NoGroupSpecified.log USE_SETTINGS_FROM_AD=1 USE_MANUALLY_SPECIFIED_SETTINGS=0 ACTIONS_USE_COMPUTER_ACCOUNT=0 ACTIONSUSER=<AccountUser> ACTIONSDOMAIN=<AccountDomain> ACTIONSPASSWORD=<AccountPassword>  SET_ACTIONS_ACCOUNT=1

Agent installation with Active Directory integration and using the Local System account

The following example installs an agent by using Active Directory and the Local system account for the Action Account.

msiexec /i \\path\Directory\MOMAgent.msi  /qn /l*v %temp%\ mominst.NoGroupSpecified.log USE_SETTINGS_FROM_AD=1 ACTIONS_USE_COMPUTER_ACCOUNT=1 USE_MANUALLY_SPECIFIED_SETTINGS=0 SET_ACTIONS_ACCOUNT=1

Agent upgrade from a previous release of Operations Manager 2007 SP1

The following example upgrades an agent.

msiexec /i \\path\Directory\MOMAgent.msi SET_ACTIONS_ACCOUNT=0 /qn /l*v %temp%\MOMAgentUpgrade.log

Change the name of the management server associated with the agent

The following example changes the name of the management server.

MsiExec.exe /i \\path\Directory\MOMAgent.msi /norestart /qn /l*v %temp%\MOMAgentReinstall.log MANAGEMENT_GROUP= <SameManagementGroup>  MANAGEMENT_GROUP_OPERATION=ModifyConfigGroup MANAGEMENT_SERVER_DNS=<NewManagementServerName>  REINSTALL=ALL

Add a new management group

The following example adds a new management group to an agent. This is also referred to as “multi-homing.”

MsiExec.exe /i \\path\Directory\MOMAgent.msi /norestart /qn /l*v %temp%\MOMAgentAdd.log MANAGEMENT_GROUP=<NewManagementGroup> MANAGEMENT_GROUP_OPERATION=AddConfigGroup MANAGEMENT_SERVER_DNS=<NewManagementServerName> REINSTALL=ALL
Note: 

Note

If the agent was installed as Active Directory-enabled, then the configuration is set by Active Directory.

Remove a management group

The following example removes a management group from the agent.

MsiExec.exe /i \\path\Directory\MOMAgent.msi  /norestart /qn /l*v %temp%\MOMRemove.log MANAGEMENT_GROUP=<OldManagementGroup> MANAGEMENT_GROUP_OPERATION=RemoveConfigGroup MANAGEMENT_SERVER_DNS=<OldManagementServerName> REINSTALL=ALL

Note

If this is the last management group assigned to this agent, the agent will also be uninstalled.

If the agent was installed as Active Directory-enabled, then the configuration is set by Active Directory.

Remove an old management group or management server and redirect to a new management group or management server

The following example removes an existing management group or server and adds a new management group or server to the agent.

First, add the new management group or management server:

MsiExec.exe /i \\path\Directory\MOMAgent.msi /norestart /qn /l*v %temp%\MOMAgentAdd.log MANAGEMENT_GROUP=<NewManagementGroup> MANAGEMENT_GROUP_OPERATION=AddConfigGroup MANAGEMENT_SERVER_DNS=<NewManagementServerName> REINSTALL=ALL

Next, remove the old management group or management server:

MsiExec.exe /i \\path\Directory\MOMAgent.msi  /norestart /qn /l*v %temp%\MOMRemove.log MANAGEMENT_GROUP=<OldManagementGroup> MANAGEMENT_GROUP_OPERATION=RemoveConfigGroup MANAGEMENT_SERVER_DNS=<OldManagementServerName> REINSTALL=ALL

Note

Make sure to add the new management group first before removing the old one.  If you remove the old management group first and it’s the last management group assigned to the agent, the agent will be uninstalled.

If the agent was installed as Active Directory-enabled, then the configuration is set by Active Directory.