Installation on macOS Endpoints

In this section:

• Before You Begin
• Step 1. Download the Action1 Agent Installer
• Step 2. Install the Agents
• Examining Installation Logs

Before You Begin

First, make sure that the endpoints you plan to manage with Action1 meet the requirements listed in this section.

The agent is always installed under the administrative account (root). It resides in /usr/local/action1 directory and operates as a daemon.

The next sections explain how you can install Action1 agent on a local or remote machine.

Step 1. Download the Action1 Agent Installer

1. In Action1 console, click Install Agents in the top-right corner to open the Getting started wizard.
2. On the Install Agent step, either click Download .SH to run the installer locally, or click Other Options if you plan to install the agent on another machine or run an unattended installation.

Step 2. Install the Agents

Use one of the following scenarios:

• Interactive installation
• Unattended installation
• Direct download for deployment using MDM tools

Scenario 1: Interactive installation

This option is recommended for first-time users.

1. In the Getting Started wizard, click Download.SH to obtain the script for automated agent installation.
2. On the local macOS machine, run the Terminal app as root.
3. Locate the downloaded script named action1_agent_YourOrganizationName.sh.
4. Copy the script name with the extension.
5. Go to the Terminal window and run the following command, providing the script name: bash {script_name}

The script will automatically download and start the Action1 agent setup. Follow the Agent setup wizard as described below.

Agent Setup Wizard

1. Accept the EULA.
2. When prompted for destination and type, select Install for all users of this computer.

3. Don’t change the installation destination – it must be /usr/local/action1.
4. When prompted, enter the administrative credentials.

5. Wait for the installation to complete. Then you can remove the PKG file.

Scenario 2: Unattended installation

This option is recommended for advanced users who want to install the Action1 agent on a local or remote endpoint in unattended (silent) mode.

1. In the Getting Started wizard, click Other Options.
2. Copy the corresponding script and run it on your target endpoints as root.

The following line will be copied:
p=(pwd) && curl -o "{p}/action1_agent(your_Action1_Org).pkg" "https://app.<region>.action1.com/agent/<id>/Mac/agent(your_Action1_Org).pkg " && sudo installer -pkg "${p}/action1_agent(your_Action1_Org).pkg" -target /

Here:

• curl – cURL (Client for URL) utility for the file download.
• -o – a parameter that instructs cURL to save the downloaded PKG file with the same name as in the URL.
• region – the region where your Action1 account is registered (North America, Europe, or Australia).
• id – a unique ID associated with a downloadable agent setup for your organization.

3. Share the copied line with endpoint owners.
4. Instruct them to launch the shell script using the Terminal window. The script will automatically download the PKG file and start the Action1 agent setup.

5. Apply additional configuration after installation on the Apple Silicon devices to enable OS patching.

Scenario 3: Direct download for deployment tools

This option is recommended to those who need to download the agent installer (.PKG file) for use with MDM tools.

Copy the corresponding URL and use it with your deployment tool:

https://app.<region>.action1.com/agent/<id>/Mac/agent(your_Action1_Org).pkg

Here:

• region – the region where your Action1 account is registered (North America, Europe, or Australia).
• id – a unique ID associated with a downloadable agent setup for your organization.

Examining Installation Logs

Сheck out the logs to examine errors that might have occurred during the setup. The Action1 agent installation logs on macOS endpoints can be found at

• /tmp/action1_agent.log (pi.log in previous versions)
•  /tmp/action1_install.log (prei.log in previous versions)