Veeam Backup Enterprise Manager

To install Veeam Backup Enterprise Manager, 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 >"] VBREM_LICENSE_FILE="<path_to_license_file>" [VBREM_LICENSE_AUTOUPDATE="1"] [VBREM_SERVICE_USER="<Veeam_EM_Service_account>"][VBREM_SERVICE_PASSWORD="<Veeam_EM_Service_account_password>"] [VBREM_SERVICE_PORT="<Veeam_EM_Service_port>"] [VBREM_SQLSERVER_ENGINE=1]
[VBREM_SQLSERVER_SERVER="<SQL_server>"] [VBREM_SQLSERVER_DATABASE="<database_name>"][VBREM_SQLSERVER_AUTHENTICATION="0"] [VBREM_SQLSERVER_USERNAME="<SQL_auth_username>"] [VBREM_SQLSERVER_PASSWORD="<SQL_auth_password>"] [VBREM_TCPPORT="<TCP_port_for_web_site>"] [VBREM_SSLPORT="<SSL_port_for_web_site>”]>"] [VBREM_THUMBPRINT="<certificate_hash>"] [VBREM_RESTAPISVC_PORT="<TCP_port_for_RestApi_service>"] [VBREM_RESTAPISVC_SSLPORT="<SSL_port_for_RestApi_service>"][VBREM_CHECK_UPDATES="1"]

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\EM.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 Veeam Backup Enterprise Manager.

Specify a full path to the setup file as the parameter value.

Example: /i "C:\Veeam\EnterpriseManager\BackupWeb_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 Enterprise Manager subfolder of the C:\Program Files\Veeam\ folder.

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

VBREM_LICENSE_FILE

license path

Yes

Specifies a full path to the license file.

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

VBREM_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: VBREM_LICENSE_AUTOUPDATE="1"

VBREM_SERVICE_USER

user

No

Specifies the account under which the Veeam Backup Enterprise Manager 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 Veeam Backup Enterprise Manager configuration database on the Microsoft SQL Server that you plan to use.

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

Together with the VBREM_SERVICE_USER parameter, you must specify the VBREM_SERVICE_PASSWORD parameter.

Example: VBRC_SERVICE_USER="BACKUPSERVER\Administrator"

VBREM_SERVICE_PASSWORD

password

No

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

Example: VBREM_SERVICE_PASSWORD="1234"

VBREM_SERVICE_PORT

Port

No

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

By default, the port number 9394 is used.

Example: VBREM_SERVICE_PORT ="9394"

VBREM_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: VBREM_SQLSERVER_ENGINE="1"

VBREM_SQLSERVER_SERVER

SQL server\instance
or
SQL Server:port

No

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

If VBREM_SQLSERVER_ENGINE=0, VBREM_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 VBREM_SQLSERVER_ENGINE=1, VBREM_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:
VBREM_SQLSERVER_SERVER="BACKUPSERVER\VEEAMSQL2016_MY"
VBREM_SQLSERVER_SERVER="(local):5432"

VBREM_SQLSERVER_DATABASE

database

No

Specifies a name of the Veeam Backup Enterprise Manager database.

By default, the database is deployed with the VeeamBackupReporting name.

Example: VBREM_SQLSERVER_DATABASE="VeeamBackupReporting01"

VBREM_SQLSERVER_
AUTHENTICATION

0/1

No

Specifies if you want to use the Microsoft SQL Server authentication mode to connect to the Microsoft SQL Server where the Veeam Backup Enterprise Manager is deployed.

Set this parameter to 1 if you want to use the SQL Server authentication mode. If you do not specify this parameter, Veeam Backup Enterprise Manager 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: VBREM_SQLSERVER_USERNAME and VBREM_SQLSERVER_PASSWORD.

Example: VBREM_SQLSERVER_AUTHENTICATION="1"

VBREM_SQLSERVER_USERNAME

user

No

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

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

Example: VBREM_SQLSERVER_USERNAME="sa"

VBREM_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 Microsoft SQL Server in the SQL Server authentication mode.

Example: VBREM_SQLSERVER_USERNAME="1234"

VBREM_TCPPORT

port

No

Specifies a TCP port that will be used by the Veeam Backup Enterprise Manager website.

By default, the port number 9080 is used.

Example: VBREM_TCPPORT="9080"

VBREM_SSLPORT

port

No

Specifies a port that will be used by the Veeam Backup Enterprise Manager website.

By default, the port number 9443 is used.

Example: VBREM_SSLPORT="9443"

VBREM_THUMBPRINT

hash

No

Specifies the certificate to be used by Veeam Backup Enterprise Manager Service and Veeam RESTful API Service. If this parameter is not specified, a new certificate will be generated by openssl.exe.

Example: VBREM_THUMBPRINT="0677d0b8f27caccc966b15d807b41a101587b488"

VBREM_RESTAPISVC_PORT

port

No

Specifies a TCP port that will be used by the Veeam Backup Enterprise Manager RESTful API Service.

By default, the port number 9399 is used.

Example: VBREM_RESTAPISVC_PORT="9399"

VBREM_RESTAPISVC_SSLPORT

port

No

Specifies a port that will be used by the Veeam RESTful API Service.

By default, the port number 9398 is used.

Example: VBREM_RESTAPISVC_SSLPORT="9398"

VBREM_CONFIG_SCHANNEL

0/1

No

Specifies if the TLS 1.2 protocol will be used for secure communication with the Veeam Backup Enterprise Manager website.

VBREM_CHECK_UPDATES

0/1

No

Specifies if you want Veeam Backup Enterprise Manager 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 Enterprise Manager will automatically check for updates (default value is 1).

Example: VBREM_CHECK_UPDATES="0"

Example

Suppose you want to install Veeam Backup Enterprise Manager with the following settings:

  • Installation log location: C:\logs\log1.txt
  • No user interaction
  • Path to the MSI file: E:\Veeam\EnterpriseManager\BackupWeb_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
  • Microsoft SQL Server database: BACKUPSERVER\VEEAMSQL2012_MY
  • Database name: VeeamReporting01
  • TCP and TLS ports: default
  • Certificate: default
  • TCP port for RESTful API: 9396
  • TLS port for RESTful API: 9397
  • No check for updates

The command to install Veeam Backup Enterprise Manager with such configuration will have the following parameters:

msiexec.exe /L*v "C:\logs\log1.txt" /qn /i "E:\Veeam\EnterpriseManager\BackupWeb_x64.msi" ACCEPT_EULA="1" ACCEPT_THIRDPARTY_LICENSES="1" ACCEPT_LICENSING_POLICY=1 ACCEPT_REQUIRED_SOFTWARE=1 INSTALLDIR="D:\Program Files\Veeam" VBREM_LICENSE_FILE="C:\License\veeam_license.lic" VBREM_SERVICE_USER="VEEAM\Administrator" VBREM_SERVICE_PASSWORD="1234" VBREM_SQLSERVER_SERVER="BACKUPSERVER\VEEAMSQL2012_MY" VBREM_SQLSERVER_DATABASE="VeeamReporting01" VBREM_RESTAPISVC_PORT="9396" VBREM_CHECK_UPDATES="0"

Page updated 1/25/2024

Page content applies to build 12.1.1.56