Native Monitoring Point (NMP) - macOS

The AppNeta macOS NMP Enterprise Monitoring Point is software that runs on the native operating system of a host computer and is used for Delivery monitoring. As such, it is typically used to monitor network performance from the perspective of a work-from-home user. The macOS NMP can be licensed as either an n10 (using the “Workstation (n10)” license) or as an n35 (using a “Strategic (m50/c50) / Legacy Small Office” license).

Specifications

Host Requirements

Spec Sub-spec Value
Storage 2 hours stored locally in case disconnected from APM
Supported OS Mac OS
  • macOS 10.14 (Mojave), macOS 10.15 (Catalina), macOS 11.0 (Big Sur)
Virtual environments Hypervisors
  • ESXi 5.5 or higher
Guest OS
  • 64-bit RHEL 7
Hardware requirements Memory 512 MB
CPU 2.0 GHz
Disk space 10 MB

Limitations and issues

  • Delivery monitoring only (no Experience monitoring, Usage monitoring, or Packet Capture).
  • Does not support PathTest.
  • Does not support voice or video testing when installed on a virtual machine.
  • Scheduled access network links (for example, Fibre PON, DOCSIS Cable), typically provided by ISPs to residential customers, can show lower uplink capacity than expected.
  • Capacity measurements in either direction are problematic on Wifi networks.
  • Does not support Apple M-series processors.
  • macOS automatic time updates cause periodic jitter spikes and packet discards in voice and video tests. To work around this issue, uncheck > ​System Preferences​ > Date & Time > Set date and time automatically.
  • Usage monitoring is not supported.

A full list of features can be found on the Monitoring Point Feature Comparison page.

Setup

Monitoring Point setup

Use the following steps to install a Native Monitoring Point (NMP) on a macOS system on your network. After installation is complete, the NMP software connects to back APM. Once this is done, you need to license the Monitoring Point, set its location, and then set up monitoring.

Upgrading from a macOS Software Sequencer to a macOS NMP: If you are upgrading a macOS Software Sequencer (EMP 8.4 or earlier) to macOS NMP (EMP 12.9.0 or later), only steps 1, 2, and 3 below (Download, Install, and Verify) are required. The existing Monitoring Point identity and settings are preserved.

Prerequisites

  • Make sure you have administrative privileges on the system you are deploying to.
  • Make sure you’re using a supported OS.
  • To provide continuous monitoring, prevent the computer from sleeping when the display is powered off (Apple menu () > ​System Preferences​ > Energy Saver > Prevent computer from sleeping automatically when the display is off). Screenshot of the macOS Energy Saver dialog showing 'Prevent computer from sleeping automatically when the display is off' enabled.
  • For virtual environments, make sure you’re using a qualified hypervisor and guest OS. If not, use a Virtual Monitoring Point (on KVM or VMware) instead.
  • If you are using APM-Private Cloud, you should be using CA-signed certificates. Also, the host you are installing macOS NMP onto should have all root certificates in its trust store (required for automatic upgrades).
  • Configure your firewall rules to enable the Monitoring Point access to APM.
    • The Monitoring Point can still be installed and configured without this step, but monitoring is not possible until it is done.
  • If the firewall within the macOS (Apple menu () > ​System Preferences​ > Security & Privacy > Firewall) is turned on, make sure that you:
    • Enable “Automatically allow downloaded signed software to receive incoming connections”.
    • Disable “Enable stealth mode”. Screenshot of the macOS firewall with Automatically allow downloaded signed software to receive incoming connections enabled and Enable stealth mode disabled.

Download the software

  1. Log in to APM.
  2. Select an organization (if you belong to more than one).
  3. If you’re setting up your first Monitoring Point, you will be taken to the first step of the Add Monitoring Point wizard.
  4. If your organization already has Monitoring Points, navigate to > Manage Monitoring Points > Add Monitoring Points.
  5. In the Platform Type field, select macOS (native).
  6. Click Download.
    • The installer is downloaded to your computer.

Install the software

If you are using anti-virus software that requires that applications be included on an “allow” list, add the macOS NMP to that list. For example, for Malwarebytes, add the NMP software (/Applications/AppNeta Monitoring Point.app) to the list using this procedure.

There are two ways to install the software:

Manual install

This procedure is also available in other formats: Word, PDF

  1. On your Mac, open ​Finder​. Screenshot of Mac task bar with Finder highlighted.
  2. Select the ​Downloads​ folder and double-click the downloaded file (e.g., appneta-nmp-for-<org>-macos-<version>.dmg). Screenshot of Downloads folder with Downloads and appneta-nmp-for-Testing-macos-version.dmg highlighted.
  3. Double-click Installer.pkg. Screenshot of package screen with Installer.pkg highlighted.
  4. Click Continue. Screenshot of install screen with Continue highlighted.
  5. Review the license agreement and click Continue. Screenshot of read the license agreement dialog with Continue highlighted.
  6. If you agree to the terms of the license agreement, click Agree. Screenshot of read the agree to terms dialog with Agree highlighted.
  7. Click Install. Screenshot of Installation Type dialog with Install highlighted.
  8. If prompted, click Close Application and Install. Screenshot of Monitoring Point must be closed dialog with Close Application and Install highlighted.
  9. If prompted, enter your password and click Install Software. Screenshot of password prompt dialog with Install Software highlighted.
  10. On successful installation, click Close. Screenshot of the installation successful dialog with Close highlighted.
  11. If prompted to move the installer to the Trash, click Move to Trash. Screenshot of move to trash dialog with Move to trash highlighted.
  12. If prompted to allow the installer to access files in your Downloads folder, click OK. Screenshot of installer wants access to Downloads folder  dialog with OK highlighted.
Unattended install

Administrative privileges are required for a “silent” (no prompts) installation.

To deploy to multiple Macs using a Configuration Management (CM) tool (for example, Microsoft Endpoint Manager (formerly SCCM)):

  1. Define an “Appneta NMP” application in the CM tool.
  2. Add the downloaded installer (appneta-nmp-for-<org>-macos-<version>.dmg) to the application and deploy to your Mac hosts.
  3. By default, the Monitoring Point updates itself automatically as software updates become available. If you want to turn off auto-updates and provide updates via your CM tool instead, add the following as a post-install script:

     !/bin/bash
     set -e
     defaults write /Library/Preferences/com.appneta.nmp.plist SUEnableAutomaticChecks -bool NO
    

Verify that the Monitoring Point is running

Once the Monitoring Point is installed, the macOS NMP menu bar app will appear on your menu bar at the top of your desktop.

Click the menu bar app and confirm that the Monitoring Point service is running. Screenshot of the macOS NMP menu bar app opened with Monitoring Point is Running highlighted.

Assign a base license

Every macOS NMP is sold with a base license that must be assigned to it in APM before it can be used.

  1. Within APM, navigate to > Manage Monitoring Points.
  2. Wait for the new macOS NMP to show up in the list (you may need to refresh your screen).
    • The macOS NMP’s status should show “Connection Established” (Green circle with white check mark).
    • If it doesn’t appear after a few minutes, you’ll need to troubleshoot the problem.
  3. To assign it a base license, navigate to > Manage Licenses.
  4. In the Parent Organization drop-down (if visible), select the parent organization containing the macOS NMP.
  5. In the Organization drop-down, select the child organization containing the macOS NMP.
  6. Click the APM Monitoring Points tab in the bottom table.
  7. For the macOS NMP you want to add the license to, select > Assign Licenses.
  8. In the Base License section, select a base license.
  9. Click Submit. The macOS NMP is ready to use.

Optional - Assign add-on licenses

In addition to a base license, you can add Standard Enterprise Application licenses, voice licenses, and video licenses to the macOS NMP. Before they can be assigned, you need to purchase them. Once purchased, they will be added to your organization and available for assignment.

To assign an add-on license to the macOS NMP:

  1. Navigate to > Manage Licenses.
  2. In the Parent Organization drop-down, select the parent organization containing the macOS NMP.
  3. In the Organization drop-down, select the child organization containing the macOS NMP.
  4. Click the APM Monitoring Points tab in the bottom table.
  5. For the macOS NMP you want to add the license to, select > Assign Licenses.
  6. In the Add-on Licenses section, specify the types and quantities of licenses you want to add.
  7. Click Submit.
    • The new capabilities are ready to use.

Set the location

When adding a new macOS NMP to APM, you need to specify its location. This setting provides essential geographical context for the data that the macOS NMP collects. Typically, you specify its location during the setup procedure.

If you are outside the setup procedure, you’ll need to edit its location:

  1. Navigate to > Manage Monitoring Points
  2. For the macOS NMP you want to edit, select > Edit Location.
  3. Specify the location of the macOS NMP.
  4. Click OK.
    • The location is set.

Set up monitoring

At this point the Monitoring Point setup is complete. Continue the APM setup procedure at Set up performance monitoring. Note that the NMP only supports Delivery monitoring. It does not support Experience or Usage monitoring.

Troubleshooting connectivity to AppNeta

Your macOS NMP is properly connected to AppNeta Performance Manager (APM) when the status icon in > Manage Monitoring Points shows Green circle with white check mark.

If this is not the case, use the troubleshooting procedure below to help determine why it is not connecting.

Requirements Things to check
NMP 12.8.0 or later. See Offline Legacy Monitoring Points for issues with older Monitoring Points.
Your firewall must be configured to allow the NMP to connect to APM. Check the firewall configuration.
The NMP must be installed and running. Check that the NMP is properly installed and running.
The NMP must be connected to the network Use a browser to confirm that you can connect to the internet.
The system time must be correct. Check the system time and time zone.
If a proxy is being used, the NMP must be configured to connect through it. Check the proxy configuration on the NMP.
  Verify that the proxy is reachable from the network the NMP is on.
  Verify that the APM servers have been allowed in any access controls which may exist on the proxy.
If you are using anti-virus software that requires that applications be included on an “allow”” list, confirm that the macOS NMP software is on that list. For example, for Malwarebytes, add the NMP software (/Applications/AppNeta Monitoring Point.app) to the list using this procedure.

If you are still unable to resolve the issue, contact AppNeta Support.

Verify installation

Once the NMP is installed on your Mac, the macOS NMP menu bar app will appear on your menu bar at the top of your desktop.

Click the menu bar app and confirm that the Monitoring Point service is running. Screenshot of the macOS NMP menu bar app opened with Monitoring Point is Running highlighted.

Access

View Monitoring Point status

You can view the macOS NMP status on APM and on your deployment host.

View Monitoring Point status on APM

To view a Monitoring Point’s status in APM:

  • Within APM, navigate to > Manage Monitoring Points.
    • The Monitoring Point status is indicated by the icon in the left column.
Icon Status Description
Green circle with white check mark OK The Monitoring Point is connected to APM.
Black circle with white minus sign Connection Lost The Monitoring Point is not connected to APM. Troubleshoot the issue.

Additional statuses can be found in the Additional Status columns. Hover over the icons for details and/or actions to take.

Icon Status Description
Shared The Monitoring Point is shared between organizations.
Unlicensed The Monitoring Point is unlicensed.
Monitoring Point Error There is a Monitoring Point error.
Upgrade Available There is a software upgrade available for the Monitoring Point.

View Monitoring Point status on your Mac

If the macOS NMP is not connecting to APM, you will want to confirm that it is running on your Mac. Click the macOS NMP menu bar app and confirm that the Monitoring Point service is running. Screenshot of the macOS NMP menu bar app opened with Monitoring Point is Running highlighted.

Determine the Monitoring Point hostname or IP address

Once the macOS NMP has connected to APM, you can view its hostname and IP address.

  1. Log in to APM.
  2. Make sure you are using the correct organization
  3. Navigate to > Manage Monitoring Points.
  4. Click the macOS NMP you want to connect to. In the right pane:
    • the Host Name field contains the hostname.
    • the Public IP field contains the public IP address. Use this if you are connecting to the macOS NMP across the internet.
    • the Host Networking Details section contains the active macOS NMP interfaces and the local IP address of each. Use this if you are connecting to the macOS NMP locally.

Configure

Methods

Management and configuration capabilities are accessed from within APM via > Manage Monitoring Points. For example, changing Monitoring Point location or renaming the Monitoring Point.

Basic settings

There are a few settings that should be configured on the macOS NMP including Time zone, Location, and Name.

Time zone

There are two time zones that must be configured - your local time zone and the Monitoring Point time zone.

The Monitoring Point time zone must be configured on the host the macOS NMP is running on.

Having the correct time zone on the macOS NMP is important for a number of reasons:

  • In conjunction with the macOS NMP’s system time, it is required in order for the macOS NMP to connect to APM. If the time is not correct, then there could be an issue with certificate validity checks when connecting.
  • It is required for monitoring results to be timestamped correctly.
  • It is required in order to display the correct time in path performance charts when Source Monitoring Point Time Zone is set.
  • It is required for alert conditions to be applied at the right time according to alert time ranges you have set.

Location

The location specified for the macOS NMP is necessary for a variety of reports and charts.

The macOS NMP’s location is specified during the setup procedure but it can be edited at any time.

  1. Navigate to > Manage Monitoring Points
  2. For the Monitoring Point you want to edit, select > Edit Location.
  3. Specify the location of your Monitoring Point.
  4. Click OK.
    • The Monitoring Point’s location is set.

APM name and hostname

All Enterprise Monitoring Points (EMP) have two names: a hostname and an APM name. The hostname is used to identify the Monitoring Point on the network. The APM name is used to identify the Monitoring Point within APM. By default, both of these names are the same and match the computer name of the computer the macOS NMP is installed on.

If you manually change the APM name, the hostname is not affected. If you change the hostname, the APM name is changed automatically unless the APM name was changed manually. In this case, changing the hostname does not affect the APM name.

Rename a Monitoring Point

To change the macOS NMP’s APM name:

  1. Navigate to > Manage Monitoring Points.
  2. For the macOS NMP you want to rename, navigate to > Rename.
  3. Either select the default or specify a new name.
  4. Click Confirm.
    • The macOS NMP’s APM name is changed.
Change the hostname

When you change the macOS NMP’s hostname, the APM name is changed automatically unless the APM name was changed manually. In this case, changing the hostname does not affect the APM name.

To change the macOS NMP’s hostname, change the hostname of your Mac.

Networking

The following networking-related features can be configured on the macOS NMP.

Hostname

See APM Name and Hostname

Web proxy

For networks that require internet traffic to be forwarded by a web proxy, the Native Monitoring Point (NMP) - macOS must be configured to connect to your proxy server so that it can communicate with APM.

The proxy settings on the macOS NMP only affect how it connects and reports data back to APM. These settings are not used for performance monitoring. If you are using Experience monitoring, you will also need to configure access to the proxy either when you create a web app group or after the web app group is created.

  1. Find seq.config.sample in /Library/PreferencePanes/AppNetaSequencer.prefPane/Contents/Resources/config
  2. Save a copy and rename it seq.config.
  3. Edit seq.config.
  4. Uncomment the proxy config lines and fill in your proxy details:
    • Proxy Address - the IP address of the proxy server.
    • Proxy Port - the port the proxy server is listening on.
    • Proxy Username - a valid user name on the proxy server (if authentication/authorization is required). Only basic and digest authentication protocols are supported. NTLM and Kerberos are not supported.
    • Proxy Password - the password for the username specified (if authentication/authorization is required).
  5. Save your changes.
  6. Restart the macOS NMP (as a user with administrative access):
    1. Open System Preferences.
    2. Double-click AppNeta Sequencer.
    3. Enter your password and click OK.
    4. Click Restart.

Manage

Restart

Restarting the macOS NMP will disrupt its connection to APM but it does not affect its software or its configuration.

To restart the macOS NMP, click the menu bar app and select Restart Monitoring. Screenshot of the macOS NMP menu bar app opened with Restart Monitoring highlighted.

Shutdown

Administrative privileges are required to stop or start the macOS NMP.

To shut down the macOS NMP, click the menu bar app and select Stop Monitoring. Screenshot of the macOS NMP menu bar app opened with Stop Monitoring highlighted.

To start it back up again, click the menu bar app and select Start Monitoring. Screenshot of the macOS NMP menu bar app opened with Start Monitoring highlighted.

Delete

Deleting the macOS NMP from an organization is typically done when you are moving it to another organization or freeing up its base license so it can be used by another Monitoring Point.

Deleting the macOS NMP has the following effects:

  • All paths where the macOS NMP is the source (and the monitoring history related to those paths) are deleted (though they can be moved to another Monitoring Point during the delete process).
  • Tests and assessments are not deleted.
  • The base license and any add-on licenses that were assigned to the macOS NMP become available again.
  • The macOS NMP can no longer be seen from APM and will be decommissioned if it is online during the delete process.

To delete the macOS NMP from your organization:

  1. Navigate to > Manage Monitoring Points.
  2. For the macOS NMP you want to delete, select > Delete.
    • You will be prompted to confirm this action, and optionally to move all affected paths to another Monitoring Point.
  3. You should also remove resources on the deployment host.

Manage software

For a macOS NMP, you can upgrade the software or uninstall it. You can also quit and restart the macOS NMP menu bar app.

Upgrade software

Upgrading from a macOS Software Sequencer to a macOS NMP: If you are upgrading a macOS Software Sequencer (EMP 8.4 or earlier) to macOS NMP (EMP 12.9.0 or later), you need to reinstall the software (Important: DO NOT uninstall the old software first). The existing Monitoring Point identity and settings are preserved. Upgrades to a macOS NMP running EMP 12.9.0 or later software occur automatically by default.

By default, the macOS NMP software checks for updates daily and is updated automatically when a new version is available. You can also check for updates manually by clicking the macOS NMP menu bar app and selecting Check For Updates. Screenshot of macOS NMP menu bar app selected with Check For Updates highlighted.

Uninstall software

Prior to removing the macOS NMP software, delete the Monitoring Point in APM.

To uninstall the macOS NMP software:

  1. On your Mac, click the macOS NMP menu bar app and select Quit. Screenshot of macOS NMP menu bar app selected with Quit highlighted.
  2. When prompted to quit the menu bar app, click Quit. Screenshot of the Do you want to quit the menu bar app dialog with Quit highlighted.
  3. Open ​Finder​. Screenshot of Mac task bar with Finder highlighted.
  4. Select the Applications folder, right click AppNeta Monitoring Point.app, and select Move to Trash. Screenshot of Applications folder with AppNeta Monitoring Point.app and Move to Trash highlighted.
    • The AppNeta Monitoring Point software is uninstalled.
    • It may take a few minutes for the AppNeta Monitoring Point service to stop. Emptying the trash will immediately trigger the service shutdown and cleanup.
    • Log files and configuration files are not removed by default. To remove them, enter the following:

        sudo rm -rf /Library/Applicaiton Support/AppNeta
        sudo rm -rf /Library/Logs/AppNeta
      

Quit the menu bar app

Note: Quitting the macOS NMP menu bar app disables automatic software updates (not recommended). Also, quitting the menu bar app does not stop the Monitoring Point service. Use Stop Monitoring for that.

To quit the menu bar app:

  1. On your Mac, click the macOS NMP menu bar app and select Quit. Screenshot of macOS NMP menu bar app selected with Quit highlighted.
  2. When prompted to quit the menu bar app, click Quit. Screenshot of the Do you want to quit the menu bar app dialog with Quit highlighted.

Restart the menu bar app

To restart the menu bar app:

  1. Open ​Finder​. Screenshot of Mac task bar with Finder highlighted.
  2. Select the Applications folder, and double-click AppNeta Monitoring Point.app. Screenshot of Applications folder with AppNeta Monitoring Point.app highlighted.

Migrate monitoring

See Migrate Monitoring between Monitoring Points.

Share

See Sharing a Monitoring Point.

Move between orgs

macOS NMPs and the data they have collected cannot be moved to another organization. If you need to move a macOS NMP to another organization you must first delete it then reinstall/re-deploy it in the new organization.

  1. Delete the macOS NMP.
  2. Reinstall the macOS NMP in the new organization.