Skip to content

Guides

Log in to Control Hub

To log in to Control Hub navigate to admin.webex.com and log in with the email and password provided to you.

Enable Remote Access for your company via Control Hub

To enable Remote Access feature in Control Hub for your company. Navigate to Device -> Settings in Control Hub, read the description of Remote Access and toggle on Enable Remote Access.

Remote Access

You also have the option to enable/disable Remote Access per device, refer to the documentation for that.

In case you want to activate it directly on a device using the xAPI the public xConfiguration that activates Remote Access is:

xConfiguration RemoteAccess Mode: On/Off

Access Local Device Controls from Control Hub

It’s important to note that the Local Device Controls, also known as the device's Web Interface can only be accessed from the same network as the device.

To access the local device controls first you have to navigate to the device's Overview page in Control Hub and find your device on the devices tab. To find out the name of the device in front of you check the top left corner of the device's home screen. Once you are on the device's page you can click on Launch on the Local Device Controls within the Support card as seen in the image below:

Local Device Controls

Press "Connect with Hostname" or "Proceed" and you will have access to the Local Device Controls hosted on the device.

Cross Launch Device Controls

If prompted, accept the risks

You are accessing a page hosted on the device, its safe to ignore the warnings from the browser and continue.

You will land on the home page of Local Device Controls of the device as seen in the image bellow:

Having access to this page opens up a series of options that will be useful for us in this lab. Such as:

  • On the home screen you will find the Developer API tab on the left where you can execute xCommands and xConfigurations directly on the device. This can be useful in case you want to control a call with xCommands for instance.
  • You also have the macro editor, where you can create your own macros in combination with UI Extensions. This will be useful for us in the integrator scenario where we will have to visit this page to fix our customizations.
  • Call tab. Useful in the call scenario where we will start a call from Remote Access. Remote Access is not supported during a call. The Remote Access session will end and you will be able to control the call from this tab on the Local Device Controls.
  • Remote Access from the Local Device Controls. You can give it a quick try! After that, end the session and navigate back to the home screen.
Configuration NetworkServices Websocket: FollowHTTPService

Using Remote Access from the Local Device Controls requires that the configuration NetworkServices Websocket is set to FollowHTTPService.

Using xAPI commands on Control Hub

  • To run an xAPI command on Control Hub log in to Control Hub follow the instructions from Logging into Control Hub. After that find your device and click on the device to reach the device's overview page. Here you will find an Action button with the option Run XCommand. From there you can run commands from RoomOS xAPI page directly on the device.

More at RoomOS xAPI page

Using xAPI commands on Local Device Controls webpage

  • To use Local Device Controls you need to be on the same network as the device.

  • To log in to the Local Device Controls follow the instructions from Access Local Device Controls from Control Hub. If you have a local user registered on the Local Device Controls you can also log in to Local Device Controls with that user by navigating to the device's IP address.

  • Go to Developer API on the home screen of Local Device Controls and run the xCommands.

More at RoomOS xAPI page

Get an Activation Code in CH

In Control Hub from the Devices Page click Add Device -> Shared Usage -> Next -> New Workspace. Here you can set any name for the workspace, then click Next -> Cisco Room and Desk Devices -> Next (there is no need to change anything). Click on Add Device to get the activation code. That activation code is what you’ll enter on the device.

Show me how to get the activation code in CH

alt text