Groups

1. What are groups?

Groups are admin-defined groups of devices that share the same content (apps and files) & settings (like Wi-Fi network and launch method). If you add or remove an app or file to or from a group, that app or file will be added/removed from all devices within the group. Likewise, if you change a group's setting such as the launch method, that launch method will be applied to all devices in the group. 

Groups only support a single device type. For example, you cannot add both Pico Neo 2 devices and VIVE Focus Plus devices to the same group. Additionally, devices cannot be assigned to multiple groups simultaneously. 

2. How can I create groups?

  1. In the side navigation menu select Create a Group.
  2. Enter a name for the group.
  3. Specify the Device Type that will be added to this group (i.e., whether group will be used to manage Pico Neo 2 devices, HTC VIVE Focus Plus devices, etc.).
  4. Click Create Group.
  5. You will now be directed to the group's overview page and see the group as a menu item listed beneath Devices.


3. How can I add devices to a group?

Once you have paired devices to ArborXR, you have two options for assigning devices to a group.

Option 1: Group Overview Page

  1. Navigate to the group in question.
  2. Click Add Devices.
  3. Select devices then click Add. 
This modal will filter out incompatible device types along with devices that have already been added to the group.

Option 2: Device Index Page

  1. Navigate to the All devices page.
  2. Select relevant devices.
  3. Click Assign to Group.
    1. If you have multiple device types selected (e.g. Pico Neo 2 devices and VIVE Focus Plus devices), select one of the device type options from the dropdown that appears on clicking Assign to Group.
  4. Select the relevant group.
  5. Click Assign.
If any of the selected devices are already in a group and you select to reassign them to a different group, the content and settings of the new group will be applied. 


4. How can I add apps to a group? 

Once you have uploaded apps to ArborXR, have two options for assigning apps to a group.

Option 1: Group Overview Page

  1. Navigate to the group in question.
  2. Tab over to Apps & Files.
  3. Click Add Apps.
  4. Select relevant apps and specify the version of the selected apps.
    • If you do not manually specify a version, the latest available version of the selected app(s) will be deployed to the group. For more information on version management see this article.
  5. Click Add to Group.
This modal will filter out apps already added to the group.

Option 2: Content Library Page

  1. Navigate to the Apps page which is beneath Content Library in the side navigation menu.
  2. Select relevant apps and specify the version of the selected apps.
    • If you do not manually specify a version, the latest available version of the selected app(s) will be deployed to the group. For more information on version management see this article.
  3. Click Add to Group.
    • If you have multiple apps selected each with different device compatibility, select one of the device type options from the dropdown that appears on clicking Add to Group.
  4. Select the relevant group(s).
  5. Click Add.


5. How can I add files to a group? 

Once you have uploaded files to ArborXR, have two options for assigning files to a group.

Option 1: Group Overview Page

  1. Navigate to the group in question via the side navigation menu.
  2. Tab over to Apps & Files.
  3. Click Add Files.
  4. Select relevant files.
  5. Click Add to Group.
This modal will filter out files already added to the group.

Option 2: Content Library Page

  1. Navigate to the Files page which is beneath Content Library in the side navigation menu.
  2. Select relevant files.
  3. Click Add to Group.
  4. Select the relevant group(s).
  5. Click Add.


6. How can I track the status of content deployments to devices in a group?

The status of content deployments to a group of devices can be tracked in real time via the status column in the  Apps & Files tab of a device group. Hover over the status column to see the count of devices the app or file is pending to deploy to, actively installing on, or successfully installed on. Click View Details for even more information. 

If any of the devices within a group are powered off or are offline when apps & files are added or removed, they will process and proceed with the install or uninstall job the next time they come online and connect to ArborXR's servers.  


7. How can I change the launch method of devices in a group?

ArborXR offers three launch methods:
  1. Device Home Environment: This is the device's default launcher (what you normally see when putting on the headset) and the default launch method. While in this launch method, end-users have access to all apps and settings on this device.
  2. Kiosk Mode: This launch method allows only one app (the "kiosk" app) to be launched when powering on a device. This locks down the device and prevents end users from accessing other apps. 
  3. Multi-app LauncherThis is a A 2D app launcher that displays a grid of apps installed via ArborXR. This allows the end user to launch into apps themselves while preventing them from accessing non-ArborXR installed apps on the device.

To change the launch method on the devices within a group:

  1. Navigate to the group in question.
  2. Tab over to Settings.
  3. Select Launch Method from the sub navigation menu.
  4. Select between Device Home Environment, Kiosk Mode or Multi-App Launcher.
    1. If you select Kiosk Mode, click Select Kiosk App to "whitelist" the kiosk app then click Apply and Save.
    2. If you select Multi-App Launcher, click Select Launcher Apps to "whitelist" applications that should appear for end users then click Apply and Save.


8. How can I deploy a Wi-Fi configuration to devices in a group?

For devices running build 2021.27.0 (or later) of the client app, ArborXR offers Wi-Fi configuration functionality where you can create and configure a library of Wi-Fi networks, then remotely deploy the configuration to devices to allow them to connect to the networks.

ArborXR supports the configuration and remote deployment of open networks, WPA, as well as the personal and enterprise modes for both WPA2 and WPA3. For the enterprise modes various encryption protocols and authentication types are supported, including certificate-based authentication. For more information on supported Wi-Fi network configurations please see this article
  1. Navigate to the group in question.
  2. Tab over to Settings.
  3. Select Wi-Fi from the sub navigation menu.
  4. Click Add Configuration to open the Wi-Fi management modal.
    1. If you have configured Wi-Fi network(s) previously, those will show in the Library tab where you can select one or more listed Wi-Fi configurations then click Add.
    2. If you do not have Wi-Fi networks configured, or if you need to add a new one, tab over to Create New, enter your Wi-Fi network's details, then click Add.
  5. On clicking Add, devices will be provisioned with (and automatically connect to) the new network the next time they come online and connect to ArborXR's servers.


Have a suggestion or feature request? We'd love to hear!
Message ArborXR


Still need help? Contact Us Contact Us