Caching Service
To install Veeam ONE Caching service, use a command with the following syntax:
|
msiexec.exe [/L*v "<path_to_log>"] /qn /i "<path_to_msi>" [ACCEPT_THIRDPARTY_LICENSES="1"][ACCEPT_EULA="1"][ACCEPT_REQUIRED_SOFTWARE="1"][ACCEPT_LICENSING_POLICY="1"][INSTALLDIR="<path_to_installdir>"][VO_CACHING_SERVICE_ACCOUNT_NAME="<Veeam_One_Service_Account>"][VO_CACHING_SERVICE_ACCOUNT_PASSWORD="<Veeam_One_Service_Account_Password>"] [VO_POSTGRESQL_INSTALLATION="0"] [VO_POSTGRESQL_SERVER="<PostgreSQL_server>"] [VO_POSTGRESQL_PORT="<port_number>"] [VO_POSTGRESQL_DATABASE="<database_name>"] [VO_POSTGRESQL_AUTHENTICATION="0"] [VO_POSTGRESQL_USERNAME="<PostgreSQL_username>"] [VO_POSTGRESQL_PASSWORD="<PostgreSQL_password>"] [VO_CACHING_SERVICE_PORT="<port_number>"] [VO_CACHING_SERVICE_REPORTERCONNECTIONPARAMETERS_PORT="<port_number>"] |
|
Important! |
|
Install Veeam ONE Reporting service before you install Veeam ONE Caching service. The Caching service registers with the Reporting service during setup and requires it to be available. |
The command has the following parameters:
|
Option |
Parameter |
Required |
Description |
|---|---|---|---|
|
/L |
*v logfile |
No |
Creates an installation log file with the verbose output. Specify an existing 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\CachingServiceSetup.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 ONE Caching service. Specify a full path to the setup file as the parameter value. Example: /i “C:\Veeam\Caching\VeeamONE.Caching.Service.x64.msi” |
|
ACCEPT_THIRDPARTY_LICENSES |
0/1 |
Yes |
Specifies if you want to accept the terms of the license agreement for the 3rd party components. Specify 1 if you want to accept the terms and proceed with installation. Example: ACCEPT_THIRDPARTY_LICENSES="1" |
|
ACCEPT_EULA |
0/1 |
Yes |
Specifies if you want to accept the terms of the Veeam license agreement. Specify 1 if you want to accept the terms and proceed with installation. Example: ACCEPT_EULA="1" |
|
ACCEPT_LICENSING_POLICY |
0/1 |
Yes |
Specifies if you want to accept the terms of the Veeam licensing policy. Specify 1 if you want to accept the terms and proceed with installation. Example: ACCEPT_LICENSING_POLICY="1" |
|
ACCEPT_REQUIRED_SOFTWARE |
0/1 |
Yes |
Specifies if you want to accept the terms of the required software license agreements. Specify 1 if you want to accept the terms and proceed with installation. Example: ACCEPT_REQUIRED_SOFTWARE="1" |
|
INSTALLDIR |
path |
No |
Installs the component to the specified location. By default, Veeam ONE uses a subfolder of the C:\Program Files\Veeam\Veeam ONE folder. Example: INSTALLDIR="C:\Veeam\" |
|
VO_CACHING_SERVICE_ACCOUNT_NAME |
user |
Yes |
Specifies a user account under which the Veeam ONE Caching Service will run. Example: VO_CACHING_SERVICE_ACCOUNT_NAME="ONESERVER\Administrator" |
|
VO_CACHING_SERVICE_ACCOUNT_PASSWORD |
password |
Yes |
This parameter must be used if you have specified the VO_CACHING_SERVICE_ACCOUNT_NAME parameter. Specifies a password for the account under which the Veeam ONE Caching Service will run. Example: VO_CACHING_SERVICE_ACCOUNT_PASSWORD="p@ssw0rd" |
|
VO_POSTGRESQL_INSTALLATION |
0/1 |
No |
Specifies whether the setup installs a new PostgreSQL instance or uses an existing one. This parameter corresponds to the Install new instance and Use existing instance options of the setup wizard. For details on, see Choose Reporting Database. If you use an existing instance, you must also specify the VO_POSTGRESQL_SERVER and VO_POSTGRESQL_DATABASE parameters. |
|
VO_POSTGRESQL_SERVER |
server |
No |
Specifies the hostname or IP address of the PostgreSQL server that hosts the Veeam ONE reporting database. Example: VO_POSTGRESQL_SERVER="postgres01.tech.local" |
|
VO_POSTGRESQL_PORT |
port number |
No |
Specifies the port number used for the PostgreSQL connection. If you do not use this parameter, the setup uses the default port 5432. Example: VO_POSTGRESQL_PORT="5432" |
|
VO_POSTGRESQL_DATABASE |
database |
No |
Specifies the name of the Veeam ONE reporting database. Example: VO_POSTGRESQL_DATABASE="VeeamOneReporting" |
|
VO_POSTGRESQL_AUTHENTICATION |
0/1 |
No |
Specifies the authentication mode used to connect to the PostgreSQL server instance: Microsoft Windows authentication or native database server authentication. If you use native authentication, you must also specify the VO_POSTGRESQL_USERNAME and VO_POSTGRESQL_PASSWORD parameters. |
|
VO_POSTGRESQL_USERNAME |
user |
No |
This parameter must be used if you have selected native database server authentication with the VO_POSTGRESQL_AUTHENTICATION parameter. Specifies the PostgreSQL account used to connect to the database server instance. The account requires the superuser role. For details on, see Connection to PostgreSQL. Example: VO_POSTGRESQL_USERNAME="postgres" |
|
VO_POSTGRESQL_PASSWORD |
password |
No |
This parameter must be used if you have specified the VO_POSTGRESQL_USERNAME parameter. Specifies a password to connect to the PostgreSQL server instance in the native authentication mode. Example: VO_POSTGRESQL_PASSWORD="p@ssw0rd" |
|
VO_CACHING_SERVICE_PORT |
port number |
No |
Specifies the port number that the Veeam ONE Caching service will use to provide cached report data by Veeam ONE Reporting service requests. If you do not use this parameter, Veeam ONE Caching service will use the default port 2743. Example: VO_CACHING_SERVICE_PORT="2743" |
|
VO_CACHING_SERVICE_REPORTERCONNECTIONPARAMETERS_PORT |
port number |
No |
Specifies the port number that the Veeam ONE Caching service uses to connect to Veeam ONE Web API. If you do not use this parameter, the setup uses the default port 2741. Example: VO_CACHING_SERVICE_REPORTERCONNECTIONPARAMETERS_PORT="2741" |
Example
Suppose you want to install Veeam ONE Caching service with the following configuration:
- Installation log location: C:\ProgramData\Veeam\Setup\Temp\Logs\CachingServiceSetup.txt
- No user interaction
- Path to the MSI file: C:\Veeam\Caching\VeeamONE.Caching.Service.x64.msi
- Accept 3rd party license agreement
- Accept Veeam license agreement
- Accept required software license agreements
- Accept Veeam licensing policy
- Installation folder: default
- Service user account: ONESERVER\Administrator
- Service user account password: p@ssw0rd
- PostgreSQL instance: existing instance postgres01.tech.local
- PostgreSQL port: default
- Reporting database name: VeeamOneReporting
- Authentication mode: native database server authentication
- PostgreSQL user: postgres
- PostgreSQL password: p@ssw0rd
- Caching service port: default
- Web API port: default
The command to install Veeam ONE Caching service with such configuration will have the following parameters:
msiexec.exe /L*v "C:\ProgramData\Veeam\Setup\Temp\CachingServiceSetup.txt" /qn /i "C:\Veeam\Caching\VeeamONE.Caching.Service.x64.msi" ACCEPT_THIRDPARTY_LICENSES="1" ACCEPT_EULA="1" ACCEPT_REQUIRED_SOFTWARE="1" ACCEPT_LICENSING_POLICY="1" VO_CACHING_SERVICE_ACCOUNT_NAME="ONESERVER\Administrator" VO_CACHING_SERVICE_ACCOUNT_PASSWORD="p@ssw0rd" VO_POSTGRESQL_INSTALLATION="0" VO_POSTGRESQL_SERVER="postgres01.tech.local" VO_POSTGRESQL_DATABASE="VeeamOneReporting" VO_POSTGRESQL_AUTHENTICATION="1" VO_POSTGRESQL_USERNAME="postgres" VO_POSTGRESQL_PASSWORD="p@ssw0rd" |