macOS Obkio Agent Installation Guide (Beta Testing)

    What you are going to learn:

  • How to install the Obkio Monitoring Agent on macOS

The macOS Software Agents are agents installed on Mac Computers. They differ from Public, Virtual Appliance and Hardware agents because the user must maintain the OS and its security.

Minimum Requirements
Minimum Requirements

The minimum requirements for the macOS Software Agent are:

  • CPU: 2 CPU cores
  • Memory: 4 GB
  • Disk: 20 GB

Supported macOS Versions
Supported macOS Versions

The macOS Software Agent is supported on the following macOS Versions:

  • macOS Monterey (12)
  • macOS Big Sur (11)
  • macOS Catalina (10.15)

Supported Architecture
Supported Architecture

The supported CPU architecture for the Linux Monitoring Agent are:

  • Apple Silicon (M1 - aarch64) through Rosetta 2
  • Intel 64-bits

Installation Instructions
Installation Instructions

Download macOS Obkio Agent Installation Wizard

  1. Inside the App, create a new Software Agent. In the Installation Instructions window, select Windows 10 and write down the Agent ID. A macOS tab will be added to the App after Beta testing.
  2. Download and execute the Installation Wizard (link above).
  3. Open a Terminal and execute the command (replace AGENT_ID with the ID found in step #1):
sudo /Library/ObkioAgent/ObkioAgentService -setagentid AGENT_ID

That's it. Once installed, the agent will start and will update itself automatically when needed.

Firewall Settings
Firewall Settings

As for all other agent types, some firewall configurations might be required if outbound connections are filtered. Refer to the article Firewall Configurations for more details.

Uninstall
Uninstall

Open a Terminal and execute the following command:

sudo /Library/ObkioAgent/uninstall

macOS Agent Limitations
macOS Agent Limitations

The macOS Obkio Agent does not support:

  • TOS and DSCP Settings
  • APM Web Features