Unattended installation or uninstallation parameters
This section describes parameters that are used during unattended installation or uninstallation in Windows.
In addition to these parameters, you can use other parameters of msiexec
, as described at https://msdn.microsoft.com/en-us/library/windows/desktop/aa367988(v=vs.85).aspx.
Installation parameters
Common parameters
ADDLOCAL=
<list of components>
The components to be installed, separated by commas without space characters. All of the specified components must be extracted from the setup program prior to installation.
The full list of the components is as follows.
Component | Must be installed together with | Bitness | Component name / description |
---|---|---|---|
AcronisCentralizedManagementServer | WebConsole | 32-bit/64-bit | Management Server |
WebConsole | AcronisCentralizedManagementServer | 32-bit/64-bit | Web Console |
ComponentRegisterFeature | AcronisCentralizedManagementServer | 32-bit/64-bit | Components for Remote Installation |
AtpScanService | AcronisCentralizedManagementServer | 32-bit/64-bit | Scan Service |
AgentsCoreComponents | 32-bit/64-bit | Core components for agents | |
BackupAndRecoveryAgent | AgentsCoreComponents | 32-bit/64-bit | Agent for Windows |
ArxAgentFeature | BackupAndRecoveryAgent | 32-bit/64-bit | Agent for Exchange |
ArsAgentFeature | BackupAndRecoveryAgent | 32-bit/64-bit | Agent for SQL |
ARADAgentFeature | BackupAndRecoveryAgent | 32-bit/64-bit | Agent for Active Directory |
OracleAgentFeature | BackupAndRecoveryAgent | 32-bit/64-bit | Agent for Oracle |
ArxOnlineAgentFeature | AgentsCoreComponents | 32-bit/64-bit | Agent for Office 365 |
AcronisESXSupport | AgentsCoreComponents | 32-bit/64-bit | Agent for VMware (Windows) |
HyperVAgent | AgentsCoreComponents | 32-bit/64-bit | Agent for Hyper-V |
ESXVirtualAppliance | 32-bit/64-bit | Agent for VMware (Virtual Appliance) | |
ScaleVirtualAppliance | 32-bit/64-bit | Agent for Scale Computing HC3 (Virtual Appliance) | |
CommandLineTool | 32-bit/64-bit | Command-Line Tool | |
TrayMonitor | BackupAndRecoveryAgent | 32-bit/64-bit |
Cyber Protect Monitor |
BackupAndRecoveryBootableComponents | 32-bit/64-bit | Bootable Media Builder | |
PXEServer | 32-bit/64-bit | PXE Server | |
StorageServer | BackupAndRecoveryAgent | 64-bit | Storage Node |
CatalogBrowser | JRE 8 Update 111 or later | 64-bit | Catalog Service |
TARGETDIR=
<path>
The folder where the product will be installed.
REBOOT=ReallySuppress
If the parameter is specified, the machine reboot is forbidden.
CURRENT_LANGUAGE=
<language ID>
The product language. Available values are as follows: en
, en_GB
, cs
, da
, de
, es_ES
, fr
, ko
, it
, hu
, nl
, ja
, pl
, pt
, pt_BR
, ru
, tr
, zh
, zh_TW
.
ACEP_AGREEMENT={0,1}
If the value is 1
, the machine will participate in the Acronis Customer Experience Program (ACEP).
REGISTRATION_ADDRESS=
<host name or IP address>:<port>
The host name or IP address of the machine where the management server is installed. Agents, Storage Node, and Catalog Service specified in the ADDLOCAL
parameter will be registered on this management server. The port number is mandatory if it is different from the default value (9877).
With this parameter, you must specify either the REGISTRATION_TOKEN
parameter, or the REGISTRATION_LOGIN
and REGISTRATION_PASSWORD
parameters.
REGISTRATION_TOKEN=
<token>
The registration token that was generated in the Cyber Protect web console as described in Deploying agents through Group Policy.
REGISTRATION_LOGIN=
<user name>, REGISTRATION_PASSWORD=
<password>
The user name and password of a management server administrator.
REGISTRATION_TENANT=
<unit ID>
The unit within the organization. Agents, Storage Node, and Catalog Service specified in the ADDLOCAL
parameter will be added to this unit.
To learn a unit ID, in the Cyber Protect web console, click Settings > Accounts, select the unit, and click Details.
This parameter does not work without REGISTRATION_TOKEN
, or REGISTRATION_LOGIN
and REGISTRATION_PASSWORD
. In this case, the components will be added to the organization.
Without this parameter, the components will be added to the organization.
REGISTRATION_REQUIRED={0,1}
The installation result in case the registration fails. If the value is 1
, the installation fails. If the value is 0
, the installation completes successfully even though the component was not registered.
REGISTRATION_CA_SYSTEM={0,1}|REGISTRATION_CA_BUNDLE={0,1}|REGISTRATION_PINNED_PUBLIC_KEY=
<public key value>
These mutually exclusive parameters define the method of the management server certificate check during the registration. Check the certificate if you want to verify the authenticity of the management server to prevent MITM attacks.
If the value is 1
, the verification uses the system CA, or the CA bundle delivered with the product, correspondingly. If a pinned public key is specified, the verification uses this key. If the value is 0
or the parameters are not specified, the certificate verification is not performed, but the registration traffic remains encrypted.
/l*v
<log file>
If the parameter is specified, the installation log in the verbose mode will be saved to the specified file. The log file can be used for analyzing the installation issues.
Management server installation parameters
WEB_SERVER_PORT=
<port number>
The port that will be used by a web browser to access the management server. By default, 9877.
AMS_ZMQ_PORT=
<port number>
The port that will be used for communication between the product components. By default, 7780.
SQL_INSTANCE=
<instance>
The database to be used by the management server. You can select any edition of Microsoft SQL Server 2012, Microsoft SQL Server 2014, or Microsoft SQL Server 2016. The instance you choose can also be used by other programs.
Without this parameter, the built-in SQLite database will be used.
SQL_USER_NAME=
<user name> and SQL_PASSWORD=
<password>
Credentials of a Microsoft SQL Server login account. The management server will use these credentials to connect to the selected SQL Server instance. Without these parameters, the management server will use the credentials of the management server service account (AMS User).
Account under which the management server service will run
Specify one of the following parameters:
-
AMS_USE_SYSTEM_ACCOUNT={0,1}
If the value is
1
, the system account will be used. -
AMS_CREATE_NEW_ACCOUNT={0,1}
If the value is
1
, a new account will be created. -
AMS_SERVICE_USERNAME=
<user name> andAMS_SERVICE_PASSWORD=
<password>The specified account will be used.
Agent installation parameters
HTTP_PROXY_ADDRESS=
<IP address> and HTTP_PROXY_PORT=
<port>
The HTTP proxy server to be used by the agent. Without these parameters, no proxy server will be used.
HTTP_PROXY_LOGIN=
<login> and HTTP_PROXY_PASSWORD=
<password>
The credentials for the HTTP proxy server. Use these parameters if the server requires authentication.
HTTP_PROXY_ONLINE_BACKUP={0,1}
If the value is 0
, or the parameter is not specified, the agent will use the proxy server only for backup and recovery from the cloud. If the value is 1
, the agent also will connect to the management server through the proxy server.
SET_ESX_SERVER={0,1}
If the value is 0
, Agent for VMware being installed will not be connected to a vCenter Server or an ESXi host. After the installation, proceed as described in "Configuring an already registered Agent for VMware".
If the value is 1
, specify the following parameters:
ESX_HOST=
<host name or IP address>
The host name or IP address of the vCenter Server or the ESXi host.
ESX_USER=
<user name> and ESX_PASSWORD=
<password>
Credentials to access the vCenter Server or ESXi host.
Account under which the agent service will run
Specify one of the following parameters:
-
MMS_USE_SYSTEM_ACCOUNT={0,1}
If the value is
1
, the system account will be used. -
MMS_CREATE_NEW_ACCOUNT={0,1}
If the value is
1
, a new account will be created. -
MMS_SERVICE_USERNAME=
<user name> andMMS_SERVICE_PASSWORD=
<password>The specified account will be used.
Storage node installation parameters
Account under which the storage node service will run
Specify one of the following parameters:
-
ASN_USE_SYSTEM_ACCOUNT={0,1}
If the value is
1
, the system account will be used. -
ASN_CREATE_NEW_ACCOUNT={0,1}
If the value is
1
, a new account will be created. -
ASN_SERVICE_USERNAME=
<user name> andASN_SERVICE_PASSWORD=
<password>The specified account will be used.
Catalog service installation parameters
CATALOG_DATA_MIGRATION_PATH=<path>
Use this parameter to migrate the catalog data to the new version of the catalog service in Acronis Cyber Protect 15 Update 4. Specify the path to the temporary folder where the catalog data will be exported.
SKIP_CATALOG_DATA_MIGRATION=1
Use this parameter to skip the migration of catalog data.
The parameters SKIP_CATALOG_DATA_MIGRATION
and CATALOG_DATA_MIGRATION_PATH
are mutually exclusive.
Uninstallation parameters
REMOVE={
<list of components>|ALL}
The components to be removed, separated by commas without space characters.
Available components are described earlier in this section.
If the value is ALL
, all of the product components will be uninstalled. Additionally, you can specify the following parameter:
DELETE_ALL_SETTINGS={0, 1}
If the value is 1
, the product's logs, tasks, and configuration settings will be removed.