User Guides > JIBB Room > Cisco Device Installation (MTR Mode)

How to Install JIBB Room on a Cisco Device (MTR Mode)

This guide walks you through installing the JIBB Room App on a Cisco Room Series device running Microsoft Teams Rooms (MTR) mode, using the JIBB Admin Portal.

3D render of a meeting room where JIBB Room captures a bar chart from the whiteboard and streams it, alongside remote participants, onto the in-room video display.

Table of contents

1. Compatibility Requirements
2. Installing the JIBB Room App
3. Post Installation
4. JIBB Room Camera Preset
5. Microsoft Teams Sharing

1. Compatibility Requirements

Please make sure you check all of the following details before you start installing JIBB Room on your Cisco Device:
Important: Network Firewall/Proxy Health Check

As a crucial first step to ensure that your network environment is optimized for seamless integration, we recommend doing a quick network health check.

Full Guide
Step 1: Check JIBB Workspace Accessibility

Visit the Login Page:

  • Open your web browser on a desktop connected to the same network as your Cisco Device and go to https://app.jibb.ai/.
  • If you see the login page, proceed to Step 1. This indicates that your network allows access to JIBB Room, but it does not confirm full accessibility.
  • If you see a blank or error page, this could mean that your network settings, including firewalls or proxies, are blocking access to JIBB Room.

‍

Step 2: Verify JIBB Room API Accessibility

Access Developer API Tab in Local Device Controls:

  • Log in to Webex Control Hub.
  • Local Device Controls for the device you want to install JIBB Room onto.
  • Inside Local Device Controls, click on the Developer API tab.

‍Execute the following API Command:

“xCommand HttpClient Get ResultBody: None Url: https://app.jibb.ai/”

‍

Interpret the Results:

  • A message showing "1 of 1 applied successfully" with a green tick signifies that your network isn't blocking JIBB, and you can proceed with the installation of JIBB room. 
  • A response of "some commands were rejected" suggests that JIBB is likely being blocked by your firewall or proxy settings.

‍

‍

Step 3: Adjust Firewall / Proxy Settings

If either Step 1 or Step 2 indicates that JIBB Room is being blocked:

‍

  1. Whitelist Essential Domains:
  • Ensure the following domains are whitelisted in your firewall and proxy settings to allow smooth operation of JIBB Room on your network:
    • https://app.jibb.ai/
    • https://api.jibb.ai/
  1. If you're not sure how to adjust these settings, contact your IT administrator:
  • Provide them with the domains listed above and request that they ensure these are not blocked by your network’s firewall or proxy.

‍

1.1 - Device Operating System Requirements

‍

Key Points to Ensure Compatibility:

  • Latest Software Versions: Ensure your device is updated to the latest version of MTR Stable Channel for optimal performance and compatibility.
    • How to Check: In Control Hub under Devices > Software, you can see the different channels and how many devices in your organization are on which channel.

‍

1.2 - Network Settings & Device Admin Credentials

‍

Whenever you want to install JIBB Room on a device or update the App's configuration, please ensure you are connected to the same network as the device.

‍

You also need to have access to an active device admin username and password/passphrase, the device's IP address, and a valid JIBB Room license API key (more info below).

List titled 'Things you will need' with four requirements: same network as device, device admin credentials, device IP address, and JIBB License (API key), above a Cisco device with camera.
Accessing & Managing Local Device Usernames & Passwords:

‍

You need an active local device admin username and password to install JIBB Room onto your Cisco device.

‍

Confirm you have an active local admin username, password, and IP address for your Cisco device, and you're connected to the same network as the device. This step is crucial for a smooth installation.

‍

To access, create, or update a local user with an active admin role for your device, follow these steps:

  1. Log in to https://admin.webex.com.
  2. Go to Devices and select your device in the list.
  3. Launch Local Device Controls and go to Users.
  4. Add a new user and assign the admin role and set the status as Active.

‍

‍

‍

‍

2. Installing the JIBB Room App

Once you have checked the compatibility requirements above, you're ready to start installing JIBB Room onto your Cisco Room Series Device.

Please follow the instructions below to log in to the JIBB Admin Portal, add a Room device license, generate an API Key, and install the JIBB Room Macro on your Cisco Device:

JIBB Admin Portal login page with options to continue with Google or by entering an email and password.
Please note: You will need a JIBB Admin/Owner account to access the JIBB Admin Portal.
JIBB Admin Portal with an arrow pointing to the Room Device Macro tab.
Navigate to the Room Device Macro tab.
JIBB Admin Portal Room Device Macro tab with an arrow highlighting the option to add a device license.
Add a Room device license for the Cisco device you want to install JIBB Room on.
JIBB Admin Portal device list with an arrow highlighting the Key link beside a device.
Hover over your device and click "Key" to generate a JIBB Room API Key for it.
API key dialog in the JIBB Admin Portal with an arrow highlighting the Generate button.
Please note: If you generate a new API Key for a device you have already installed JIBB Room onto, the old key stops working and you will need to reinstall the app with the new key.
API key dialog with an arrow highlighting the button to copy the generated API key.
Tip: Copy the API Key into a secure location, such as a password manager. You won't be able to access it again once this window is closed.
JIBB Admin Portal showing two ways to install the Room Device Macro: Install Automatically and Install Manually.

You can either install the JIBB Room Device Macro automatically or manually.

‍

2.1 - Install Automatically
JIBB Admin Portal with an arrow highlighting the Install Automatically option.
Click "Install Automatically".
Configuration form in the JIBB Admin Portal for entering the device details required to install JIBB Room.
Enter the required details for your device.
JIBB Admin Portal configuration form with an arrow highlighting the Save button.
Click "Save".

You will see a "JIBB is ready" notification appear on the Room Navigator, along with the JIBB Room app icon, as soon as the macro is successfully installed.

‍

2.2 - Install Manually (Export / Import)
JIBB Admin Portal with an arrow highlighting the Install Manually option.
Click "Install Manually".
Install options dialog with an arrow highlighting the MTR mode selection.
Select MTR as your device mode.
Dialog with an arrow highlighting the button to download the JIBB Room macro files.
Download the macro files.
Cisco device web interface with an arrow highlighting the Macro Editor.
In your device's web interface, open the Macro Editor.
Macro Editor with an arrow highlighting the Import from file option.
Import each downloaded macro from file.
Macro Editor showing both imported macros with the Save action highlighted.
Save both macros.
Macro Editor with an arrow highlighting the toggle to activate only the jibb macro.
Activate only the jibb macro.

‍

‍

3. Post Installation

After installing the JIBB Room App on your device, follow these instructions to test the app or make any changes.
3.1 - Make sure you clicked 'Save'

When using the configuration form to install JIBB Room, always remember to click "Save" when you're done, so the app is installed correctly.

‍

If you encountered any errors, please review the steps above or contact support@jibb.ai.

Instruction card reminding to click 'Save' with tips to check device admin credentials and JIBB API Key if the JIBB app is missing on the Room Navigator home screen.

If you can’t see JIBB Room on the Room Navigator home screen: 

‍

Check your JIBB Room API Key or generate a new one.

‍

‍

‍

‍

3.2 - Check the Room Navigator

You'll know JIBB Room is installed when the JIBB Room App icon is added to the Room Navigator touchscreen (or inside the Control Panel if your device is running on MTR mode).

‍

If you are updating the app after it's already installed, you'll see a "JIBB is ready" notification appear on the Room Navigator.

‍

3.3 - Removing JIBB Room from your device

If you've already installed JIBB Room using the method above and want to uninstall the app from your device so you can install it on another device using the same API Key, follow the instructions in this video.

‍

4. JIBB Room Camera Preset

In order for JIBB Room to automatically snap to your whiteboard every time someone uses the app, we strongly recommend creating a new Camera Preset position named "jibb" on your device.
4.1 - Aim, Set & Forget

On your Room Navigator, go to the manual controls and aim the camera at the meeting room whiteboard, zoom in or out, making sure it fits the whole writing surface inside the camera preview that will be displayed on the TV screen/monitor connected to your device.

An electronic device setup including a speaker with a camera, a tablet displaying an app, and a whiteboard showing a hand-drawn bar graph with three bars labeled A, B, and C.
You must name this new camera preset "jibb"

‍
‍Make sure you tap "Save". Once installed, the JIBB Room macro will use this preset to ensure that every time someone starts JIBB Room on the device, the camera will automatically snap to the whiteboard.

User interface showing a new camera preset named 'jibb' being saved with a finger pointing at the Save button on a touchscreen keyboard.

Watch the tutorial video to see how it's done.

‍

5. Microsoft Teams Sharing

Connect your Microsoft 365 tenant to JIBB to enable the Collaboration Assistant. It streamlines your MTR workflow by automatically posting the workspace invitation in the meeting chat, then sending the meeting summary and Comak link afterward.
JIBB Admin Portal with an arrow pointing to the Microsoft Teams Sharing tab.
Navigate to the Microsoft Teams Sharing tab in the JIBB Admin Portal.
Microsoft Teams Sharing tab with an arrow highlighting the Connect Account button.
Click "Connect Account" and sign in with your Microsoft 365 account.
Microsoft consent screen listing the permissions JIBB requests, with the Accept button.
Review and accept the requested permissions.
Microsoft Teams meeting showing the JIBB Collaboration Assistant posting a JIBB Meeting is Ready message with a Join Meeting link in the chat.
Once connected, the JIBB Collaboration Assistant automatically joins the meeting and shares the workspace invitation in the meeting chat.

‍

Still Need Help?

If you didn’t find the answer here or need help with something more specific, our support team is ready to assist. Use the options below to get personal support or raise an issue.

Contact Support
Headset with microphone resting on a desk alongside a keyboard, mouse, and notepad.