Deploy clients with Intune

You can use Microsoft Intune to deploy the Adaptiva Client to your devices. You will need to download and install the Microsoft Win32 Content Prep Tool to complete these steps.

You can create a Windows app (Win32) in Intune to install the Adaptiva Client using one or both of the methods below:

• (Recommended) Distribute the Peer-to-Peer (P2P) installer by publishing the adaptiva-client-p2p-<version>-windows.msi installer.

• Distribute the full client installer by publishing the adaptiva-client-<version>-windows.exe installer.

Distribute the P2P Installer

Windows installers are deployed by Intune as a Line-of-business(LOB) Apps, which will install the Adaptiva client in the User context. To install the app in the Device content, you must create an .intunewin file and configure a Win32 App in Intune to install the app correctly.

When you distribute the Win32 App, devices will download and run the 1MB adaptiva-client-p2p-<version>-windows.msi from Intune. The device will then look for a peer on the local subnet to access the full client installer. If not found, the installer will download it either from a server share or an internet accessible share.

For any Intune clients on the internet, you need to host the full client install (adaptiva-client-<version>-windows.exe) in a cloud storage container or CDN accessible to clients over the internet. Clients that are on-premises will download the client from a peer.

Share the Installer On-Premises

Create a network share for on-premises users to access the Adaptiva Client Installer.

1. Create a content source folder as follows:

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

2. Copy the adaptiva-client--windows.exe from the Adaptiva installer files in \Adaptiva\AdaptivaClient\Bin.

3. Share this folder on the server as AdaptivaClient with the following permissions:

   Share permissions: Everyone: Read

   NTFS permissions: Domain Computers: Read & Execute, List folder contents, Read

Share the Installer on the Internet

Create an internet accessible share using any cloud storage or CDN provider. Copy the full adaptiva-client-<version>-windows.exe installer to this cloud storage container and ensure that you provide an appropriate access policy or token to allow clients to access it.

Create Intunewin File for P2P Installer

Download and install the Microsoft Win32 Content Prep Tool.

1. Create a content source folder as follows:

   <Drive>:\\<Path>\Adaptiva\P2PClient

2. Copy the adaptiva-client-p2p-<version>-windows.msi from the installation source into the P2PClient folder.

3. Open Notepad and create an install.cmd command for your appropriate installer:

   • For the OneSite Patch SaaS installer:

     %windir%\system32\msiexec.exe /I adaptiva-client-p2p-<version>-windows.msi /qn WAITFORCOMPLETION=1

   • For the on-premises installer:

     %windir%\system32\msiexec.exe /I adaptiva-client-p2p-<version>-windows.msi /qn WAITFORCOMPLETION=1 CLOUDRELAY=1 SERVERNAME=%1 SERVERGUID=%2 SOURCEURLS=%3 %4 %5

4. Save this file as Install.cmd in the P2PClient folder.

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

   IntuneWinAppUtil.exe -c <Drive>:\<Path>\Adaptiva\P2PClient -s Install.cmd -o <Drive>:\<Path>\Adaptiva\P2PClient

Create Intune App for P2P Installer

Perform the following in Microsoft Intune.

For more information on distributing line of business apps using Microsoft Intune, see https://learn.microsoft.com/en-us/intune/intune-service/apps/apps-win32-app-management.

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 your .intunewin file: <Drive>:\<Path>\Adaptiva\P2PClient and select the install.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:

      • For the OneSite Patch SaaS installer:

        install.cmd

      • For the on-premises installer:

        install.cmd [ServerFQDN] [ServerGUID] [CDN_URL] [Password=Secret] [Additional parameters as required]

      Parameters need to be in the same order as defined in Install.cmd. Be sure to replace with the specific server information.

    • Uninstall command:

      %windir%\system32\msiexec.exe /i adaptiva-client-p2p-<version>-windows.msi UNINSTALL=1

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

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

    
24. Create the following rule:

    

    MSI product code: Enter the version of the Adaptiva Installer

    MSI product version check: 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.

Distribute 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 is the same process that Adaptiva will use to automate the creation of apps, but it will not have the connection to Adaptiva to download the content via Adaptiva technologies.

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 Installer

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\"

4. The AdaptivaClientSetup.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 your .intunewin file: <Drive>:\<Path>\Adaptiva\FullClient and select the install.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:

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

      Include the following switches as required if the Cloud Relay service or if HTTP client communications will be used:

      • Cloud Relay service: -CloudRelay, -ServerGUID <GUID>, -Password <auth. Secret>

      • HTTP communications: -ServerURL <ServerURL:port>

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

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 exists

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

    For clients that are on the internet that already have Adaptiva installed, use the Detection method Version comparison, operator: Equals, Value: Enter the version being installed, e.g. 9.3.968.16

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.