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. Install the 64 bit-agent. For example:

        sudo pkg -o AGENTUSER={username} add -f opsramp-agent{version}_freebsd12-amd64.txz
        
  9. 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.

    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.