Manual Installation—Mac Agent

To download and install the Agent you must have the appropriate N-sight RMM User account permissions. For information about Agents permissions, see Default system roles and their permissions.

Depending on the configuration of the computer it may need local administrator authorization.

1. On the All Devices view, go to Agent > Download Agent
2. Select the version of the Mac Agent to download

   

   The DMG file, which contains the required Mac Agent PKG, is downloaded to the workstation. Next, see 2. Install the Mac Agent on the workstation.

To optimize installation time and ensure Check and Automated Task consistency across devices, you can Configure default monitoring templates for installation.

1. On the workstation, go to the download directory (available in the Finder sidebar or the Dock)
2. Double-click the DMG to open (for example. OSX_AGENT_3_8_0.DMG)
3. Double-click Install to start the Mac Agent installation wizard that first checks to ensure the Agent can install
4. Click Continue to proceed through each section of the wizard
5. Choose to register the Agent now or after the installation

   Choice	Action
   Register Agent now	You are prompted to enter the Dashboard Username and Password Enter a Description for the device and the Dashboard Client and Site it should be registered under If required, configure the Proxy server settings when launching the Agent after installation.
   Register after installation manually	After installation, you are prompted to enter the All Devices view credentials and device information when you launch the Agent. For more information, see 3.Register the Mac Agent against the Dashboard.

   

6. Click install and when prompted enter the password of the user you logged into the Mac under to authorize
7. Click Close once complete

If a device is not enrolled in Device Management for Apple , you must Enable Accessibility and Full Disk Access permissions for rmmagent for that device.

You only manually register the Mac Agent if you manually installed the Mac Agent, and selected Register after installation manually in the installation wizard.

You can register the Mac Agent from within the Monitoring Agent or from a terminal.

Option 1: Using the Monitoring Agent

1. On the Mac workstation, open Finder
2. Go to Applications > Utilities
3. Double-click Advanced Monitoring Agent
4. When prompted enter All Devices view login Username and Password
5. Complete the Proxy server settings (if required)
6. Enter the Device Description and select the Client and Site combination from the drop-downs
7. Click OK to finish the registration process

Option 2: Using the Terminal (Command Line)

Register the Monitoring Agent from its installation directory: /usr/local/rmmagent

1. Click Finder > Go > Utilities
2. Double-click Terminal
3. Navigate to the Agent installation directory

$ cd /usr/local/rmmagent/

4. Enter the register command for the rmmagentd daemon either as root or by assuming root privileges by sudo, providing the computer's password where prompted. Complete the information then enter Yes to register the Agent with the Dashboard.

$ sudo ./rmmagentd register
*** Agent registration ***
Username:
Password:
Your current Clients:
0) Create new Client/Site
1) Alpha
2) Beta
Select the Client Number: 2
Sites for Client Beta:
0) Create new Site
1) Site A
2) Site B
Select Site number: 1
Device description: Bruce MacBook
Please check registration data:
Client: "Beta"
Site: "Site A"
Device: "Bruce MacBook"
Want to continue registration? Answer 'yes' or 'no': yes

Successfully registered

Register Agent (quiet)

You can send the registration information to the All Devices view using the quiet switch. Enter the register command for the rmmagentd daemon either as root or by assuming root privileges by sudo, providing the computer's password where prompted.

To avoid any command failures due to blank space or special characters, we recommend you encapsulate them in quotation marks.

$ sudo /usr/local/rmmagent/rmmagentd register --quiet --username=dashboard_user@example.com --password=Password321 --Client=Beta --Site="Site A" --desc="Bruce MacBook"

Registration succeeded.

Information displays as plain text in the terminal when using this option.

Quiet Register Command Switches

The following switches are available when using the quiet option to register the Agent.