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

Networking Prerequisites

The following set of URLs need to be accessible from the AuGR Agent installation location.

Example Wildcard

*.n5o.blue
*.augr.aunsight.com

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

Note

These are all examples for *augr.aunsight.com. Your actual hostname may differ.

Protocols

Protocol	Port
HTTPS	443
WSS	443

Step 1: Download the Agent Installer

Note

AuGR Agent Management is only available for Windows so it will only be available for download on the Windows tab.

1. Login to the desired tenant in the Aunsight Golden Record platform and navigate to Agents screen to download the AuGR Agent Installer.

2. 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.
   

3. The agent installer will download locally.

4. 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

1. Double click on the now unblocked downloaded AugrAgentInstall.msi file to begin the installation process. Click Next.

   

2. Click Install.

   

3. Installation will begin.

   

4. Check the box next to Launch Aunalytics Golden Record Agent Management & click Finish.

   

5. Once installed, the Aunsight Agent Management application can be found in the available applications.

Step 3: Add Agents

1. Log into Aunsight Golden Record.

2. Click the + on the Agents screen to create new agent.

3. Enter the agent name in the Display Name box and click Create Windows Agent.

4. 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.

5. Open the Aunsight Golden Record Agent Management application.

6. Click Add/Update Agent(s) button.

7. In the Add/Update Agents screen, paste the key (token) from AuGR that was copied in step 4 and click Validate

   Note

   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.

8. 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.

   Note

   If an error indicating key (token) was invalid, click Cancel and Return to Token Entry button to reenter the correct key (token).

9. 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.

10. 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.

11. Agent installation is complete. The AuGR Agent Management Application can be closed. Agents will run based on their control status.

Manage Agents

Now that the Agents are installed and running, the Aunsight Golden Record Agent Management Application can be used to manage agents.

Stopping 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.

Re-Authenticating Agents

1. Stop the agent you would like to re-authenticate in the AuGR Agent Management Application and AuGR web UI.

2. In the AuGR Agent Management Application use the “Add/Update Agent(s)” command.

3. In the AuGR web UI click the Re-Authenticate the Agent button or the Generate New Key button (whichever appears) to generate a new key

4. Copy the new key using the copy button.

5. Paste the agent key from the AuGR web UI into the AuGR Agent Management Application.

6. The AuGR Agent Management Application will then confirm the new key, process for a moment, and then connect the agent. Users will see the agent successfully connected in the AuGR web UI.

Restarting Agents

Use the Start button in the Control column to start 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.

Removing Agents

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.