Manual Installation—Mac Agent

To manually install the Mac Agent on a Mac workstation:

  1. Download the Mac Agent from the All Devices view:

    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.

      There are two Agent version types:

      • General Availability (GA) — Latest production Agent release
      • Release Candidate (RC) — Release Candidate Agents undergo extensive testing before you can download them, but if you choose to download an RC Agent, it could include be minor bugs
  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.
      ChoiceAction
      Register Agent now
      1. You are prompted to enter the N-sight RMM Username and Password.
      2. Enter a Description for the device and the Client and Site it should be registered under.

        3. If required, configure the Proxy server settings when launching the Agent after installation.

      Register after installation manuallyIf you select this option, when you launch the Mac Agent after the installation is complete you are prompted to enter the N-sight RMM credentials and device information to register the Mac Agent.

    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.

  3. If you selected Register after installation manually above, now you must register the Mac Agent with the N-sight RMM user interface. You have the option to register the Mac Agent from within the Mac Agent or from the Terminal (Command Line).

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

    OptionActions
    Using the Mac Agent
    1. On the Mac workstation, open Finder .
    2. Go to Applications > Utilities
    3. Double-click Advanced Monitoring Agent.
    4. When prompted enter the N-sight RMM 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.
    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.

      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 N-sight RMM user interface.

      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 user interface 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

When these steps are complete, the Mac workstation displays in the All Devices view North-pane Workstation tab, for the selected Client and Site.

Any amendments to the Mac Agent (changes to the settings or Check management) are configured and performed from the All Devices view.