Distribute macOS installer

How to deploy the adaptiva macOS client with Microsoft Intune.

Overview

You can easily add the Adaptiva macOS client installer as a macOS app (PKG) in Microsoft Intune. This will distribute the client to macOS devices and configure their connection to the Adaptiva server.

If you are using a SaaS instance, the installation configuration will differ. Skip to the instructions for a SaaS client deployment using Intune.

Access the Adaptiva Client

The Adaptiva Client is available from the Installation folder of the installation media. You can download the latest release from the Product Releases section of the Adaptiva Support Portal.

Create macOS App

1. Log into the Microsoft Intune admin center (https://intune.microsoft.com) using the account with the appropriate role assignment.

2. In the left-hand navigation pane, click Apps, then click All Apps.

   
3. Click + Add.

4. In the Select app type pane, click the App type drop-down.

5. Under the Other app types, select macOS app (PKG).

   
6. Click Select to open the Add App steps.

Select the app package file

1. On the App Information pane, click Select app package file.

   
2. In the App package file pane, select the Browse button. Browse to the path where the installation files were located and select the adaptiva-client-<version>-macOS.pkg file. Click Open. The app details are displayed.

3. Click OK on the App package file pane to add the app.

4. On the App information page, update the properties with these and any other values as appropriate. These are user facing values.

   

   • Name and Description: Update the name and description to user friendly values.

   • Publisher: Adaptiva

5. Complete any addition app information and click Next.

6. On the Program page, enter the following Post-install script:

   #! /bin/bash
   sudo /opt/adaptiva/adaptivaclient/bin/adaptivactl setup -server <hostname> -server-guid <guid>

   • Update the configuration script with any valid parameters. See the adaptivactl command line parameters reference for details.

   
7. Click Next.

8. Click the Minimum operating system drop-down and select macOS Ventura 13.0.

   
9. Click Next.

10. On the Detection Rules tab, ensure Yes is selected for ignore app version. Update the App Version to the version listed in the name of the .pkg file.

11. Click Next.

12. On the Supersedence and Scope tags tabs, click Next.

13. On the Assignments tab, configure assignments for the following groups. Assignments do not need to be entered right now; they can be entered later.

    

    Add a group to Required to force the installation.

    Add a group to Available for enrolled devices to make the installation optional via the Company Portal app. When adding a group to Available, the group must contain Users, not Devices.

    Add a group to Uninstall for managed devices to have this app removed.

14. Click Next.

15. Review the App information and click Create.

SaaS Client Deployment using Intune

If you are using a SaaS instance, you can access the macOS installation script (adaptiva-client-<version>-install-unix.sh) from the Cloud Admin Portal.

If the Authorization token is updated, you must re-download the installation script and update your macOS script. See these instructions if the authorization token is updated.

1. Log in to your cloud tenant and click the settings gear > Settings > Client Downloads. Download the macOS Client installation script to an accessible location.

2. Log into the Microsoft Intune admin center (https://intune.microsoft.com) using the account with the appropriate role assignment.

3. In the left-hand navigation pane, click Devices.

4. Under By platform, click macOS. Then under Manage devices, click Scripts.

   
5. Click + Add.

   
6. On the Basics page, enter a Name and Description for the script policy, then select Next.

7. On the Script settings page, click the Browse button. Browse to the path where the macOS install script is located and select the adaptiva-client-<version>-install-unix.sh file. Click Open. The script details are displayed.

8. Configure the following script settings:

   • Run script as signed-in user: No

   • Hide script notifications on devices: Not Configured

   • Script frequency: Not Configured, this will run the script only 1 time.

   • Max number of times to retry if script fails: Not Configured.

   
9. Select Next.

10. On the Scope tags tab, click Next.

11. On the Assignments tab, configure assignments for the following groups. Assignments do not need to be entered right now; they can be entered later.

    

    Add a group to Included groups to install the client on these devices.

    Add a group to Excluded groups if necessary.

12. Click Next.

13. Review the script information and click Add.

If authorization token updated

1. On the macOS | Scripts page, select the previously created script.

2. Under Manage, click Properties.

3. In the details pane, next to Settings, click Edit.

4. Click the Browse button, and browse to the updated .sh file. Click Open.

5. Click Review + save.

6. Review the script information and click Save.