Help Center
Choose product document...
Veeam Availability Console 3.0
Deployment Guide

Veeam Availability Console Management Agent

To install Veeam Availability Console management agent, 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"][VAC_SERVER_NAME="<product_server_name>"] [VAC_CC_COMMUNICATION_PORT="<port_number>"] [VAC_MANAGEMENT_AGENT_TYPE="2/3"] [VAC_SERVER_CERTIFICATE_THUMBPRINT="<security_certificate_thumbprint>"] [VAC_TENANT="tenant_account_name">] [VAC_TENANT_PASSWORD="tenant_account_password">] [CC_GATEWAY="cloud_gateway_address">]  [CC_GATEWAY_PORT="cloud_gateway_port_number">] [VAC_MASTER_MANAGEMENT_AGENT="master_agent_address">]

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\VACAgentSetup.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 Availability Console management agent. Specify a full path to the setup file as the parameter value.

Example: /i “C:\Veeam\VAC\VAC.CommunicationAgent.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"

VAC_MANAGEMENT_AGENT_TYPE

2/3

No

Specifies the role of the management agent. Specify 3 if you want to install management agent on the Veeam Cloud Connect server.

If you do not use this parameter, Veeam Availability Console management agent component will be installed as a client management agent (default value, 2).

Example: VAC_MANAGEMENT_AGENT_TYPE="3"

VAC_SERVER_NAME

server name or address

No

Specifies FQDN or IP address of the server where Veeam Availability Console server is deployed.

You can use this parameter if you have specified 3 for the VAC_MANAGEMENT_AGENT_TYPE parameter.

If you do not use this parameter, you will need to configure connection settings manually.

Example: VAC_SERVER_NAME=“vac.cloudprovider.com"

VAC_CC_COMMUNICATION_PORT

port

No

Specifies the port number that the management agent will use to transfer traffic from cloud gateways and Veeam Cloud Connect server to Veeam Availability Console Server component.

You can use this parameter if you have specified 3 for the VAC_MANAGEMENT_AGENT_TYPE parameter.

If you do not use this parameter, Veeam Availability Console management agent will use the default port 9999.

Example: VAC_CC_COMMUNICATION_PORT=“101"

VAC_SERVER_CERTIFICATE_THUMBPRINT

thumbprint

No

Specifies a thumbprint to verify the security certificate installed on the Veeam Availability Console server.

Example: VAC_SERVER_CERTIFICATE_THUMBPRINT="028EC0FB60A7EBA9B140FCD1553061AF991A7FDE"

VAC_TENANT

user name

No

Specifies the user name of the client Company Owner.

If you do not use this parameter, you will need to configure connection settings manually.

Example: VAC_TENANT="Beta\Beta"

VAC_TENANT_PASSWORD

password

No

Specifies the password of the client Company Owner.

If you do not use this parameter, you will need to configure connection settings manually.

Example: VAC_TENANT_PASSWORD="P@ssw0rd"

CC_GATEWAY

name or address

No

Specifies FQDN or IP address of a cloud gateway to which management agent connects.

If you do not use this parameter, you will need to configure connection settings manually.

Example: CC_GATEWAY="gate01.cloudprovider.com"

CC_GATEWAY_PORT

port

No

Specifies the port number on the cloud gateway that is used to transfer data to Veeam Availability Console.

If you do not use this parameter, Veeam Availability Console will use the default port 6180.

Example: CC_GATEWAY_PORT="6181"

VAC_MASTER_MANAGEMENT_AGENT

name or address

No

Specifies FQDN or IP address of the machine on which the management agent with the Master role is installed.

If you use this parameter, master agent will trigger management agent installation and configure management agents to communicate with Veeam Availability Console.

Example: VAC_MASTER_MANAGEMENT_AGENT="backup01.tech.local"

Example

Suppose you want to install Veeam Availability Console management agent with the following configuration:

  • Installation log location: C:\ProgramData\Veeam\Setup\Temp\Logs\VACAgentSetup.txt
  • No user interaction
  • Path to the MSI file: C:\Veeam\VAC\VAC.CommunicationAgent.x64.msi
  • Accept 3rd party license agreement
  • Accept Veeam license agreement
  • Agent type: client
  • Cloud gateway: gate01.cloudprovider.com
  • Company Owner user name: Beta\Beta
  • Company Owner password: P@ssw0rd
  • Communication ports: default
  • Security certificate thumbprint: 028EC0FB60A7EBA9B140FCD1553061AF991A7FDE

The command to install Veeam Availability Console management agent with such configuration will have the following parameters:

msiexec /qn /l*v C:\ProgramData\Veeam\Setup\Temp\Logs\VACAgentSetup.txt /i "C:\Veeam\VAC\VAC.CommunicationAgent.x64.msi"  CC_GATEWAY="gate01.cloudprovider.com" ACCEPT_THIRDPARTY_LICENSES="1" ACCEPT_EULA="1" VAC_TENANT="Beta\Beta" VAC_TENANT_PASSWORD="P@ssw0rd" VAC_CERT_THUMBPRINT="028EC0FB60A7EBA9B140FCD1553061AF991A7FDE"

Example 2

Suppose you want to install Veeam Availability Console management agent using a preconfigured master management agent:

  • Installation log location: C:\ProgramData\Veeam\Setup\Temp\Logs\VACAgentSetup.txt
  • No user interaction
  • Path to the MSI file: C:\Veeam\VAC\VAC.CommunicationAgent.x64.msi
  • Accept 3rd party license agreement
  • Accept Veeam license agreement
  • Agent type: client
  • Master management agent: backup01.tech.local
  • Communication ports: default

The command to install Veeam Availability Console management agent with such configuration will have the following parameters:

msiexec /qn /l*v C:\ProgramData\Veeam\Setup\Temp\Logs\VACAgentSetup.txt /i "C:\Veeam\VAC\VAC.CommunicationAgent.x64.msi"  ACCEPT_THIRDPARTY_LICENSES="1" ACCEPT_EULA="1" VAC_MASTER_MANAGEMENT_AGENT="backup01.tech.local"

Example 3

Suppose you want to install Veeam Availability Console management agent on a Veeam Cloud Connect :

The command to install Veeam Availability Console management agent with such configuration will have the following parameters:

msiexec /qn /l*v C:\ProgramData\Veeam\Setup\Temp\Logs\VACAgentSetup.txt /i "C:\Veeam\VAC\VAC.CommunicationAgent.x64.msi"  ACCEPT_THIRDPARTY_LICENSES="1" ACCEPT_EULA="1" VAC_MANAGEMENT_AGENT_TYPE="3" VAC_SERVER_NAME="vac.cloudprovider.com" VAC_CERT_THUMBPRINT="028EC0FB60A7EBA9B140FCD1553061AF991A7FDE"

Veeam Large Logo

Deployment Guide

Guide for Service Providers

Guide for End Users

Guide for Resellers

Usage Scenarios for Service Providers

RESTful API Reference