macOS Deployment

Starting with Catalina, Apple has added security when any new application is installed on a Mac. All users will be asked to grant location permission to the 7SIGNAL Mobile Eye app after install.

After Mobile Eye is successfully installed on any device, go to Configuration >  Licenses > Unassigned to find it. Check the box to the left, then click the Activate button. Within 5 or 10 minutes you should see your first data points for your device.

There are two steps to the macOS deployment and you may use tools like Jamf Pro to facilitate this process. The first step is to install the package. A sample script is below.

sudo installer -pkg 7signal-Mobile-Eye-Agent-MacOS-1.20.1.70-signed.pkg -target /

 

Run as “admin/root” for no GUI or prompts.

The second step is to update the organization ID in the application.properties file, which defines your tenant in the cloud. Your organization ID is a special code that maps your devices to our cloud. It MUST come from 7SIGNAL.  A sample script is below.

#!/bin/bash
org=yourOrgID
cd /Library/Application\ Support/7signal
plist=/Library/LaunchAgents/com.sevensignal.mobileeyeagent.plist
sed -i.bak "/organization/d" application.properties
echo organization=$org >> application.properties

loggedInUser=$(stat -f%Su /dev/console)
uid=$(id -u $loggedInUser)
launchctl bootout gui/$uid $plist
launchctl bootstrap gui/$uid $plist

After macOS Install

  • After the Mobile Eye install, the user will be asked to grant the location permission.
  • When granted (click OK), Mobile Eye cannot ask again, even after a reinstallation of Mobile Eye. This is because MacOS remembers the selection and will not allow 3rd party applications to ask again.
  • If the permission is denied (click Don't Allow), Mobile Eye cannot ask again, even after a reinstallation of Mobile Eye, because MacOS remembers the selection and will not allow 3rd party applications to ask again.
  • If permission is denied by mistake, then the user must  go to the System Preferences > Security & Privacy > Privacy > Location pane if they now want to grant permission.

Login for macOS

The location permission allows Mobile Eye to identify neighboring networks and access points so that it may detect device roaming and Wi-Fi interference issues. If the permission is not granted, then Mobile Eye will not be able to detect these issues.

If the user denies permission when MacOS asks, then the user must  go to the System Preferences → Security & Privacy pane if they now want to grant permission.

Security and Privacy

Permission Not Granted

While active testing and many passive metrics are not affected, when the location permission is not granted by the user, some elements are not available to 7SIGNAL by macOS.  This inhibits the ability to perform root cause analysis:

  • Names and BSSIDs of the connected AP
  • Names and BSSIDs of surrounding APs
  • Channel widths
  • Geo-location

Mac no permission

Self-Service Installation

Login to your Mobile Eye account and click the downloads button along the left navigation bar. After downloading, double click the file to launch the Mobile Eye Setup Wizard.

The first screen of the setup wizard is the most important. You MUST enter your Organization ID so that your Wi-Fi performance data is directed to your instance in the cloud.

Your Organization ID is in the ‘Welcome to Mobile Eye’ email you received from 7SIGNAL Support.

 

Setup-Wizard-medium

After Installation

Next, you’ll want to verify that you can see the device’s Wi-Fi performance data by logging into Mobile Eye and clicking the Devices menu along the left navigation bar.

It generally takes about 10 minutes for the first data points from the client to appear. However, If you do not see the client device in the list, then click here for troubleshooting.