Install AuGR Agent Management Application & AuGR Agents¶
The Aunsight Golden Record (AuGR) Agent Management Application allows easy AuGR agent installation and management. The AuGR Agent Management Application is used to install agents, so it is essential for it to be installed on the server the Agents will be installed and run on.
This page walks through:
- Recommended system and network requirements for AuGR agents
- Downloading the Aunsight Golden Record Agent Management Application Installer
- Installing the Aunsight Golden Record Agent Management Application
- Adding AuGR agents using the Aunsight Golden Record Agent Management Application
- Managing AuGR agents using the Aunsight Golden Record Agent Management Application
Recommended System Requirements¶
It is recommended that the system the Agents will be installed on be setup with the following:
- 6 Cores
- 32GB RAM
- 100GB Disk Space
- Windows Server 2012 or newer
The following set of URLs need to be accessible from the AuGR Agent installation location.
Example Explicit Hostnames¶
auth.n5o.blue chadburn.augr.aunsight.com go-between.augr.aunsight.com go-between-grpc.augr.aunsight.com logs.augr.aunsight.com metabase.augr.aunsight.com vault.augr.aunsight.com writeback.augr.aunsight.com
These are all examples for *augr.aunsight.com. Your actual hostname may differ.
Step 1: Download the Agent Installer¶
AuGR Agent Management is only available for Windows so it will only be available for download on the Windows tab.
- Login to the desired tenant in the Aunsight Golden Record platform and navigate to Agents screen to download the AuGR Agent Installer.
Click the Download button on the New Agent Windows tab OR click on the Download Agent Installer link after creating a new Agent in the Aunsight Golden Record Agent screen.
The agent installer will download locally.
- Unblock the file. From the Downloads folder, right click on the AugrAgentInstaller.msi file and go to Properties. On the General tab, check the Unblock checkbox to provide permission to install the application. Click Apply. Click OK.
Step 2: Install Aunsight Golden Record Agent Management Application¶
Double click on the now unblocked downloaded AugrAgentInstall.msi file to begin the installation process. Click Next.
Installation will begin.
Check the box next to Launch Aunalytics Golden Record Agent Management & click Finish.
Once installed, the Aunsight Agent Management application can be found in the available applications.
Step 3: Add Agents¶
- Log into Aunsight Golden Record.
Click the + on the Agents screen to create new agent.
Enter the agent name in the Display Name box and click Create Windows Agent.
Click Generate a New Key and click the Click to Copy icon next to the generated key to copy the key which will be used in step 7 below.
Open the Aunsight Golden Record Agent Management application.
Click Add/Update Agent(s) button.
In the Add/Update Agents screen, paste the key (token) from AuGR that was copied in step 4 and click Validate
Multiple keys (tokens) can be added at the same time. The keys (tokens) can be entered one per line or separated by commas as in the image below.
On the Validating Tokens screen, click on Confirm Validation and Install Agents.
Agents will be installed in the default directory: C:\Program Files\Aunalytics\Golden Record. Check the box next to Use alternate directory for new agents to specify a different location.
If an error indicating key (token) was invalid, click Cancel and Return to Token Entry button to reenter the correct key (token).
Once the agent installation process completes, the Install Agents window can be closed. The main installer screen will show all the agents that are running.
The agents will also appear Connected in the AuGR UI.
Click Test Network to confirm the network is running for the agents. This test will connect to all the web services used by the agents. A successful test denotes that all the Aunsight Golden Record services are working properly. Failures are generally resolved with updates to group polices or firewall settings.
Agent installation is complete. The AuGR Agent Management Application can be closed. Agents will run based on their control status.
Now that the Agents are installed and running, the Aunsight Golden Record Agent Management Application can be used to manage agents.
Use the Stop button in the Control column to stop the agents. The Status column will update to Stopped.
The agent will indicate it is Disconnected in the AuGR UI as well.
Use the Start button in the Control column to stop the agents. The Status column will update to Running when the agent restarts.
The agent will appear as Connected in the AuGR UI as well.
Agents can be removed by checking the checkbox next to the agent to remove then clicking Remove Selected Agent(s) button. Click OK on the confirmation prompt.
Removing agents will stop and disconnect the agent but will not remove the agent from AuGR UI.
Uninstalling the Aunsight Golden Record Agent Management Application¶
The Aunsight Golden Record Agent Management Application can be uninstalled. To uninstall, find the Aunsight Golden Record Agent Management application in Apps & Features in Settings and uninstall.
Agents will continue to run although the Aunsight Golden Record Agent Management Application is uninstalled. To manage agents without the Aunsight Golden Record Agent Management Application, use the command prompt window to stop and restart Agents.