Deploying the Automox Agent in Bulk

You can deploy the Automox agent to a large number of devices at the same time.

There are different methods available to do remote, bulk deployment of the agent using scripts for the various tools for each of the supported operating systems.

The following methods are described here:

  • OS Deployment Scripts

  • Deploying with Ansible

  • Deploying with JumpCloud

OS Deployment Scripts

You can use scripts to deploy to devices for each of the supported operating systems. Your organization key (unique access key) must be added to a specific section of the script before running the scripts.

Prerequisites

Administrative privileges required.

The deployment tool or target device must have administrator privileges in order to successfully deploy and install the Automox Agent.

‌Deploying on OS X / macOS

You can deploy the Automox Agent on a macOS operating system by using the original command that was required to download the agent installer.

Copying the Agent Installer Command

Follow these steps to copy the curl command:

From the Devices page, click Add Devices.

  1. In the Add Devices dialog window, you can see your unique access key, which is also referred to as your organization key. You will need this key for the script.

  2. Choose OS X from the drop-down menu.

  3. From the install options, click Run Command.

  4. Copy the curl command.

‌Editing the Run Command for macOS Bulk Deployment

‌To bulk deploy the agent on macOS, you must edit the installer command. Add the following code to the deployment command:

launchctl load /Library/LaunchDaemons/com.automox.agent.plist

Note:

You must replace "accesskey" in the following command with your organization key. Your organization (unique user) key can be found in the Add Devices dialog window.

curl -sS https://console.automox.com/downloadInstaller?accesskey=Your-Organization-Key-Here | sudo bash

launchctl load /Library/LaunchDaemons/com.automox.agent.plist

Deploying on Windows Using PowerShell

You can deploy the Automox agent using the following Windows PowerShell script. This performs an unattended, silent install of the Automox agent on Windows devices. This script performs the following actions:

  1. The script downloads the agent from Automox if it hasn’t already been downloaded.

  2. The script installs the agent on the device if it isn’t already installed.

  3. The script starts the Automox agent service if it is stopped.

‌Windows PowerShell Script

  1. To download the Windows PowerShell script, click Install-AxAgentMsi.ps1. ‌This script takes the following command line parameters ‌-AccessKey YOUR-ORGANIZATION-KEY-HERE This is a required parameter that associates the device with your Automox organization.

  2. Optionally, if you want your device to join a group at the time of installation, you need to specify a destination Group Name and a Parent Group Name. -GroupName "My Group Name" -ParentGroupName "My Parent Group Name" The basic form of this command is: Install-AxAgentMsi.ps1 -AccessKey xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -GroupName "My Group Name" -ParentGroupName "My Parent Group Name"

Note: Your destination group can either be under a "Parent Group" or under the "Default Group". A "ParentGroupName" parameter is required in both cases. If you do not specify a parent group, it ignores the group assignment.

See the code examples here:

‌Example 1: Deploy the Automox agent to your organization inside the group "Accounts Payable", which belongs to a parent group "Finance".

Install-AxAgentMsi.ps1 -AccessKey xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -GroupName "Accounts Payable" -ParentGroupName "Finance"

Example 2: Deploy the Automox agent for your organization inside the group "Accounts Payable", which does not belong to a parent group.

Install-AxAgentMsi.ps1 -AccessKey xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -GroupName "Accounts Payable" -ParentGroupName "Default Group"

‌Example 3: Deploy the Automox agent for your organization inside the default group. In this case, there is no group assignment.

Install-AxAgentMsi.ps1 -AccessKey xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Debugging the Installation Process

If you need to debug the installation process performed by this script, you can find logging information in the following file on the device:

$env:TEMP\Install-AxAgentMsi.log

‌Deploying on Linux

You can deploy the Automox agent on a Linux operating system by using the original command that was required to download the agent installer.

‌Copying the Agent Installer Command

‌Follow these steps to copy the curl command.

  1. From the Devices page, click Add Devices.

  2. In the Add Devices dialog window, you can see your unique access key, which is also referred to as your organization key. You will need this key for the script.

  3. Choose Linux from the drop-down list.

  4. Copy the curl command.

Editing the Curl Command for Linux Bulk Deployment

To bulk deploy the agent for Linux, you must edit the installer command. Add the following to the deployment command:

service amagent start

NOTE

You must replace “accesskey” in the following command with your organization (unique user) key. Your organization key can be found in Add Devices dialog window.

curl -sS https://console.automox.com/downloadInstaller?accesskey=Your-Organization-Key-Here | sudo bash service amagent start

Deploying with Ansible

You can distribute the Automox agent with Ansible using the Ansible playbook: get-automox.yml. Contact Automox Support for further assistance.

From the directory where the ‘get-automox.yml’ file is located, invoke the playbook with the following command, substituting your organization key as indicated:

ansible-playbook get-automox.yml --extra-vars "organization=YOUR-ORGANIZATION-KEY-HERE"

Deploying with JumpCloud

JumpCloud® is a cloud-based Directory-as-a-Service platform that provides authentication, authorization, and management of an organization’s employees and the systems and IP resources they need access to. The JumpCloud platform provides a Commands tab that lets you run commands across any number of devices. This makes it possible to quickly and easily automate tasks across a number of servers, launch those tasks based on a number of different types of events, and get full auditing of all command results.

Mac Version

  1. Navigate to the Commands tab of the JumpCloud console and click the + button to create a new command.

  2. Select Mac as the target operating system, provide a name for the command, and in the RUN AS: drop-down list, select root.

  3. Paste the deployment script as specified in Deploying on OS X / MacOS into the COMMAND: text field. Select the systems or tags that will receive the Automox agent, and then press save command to create the command on the JumpCloud platform.

  4. Click the Run Now button adjacent to the command you just created to execute the script on all the target devices.

  5. You will see the Exit Code (0 = success) when the command finishes running on each system. Click the details button to view the execution log.

  6. Finally, as the Automox agent registers itself with the Automox platform, you will be able to see the new devices on the Devices page of the Automox console.

‌Windows Version‌

  1. Navigate to the Commands tab of the JumpCloud console and click the + button to create a new command.

  2. Select Windows as the target operating system.

  3. Provide a name for the command and select the target devices that will receive the Automox agent.

  4. Select Windows PowerShell and copy and paste the script into the script box.

  5. Click the Save button and you will return to the command tab. Your command will show in the list of available commands that will be run. Click the Run Now button adjacent to the command that you just created to execute the script on all target devices.

  6. Finally, as the Automox agent registers itself with the Automox platform, you will be able to see the new devices on the Devices page of the Automox console.

Linux Version‌

  1. Navigate to the Commands tab of the JumpCloud console and click the + button to create a new command.

  2. Select Linux as the target operating system, provide a name for the command and in the RUN AS: drop-down list, select root.

  3. Paste the deployment script as specified in Deploying on Linux into the COMMAND: text field. Select the systems or tags that will receive the Automox agent, and then press save command to create the command on the JumpCloud platform.

  4. Click the Run Now button adjacent to the command you just created to execute the script on all the target devices.

  5. You will see the Exit Code (0 = success) when the command finishes running on each system. Click the details button to view the execution log.

  6. Finally, as the Automox agent registers itself with the Automox platform, you will be able to see the new devices on the Devices page of the Automox console.

Related Topics: