Manually Upgrading Your Automox Agent

How to manually upgrade your Automox Agent if the Auto-Upgrade fails.

This guide provides step-by-step instructions to upgrade the Automox Agent on Windows devices, either using a worklet or manually for single devices.

Prerequisites

Before beginning, ensure:

• You have administrator access to the Automox console and target devices.
• The target devices meet the latest agent version requirements.
• You can access the Automox Agent Installation Overview for MSI download links and $accessKey information.

Using a Worklet to Upgrade Multiple Devices

1. Access the Automox Console:
   • Navigate to console.automox.com and log in.
2. Download the Latest Automox Agent MSI
   • Navigate to the Add Devices section under the console.
   • Download the latest installer MSI and note the agent version (e.g., 1.48.48).
3. Locate the Worklet:
   • Click on the Manage tab and select Worklet Catalog.
   • Search for Install Latest Agent on Systems with Old Agents.
4. Create a Policy:
   • Click Create Policy, name the policy, and assign it to appropriate device groups.
   • Upload the downloaded Automox Agent MSI to the Payload section of the Worklet.
5. Update the Variables in the Worklet

• Modify the evaluation and remediation codes with the following:
  • $agentVer: Set to the version of the uploaded installer file.
  • $installMSI: Set to the name of the uploaded MSI file.
  • $accessKey: Set to your organization’s access key, available in the “Add Devices” dialog.

$agentVer = "1.48.48" 

$installMSI = "Automox_Installer-1.48.48.msi" 

$accessKey = 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'

6. Optional: Schedule the Upgrade:
   • Configure a schedule for the policy if desired.
7. Run the Policy:
   • Save the policy and allow it to execute across the selected devices.

Manually Upgrading a Single Device

1. Remove the Existing Agent:
   • Log in to the console and select the device that is stuck.
   • Click Action > Remove.
2. Reinstall the Agent:
   • Follow the installation instructions in the Automox Agent Installation Overview.
   • Use the downloaded MSI or the available commands to install the agent.

Verification and Troubleshooting

• After upgrading, verify the agent version in the console.
• If the upgrade fails, check the local agent logs or restart the agent service:
  • Windows:

net stop amagent && net start amagent

• • Linux:

sudo service amagent restart

• • macOS:

sudo launchctl kickstart -k system/com.automox.agent