Register the Mac Agent against the Dashboard

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.

Launch the Monitoring Agent

  1. Open Finder
  2. Navigate to Applications > Utilities
  3. Double-click Advanced Monitoring Agent

    4. clip0770

  4. When prompted enter N-sight RMM Dashboard 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

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

    4. $ 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.

    5. $ 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 N-sight RMM Dashboard 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.

$ sudo /usr/local/rmmagent/rmmagentd register help

Application command line error: Unexpected option argument: help

usage: rmmagentd register [--quiet --username=<username> --password=<password> --client=<client>

--site=<site> [--description=<description>] [--create-client] [--create-site]]

Register agent

-q, --quiet Quiet registration

-u<user>, --username=<user> User name

-p<password>, --password=<password> Password

-c<client>, --client=<client> Client name

-s<site>, --site=<site> Site name

-d<desc>, --description=<desc> Server description (optional)

-C, --create-client Create client (and site) if not exists

-S, --create-site Create site if not exists

Dashboard

After the Mac registers against the N-sight RMM Dashboard, it displays in the Workstations section, under the selected Client and Site. A Mac icon osx_icon is displayed against the computer for easy identification.

Any amendments to the Mac Agent (changes to the settings or Check management) are configured and performed from the N-sight RMM Dashboard.

osx_dashboard