Remote Mass Deployment on macOS Clients Using Jamf Pro

Prerequisite: Download and unpack the macos_agent_x64.tar.gz (or macOS x64 Client Installation (.tar.gz+.ini) installation package archive into any folder on the macOS system.

Follow the instructions below to deploy on Clients running the macOS 10.x (Catalina) or macOS 11.x (Big Sur) versions of the operating system.

Creating a Device Profile

To add a device profile, do the following:

1. In the navigation pane on the left, select Computers > Configuration Profiles, and then click the Upload button in the top right.

2. In the Upload OS X Configuration Profile pop-up window that opens, click the Choose File button, and then select one of the following (depending on the version of macOS that the deployment is required for):

• For macOS 11.x (Big Sur) or macOS 12.x (Monterey) versions, select the EkranClient/remote deploy/Profiles for Jamf/Ekran System Client macOS 11.x.mobileconfig file.

• For macOS 10.x (Catalina) versions, select the EkranClient/remote deploy/Profiles for Jamf/Ekran System Client macOS 10.x.mobileconfig file.

    

3. Click the Upload button.

4. Select the Scope tab, then click the Add button on the right and select those computers where you want to install mobileconfig, and then click the Save button in the bottom right.

    

Uploading Files to Jamf Pro

To upload the Ekran System installation package, do the following:

1. Click the Settings () button in the top right, then select Computer Management in the navigation pane on the left, and click the Packages () icon.

    

2. On the Packages page that opens, click the New button in the top right.

    

3. On the New Package page that opens, under Filename, click the Choose File button, and select the EkranClient/EkranSystemClient-<version>.pkg file, then click the Save button in the bottom right.

    

To upload the postinstall script, do the following:

1. Click the Settings () button in the top right, and then select Computer Management in the navigation pane on the left, and click the Scripts () icon.

    

2. On the Scripts page that opens, click the New button in the top right.

    

3. On the New Script page that opens, enter a name for the script.

    

4. Select the Script tab.

    

5. Copy the contents of the EkranClient/remote\ deploy/postinstall.sh script file from the installation package into the Script Contents field.

    

Instead, if the EkranClient folder in the macOS installation package contains a .ini file, copy the contents of the EkranClient/remote\ deploy/postinstall_ini_file_support.sh script file into the Script Contents field, and then copy the contents of the settings.ini file into the SETTINGS_INI_FILE_DATA variable to replace the DATA value in the Script Contents field, and Steps 6 and 7 (below) should then be ignored.

 

6. In the script, change "X.X.X.X" to the hostname or the IP address of the Ekran System Application Server to be connected to.

7. If you need to install the Client on a specific tenant, in the script text, change "90807A10-DF80-45EA-A7DE-A550B55F548A" to your tenant key.

NOTE: In Multi-Tenant mode, the tenant key can be copied from the Management Tool (on the Tenant Management page) by the administrator of the default tenant. If you do not change the tenant key, the Client will be installed on the built-in default tenant.

8. Select the Options tab, and then in the Priority drop-down list, make sure After is selected, and click the Save button in the bottom right to save the script.

    

Creating a Policy

To add a policy, do the following:

1. In the navigation pane on the left, select Computers > Policies, and then click the New button in the top right.

    

2. On the New Policy page that opens, enter a name for the policy in the Display Name field, and then in the Trigger section, select the Recurring Check-in checkbox.

    

3. In the navigation pane on the left, select Packages (), and then click the Configure button in the Configure Packages pane that opens.

    

4. Click the Add button next to the required package.

    

5. In the Action drop-down list, make sure Install is selected, and then click the Save button in the bottom right.

    

6. In the navigation pane on the left, select Scripts (), and then click the Configure button in the Configure Scripts pane that opens.

    

7. Click the Add button next to the required package.

    

8. In the Priority drop-down list, make sure After is selected, and then click the Save button in the bottom right.

    

9. Select the Show in Jamf Pro Dashboard checkbox in the top right.

    

10. After creating the policy, the agent installation will start after 15 minutes (by default). You can view the installation progress on the Jamf Pro Home page, on the Dashboard, under Policy Statuses.