Deploying Agents on FreeBSD

Introduction

The FreeBSD agent has the following features, which can be selectively enabled:

• Automation: Runbook automation, remote script execution, and custom script monitoring
• RemoteCommand: Remote command execution
• RemoteConsole: Remote device access

By default, all features are enabled.

The agent download file name format is opsramp-agent-{version}.{osType}.{packageType} where

• version: OpsRamp version
• osType: 32-bit or 64-bit
• packageType: Installation package format

For example, opsramp-agent-9.0.0-1_freebsd10-amd64.txz

After the agent is installed, the agent automatically begins sending telemetry to OspRamp.

Prerequisites

• Processor: 1 GHz CPU or greater
• Memory: 2 GB RAM
• Disk Space: 200 MB

For x64-bit, the agent supports for the following operating system versions:

• FreeBSD 10.x
• FreeBSD 11.x
• FreeBSD 12.x

Download and install a root user agent

1. From All Clients choose a client.
2. In the Dashboard menu, navigate to Setup > Download > Agent.
3. In the FreeBSD tile, select the operating system version from drop-down list.
4. Follow the dialog to download and save the agent installer. Note: Agent installation with a non-root user is not supported.
5. Install the agent: For example: 64 bit

       pkg add opsramp-agent-{version}_freebsd10-amd64.txz
       

6. Start the agent with the authentication tokens generated for your organization, enabling the features that you want.
   • Click Instructions in the FreeBSD tile to get the authentication tokens. The -K and -S argument values in the instructions are populated for your organization.
   • Copy-and-paste the values into the command line.
   • Enable all features using the following:

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

   • Enable specific features:

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

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

Uninstall the agent

To uninstall the agent, delete the agent and the /opsramp/agent directory:

pkg delete opsramp-agent
rmdir /opt/opsramp/agent

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

Limitations

The following are limitations and unsupported agent features on a FreeBSD operation system:

• Monitors
• Remote commands
• Patching

Monitors

Remote commands

Patching