Before using Custom Reports, you must install the Workspace ONE Intelligence Connector service (also known as ETL installer) onto a server. The Workspace ONE Intelligence Connector service collects data from your AirWatch database and pushes it to the cloud-based report service.

SaaS customers do not need to install their own Workspace ONE Intelligence Connector server. On-premises customers must install their own Workspace ONE Intelligence Connector server.

You must install the Workspace ONE Intelligence Connector service on its own server. For additional information about the installation process of other AirWatch application servers, refer to the VMware AirWatch Installation Guide.

Important:

If you upgrade the AirWatch database as part of the upgrade process, you must stop the Workspace ONE Intelligence Connector service during the AirWatch Database upgrade and restart the service after completing the upgrade process.

Important:

If you need to change the setting for Deployment Region, do not run the installer again.

To install the Workspace ONE Intelligence Connector service, take the following steps.

  1. Download the Workspace ONE Intelligence Connector installer on to the server you configured for the service.
  2. Run the installer. Select Next.
  3. Accept the Terms of Use and select Next.
  4. Ensure the Workspace ONE Intelligence Connector Service is selected as a feature to install. Select Next.
  5. The installer detects the version of Java installed on the application server. If the installer does not detect the required version, the required version installs. Select Next.
  6. Enter the Database server settings.

    Setting Description
    AirWatch Database server

    Select Browse next to the Database server text box and select your AirWatch database from the list of options. If you are using a custom port, do not select Browse. Instead, use the following syntax:  DBHostName,<customPortNumber>, then select Browse to select the database server.

    • For example: db.acme.com, 8043

    Application Authentication

    Select one of the following authentication methods.

    • Windows Authentication uses a service account on the Windows server to authenticate.

      You are prompted to enter the service account that you want to use. This service account is used to run all the application pools and AirWatch related services and therefore must have AirWatch Database access.

    • SQL Server Authentication uses the SQL server authentication method.

      You are prompted to enter the user name and password.

    AirWatch Database Name Enter the name of the AirWatch database or browse the SQL server and select it from a list.

    Select Next.

  7. Select the Destination Folder in which to install the Workspace ONE Intelligence Connector service. Select Next.
  8. Configure the Workspace ONE Intelligence Connector Service settings.

    Setting Description
    Deployment Region

    Select the region for your cloud service.

    Whitelist the api.ci.dpa0.org URL for all regions. The installer calls this endpoint for a list of all supported regions.

    Each option represents a region of the cloud service, selected based on the location of your enterprise data. United States (Sandbox) is for UAT environments.

    Ensure the right region is selected. Do not run the installer again if you need to change this region in the future.

    If you upgrade your Workspace ONE Intelligence Connector service from a previous version, this screen does not display because you cannot change your region during an upgrade.

    Supported regions and URLs you may want to whitelist:

    • United States (UAT environment)
      • sandbox.data.vmwareservices.com
      • api.sandbox.data.vmwservices.com
      • eventproxy.sandbox.data.vmwservices.com
    • United States (Production)
      • na1.data.vmwservices.com
      • api.na1.data.vmwservices.com
      • eventproxy.na1.data.vmwservices.com
    • Frankfurt
      • eu1.data.vmwservices.com
      • api.eu1.data.vmwservices.com
      • eventproxy.eu1.data.vmwservices.com
    • Ireland
      • eu2.data.vmwservices.com
      • api.eu2.data.vmwservices.com
      • eventproxy.eu2.data.vmwservices.com
    • Tokyo
      • ap1.data.vmwservices.com
      • api.ap1.data.vmwservices.com
      • eventproxy.ap1.data.vmwservices.com
    Installation Token

    Enter your AirWatch Installation Token.

    This token is created as part of the AirWatch Installation process. For more information, see the VMware AirWatch Installation Guide (VMware provides this document to you as part of the on-premises installation process).

    Select Next.

  9. Select Install to install the Workspace ONE Intelligence Connector service. Once installation completes, select Finish.

For information on setting up the wizard for the Workspace ONE Intelligence Connector service, see Run the Custom Reports Wizard.