In this article

  1. Overview

  2. Create the JSON auth file

  3. Open the batch configuration package creator in VIVE Business Device Management System

  4. Batch configuration package creation steps

  5. Provision devices with the batch configuration package


1. Overview

ArborXR worked closely with HTC to enable HTC's batch configuration method to install ArborXR's Client and Home apps to the VIVE Focus 3 and silently enroll these devices to the respective customer's ArborXR organization.

While customers can use ArborXR's Device Setup App to setup devices, HTC's batch configuration is an optional alternative device setup method.


2. Create the JSON auth file

⚠️ IMPORTANT: The batch configuration package must include a JSON auth file containing the credentials of a user in your ArborXR organization to ensure devices are associated to your ArborXR organization. While ArborXR offers multi-organization support, the user whose credentials are inputted into the JSON auth file cannot be a part of any other organizations. We suggest creating a dedicated user strictly for device setup and assign them the role Device Setup App User.

  • Copy and paste the text contained in the blue box below to Notepad (or a similar text editing tool).

  • Input the email (i.e. username) and password of a user in your organization between the quotation marks.

  • Leave clientContentChannelId and launcherContentChannelId exactly as is.

  • Save the file with the filename ArborXR-Configuration.json.

{ 
"authentication": {
"username": " insert username here",
"password": " insert password here"
},
"clientContentChannelId": "d5124812-edea-4fb1-9193-286fb8dc10bb",
"launcherContentChannelId": "0011e200-d8e2-4048-a8dc-d0cbee2eb356"
}

3. Open the batch configuration package creator in VIVE Business Device Management System

  1. Log into the VIVE Business Device Management System here.

  2. From the side menu, navigate to Manage Devices.

  3. Select Batch Configuration.

  4. Select VIVE Focus 3.

  5. In the top right hand corner, click Create New to open the five step batch config creator.


4. Batch configuration package creation steps

Step 1: Set Permissions and Enroll Devices

  • Under Device Permissions, we recommend leaving the default selected.

  • Under Enroll Devices to VIVE Business Device Management System, we recommend selecting No as this ensures devices receive system updates automatically and are not restricted to only receiving system updates via the VIVE Business Device Management System.

Step 2: Choose Device Settings

  • General, Network, Boundary, Camera Settings, Advanced, and Customized Sign-In Header should be configured according to your organization's needs.

  • Under When installing the batch configuration package*, check the Store batch configuration package on device box if you would like to save the batch configuration package to the device. If checked, the saved configuration will be re-applied to the device in the instance of a factory reset.

Step 3: Select Apps and MDM Solution

⚠️ IMPORTANT: While VIVE Business Device Management System says this step is optional, this step is required by ArborXR as it ensures your devices are associated to your ArborXR organization

  • Under Upload, upload the apk for ArborXR Home which can be downloaded here. You can learn more about ArborXR Home here.

  • Side load, Corporate, Licensed Content, and Preloaded should be configured according to your organization's needs.

  • Under Mobile Device Management (MDM) Solution:

    • Upload the ArborXR client apk which can be downloaded here.

    • Under Credentials configuration file (Optional), upload the JSON auth file. ArborXR-Configuration.json.

Step 4: Enable and Set Kiosk Mode Options

  • Leave VIVE's Kiosk Mode disabled so you can take advantage of ArborXR Home or Kiosk Mode.

  • The other settings under this step should be configured according to your organization's needs, though we recommend leaving Show System Tutorial and Show cinematic opening when play tutorial unchecked.

Step 5: Publish and Activate Package

  • Optionally add a description for the batch config package then click Publish.


5. Provision devices with the batch configuration package

  1. Download the batch configuration package then unzip it.

  2. Copy the RichuImage.zip and key directly to the root folder of the microSD card.

  3. Unbox and power on the VIVE Focus 3.

  4. Connect to a Wi-Fi network and follow the steps in the headset to get to the HTC home environment.

  5. Insert the microSD card into the device.

  6. Initiate a factory reset by navigating to Settings > Advanced > Reset device > Reset.

  7. Upon powering on after the reset, the device will begin provisioning itself with the contents of the batch configuration package.

  8. Once the device completes provisioning, and provided it is connected to Wi-Fi, it will appear in the ArborXR web portal, thereby indicating the enrollment was successfully completed.

⚠️ IMPORTANT: DO NOT place the RichuImage.zip and key in any subfolders on the microSD card. The device will not be able to detect them.

Did this answer your question?