This guide describes how to install the OpsRamp Agent on FreeBSD 12.X.

  • Step 1: Install the Linux OS Integration
  • Step 2: Choose connection type and download the Agent for FreeBSD 12.X version:
  • Step 3: Install the Agent for:
    • Root User Agent
    • Default Non-root User Agent
    • Non-root Custom User Agent

Install the Linux OS Integration

Refer to Install Linux OS Integration document.

Download the Agent

Refer Download Linux Agent document.

Install the Agent

Tabbed Interface with Table
Root User Agent
Default Non-root User Agent
Non-root Custom User Agent
1. Install the Agent with 64 bit run the following command.
    sudo pkg add opsramp-agent-XX.X.X-X_freebsd12-amd64.txz
2. Start the Agent with the authentication tokens generated for your organization. See the Instructions page in OpsRamp portal to get your authentication tokens.
  • Enable all features
    •     sudo /opt/opsramp/agent/bin/configure -K {accessKey} -S {securityKey} -s client-name.api.opsramp.com -F {Integration ID} -L true
  • Specific features
    •     sudo /opt/opsramp/agent/bin/configure -K {accessKey} -S {securityKey} -s client-name.api.opsramp.com -F {Integration ID} -L true -f "agent:RemoteCommand,agent:PatchManagement,agent:Automation,agent:RemoteConsole"
3. The server appears on the OpsRamp Infrastructure page within a few seconds.

See the /tmp/opsramp-agent_install.log file for installation progress.
The default, non-root agent installation automatically creates the default user.
  1. Install the Agent with 64 bit run the following command.
        sudo pkg -o ISNONROOT=y add -f opsramp-agent-XX.X.X-X_freebsd12-amd64.txz
  2. Start the Agent with the authentication tokens generated for your organization. See the Instructions page in OpsRamp portal to get your authentication tokens.
    • Enable all features
      •     sudo /opt/opsramp/agent/bin/configure -K {accessKey} -S {securityKey} -s client-name.api.opsramp.com -F {Integration ID} -L true
    • Specific features
      •     sudo /opt/opsramp/agent/bin/configure -K {accessKey} -S {securityKey} -s client-name.api.opsramp.com -F {Integration ID} -L true -f "agent:RemoteCommand,agent:PatchManagement,agent:Automation,agent:RemoteConsole"
  3. The server appears on the OpsRamp Infrastructure page within a few seconds.

    See the /tmp/opsramp-agent_install.log file for installation progress.
To install the agent as a custom user with non-root privilege, create a new user group and custom user before installing the agent.
  1. Create a new user group:
        groupadd --system {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. Install the Agent with 64 bit run the following command.
        sudo pkg -o AGENTUSER=username add -f opsramp-agent-XX.X.X-X_freebsd12-amd64.txz
  5. Start the Agent with the authentication tokens generated for your organization. See the Instructions page in OpsRamp portal to get your authentication tokens.
    • Enable all features
      •     sudo /opt/opsramp/agent/bin/configure -K {accessKey} -S {securityKey} -s client-name.api.opsramp.com -F {Integration ID} -L true
    • Specific features
      •     sudo /opt/opsramp/agent/bin/configure -K {accessKey} -S {securityKey} -s client-name.api.opsramp.com -F {Integration ID} -L true -f "agent:RemoteCommand,agent:PatchManagement,agent:Automation,agent:RemoteConsole"
  6. The server appears on the OpsRamp Infrastructure page within a few seconds.

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

Uninstall the Agent

  1. To uninstall the agent run the following command:
    sudo pkg delete opsramp-agent
  2. Delete the folder:
    rmdir /opt/opsramp/agent

See the /tmp/opsramp-agent_uninstall.log file for uninstall progress.