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 input your access key as a shared secret to use in your Worklet.
Using a Worklet to Upgrade Multiple Devices
1. Access the Automox Console
- Navigate to console.automox.com and log in.
2. Create a Secret for your access key
- Go to your Settings and click on Secrets and Keys.
- In the Secrets Management section, click Add Secret.
- Give your secret a Name and Description (optional).
- Set the Value to your organization's agent Access Key.
3. Locate the Worklet
- Click on the Automate tab and select Worklet Catalog.
- Search for the appropriate OS Worklet:
- Click Create Policy.
5. Add the Secret Input to the Worklet
- On the Inputs section of the Worklet creation page, click Add Input.
- Set the Variable Name to "accessKey" if you are using the Windows worklet.
- If you are using the macOS and Linux worklets, the Variable Name will be "accesskey".
- Set the Select Organization Secret dropdown to pick the secret you created in the previous step.
6. Optional: Schedule the Upgrade
- Assign a device Group to the policy.
- 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 > Delete.
2. Reinstall the Agent:
- Follow the installation instructions in the Automox Agent Installation Overview.
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 bootout system/com.automox.agent
sudo launchctl bootstrap system /Library/LaunchDaemons/com.automox.agent.plist