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 administrative 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:

  1. From the Devices page, click Add Devices.
    In the Get Started dialog window, you can see your organization key or unique access 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 (unique user) key. Your organization key can be found in the Get Started 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

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. 

  • -GroupName "My Group Name" 
  • -ParentGroupName "My Parent Group Name"

Group names are both optional and only required if you want your device to initially join a group that is not the Default Group. You only need to specify a Parent Group if your target group is under a parent that is not the Default Group.

Example 1: Deploy the Automox agent to your organization inside the Group "My Group Name" which belongs to a parent "My Parent Group Name"

Install-AxAgentMsi.ps1 -AccessKey xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -GroupName "My Group Name" -ParentGroupName "My Parent Group Name"

Example 2: Deploy the Automox agent for your organization inside the default group.

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\AutomoxInstallandLaunch.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.
    The Get Started dialog window appears, where you can see your organization key or unique access key. You will need this key for the script.
  2. Choose Linux from the drop-down list.
  3. 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 code 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 Get Started 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 following Ansible playbook: get-automox.yml.

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. Download the Windows PowerShell script by clicking Install-AxAgentMsi.ps1 and attach (upload) the file to the command.
  6. Click the save command 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.
  7. 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.



Did this answer your question?