Installing and Configuring Linux Master Agent

In this article

    Before you start discovery and installation, you must install and configure a master agent on a Linux machine in the company infrastructure.


    Before you install and configure a master agent:

    • Obtain the management agent setup file.

    For details, see How to Obtain Management Agent Setup File.

    • Make sure that the machine that will host the master agent has access to the Internet, and network access to all computers that you want to discover in the client infrastructure.
    • Make sure you have the root account or any user account with super user privileges on all computers that you want to discover.

    Required Details

    Obtain the following data from the service provider:

    • FQDN or IP address of a cloud gateway
    • Port on the cloud gateway used to transfer backup data to and from cloud repositories
    • Thumbprint of a certificate that is installed on the Veeam Service Provider Console server

    Installing and Configuring Master Agent

    To install a master agent:

    1. Log on to the machine where you want to install the master agent.
    2. Copy the agent installation package on a machine where you want to install the master agent.

    Make sure that you have permission to execute the installation package file.

    1. Install the package with the following command:

    sudo <...>/'LinuxAgentPackages.<company_name>.sh'


    sudo sh <...>/'LinuxAgentPackages.<company_name>.sh'


    sudo bash <...>/'LinuxAgentPackages.<company_name>.sh'




    To see all available actions for managing the master agent, use the following command: veeamconsoleconfig -h.

    If you have downloaded the management agent setup file from Veeam Service Provider Console, it will connect to Veeam Service Provider Console automatically. Otherwise, you must configure the agent manually.

    To configure a master agent:

    1. Use the following commands:

    sudo veeamconsoleconfig -g add <gateway>:<port> --tag_name <tag> --validate_cert <thumbprint>

    sudo veeamconsoleconfig --tag_name <tag>



    It is strongly recommended to provide a certificate thumbprint for automated verification of the security certificate. Do not use the --validate_cert command with -f argument.

    Management agent will connect to Veeam Service Provider Console server and verify the security certificate.

    1. If you did not specify a certificate thumbprint, you will be asked to verify the security certificate.

    After you verify the certificate, management agent will restart and apply connection settings automatically.

    1. Wait for the agent to connect to Veeam Service Provider Console.

    What You Can Do Next

    If a company has more than one location, you must set a location for the master agent.

    By default, all new master agents you install belong to the default company location. If the master agent belongs to a non-default location, you must explicitly set this location for the agent.

    For details on setting locations, see Setting Locations.