Room Connection Status Monitoring/Management

Monitor and manage your Room's connection through the Room's STATUS page that is found under the Room's CONNECTION tab.

Access a Room's STATUS page as follows:

  1. Log in to the Tehama Web UI.
  2. Click on the ROOMS tab.
  3. Click on the name of the Room you want to access. You will see the Room's interface. The tab you will see depends on the role you have within your organization.
  4. Click on the CONNECTION tab.
  5. Click on the STATUS sidebar item.

The STATUS page provides the following capabilities:


View a Room's status

The Admin user, the Org Managers and all Room members from any of the organizations in a Room can see the Room's status.

View your Room's status as follows:

  1. Access the Room's status page.
  2. Look at the top of the page. The Room's connection status is displayed in a status box found at the top of the page.

Status values are:

  • Creating room or Built (for 'Internet Only' network access mode)
  • Pending Gateway Connection, Creating room, Connected or Disconnected (for 'Tehama Gateway' network access mode)

You will not see the status box if your Room has 'Internet Only' network access mode and the building of your Room's infrastructure has not yet been triggered. The Admin user and Org Managers and Room Managers (who are members of the Room) of the owner+connected or connected-only organization in the Room should see a BUILD button to trigger the build.

NOTE: The Status column in the Rooms list under the ROOMS tab will show if the Room is Connected Disconnected, Pending, Deactivated or Archived.


View a Room's region

The Admin user, the Org Managers and all Room members from any of the organizations in a Room can see the Room's region.

A Room's region is the data storage location in which the Room's infrastructure is provisioned. Tehama offers access to data storage locations in different geographical regions around the world. Room regions are selected when the Room is created and cannot be changed.

View your Room's Region as follows:

  1. Access the Room's status page.
  2. Look for the Room's Room Region field, which is found just under the status box at the top of the page.

View a Room's network access setting

The Admin user, the Org Managers and all Room members from any of the organizations in a Room can see the Room's network access setting.

View your Room's Network Access setting as follows:

  1. Access the Room's status page.
  2. Look for the Room's Network Access field, which is found just under the Room region near the top of the page.

Network Access options are:

  • Internet Only
    When set to 'Internet Only', your Room's 'connected network' is a set of applications and services in the cloud constrained by your Room's firewall settings.
  • Tehama Gateway
    When set to 'Tehama Gateway', your Room's 'connected network' is a private network managed by the Room's connected organization (as well as desired resources in the cloud), constrained by your Room's firewall settings. A Tehama Gateway must be installed in the private network. (See the Tehama Gateway User Guide for more information on Tehama Gateways.)

Change a Room's network access setting

Only the Admin user and Org Managers and Room Managers (who are members of the Room) of a Room's connected organization (owner+connected or connected-only) can change the Room's network access setting.

It is not possible to change the network access setting of a Room that has Domain Join enabled. It must remain set to "Tehama Gateway". See the Room Domain Join User Guide for a description of the feature.

Change the Room's network access as follows:

  1. Access the Room's status page.
  2. Look for the Room's Network Access field, which is found just under the status box at the top of the page.
  3. Click the CHANGE link next to the Network Access field. The CHANGE NETWORK MODE dialog will appear.
  4. Select the network access option you want from the dialog - either 'Internet Only" or "Tehama Gateway'. (See above for a description of the options.)
  5. Click the CONFIRM button in the dialog to proceed (or the CANCEL button in the dialog to dismiss the change). The CONFIRM NETWORK MODE confirmation dialog will appear.
  6. Click the CONFIRM button in the confirmation dialog to proceed (or the X in the confirmation dialog to dismiss the change and return to the CHANGE NETWORK MORE dialog).

View a Room's router IPs

The Admin user, the Org Managers and all Room members from any of the organizations in a Room can see the Room's router IPs.

View the details for your Room's router IPs as follows:

  1. Access the status page.
  2. Look for the following field(s) found below the status box and the Network Access field (and also below the 'Multiple Gateways' field, if that feature is enabled for your Room).

    • If your Room has 'Network Access' set to 'Internet Only', then you will see:
      • the Room IPs field:
        • These are the IP addresses of machines in the Room's infrastructure that support connectivity.
  • If your Room has 'Network Access' set to 'Tehama Gateway', then you will see:
    • the Room's IPs

      These are the IP addresses of machines in the Room's infrastructure that support connectivity. You must ensure that the Tehama Gateway(s) in your private network can reach these IPs at the ports shown through your network's firewall.

    • the Room's Ports

      These are the ports used in the hosts in the Room's infrastructure that support connectivity.


View a Room's 'Multiple Gateways' setting

The Admin user, the Org Managers and all Room members from any of the organizations in a Room can view the Room's 'Multiple Gateways' setting.

This option is only available if your Room has 'Network Access' set to 'Tehama Gateway'.

Note on the Multiple Gateways Feature:

The 'Multiple Gateways' feature provides redundancy for a Room's network access when the selected network access mode is 'Tehama Gateway' and the feature is enabled. It allows you to provision a second Tehama Gateway, which you must install in your network's infrastructure. The two Gateways will run simultaneously.

The 'Multiple Gateways' option is an added expense for your Room.

Access to this feature is not offered by default. Contact Tehama Support to arrange for access to this feature in your Room. Or you may enable access to this feature through the Room Settings interface. See the Enable/Disable Multi-Gateway section in the Rooms User Guide.

Options for the Multiple Gateways setting are Enabled or Disabled.

  • When disabled, your Room will provide network connectivity through one Tehama Gateway, installed in your private network.
  • When enabled, the Multiple Gateways feature allows you to install a second Tehama Gateway in your private network on a different host from the first. With the 'Multiple Gateways' feature enabled, network connectivity to your Room will be maintained if one of the Tehama Gateways crashes. This can be enabled/disabled by the organization that owns the Room and viewed by the Room's connected organization.

View your Room's 'Multiple Gateways' setting as follows:

  1. Access the Room's status page.
  2. Look for the Multiple Gateways field below the Room's status box and Network Access field. (If you do not see this field, then the feature is not enabled for your Room. See the Note on the Multiple Gateways Feature above. When the toggle is 'on', the feature is enabled. Otherwise, it is disabled.

Enable/Disable the 'Multiple Gateways' option for a Room

Only the Admin user and Org Managers and Room Managers (who are members of the Room) of a Room's owner organization (owner+connected or user+owner) can enable/disable the Room's 'Multiple Gateways' option.

See the Note on the Multiple Gateways Feature above.

This option is only available if your Room has 'Network Access' set to 'Tehama Gateway'.

The 'Multiple Gateways' option requires additional ports to be opened. Before enabling the option, see the firewall configuration options in the Firewall Configuration section in the Tehama Gateway User Guide. Each configuration option lists the ports you must open to support the 'Multiple Gateways' option.

The 'Multiple Gateways' option is an added expense for your Room.

Enable the Multiple Gateways option for your Room as follows:

  1. Access the Room's status page.
  2. Look for the Multiple Gateways field below the Room's status box and Network Access field. (If you do not see this field, then the feature is not enabled for your Room. See the Note on the Multiple Gateways Feature above.)
  3. You should see a toggle next to the Multiple Gateways field. (If you do not see this toggle then you do not have permission to change the setting.)
  4. Verify that your current Tehama Gateway instance has version greater or equal to 4.0.4. An Incompatible Gateway icon icon will be visible next to the 'Multiple Gateways' toggle to alert you should your Gateway not have the minimum required version.
  5. Click on the toggle in the Multiple Gateways field. The ENABLE MULTIPLE GATEWAYS dialog will appear.
  6. Be sure that you want to incur the cost of this option and that you are prepared for some downtime (approximately ten minutes) for your Room while it modifies its infrastructure to support the option.
  7. Click ENABLE in the dialog.

    NOTE: There will be downtime, approximately ten minutes, (e.g.: a loss of connectivity from the existing gateway to your Room) while the Room modifies its infrastructure to support multiple gateways.

  8. Proceed to install/activate a second Tehama Gateway once the 'Multiple Gateways' setting is enabled as follows:

Disable the Multiple Gateways option for your Room as follows:

  1. Access the Room's status page.
  2. Look for the Multiple Gateways field below the Room's router IP/port information.
  3. You should see a toggle next to the Multiple Gateways field. (If you do not see this toggle then you do not have permission to change the setting.)
  4. Click on the toggle in the 'Multiple Gateways' field. The DISABLE MULTIPLE GATEWAYS dialog will come up.
  5. Be sure that you want to reduce your connections to one and that you are prepared for some downtime for your Room (approximately ten minutes) while it modifies its infrastructure to remove support for the option.
  6. Select the Tehama Gateway instance you want to remove.
  7. Click DISABLE.

    NOTE: There will be downtime, approximately ten minutes, (e.g.: a loss of connectivity from the remaining gateway to your Room) while the Room modifies its infrastructure to remove support for multiple gateways.


View/Regenerate a Room's access key

Only the Admin user and Org Managers and Room Managers (who are members of the Room) of a Room's connected organization (owner+connected or connected-only) can view/regenerate/copy/download the Room's 'Access Key'.

This option is only available if your Room has 'Network Access' set to 'Tehama Gateway'.

The Room's Access Key is used to configure the connection to the Room for all the Tehama Gateways provisioned in the Room.

To view/regenerate the Access Key for your Room see the steps found in the View/Regenerate an Access Key section of the Tehama Gateway User Guide.


View the table of Tehama Gateway(s) for a Room

Only the Admin users and Org Managers and Room Managers (who are members of the Room) of a Room's owner organization and of its connected organization (owner+connected or user+owner and connected-only) can view the Room's Gateway table.

This option is only available if your Room has 'Network Access' set to 'Tehama Gateway'.

View the Gateway table for your Room as follows:

  1. Access the Room's status page.
  2. Look for the table of Tehama Gateways at the bottom of the STATUS page. There will be one entry for each Tehama Gateway connection provisioned for your Room. (If you do not see the table then you do not have permission to see the Gateway info in this Room - and remember that the table is only visible when 'Network Access' is set to 'Tehama Gateway'.)

Each entry provides:

  • the IP of the host machine of the Tehama Gateway.

  • the version of the Tehama Gateway.
    If an update is pending or in progress, text indicating that will be displayed next to the version.

  • the status of the Tehama Gateway's connection to your Room:

    • Connected no issues icon

      indicates the Gateway is successfully connected to the Room and is the latest available version and is successfully connected to the Room.

    • Connected warning icon

      indicates that the Gateway is successfully connected to the Room but is not the latest available version.

    • Connected error icon

      indicates that the Gateway is successfully connected to the Room but failed to update to the latest available version (after three attempts).

    • Disconnected error icon

      indicates that the Gateway is not connected to the Room. (It may or may not be the latest available version.)

  • a menu of actions that can be performed on the Tehama Gateway, depending on its current status, such as:

    • 'Update':

      This action is available when the Gateway is not the latest available version. Select this action to display a dialog listing the details of the latest available update. See the "Update a Room's Tehama Gateway" section below for how to trigger the update. See the Tehama Gateway User Guide's update section for more comprehensive details on how to update a Gateway.

    • 'Show error':

      This action is available when the Gateway is not connected to the Room or when an attempt to update the Gateway failed. It displays the error text in a dialog.


Update a Room's Tehama Gateway

Only the Admin user of a Room's connected organization (owner+connected or connected-only) can update one of the Room's Gateways.

This option is only available if your Room has 'Network Access' set to 'Tehama Gateway'.

Update a 'Tehama Gateway' for your Room as follows:

  1. Access the Room's status page.
  2. Look for the table of Tehama Gateways at the bottom of the STATUS page. There will be one entry for each Tehama Gateway connection provisioned for your Room. (If you do not see the table then you do not have permission to update a Gateway in this Room - and remember that the table is only visible when 'Network Access' is set to 'Tehama Gateway'.)
  3. Locate the entry for the Tehama Gateway instance that you wish to update.
  4. Examine the status for the Gateway under the Status column. (See the description of the different Gateway statuses in the "View the table of Tehama Gateway(s) for a Room" section above.)

    Note, you may need to refresh the page to see most current status.

    When the status indicates that the Gateway is not the latest available version, you will find the 'Update' action under the three vertical dots menu in the Actions column.
  5. Select the 'Update' action under the three vertical dots menu in the Actions column. You will see a dialog listing the details of the latest available update.
  6. Pick an opportune time (i.e.: when your Room is not busy) to perform the update.
  7. Click UPDATE in this dialog to trigger the update.

See the Tehama Gateway User Guide's update section for more comprehensive details on how to update a Gateway.


Build an 'Internet Only' Room

Only the Admin user or Org Managers and Room Managers (who are members of the Room) of a Room's connected organization (owner+connected or connected-only) can trigger the build of the Room when its network access is set to 'Internet Only'.

This option is only available if your Room has 'Network Access' set to 'Internet Only' and the building of your Room's infrastructure has yet to be triggered.

You will incur the cost of the Room when the Room's infrastructure begins to build.

Build your 'Internet Only' Room as follows:

  1. Access the Room's status page.
  2. Look for the BUILD button at the bottom of the page.
  3. If you are willing to accept responsibility for the cost of the Room, click the BUILD button to proceed.