Distribute full installer

Adaptiva recommends deploying the P2P installer in order to simplify deployment. If you are using a SaaS environment, use the P2P installer.

Overview

You can create a Windows app (Win32) in Intune to install the Adaptiva Client by publishing the adaptiva-client-<version>-windows.exe installer. This is the full Windows client installer for the Adaptiva Client available with your installation files.

Prerequisites

You will need to download and install the Microsoft Win32 Content Prep Tool to complete these steps.

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.

For users of the SaaS platform, you can access the P2P installer or cross-platform installation scripts from your tenant. Click the settings gear > Settings > Client Downloads.

However, to access the full client installer you will need to download and install the Adaptiva P2P client to gain access to the full Adaptiva client.

1. Follow these steps to download and install the Adaptiva P2P Client on a device.

2. On the new device, navigate to C:\ and show hidden folders.

3. Navigate to the hidden C:\AdaptivaCache\Client folder and copy AdaptivaClientSetup.exe to an accessible location.

Deploy the Full Client Installer

Microsoft Intune does not support .exe distribution, so you must create an .intunewin file and configure a Win32 App in Intune.

This process will download the full Adaptiva client (approx. 92MB) using Intune. It is recommended to use the P2P Client Installer method as that will only download 1Mb using Intune.

Create Intunewin File for Full Client Installation

Download and install the Microsoft Win32 Content Prep Tool.

1. Create a content source folder as follows:

   <Drive>:\<Path>\Adaptiva\FullClient

2. Copy the adaptiva-client-<version>-windows.exe from the installation source into the FullClient folder.

3. Open a command prompt at the intunewin tool folder and run the following command:

   Intunewinapputil -c "<Drive>:\<Path>\Adaptiva\FullClient\" -s adaptiva-client-<version>-windows.exe -o "<Drive>:\<Path>\Adaptiva\FullClient\"

   • The installer name will be AdaptivaClientSetup.exe if you sourced it from a SaaS-based client.

4. The <executable_name>.intunewin will be created in the FullClient folder.

Create Intune App for Full Installer

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 + Create.

4. In the right pane, select the App type drop-down.

5. Under Other, select Windows app (Win32).

   
6. Click Select.

7. The Add App pane appears.

   
8. Click Select app package file.

9. In the right pane, click on the folder icon.

   
10. Browse to the path with the .intunewin file you created using the winapputil tool: <Drive>:\<Path>\Adaptiva\FullClient and select the <executable_name>.intunewin file. Click Open.

11. The right pane will be updated with the package file details. Click OK.

12. Under the App Information step, 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

13. Update the other fields as necessary and click Next.

14. On the Program tab, enter the following:

    

    • Install command:

      Since you are installing from Intune, you should include the -CloudRelay and -ServerGUID parameters, which enables the client to use the Cloud Relay Service to connect when off-premises. SaaS customers will need the -Password parameter, but will not need the -CloudRelay parameter.

      adaptiva-client-<version>-windows.exe -InstallorUpgrade -ServerName *AdaptivaServer.FQDN* -CloudRelay -ServerGUID <GUID> [-Password and other optional parameters]

    • Uninstall command: adaptiva-client-<version>-windows.exe -uninstall

    • Install behavior: System

    • Device restart behavior: No specific action.

15. Click Next.

16. On the Requirements tab, click Yes. Specify the systems the app can be installed on.

17. Click to select the Install on x86 system and Install on x64 system checkboxes.

18. Select the Minimum operating system your organization supports.

19. Complete any additional requirements as needed.

    
20. Click Next

21. On the Detection Rules tab, click the Rules format drop-down and select Manually configure detection rules.

    
22. Click + Add

23. In the right-hand pane, click the Rule type dropdown and select Registry.

    
24. Create the following rule:

    

    • Key path: HKEY_LOCAL_MACHINE\Software\Adaptiva\Client

    • Value name: slm.version

    • Detection method: Value comparison

    • Operator: Less than

    • Value: 10.1.972.12

    • Associated with a 32-bit app on 64-bit clients: No

25. Click OK.

26. Click Next.

27. On the Dependencies tab, click Next.

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

29. 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.

30. Click Next.

31. Review the App information and click Create.