Note: Support ended for legacy Exchange MAPI, SQL Server VDI and SharePoint Plug-in jobs as of Agent version 7.50. Before upgrading an Agent, you must delete jobs with these legacy types, or the upgrade will fail. If you upgrade an Agent with a legacy plug-in to version 7.50 or later, the plug-in will be removed.
To install or upgrade the Windows Agent and any plug-ins in silent mode, run the following command in the directory where the installation kit is located:
installKitName /s /v"/qn [parameters] [featureParameters]" [/l"language"]
Where:
•installKitName is the name of the Windows Agent installation kit: Agent-Windows-x64-x-xx-xxxx.exe for 64-bit systems or Agent-Windows-x-xx-xxxx.exe for 32-bit systems. x-xx-xxxx represents the Agent version number.
•parameters are optional parameters for running the installation kit in silent mode. For a list of available parameters, see Windows Agent installation parameters.
•featureParameters are optional parameters for installing plug-ins and features in silent mode. See Windows Agent feature parameters.
•/l"language" is an optional parameter that specifies the language for the Agent. Available language values are:
•1033 – English (United States). This is the default value.
•1036 – French (Standard)
•1031 – German
•1034 – Spanish
For example, to install the French version of the Agent, include the following parameter: /L"1036"
Windows Agent installation parameters
|
Parameter |
Description |
Default Value |
|
ACCOUNTTYPE |
Possible values are LocalSystem, AutoCreate, and Custom. |
LocalSystem |
|
SERVICEACCOUNTNAME |
If ACCOUNTTYPE is Custom, this field is required. |
|
|
SERVICEACCOUNTPASSWORD |
If ACCOUNTTYPE is Custom, this field is required. |
|
|
REGISTERWITHWEBCC |
Turns on/off registration of the Agent with Portal. |
False |
|
AMPNWADDRESS |
If REGISTERWITHWEBCC is True, this field is required. |
|
|
AMPPASSWORD |
If REGISTERWITHWEBCC is True, this field is required. |
|
|
AMPPORT |
|
8086 |
|
AMPUSERNAME |
If REGISTERWITHWEBCC is True, this field is required. |
|
|
EXTRACTMSI |
Turns on/off extraction of the Microsoft Installer (MSI) package. |
False |
|
INTEGRATEDENCRYPTION |
Specifies whether to use the optimized AES 256 data encryption method that is integrated with the Agent, or use an external encryption library. Available values are: •On – the Agent uses the internal, optimized AES 256 data encryption method •Off – the Agent uses the external encryption library Note: The data encryption method is used for data at rest. Note: You cannot change the data encryption method when you modify or repair the Agent. You can only change the data encryption method when you install or upgrade the Agent. |
On |
|
KEEPAMPREGISTRATION |
Set this property to True to retain the previous Portal registration. |
True |
|
MSIPATH |
If EXTRACTMSI is True, this property denotes the location of the extracted MSI and MST files. |
C:\ |
|
SILENTINSTALLDIR |
Specifies an installation folder for the Agent. The installation folder must be enclosed in double quotation marks if there are spaces in the name or path.
|
|
Windows Agent feature parameters
|
Feature Parameter |
Description |
Default Value |
|
FEATURECLUSTER={On|Off} |
Turns on/off installation of the Cluster Plug-in. |
Off |
|
FEATUREEXCHANGE= {On|Off} |
Turns on/off installation of the Exchange 2007 DR Plug-in. Note: Only available with the 64-bit Windows Agent. |
Off |
|
FEATUREEXCHANGE2010= {On|Off} |
Turns on/off installation of the Exchange 2010/2013/2016 DR Plug-in. Note: Only available with the 64-bit Windows Agent. |
Off |
|
FEATUREORACLE={On|Off} |
Turns on/off installation of the Oracle Plug-in. |
Off |
|
FEATURESQL={On|Off} |
Turns on/off installation of the SQL Server Plug-in. |
Off |
|
FEATUREVOLUMEIMAGE= {On|Off} |
Turns on/off installation of the Image Plug-in. Note: Only available with the 64-bit Windows Agent. Note: After the Image Plug-in is installed silently, the machine must be restarted before the Plug-in can use Changed Block Tracking (CBT) to identify data that has changed since a previous backup. Without CBT, the Agent reads all data when backing up a volume. |
Off |
For example, to install the 64-bit Agent in a different directory, run the following command:
Agent-Windows-x64-x-xx-xxxx.exe /s /v" SILENTINSTALLDIR=\"C:\Program Files\Acme Software\" /qn"
Note: In each example shown, x-xx-xxxx represents the Agent version number.
To install the French version of the 32-bit Agent, run the following command:
Agent-Windows-x-xx-xxxx.exe /s /v" /qn" /l"1036"
where 1036 indicates that the French version of the Agent is installed.
To install the 64-bit Agent and register it with Portal, run a command similar to this:
Agent-Windows-x64-x-xx-xxxx.exe /s /v" REGISTERWITHWEBCC=True AMPNWADDRESS=123.456.com AMPUSERNAME=user@test.com AMPPASSWORD=password /qn"
To install the 64-bit Agent and the SQL Server Plug-in:
Agent-Windows-x64-x-xx-xxxx.exe /s /v" FEATURESQL=On /qn"