B.5 Silently Installing the Windows Agent

For information about silently installing the UNIX agent, see the AppManager for UNIX and Linux Servers Management Guide, available on the AppManager Modules Documentation page.

To silently install the Windows agent using the required parameters and default settings, run the following command from the folder where you saved the agent setup program:

msiexec.exe /i "NetIQ AppManager agent.msi" /qn
INSTALLDIR="C:\Program Files\NetIQ\" MC_B_REPORTAGENT=0 MC_SECLEVEL=0 MC_B_PORT=0 MC_B_MAPI=0 MC_B_WINUSER=1 MC_WINDOMAINUSER="Domain\User_Name_for_the_Windows_User_Account_under_which_the_
Agent_Services_Will_Run" MC_WINPWD="Password_for_the_Windows_User_Account_under_which_the_Agent_Services_
Will_Run" MC_B_ONMS=0|1

To specify additional parameters or alternate settings, add the appropriate parameters to the command. The following table describes all parameters available for silently installing the Windows agent.

Option

Description

MC_B_UPGRADE

Whether to install a new agent or upgrade an existing agent

Specify 1 to upgrade an existing agent.

Specify 0 to install a new agent.

If you specify 1, also specify the REINSTALLMODE and REINSTALL options.

REINSTALLMODE

If you specified to upgrade an existing agent, the type of reinstall to perform

Specify vomus.

REINSTALL

If you specified to upgrade an existing agent, the features to be reinstalled

Specify ALL.

INSTALLDIR

Target installation folder

The default value is C:\Program Files\NetIQ\.

MC_B_REPORTAGENT

Whether to enable the agent to generate reports.

Specify 1 to enable the agent to generate reports.

Specify 0 if you do not want to enable the agent to generate reports.

For more information about the agent reporting capability, see Section 8.1.3, Understanding Agent Reporting Capabilities.

MC_SECLEVEL

Security level to use for communication between the agent and management servers

Specify 0 if you do not want to secure communication between the agent and management servers.

Specify 1 to encrypt communication between the agent and management servers.

Specify 2 to encrypt and authenticate communication between the agent and management servers.

For more information about securing communication between the agent and management servers, see Section 6.1.2, Understanding QDB Security Options.

MC_SECPWD

If you specified to encrypt communication or to encrypt and authenticate communication between the agent and management servers, the password for the agent to access its portion of the QDB encryption key

Specify the same password you specified when you installed the QDB to which the agent reports.

MC_B_DISPLAYNAME

Whether to change the display name for the agent computer

Specify 1 to change the display name for the agent computer. If you specify 1, also specify a value for the MC_DISPLAYNAME parameter.

Specify 0 to use the agent computer name as the display name.

Use the MC_DISPLAYNAME parameter to specify the display name.

MC_DISPLAYNAME

If you specified to change the display name for the agent computer, name to display for the agent computer in the Control Center console and Operator Console

MC_B_PORT

Whether to change the default RPC ports where the management server and the agent listen for communications from each other

Specify 1 to change the ports.

Specify 0 to use the default ports.

If you specify 1, also specify values for the MS_PORT and MC_PORT parameters.

For more information about the ports the management server and agents use, see Section 6.6.1, Reviewing Management Server Port Information.

MS_PORT

If you specified to change the default RPC ports where the management server and the agent listen for communications from each other, port where the management server will listen for communications from the agent

MC_PORT

If you specified to change the default RPC ports where the management server and the agent listen for communications from each other, port where the agent will listen for communications from the management server

MC_B_MAPI

Whether to enable MAPI mail to allow the agent to automatically send email messages in response to certain events

Specify 1 to enable the MAPI mail option. If you specify 1, also specify values for the MC_EXCHSVR, MC_MAILBOX, and MC_PROFILE parameters.

Specify 0 if you do not want to enable the MAPI mail option.

For more information about the MAPI mail option, see Section 8.1.5, Understanding MAPI Mail Settings.

MC_EXCHSVR

If you specified to enable MAPI mail, name of the Microsoft Exchange Server the MAPI mail client will use

MC_MAILBOX

If you specified to enable MAPI mail, Exchange mailbox alias name for the agent service account to use

MC_PROFILE

If you specified to enable MAPI mail, Exchange client profile name

MC_B_WINUSER

Whether the agent services will use a Windows user account or the local system account

Specify 1 if the services will use a Windows user account. If you specify 1, also specify values for the MC_WINDOMAINUSER and MC_WINPWD or MC_WINPWDE parameters.

Specify 0 if the services will use the local system account.

In some cases, the services must use a Windows user account. For more information about account requirements for the agent services, see Section 2.3, Reviewing Required Accounts and Permissions.

MC_WINDOMAINUSER

If the agent services will use a Windows user account, the domain and user name for the account

MC_WINPWD

If the agent services will use a Windows user account and your site does not use FIPS, the password for the account

MC_WINPWDE

If the agent services will use a Windows user account and your site uses FIPS, the encrypted password for the account

MC_B_ONMS

Whether the management server is present on the agent computer

Specify 1 if the management server is present on the agent computer.

Specify 0 if the management server is not present on the agent computer.

If the management server is present on the agent computer, it must also be the primary management server for the agent. AppManager automatically selects the local management server as the primary management server.

MC_B_MSPRISEC

If you are not installing the agent on the same computer as the management server, whether to designate the primary and, optionally, secondary management server during agent installation

Specify 1 to designate the primary and, optionally, secondary management server during agent installation. If you specify 1, use the MC_MSPRIMARY and MC_MSSECONDARY parameters to specify the management server names.

Specify 0 to designate the primary and secondary management servers later using the AMAdmin_SetPrimaryMS Knowledge Script.

NetIQ Corporation recommends designating at least the primary management server during agent installation. For more information about designating management servers, see Section 8.1.7, Understanding Agent Automatic Discovery and Management Server Designation.

MC_MSPRIMARY

If you are not installing the agent on the same computer as the management server, name of the primary management server

MC_MSSECONDARY

Name of the secondary management server

MC_ALLOWMS

Whether to allow an anonymous management server to communicate with the agent

Specify * to allow an anonymous management server to communicate with the agent.

If you are installing the agent on the local computer, specify the names of the primary and secondary management servers to only allow those management servers to communicate with the agent.

If you are installing the agent on a remote computer, specify ; if you do not want to allow an anonymous management server to communicate with the agent.

If you are installing the agent on a remote computer, specify *; to allow an anonymous management server to communicate with the agent until you designate primary and secondary management servers.

MC_B_MSPRISEC_ REMOVEALLOWMSSTAR

Removes authorization for all management servers to communicate with the agent computer during agent installation. The AllowMS registry key stores the list of management servers that are authorized to communicate with an agent computer. The key uses an asterisk (*) to allow all management severs to communicate with an agent computer if you do not designate a primary management server.

If you designate the primary management server during agent installation, the MC_B_MSPRISEC_REMOVEALLOWMSSTAR parameter removes the asterisk from the AllowMS registry key.

If you do not designate the primary management server during agent installation, the parameter indicates that the AllowMS registry key should not change until you run the SetPrimaryMS Knowledge Script.

MC_B_MSPRISEC_REMOVESTAR

Whether to allow an anonymous management server to exchange reports with the agent

Specify 1 if you do not want to allow an anonymous management server to exchange reports with the agent.

Specify 0 to allow an anonymous management server to exchange reports with the agent.

MC_B_MSPRIMARY_EXIST

Whether the primary management server is available

Specify 1 if the primary management server is available.

Specify 0 if the primary management server is not available.

MC_B_MSSECONDARY_EXIST

Whether the secondary management server is available

Specify 1 if the secondary management server is available.

Specify 0 if the secondary management server is not available.

MC_B_PROXY

Installs the agent as a proxy

Specify 1 to install the agent as a proxy.

MC_MDBPATH

Target installation folder for the local repository

For more information about installing the agent, see Section 8.0, Installing Agent Components.