JIBB Installation Guide for Cisco Devices

Follow the instructions on this page to learn how to add JIBB to your Cisco Room Series device, the optional features you can use, and how to get the most out of the JIBB app.

Watch the tutorial video below to get started

Table of contents

1. Compatibility Requirements

Please make sure you check the following details before installing JIBB:

Network Firewall/Proxy Healthcheck

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

Full Guide
Step 1: Check JIBB Web App 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 2. This indicates that your network allows access to JIBB, but it does not confirm full accessibility.
  • If you see a blank page or error page, this could mean that your network settings, including firewalls or proxies, are blocking access to JIBB.
Step 2: Verify JIBB API Accessibility

Access Developer API Tab in Local Device Controls:

  1. Log in to Webex Control Hub
  2. Local Device Controls for the device you want to install JIBB onto.
  3. 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 the JIBB app.
  • 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 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 on your network:
      • https://app.jibb.ai/
      • https://api.jibb.ai/
  2. 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.
Device Operating System Requirements

JIBB is now fully compatible with Cisco Devices running on both the latest Cisco RoomOS Stable Channel and Microsoft Teams Rooms (MTR) mode. Whether you prefer the native Cisco experience or the MTR interface, JIBB works seamlessly with your setup.

Key Points to Ensure Compatibility:

  • Latest Software Versions: Ensure your device is updated to the latest version of RoomOS/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 OS/channel.
Network Settings & Device Admin Credentials

Any time you want to install JIBB onto a device or update the app's configuration, please make sure you are connected to the same network the device is on.

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

2. Installing the JIBB App

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

Attn: Demo License Users

If you're installing JIBB using a demo license key, you will need to refer to the Demo License Installation Guide, which follows a slightly different process. If you have a JIBB Admin Account, continue below.

Please follow the instructions below to login to the JIBB Admin Portal, add a device, generate a JIBB API Key and complete the configuration form to install the JIBB App on your Cisco Device:
Please note: You will need to have a JIBB Admin/Owner account to access the JIBB Admin Portal.
Tip: If your device already has a name, such as "Board Room Camera 1", use the same name here in the JIBB Admin Portal so you know which devices you have already installed the JIBB App onto.
Once you've added your device, hover over it and click on "Key" to generate a JIBB API Key for that device.
Please note: If you generate a new API key for a device you have already added and installed JIBB onto, the old API Key will no longer be valid and you will need to reinstall the app with the new API Key you generated.
It is highly recommended that you copy this API Key into a word document or somewhere secure, as you will no longer be able to access the API key again once it is copied and this window is closed.
Accessing & Managing Local Device Usernames & Passwords:

You need an active local device admin username and password to install JIBB 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 or 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.

For more detailed instructions, refer to this Cisco user guide.

‍

3. Post-Installation

After installing JIBB, follow these instructions to test the app or make any changes

Make sure you clicked 'Save'

When using the configuration form to install the app, always remember to click "Save" when you're done in order for the app to be installed correctly.

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

Check the Room Navigator

You'll know JIBB is installed when the JIBB 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.

Removing the JIBB App from your device

If you've already installed JIBB 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 Camera Preset

In order for JIBB 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.

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.

If you're using a Device running on MTR mode, please watch and follow the instructions in the second video tutorial.

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