Installing the Management Agent - Veeam Service Provider Console
  • 15 Feb 2024
  • 4 Minutes to read
  • Dark
    Light

Installing the Management Agent - Veeam Service Provider Console

  • Dark
    Light

Article summary

The first step to adding a machine to the Veeam Service Provider Console is to install the Veeam management agent.

Once the management agent is installed, it can handle installing and upgrading the Veeam backup agent on the server or desktop computer that you want to back up.

Once the backup agent is installed you can start configuring your backups. The below guide shows the process of installing the management agent, backup agent

Getting the management agent

Before you start, make sure your system meets all the requirements listed here: System Requirements - Veeam Agent Management Guide 

First, log into your Veeam Service Provider Console account, at https://veeam.servercontrol.com.au:1280/

TIP
If you're backing up a computer that has a user interface such as Windows Server, it's recommended that you log into the Veeam Service Provider console from that machine itself, which will allow you to download the agent directly to the machine, saving you some steps later. 

1. Navigate to the 'Managed Computers' section.

2. Select 'Download Management Agent'.

3. Select the operating system of the desktop or server you wish to back up.



4. Set the Location (or leave it as the default location if you only have a single location configured), and set the token expiry period. The token expiry period is how long the agent will last before you have to redeploy. In secure environments, we recommend setting this to the maximum which is 5 years.

5. Once you have the agent, upload it to the server you wish to back up. You can do this via any method such as FTP, SCP, or Remote Desktop on Windows.

Installing the Management Agent - Windows

Run the Management Agent executable. You can do this straight from your browser if you've just downloaded it to the machine you wish to back up.

Otherwise, navigate to the management agent exe via Windows Explorer and run it.

This will start the installation wizard.

Simply click through the wizard and complete the installation.

Once the management agent is installed, you should see the veeam management agent running in your taskbar.

Give it a few minutes to complete the initialization and connection to cloud connect. 

You can double-click the agent to open the veeam management agent settings. You should see if it's connecting or connected already.

TIP
If you're having trouble getting the agent connected, make sure the veeam management agent service is running in your Windows 'Services' console.
You can also test to see that you can connect to the veeam cloud connect gateway by using the PowerShell 'Test-NetConnection' cmdlet.

EXAMPLE:
Test-NetConnection -ComputerName veeam-cg-1.servercontrol.com.au -port 6180

EXPECTED RESULT:
ComputerName     : veeam-cg-1.servercontrol.com.au
RemoteAddress    : 203.26.199.115
RemotePort       : 6180
InterfaceAlias   : Ethernet 2
SourceAddress    : xxxxxxxx
TcpTestSucceeded : True

If the 'TcpTestSucceeded' does not report as 'True', this means that something is blocking your connection to the veeam cloud connect gateway, such as a firewall. Please check your firewall to ensure that traffic is allowed outbound on port 6180 to the veeam cloud connect gateway.


Once connected, you should see the machine show up in the Veeam service provider console under 'Discovered Computers'.

Proceed to the "Install Backup Agent" section.

Installing the Management Agent - Linux

The installer for Linux is a shell script that must first be copied to the Linux server (via SCP, FTP, or any other method).

The method of installation is the same regardless of distribution. 

1. Copy the management agent installation script to the server. In this example, we'll use SCP. But you can use FTP or any other method to copy the installation script to the server. We'll be putting the installation script in the /root/ directory.

[root@myserver ~] scp -P22 LinuxAgentPackages.MyCompany_Default_location.sh root@myserver.com:/root/

2. Make sure the script is executable. On the Linux server:

[root@myserver ~] sudo chmod +x /root/LinuxAgentPackages.MyCompany_Default_location.sh

3. Run the installation script.

[root@myserver ~] sudo sh /root/LinuxAgentPackages.MyCompany_Default_location.sh

Veeam Management Agent Installation
Creating temp directory...
Unpacking installation files...
Extracting packages...
System platform: x64
Installing management agent...
Installing package veeamma-7.0.0.12777-x64-el7_template.rpm
Package veeamma-7.0.0.12777-x64-el7_template.rpm installation finished.
Copying files...
Configuring agent authentication settings...
Starting service...
Configuration summary: Management agent service has been restarted.
The management agent has been installed.
Run veeamconsoleconfig -s to get management agent status or veeamconsoleconfig -h to configure the management agent.
IF THE MANAGEMENT AGENT FAILS TO INSTALL WITH A PERMISSION DENIED ERROR PLEASE ACCESS THE FOLLOWING LINK FOR MORE INFORMATION:


4. Check to ensure that the management agent is running.


[root@myserver ~] veeamconsoleconfig -s
Management agent
    Connection state       : Connected
    Cloud gateway          : veeam-cg-1.servercontrol.com.au:6180
    Connection account     : Servers Australia Test Account
Backup agent
    Version                : 5.0.2.4567
    Driver version         : 5.0.2.4567
    Status                 : Running


If the management agent cannot connect, make sure you have allowed port 6180 to the cloud gateway IP address.

You can verify that the server can connect to port 6180 by using the 'nc' tool or 'telnet'.

[root@myserver ~] nc -vz veeam-cg-1.servercontrol.com.au 6180
Ncat: Version 7.50 ( https://nmap.org/ncat )
Ncat: Connected to 203.26.199.115:6180.
Ncat: 0 bytes sent, 0 bytes received in 0.04 seconds.
[root@myserver ~] telnet veeam-cg-1.servercontrol.com.au 6180
Trying 203.26.199.115...
Connected to veeam-cg-1.servercontrol.com.au.

If you don't see 'Connected' in the output, make sure you have adjusted your firewall correctly to allow the connection.


Proceed to the "Install Backup Agent" section.

Installing the Backup Agent

If the management agent doesn't automatically install the backup agent, you can do it manually by selecting the machine in the 'Discovered Computers' section, and then selecting 'Install Backup Agent'. This will deploy the backup agent component to the machine. 

Once the backup agent is installed, it will show up under the 'Backup Agents' section.

Once the Backup Agent is showing up in the interface correctly, you can proceed to create backup jobs for the machine.


Was this article helpful?


Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.
ESC

Eddy AI, facilitating knowledge discovery through conversational intelligence