Deploying Windows Management Agents
To install a management agent on a computer running Microsoft Windows operating system:
- Copy the agent setup file to a location accessible from the machine where you want to install the management agent.
- Log on to the machine as an Administrator.
- Double-click the agent setup file to launch the Veeam Service Provider Console Management Agent wizard.
- Follow the steps of the wizard.
- At the last step of the wizard, click Install.
- When installation completes, click Finish to close the wizard.
The agent will be installed by the following path: %ProgramFiles%\Veeam\Availability Console\CommunicationAgent.
If you have downloaded the management agent setup file from the Veeam Service Provider Console and the management agent is assigned to a company, it will automatically connect to Veeam Service Provider Console with the assigned company configuration. Otherwise, you must configure the agent manually.
Tip: |
You can install Veeam Service Provider Console management agent using the command line interface. For details on installation command-line syntax, see section Veeam Service Provider Console Management Agent for Microsoft Windows of the Deployment Guide. |
To configure a management agent:
- In the icon tray, right-click the management agent icon and choose Agent Settings.
If the icon is hidden, display hidden icons, find Veeam.MBP.Agent.Configurator in the list of notification area icons, and choose to show the icon and notifications for it.
- In the Management Agent Settings window, specify settings that the agent must use to connect to Veeam Service Provider Console.
- For agents hosted in client infrastructure, including master agents that will be used for discovery:
- In the Cloud gateway field, type FQDN or IP address of the cloud gateway.
- In the Port field, specify the port on the cloud gateway that is used to transfer data to Veeam Service Provider Console.
- [Optional] In the Tag field, specify the tag that must be assigned to the management agent.
- For agents hosted in your infrastructure, including master agents that will be used for discovery:
- In the Backup portal field, type FQDN or IP address of the Veeam Service Provider Console portal.
- In the Port field, specify the port that is used to transfer data to Veeam Service Provider Console.
- [Optional] In the Tag field, specify the tag that must be assigned to the management agent.
- In the Management Agent Settings window, click Apply.
Management agent will connect to Veeam Service Provider Console server, download the security certificate and perform its verification.
In case of errors during certificate verification you will be prompted the Security Certificate Preview window:
- To view error details, at the top of the window, click the Learn more link.
- To ignore the error and continue agent configuration, click Ignore.
- In the Management Agent window, click Restart to restart the management agent and apply connection settings.
- Wait for the agent to connect to Veeam Service Provider Console.
When the agent connects to Veeam Service Provider Console, the status in the Management Agent Settings window will be displayed as Connected. The agent icon in the icon tray will turn blue.
- [Optional] Specify an account that will be used for computer discovery, and the installation and upgrade of Veeam products on local computers.
If you do not specify an account at this stage, you can specify it when configuring discovery rules, or installing or upgrading VBR servers.
- In the Management Agent Settings window, click the Remote computer discovery user account link.
- In the Discovery Account window, select the Specify local administrator credentials for remote installation of backup agents check box.
- In the Username and Password fields, specify credentials of an account that will be used to discover client computers and install Veeam backup agents.
The account must have local Administrator permissions on all computers that you want to discover in the client infrastructure.
- Click OK.
- In the Management Agent Settings window, click Close.
What You Can Do Next
If a company has more than one location, you must set a location for the management agent.
By default, all new management agents you install belong to the default company location. If the management agent belongs to a non-default location, you must explicitly set this location for the agent.
For details on setting locations, see Setting Locations.