Install a Root User Agent

The examples used in these instructions show how to install the agent using RPM package management. Follow the same steps to install the agent on other Linux platforms using the appropriate package manager, such as the dpkg Debian package manager.

1. From All Clients choose a client.

2. Go to Setup > Download > Agent.

3. In the Amazon Linux tile or the tile for your Linux platform, choose 32-bit or 64-bit for your operating system.

4. Follow the dialog to download and save the agent installer.

5. Make sure that you verify the SHA-256 checksum of the downloaded file.

6. Install the agent:

   32 bit

       sudo rpm -i opsramp-agent_{version}_i386.rpm
       

   64 bit

       sudo rpm -i opsramp-agent_{version}_x86_64.rpm
       

7. Start the agent with the authentication tokens generated for your organization, enabling the features you want.

   Click Instructions in the Amazon Linux tile to get the authentication tokens. The -K and -S argument values in the instructions are populated for your organization. The -M true argument is optional and enabling it enables auto-monitoring. Copy-and-paste the values into the command line.

   Note

   Only the values copied from this page are valid and should be used in the following steps. Any other values will cause agent misbehavior.
   • Enable all features:

       sudo /opt/opsramp/agent/bin/configure -K {accessKey} -S {securityKey} -s client-name.api.opsramp.com -M true
       

   • Enable specific features:

       sudo /opt/opsramp/agent/bin/configure -K {accessKey} -S {securityKey} -s client-name.api.opsramp.com -M true -f "agent:RemoteCommand,agent:PatchManagement,agent:Automation,agent:RemoteConsole"
       

See the /tmp/opsramp-agent_install.log file for installation progress.