Installation

First you need to set up or pick a server that is going to have the remote agent. To create a new server, go to Panopta, and under the Servers tab, click "Create Server" and a creation dialog will open. Select "Local Panopta Agent" and finish creating your server as you normally would.

Next, you'll need to download the Panopta Agent from the following link: http://www.panopta.com/downloads/. Be sure to select the correct operating system and architecture for your server, then follow the instructions below corresponding to the version you downloaded.

LINUX (Debian, Ubuntu)

1. If you have an existing agent installed, remove it with "dpkg -r panopta-agent"
2. As root, run "dpkg -i panopta-agent_x.x.x-xx_all.deb"
3. Agree to install
4. Wait a minute for your remote agent to automatically sync with the central Panopta infrastructure.
5. Return to the Panopta.com "Servers" page.
6. If you haven't added the server for which you just installed the agent, click "Create Server" at the top of the page to add a new server. On the first input of the "Add Server" popup, enter your server's FQDN or IP address. The Panopta Agent running on your server will be able to sync itself automatically with the server created in the controlpanel using this value.
7. Once you have finished adding a new server (or selecting your existing server) take a look at the server overview page. You may now begin to add resources to monitor by clicking "Add Agent Resource" under the "Server Resource Configuration" section.
8. Continue adding Agent Resources until you're scheduled to monitor everything about that server you wish to check.As root, run "dpkg -i panopta-agent_x.x.x-xx_all.deb"

LINUX (Redhat, CentOS)

1. If you have an existing agent installed, remove it with "yum remove panopta-agent". If you have any trouble with this, try "rpm -e --noscripts panopta-agent"
2. As root, run "yum install panopta-agent-x.x.x-xx.xxxx.rpm --nogpgcheck"
3. Agree to install
4. Wait a minute for your remote agent to automatically sync with the central Panopta infrastructure.
5. Return to the Panopta.com "Servers" page.
6. If you haven't added the server for which you just installed the agent, click "Create Server" at the top of the page to add a new server. On the first input of the "Add Server" popup, enter your server's FQDN or IP address. The Panopta Agent running on your server will be able to sync itself automatically with the server created in the controlpanel using this value.
7. Once you have finished adding a new server (or selecting your existing server) take a look at the server overview page. You may now begin to add resources to monitor by clicking "Add Agent Resource" under the "Server Resource Configuration" section.
8. Continue adding Agent Resources until you're scheduled to monitor everything about that server you wish to check.

Windows

1. Download the agent from the downloads page onto your server
2. Double click on the MSI installer. Accept all the defaults for installation unless you would like to customize the install location
3. After the install completes, go to the C:Program FilesPanoptaAgent in Windows Explorer (Note: It may be called Program Files (x86) on some systems)
4. Double click on the agent_setup.bat file. This script will execute some commands to initialize the agent and add it to your scheduled tasks.
5. Enter the servery key from the Panopta control panel when asked
6. Enter the Administrator password when asked to authorize adding the task to scheduled tasks.
7. That's it! The Agent should now run in the background and report back to the central system with the metrics its collecting. You can find logs for both the synchronization process and the data collection process in C:PanoptaAgent

Troubleshooting

Q. How do I know the agent on my server synced correctly with the server reference in the Panopta control panel?

A. If you select your server reference in the Panopta control panel and look at the "Server Configuration" box in the upper left, you should see a field and value for "Agent Version" if your server was able to correctly sync. This field will not exist for servers that could not sync.

Q. My server won't sync with the server reference in the Panopta control panel.

A. It's possible that the agent was unable to locate your server reference on Panopta. Fortunately, there's a quick fix. In the Panopta control panel, select your server so that you can see the server overview. Under the "Server Configuration" box in the upper left, find the field "Server Key" and copy this value. Now go onto your server where you installed the agent and edit the file "/etc/panopta-agent.cfg" In this file, there will be a line that starts with "server_key". Make sure the entire line reads "server_key = theserverkeyyoucopied". This will give the Panopta Agent a explicit handle to the server reference in the Panopta control panel.

Q. I'm using yum/rpm and I'm unable to uninstall the agent.

A. First, make sure when you're removing the agent, you're specifying it by its package name, "panopta-agent", and not the name of the package file, "panopta-agent-x.x.x-xx.xxxx.rpm". If this doesn't work, and your packaging system claims that the agent is still installed, it's possible that the agent files have been uninstalled, but that it was unable to communicate this to the packaging system. Try removing it from rpm with "rpm -e --noscripts panopta-agent".

Q. I'm using yum/rpm and I'm unable to install the agent. My packaging system complains about the gpg signing key.

A. Due to a bug rpm/yum bug in certain versions, sometimes the packaging system fails when validating the signing key. To get around this, run the install with the option "--nogpgcheck".

If you have any other questions on the Agent installation or usage, please contact us at support@panopta.com and we'll be happy to help you solve them.