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.
- Download the software
- Install the software
- Verify that the Monitoring Point is running
- Assign licenses
- Set the Monitoring Point location
- Set up monitoring
- Related topics
- Make sure you have administrative privileges on the system you are deploying to.
- Make sure you’re using a supported OS.
- 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”.
Download the software
- Log in to APM.
- Select an organization (if you belong to more than one).
- If you’re setting up your first Monitoring Point, you will be taken to the first step of the Add Monitoring Point wizard.
- If your organization already has Monitoring Points, navigate to > Manage Monitoring Points > Add Monitoring Points.
- In the Platform Type field, select macOS (native).
- Click Download.
- The installer is downloaded to your computer.
Install the software
There are two ways to install the software:
- On your Mac, open Finder.
- Select the Downloads folder and double-click the downloaded file (e.g., appneta-nmp-for-<org>-macos-<version>.dmg).
- Double-click Installer.pkg.
- Click Continue.
- Review the license agreement and click Continue.
- If you agree to the terms of the license agreement, click Agree.
- Click Install.
- If prompted, click Close Application and Install.
- If prompted, enter your password and click Install Software.
- On successful installation, click Close.
- If prompted to move the installer to the Trash, click Move to Trash.
- If prompted to allow the installer to access files in your Downloads folder, click OK.
To deploy to multiple Macs using a Configuration Management (CM) tool (for example, Microsoft Endpoint Manager (formerly SCCM)):
- Define an “Appneta NMP” application in the CM tool.
- Add the downloaded installer (appneta-nmp-for-<org>-macos-<version>.dmg) to the application and deploy to your Mac hosts.
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.
Every Monitoring Point is sold with a base license that allows it to monitor a certain number of applications. The base license must be assigned to the Monitoring Point in APM before it can be used. Optionally, add-on licenses can be assigned.
To license a Monitoring Point:
- Within APM, navigate to > Manage Monitoring Points.
- Wait for the new Monitoring Point to show up in the list (you may need to refresh your screen).
- The Monitoring Point status should show “Connection Established” ().
- If it doesn’t appear after a few minutes, you’ll need to troubleshoot the problem.
- Assign a base license to the Monitoring Point.
- Optionally, assign add-on licenses as required.
Set the Monitoring Point location
When adding a new Monitoring Point to APM, you need to specify its location. This setting provides essential geographical context for the data that the Monitoring Point collects.
To set the location of the Monitoring Point:
- Enter the Monitoring Point location if prompted during the setup procedure.
- If you are outside the setup procedure, you’ll need to edit the Monitoring Point location.
Set up monitoring
At this point the Monitoring Point setup is complete. Continue the APM setup procedure at Set up monitoring.
Note that the NMP only supports Delivery monitoring. It does not support Experience or Usage monitoring.