Veeam Backup & Replication Server

To install the Veeam Backup & Replication server, use a command with the following syntax:

msiexec.exe [/L*v "<path_to_log>"] /qn /i "<path_to_msi>" ACCEPT_EULA="1" ACCEPT_THIRDPARTY_LICENSES="1" ACCEPT_LICENSING_POLICY=1 ACCEPT_REQUIRED_SOFTWARE=1 [INSTALLDIR="<path_to_installdir >"] [VBR_LICENSE_FILE="<path_to_license_file>"] [VBR_LICENSE_AUTOUPDATE="1"] [VBR_SERVICE_USER="<Veeam_B&R_Service_account>"] [VBR_SERVICE_PASSWORD="<Veeam_B&R_Service_account_password>"] [VBR_SERVICE_PORT="<Veeam_B&R_Service_port>"] [VBR_SECURE_CONNECTIONS_PORT="<SSL_port>"] [VBR_SQLSERVER_ENGINE = 1][VBR_SQLSERVER_SERVER="<SQL_server>"] [VBR_SQLSERVER_DATABASE="<database_name>"][VBR_SQLSERVER_AUTHENTICATION="0"] [VBR_SQLSERVER_USERNAME="<SQL_auth_username>"] [VBR_SQLSERVER_PASSWORD="<SQL_auth_password>"] [VBR_IRCACHE="<path_to_instant_recovery_cache_folder>"] [VBR_CHECK_UPDATES="1"][VBR_AUTO_UPGRADE="1"]

Note

This command does not install the Veeam Backup & Replication console and the Veeam PowerShell module. To install the Veeam Backup & Replication console, run the command specified in Veeam Backup & Replication Console. The Veeam PowerShell module will be installed with the Veeam Backup & Replication console.

The command has the following parameters:

Option

Parameter

Required

Description

/L

*v logfile

No

Creates an installation log file with the verbose output. Specify a full path to the log file as the parameter value. A setup log file created during the previous installation is cleared.

Example: /L*v "C:\ProgramData\Veeam\Setup\Temp\Logs\Backup.txt"

/q

n

Yes

Sets the user interface level to “no”, which means no user interaction is needed during installation.

/i

setup file

Yes

Installs the Veeam Backup & Replication server. Specify a full path to the setup file as the parameter value.

Example: /i "E:\Backup\Server.x64.msi"

ACCEPT_EULA

0/1

Yes

Specifies if you want to accept the Veeam license agreement. Specify 1 to accept the license agreement and proceed with installation.

Example: ACCEPT_EULA="1"

ACCEPT_THIRDPARTY_LICENSES

0/1

Yes

Specifies if you want to accept the license agreement for 3rd party components that Veeam incorporates. Specify 1 to accept the license agreement and proceed with installation.

Example: ACCEPT_THIRDPARTY_LICENSES="1"

ACCEPT_LICENSING_POLICY

0/1

Yes

Specifies if you want to accept the Veeam licensing policy. Specify 1 to accept the licensing policy and proceed with installation.

Example: ACCEPT_LICENSING_POLICY="1"

ACCEPT_REQUIRED_SOFTWARE

0/1

Yes

Specifies if you want to accept the license agreements for each of the required software that Veeam will install. Specify 1 to accept the license agreements and proceed with installation.

Example: ACCEPT_REQUIRED_SOFTWARE="1"

INSTALLDIR

path

No

Installs the component to the specified location. By default, Veeam Backup & Replication uses the Backup subfolder of the C:\Program Files\Veeam\Backup and Replication\ folder.

Example: INSTALLDIR="C:\Backup\"
The component will be installed to the C:\Backup\Backup folder.

VBR_LICENSE_FILE

license path

No

Specifies a full path to the license file. If you do not specify this parameter, Veeam Backup & Replication will operate in the Community Edition mode.

Example: VBR_LICENSE_FILE="C:\Users\Administrator\Desktop\enterprise - veeam_backup_trial_0_30.lic"

VBR_LICENSE_AUTOUPDATE

0/1

No

Specifies if you want to update the license automatically (enables usage reporting). If you do not specify this parameter, the automatic update will be enabled. For Community Edition and NFR it must be set to 1. For licenses without license ID information it must be set to 0.

Example: VBR_LICENSE_AUTOUPDATE="1"

VBR_SERVICE_USER

user

No

Specifies the account under which the Veeam Backup Service will run. The account must have full control NTFS permissions on the VBRCatalog folder where index files are stored and the Database owner rights for the configuration database on the Microsoft SQL Server where the configuration database is deployed.

If you do not specify this parameter, the Veeam Backup Service will run under the LocalSystem account.

Together with the VBR_SERVICE_USER parameter, you must specify the VBR_SERVICE_PASSWORD parameter.

Example: VBR_SERVICE_USER="BACKUPSERVER\Administrator"

VBR_SERVICE_PASSWORD

password

No

This parameter must be used if you have specified the VBR_SERVICE_USER parameter.

Specifies a password for the account under which the Veeam Backup Service will run.

Example: VBR_SERVICE_PASSWORD="1234"

VBR_SERVICE_PORT

port

No

Specifies a TCP port that will be used by the Veeam Backup Service.

By default, the port number 9392 is used.

Example: VBR_SERVICE_PORT="9395"

VBR_SECURE_CONNECTIONS_PORT

port

No

Specifies a port used for communication between the mount server and the backup server. By default, port 9401 is used.

Example: VBR_SECURE_CONNECTIONS_PORT="9402"

VBR_SQLSERVER_ENGINE

0/1

No

Specifies the SQL engine to be used to deploy the configuration database.

Specify 0 if you want to use Microsoft SQL Server as your configuration database. If you do not specify this parameter, Veeam Backup & Replication will use PostgreSQL as your configuration database (default value is 1).

Example: VBR_SQLSERVER_ENGINE="1"

VBR_SQLSERVER_SERVER

SQL server\instance
or
SQL Server:port

No

Depending on the value of parameter VBR_SQLSERVER_ENGINE, this parameter has different format and default value:

If VBR_SQLSERVER_ENGINE=0, VBR_SQLSERVER_SERVER specifies a Microsoft SQL server and instance on which the configuration database will be deployed in the following format: SQL server\instance. By default, Veeam Backup & Replication uses (local)\VEEAMSQL2016 for machines running Microsoft Windows Server.

If VBR_SQLSERVER_ENGINE=1, VBR_SQLSERVER_SERVER specifies a PostgreSQL server and port on which the configuration database will be deployed in the following format: SQL Server:port. By default, Veeam Backup & Replication uses (local):5432 for machines running PostgreSQL.

Examples:
VBR_SQLSERVER_SERVER="BACKUPSERVER\VEEAMSQL2016_MY"
VBR_SQLSERVER_SERVER="(local):5432"

VBR_SQLSERVER_DATABASE

database

No

Specifies a name for the configuration database.

By default, the configuration database is deployed with the VeeamBackup name.

Example: VBR_SQLSERVER_DATABASE="VeeamBackup"

VBR_SQLSERVER_
AUTHENTICATION

0/1

No

Specifies if you want to use the SQL Server authentication mode to connect to the PostgreSQL or Microsoft SQL Server where the Veeam Backup & Replication configuration database is deployed.

Specify 1 if you want to use the SQL Server authentication mode. If you do not specify this parameter, Veeam Backup & Replication will connect to the Microsoft SQL Server in the Microsoft Windows authentication mode (default value is 0).

Together with this parameter, you must specify the following parameters: VBR_SQLSERVER_USERNAME and VBR_SQLSERVER_PASSWORD.

Example: VBR_SQLSERVER_AUTHENTICATION="1"

VBR_SQLSERVER_
USERNAME

user

No

This parameter must be used if you have specified the VBR_SQLSERVER_AUTHENTICATION parameter.

Specifies a LoginID to connect to the PostgreSQL or Microsoft SQL Server in the SQL Server authentication mode.

Example: VBR_SQLSERVER_USERNAME="sa"

VBR_SQLSERVER_
PASSWORD

password

No

This parameter must be used if you have specified the VBR_SQLSERVER_AUTHENTICATION parameter.

Specifies a password to connect to the PostgreSQL or Microsoft SQL Server in the SQL Server authentication mode.

Example: VBR_SQLSERVER_PASSWORD="1234"

VBR_IRCACHE

 

path

No

Specifies the folder to which the instant recovery cache will be stored. By default, Veeam Backup & Replication uses the folder on a volume with the maximum amount of free space, for example, C:\ProgramData\Veeam\Backup\IRCache\.

Example: VBR_IRCACHE="C:\ProgramData\Veeam\Backup\IRCache2\"

VBR_CHECK_UPDATES

0/1

No

Specifies if you want Veeam Backup & Replication to automatically check for new product versions and updates.

Specify 0 if you do not want to check for updates. If you do not specify this parameter, Veeam Backup & Replication will automatically check for updates (default value is 1).

Example: VBR_CHECK_UPDATES="0"

VBR_AUTO_UPGRADE

0/1

No

Specifies if you want Veeam Backup & Replication to automatically upgrade existing components in the backup infrastructure. Veeam Backup & Replication performs automatic upgrade after the Veeam Backup Service is started on the backup server.

Specify 1 to enable automatic upgrade. If you do not specify this parameter, Veeam Backup & Replication will not automatically upgrade existing components (default value is 0).

Example: VBR_AUTO_UPGRADE="1"

Example

Suppose you want to install Veeam Backup & Replication with the following configuration:

  • Installation log location: C:\logs\log1.txt
  • No user interaction
  • Path to the MSI file: E:\Backup\Server.x64.msi
  • Installation folder: D:\Program Files\Veeam
  • License file location: C:\License\veeam_license.lic
  • Service user account: VEEAM\Administrator
  • Service user account password: 1243
  • Service port: default
  • TLS port: default
  • Configuration database engine and database name: default
  • Path to the instant recovery cache folder: D:\IRCache

The command to install Veeam Backup & Replication with such configuration will have the following parameters:

msiexec.exe /L*v "C:\logs\log1.txt" /qn /i "E:\Backup\Server.x64.msi" ACCEPT_EULA="1" ACCEPT_THIRDPARTY_LICENSES="1" ACCEPT_LICENSING_POLICY=1 ACCEPT_REQUIRED_SOFTWARE=1 INSTALLDIR="D:\Program Files\Veeam" VBR_LICENSE_FILE="C:\License\veeam_license.lic" VBR_SERVICE_USER="VEEAM\Administrator" VBR_SERVICE_PASSWORD="1234" VBR_IRCACHE="D:\IRCache"

Page updated 6/3/2024

Page content applies to build 12.2.0.334