Deploying Beam Across the Organization to Mac Devices

Mac Beam Client 

Download the Mac Installer, ScreenMeetBeam.pkg.

Use can use an MDM system to deploy the ScreenMeetBeam.pkg and there are three main steps.

1. Upload ScreenMeetBeam.pkg to the MDM system.

2. Configure the pre-install script that will set all required ScreenMeet Beam client settings.

3. Configure the audit script which checks the conditions when the ScreenMeet Beam client should be installed.

Upload ScreenMeetBeam.pkg to the MDM system

Uploading the package to the mdm system is pretty straightforward operation and just requires the ScreenMeetBeam.pkg file

Configure the pre-install script

Here's an example shell script that configures Beam group key and other settings.

#!/bin/bash

PLISTFILE="/Users/Shared/ScreenMeetBeam/Config-000000.plist"

SCREENMEET_BEAM_CLIENT_GROUPKEY=gsfVxygOanARIpZMaCLKxIqSoiGxcEGTxTdaJRZp
SCREENMEET_BEAM_CLIENT_HIDEUI=true
SCREENMEET_BEAM_CLIENT_PASSWORD=
SCREENMEET_BEAM_CLIENT_AUTOUPDATE=false
SCREENMEET_BEAM_CLIENT_USER_CAN_CONTROL_AUTOUPDATE=false
SCREENMEET_BEAM_CLIENT_LABEL=MyMac
SCREENMEET_BEAM_CLIENT_TAGS=tag1,tag2

cat > "$PLISTFILE" <<EOF
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>authMode</key>
	<string>noauth</string>
	<key>groupKey</key>
	<string>$SCREENMEET_BEAM_CLIENT_GROUPKEY</string>
	<key>hideUI</key>
	<$SCREENMEET_BEAM_CLIENT_HIDEUI/>
	<key>password</key>
	<string>$SCREENMEET_BEAM_CLIENT_PASSWORD</string>
    <key>autoupdate</key>
	<$SCREENMEET_BEAM_CLIENT_AUTOUPDATE/>
    <key>userCanControlAutoupdate</key>
	<$SCREENMEET_BEAM_CLIENT_USER_CAN_CONTROL_AUTOUPDATE/>
    <key>installMethod</key>
	<string>mdm</string>
    <key>installSoftware</key>
	<string>kandji</string>
	<key>label</key>
	<string>$SCREENMEET_BEAM_CLIENT_LABEL</string>
	<key>tags</key>
	<string>$SCREENMEET_BEAM_CLIENT_TAGS</string>
</dict>
</plist>
EOF

Here's a list of the configuration options you can specify to configure different settings for the Beam client:

SCREENMEET_BEAM_CLIENT_GROUPKEY - device group key that associates the Mac with a specific Beam Group.

SCREENMEET_BEAM_CLIENT_HIDEUI - if enabled, starts Beam session without UI being displayed on client machine.

SCREENMEET_BEAM_CLIENT_PASSWORD - password for password authentication mode.

SCREENMEET_BEAM_CLIENT_AUTOUPDATE - enables automatic checks for updates and notifications.

SCREENMEET_BEAM_CLIENT_USER_CAN_CONTROL_AUTOUPDATE - if disabled, user can not control auto update settings from the Beam configuration UI.

SCREENMEET_BEAM_CLIENT_LABEL - adds label displayed in the Beam device table for the current device

SCREENMEET_BEAM_CLIENT_TAGS - adds comma-separated list of tags displayed in the Beam device table for the current device

Configure the audit script which checks the conditions when the ScreenMeet Beam client should be installed

The audit script checks whether ScreenMeetBeam is installed on the machine and pushes the install if it is NOT installed. It depends on the specific mdm systems and can be tweaked as needed.

Here's an example shell script that checks the conditions for automatically installing Beam client:

#!/bin/bash
PLISTFILE="/Users/Shared/ScreenMeetBeam/Config-000000.plist"
if [ -f "$PLISTFILE" ]; then
echo "ScreenMeetBeam is installed. Do nothing."
exit 0
else
echo "ScreenMeetBeam is not installed...forcing reinstall..."
exit 1
fi