Installing Veeam Backup & Replication in Silent Mode
You can install Veeam Backup & Replication in the unattended mode with a special XML answer file by using the command line interface. The answer file contains all the necessary installation settings in the proper order and their thorough description.
Before You Begin
Before starting the installation of Veeam Backup & Replication in the unattended mode with the answer file, consider the following:
- The user account that you use to run the silent installation must be in the local Administrators group on the machine where the silent installation will run. The silent installation cannot be run under the LocalSystem and NetworkService accounts.
- If the user account that you use to run the unattended installation is logged on the machine using the network logon method, the unattended installation will fail. To avoid this, use an additional /SkipNetworkLogonErrors command line key. For example, it is required when the unattended installation is started via a remote PowerShell session.
- When configuring the answer file, remove or comment out unused [Optional] parameters. Otherwise, the installation session will fail.
Installing Veeam Backup & Replication
To install Veeam Backup & Replication in the silent mode with the answer file, take the following steps:
- Copy the VbrAnswerFile_install.xml file to your local drive.
You can find the template answer file on the Veeam Backup & Replication installation disk in the \Setup\Silent\AnswerFiles\VBR folder. This folder contains the following templates of answer files used for installing, uninstalling, and upgrading Veeam Backup & Replication:
- VbrAnswerFile_install.xml — for installing Veeam Backup & Replication;
- VbrAnswerFile_uninstall.xml — for uninstalling Veeam Backup & Replication;
- VbrAnswerFile_upgrade.xml — for upgrading Veeam Backup & Replication.
- Configure installation parameters according to your needs. For details, see Configuration Parameters.
Check that the answer file has the correct bundle (Vbr) and mode (install) specified in line 2:
<unattendedInstallationConfiguration bundle="Vbr" mode="install" version="1.0"> |
- After you make all the necessary changes in your answer file, start the installation by running the Veeam.Silent.Install.exe file located on the Veeam Backup & Replication installation disk in the \Setup\Silent folder. Use the following command line keys in your installation command:
D:\Setup\Silent\Veeam.Silent.Install.exe /AnswerFile E:\MyAnswerFileVBRInstall.xml /SkipNetworkLogonErrors |
where:
- /AnswerFile — required key for specifying the path to your custom answer file, for example: E:\MyAnswerFileVBRInstall.xml.
- /SkipNetworkLogonErrors — optional key that allows skipping additional pre-installation validations that do not work under the network logon, which will block the silent installation from running.
- /LogFolder — optional key for specifying the path where the setup should save log files if it is different from the default path. The default path is: C:\ProgramData\Veeam\Setup\Temp.
The configuration file contains the following parameters:
Parameter | Required? | Default | Description |
|---|---|---|---|
ACCEPT_EULA | Yes |
| Specify 1 to accept the Veeam license agreement. |
ACCEPT_LICENSING_POLICY | Yes |
| Specify 1 to accept the Veeam licensing policy. |
ACCEPT_THIRDPARTY_LICENSES | Yes |
| Specify 1 to accept the license agreement for 3rd party components that Veeam incorporates. |
ACCEPT_REQUIRED_SOFTWARE | Yes |
| Specify 1 to accept all required software license agreements. |
VBR_LICENSE_FILE | No |
| Path to the license file on the machine where you want to install Veeam Backup & Replication. If you do not specify this parameter (or leave it empty value), Veeam Backup & Replication will be installed using the current license file. To install the Community Edition, set the parameter to to 0. |
VBR_LICENSE_AUTOUPDATE | No | 1 | Specify 1 to enable automatic license update and usage reporting. Specify 0 if you want to update the license manually. For Community Edition, NFR and Evaluation licenses, specify 1. For licenses without ID information, specify 0. |
VBR_SERVICE_USER | No |
| User account under which the Veeam Backup Service will run. If you do not specify this parameter, the service will run under the LocalSystem account. |
VBR_SERVICE_PASSWORD | No |
| Password for the account under which the Veeam Backup Service will run. |
VBR_SQLSERVER_INSTALL | Yes | 1 | Specify 0 to use an existing SQL server instance or specify 1 to create a new SQL server instance. |
VBR_SQLSERVER_ENGINE | No | 1 | Specify 1 to use PostgreSQL engine or specify 0 to use Microsoft SQL engine. Note that if you want to create a new SQL server instance, you can only choose the PostgreSQL engine. |
VBR_SQLSERVER_SERVER | No | localhost:5432 | SQL server and instance (for Microsoft SQL) or SQL server an port (for PostgreSQL) where the configuration database will be deployed. Note that if you want to create a new SQL instance, you can only connect to a local host. |
VBR_SQLSERVER_DATABASE | No | VeeamBackup | Configuration database name. If you do not specify this parameter, the default VeeamBackup name is used. |
VBR_SQLSERVER_AUTHENTICATION | No | 0 | Authentication mode to connect to the SQL Server where the Veeam Backup & Replication configuration database is deployed. Specify 1 to use the SQL Server authentication mode or specify 0 to use the Microsoft Windows authentication mode. |
VBR_SQLSERVER_USERNAME | No |
| LoginID to connect to the SQL Server in the SQL Server authentication mode. |
VBR_SQLSERVER_PASSWORD | No |
| Password to connect to the SQL Server in the SQL Server authentication mode. |
VBRC_SERVICE_PORT | No | 9393 | TCP port to be used by the Veeam Guest Catalog Service. If you do not specify this parameter, the default 9393 port is used. |
VBR_SERVICE_PORT | No | 9392 | TCP port to be used by the Veeam Backup Service. If you do not specify this parameter, the default 9392 port is used. If the specified port number is already occupied, the setup will assign the next available port number to the component. |
VBR_SECURE_CONNECTIONS_PORT | No | 9401 | TCP port to be used for communication between the mount server and the backup server. If you do not specify this parameter, the default 9401 port is used. |
VBR_RESTSERVICE_PORT | No | 9419 | TCP port to be used for communication with REST API service. If you do not specify this parameter, the default 9419 port is used. |
INSTALLDIR | No | C:\Program Files\Veeam\Backup and Replication | Path to the directory where Veeam Backup & Replication will be installed. If you do not specify this parameter, the default %ProgramFiles%\Veeam\Backup and Replication installation path is used. |
VM_CATALOGPATH | No | C:\VBRCatalog | Path to the catalog folder where index files will be stored. If you do not specify this parameter, a path is selected based on the free space across all available disks. |
VBR_IRCACHE | No | C:\ProgramData\Veeam\Backup\IRCache | Path to the folder where the instant recovery cache will be stored. If you do not specify this parameter, a path is selected based on the free space across all available disks. |
VBR_CHECK_UPDATES | No | 1 | Specify 1 to automatically check for new product versions and updates. Specify 0 if you do not want Veeam Backup & Replication to check for updates automatically. |
AHV_INSTALL | No | 0 | Specify 1 if you want to install Nutanix AHV Plug-in for Veeam Backup & Replication. Specify 0 if you do not want to install the plugin. |
RHV_INSTALL | No | 0 | Specify 1 if you want to install oVirt KVM Plug-in for Veeam Backup & Replication. Specify 0 if you do not want to install the plugin. |
AWS_INSTALL | No | 1 | Specify 1 if you want to install AWS Plug-in for Veeam Backup & Replication. Specify 0 if you do not want to install the plugin. |
AZURE_INSTALL | No | 1 | Specify 1 if you want to install Microsoft Azure Plug-in for Veeam Backup & Replication. Specify 0 if you do not want to install the plugin. |
GCP_INSTALL | No | 1 | Specify 1 if you want to install Google Cloud Plug-in for Veeam Backup & Replication. Specify 0 if you do not want to install the plugin. |
KASTEN_INSTALL | No | 1 | Specify 1 if you want to install Kasten K10 Plug-in for Veeam Backup & Replication. Specify 0 if you do not want to install the plugin. |
REBOOT_IF_REQUIRED | No | 0 | Specify 1 if you want to reboot the machine where you install Veeam Backup & Replication after the installation finishes. Specify 0 if you do not want to reboot the machine. |
Note that you must specify "1" in ACCEPT_EULA, ACCEPT_LICENSING_POLICY, ACCEPT_THIRDPARTY_LICENSES and ACCEPT_REQUIRED_SOFTWARE parameters to proceed with the installation.
Installation Result Codes
The installation result is written into the installation log file located at your selected log folder. It may show one of the following result codes:
Result Code | Result |
|---|---|
0 | success |
1603 | install failure |
3010 | reboot required |
3011 | logoff required |
Installation Error Codes
The installation error codes accompanied by their detailed description are displayed in the command line dialog. They can also be found in the UnattendedInstallationResult_%DATE%_%TIME%.xml file in the log folder (by default, C:\ProgramData\Veeam\Setup\Temp). You can use such an XML file for retrieving installation results from the scripts or utilities that are used to run the installation. The error message may show one of the following error codes:
Error Code | Description |
|---|---|
0 | Installation has been completed successfully. |
1 | Product is already installed. |
2 | Uninstallation has been completed successfully. |
11 | Unable to start the setup program, because machine's reboot is pending. |
12 | Reboot is required to finalize prerequisites installation. |
13 | Reboot is required to finalize the product installation. |
14 | Logoff is required to finalize the product installation. |
101 | Failed to start the installer. |
102 | Invalid answer file provided. |
103 | Invalid launch conditions. |
104 | Failed to initialize setup properties. |
105 | Failed to validate setup properties. |
106 | System configuration check detected some issues. |
107 | Failed to install prerequisites. |
108 | Failed to install a database server. |
109 | Failed to install the product. |
110 | Failed to update the product. |
111 | Failed to change a service status. |
112 | Failed to uninstall the product. |
113 | Unexpected error occurred. |