Install the Panopta Agent

Install an Agent on a new server

You can install the Agent on a server and it will automatically be added to your Panopta account. This is a helpful option for installing the Agent on a number of servers at once to import into Panopta. To install the Agent to a Windows or Linux server, perform the following steps:

From the main navigation header, click Add.
Select Linux or Windows.
Select either Quick Install Instructions or Manual Install Instructions.
Selecting Quick Install Instructions will generate a command that you can run manually on each of your servers or through your configuration management tool, like Chef or Puppet.
Follow the on-screen instructions.

Script reusability

This script is generic for your account - you can use it on any new server you'd like to add to Panopta and it will obtain its own distinct key during the installation process.

Python

Python is required on all Linux Agent installations for the script to work properly.

This command will install the Agent, obtain a server key, add the server to Panopta, and begin reporting metrics.

Install the Agent on a server already in Panopta

On the Instance Details page, select Install Agent to install the Panopta Agent.

Clicking Install Agent will give you a few prompts. The first being to select the OS of the server on which you are installing the Agent.

After selecting the OS, you have the option to either do a Quick Install or a Manual Install. The Quick Install tab provides a quick script for you to run which will download the Agent from our repository and link the Agent to your account. It will start reporting metrics in minutes, which you will be able to see in the control panel. Selecting the Manual Install tab will provide several commands that you must run individually to download and install the Agent to your server.

This version of the script has a unique key for this one instance only! Do not use the same script to try to install other Agents. A key is generated for each server.

Installer parameters

Linux

The following parameters can be appended to the standalone installer command if you selected Linux:

Parameter	Type	Description
customer_key		Required To obtain your customer key, select your avatar then select My Account.
server_group	Int	Assign the instance to one or more instance groups.
templates	Int	Applies the defined template or templates to the instance.
tags	Comma-separated value, string	Applies the defined tags to the instance
disable-server-match		Disable server matching. This will prevent instances from getting merged when using the Agent one-liner installer for multiple servers. For example: `curl -s https://packages.panopta.com/install/agent_install.sh \| bash /dev/stdin xxxx-xxxx-8gs8-gehw --disable-server-match`

For example, enter the following command:

The parameters and values will be inserted into the manifest file and subsequently be applied to the instance.

Windows

The following parameters can be appended to the standalone installer command if you selected the MSI installer option:

Parameter	Type	Description
customer_key		Required To obtain your customer key, select your avatar then select My Account.
server_group	Int	Assign the instance to one or more instance groups.
templates	Int	Applies the defined template or templates to the instance.
tags	Comma-separated value, string	Applies the defined tags to the instance
		Disable server matching. This will prevent instances from getting merged when using the Agent one-liner installer for multiple servers. A `true\|false` argument is needed after the `-disable_server_match` flag. For example: `Invoke-WebRequest https://packages.panopta.com/install/panopta_agent_windows.ps1 -OutFile panopta_agent_windows.ps1; .\panopta_agent_windows.ps1 -customer_key xxxx-xxxx-8gs8-gehw -countermeasures -disable_server_match = true`