Adaptiva.comSupport

Deploy clients

You can deploy the Adaptiva client to your systems using most application deployment methodologies. This article walks through how to install the client using Group Policy and Microsoft Intune.

Client Installation using Group Policy

Deploying software through Group Policy cannot use the standard command line syntax. The properties that are set via the command must be set in a Windows Installer transform file. A variety of tools are available that can be used for this task. Orca is a free tool available from Microsoft and is part of the Windows SDK.

Create an MST

To create the MST with Orca, follow these steps:

  1. In Orca, in the menu bar, select File | Open and select the adaptiva-client-p2p-<version>-windows.msi.

  2. In the menu bar, select Transform | New Transform to create a new transform file.

  3. Select the Property table in the Tables list on the left.

  4. At a minimum, modify SOURCEUNCPATH and either SERVERNAME or SERVERIP

    IMPORTANT: Include the following properties as required, if the Cloud Relay service will be used:

    Cloud Relay service: CLOUDRELAY=1, SERVERGUID=<GUID>, PASSWORD=<password>

    or if using HTTP client communications

    HTTP communications: SERVERURL=<ServerURL:port>

  5. In the menu bar, select Transform / Generate Transform and save the transform file. Then Close the Transform.

Create File Share

  • Create a content source folder as follows:

<ContentSource-Drive>:<Path>\Adaptiva\Client

Copy the MSI and MST files into the Client folder

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

    Share permissions: Everyone: READ

    NTFS permissions: Domain Computers: Read and Execute, List, Read

Create Group Policy Object

  1. To create the group policy, open the Group Policy Management snap-in and create a new or edit an existing GPO.

  2. In the Group Policy Management Editor, expand Computer Configuration | Policies | Software Settings then right-click the Software installation node.

  3. In the context menu, select New | Package.

  4. In the Open dialog, navigate to the share location where the MSI is stored and select the adaptiva-client-p2p-<version>-windows.msi.

  5. In the Deploy Software dialog, select Advanced and then click OK.

  6. In the Adaptiva Peer to Peer Client Installer Properties dialog, select the Modifications tab, and click the Add button to select the MST file.

  7. Once complete, click OK to save the policy.

  8. Target the group policy appropriately. Computers targeted will run the install at next system restart.

Client Installation using Intune

When integrating OneSite with Intune, the Adaptiva Client will need to be deployed to target devices.

A Windows app (Win32) can be created for either one or both of the client installation methods below

  • (Recommended) Distribute the Peer-to-Peer client installer by publishing the AdaptivaP2PClientInstaller.msi

  • Distribute the full client by publishing the AdaptivaClientSetup.exe

P2P Client Installer

Windows installer files can only be deployed via Intune as a Line of Business App and as such will be installed as the User. To work around this, an .intunewin file will be created so the app can be installed correctly.

Because these are Intune clients, there is also the possibility they will be on the internet and not able to get to an on-premises server-based share. We need to host the AdaptivaClientSetup.exe in Azure. Clients that are on-premises will be able to download from a peer.

This process will download the 1MB AdaptivaP2PClientInstaller.msi using Intune. If the full client is not available on the local subnet, then it will be downloaded either from a server share UNC or from a web-based URL.

This process will download the P2P Client installer (approx. 1MB) using Intune. The full client will be downloaded from a peer on the same subnet or will be copied from the provided server share name or internet-based URL.

Complete the following prerequisites to deploy the Adaptiva P2P Client Installer to Intune clients

Share AdaptivaClientSetup.exe

Share this for the on-premises users

  1. Create a content source folder as follows:

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

Copy the AdaptivaClientSetup.exe from the Adaptiva server in \Adaptiva\AdaptivaClient\Bin

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

    Share permissions: Everyone: READ

    NTFS permissions: Domain Computers: Read and Execute, List, Read

Also, make it available for those that might be out on the internet

  1. Open a browser and connect to Azure (https://portal.azure.com) with an account with appropriate access to the Storage Account Container

  2. Select Storage Accounts, the Adaptiva storage account, Containers, the Adaptiva Container

  3. Click on Upload

  4. Click on the folder icon and browse to the Adaptiva installation media in the Installers folder and select AdaptivaClientSetup.exe and click Open then click Upload

  5. Click on AdaptivaClientSetup.exe to display its information

  6. Click on Generate SAS

  7. Update the Expiry date. This should be long enough until the next version is deployed.

  8. Click on Generate SAS token and URL.

  9. Copy the Blob SAS URL and make a note of the expiration date. This file will not be able to be downloaded using this SAS token after the expiry timestamp.

  10. Because this URL is really long, we need to make it shorter, use a favorite URL shortener. i.e. tinyurl.com. Copy and save the shortened URL with the original URL.

Create .intunewin file

The intunewin tool was downloaded earlier. Create a folder to hold the single installation

  1. Create a content source folder as follows:

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

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

  1. Open Notepad and enter the following:

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

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

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

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

Create Intune app

  1. Log into Endpoint Management (https://endpoint.microsoft.com) using the account with the appropriate role assignment

  2. Open the Apps blade and click All apps

  3. Click + Add. The following will be displayed on the far right pane, select the app type

Under Other, select Windows app (Win32)

![](media/install-platform/image80.png)

Click Select

  1. The Add app pane is displayed

  2. Click on Select app package file. The following will be displayed on the right

  3. Click on the folder icon and browse to the path with the .intunewin file: <ContentSource-Drive>:\<Path>\Adaptiva\P2PClient.

  4. Select the Install.intunewin file and click Open.

  5. The right pane will be updated.

Click OK.

  1. Update the rest of the App Information, as necessary.

    The properties that are starred are mandatory

    The Name field is what will display to the end-user. The other information is also available for the user to see. Make the following updates:

    Name: Update the name to a friendly name with spaces.

    Description: Write a friendly description

    Publisher: Adaptiva

    Update the other fields as required by the company's standards and click Next.

  2. On the Program tab

    Enter the following.

    Install command:

    install.cmd AdaptivaServer.adaptiva.com ServerGUID TinyURL [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

    Click Next

  3. On the Requirements tab

    Select the Operating System architecture: 32-bit and/or 64-bit

    Select the Minimum Operating system where the installation can occur

    Complete the rest of the fields as necessary

    Additional requirements can also be added

    Click Next

  4. On the Detection Rules tab

    Select the drop-down for Rules format and select Manually configure detection rules

  5. Click + Add

  6. In the right-hand pane the Detection Rule pane will be displayed

  7. Select the rule type MSI and enter the information

    MSI product code: Enter the Product code. E.g. This will change with every version.

    MSI product version check: No

    Click OK

    Click Next

  8. On the Dependencies tab

    Click Next

  9. On the Assignments tab.

    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

    All users or all devices can also be added

    Click Next

  10. Review the Summary information provided and click Create.

Full Client Installer using .exe

There is no application type that supports a .EXE, so we have to create a .intunewin file so it can be imported using the Windows app (Win32) type. 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.

Follow the steps below to create the .intunewin file and create the Intune app

Create .intunewin file

The intunewin tool was downloaded earlier.

  1. Create a folder to hold the single installation

  2. Create a content source folder as follows:

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

    Copy the AdaptivaClientSetup.exe from the Installation source into the FullClient folder

    • Open a command prompt to the folder where the intunewin tool is located

    • Type the following command or just run the command to be prompted:

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

    • The AdaptivaClientSetup.intunewin will be created in the FullClient folder

Create Intune app

  • Log into Endpoint Management (https://endpoint.microsoft.com) using the account with the appropriate role assignment

  • Open the Apps blade and click All apps

  • Click + Add. The following will be displayed on the far right pane, select the app type

Under Other, select Windows app (Win32)

Click Select

  • The Add app pane is displayed

  • Click on Select app package file. The following will be displayed on the right

  • Click on the folder icon and browse to the path with the .intunewin file: <ContentSource-Drive>:\<Path>\Adaptiva\FullClient

  • Select the .intunewin file and click Open

  • The right pane will be updated

Click OK

  • Update the rest of the App Information, as necessary.

The properties that are starred are mandatory

The Name field is what will display to the end-user. The other information is also available for the user to see. Make the following updates:

Name: Update the name to a friendly name with spaces. Remove the .exe

Description: Write a friendly description

Publisher: Adaptiva

Update the other fields as required by the company's standards

Click Next

  1. 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]

IMPORTANT: 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--windows.exe -Uninstall

Install behavior: System

Device restart behavior: No specific action

Click Next

  • On the Requirements tab

Select the Operating System architecture: 32-bit and/or 64-bit

Select the Minimum Operating system where the installation can occur

Complete the rest of the fields as necessary

Additional requirements can also be added

Click Next

  • On the Detection Rules tab

Select the drop-down for Rules format and select Manually configure detection rules

  • Click + Add

  • In the right-hand pane the Detection Rule pane will be displayed

  • Select the rule type Registry and enter the information

Key path: HKEY_LOCAL_MACHINE\Software\Adaptiva\Client

Value name: slm.version

Detection method: Value exists

NOTE: 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

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

Click OK

Click Next

  • On the Dependencies tab

Click Next

  • On the Assignments tab.

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

All users or all devices can also be added

Click Next

  • Review the Summary information provided and click Create

PreviousClient installNextCommunication ports

Last updated

Was this helpful?