Note: This article only applies to NetSupport DNA Mac Agents up to version 2.10.xxxx. Please click here for instructions on how to install the NetSupport DNA version 2.20.000 Mac Agent via Jamf Pro.
Pre-requisites/assumptions
-
- An MDM specific profile is installed onto the Mac device and relevant permissions granted.
- The Mac device is enrolled in the MDM environment.
- An MDM specific Client application is installed on the device.
- The user is familiar with the Meraki web interface/configuration.
- The NetSupport DNA Console and SQL Server are installed on a Windows machine.
- The user understands Apple Remote Desktop (ARD).
- The Mac DNA Agent has been downloaded from www.netsupportdna.com
Apple Remote Desktop
Remote installation
Adding/deploying the application
You need to ensure the sharing options are enabled for remote management.
- Select System Preferences – Sharing.
- The target machines must have the following three options selected:
- File Sharing
- Remote Login
- Remote Management.
- Select the DNA Mac Agent application and send to the desktop of the ARD machine.
- Open Remote Desktop from the Launchpad.
- Select the machines you would like to install the DNA Mac Agent onto.
- You can search for machines using any of the options shown in the screen shot below.
- Select the required machines and click Copy.
- The Copy Items page will appear. Drag or add the DNA Mac Agent installation application into the Items to copy box.
Place items in:
Ensure this is set to the /Users/Shared file location as this is accessible to all users that log into a Mac. It is also accessible while users are logged off.
If an item already exists:
Select the applicable option.
Set item ownership to:
This option needs to be set to Inherit from destination folder.
Select any other relevant options and click Copy.
- Select UNIX.
- In the UNIX Command Centre, enter the following command:
/bin/bash
cd /Users/Shared/
cd “NetSupport DNA Agent Installer.app”
cd ./Contents/Resources/
./quickinstaller.sh 10.20.0.95 en
The format for the above command is:
\… Installer.app = The current app name.
./quickinstaller.sh = Runs the installer script.
10.20.0.95 = IP address of the NetSupport DNA Server.
/en = Install the English language pack.
/de = Install the German language pack.
/es = Install the Spanish language pack.
/it = Install the Italian language pack.
- Once the command has been entered, press Send.
- The default path for the install is:
Applications/NetSupport/NetSupportDNA/SystemAgent. - The command has now been sent to all selected machines. You need to check the ARD to make sure there were no errors.
- The machines will restart and the DNA Agents will have been successfully installed.
Cisco Meraki
Adding/deploying the application
- Login to your Meraki interface and choose Systems Manager – Apps.
- Select Add an app, choose macOS, select the Custom app option and click Next.
- Enter the name of the application, “NetSupport DNA Agent Installer.app” and any other required information. In the Source section, add the DNA Mac Agent installation application (.DMG file) you copied earlier.
- In the Details section, complete any settings you require, set the scope of devices you want the application installed onto and click Save.
- Applications will automatically install if configured to do so, but the user can force installation again from the Systems Manager – Apps tab if required.
- Select Push to all in scope or Push to missing.
- Check that the installer Agent has been added into the Applications folder.
- Go to the Command Line and select all machines you want to install the DNA Mac Agent onto and run the command (see below). The server IP address will need to be changed to match your server IP address (red text), you can also change the installation location, language and the website it navigates to (blue text).
Command text
Short command
Installs in Applications/NetSupport and directs to NetSupport DNA website:
cd /Applications/NetSupport\ DNA\ Agent\ Installer.app/Contents/Resources/; /Applications/NetSupport\ DNA\ Agent\ Installer.app/Contents/Resources/quickinstaller.sh 10.20.0.95 en
Long command
To change the installation location and website:
/Applications/NetSupport\ DNA\ Agent\ Installer.app/Contents/Resources/installer.sh /Applications/NetSupport\ DNA\ Agent\ Installer.app/Contents/Resources/ 10.20.0.95 /Applications/NetSupport/NetSupportDNA/SystemAgent en http://www.netsupportdna.com
Uninstalling in Apple Remote Desktop
- Select the device you would like to uninstall the NetSupport DNA Agent from.
- Run the following command in UNIX as a root user:
/bin/bash
cd /Users/Shared/
cd “NetSupport DNA Agent Installer.app”
cd ./Contents/Resources/
./uninstaller.sh . /Applications/NetSupport/NetSupportDNA/SystemAgent
If you have installed this to a different location, the red text will need amending.
Uninstalling in Meraki
- Go to the Command Line.
- Select all devices you want to remove it from.
- Run the following command, this will need to be changed if you installed to a different location:
/Applications/NetSupport\ DNA\ Agent\ Installer. app/Contents/Resources/uninstaller.sh /Applications/NetSupport\ DNA\ Agent\ Installer. app/Contents/Resources/ /Applications/NetSupport/NetSupportDNA/SystemAgent
Mac OS 10.14 – custom configuration
With Mac OS 10.14, Apple has introduced extra security protection for your private data. Users are now asked to grant permission to applications before they can run or access certain content on your system.
If a user does not grant permission to the NetSupport DNA Mac Agent, certain features within the software will not operate as expected, such as Internet Metering or viewing an Agent.
For systems administrators, we have created a custom configuration which can be applied so users do not have to accept permissions multiple times or when a new user signs into a shared machine. This configuration can be assigned to devices enrolled in an MDM environment.
Once a custom configuration/profile has been sent to the device, it can be viewed on a device by logging into a user account, opening System Preferences and selecting Profiles.
The custom configuration file can be found at:
Cisco Meraki
- Select Systems Manager – Settings.
- Select Add Profile.
- Choose Upload custom Apple profile and click Continue.
- Select the Upload a .mobileconfig file option and navigate to the location of the NetSupportDNASecurityProfile.mobileconfig file.
- Configure any other options on the page which you require, e.g. Allow users to remove this profile.
- Adjust your scope to choose which devices receive the custom configuration.
- Click Save.