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] |
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\" |
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 | 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_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_ | 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" |