Deployment with Jamf Pro

Follow

Who is this for?

This guide was designed for the Jamf Pro Admin at an organization that is deploying Splashtop Business.

Scope

This guide will take you through the steps of deploying and configuring the Splashtop Streamer on macOS with Jamf Pro. Splashtop Business app is also required.

Prerequisites

  • Jamf Pro
  • Splashtop Business Account
  • Splashtop Download
  • Network Connection

Deployment Instructions

A Jamf Pro admin needs to package Splashtop correctly, and then create a Computer Policy to deploy the package and execute a command to kickoff the installation script.

Preparing the Splashtop deployable PKG

The default Splashtop installer DMG must be packaged into a format that is deployable by Jamf Pro. This can be done with the Jamf Composer tool.

  1. Please download these two files: Splashtop installer .dmg and the deploy_splashtop_streamer.sh script to your computer.
  2. Navigate to the /private/tmp directory on a machine that is running Jamf Composer. 
    Within this directory, please make a new folder with one word and name it something to help keep track of the Splashtop files Ex. folder name "Streamer" or "SplashtopStreamer"

    Screen_Shot_2020-09-29_at_10.13.35_AM.png
  3. Drag and drop the two files we downloaded earlier, Splashtop installer .dmg and deploy_splashtop_streamer.sh into the folder we just created.
    Screen_Shot_2020-09-29_at_10.10.21_AM.png
  4. Open Jamf Composer on your machine, and log in if prompted. (If a window opens asking which method to use to create your package, please click cancel, we will be using the drag and drop method instead).
  5. Drag and drop this folder into the sidebar of Composer under “Sources” and it should appear as one source.Screen_Shot_2020-08-07_at_11.20.59_AM.png
  6. Next, adjust the ownership and permissions of Streamer to match the private folder by selecting the private folder in the center window and using the gear icon and selecting “apply Permissions to private and All Enclosed Items”
    Screen_Shot_2020-09-29_at_10.12.43_AM.png
  7. Click “Build as PKG” and choose where you would like the new package to be saved.

Uploading the PKG to Jamf Pro

The deployable PKG needs to be moved into Jamf Pro to enable its use in a Computer Policy.  Here is a JAMF Pro reference doc: here.

  1. Log in to Jamf Pro.
  2. In the top-right corner of the page, click Settings..
  3. In the “Computer Management” section, click Packages.
  4. Click New.
  5. Use the General pane to configure basic settings for the package, including the display name and category.
 Note: If you do not add the package to a category, Jamf Admin displays the package in blue text in the Unknown category.
  6. Click Upload Package and upload the package.
  7. Click the Options tab and configure additional settings for the package, including the priority.
 Packages with higher priority install first. Package priority defaults to "10". A package with a priority of "1" is deployed or uninstalled before other packages. Multiple packages with the same priority install in alphabetical order based on the package name.
  8. Click Save.

Create a Computer Policy

The deployable PKG needs to be moved into Jamf Pro to enable it’s use in a Computer Policy.

  1. Click Computers at the top of the page.
  2. Click Policies.
  3. Click New.
  4. Use the General payload to configure basic settings for the policy, including the trigger and execution frequency. Below are examples.
    1. Display Name: Deploy Splashtop
    2. Trigger: Reoccurring Check-In
    3. Execution Frequency: Once Per Computer
  5. Use the Packages tab to select your deployable Splashtop PKG.
    1. Click Configure.
    2. Find your Splashtop PKG and click Add.
    3. Ensure that Install is selected and click Save.
    4. Use the rest of the payloads to configure the tasks you want to perform. For an overview of each payload, see Policy Payload Reference.
  6. Use the Files and Processes tab to execute a command that will trigger the installation script.
    1. Click Configure.
    2. Under Execute Command, paste the following and substitute XXXXXX with your Deploy Code and “Splashtop_Streamer_Mac_DEPLOY_INSTALLER_v3.3.6.0.dmg” with the appropriate installer .dmg: 
      sudo sh /private/tmp/deploy_splashtop_streamer.sh -i "/private/tmp/Splashtop_Streamer_Mac_DEPLOY_INSTALLER_v3.4.0.0.dmg" -d XXXXXX  -w 0 -s 0
      OR 2 commands:
      cd /private/tmp
      ./deploy_splashtop_streamer.sh -i "./Splashtop_Streamer_Mac_DEPLOY_INSTALLER_v3.4.0.0.dmg" -d XXXXXX  -w 0 -s 0

    3. Click Save.
  7. Click the Scope tab and configure the scope of the policy to choose computers this should be installed on. If you intend to install this on all computers, you can choose “All Computers” from the drop down. Jamf Admins should understand their own scope standards.
  8. Click Save.

Note: May be helpful if you add Splashtop Team ID, CPQQ3AW49Y, to "Approved Kernel Extensions" for installing the Splashtop Sound driver

kext.png

Jamf reference article: Whitelisting Kernel Extensions

1 out of 4 found this helpful