Install the Atlas Experience Agent

The Experience Agent installation has been scripted to simplify installation with particular consideration given to installing the Agent on-premesis with the limited access to the PC.

This document steps through installing Agents via the Experience Manager.

WARNING

The installation process is a work in progress and subject to change. Steps in this document may be inconsistent with actual use at times and between version.

Instructions

The Experience Agent may be installed via the Atlas Web Console. Begin by logging into the Experience Manager and selecting Nodes (path: /clusters/nodes/provision/).

Select + Add Node for the Guided Installation page:

Agent Installation

The Atlas Agent is installed via Powershell or Bash scripts that both download, install and schedule the Agent requiring only one command for the Agent to run.

Windows amd64/x64 (Powershell)

To install the Experience Agent on the Windows 10+, open Powershell as an Administrator.

WARNING

Powershell requires Administrator privileges to install the Agent, if run with standard User privileges, installation will fail.

Run the following, obtaining the TOTP token from the Guided Installation page above.

This utilizes irm to download the file and iex to immediately run the downloaded script.

irm https://xm.upswell.cloud/get/agent/win64/[totp token]/ | iex

Linux amd64/x64 (Bash)

To install the Experience Agent on Linux (currently only Debian variants), open a Terminal and run the following, obtaining the TOTP token from the Guided Installation page above.

This utilizes curl in a one-liner to download the installer and execute it immediately. If you receieve a curl error, install curl with sudo apt install curl.

bash <(curl -fsSL https://xm.upswell.cloud/get/agent/deb64/[totp token]/)

WARNING

The Linux installer currently only downloads and installs the Agent, it is not currently scheduled via sysctl and will not autorun.

macOS ARM (Bash)

WARNING

The Experience Agent has been tested throughly and runs on macOS ARM devices, but is not currently built during the release process. If you have macOS installation requirements, contact Upswell to discuss your deployment requirements.

Configure the Environment

The atlas or atlas.exe executables should be placed on the Node’s PATH so that they are accessible from any folder within Bash or Powershell.

Before running the Experience Agent, the environment needs to be configured using the config command. Open Bash or Powershell (depending on the OS you are running) a

.\atlas config --host https://<tenant>.atlasss.app --alias gallery-station-01

This will set the host environment file, indicating which host the Experience Agent connects to when it starts. It will also confirm that the id_rsa and id_rsa.pub files exist in the ~/.ssh/ folder, and if they don't it will attempt to create a new RSA keypair.

Run the Agent

Once the Agent is configured you are ready to run the Agent and start the automated registration and provisioning process:

.\atlas run

TIP

For Windows installations, you will find a Desktop shortcut labeled Run Me that will launch the Agent.

Next Steps

Once an Agent is installed, it will need to be configured via the Experience Manager. See Node Managenent to complete Node setup.