N-central Help

Use the command prompt to install Windows agents and probes

Install the Windows agent and probe using the command prompt to initiate a silent install. A silent install is a non-intrusive method of installing the agent software on devices. That is, there are no messages or windows displayed to the user during the installation. This also ensures that the correct settings are applied to all devices.

Customer-specific installs

The customer-specific install includes preset parameters based on the customer configuration. The only parameter that you can use on the command line is -ai to initiate a silent install. For example...

<nnWindows>AgentSetup.exe -ai

...where nnWindows is the customer number assigned and included in the downloaded agent executable.

Generic installs

A generic install is an install file you downloaded from the System Software tab on the Download Agent/Probe page, and is not associated with a specific customer. As such, you define the parameters on the command line. Each portion of the install is defined by a parameter. The table below outlines the parameter syntax.

The use of characters used for the user name and password parameters must contain only alphanumeric characters. You cannot use spaces, a backslash (\), quotation marks ("), or other special characters in the parameters of an installation command.

When writing an installation command, parameters can be sent to both the Windows installation software and the InstallShield application. In the case of a silent installation, parameters must be sent to both.

InstallShield® Command Parameters Details
/s Initiates a silent install.
/v Directs values to the Windows installation software. These must be contained within quotation marks. Spaces must be inserted after the first quotation mark and before the last quotation mark. This indicates the separation of parameters within the command.

 

Windows Install Parameters Details

/qn

Indicates a silent installation to the Windows installation software.

AGENTACTIVATIONKEY

The key generated by SolarWinds N-central required to install the generic system Agent software.

When using this parameter in an installation command, you do not need to use the CUSTOMERID and CUSTOMERNAME parameters. Similarly, if you used the CUSTOMERID and CUSTOMERNAME parameters you do not need to use the AGENTACTIVATIONKEY parameter.

AGENTPROXY (optional)

Include this parameter if you are using a proxy.

The proxy string must be provided in one of the following formats:

  • Non-authenticating Proxy - <server FQDN or IP address>:<port number>
  • Authenticating Proxy - <proxy user>:<proxy password>@<server FQDN or IP address>:<port number>
  • ISA 2000/2004 - <proxy domain>\\<proxy user>:<proxy password>@<server FQDN or IP address>:<port number>

CUSTOMERID

The numeric identifier of the customer on the device where you are installing the probe.

CUSTOMERNAME

The name of the customer device where you are installing the probe.

If used in an installation command, the CUSTOMERID and CUSTOMERNAME parameters must both be included together.

If the customer name includes a space, the name must be enclosed with \" characters. For example, CUSTOMERNAME=\"ACME Corp\"

SERVERPROTOCOL

Identifies the protocol that the Probe will use to communicate with the central server; either HTTP or HTTPS.

SERVERADDRESS

The IP address or FQDN of the central server.

SERVERPORT

The port number the probe uses to communicate with the central server. For example, 80 for HTTP or 443 for HTTPS.

If used in an installation command, the SERVERPROTOCOL, SERVERADDRESS, and SERVERPORT parameters must also be included together.

PROBETYPE

Identifies the type of Probe to be installed; either Local_Windows or Network_Windows, or Workgroup_Windows.

  • For the Network_Windows probe type, include the AGENTDOMAIN, AGENTUSERNAME, and AGENTPASSWORD parameters.
  • For the Workgroup_Windows probe type, include the AGENTUSERNAME and AGENTPASSWORD parameters.
  • This parameter is only used for WindowspProbes, not for Windows agents.

AGENTDOMAIN

The domain of the user account that will access the probe. This parameter is only used for Windows probes, not for Windows agents.

AGENTUSERNAME

The user name of the user account that will access the probe. This parameter is only used for Windows probes, not for Windows agents.

AGENTPASSWORD

The password of the user account that will access the probe. This parameter is only used for probes, not for Windows agents.

AMT_USER (optional)

The user name required to use Intel Active Management Technology (AMT) 4.0.

AMT_PASSWORD (optional)

The password required to use Intel Active Management Technology (AMT).

If used in an installation command, the AMT_USER and AMT_PASSWORD parameters must both be included together.

 

Examples

Installation commands can use either customer identification or activation keys.

Example 1 - Installing a Windows Probe Using Customer Identification

WindowsProbeSetup.exe /s /v" /qn AGENTPROXY=<proxy string> CUSTOMERID=<customer ID> CUSTOMERNAME=<customer name> SERVERPROTOCOL=<protocol> SERVERADDRESS=<server address> SERVERPORT=<port number> PROBETYPE=<type of probe> AGENTDOMAIN=<domain name> AGENTUSERNAME=<user name> AGENTPASSWORD=<user password> AMT_USER=<AMT user name> AMT_PASSWORD=<user password> "

Example 2 - Installing a Windows Agent Using Customer Identification

WindowsAgentSetup.exe /s /v" /qn AGENTPROXY=<proxy string> CUSTOMERID=<customer ID> CUSTOMERNAME=<customer name> AMT_USER=<AMT user name> AMT_PASSWORD=<user password> "

Example 3 - Installing a Windows Probe Using an Activation Key

WindowsProbeSetup.exe /s /v" /qn AGENTACTIVATIONKEY=<key> AGENTPROXY=<proxy string> SERVERPROTOCOL=<protocol> SERVERADDRESS=<server address> SERVERPORT=<port number> PROBETYPE=<type of probe> AGENTDOMAIN=<domain name> AGENTUSERNAME=<user name> AGENTPASSWORD=<user password> AMT_USER=<AMT user name> AMT_PASSWORD=<user password> "

Example 4 - Installing a Windows Agent Using an Activation Key

WindowsAgentSetup.exe /s /v" /qn AGENTACTIVATIONKEY=<key> AGENTPROXY=<proxy string> AMT_USER=<AMT user name> AMT_PASSWORD=<user password> "