Unattended installation and uninstallation in macOS

Unattended installation and uninstallation in macOS

This section describes how to install, register, and uninstall the protection agent in the unattended mode on a machine running macOS, by using the command line.

Required permissions

Before you initiate an unattended installation on a mac workload, you must modify the Privacy Preferences Policy Control to allow App access and kernel and system extensions in the macOS of the workload to enable the installation of the Cyber Protection agent. See Required permissions for unattended installation in macOS.
After you deploy the PPPC payload, you can proceed with the procedures below.

To download the installation file (.dmg)

  1. In the Cyber Protection service console, go to Devices > All devices.
  2. Click Add, and then click Mac.

To install Agent for Mac

  1. Create a temporary directory where you will mount the installation file (.dmg).

    mkdir <dmg_root>

    Here, <dmg_root> is a name of your choice.

  2. Mount the .dmg file.

    hdiutil attach <dmg_file> -mountpoint <dmg_root>

    Here, <dmg_file> is the name of the installation file. For example, Cyber_Protection_Agent_for_MAC_x64.dmg.

  3. Run the installer.

    • If you use a full installer for MAC, like CyberProtect_AgentForMac_x64.dmg or CyberProtect_AgentForMac_arm64.dmg, run the following command.
      sudo installer -pkg <dmg_root>/Install.pkg -target LocalSystem
      If you need to enable auto-onboarding for File Sync & Share, run the following command instead. This option will request the administrator password.
      open <dmg_root>/Install.app --args --unattended --fss-onboarding-auto-start
    • If you use an universal installer for MAC, like CyberProtect_AgentForMac_web.dmg, run the following command.
      sudo <dmg_root>/Install.app/Contents/MacOS/cyber_installer -a

  4. Detach the installation file (.dmg).

    hdiutil detach <dmg_root>

Examples

  • mkdir mydirectory
    hdiutil attach /Users/JohnDoe/Cyber_Protection_Agent_for_MAC_x64.dmg -mountpoint mydirectory
    sudo installer -pkg mydirectory/Install.pkg -target LocalSystem
    hdiutil detach mydirectory

To register Agent for Mac

Do one of the following:

  • Register the agent under a specific account, by using a user name and password.

    sudo /Library/Application\ Support/BackupClient/Acronis/RegisterAgentTool/RegisterAgent -a <Cyber Protection service address> -t cloud -u <user name> -p <password> -o register

    Here:

    <Cyber Protection service address> is the address that you use to log in to the Cyber Protection service. For example:

    <user name> and <password> are the credentials for the account under which the agent will be registered.This cannot be a partner administrator account.

  • Register the agent by using a registration token.

    sudo /Library/Application\ Support/BackupClient/Acronis/RegisterAgentTool/RegisterAgent -a <Cyber Protection service address> -t cloud -o register --token <token>

    The registration token is a series of 12 characters, separated by hyphens in three segments. You can generate one in the service console, as described in "Deploying agents through Group Policy".

    When you use a registration token, you must specify the exact datacenter address. This is the URL that you see once you are logged in to the Cyber Protection service. For example:

Examples

Registration with a user name and password.

  • sudo /Library/Application\ Support/BackupClient/Acronis/RegisterAgentTool/RegisterAgent -a https://cloud.company.com -t cloud -u johndoe -p johnspassword -o register

Registration with a token.

  • sudo /Library/Application\ Support/BackupClient/Acronis/RegisterAgentTool/RegisterAgent -a https://eu2-cloud company.com -t cloud o -register --token D91D-DC46-4F0B

If you use macOS 10.14 or later, grant the protection agent full disk access. To do so, go to Applications >Utilities, and then run Cyber Protect Agent Assistant. Then, follow the instructions in the application window.

To uninstall Agent for Mac

Run the following command:

  • sudo /Library/Application\ Support/BackupClient/Acronis/Cyber\ Protect\ Agent\ Uninstall.app/Contents/MacOS/AgentUninstall /confirm

To remove all logs, tasks and configuration settings during the uninstallation, run the following command:

  • sudo /Library/Application\ Support/BackupClient/Acronis/Cyber\ Protect\ Agent\ Uninstall.app/Contents/MacOS/AgentUninstall /confirm /purge

    • Related Articles

    • SentinelOne - Installing the macOS Agent

      Installing the macOS Agent Make sure you have all the requirements before you start the installation. To install the macOS Agent Get the Site or Group Token Install the Agent using the command line or the Installation Wizard. Authorize Full Disk ...

    • Installing protection agents in macOS

      Agent for Mac This agent includes a component for Antivirus & Antimalware protection and URL Filtering. See Supported Cyber Protect features by operating system for details about supported functionality by operating system. Both x64 and ARM ...

    • Preventing unauthorized uninstallation or modification of agents

      You can protect Agent for Windows against unauthorized uninstallation or modification, by enabling the Password protection setting in a protection plan. This setting is available only when the Self-protection setting is enabled. To enable Password ...

    • HarfangLab EDR Installation

      Non-interactive installation To perform the non-interactive installation: Download the Agent msi file on the desired system. Launch Powershell as an Administrator and traverse to the Directory where the Agent msi file is place on the system. Copy the ...

    • Acronis DLP agent installation

      After Downloading the agent, follow the below steps: Step one: Select customize installation Step two: Click on change in the What to install section Step three: Select Agent for Data Loss Prevention click on done. Step four: Click on change in the ...