Connecting to the Edge Server

You can configure Vocera Voice Server to connect to the Edge Server for enabling Voice users to call Edge app users.

Vocera Edge, a cloud-based communication solution for smartphones, provides caregivers with the ability to enhance care team mobility and efficiency at the point of care through effective, reliable, clinical workflows. With Vocera Edge, nurses can document to the EHR while receiving filtered, prioritized alarm and task notifications. Physicians can easily locate and communicate with the nurse and team members supporting their patients, saving time with each connection.

To connect to the Edge Server, perform the following steps:

  1. Shut down the Vocera Voice Server on the standby server.
  2. Request the Edge Server Admin to share the Edge production URL and create a new Secret Key in the Edge Server for the new on-premises Voice Server.
  3. Use the shared values to create a property file called edge-datasync.properties in the <vocera-drive>\vocera\server\conf folder as in the following example:
    # Specify the Edge server service URL (Required)
    vocera.datasync.edge.serviceURL=<Edge_Server_URL:8131>
    
    # Client secret key (Required)
    vocera.datasync.edge.clientSecret=XXXXXX 
    
    # Following are optional properties
    # Prefix Edge usernames with "edge-", true or false.
    # Default is false
    vocera.datasync.edge.prefixUserID=
    
    # Use TLS, true or false
    # Default is true
    vocera.datasync.edge.useTLS= 
    
    # Specify how long to back off after repeated reconciliation errors.
    vocera.datasync.edge.errorBackoffTiming.1 =
    vocera.datasync.edge.errorBackoffTiming.2 =
    vocera.datasync.edge.errorBackoffTiming.3 =
    vocera.datasync.edge.errorBackoffTiming.4 =
    vocera.datasync.edge.errorBackoffTiming.5 =
    vocera.datasync.edge.errorBackoffTiming.6 = 
    vocera.datasync.edge.errorBackoffTiming.7 =
    # 30, 60, 120, 180, 300, 480, 600 are the default timings to back off after repeated reconciliation errors 
    Note:

    Specifying the service URL and client secret key is mandatory for starting the service. You can leave all other fields empty to take the default values. Backoff timings start at 30, 60, 120, 180, 300, 480, and 600 seconds respectively.

  4. Start the standby server.
  5. Failover the Voice Server to make it active.

    Now the Voice Server on the active server makes a connection to the Edge server and starts reconciliation. Users from the Edge server will be synced to the Voice server under a permission only group called 'edgeusers.' The auto forwarding option is set for all the Edge users on the Voice side, which is a prerequisite to work the Voice to Edge calling.

    Note:

    Any manual changes in the 'edgeusers' group or the auto forwarding on the edge users are not recommended.

  6. Create the edge-datasync.properties file in the active server as well following the Steps 1-3.