Install a Non-root Custom User Agent

To install the agent as a custom user with non-root privilege, create a new user and group before installing the agent:

1. Create a new user group:

       pw groupadd {username}
       

2. Create a custom user:

       pw useradd -n {username} -c "OpsRampAgent User" -g {username} -d /opt/opsramp -m -s /bin/sh
       

3. Set the user password:

       echo {password} | pw usermod {username} -h 0
       

4. From All Clients choose a client.

5. Go to Setup > Download > Agent.

6. In the FreeBSD tile, choose the operating system version.

7. Download and save the agent installer.

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

9. Install the 64 bit-agent. For example:

       sudo pkg -o AGENTUSER={username} add -f opsramp-agent{version}_freebsd12-amd64.txz
       

10. To start the agent with the authentication tokens generated for your organization, click Instructions in the FreeBSD tile and copy the authentication tokens for the features you want to install.

    You can choose to enable all features or specific features.

    The authentication token -K and -S argument values are populated for your organization. Copy-and-paste the values into the command line and run the command for the features you want:

    You can choose to enable all features or specific features.

    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:Automation,agent:RemoteConsole"
      

You can view the installation logs in the /tmp/opsramp-agent_install.log file.