Plan for Workspace ONE integration

Whether your Workspace ONE configuration includes the Adaptiva Server and AirWatch Cloud Connector (ACC) installed on the same server, two separate servers, or each component completely isolated, Adaptiva OneSite provides integration options at installation. Workspace ONE uses the ACC to contact the Adaptiva Server.

Adaptiva recommends installing the Adaptiva Server and ACC on the same server. The SQL Server is also installed on this server. This ensures platform performance and security as there is no outside network access to the Adaptiva Server with all components installed on one server.

AirWatch Cloud Connector

Workspace ONE uses the ACC as a proxy to securely contact the Adaptiva Server by calling the Adaptiva APIs. The ACC must be installed before installing the Adaptiva Server. Install the correct version of the ACC. For more information, see Enable AirWatch Cloud Connector from the Workspace ONE console (Omnissa).

ACC Account and Permissions

Grant Adaptiva the ACC permissions to integrate the Adaptiva Server with Workforce ONE during the server installation.

Permissions	Account	Permission
ACC	AirWatch Service Account	Local Administrators group Minimum permissions: Registry Full Control access to the following paths: - HKLM\Software\Adaptiva - HKLM\Software\Microsoft\SystemCertificates File System Read access for the following Adaptiva DLLs file path: - C:\Program Files\Adaptiva

ACC Integration Options

Based on the security requirements for your site configuration, decide which of the integration options below works best for your organization. In all cases, Workspace ONE requires the ACC installed on a server to communicate with the Adaptiva Server.

• Adaptiva Server, the ACC, and the Adaptiva Server on the same server.

• Adaptiva Server is separate from the ACC.

• Adaptiva Server, the ACC, and the SQL Server are each on separate servers.

Adaptiva Server and the ACC on the same server

In this example, integrating the ACC and the Adaptiva Server on the same server is the simplest configuration and eliminates any network communications between the components.

AirWatch Cloud Connector co-hosted

Adaptiva Server separate from the ACC

In this example, the Adaptiva Server and the ACC are installed on different servers. This configuration is often with SQL Server Express installed with Adaptiva.

AirWatch Cloud Connector separate from Adaptiva

Adaptiva Server, the ACC, and the SQL Server each on separate servers

In this example, the AdaptivaServerSetup.exe, SQL Server, and ACC are completely separated, with each component installed on a different server. This enables the database administration team to maintain all databases on managed servers. This also provides for the use of Always On Availability Groups to cluster the SQL servers.

AirWatch Cloud, Adaptiva, SQL on separate server

Setting up the ACC

Enable the ACC in the Workspace ONE console, and then download the VSEC certificate to a designated installation path.

Install the ACC

1. If the ACC is already installed, navigate to the following file path to open the log file CloudConnect.log:

   %InstallPath%\Airwatch\Logs\CloudConnector

2. Search for Starting CloudConnector. The ACC must be version 19.7.0.0 or later.

3. If the ACC is not installed or if the ACC version is older than 19.7.0.0, open the Workspace ONE UEM console and navigate to Groups & Settings | All Settings | System | Enterprise Integration | Cloud Connector.

4. Select Download AirWatch Cloud Connector Installer.

5. Select Open File after the download has completed to start the installation.

6. In the UEM console, select Test Connection to verify if the ACC is active.

Download the vSEC Certificate

1. Open the Workspace ONE UEM console, and navigate to Groups & Settings | All Settings | System | Enterprise Integration | Peer Distribution | Adaptiva.

2. Select the Download vSEC Certificate link to download the certificate to a location on your computer. This will be used later.

   

   Download vSEC Certificate

Adaptiva Certificate for Workspace ONE Installation

After the Adaptiva Server setup is complete, you must return to the Workspace ONE UEM console to upload the Certificate on the Adaptiva Peer Distribution Software Setup page. Adaptiva automatically generates the AdaptivaServer.cer file and downloads it to a location on your computer during the Adaptiva Server installation.

Adaptiva APIs

The ACC communicates with the Adaptiva Server by calling the Adaptiva APIs. The ACC requires access to the Adaptiva DLLs to call the Adaptiva APIs. The .dlls act as a shared library of content that allows multiple components simultaneous access. Adaptiva recommends installing the .dlls on the server hosting the ACC.

Install the DLLs

1. Locate the Adaptiva installation files from downloaded .zip file.

2. Copy the file AdaptivaWorkspaceONEACCInstaller.exe from Installers or Windows to the ACC.

3. Right-click on the AdaptivaWorkspaceONEACCInstaller.exe, select Run as an administrator, and then select Yes (if prompted).

   

   Run Adaptiva Workspace ONE ACC installer
4. This opens the Installs Adaptiva DLLs To The Workspace ONE AirWatch Cloud Connector (ACC) dialog. The current installation status appears on the dialog.

   

   Install Adaptiva DLLs
5. Select Install, and then select Yes on the Are You Sure You Wish To Install Adaptiva DLLs? dialog.

6. Select OK on the Installation Was Successful dialog.

You are now ready to install the Adaptiva Server and integrate it with Workspace ONE.

Record the Location Details

• Record either the FQDN or the internal IP address of the Adaptiva Server.

• Record the location of the downloaded vSec certificate.

• Record the location of the Adaptiva Server certificate, which defaults to the following path:

  <path>\Adaptiva\Adaptiva Server\data\security