This is an archive version of the document. To get the most up-to-date information, see the current version.

Deploying Mac Management Agents

In this article

    Agent installation package for computers running macOS operating system contains both Veeam Service Provider Console management agent and Veeam Agent for Mac. Veeam Agent for Mac will be installed automatically after deployment of the management agent.

    To install a management agent and Veeam Agent for Mac on a client computer running macOS operating system:

    1. Log on to the machine where you want to install the management agent and Veeam Agent for Mac.
    2. Copy the agent installation package (MacAgentPackages.sh) on a machine where you want to install the management agent and Veeam Agent for Mac.

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

    1. Install the package with the following command:

    sudo <...>/'MacAgentPackages.sh'

    or

    sudo sh <...>/'MacAgentPackages.sh'

    or

    sudo bash <...>/'MacAgentPackages.sh'

    where:

    <...> — path to the directory where you have saved the MacAgentPackages.sh package.

    Tip:

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

    To configure the management agent:

    1. Use the following command:

    sudo veeamconsoleconfig -g add <gateway>:<port> -t <company_name\\username> (<password>) --validate_cert <thumbprint>

    where:

    • <gateway> — FQDN or IP address of a cloud gateway.
    • <port> — the port on the cloud gateway that is used to transfer data to Veeam Service Provider Console.
    • <company_name\\username> and <password> — user credentials of a Company Owner.

    If the password contains special characters, you must provide the password in the '<password>' format.

    • [optional] <thumbprint> — thumbprint of the security certificate that is installed on the Veeam Service Provider Console server.

    Important!

    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.