You are here: Software Download > Installing Windows Agents and Probes from the Command Prompt

Installing Windows Agents and Probes from the Command Prompt

Windows agents and probes can be installed from a command prompt instead of using the GUI installer to initiate the installation. This allows for silent installation which does not display any messages or windows during the installation process.

To access a Windows command prompt

The Windows installation software (.MSI format) used to install Windows agents and probes is contained within InstallShield® applications. This requires that the command syntax directs parameters to the Windows installation software instead of to the InstallShield® application.

Both generic installation programs or customer-specific installation programs can be started from the command prompt but only commands directed at generic installation programs can include specific parameters. Customer-specific installation programs already contain preset parameters and so the only parameter that can be used from the command line is /s to indicate a silent installation. As a result, we recommend that customer-specific installation programs should be started from the N-central UI and not from the command prompt.

Warning! Due to the restrictions placed by Windows installation software and InstallShield® applications on the use of special characters within an installation command, user name and password parameters must contain only alphanumeric characters. Do not use spaces, a backslash (\), quotation marks ("), or other special characters in the parameters of an installation command.

Syntax

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 Indicates a silent installation to the InstallShield® application.
/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.

Installation commands can use either customer identification or activation keys as shown in the examples below:

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 UsingCustomer 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> "

Windows Install Parameters Details
/qn Indicates a silent installation to the Windows installation software.
AGENTACTIVATIONKEY

The key generated by N-central that is required in order to install generic system agent software.

Note: If the AGENTACTIVATIONKEY parameter is used in an installation command, the CUSTOMERID and CUSTOMERNAME parameters do not need to be used. Similarly, if the CUSTOMERID and CUSTOMERNAME parameters are used in an installation command, the AGENTACTIVATIONKEY parameter does not need to be used.

AGENTPROXY (optional)

The information required if a proxy server is used.

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

  • Non-authenticating Proxy - <server FQDN or IP address>:<port number> (For example: 192.168.0.1:8080)
  • 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 whose device the probe will be installed.
CUSTOMERNAME

The name of the customer on whose device the probe will be installed.

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

Warning: If the customer name includes a space, the entire name must be indicated with double quotation marks and the double quotation marks must have escape characters (the \ character) in front of them. For example, the customer name ACME Corp should be inserted into the installation command in the format: CUSTOMERNAME=\"ACME Corp\"

SERVERPROTOCOL

Identifies the protocol that the probe will use to communicate with the central server as one of:

  • HTTP
  • HTTPS
SERVERADDRESS The IP address or FQDN of the central server.
SERVERPORT

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

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

PROBETYPE

Identifies the type of probe to be installed as one of:

  • Local_Windows
  • Network_Windows

Note: For the Network_Windows probe type, include the AGENTDOMAIN, AGENTUSERNAME, and AGENTPASSWORD parameters.

  • Workgroup_Windows

Note: For the Workgroup_Windows probe type, include only the AGENTUSERNAME and AGENTPASSWORD parameters must all be included together.

Note: This parameter is only used for Windows probes and not for Windows agents.

AGENTDOMAIN

The domain of the user account that will access the probe.

Note: This parameter is only used for Windows probes and not for Windows agents.

AGENTUSERNAME

The user name of the user account that will access the probe.

Note: This parameter is only used for Windows probes and not for Windows agents.

AGENTPASSWORD

The password of the user account that will access the probe.

Note: This parameter is only used for Windows probes and not for Windows agents.

AMT_USER (optional) The user name required to use Intel® Active Management Technology (AMT).
AMT_PASSWORD (optional)

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

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

Related Topics

For further product information and training, visit the N-able Resource Center.

Copyright © 2010 N-able Technologies Inc. All Rights Reserved.