We are here to help!

Find new ways to use Atera, Ask us anything.

Follow

Install an agent on a Windows OS device

The Atera agent monitors the availability, performance and health of your computers\servers, and is the backbone of Atera. It enables Atera to alert you when a critical system or resource is down, degraded, or has reached a predefined threshold parameter, and gives you the ability to view, access, and fix the problem. The Atera agent for Windows OS is a .MSI file, and should be installed on all computer/servers you wish to monitor. This article explains how to:

 

 

For download/installation instructions on Mac OS devices, see these instructions.

 

 

Download the Agent

 

The following are instructions for downloading the agent.

 

To download an agent:

 

1. Click the Install agent button at the top right of the screen.

 

 

Install_agent_button.JPG

 


The Install Agent screen appears.

 

 

2. Complete the 3-step installation process:

 

a) Select either Windows or Mac OS, then click Next.

 

1select_os.jpg

 

 

b) If you selected Windows OS in the previous step, you can download either an 'Unassigned' agent, or one specific to the customer (which auto assigns devices to the customer). For Mac OS, only a generic, 'Unassigned' agent is available (you'll need to assign devices manually, at a later time). After making your selection, click Next.

 

2_assign_agent.jpg

 

 

c) Click the Download and Install button. The agent is downloaded to the computer. Run it to complete the installation.

 

3_install.jpg

 

Alternatively, you can install the agent via the Command Prompt, by copying the command provided. You can also copy and share the agent installation link with your customer and have them install it themselves.

 

 

Note: You can also download the Atera agent from within the customer's page. To download:

1. From Customers (on the side panel), click the specific customer.

2. Click the Devices tab, from within the customer's page.

 

mceclip0.jpg

 

3. From the Actions dropdown menu, click Agent Installer (Customized) > Step 1: Check to select either Windows or Mac OS, and click Next > Step 2: Click Download and install.  An agent installer, specific to the customer, downloads (meaning devices with this agent installed will automatically be assigned to the customer).

 

2_install.jpg

 

Alternatively, you can install the agent via the Command Prompt, by copying the command provided. You can also copy and share the agent installation link with your customer and have them install it themselves.

 

See 'Install the agent' (below) for instructions on installing the downloaded agent.

 

 

Install the Agent

 

Once the agent is downloaded, you can install it in one of three ways:

 

 

 

Single Agent Installation

The most basic installation, used to install an agent on a single customer device, in a non-domain environment.

 

To install via single agent installation: Simply double click on the downloaded agent, and follow the installation prompts to install the agent.

 

 

 

Multiple Agent Installation (Using Group Policy):

 

Used to automatically install agents on multiple customer devices in a domain environment, and on any device logging into the domain that doesn’t already have the agent.

 

To install using Group Policy:

1. Save the Atera agent .msi file in the SYSVOL folder.

2. In the domain controller, open the Group Policy Management and edit the Default Domain Policy.  

mceclip0__1_.jpg

 

3. Under Computer Configuration, click on Policies.

 

mceclip1.jpg

 

4. Click on Software Settings >Software Installation.

 

mceclip2.jpg

 

5. Click on New, then Package...

 

 

mceclip3.jpg
 

5. Choose the Setup file and click Open.

 

mceclip4.jpg

 

6. Right click on the new package, and click Properties.

 

mceclip5.jpg

 

7. Click the Deployment tab to verify the deployment type is set to 'Assigned'. That's it. The Atera agent will automatically be installed on all computers in your network.

 

mceclip6.jpg

 

 

Troubleshooting Group Policy Installation:

 

- An internet connection is required for agent installation.

To enable: Go to Computer Configuration > Administrative Templates > System > Logon > Always wait for the network at computer startup and logon – Enabled

Note: This can significantly slow down off-domain logins for laptops and wireless clients.

 

- If the device is slow (e.g., old hardware, bad network) you might need to extend the timeout:

To extend: Go to Computer Configuration > Policies > Administrative Templates > System > Group Policy -> Specify startup policy processing wait time - Set timeout (in seconds)

 

- Language discrepancies can cause installation failure. To work around this, it is necessary to remove the language check:

To remove the language check: Go to Computer Configuration > Policies > Software Installation > Right Click AteraGPO > Properties >  Deployment > Advanced > Ignore language when deploying this package - Enabled

 

- Previously installed agent: Sometimes, the installation will fail if an agent was previously installed through a different account. One of the following two registry keys might be the cause:

HKEY_CLASSES_ROOT\Installer\Products\4758948C95C1B194AB15204D95B42292

HKEY_CLASSES_ROOT\Installer\Products\10F15BFE50893924BB61F671FEC4DE2F

 

 

Note: After any of the above settings are applied, be sure to run gpupdate /force in order to force the GPO to update. Then reboot, and wait for the policy to enforce.

 

 

 

Installation Via Command Prompt

 

This is an alternative way to install the agent. To install an agent via the command prompt, see these instructions.

 

 

 

Share the Agent Installer Link  

As an alternative to downloading and installing the agent for your customer, you can share the agent installer link with them, to download and install on their own.

 

To share the agent installer link:

 

 1. Click the Install agent button at the top right of the screen.

 

Install_agent_button.JPG

 

 

The Install agent screen appears.

 

 

2. Complete the 3-step installation process:

a) Select either Windows or Mac OS, and click Next.

 

1select_os.jpg

 

 

b) If you selected Windows OS in the previous step, you can download either an 'Unassigned' agent, or one specific to the customer (which auto assigns devices to the customer). For Mac OS, only a generic, 'Unassigned' agent is available (you'll need to assign devices manually, at a later time). After making your selection, click Next.

 

2_assign_agent.jpg

 

 

c) Copy the agent installation link by clicking the  copy_clipboard_icon.JPGicon next to the link  (under Share the link), then share with your customer. 

 

3_install.jpg

 

 

 

Note: You can also copy the agent installer link from within the customer's page (To copy: Click Customers (on the side panel) > click the specific customer > click the Devices tab > From the Actions dropdown menu, click Agent Installer (customized). The same Install agent screen appears. 

 

 

 

 

Was this article helpful?
5 out of 17 found this helpful
Have more questions? Submit a request