# Deploy clients with 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](https://learn.microsoft.com/en-us/windows/win32/msi/orca-exe) is a free tool available from Microsoft and is part of the Windows SDK.

## Create a Transform File (MST)

Download and install the latest [Windows SDK](https://developer.microsoft.com/en-us/windows/downloads/windows-sdk/).

Follow these steps to create a Windows Installer transform file (MST) using Orca.

1. Open Orca, 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.

   ![](https://1238239958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzBcNZqjCKqgdpA83eD4o%2Fuploads%2Fgit-blob-e41d3f3477c0b1d4e8b355764464ae20a5824798%2Forca.png?alt=media)
4. In the Property table, modify the following values:

   * **SOURCEUNCPATH** = `<Path to the Adaptiva installer>`
   * **SERVERNAME** or **SERVERIP** = `<FQDN>` or `<IP Address>` of the Adaptiva Server

   If you are using the Cloud Relay service, set the following properties:

   * **CLOUDRELAY**=`1`
   * **SERVERGUID**=`<GUID>`
   * **PASSWORD**=`<password>`

   If you are using HTTP for client communications, set the following properties:

   * **SERVERURL**=`<ServerURL:port>`
5. Click **Transform > Generate Transform** and save the MST file.
6. Close the Orca tool.

## Create a File Share

1. Create a content source folder as follows:

   `<Drive>:<Path>\Adaptiva\Client`
2. Copy the Adaptiva Client MSI and MST files into the Client folder.
3. 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 a Group Policy Object

1. Open Group Policy Management and create a new or edit an existing GPO.

   ![New GPO](https://1238239958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzBcNZqjCKqgdpA83eD4o%2Fuploads%2Fgit-blob-1945dcaf66a653a2388344d9a259bd18248e0ec6%2Fgpm-new-gpo.png?alt=media)
2. In the Group Policy Management Editor, expand **Computer Configuration > Policies > Software Settings**.
3. Right-click **Software installation** and select **New > Package**.

   ![Software installation](https://1238239958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzBcNZqjCKqgdpA83eD4o%2Fuploads%2Fgit-blob-2d93906a4211833a0598424448207b34481396f5%2Fgpo-new-package.png?alt=media)
4. In the **Open** dialog, navigate to the Adaptvia Client share location and select the `adaptiva-client-p2p-<version>-windows.msi`.
5. In the **Deploy Software** dialog, select **Advanced** and then click **OK**.

   ![](https://1238239958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzBcNZqjCKqgdpA83eD4o%2Fuploads%2Fgit-blob-c78ed9347fd736ebc4baade645c44ed89eb24de6%2Fdeploy-software-advanced.png?alt=media)
6. In the Adaptiva Peer to Peer Client Installer Properties dialog, select the **Modifications** tab, and click **Add**.
7. Navigate to to the Adaptvia Client share location, select the MST file, and click **Open**.

   ![](https://1238239958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzBcNZqjCKqgdpA83eD4o%2Fuploads%2Fgit-blob-3ebeb2f0cd14c28975daa8490eb80c82cb42a645%2Fdeployment-modifications.png?alt=media)
8. Click **OK** and close the policy.
9. Target the group policy appropriately. Devices will install the Adaptiva Client at the next system restart.