Configure a pull service v1.0 relay server using a Linux FTP, Explicit FTPS, Implicit FTPS (Pull only), SFTP file server, or HTTPS server for use with product provisioning and staging. The pull service must be installed before you integrate the server with the Workspace ONE UEM console.

Prerequisites

  • An FTP, Explicit FTPS, Implicit FTPS in Pull configuration (Android only), or SFTP server. Only Android supports Implicit FTPS relay servers.
  • Linux-based servers must run either CentOS or SLES 11 SP3.
  • Only x86 64bit architecture is supported.
  • Java 8+ must be installed on Linux-based servers.
  • The pull relay server requires outbound network access on https 443 to the Workspace ONE UEM console
  • Each server requires disk storage of 2 MB for the pull server installer and hard disk space for all the content pulled to the server.

Procedure

  1. Configure an FTP, Explicit FTPS, Implicit FTPS (Pull only), SFTP file server, or HTTPS server.
    You must create an FTP/HTTP user with read/write/delete permissions for both the directory and the files used in the relay server. Note the home directory of the user for use in configuring the pull service.
    This FTP user must have a user name and password for authentication.
  2. Navigate to Groups & Settings > All Settings > System > Enterprise Integration > Pull Service Installers.
  3. Download the Linux Pull Service Installer and the Configuration file onto the server using your preferred server management system.
  4. Open the XML config file and update the following.
    1. Set the install directory for the pull service, found inside the libraryPath tags. This location does NOT have to match the root directory of the file server.
    2. Set the FQDN or IP address of your Workspace ONE UEM console server with /contentpull appended to it. This configuration is found inside the endPointAddress tags.
    cn274.awmdm.com
    <PullConfiguration>
    <libraryPath>C:\AirWatch\PullService\</libraryPath>
    <endPointAddress>https://[endpoint URL]/contentpull/</endPointAddress>
    </PullConfiguration>
  5. In the command prompt, enter the command.
    sudo ./LinuxPullServerInstaller.bin
    Alternatively, enter the following command to install silently.
    sudo ./LinuxPullServerInstaller.bin -i silent
  6. Follow the instructions prompted by the installer, including the optional configuration of a proxy server.
    1. If you want to use a proxy server, supply the host, port, and authentication information when prompted.
  7. Validate the pull service configuration.
    • SaaS Customers (or customers whose Global OG is unavailable)
    • On Premises Customers
    1. For SaaS Customers (or for customers without access to the Global OG), you can skip this validation step. Proceed to Results.
    2. For On Premises Customers, log into the Workspace ONE UEM console at the topmost organization group, Global.
    3. Navigate to Devices > Provisioning > Relay Servers > Undiscovered Pull Relay Servers.
    4. If the new Linux-based Pull Relay Server displays in the listing by its Discovery Text, then you have successfully validated the pull service configuration.

Results

The installer looks for the PullserviceInstaller.config file in the installer execution directory. If the file is missing, the installer prompts you that the file is missing.