macOS Deployment

The latest version of Mobile Eye can always be downloaded after logging into the web interface. Just click the Downloads button from the left navigation menu.

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.17.1.60-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

Starting with Catalina, Apple has added increased security when any new application is installed on a Mac. Now, all users will be asked to grant location permission to the 7SIGNAL Mobile Eye app before using it.

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.

First, 7SIGNAL Mobile Eye will ask for the location permission. The primary purpose of this message is to explain why the location permission is needed. When the user selects "OK" then Apple macOS will ask the user for the location permission and it should be granted.

If the user clicks "Don't Allow," when Mobile Eye prompts them, then the dialog box will close. However, Mobile Eye will prompt the user again the next time they login to their computer.

 

Login for macOS

 

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 5 or 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.