1. Mac Mini Pre-configuration

Configure Mac Mini for deviceConnect

What’s needed before you start

You will need a Mac mini with at least the following hardware specifications.Screen_Shot_2022-09-06_at_1.22.16_PM.png

  • MacOS version 11.4 (Big Sur) or higher.
  • Intel-based processor. Apple Silicon will be supported on October 8, 2022.
  • If the Mac machine was installed with the legacy Kobiton Desktop app, make sure to do a factory reset before installing deviceConnect.

Configure Mac mini

1. Disable Energy Saver in Mac

The Mac machine always acts as a server. However, the Energy Saver on MacOS puts the machine into sleep mode after a period of inactivity. This step aims to keep the machine awake by disabling Energy Saver.

  1. Click on the menu icon Screen_Shot_2022-09-06_at_1.46.09_PM.png and then choose “System Preferences”
  2. Type ‘Energy Saver’ into the search field located at the top-right corner then select it.
  3. Switch to Power Adapter view, ensure that:
    • Prevent computer from sleeping… is checked
    • Put hard disks to sleep when possible is unchecked

      Screen_Shot_2022-09-06_at_1.47.11_PM.png

2. Set the timezone

Set the timezone for the Mac mini to be in the timezone it is located.

  1. Click on the menu icon Screen_Shot_2022-09-06_at_1.46.09_PM.png and then choose “System Preferences”
  2. Enter ‘Date & Time’ into the search field located at the top-right corner, and then select it.
  3. Choose the city in the ‘Closest City’ fieldScreen_Shot_2022-09-06_at_1.48.11_PM.png

3. Disable OS updates

Automatic OS updates interrupt the device testing functions, so we disable it.

  1. Click on the menu icon Screen_Shot_2022-09-06_at_1.46.09_PM.png and then choose “System Preferences”.
  2. Enter ‘Software Update’ into the search field located at the top-right corner, and then select it.
  3. Click on Advantage button.
  4. Make sure all checkboxes are unchecked.

4. Enable remote control

We will use remote control to remotely access the Mac mini and make changes, as necessary.

  1. Click on the  menu item and then choose “System Preferences”
  2. Enter ‘Sharing’ into the search field located at the top-right corner, and then select it.
  3. Make sure ‘Screen Share’ and ‘Remote Login’ are both checked.

5. Disable Siri

Siri is nice and all, but it’s a server and nobody is going to hear her. So, follow Apple’s instructions here to disable Siri.

6. Disable Firewall

Since deviceConnect will communicate with other machines, the built-in macOS Firewall service should be disabled to allow full network data transmission. Follow Apple’s instructions here to disable Firewall.

7. Create MacOS local user for deviceConnect executable

The deviceConnect automation installer requires an admin privilege user to operate on. Please run the script below in the terminal to create a deviceConnect user if the Mac mini doesn’t have the deviceConnect user yet.

sudo -s <<EOF
dscl . -create /Users/deviceconnect
dscl . -create /Users/deviceconnect RealName "deviceConnect"
dscl . -create /Users/deviceconnect UserShell /bin/bash
dscl . -create /Users/deviceconnect NFSHomeDirectory /Users/deviceconnect
dscl . -create /Users/deviceconnect UniqueID "1001"
dscl . -create /Users/deviceconnect PrimaryGroupID 20
dscl . -passwd /Users/deviceconnect GoMobile!
dscl . -append /Groups/admin GroupMembership deviceconnect
dseditgroup -o edit -a deviceconnect -t user admin
mkdir -p /Users/deviceconnect
chown deviceconnect /Users/deviceconnect
EOF

 

Bypass deviceConnect’s executables in the protection application (antivirus, malware) of your organization

DISREGARD this section if your organization has no antivirus or malware app running in the machine where deviceConnect is installed

McAfee,Sophos, or CylancePROTECT are examples of antivirus or malware apps that you may have installed on the workstation where deviceConnect is installed. They may block deviceConnect’s executables and block it from functioning normally. This section lists out top-level executables from deviceConnect that you should add to the whitelist (e.g. always allow to execute with a full grant from OS) of the antivirus software.

The deviceConnect is initialized by below executable files, please make sure files in the below list are added to the whitelist of your antivirus app

  • /usr/local/deviceconnect/Services/ (directory): *.dll and executable files i.e. the execute bit is 1 for owner, group and other
  • /usr/local/deviceconnect/devicekey/deviceKeyServer
  • /usr/local/deviceconnect/Build/Mono/dc-adb
  • /usr/bin/caffeinate
  • /usr/local/bin/nginx

Then reboot the workstation so that the deviceConnect can initialize fully without any prevention from the antivirus app

Was this article helpful?
0 out of 0 found this helpful