- 15 Feb 2024
- 4 Minutes to read
- Print
- DarkLight
Installing the Management Agent - Veeam Service Provider Console
- Updated on 15 Feb 2024
- 4 Minutes to read
- Print
- DarkLight
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/
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.
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.
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.