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.
Create the JSON auth file
⚠️ IMPORTANT: The batch configuration package must include a JSON auth file containing an access token generated from the ArborXR organization you wish to enroll the devices into. |
Navigate to organization Settings, select Access Token in the top right, then click Create Access Token.
Enter a title, check the Batch Configuration checkbox, then click Create.
Copy the token value before closing.
Open a text editing tool like Notepad.
Input the text below into the text editing tool.
{
"personalAccessToken": ""
}Paste the token value generated from ArborXR in step 3 between the double quotation marks
"".Save the file with the filename ArborXR-Configuration.json.
Open the batch configuration package creator in VIVE Business Device Management System
Log into the VIVE Business Device Management System here.
From the side menu, navigate to Manage Devices.
Select Batch Configuration.
Select VIVE Focus 3.
In the top right hand corner, click Create New to open the five step batch config creator.
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 |
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.
Provision devices with the batch configuration package
Download the batch configuration package then unzip it.
Copy the RichuImage.zip and key directly to the root folder of the microSD card.
Unbox and power on the VIVE Focus 3.
Connect to a WiFi network and follow the steps in the headset to get to the HTC home environment.
Insert the microSD card into the device.
Initiate a factory reset by navigating to Settings > Advanced > Reset device > Reset.
Upon powering on after the reset, the device will begin provisioning itself with the contents of the batch configuration package.
Once the device completes provisioning, and provided it is connected to WiFi, 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. |