A Relay Server Cloud Connector (RSCC) is a hybrid solution that pulls content from a service endpoint and distributes it to your relay servers. This design initiates an outbound connection from your network to the VMware cloud to download content for distribution. An outbound connection represents a security advantage over other designs.

Prerequisites

Each server intended to be used as an RSCC conduit must adhere to the following hardware specifications. The quantity of servers you must configure depends upon the number of products you want to push at a time.

RSCC Server Hardware: CPU with 4 cores x 2 sockets (for a total of 8 vCPUs), 8GB RAM and 100 GB of free HD/SSD space (not including space required for the OS). The extra space is for the storage of files on RSCC.

Procedure

  1. Enable the PullServiceInstaller feature flag
    1. https//{server url}/api/system/featureflag/PullServiceInstallerFeatureFlag/{global-locationgroup-guid}/true
    2. for example, https//localhost/api/system/featureflag/PullServiceInstallerFeatureFlag/B36DE603-E05E-4E17-8DA5-B9760975BCBD/true
  2. Download the RSCC Installer
  3. Generate an Installer Certificate. Navigate to Groups & Settings > All Settings > System > Enterprise Integration > Pull Service Installers. Select the Generate button.
  4. Download the RSCC configuration file. If you are configuring RSCC for the first time, select the Download Configuration button.
  5. Place the installer and the configuration file in the same folder of the RSCC server.
  6. Run the RSCC Installer on each server you want to create.
    1. Run the installer and choose the installation path.
    2. Provide the password that was entered while downloading the certificate in step 3.
    3. Enable or disable proxy.
      • If disabled, proceed to the next step.
      • If enabled, then supply the Proxy Information including the Proxy Host name, port number, auth type with username and password.
    4. Enable or disable Custom Discovery Text.
      • If disabled, the Discovery Text becomes a combination of the server's IP address plus its MAC address.
      • If enabled, the Custom Discovery Text entered must be unique for each RSCC server.
    5. Select Install and complete the installation.
  7. System Code Changes (where are these located?)
    1. RelayServerCloudConnectorApplicableCommandRetrievalBatchSize: 2000
    2. RelayServerCloudConnectorMaxCommandQueueIteration: 1
    3. RelayServerCloudConnectorBatchSize: 50
  8. If you have more than one content pull endpoint, take the following steps to directly update the RSCC config file with the content pull endpoint URL.
    1. Login to each RSCC server machine
    2. Stop the RSCC service
    3. Navigate to the folder where RSCC is installed and locate the appsettings.json file.
    4. Edit the PullServiceURL field with the content pull URL. For example, https://vmware.bng.com/contentpull
    5. Navigate to c:\windows\system32\drivers\etc and edit the hosts file.
    6. Add the IP address and host name to the hosts file as shown.
      10.1.1.1 vmware.bng.com
    7. Save the hosts file.
    8. Restart the RSCC service.
  9. Pull up the list of Windows Services and stop the Content Delivery Service (CDS).
  10. Enable the RSCC feature flag (this step to be removed once the FF is on by default).
    1. https//{server url}/api/system/featureflag/RelayServerCloudConnectorFeatureFlag/{global-locationgroup-guid}/true
    2. for example, https//localhost/api/system/featureflag/RelayServerCloudConnectorFeatureFlag/B36DE603-E05E-4E17-8DA5-B9760975BCBD/true
  11. Add each RSCC server in the console one by one using this configuration.
    1. While logged into Workspace ONE UEM in the Global OG, navigate to Devices > Provisioning > Relay Servers > Undiscovered Pull Relay Servers.
    2. Copy (Ctrl-C) the pull discovery text. If the pull discovery text is not provided, then you must use the IP address from one of the RSCC machines (except 127.0.0.1) to create the relay server.
    3. Move to the OG in which you downloaded the RSCC certificate and navigate to Devices > Provisioning > Relay Servers > List View and select Add > Add Relay Server button.
    4. Complete the required text boxes, making sure Relay Server Type is set to 'Cloud Relay'.
    5. Switch to the Assignment tab and select the appropriate OG.
    6. Switch to the Pull Connection tab and complete all required text boxes, making sure you paste the discovery text (copied earlier) into the Pull Discovery Text text box.
    7. Select Save. Repeat a. through g. until each RSCC server is added.
  12. On the Relay Servers > List View page, activate each RSCC server by selecting its red toggle button, turning it to green.