We are here to help!

Find new ways to use Atera, Ask us anything.

Follow

Install an Agent on Windows

The January release updates the Atera Agent installation process and adds some automatic fixes and diagnostic tools.

To install an Atera Agent follow the steps below:

1. From the main Dashboard click the + dropdown menu
2. Then click Agent Installer > Download
 
3. Open and run the Agent Installer package

4. Select the Deployment Method

Click Edit next to Customer Name to allocate the Agent to the correct Customer before installation begins. You will be prompted for your Atera Username and Password.

Note: If you do not click on Edit to choose Customer Name, the Agent will be assigned to the undefined Customer. This applies to both Single Agent Installation and Multiple Agents Installation.

 

5. Click Install
The Installing Agent... progress bar displays.
After the installation completes the Analyzing Agent Installation Status information displays.

Agent Installation Status provides a step by step view of the install and alerts you to any issues the installer encountered.

  • Connectivity Tests
  • Download from Repository Test
  • Identity Validation Tests
  • General System Checks

If an installation failed the step will be identified with an exclamation mark (!) and a button will be available on the right hand side to help resolve the issue.

Note: When installed an agent leaves an identity in the registry. In the scenario where an Atera agent has been installed previously you will need to click Fix Identity to resolve this issue automatically (previously it was necessary to delete the registry key).  

To see a full diagnostic log and recommendations you can click the Open Logs hyperlink.

A new browser tab displays with log information on possible issues:

Access to Atera Reporting:

Failed to get the expected result from Atera's store. This might be due to firewall/proxy settings on your machine"


Diagnostics from Atera's Backend: 

Failed to get the expected result from Atera's backend. This might be due to firewall/proxy settings on your machine.


Identity Issue found: Agent Installed Twice on Same Machine:

Current Atera Agent Name is: {resultObject.AgentNameInDB}. New Agent Name in machine selected for install is: {Environment.MachineName}", to resolve click Close and abort installation.

Identity Issue found: Cloned Machine:

This Agent has existed in your account since {creationTime.ToLocalTime()}, this could be a cloned machine". To resolve click Fix Identity.

Identity Issue found: Agent Exists in Another Account: 

You may have previously registered an Atera account with another email address", to resolve click Fix Identity.

PubSub Connectivity Issues:

Please make sure you have a valid connection to <a href=\"https://pubsub.atera.com\">[https://pubsub.atera.com%3c/a]https://pubsub.atera.com</a>. Connection failure may be due to firewall/proxy settings on your machine.

Access to Package Store - Failed to download packages from Atera's package store:

This might be due to firewall/proxy settings on your machine.

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