How to Troubleshoot the VMI Connection

Most problems with the VMI connection are due to entering the IP address of the Vocera Voice Server or cluster incorrectly. You cannot solve this problem by editing the value of the environment variable alone. To troubleshoot this issue, you must also delete the IP address list from the database and set up the VMI connection again.

Note: Before you begin, double-check to make sure that your system has an available VMI license. An unavailable VMI license also prevents you from establishing the VMI connection.

To troubleshoot an incorrect IP address:

  1. Update the value of the VOCERA_SERVER_IP_ADDRESS environment variable to the correct IP address or cluster list.
    If necessary, review the information in How to Set Up the VMI Connection to understand how to edit the environment variable.
  2. Disable the MySQL "Safe Updates" preference to allow you to update the database easily:
    1. Use the Windows Start menu to launch MySQL Workbench.
      Figure 1. The MySQL Workbench Main Window MySQL Workbench
    2. Choose Edit|Preferences from the menu.
      The Workbench Preferences dialog box appears.
    3. Select SQL Queries in the menu of the Workbench Preferences dialog box.
      Figure 2. The SQL Queries Preferences SQL Queries Preferences
    4. Uncheck Safe Updates and click OK.
      The Workbench Preferences dialog box closes.
  3. Delete the incorrect IP address from the database as follows:
    1. In the MySQL Workbench Main Window, double-click Local Instance MySQL.

      The Connect to MySQL Server dialog box appears.

      Figure 3. The Connect to MySQL Server dialog box Connect to MySQL Server
    2. Enter the password vocera and click OK.
      The Local Instance MySQL dialog box appears.
    3. In the Schemas section of the dialog box, navigate to evs|Tables|configuration.
      Figure 4. Editing the Database Schema Editing the Database Schema
    4. Right-click configuration and choose Select Rows.

      The first row in the configuration table appears. This row contains the value of the Vocera Voice Server IP address.

      Figure 5. Editing the Configuration Table Editing the Configuration Table
    5. Right-click the first row and choose Delete Row(s).
      The editor marks the first row of the configuration table for deletion and removes it from the display.
    6. Click Apply.

      The Apply SQL Script to Database dialog box appears.

      Figure 6. Apply SQL Script to Database dialog box Apply SQL Script to Database dialog box
    7. Review the SQL statement in the Apply SQL Script to Database dialog box and click Apply.

      The editor displays the message "Applying SQL script to database..." and deletes the row from the configuration table.

      Figure 7. Applying SQL Script Applying SQL Script
    8. Click Finish.
      The Apply SQL Script to Database dialog box closes.
    9. Close MySQL Workbench.
    The value of the VOCERA_SERVER_IP_ADDRESS environment variable is removed from the database.
  4. Restart the Vocera EVS Service.
    The EVS application writes the value of the Vocera Voice Server IP address list to the database again.
    Note: If necessary, review the information in How to Set Up the VMI Connection to understand how to restart the EVS service.