Vocera Messaging Platform Administration Guide. Version 4.8

Transcription

1 Vocera Messaging Platform Administration Guide Version 4.8

2 Copyright Vocera Communications, Inc. All rights reserved. Protected by US Patent Numbers D486,806; D486,807; 6,892,083; 6,901,255; 7,190,802; 7,206,594; 7,248,881; 7,257,415; 7,310,541; 7,457,751; AU Patent Number AU B2; CA Patent Number 2,459,955; EEC Patent Number ED 7513; and Japan Patent Number JP 4,372,547. Vocera is a registered trademark of Vocera Communications, Inc. This software is licensed, not sold, by Vocera Communications, Inc. ( Vocera ). The reference text of the license governing this software can be found at The version legally binding on you (which includes limitations of warranty, limitations of remedy and liability, and other provisions) is as agreed between Vocera and the reseller from whom your system was acquired and is available from that reseller. Certain portions of Vocera s product are derived from software licensed by the third parties as described at Microsoft, Windows, Windows Server, Internet Explorer, Excel, and Active Directory are registered trademarks of Microsoft Corporation in the United States and other countries. Java is a registered trademark of Oracle Corporation and/or its affiliates. Android is a trademark of Google, Inc. Use of this trademark is subject to Google Permissions. BlackBerry is a registered trademark of BlackBerry in the United States and other countries. Apple, the Apple logo, iphone, Mac, and Mac OS are registered SM trademarks of Apple Inc. in the United States and other countries. App Store is a service mark of Apple Inc. Vocera Communications, Inc. tel :: fax :: :07:20 ii Vocera Messaging Platform Administration Guide

3 Contents Introduction... 9 The Vocera Messaging Platform... 9 Installation VMP Server Requirements Operating System Requirements... VMP MS SQL Server Requirements... Network Access Requirements... VMP Software... VMP System Accounts... VMP System Settings Installing the Vocera Messaging Platform Server VMP Server Installation Checklist... VMP Server Installation Worksheet... Installing the VMP Server... Configuring the VMP License... Updating the VMP Server... Installing a VMP Cluster... Updating a VMP Cluster... The Smartphone Proxy... Installing the Vocera Smartphone Proxy (VSP)... The VSP Configuration Utility Deploying VMP Deploying VMP Configuring Wireless Gateways Integrating with BlackBerry Enterprise Server Contents iii

4 Configuring the BES Server... Configuring the PIN Gateway... Configuring a BlackBerry Wireless Gateway with the Push API... The VMP PIN Gateway... Configuring the PIN Gateway... SNPP Gateways... Configuring an SNPP Wireless Gateway Importing Users and Contacts Active Directory User Synchronization... Configuring VMP for Active Directory... Importing Active Directory Users... Importing From an Excel or CSV File... Importing From SQL... Adding and Deleting Users Manually... Vocera Server Integration... Vocera Server Configuration... Importing Vocera Server... Configuring Notify Contacts... Monitoring With VMP Alerts... Configuring VMP to Vocera Server Paging Sending Installation Information to User Devices Configuring the VMP Server For Secure Connections Enforcing SSL on the VMP Server Data Encryption BlackBerry Enterprise Server Data Encryption... ios Server Data Encryption... Android Server Data encryption... Android C2DM Device Data Encryption... Password Enforcement Vocera Messaging Platform Failover Configuring Vocera Messaging Platform Failover VMP Server Failover Configuration Scenarios Configure Failover Notifications Establishing Health Monitoring on the VMP Server Establishing Health Monitoring on the VMP Server Post Failover Configuration Using SSL in a VMP Failover Environment iv Vocera Messaging Platform Administration Guide

5 VMP Server Log Files Remote Wipe Performing a Remote Wipe The VMP Administrator Console The VMP Administrator Console Standalone VMP Administrator Console Requirements Installing the VMP Administrator Console on a Standalone Server Using Active Directory Authentication Content Adding Content Editing Content Managing Content Distribution Lists Creating a Regular or On-Call Distribution List Creating an Escalation Distribution List Maintaining a Distribution List Messaging and Chat Chat... Initiating a Chat from the VMP Administrator Console... Viewing the Chat History... Notify Alerts... Sending a Notify Alert... Notify Alert Templates Alerts Creating Alerts... Managing Alerts... Alert Templates... Creating Alert Templates... Editing Alert Templates Alarms Defining Alarm Tones Creating and Managing Alarm Rules Contents v

6 Reports Creating Creating Creating Creating Incidents Reports... Logging Reports... Messaging Reports... Transmit Status Reports Users and Groups Editing User Information... Editing User Rights... Unlocking a User... Filtering the User Display... Groups... Adding and Deleting Groups... Adding Users to a Group... Granting Group Access... Group Profiles... Managing Group Profiles Contacts Importing Contacts From a Source... Manually Adding a New Contact... Creating a Contacts Distribution List... Managing Contacts Distribution List Access Configuration Defining Contact Fields... Editing Contact Fields... Editing User Fields... Plugin Configuration... Using the Plugin Configuration Module... Licensed Applications... System Options The VMP Web Console The VMP Web Console The Monitor View... Monitor View Features... Alert Templates... Web Console Alerts... Sending Alerts from the Web Console... vi Vocera Messaging Platform Administration Guide

7 Managing User Permissions Granting Existing Users Access to the VMP Web Console Granting Users Scheduling Permissions Allowing Users to View Monitor System Alerts Schedules Creating On-Call Schedules Web Console Contacts Using Web Console Contacts Appendices Server Sizing Matrix High-Level Sizing Recommendations... VMP Server CPU and Memory Recommendations... VMP Server Hard Drive Storage Recommendations... SQL Server Database Growth and Storage Recommendations Virtual Environment Support Port Requirements Internet Information Services (IIS) VMP Considerations High Availability for the BES Server Configuring VMP for a BES Cluster Web Console Refresh Rates Frequently Asked Questions Contents vii

8 viii Vocera Messaging Platform Administration Guide

9 Introduction The Vocera Messaging Platform (VMP) provides an enterprise messaging and alerting solution designed to address the unique communication challenges of healthcare. Users leverage the communication features from the smartphone client, a Web console, and the Vocera Badge. The platform runs on Windows Server 2005 or 2008 and integrates with Windows SQL Server 2005 and User data is imported from Active Directory, Vocera Server, BES, SQL, or EXCEL/ CSV data files. VMP administrators perform initial system configuration and ongoing system administration. Initial configuration tasks are managed from the VMP Enterprise Manager and the VMP Administrator Console. Administrative tasks are also managed from the VMP Web Console. VMP alerts can be delivered to a number of different devices, including BlackBerry, ios, and Android devices running VMP clients, or to cell phones via SMS. Pagers are also supported using the SNPP protocol. VMP has a SOAP-based API that external systems can use to send alerts and receive delivery statuses and responses to the alerts. In addition, alerts can be delivered to third-party systems using the WCTP protocol. VMP supports the WCTP protocol as an inbound and outbound protocol to allow third-party systems to initiate alerts through VMP using WCTP. This guide provides the following conceptual and task-based information: Introduction to the Vocera Messaging Platform Installation Deploying VMP The Vocera Messaging Platform The Vocera Messaging Platform (VMP) runs on Windows Server 2008 and integrates with other server systems. Introduction 9

10 The Vocera Messaging Platform Table 1. Integration Options System Integration Details Active Directory Server The VMP Server uses Active Directory to sync domain users with the VMP Administrator Console. SQL Server 2008 The VMP Server uses SQL Server to store all of the system data into a secure database. Users and Contacts can also be imported from an SQL database. BlackBerry Enterprise Server (BES) The VMP Server integrates with BES for all system data that is moving between the VMP Server and BlackBerry devices. The BES Server uses the BlackBerry Mobile Data Service (MDS) to securely transfer data between the VMP Server and the BlackBerry device using the RIM NOC as a gateway. The VMP connects to the RIM NOC network through HTTP(S). Apple Push Notification Service- The VMP Server integrates with APNS for all system data that is moving between the VMP Server and Apple ios devices. The APNS Servers are not hosted within a network. VMP connects to the APNS network through HTTP(S). Google Cloud Messaging Service (GCM) The VMP Server integrates with GCM for all messaging data that is moving between the VMP Server and Google Android devices. The GCM Servers are not hosted within a network. VMP connects to the GCM network through HTTP(S). Vocera Server The VMP Server integrates with the Vocera Server through a wireless connection within a network. Figure 1. The VMP Architecture 10 Vocera Messaging Platform Administration Guide

11 Installation This part of the manual describes the VMP Server system requirements, and describes how to install the VMP Server. VMP Server Requirements Installing the Vocera Messaging Platform Server Installation 11

12 12 Vocera Messaging Platform Administration Guide

13 VMP Server Requirements Before you begin your installation, make sure that the VMP installation server is running with at least 4GB RAM and 120 GB HDD and meets the requirements described here. Note: The VMP Server can be installed on a virtualized server running VMWare. For details about virtualization, see Virtual Environment Support. Operating System Requirements The following table lists the VMP Server operating system and software framework requirements. For details about server sizing recommendations, see Server Sizing Matrix. Table 2. Operating system requirements Item Requirement Operating System Windows Server 2008 SP2 64-bit Windows Server 2008 R2 64-bit Software Framework Microsoft.NET Framework 3.5 or later Best Practice: The VMP Server can run on a 32-bit system, but a 64-bit system is recommended for enterprise deployments. VMP MS SQL Server Requirements The following table lists the VMP MS SQL Server requirements. VMP Server Requirements 13

14 Network Access Requirements Table 3. SQL server requirements Item Requirement MS SQL Server MS SQL Server 2005 MS SQL Server 2008 SP2 MS SQL Server 2008 P2 MS SQL Server 2012 R2 MS SQL Server 2012 R2 SP1 Database Connectivity The SQL Server must be configured to enable: Remote Connections TCP/IP Name Pipes SQL Authentication Important: In addition to the supported platform requirements, SQL Server System Administrator (SA) credentials are required. The credentials are requested during the installation to connect with the SQL Server during the initial configuration. Network Access Requirements Prior to installation, make sure the following minimum network access requirements are met: Table 4. Network Access Requirements Requirement Details HTTPS connection SMS message aggregation requires an outbound HTTPS connection. BlackBerry Enterprise Server (BES) Access The installed VMP Server should have network access to the BES to send Push packets and import users and contacts. Make sure there are no firewall restrictions between the VMP Server and the BES. IIS Service The IIS World Wide Web Publishing Service must be turned off after VMP is installed on the server, and before using the VMP Web Console. For details, see Installing the VMP Server. 14 Vocera Messaging Platform Administration Guide

15 VMP Software VMP Software To install and deploy the VMP Server, you must have the following available on the installation server. A Windows Server that meets the minimum requirements (see Chapter 3, VMP Server Requirements), with the IIS Service running as described in Appendix C, Internet Information Services (IIS) VMP Considerations. The VMP installation files The VMP client installation files The VMP license file If you do not have these items ready for your installation, speak with your Vocera services representative before continuing with the installation. VMP System Accounts During the VMP Server installation, two system accounts are created on the associated SQL Server: wicapplication: This is the VMP system application account. wicauth: This is the user authentication account. The accounts are created automatically during platform installation. The installation wizard prompts for password credentials. VMP System Settings The following system settings must be provided during the VMP installation: Public host name or IP address for the VMP Server Internal host name or IP address for the VMP Server SMTP Settings Table 5. VMP SMTP Settings Setting Description Mail Server The Exchange server name or IP address. Use the.local prefix when the address is part of the domain name. Mail Server Port The port on which the Exchange server resides. Address The address for sending out installation communications and receiving server status updates. VMP Server Requirements 15

16 VMP System Settings Setting Description Use Authentication Enable the Use Authentication checkbox and enter the credentials, as these credentials are required to access the Exchange server. 16 Vocera Messaging Platform Administration Guide

17 Installing the Vocera Messaging Platform Server This chapter provides information about installing the Vocera Messaging Platform server. VMP Server Installation Checklist Use the following checklist to prepare for the VMP installation and deployment: The VMP installation server meets the minimum server requirements. See VMP Server Requirements. The VMP software and associated files are available on the installation server. See VMP Software. The IIS Service includes the.net framework (3.5 or later), and the IIS services are turned off on the installation server. See Appendix C, Internet Information Services (IIS) VMP Considerations. The platform minimum network access requirements are available. See Network Access Requirements. The SQL Server is running and meets the minimum requirements. See VMP MS SQL Server Requirements. The Vocera Server is configured to communicate with the VMP Server (if a Vocera Server integration is part of the deployment). See About Vocera Server Integration. The user sources are defined and proper credentials are available to configure the import parameters for remote sources. See Contacts. VMP Server Installation Worksheet Use the following worksheet to gather the information needed for a successful installation. Installing the Vocera Messaging Platform Server 17

18 Installing the VMP Server The VMP Server hostname or IP address: The VMP license file location: BlackBerry Enterprise Server hostname or IP address: SQL server hostname or IP where BESMgmt is stored: Credentials for the SQL account with read access to BESMgmt. Name: Password: SQL Server hostname or IP for VMP master database Server : sa login ID: Credentials Password: Microsoft Exchange Mailbox info: SMTP Server: Credentials (optional if needed to relay messages through the SMTP server): Name: Password: Installing the VMP Server Use the following steps to install the VMP Server: Installing the VMP Server 1. Use the following steps to turn off the IIS World Wide Web Publishing Service. This step ensures that port 80 is open for the VMP Web Console. Turn Off IIS 1. Open the Windows Services application: Windows > Start > Administrative Tools > Services 2. Click to select World Wide Web Publishing Service. 3. Right-click and select Properties. 4. Choose Disable from the dropdown list, click Stop, and click Apply. 2. Execute the VMP setup file on the VMP installation server. 18 Vocera Messaging Platform Administration Guide

19 Installing the VMP Server 3. Accept the License Agreement, and click Next. 4. In the Software Type dialog, select Server and Client, and click Next. 5. Choose the Install Location and click Install. 6. At the Create VMPDatabase Wizard prompt, enter the following information and click Next. Enter the SQL Server name. Best Practice: Vocera recommends that you type the name of the server instead of using the dropdown list to select a server. Select the Sql Server Authentication radio button. Enter the SA Login and Password. Click Next. Note: For details about the SQL Server requirements, see VMP MS SQL Server Requirements. 7. Enter a password for the wicapplication and wicauth accounts using the following rules, and click Next. Passwords must be a minimum of 7 characters and include at least three of the following: Uppercase letter Lower-case letter Symbol and/or number Note: Do not change the system account names. Installing the Vocera Messaging Platform Server 19

20 Installing the VMP Server 8. In the VMP System Setting dialog, enter the VMP Server internal and external host information and the SMTP settings. Best Practice: Use the DNS name for the external host name to make IP scheme updates easier. If configuring a device manually, use an IP address. Note: For detailed information about System Setting requirements, see VMP System Settings. 9. To install the BlackBerry client using the VMP Server, you must install the OTA.xml file included with the client installation files. Browse to the client folder, select the OTA.XML file, click Open, and click Complete. 10. The installer creates the VMP databases on the SQL server. When the script is complete, click OK. 11. This release opens the VMP Enterprise Manager after the database script complete. Close the application to complete the installation process. Click Finish to close the installer. 12. The VMP Server is now installed. Confirm a good installation by opening a supported Web browser (Internet Explorer version 9 or later) and pointing to the server URL. If VMP is installed correctly, the VMP Web Console opens at the login page. 20 Vocera Messaging Platform Administration Guide

21 Configuring the VMP License Configuring the VMP License Use the following steps to configure the VMP Server. Configuring the VMP Server License 1. Start the VMP Enterprise Manager application: All Programs > VMP > VMP Enterprise Manager 2. Click the Instances icon credentials. and enter the SQL Server administrator Note: For more information about the SQL Server credential requirements, see VMP MS SQL Server Requirements. 3. In the Licenses tab, select the Install License button. 4. Navigate to the license file and click Open. Note: The license file is provided by the Order Admin (OA). The file is distributed as a zip file. Extract the file before you begin the installation to import the WLC extension. 5. Click OK to close the install dialog. Installing the Vocera Messaging Platform Server 21

22 Updating the VMP Server Updating the VMP Server Use the following steps to update the VMP Server: Updating the VMP Server 1. Use the following steps to stop the Vocera Data Exchange service on the VMP Server: Stop the Vocera Data Exchange Service 1. Open the Windows Services application: Windows > Start > Administrative Tools > Services 2. Click to select Vocera Data Exchange Service. 3. Right-click and select Stop. 2. Execute the updated VMP setup file on the VMP installation server. 3. Accept the License Agreement, and click Next. 4. In the Software Type dialog, select VMP Server and Administrator, and click Next. 5. Accept the existing Install Location and click Install. 6. At the Create VMPDatabase Wizard prompt, enter the following information and click Next. 22 Vocera Messaging Platform Administration Guide

23 Updating the VMP Server Enter the SQL Server name. Best Practice: For this release, Vocera recommends that you type the name of the server and that you do not use the dropdown list to select a server. Select the SQL Server Authentication radio button. Enter the SA Login and Password. Note: For details about the SQL Server requirements, see SQL Requirements. 7. Click OK to confirm that the existing database will be upgraded, and click Next. 8. To install the BlackBerry client using the VMP Server, you must install the OTA.xml file included with the client installation files. Browse to the client folder, select the OTA.XML file, click Open and click Complete. 9. The installer will create the VMP databases on the SQL server. When the script is complete click OK. Installing the Vocera Messaging Platform Server 23

24 Installing a VMP Cluster 10. If the VMP Enterprise Manager opens after the database script is complete, close the application to complete the installation process. Click Finish to close the installer. 11. Restart the server. 12. The VMP Server is now updated. Confirm a good installation by opening a supported web browser (Internet Explorer 8 and newer) and pointing to the server URL. If VMP is installed correctly, the VMP Web Console opens. Note: If you need to roll back your upgrade, use the steps listed in Rollback 1 Procedure for VMP Upgrade. Installing a VMP Cluster To ensure maximum reliability, you can set up a cluster and install the VMP Server on each node of the cluster. For more information on using the Vocera Messaging Platform in a clustered environment, see Vocera Messaging Platform Failover. Installing the VMP Server on the First Node of the Cluster 1. Perform a normal installation of the VMP Server. See Installing the VMP Server for instructions on how to install the VMP Server. 2. Test the VMP Server to ensure that it works properly. 3. Copy the server configuration file, WIC.config, to a folder that the second node of the cluster can access. Note: The WIC.config file is located in your VMP installation folder. By default, this is \Program Files\Wallace\WIC. Installing the VMP Server on the Second Node of the Cluster 1. Create the VMP installation folder for the VMP Server. By default, this is \Program Files\Wallace\WIC. 2. Locate the copy of the server configuration file, WIC.config, that you created when installing the VMP Server on the first node of the cluster. Copy this file to the VMP installation folder that you have just created. 3. Turn off the IIS World Wide Publishing Service. See Installing the VMP Server for instructions on how to do this Vocera Messaging Platform Administration Guide

25 Updating a VMP Cluster 4. Execute the VMP setup file. 5. Accept the License Agreement, and click Next. 6. In the Software Type dialog, select Server and Client, and click Next. 7. In the Install Location field, enter the path of the installation directory into which you copied the WIC.config file. Click Install. 8. At the Create VMPDatabase Wizard prompt, confirm that the SQL Server name is correct. Note: The SQL Server name is supplied by the WIC.config file that you copied. 9. Select the Sql Server Authentication radio button, and enter the SA Login and Password. Click Next. 10. When prompted, click OK to upgrade the database. 11. Leave the SQL Account Configuration page unchanged and click Next. Note: The account configuration information is supplied from the WIC.config file that you copied. Do not change this information. 12. Complete the VMP System Setting dialog and all subsequent steps in the Create VMPDatabase Wizard as described in Installing the VMP Server. Updating a VMP Cluster Updating a VMP Cluster 1. On the first node of the cluster, follow the instructions in Updating the VMP Server to update the VMP Server. 2. Stop the Vocera Data Exchange Service on the first node: a. Open the Windows Services application: Windows > Start > Administrative Tools > Services b. Click to select Vocera Data Exchange Service. c. Right-click and select Stop. Installing the Vocera Messaging Platform Server 25

26 The Smartphone Proxy 3. On the second node of the cluster, follow the instructions in Updating the VMP Server to update the VMP Server. 4. Stop the Vocera Data Exchange Service on the second node. 5. Restart the Vocera Data Exchange Service on the first node of the cluster: a. Open the Windows Services application: Windows > Start > Administrative Tools > Services b. Click to select Vocera Data Exchange Service. c. Right-click and select Start. The Smartphone Proxy To be able to support Active Directory authentication, the Vocera Messaging Platform (VMP) server must be part of the corporate network and must be connected to the domain controller. However, the VMP Server needs to be opened to external traffic, since it needs to communicate with smartphones. For security reasons, some customers place the VMP Server into a DMZ or perimeter network. Unfortunately, this means that some VMP features, including Active Directory authentication, become unavailable. To solve this problem, the Vocera Smartphone Proxy (VSP) is included with VMP. The VSP performs the following tasks: Accepts HTTP traffic Filters smartphone requests Authenticates the requests Sends the requests to the VMP Server Provides replies to the smartphones that sent the requests 26 Vocera Messaging Platform Administration Guide

27 Installing the Vocera Smartphone Proxy (VSP) The VSP can be installed in the DMZ, and will block all traffic to the VMP Server except for authenticated smartphone traffic. Installing the Vocera Smartphone Proxy (VSP) Use the following steps to install the VSP on your VMP Server. Installing VSP on the VMP Server 1. After the VMP Server is installed, run setup.exe again. 2. Select Smartphone Proxy and click Next. 3. Confirm or change the default install location, and click Install. 4. Use the VSP Configuration Utility to configure the proxy settings. 5. Click Save, and click Start. Note: To uninstall VSP, open the VSP Configuration application, and click Uninstall. The VSP Configuration Utility A configuration utility for the VSP is included with VMP. This utility appears when you install the VSP. It lets you install VSP as a Windows service, start and stop it, and configure it. Installing the Vocera Messaging Platform Server 27

28 The VSP Configuration Utility Figure 2. The VSP configuration utility The VSP configuration utility consists of four sections: HTTP server settings Logger settings SMTP settings Proxy settings The HTTP server settings section specifies the network interface that the VSP is listening to: Table 6. HTTP server settings options Option Description Interface The IP address for the network interface. Specify to use all available local network interfaces. Port The local HTTP port number. Https Port The local HTTPS port number. Connection Limit The maximum number of simultaneous requests that will be redirected to the application server. This lets you control the impact of smartphone use on the application server load. Connection Timeout The number of seconds that the VSP is to keep HTTP requests in the local queue. Certificate Name, Certificate Location, Certificate Thumbprint 28 Vocera Messaging Platform Administration Guide The fields that define the SSL certificate. Click to browse for the location of a previously installed certificate.

29 The VSP Configuration Utility The Logger settings section specifies the settings for file logs, Windows event logs, and log records sent by . The SMTP settings section specifies the communication settings for the SMTP server. These settings are identical to the settings specified in the VMP Enterprise Manager. The Proxy settings section defines the WDE server that the VSP is connected to: Table 7. Proxy settings options Option Description WDE HTTP Url The URL to access the WDE using HTTP. WDE HTTPS Url The URL to access the WDE using HTTPS. Check PIN Query String A query to authenticate the device. Use only HTTP protocol for WDE Select this checkbox if the VSP is to always use the HTTP interface to communicate with the WDE server. This lets you use fewer VSP and WDE resources. If this checkbox is cleared, VSP will use HTTPS if the smartphone requests it. Cache timeout The number of minutes that VSP stores information about previously authenticated devices. When the cache record is expired, the VSP re-authenticates the device on the WDE server. Authentication Timeout The number of milliseconds that the VSP will wait for a response from the WDE application server to an authentication request. Request Timeout The number of milliseconds that the VSP will wait for a response to an authenticated request redirected to the WDE application server. Installing the Vocera Messaging Platform Server 29

30 The VSP Configuration Utility 30 Vocera Messaging Platform Administration Guide

31 Deploying VMP This part of the manual describes how to deploy VMP in your environment. This description includes how to import and add users and contacts, how to encrypt your data for greater security, and how to deploy a failover environment to ensure maximum reliability. Deploying VMP Configuring Wireless Gateways Importing Users and Contacts Sending Installation Information to User Devices Configuring the VMP Server For Secure Connections Data Encryption Vocera Messaging Platform Failover Remote Wipe Deploying VMP 31

32 32 Vocera Messaging Platform Administration Guide

33 Deploying VMP VMP administrative and deployment tasks are managed from the VMP Administrator Console and VMP Web Console applications. The client applications are deployed from the VMP Administrator Console depending on the user configuration and the available application licenses. On-call scheduling is configured from the VMP Web Console based on on-call distribution lists created from the VMP Administrator Console. Deploying VMP 33

34 34 Vocera Messaging Platform Administration Guide

35 Configuring Wireless Gateways The following wireless gateways can be configured for VMP: BES SNPP WCTP Connections (see the VMP Integration Guide for details about this gateway option) Integrating with BlackBerry Enterprise Server To deploy VMP to users on your BlackBerry Enterprise Server (BES), configure the platform to connect to the Mobile Data Service (MDS) on the BES. VMP leverages the BES outbound connection to the RIM infrastructure and ensures secure communication with 256-bit AES encryption. For non BES environments, use the BlackBerry Push API. For information about configuring VMP to integrate with your existing BES, see Configuring the BES Server. For information about configuring VMP to work with the BlackBerry Push API, see Configuring a BlackBerry Wireless Gateway with the Push API. For information about configuring VMP to support BlackBerry devices using the VMP PIN Gateway, see About the VMP PIN Gateway. Configuring the BES Server Use the following steps to set up a BES Server interface. Configuring the BES Server Interface 1. Start the VMP Administrator Console: All Programs > VMP > VMP Administrator Console Type admin (or your administrative credentials) in the VMP Login dialog, and click OK. Configuring Wireless Gateways 35

36 Configuring the PIN Gateway 2. Navigate to the Wireless Gateways view: Configuration > Wireless Gateways. 3. Click to highlight Default BES Server, and click Edit. 4. Enter the host details and click OK to complete the configuration. Configuring the PIN Gateway Use the BlackBerry Push API as a wireless gateway for BlackBerry users who are not on the corporate BES or where the environment does not include a corporate BES. The push API enables two-way communication from the client to the VMP Server via HTTP or HTTPS. Important: To leverage this wireless gateway option, contact your BlackBerry service representative to register for system credentials needed during configuration. During client installs, the VMP Server provides the internal IP to users who are on a local BES, and provides the external IP to BlackBerry Push API users so that they can come in through the organization s firewall to access the VMP Server. 36 Vocera Messaging Platform Administration Guide

37 Configuring a BlackBerry Wireless Gateway with the Push API BlackBerry Push API notifications are sent to BlackBerry devices unencrypted, although this is not a problem, as they only notify the device to check for a message. Configuring a BlackBerry Wireless Gateway with the Push API Use the following steps to configure a wireless gateway using the BlackBerry Push API: Configuring a BlackBerry Push Wireless Gateway Important: To complete the following task, you must have the Push API credentials provided by your Vocera sales or service representative. 1. Start the VMP Administrator Console: All Programs > VMP > VMP Administrator Console Type admin (or your administrative credentials) in the VMP Login dialog, and click OK. 2. Navigate to System Options: Configuration > System Options. 3. From the Enable BB Push API notification dropdown list, select Yes. Best Practice: The BlackBerry VMP client accesses the server via HTTP. However, this traffic can be SSL-encrypted, which requires changing the Enforce SSL setting to Yes. Configuring Wireless Gateways 37

38 The VMP PIN Gateway To enforce SSL, an SSL certificate must be installed on the VMP Server, and this certificate must then be configured in the Enterprise Manager. Select from any certificates already installed on the server and define the secure port in the Configuration section of the VMP Enterprise Manager. The same certificate is used for the HTTPS connection and is enforced in the same location by always setting the NetworkSecureEnforceWebSSL to True. 4. Enter the BB Push API Application ID, provided by your Vocera representative, and click OK. The VMP PIN Gateway The VMP PIN Gateway provides a gateway for BlackBerry device users who are not on the organization s BES, or for environments where a BES is not available. This gateway can also be configured to support failover mode if a BES/MDS server becomes unavailable. Configuring the PIN Gateway Use the following steps to install the PIN Blaster Server client: Installing the PIN Blaster Server Client on the VMP Server 1 1. Download and install the Blackberry Desktop Software on the VMP Server. 2. Start the VMP Enterprise Manager application. 3. Select Configuration. 4. Use the Enable Pin Blaster dropdown list to set the option to True. 1 code=a8baa56554f96369ab93e4f3bb068c22&dl=a2c0d61eb187ab3afd247a852fad Vocera Messaging Platform Administration Guide

39 SNPP Gateways Note: If you are using VMP in a clustered environment, you must install the PIN Blaster Server Client on each cluster node on which the VMP Server is installed. Configuring the PIN Gateway 1. Start the VMP Administrator Console. 2. Navigate to System Options: Configuration > System Options. 3. Scroll down to the PIN Transport options and click in the right column of the PIN gateway row. Enter the host name or IP address for the VMP Server, and click OK. 4. Use the dropdown list to set Enable PIN Push notification to True. 5. Restart the VMP Server. SNPP Gateways The SNPP protocol facilitates a link between the Internet and a TAP-compliant paging terminal. To configure VMP for use with a provider using SNPP, you must have the provider's SNPP address and port number. For a list of provider SNPP addresses and port numbers, see Note Page - Simple Network Paging 2 Protocol (SNPP). Configuring an SNPP Wireless Gateway For a deployment with SNPP protocol, use the following steps to configure the SNPP Wireless Gateway in the VMP Administrator Console. Configuring an SNPP Wireless Gateway 1. Start the VMP Administrator application: All Programs > VMP > VMP Administrator Type admin (or your administrative credentials) in the VMP Login dialog, and click OK. 2 Configuring Wireless Gateways 39

40 Configuring an SNPP Wireless Gateway 2. Navigate to the Wireless gateways view: Configuration > Wireless gateways. 3. Click to highlight AT&T SNPP, and click Edit. 4. Select the SNPP Implementation from the dropdown list. ATT, Sprint, and Verizon are pre-configured. For another implementation, select Generic and provide the following details: Table 8. SNPP Configuration Options Option Values Name Name the SNPP implementation. Host Enter the host name. Port Specify the port number to use. SNPP gateway compatibility Select One way or Two way from the dropdown list. Max # of characters per message Enter the maximum number of characters allowed in a text message. Delivery receipts Click to activate delivery receipts if this option is supported by the provider. Treat "accepted by gateway" as delivery receipt Click to activate this option if it is supported by the provider. If this option is selected, the message is deemed delivered when accepted by the gateway. Free text responses This option is selected by default. Leave this option active unless instructed otherwise by the provider. Multiple Choice responses This option is selected by default. Leave this option active unless instructed otherwise by the provider. Use authentication If authentication is required to establish the gateway connection, click to activate this option and enter the login credentials. 40 Vocera Messaging Platform Administration Guide

41 Configuring an SNPP Wireless Gateway Configuring Wireless Gateways 41

42 Configuring an SNPP Wireless Gateway 42 Vocera Messaging Platform Administration Guide

43 Importing Users and Contacts The VMP Server synchronizes with other servers to import the platform user and contact base. A user is anyone who can send or receive an alert from a licensed device, from the VMP Web Console, or by . Most users are employees who have application licenses assigned to them. Some users who generate alerts but do not receive them do not need application licenses. Contacts are parties who may or may not be part of your organization, but with whom critical and frequent communication occurs. You can think of contacts as a set of employees and non-employees who are entered into the system with one or many contact points for easy communication. Users and contacts can be imported from: Active Directory Vocera Server BES (4.0, 4.1, 5.0) Excel or CSV File SQL Database Users cannot be removed from the database using automatic synchronization. Users must be removed manually. For more information, see Adding and Deleting Users Manually. Warning: Each user on the VMP Server must have a unique address. If multiple users have the same address, the VMP Server may not operate as expected. Best Practice: Before building a user base from imported sources, plan the source field mappings needed for your environment. Field mappings can be configured for users and for contacts. For details about source field mapping, see Defining User Fields and Defining Contact Fields. Importing Users and Contacts 43

44 Active Directory User Synchronization Synchronize new imports with existing contacts to ensure the maintenance and update of contacts is uninterrupted and all system contacts stay up to date. Active Directory User Synchronization A secure method of importing users to the VMP Server is through Active Directory synchronization. The VMP Server synchronizes with the Active Directory server to import Organizational Units, security groups, and distribution lists. When an import is complete, VMP has the ability to convert the organizational units to VMP distribution lists. Automatic synchronization is used to synchronize with the Active Directory at a chosen time interval. Configuring VMP for Active Directory To integrate VMP with your Active Directory server: 1. Start the VMP Enterprise Manager application: All Programs > VMP > VMP Enterprise Manager 2. Click the Configuration icon. 3. Enter the Active Directory values appropriate for your deployment: Table 9. Active Directory Configuration Options Configuration Option Description Active Directory Server Enter the Active Directory IP address or host name in this field. Connect to Active Directory over SSL Select True to connect using SSL. The default is False. Allow any Active Directory user to login Select True to allow any user in the Active Directory database to login to the VMP Server configuration and administration software. The default is False. 44 Vocera Messaging Platform Administration Guide

45 Importing Active Directory Users Configuration Option Description Enable automatic login using Active Directory authentication Select True to allow any user to log on to the VMP Web Console using Active Directory credentials. The default is False. Allow current logged domain user to login Select True to allow any user logged on to the VMP Server automatic access to the VMP Server configuration and administration software. The default is False. See Active Directory User Synchronization for more information about configuring the Active Directory values. 4. Save the configuration changes. In the confirmation dialog, click Yes to restart the VMP Server. 5. Click OK to close the restart dialog and complete the configuration. 6. Close the VMP Enterprise Manager. Note: If you have set up VMP in a clustered environment, you must repeat these instructions for each cluster node on which the VMP Server is installed. To ensure the least amount of down time, integrate the Active Directory on the standby server first, then repeat on the active server. Importing Active Directory Users To import Active Directory contacts to VMP: 1. In the VMP Administrator Console, navigate to the Users view: Users & Groups > Users 2. Click the Synchronization icon in the Users view. Importing Users and Contacts 45

46 Importing Active Directory Users 3. Set the Automatic Synchronization option to synchronize user data from the source by: Hours and minutes Daily at a specified hour Weekly on a specified day, at a specified hour Best Practice: The best auto synchronization time depends on your specific environment. The setting should keep the system updated with new and updated user data and occur when network traffic is not typically heavy. 4. Unselect the wireless gateway default selector. 5. In the User Synchronization dialog, click the Add primary source with contacts icon (under Sources). 46 Vocera Messaging Platform Administration Guide

47 Importing Active Directory Users 6. Select Active Directory from the Source type dropdown list. This selection auto-populates the Title field. You can accept the default title or customize the title. 7. Enter the Active Directory credentials under Connection Parameters. 8. Configure the following options using the dropdown list and click OK to close the dialog: Importing Users and Contacts 47

48 Importing Active Directory Users Sync Organization Units Sync Security Groups Sync Distribution Groups 9. The Active Directory source is configured. Make sure it is highlighted, and click Next in the User Synchronization dialog. 10. Select the users to import by clicking the checkbox next to the Organization Unit (OU) name. Activate the right checkbox for the OU. Activate the left checkbox to import any sub OUs. If the OU does not have sub OUs, the left checkbox cannot be activated. 48 Vocera Messaging Platform Administration Guide

49 Importing Active Directory Users Click Next. 11. In the User/DL Synchronization dialog, use the radio button selection to configure the synchronization options appropriate for your deployment. Depending on the user import configuration, the options are included in the following three tabs: Organization Units Security Groups Distribution Groups Click each tab to configure the options for the group. You can import only the users or import the existing group structures. When the options are selected, click Next. Importing Users and Contacts 49

50 Importing Active Directory Users 12. The Default DL Permissions dialog provides permission configuration options. For the initial Active Directory import, you can configure permissions for the default administrator and any groups selected for import. Use the tabs to toggle between User and Group permissions. When the configuration in complete, click Next. 13. The Field Mapping dialog allows for basic field mapping from the Active Directory Source to the VMP user contact. Define the field mappings for your deployment, and click Next. Note: For more information about field mappings, see Defining Contact Fields and Defining User Fields. 14. The synchronization script is generated by the import wizard options selected and is revealed in a script dialog box. Use the scroll bar to review the script and click Close. 50 Vocera Messaging Platform Administration Guide

51 Importing From an Excel or CSV File 15. The Script dialog provides the option to manually configure contact options before running the import script. This dialog is useful for defining device and wireless gateway assignments. These options can be changed manually at any time after deployment. Click the Check All click Finish., to confirm the previously configured values, and 16. The synchronization script runs. When the sync is complete, click OK to close the successful sync dialog, and click Close to close the script window. Importing From an Excel or CSV File Use the following steps to import User or Contact sources from an Excel spreadsheet or CSV file. Importing Sources from an Excel or CSV File 1. From the VMP Administrator Console, navigate to the Users view: Users & Groups > Users Importing Users and Contacts 51

52 Importing From an Excel or CSV File 2. Click the Synchronization icon in the Users view. 3. Configure the Automatic Synchronization options, and unselect the wireless gateway default selector. 4. In the User Synchronization dialog, click the Add primary source with contacts icon (under Sources). 5. Select Generic Excel or CSV from the Source type dropdown list. This selection auto-populates the Title field. You can accept the default title or customize the title. 52 Vocera Messaging Platform Administration Guide

53 Importing From an Excel or CSV File 6. Edit the connection parameters listed below and click OK. Table 10. Generic Excel Connection Parameters Parameter Description File path Click in this field to browse for the file, or type the path in the box. Login Password If required, enter a login and a password to access the Excel file. Confirm Password If a login and password are required to access the file, enter the password a second time to confirm the credentials. Worksheet If the spreadsheet includes more than one worksheet, enter the name of the worksheet to import as source data. Document contains columns title Select Yes if the spreadsheet uses title columns to define the data. Select No if the spreadsheet does not include title columns. Importing Users and Contacts 53

54 Importing From an Excel or CSV File Parameter Description Header row number Enter the header row number. Content row number Enter the content row number Table 11. CSV Connection Parameters Parameter Description File path Click in this field to browse for the file, or type the path in the box. Login Password If required, enter a login and a password to access the Excel file. Confirm Password If a login and password are required to access the file, enter the password a second time to confirm the credentials. Encoding Select the text encoding option appropriate for the imported data. In most cases, the default option of automatic, is appropriate. Delimiter Use the dropdown list to choose a comma or semicolon as the string separator. Document contains columns title Select Yes if the spreadsheet uses title columns to define the data. Select No if the spreadsheet does not include title columns. 7. In the sources dialog, highlight the source that you have just created, and click Next. 54 Vocera Messaging Platform Administration Guide

55 Importing From an Excel or CSV File 8. The Field Mapping dialog allows for basic field mapping from the source to VMP entry. Define the field mappings for your deployment, and click Next. Note: For more information about field mappings, see Defining User Fields and Defining Contact Fields. 9. The synchronization script is generated by the import wizard options selected and is revealed in a script dialog box. Use the scroll bar to review the script and click Close. 10. The Script dialog provides the option to manually configure contact options before running the import script. This dialog is useful for defining device and wireless gateway assignments. These options can be changed manually at any time after deployment. Click Check All to confirm the previously configured values, or manually select the users to import. When the selection is complete, click Finish. 11. Select to export VMP contact address book entries for import to the Vocera Server and click Finish to continue. Importing Users and Contacts 55

56 Importing From SQL 12. The synchronization script runs. When the sync is complete, click OK to close the successful sync dialog, and click Close to close the script window. Importing From SQL Use the following steps to import User or Contact sources from an SQL database. Importing Sources from SQL 1. From the VMP Administrator Console, navigate to the Users view: Users & Groups > Users 2. Click the Synchronization icon 56 Vocera Messaging Platform Administration Guide in the Users view.

57 Importing From SQL 3. In the User Synchronization dialog, click the Add primary source with contacts icon (under Sources). 4. Configure the Automatic Synchronization options, and click to clear the wireless gateway default selector. 5. Select MsSqlServer from the Source type dropdown list. This selection auto-populates the Title field. You can accept the default title or customize the title. 6. Enter the Connection Parameters and click OK. Importing Users and Contacts 57

58 Importing From SQL Table 12. SQL Connection Parameters Parameter Description Address The computer name or IP address of the SQL server. Login The SA login credentials. Password Confirm Password Enter the password a second time to confirm the credentials. Database Select the database to import from the dropdown list. Query Use the dropdown list to select any specifc query options for the import. 7. In the sources dialog, highlight the SQL source, and click Next in the User Synchronization dialog. 58 Vocera Messaging Platform Administration Guide

59 Importing From SQL 8. The Field Mapping dialog allows for basic field mapping from the source to the Vocera Messaging Platform entry. Define the field mappings for your deployment, and click Next. Note: For more information about field mappings, see Defining User Fields and Defining Contact Fields. 9. The synchronization script is generated by the import wizard options selected and is revealed in a script dialog box. Use the scroll bar to review the script and click Close. 10. The Script dialog provides the option to manually configure contact options before running the import script. This dialog is useful for defining device and wireless gateway assignments. These options can be changed manually at any time after deployment. Click the Check All to confirm the previously configured values, or manually select the users to import. When the selection is complete, click Finish. Importing Users and Contacts 59

60 Adding and Deleting Users Manually 11. Select to export VMP contact address book entries for import to the Vocera Server and click Finish to continue. 12. The synchronization script runs. When the sync is complete, click OK to close the successful sync dialog, and click Close to close the script window. Adding and Deleting Users Manually If you want to add a user that is not included in your remote resource, you can add the user manually. You can also manually delete users from the system. Best Practice: When editing imported users, do not edit fields that synchronize with the imported source. These changes should be made at the source to avoid overwriting the changes when the source synchronizes with the VMP. Note: If the address of a contact is changed on the VMP Server, the contact will not synchronize with the source. To add a user manually: 1. From the VMP Administrator Console, select Users & Groups > Users 60 Vocera Messaging Platform Administration Guide.

61 Adding and Deleting Users Manually 2. From the toolbar menu in the Users pane, click Add Settings window appears.. The End-User 3. Enter the following End User Settings. Table 13. End User Settings Field Description First Name The first name of the user. Middle Name The middle name of the user (optional). Last Name The last name of the user. Pager ID The user's pager ID. This optional field is populated when the VMP Alert Gateway API is implemented. Vocera ID The user's Vocera ID. This optional field is populated when the VMP Alert Gateway API is implemented. When an ID has been supplied in the Vocera ID field, select how messages are to be sent to users that have a Vocera ID: Send to badge, then smartphone if required Send to smartphone only Profile Select from this dropdown list to associate the user with a group profile. See Group Profiles for more information on group profiles. Importing Users and Contacts 61

62 Adding and Deleting Users Manually Field Description Enable PC Admin Console Access Select this check box to allow the user to access the VMP Administrator Console. Enable Web Console Access Select this check box to allow the user to access the VMP Web Console. Activating this field requires you enter authentication credentials for the user. AD Account If the new user has an Active Directory account, enter the account name in the AD Account field. Vocera credentials To provide Vocera credentials for the new user, enter the Vocera Server login in the Login field, enter the password in the Password field, and re-enter the password in the Confirmation field. 4. Click Next to display the Push Technology and Licensing window. 5. To enable mobile device access, select the Enable check box, and select the device type from the Device type dropdown list. 6. To register the user, enter the registration information in the fields provided. Note: For details on how to generate a registration key and this registration information to the user, see Sending Device Installation Information. 7. In the VMP Applications On Device pane, select the VMP applications to which the user is to be granted access. Access can be granted to an application only if at least one unused license is available. The Available column lists the number of unused licenses available for each application. 8. Click Finish to finish creating the new user. To delete a user: 1. From the VMP Administrator Console, select Users & Groups > Users 2. In the Users pane, click on the name of the user to be deleted. 3. From the toolbar menu, click Delete. 4. In the confirmation dialog box that appears, select the Wipe data on smartphone check box to wipe all data stored in the smartphone application. 5. Click Yes to confirm user deletion. 62 Vocera Messaging Platform Administration Guide.

63 Vocera Server Integration Vocera Server Integration Vocera Server to VMP integration provides seamless communication between the application client and the Badge. Alerts are displayed on the Badge as text messages and can be enunciated or viewed on the Badge screen. Badge users communicate with VMP users by issuing the Page command on the Badge. Badge initiated alerts are received on the VMP client with the details of who sent the alert and a link to call back to the Badge user. Note: Vocera Server is integrated with the platform as a connector and no additional licensing is required. To configure the VMP Server to integrate with Vocera Server, prepare the following: Table 14. Vocera Server Configuration Requirements Configuration Requirement Description Vocera Server Software Requirements Vocera Voice Server version 4.3 Service Pack 1 or later. Vocera Server Credentials You must have administrator access to the Vocera Server. VMP Server IP Address You must have the VMP Server IP address. Vocera User Address Make sure that each Vocera Server user profile includes the user address. Vocera Server Configuration Use the following steps to integrate VMP with Vocera Server. Important: Before beginning a Vocera Server import, make sure each user address is entered on the Vocera Server. The address is used to match VMP source users from other imports and prevent duplicate user entries. Make sure the paging field in the Vocera Server user profile is blank. This field is mapped on the VMP Server. To configure Vocera Server for the VMP Administrator Console: 1. Open the Vocera Server Administration Console. 2. Log on with your administrator credentials. 3. Select the System view. Importing Users and Contacts 63

64 Vocera Server Configuration 4. Select the License Info tab. 5. In the VAI Application IP Addresses field, enter the Vocera Messaging Platform Server IP address. For load balanced environments, use commaseparated values. Note: If you are using other VAI applications, the IP address for VMP must be the first IP address listed in the VAI address field. 6. Click Save Changes. 7. Click the Preferences tab. 8. If the Enable Auto-Logout Period check box is selected, set the autologout period to a value greater than 1 Minute. This ensures that clients that use the ios operating system are not unexpectedly logged out. 9. Click to select the Enable VMP checkbox. 64 Vocera Messaging Platform Administration Guide

65 Importing Vocera Server 10. Click Save Changes. Importing Vocera Server Important: Before beginning a Vocera Server import, make sure each user address is entered on the Vocera Server. The address is used to match VMP source users from other imports and prevent duplicate user entries. Make sure the paging field in the Vocera Server user profile is blank. This field is mapped on the VMP Server. To import Vocera Server contacts to VMP: 1. Start the VMP Administrator Console: All Programs > VMP > VMP Administrator Console 2. Type admin in the VMP Login dialog, and click OK. 3. Navigate to the System Options view: Configuration > System Options 4. Scroll down the System Options dialog to the Vocera section. Importing Users and Contacts 65

66 Importing Vocera Server 5. Enter the following values: Table 15. System Option Configuration Values Option Value Enabled: Yes IP Address Enter the Vocera Server IP address (or comma-separated addresses for a clustered environment). Port Enter the Vocera Server port number. See Port Requirements for information on choosing the correct port. Use https: Select Yes or No from the dropdown list as appropriate for your deployment. 6. Click OK to continue. 7. Navigate to the Users view: Users & Groups > Users 8. Click the Synchronization icon 66 Vocera Messaging Platform Administration Guide in the Users view.

67 Importing Vocera Server 9. Configure the Automatic Synchronization options. 10. In the User Synchronization dialog, click the Add primary source with contacts icon (under Sources). 11. Select Vocera from the Source type dropdown, and click OK. This selection auto-populates the Title field. You can accept the default title or customize the title. Note: If you have multiple connections, you must repeat this step for each connection. Importing Users and Contacts 67

68 Importing Vocera Server 12. The Vocera Server source is now configured. Make sure it is highlighted, and click Next in the User Synchronization dialog. 68 Vocera Messaging Platform Administration Guide

69 Importing Vocera Server 13. The Field Mapping dialog allows for basic field mapping from the Vocera Source to the VMP user contact. Define the field mappings for your deployment, and click Next. 14. The synchronization script generated by the import wizard options is revealed in a script dialog box. Use the scroll bar to review the script and click Close. Importing Users and Contacts 69

70 Importing Vocera Server 15. Select the users to be updated, or select Check All select all users for this update. Click Next. to automatically 16. Select to export VMP contact address book entries for import to the Vocera Server and click Finish to continue. 17. The synchronization script runs. When the sync is complete, click OK to close the successful sync dialog, and click Close to close the script window. 18. The Vocera import is complete. 70 Vocera Messaging Platform Administration Guide

71 Configuring Notify Contacts Configuring Notify Contacts The VMP Notify features allow you to configure the server to send alerts to users outside of your deployment. The module uses distributions lists, created from imported contacts, to identify and leverage user contact information for communications. To leverage these options, you must perform the following tasks: Configure the VMP Server to send and receive alert . Create Notify distribution lists from imported contacts. Configure the plugins required to support communications. Configuring Alert Settings To leverage the Notify features, you must configure the Alert setting in the Notify module. To configure Alert Settings: 1. Start the VMP Administrator Console: All Programs > VMP > VMP Administrator Console Type admin (or your administrative credentials) in the VMP Login dialog, and click OK. 2. Navigate to System Options: Configuration > System Options. 3. Scroll to Settings > Alerts, and configure the following options: Table 16. Alerts System Options Option Description Enable Alerts Select Yes to enable the features. Incoming Mail (Responses) Scan Interval (sec): Enter the amount of time, in seconds, between scans for new communications. Protocol: Select the protocol from one of the following options: POP3 IMAP4 Exchange Web Services Importing Users and Contacts 71

72 Monitoring With VMP Alerts Option Description Outgoing Mail (Sent Alerts) Display Name Enter the display name to appear with messages sent from the admin console. Address Enter the address to use when sending messages from the admin console. SMTP Host: Enter the address of the host responsible for routing the messages. SMTP Port: Enter the host port number. SMTP Authentication: Select Yes to enable authentication, otherwise select No. Monitoring With VMP Alerts Vocera Messaging Platform provides features to integrate user into the Alert feature. The server monitors the box and sends an alert to the user when new mail is received. The following services are supported: POP3 IMAP Exchange Web Services (EWS) The following formats are supported: 72 Vocera Messaging Platform Administration Guide

73 Monitoring With VMP Alerts Table 17. Supported Formats Format Description Free Text Format The body contains the content of the message to be delivered. The format is constrained by the following rules: The alert recipients are added to the To field. The sender address is added to the From field. The topic is added to the Subject field. The text is added to the Message field. XML Format An generated by another system or process, where the body contains an XML document with specific tags used by the VMP Server. If the body of the is structured using the supported XML template, aliasing and redirection is not necessary. messages are sent directly to the monitored mailbox. The XML document contained in the body defines the recipients for the alert. The header fields are not used to determine the recipients and sender information. See XML Template. HTML Format An that uses a subset of HTML to provide formatting and semantic markup capabilities in that are not available with plain text. sent in HTML format uses the same rules as Free Text Format, but the received alert message is converted to plain text and delivered to the recipient. Multiple aliases can be associated with a mailbox. The alias is associated with the user in the Pager ID field user record. Use rules to redirect any that matches a defined criterion to the monitored mailbox. The server attempts to identify the message initiator by matching the specified From address with the sender Pager ID field. If a match is not found, the alert is not sent and the server sends a message to the initiator indicating that the sender cannot be identified. Message recipients are identified by matching the addresses defined in the To field with the user Pager ID Distribution List ID field. If a match for one or more recipients is not found, the initiator is sent a message indicating which recipient is unknown and ignored during message routing. The alert is send to all recipients that match the criteria. Note: Alert Responses and delivery notifications are not supported where the recipients are VMP groups or on-call lists. Importing Users and Contacts 73

74 Monitoring With VMP Alerts The server sends responses and notifications back to the message initiator using the original message format. To configure a VMP user for alerts, see Configuring Alerts. Configuring Alerts Use the following steps to integrate a user's into the Alert feature. Note: For details about configuring alerts, see Integrating User 1. Start the VMP Administrator Console: All Programs > VMP > VMP Administrator Console Type admin (or your administrative credentials) in the VMP Login dialog, and click OK. 2. Navigate to System Options: Configuration > System Options. 3. Scroll to Initiation/Open Portal Reports > Enable Pager Alert Initiation, and select Yes. 4. Configure the following settings: Table 18. Initiation Configuration Settings Username Enter the name associated with the mailbox. Password Enter the user's mailbox access password. Confirm Password Enter the password again for confirmation. Scan Interval Enter the frequency, in seconds, with which the server should scan for new Vocera Messaging Platform Administration Guide

75 Monitoring With VMP Alerts Initiation Permitted Choose from one of the following permission options: From any address: This option allows from any sender to initiate an alert to the user. From VMP users only: This option restricts alert initiation to trigger only when the is from another system user. Protocol Defines the protocol the VMP Server should use to monitor the mailbox. The available choices are POP3, IMAP4, and EWS. Depending on the protocol selected, additional connection parameters need to be specified, including Host and Port. Delete Once Processed Choose one of the following options to determine when is removed from the monitored mailbox: Immediately The is deleted after it has been processed and converted to an alert. Once/Day All is deleted after 24 hours. Never The is never deleted. Enable outgoing mail Set this to yes to allow the user to respond to the . Display Name Enter the user's display name. Address Enter the user's address. SMTP Settings Enter the following SMTP parameters: Host Port Authentication Username Password 5. Click OK. Importing Users and Contacts 75

76 Configuring VMP to Vocera Server Paging XML Template <?xml version="1.0"?> < PagingAlert> <AlertExternalID>externalID1</AlertExternalID> <To> </To> <!-- High, Normal, Low --> <Priority>Normal</Priority> <OverridePersonalAlarmSettings>true</OverridePersonalAlarmSettings> <notifywhendelivered>true</notifywhendelivered> <notifywhenread>true</notifywhenread> <sendresponse>true</sendresponse> <allowcomment>true</allowcomment> <Subject>Test subject</subject> <Message>Test message</message> <!-- None, Multi, Text --> <ResponseType>Multi</ResponseType> <Responses> < PagingAlertResponse> <RspExternalID>extid1</RspExternalID> <Text>Response 1</Text> </ PagingAlertResponse> < PagingAlertResponse> <RspExternalID>extid2</RspExternalID> <Text>Response 2</Text> </ PagingAlertResponse> </Responses> </ PagingAlert> Configuring VMP to Vocera Server Paging Use the following steps to configure VMP for Vocera badge users. 76 Vocera Messaging Platform Administration Guide

77 Configuring VMP to Vocera Server Paging Enabling a Vocera Voice User for VMP Paging 1. From the Vocera Server Administration Console, select Users, click to highlight the desired user, and click Edit User. 2. Click the Phone tab, type the letter w in the Pager text field, and click Save. Note: Vocera Messaging Platform sends an alert to the user s smartphone (not the badge). Use the following steps to enable paging to a Vocera Server group. Configuring Groups for VMP Paging 1. From the Vocera Server Administration Console, select Groups, click to highlight the desired group, and click Edit Group. Importing Users and Contacts 77

78 Configuring VMP to Vocera Server Paging 2. In the Info tab, type the letter w followed by a unique set of numbers, and click Save. 3. From the VMP Server, open the VMP Administrator Console and navigate to: Alerts > Distribution Lists 4. Click New > New Regular Distribution List. 5. Enter a name in the Distribution List Name box. 6. Enter the pager ID in the Distribution List ID box, and click Next. Note: This must be the pager ID entered in the Vocera Server Group profile. 78 Vocera Messaging Platform Administration Guide

79 Configuring VMP to Vocera Server Paging 7. Click to highlight the DL users (CRTL + click to select more than one user), click > to add the users to the list, and click Next. 8. Click to highlight the VMP users who can see and use the DL (CTRL + click to select more than one user), click > to add the users to the list, and click Finish. Importing Users and Contacts 79

80 Configuring VMP to Vocera Server Paging 80 Vocera Messaging Platform Administration Guide

81 Sending Installation Information to User Devices You can send instructions on how to install and register the client application on a user's device. To send device installation information: 1. From the VMP Administrator Console, select Users & Groups > Users. 2. In the Users pane, click on the name of the user to which installation instructions are to be sent. 3. From the toolbar menu, click on the Notify mobile device list and select dropdown Install VMP Applications. 4. If no registration key exists for this user, you will be asked whether you want to generate one. Click Yes. 5. A notification dialog box appears, indicating that the installation information has been sent to the user's address. Sending Installation Information to User Devices 81

82 82 Vocera Messaging Platform Administration Guide

83 Configuring the VMP Server For Secure Connections After you have installed the VMP Server, you can configure it to use SSL to send and receive information securely. Best Practice: Vocera recommends that you use SSL to transmit information. If you are using VMP to transmit confidential patient information, your jurisdiction may require by law that this information be transmitted securely. You can configure the VMP Server for secure connections from the VMP Enterprise Manager. Note: If you are using VMP in a clustered environment, you must configure each cluster node to use SSL. Configuring the VMP Server For Secure Connections 1. Start the VMP Enterprise Manager. 2. From the left pane, select Configuration. Configuring the VMP Server For Secure Connections 83

84 3. Scroll down to the Services folder and then to the WDE subfolder. 4. In the NetworkSecureCertificate row, click in the Value column, then click select. 5. In the Select Certificate dialog box, select the SSL certificate that you want to use, and click OK. 84 Vocera Messaging Platform Administration Guide

85 Enforcing SSL on the VMP Server Note: Vocera recommends that you use a publicly issued SSL certificate rather than a self-signed certificate. If a self-signed certificate is used, most web browsers will generate an error when the VMP Server is accessed from the VMP Web Console, which might cause confusion for end users. 6. If you want to enforce the use of SSL when connecting from a web browser to this VMP Server, click in the Value column of the NetworkSecureEnforceWebSSL row. From the dropdown list that appears, select true. Users that attempt to connect using HTTP are now directed to the HTTPS URL. For information on enforcing the use of SSL between the VMP Server and VMP clients, see Enforcing SSL on the VMP Server. 7. Click Save to save your changes. In the confirmation dialog box that appears, click OK. 8. After you have made your changes, the VMP Server needs to be restarted. In the dialog box that appears, click Yes to restart the VMP Server now, or click No to restart it later. Enforcing SSL on the VMP Server From the VMP Administrator Console, you can enforce that all communications between the VMP Server and VMP clients are to use SSL. This ensures that all communications are securely encrypted. Configuring the VMP Server For Secure Connections 85

86 Enforcing SSL on the VMP Server If you are updating a previously installed VMP Server to enforce the use of SSL, all existing VMP clients that are not using SSL must re-register to use the VMP Server, as the connection protocol used by a client is specified when the client is registered. Before you can enforce SSL use, you must configure a SSL certificate. For details, see Configuring the VMP Server For Secure Connections. Enforcing SSL on a VMP Server 1. Start the VMP Administrator Console. 2. Select Configuration > System Options 3. In the System Options dialog box, scroll to the BB Push API / HTTP(S) section and click in the right column of the Enforce SSL row. 86 Vocera Messaging Platform Administration Guide

87 Enforcing SSL on the VMP Server 4. From the drop-down list that appears, select Yes. 5. Click OK. Configuring the VMP Server For Secure Connections 87

88 Enforcing SSL on the VMP Server 88 Vocera Messaging Platform Administration Guide

89 Data Encryption The Vocera Messaging Platform ensures secure communication with data encryption options. For details about options for each client platform, review the following sections: BlackBerry Enterprise Server Data Encryption ios Server Data Encryption Android Server Data encryption BlackBerry Enterprise Server Data Encryption The BlackBerry Enterprise Solution offers two transport encryption options, Advanced Encryption Standard (AES) and Triple Data Encryption Standard (Triple DES), for all data transmitted between the BlackBerry Enterprise Server and BlackBerry smartphones. Private encryption keys are generated in a secure, two-way authenticated environment and are assigned to each BlackBerry smartphone user. Each secret key is stored only in the user's secure enterprise account and on their BlackBerry smartphone. Data sent to the BlackBerry smartphone is encrypted by BlackBerry Enterprise Server using the private key retrieved from the user's mailbox. The encrypted information travels securely across the network to the device, where it is decrypted with the key stored there. Data remains encrypted in transit and is never decrypted outside of the corporate firewall. Data Encryption 89

90 ios Server Data Encryption Table 19. BlackBerry Data Encryption Methods Method Encryption Details BlackBerry Push API The data sent from the VMP Server to the BlackBerry device, using the BlackBerry Push API, is encrypted by using SSL over a HTTPS connection. This transfer method first lets the device know that there is data on the Vocera Server that needs to be retrieved. The BlackBerry device then retrieves that data from the Vocera Messaging Platform via an encrypted HTTPS transport method. BlackBerry MDS Framework Data sent from the BES to the device uses the MDS framework. This data typically uses Triple DES and AES encryption (256 bit) to transfer data outside of the organization s firewall. The encryption strength can be modified on the BES by the administrator. Vocera Server and the BES connection All the data sent between the Vocera Messaging Platform Server and the BES is behind the corporate firewall and typically uses an HTTP connection to transfer data. BlackBerry Device Data Encryption Data being pushed to the BlackBerry device from the BES using MDS is automatically encrypted through a BES policy until viewed on the BlackBerry device. Data being pushed using the Push API will remain encrypted via HTTPS transport method until viewed on the device. The BlackBerry device has a password protection layer that protects data. ios Server Data Encryption To enable communication between a provider and a device, Apple Push Notification Service must expose two standard ports (2195 and 2196). To ensure security, it must also regulate access to these entry points. For this purpose, APNS requires two different levels of trust for providers, devices, and their communications. These are known as connection trust and token trust. 90 Vocera Messaging Platform Administration Guide

91 ios Server Data Encryption Connection trust establishes certainty that, on one side, the APNS connection is with an authorized provider with whom Apple has agreed to deliver notifications. On the device side of the connection, APNS must validate that the connection is with a legitimate device. Token trust is made possible through the device token. A device token is an opaque identifier of a device that APNS gives to the device when it first connects with it. The device shares the device token with its provider. Thereafter, this token accompanies each notification from the provider. It is the basis for establishing trust that the routing of a particular notification is legitimate. In a metaphorical sense, it has the same function as a phone number, identifying the destination of a communication. Table 20. iphone Data Encryption Methods Method Encryption Details Apple APNS Data Transfer Encryption Apple Push Notification Service (APNS) is a robust and highly efficient service for sending secure data to devices such as iphone, ipad, and ipod Touch devices. Each device establishes an accredited and encrypted IP connection with the service and receives notifications over this persistent connection. If a notification for an application arrives when that application is not running, the device alerts the user that the application has data waiting for it. Apple Push Notification Service includes a default Quality of Service (QoS) component that performs a store and forward function. If APNS attempts to deliver an Alert but the device is offline, the QoS stores the notification. It retains only one notification per application on a device: the last notification received from a provider for that application. When the offline device later reconnects, the QoS forwards the stored notification to the device. The QoS retains a notification for a limited period before deleting it. Data Encryption 91

92 Android Server Data encryption Method Encryption Details Apple iphone Device Data Encryption All devices using Alert with ios must register with the VMP Server to receive push notifications. The registration occurs after the application is installed. Once the ios receives the registration request from an application, it connects with the Apple Push Notification Service (APNS) and forwards the request. APNS generates a device token using information contained in the unique device certificate. The device token contains an identifier of the device. It then encrypts the device token with a token key and returns it to the device. Android Server Data encryption The Server needs to authenticate itself with the C2DM. This is done via an authentication token that is determined with an HTTP POST request to the C2DM servers. The VMP token is stored on the VMP Server and is used to authenticate the application server with the C2DM servers once it sends out data. In a C2DM, you have three involved parties. The VMP Server which wants to push messages to the Android device, Google C2DM servers, and the Vocera Alert Application. For the Vocera Server to send a message, the application must have a registration ID that allows it to receive messages for a particular device. The registration keys are securely stored within the SQL database. The ClientLogin token authorizes the Vocera Server to send encrypted data to the Alert Application on the Android device. The Vocera Server has one ClientLogin token and multiple registration IDs. Each registration ID represents a particular device that has registered to use the messaging service for Vocera Alert. When the VMP Server sends data, the following occurs: The VMP Server sends data to the C2DM servers. 92 Vocera Messaging Platform Administration Guide

93 Android C2DM Device Data Encryption Google queues and stores the message in case the device is inactive. When the device is online, Google sends the message to the device. On the device, the system broadcasts the message to the specified application via Intent broadcast with proper permissions, so that only the targeted application gets the message. This wakes the application up. The application does not need to be running beforehand to receive the message. The application processes the secure data. This is the sequence of events that occurs when an Android application running on a mobile device receives a message: The system receives the incoming message and extracts the raw key/value pairs from the message payload. The system passes the key/value pairs to Vocera Alert. The Android application extracts the raw data from the RECEIVE Intent by key and processes the data. Android C2DM Device Data Encryption The Android-based Vocera Alert Application must register with the VMP Server to receive push notifications. It does this right after it is installed on a device. The Android mobile OS receives the registration request from an application, connects with C2DM, and forwards the request to the Vocera Server. C2DM generates a device token using information contained in the unique device certificate. The device token contains an identifier of the device. It then encrypts the device token with a token key and returns it to the device. Password Enforcement The Vocera Messaging Platform provides configuration options to ensure that all smartphone users are required to protect the device with a password. This option ensures that your confidential internal information is protected if the device is lost or stolen. Use the following steps to configure your server for password enforcement. Best Practice: When configuring password options, remember to consider the speed at which your users must view and respond to critical communications. An auto-lock setting that is too short will impair the user's ability to quickly respond to alerts and communications. A password that requires too many characters may also be inhibiting, depending on the environment. Data Encryption 93

94 Password Enforcement Configuring Password Enforcement 1. Start the VMP Administrator Console: All Programs > VMP > VMP Administrator Console Type admin (or your administrative credentials) in the VMP Login dialog, and click OK. 2. Navigate to System Options: Configuration > System Options. 3. Scroll to Paging > Enable device password for all smartphones, and select Yes. 4. Configure the following options: Table 21. Device Password Configuration Options Option Description Minimum Password length Enter the number of characters the user must include in the device password. For iphone users, the device Passcode Lock settings must be changed if you want a password longer than 4 numerical digits. Require at least one letter Select Yes to ensure that the user adds at least one letter to the device password. For iphone users, you cannot insist on a password with at least one letter. For iphone users, the device Passcode Lock settings must be changed if you want a password to include a letter. 94 Vocera Messaging Platform Administration Guide

95 Password Enforcement Option Description Auto-Lock (minutes, seconds) Set the duration of inactivity, in minutes and seconds, until the device auto-locks. In the following example, the device is set to auto-lock after five minutes and thirty seconds: 5m30 Enforce change password Select Yes to ensure the user changes the device password at a regular frequency. Password change frequency (days) If Enforce change password is set to Yes, enter the interval, in days, at which the user is required to change the device password. Unique passwords before reuse permitted The VMP Server stores a list of the most recently used passwords for a device. A password cannot be reused if it is one of the N most recent passwords used, where N is the value of this option. Maximum failed attempts before device wipe Enter the number of times a password can be incorrectly entered before all system sensitive information is wiped from the device. Data Encryption 95

96 Password Enforcement 96 Vocera Messaging Platform Administration Guide

97 Vocera Messaging Platform Failover The Vocera Messaging Platform is designed to support clustered environments using active server and passive server configuration. In a clustered environment, the primary server: Routes system traffic. Responds to the load balancer acknowledgment request every ten seconds. Updates the SQL server timestamp every two seconds. Secondary nodes retrieve a timestamp from the SQL server every two seconds, but stay passive unless the primary node fails. The load balancer manages the status of each VMP Server by sending a health check request to the primary and secondary nodes. The load balancer redirects traffic to a secondary node after a third missed heartbeat from the primary node. Note: For instructions on how to install VMP on a cluster, see Installing a VMP Cluster. Health monitoring can be configured to ensure connections are maintained at all times. For information about configuring health monitoring, see Establishing Health Monitoring on the VMP Server. Best Practice: Configure alert notifications to receive an alert when a failover occurs. For details, see Establishing Configure Failover Notifications. Best Practice: The BES instance should also be clustered. For details, see High Availability for the BES Server. Vocera Messaging Platform Failover 97

98 Configuring Vocera Messaging Platform Failover Configuring Vocera Messaging Platform Failover Use the following steps to create a DNS round robin clustered Vocera Messaging Platform server with a secondary IP address associated with the main server hostname. In this scenario, the secondary node points to the SQL server. Using DNS, the VMP host name should point to two separate IP addresses. This method provides a path for ensuring that if the primary VMP Server were to fail, DNS would automatically failover to a secondary VMP instance with a secondary IP address. This would be considered a DNS Round Robin methodology. In the event of a failover, the VMP services must be manually re-started for the application to function. The data exchange service is restarted on the secondary node and the WTV service is restarted in the secondary node. 1. Add the IP address for each node as the VMP hostname on the DNS server. 2. If your network is using non-standard ports, configure the network port information. a. Start the VMP Enterprise Manager, and select Configuration. b. Enter the network port information. c. Click Save. When prompted, click OK to restart the Vocera Data Exchange Service. 98 Vocera Messaging Platform Administration Guide

99 VMP Server Failover Configuration Scenarios If DNS fails over to the secondary node, the required VMP services must be restarted. The secondary failover should also be pre-configured to point to the correct SQL database. For details about post-failover tasks, see Post Failover Configuration. VMP Server Failover Configuration Scenarios Table 22. VMP Server Failover Configuration Scenarios Node Description Primary Vocera Messaging Platform (VMP Server 1) The primary server is accepting all HTTPS traffic. The primary server is responding with a positive acknowledgment request from the load balancer every 10 seconds. The primary server is updating the SQL server with a timestamp every 2 seconds. Secondary Vocera Messaging Platform (VMP Server 2) The secondary server is the standby server. The secondary server is not responding with a positive acknowledgment request from the Load Balancer every 10 seconds. The secondary server is retrieving a timestamp from the SQL server every 2 seconds. If the SQL timestamp table has not been updated by VMP Server 1 within 20 seconds, VMP Server 2 will automatically start its HTTP interface and begin to accept traffic from the Load Balancer. The Load Balancer in conjunction with the VMP Server pair The Load Balancer is sending an HTTP health check request to both VMP Server 1 and VMP Server 2. After a third response failure from VMP Server 1, the Load Balancer will start routing traffic to VMP Server 2 (This will happen once VMP Server 2 has initialized its HTTP interface and is accepting requests.). Vocera Messaging Platform Failover 99

100 Configure Failover Notifications Node Description The SQL Server in conjunction with the VMP Server pair VMP Server 1 is updating a timestamp in the SQL Timestamp Table every 2 seconds. VMP Server 2 is retrieving the timestamp from the SQL Timestamp Table every 2 seconds. Configure Failover Notifications Use the following steps to configure failover notifications: To configure failover notifications: 1. From the Vocera Messaging Platform Server, start the VMP Enterprise Manager: Start > All Programs > VMP > VMP Enterprise Manager 2. Select Configuration > Advanced Options. 3. Enter the SMTP mail settings for your deployment. 100 Vocera Messaging Platform Administration Guide

101 Establishing Health Monitoring on the VMP Server 4. Enter the notification address under Logging settings. If a failover occurs, the following is sent: Message from the VMP server: VMPSERVER2 VMPSERVER2 server becomes active application server Establishing Health Monitoring on the VMP Server Vocera recommends using Health Monitoring in a clustered VMP Server environment. Health monitoring helps you ensure steady access to the BES MDS service by initiating an SNMP push request, from the VMP Server to the BES MDS service every thirty seconds. When the Health Monitor feature is active, an alert is sent to the administrator if the connection fails. Error notifications are sent to the address provided during installation. Note: SNMP must be enabled on the BES for monitoring to occur. Table 23. Health Monitoring Features Setting Location Reason Health Monitoring Service (MDS check) VMP Server When configured, this option sends a continuous ping to the BES Server to ensure that connection is active between the BES MDS service and the VMP Server. Health Monitoring Service (SRP check) VMP Server When configured, this option sends a continuous ping to the BES Server to ensure that connection is active between the BES SRP service and the RIM NOC center. Error Notification VMP Server This option sends alerts when a connection error occurs. Vocera Messaging Platform Failover 101

102 Establishing Health Monitoring on the VMP Server Establishing Health Monitoring on the VMP Server Use the following steps to configure the failover Health Monitor. Configuring the Health Monitor 1. Start the VMP Administrator Console: Start > All Programs > VMP > VMP Administrator Console 2. Select Configuration > Wireless Gateways. 3. Highlight the desired instance, and click to activate the Enable Health Monitoring checkbox. 4. Configure the notification settings using the steps in Configure Failover Notifications. Post Failover Configuration Primary VMP Server - VMP Server VMP Server 1 is now the secondary (passive) server. 2. VMP Server 1 will attempt to send an to the Administrator to indicate that a failover has occurred. Secondary VMP Server - VMP Server VMP Server 2 is the primary (active) server and is accepting HTTPS traffic from the load balancer. 2. VMP Server 2 will send an to the administrator indicating its primary server status. 3. VMP Server 2 is updating the SQL server with a timestamp every 2 seconds. The Load Balancer is working in conjunction with the VMP Server pair. The Load Balancer is now redirecting all HTTPS traffic to VMP Server Vocera Messaging Platform Administration Guide

103 Post Failover Configuration Post Failover Manual Required Steps. Once a failover has occurred, the Load Balancer is now directing the HTTPS traffic to the secondary VMP Server (VMP Server 2). Once this action has started, the Administrator will receive an indicating that VMP Server 2 has become the primary server. 1. VMP Server 1 is to be restarted as the primary VMP Server 2. The Administrator must shut down the Vocera Data Exchange Windows service on VMP Server The Administrator must restart the Vocera Data Exchange Windows service on VMP Server VMP Server 1 will assume primary server status. 5. The Administrator must restart the Vocera Data Exchange Windows service on VMP Server VMP Server 2 will assume secondary server status. If VMP Server 1 is to remain as the secondary server: required. No further action is Vocera Messaging Platform Failover 103

104 Using SSL in a VMP Failover Environment Using SSL in a VMP Failover Environment If you want to use SSL in a clustered VMP Server environment, Vocera recommends that you put an SSL certificate on each node on which a VMP Server is running. This ensures that all internal traffic between the Load Balancer and each of the individual servers is secure, which may be a requirement in your jurisdiction if you are transmitting patient information. Best Practice: Although a self-signed certificate is supported, it is best to use a publicly-registered SSL certificate for each VMP Server in your cluster. To determine whether you need an SSL certificate for your Load Balancer to ensure end-to-end encryption, consult the specifications provided by the manufacturer of the Load Balancer. 104 Vocera Messaging Platform Administration Guide

105 VMP Server Log Files VMP Server Log Files In the event of a failover scenario, the VMP Server log files include a log entry describing the failover to a standby server and the startup details for the new active node. The server log files are stored in the following directory: C:/Program Files/Wallace/WIC/Logs Vocera Messaging Platform Failover 105

106 VMP Server Log Files 106 Vocera Messaging Platform Administration Guide

107 Remote Wipe Vocera Messaging Platform includes a remote wipe option to let you remove sensitive information from a client via Microsoft Exchange and most MDM solutions. This is useful when a user is no longer employed by the organization, a device is lost or stolen, a shared device is assigned to a new user, or in the event of a communicated security breach. Vocera Messaging Platform allows for the following remote wipe options: Remove the User from the Vocera Messaging Platform - Use the VMP Administrator Console to remove the user from the platform database and automatically wipe the device. Microsoft Exchange Server Send a command to a mobile phone to perform a remote device wipe. This process removes all the information stored on the device and completes a full reset of the device. EMC Shell - Use the EMC shell to remove the information from the device. Outlook Web - Log on to the Outlook Web application as the user to remove the data from the associated device(s). Performing a Remote Wipe Use the following steps to perform a remote wipe from the VMP Administrator Console. Delete a User Account and Remove Application Data 1. Select the Users & Groups module, and click to highlight the user to remove. 2. Select the Delete button. A window will prompt the administrator to remotely wipe the data from the smartphone. Once complete, the user account will be inactive on the server, and VMP data will be removed from the user's device. Remote Wipe 107

108 Performing a Remote Wipe Use the following steps to perform a remote wipe using Microsoft Exchange. Note: This process is specific to ios or Android devices. Perform a Remote Wipe Using Microsoft Exchange 1. In the console tree, navigate to Recipient Configuration > Mailbox. 2. Select the user from the Mailbox window. 3. In the action pane, click Manage mobile device, or right-click the user's mailbox, and click Manage mobile device. 4. Select the mobile phone. 5. In the Actions section, click Clear, and click Clear again. Use the following steps to perform a remote wipe using Outlook Web. Note: This process is specific to ios or Android devices. Perform a Remote Wipe Using Outlook Web 1. Open the Outlook Web Application in a browser. 2. Sign in to the device owner's mailbox, and click Options. 3. In the Navigation Pane, select Phone. 4. Click the Mobile Phones tab. 5. Select the ID of the mobile phone that you want to wipe and remove from the list. Click Wipe device and click OK. 6. Click Remove Device. Use the following steps to perform a remote wipe using an Mobile Device Management (MDM) Solution. Using an Mobile Device Management (MDM) Solution to perform a Remote Wipe 1. Submit a wipe request through the console, MDM Shell, or Self Service Portal. Submit the request as a Wipe Now command stored in a central database to be picked up by the device within a determined time in travel. 2. The device receives this Alert and immediately starts a management session with the Device Management server. 3. The device picks up its wipe request from the Device Management server, sends back an acknowledgement that started the wipe, and starts the wipe process. 108 Vocera Messaging Platform Administration Guide

109 Performing a Remote Wipe Use the following steps to perform a ECS (Exchange Management Shell) remote wipe. Performing an ECS (Exchange Management Shell) Remote Wipe 1. Send a Get-ActiveSyncDeviceStatistics command, using the following syntax, where name is the user id: Get-ActiveSyncDeviceStatistics - Mailbox name fl Identity 2. Send a Clear-ActiveSyncDevice command, using the following syntax, where name is the user id: Clear-ActiveSyncDevice -Identity WM_name Remote Wipe 109

110 Performing a Remote Wipe 110 Vocera Messaging Platform Administration Guide

111 The VMP Administrator Console This part of the manual describes the features of the VMP Administrator Console. The VMP Administrator Console Content Distribution Lists Messaging and Chat Alerts Alarms Reports Users and Groups Contacts Configuration The VMP Administrator Console 111

112 112 Vocera Messaging Platform Administration Guide

113 The VMP Administrator Console The VMP Administrator Console is installed on the VMP Server. You can also install the VMP Administrator Console on a separate machine. Use the VMP Administrator Console console to: Configure users to receive messages via the BES/MDS, BlackBerry Push API s, Apple PNS, Android C2DM, or SMS. Create and manage users and access groups Create and manage distribution lists Create and manage on-call distribution lists Create and manage alert templates Send alerts, create response options, view the status of alerts Configure alarms The console includes the following modules: Table 24. VMP Administrator Console Modules Module Description Content Module Add media assets to the VMP Server for use from the client. Messaging Module View chat logs, and create and manage chat distribution lists and alert templates. Alerts Module Configure alert notification settings and create alert templates. Alarms Module Configure alarm rules and create new alarms. Reports Module Generate view incidents and logs, and create and send reports. Users & Groups Module Import, configure, and manage users. The VMP Administrator Console 113

114 Standalone VMP Administrator Console Requirements Module Description Contacts Module Create and manage contacts, groups, and distribution lists. Configuration Module Configure wireless gateways, contact fields and source mapping, synchronization, and configure plugins. Standalone VMP Administrator Console Requirements The VMP Administrator Console can be installed on a server other than the VMP Server. It can also be installed on the administrator's personal computer. To use the VMP Administrator Console on a standalone server, you must have the following: VMP Setup.exe. This must be the same build used to create the VMP Server. SQL server name and instance name Remote connections enabled on the SQL server The Wicauth credentials Active Directory server IP address Installing the VMP Administrator Console on a Standalone Server Use the following steps to install the VMP Administrator Console on a standalone server. Installing the VMP Administrator Console on a Standalone Server 1. Start Setup.exe on the desired server. 2. Accept the license agreement and click Next. 3. In the Software Type dialog box, select VMP Administrator. Click Next. 114 Vocera Messaging Platform Administration Guide

115 Using Active Directory Authentication 4. Accept the default Destination Folder, or click Browse to select a custom installation folder, then click Install. 5. In the VMP Enterprise Manager Configuration window, click in the Server row Value column, and enter the IP address for the SQL server. 6. In the Active Directory Server row, click in the Value column and enter the IP address for the Active Directory server. 7. Click Save and close the VMP Enterprise Manager. 8. Click Finish. Using Active Directory Authentication The VMP Administrator Console and VMP Web Console can be configured to accept Active Directory credentials as a default. Use the following steps to configure this option. To configure VMP for default Active Directory authentication: 1. From the Vocera Messaging Platform Server, start the VMP Enterprise Manager: Start > All Programs > VMP > VMP Enterprise Manager 2. Select Configuration, and scroll down to Allow any Active Directory user to login (display login/password form). The VMP Administrator Console 115

116 Using Active Directory Authentication 3. Set the value to true. 4. Click Save. 5. Click Yes to restart the application server. 116 Vocera Messaging Platform Administration Guide

117 Content The Content module provides the tools to manage documents and image files that are stored on the VMP Server and can be distributed and shared with licensed devices. The content module is designed to deliver floor-plans, forms, and other essential team documents from the client. Content is uploaded and managed by the administrator. When a file is uploaded to the VMP Server, the title and upload date are posted to the main screen of the console. VMP supports the following file types: HTML file Image file (JPEG, GIF, BMP and PNG) PDF file Microsoft Word document Text To support Word, Excel, and PDF, the VMP Server must have Microsoft Word, Excel, and Adobe Acrobat Reader installed in order to properly format the documents for the device. The My Content view provides a list of the current documentation in the configured hierarchy. Content 117

118 Adding Content Features of this view include: Content view window Activate or deactivate device presence Content update timestamp Network path information Adding Content Use the following steps to add content using the VMP Administrator Console. Adding Content 1. Open the VMP Administrator Console application and select: Content > My Content 2. If you are adding content to an existing folder, or as a child to an existing content instance, click to highlight the folder or instance. 3. Click Open to open the New Content view. 4. Click to highlight the document type and click Browse to select the new document. 118 Vocera Messaging Platform Administration Guide

119 Editing Content Note: The Name field contains the document name, and it auto-populates based on the selected document. If you enter a name in the Name field, it will persist. 5. If the document resides on a network that requires credentials, enter the credentials. 6. Optionally, you can select Map network document. Mapping allows you to configure automatic synchronization for document updates. If desired, select this option and configure a synchronization interval. 7. If the document type you have selected is Word document or HTML document, the Document style dropdown list appears. Select the document style to use. 8. If the document type you have selected is Word document, Excel document, or HTML document, the Use first tables row as column names dropdown list appears. Select one of the following: Yes Use the entries in the first row of the table as the column names. No Do not use table row entries as column names. Use parent folder settings Use the settings specified in the parent folder. 9. In the Options section, select Insert as a root node to insert the new document into the My Content folder, or select Insert as a child to selected node to insert the new document into the selected folder. 10. Click OK to close the dialog and upload the document to the server. Editing Content Use the following steps to define document privileges. Content 119

120 Managing Content Assigning Document Permissions 1. Open the VMP Administrator Console application and select: Content > My Content 2. Click to highlight the folder or document, and select Edit. 3. If the document is a Word document or an HTML document, from the Document style dropdown list, select the document style to use. 4. If the document is a Word document, an Excel document, or an HTML document, from the Use first tables row as column names dropdown list, select one of the following: Yes Use the entries in the first row of the table as the column names. No Do not use table row entries as column names. Use parent folder settings Use the settings specified in the parent folder. 5. Click OK to save your changes. Managing Content Use the VMP Administrator Console to manage permissions for files uploaded to the VMP Server. Use the following steps to define document privileges. 120 Vocera Messaging Platform Administration Guide

121 Managing Content Assigning Document Permissions 1. Open the VMP Administrator Console application and select: Content > My Content 2. Click to highlight the folder or document, and select Manage Permissions. 3. Choose the Users or Groups tab, and select New. 4. Click to highlight one or more entries. 5. Select one or more of the following permission options: Allow updates Allow delete Allow manage access Visible in device by default 6. Click OK. Note: To filter the list of entries, click Filter Filter.. To reset filtering, right-click Content 121

122 Managing Content 122 Vocera Messaging Platform Administration Guide

123 Distribution Lists Distribution Lists (DLs) are created in the Alerts module or the Messaging module of the VMP Administrator Console. You can create the following types of DL: Regular and On-Call Distribution Lists Escalation Distribution Lists Note: DLs created from the Alerts module are identical to those created from the Messaging module. The only difference is whether Alerts are enabled by default or not. The Alert Distribution List and Chat Distribution List views show a list of all available DLs. Use either of these views to perform the following tasks: Table 25. Distribution List View Tasks Task Icon Description Create a new Regular or Escalation DL. Edit the highlighted DL. Delete the highlighted DL. Distribution Lists 123

124 Creating a Regular or On-Call Distribution List Task Icon Description Manage access to the highlighted DL. View all members of the highlighted DL. Each view includes the following fields: Table 26. Distribution List View Fields Field Description Name The name of the DL. On-Call and Escalation DLs are marked with a bracketed indicator of the type of list. Sort the list by name using this field. Type Identifies the DL as Regular or Escalation. On-Call DLs are listed as regular DLs. Use this field to sort the list by Type. Enabled for Vocera Alert Indicates Alert permissions with a Yes or No value. Members The total number of DL members. Enabled for Vocera Chat Indicates Chat permissions with a Yes or No value. Chat-Capable Members The number of DL members that are able to send and receive chat communications. Creating a Regular or On-Call Distribution List Use the following steps to create a regular Distribution List (DL). You can specify that this list is to be an On-Call Distribution List. Creating a Distribution List 1. Open the VMP Administrator Console application and select: Messaging > Distribution Lists 2. Click New or Alerts > Distribution Lists and select New Regular Distribution List. 124 Vocera Messaging Platform Administration Guide

125 Creating a Regular or On-Call Distribution List 3. In the Distribution List Name field, enter the name of the new DL. 4. In the Distribution List ID field, enter the ID of the new DL. 5. Select Enable for Vocera Alert if you want this DL to be available to Alert users. 6. If Enable for Vocera Alert is selected, you can select On-Call Distribution List to ensure that DL members receive Alerts only if their status is OnCall or Monitor. In the Minimum Users On-Call field, select or type the minimum number of users that can be On-Call at any one time. Note: You can create On-Call DLs to manage shift assignments and Alert communication coverage. 7. Select Enable for Vocera Chat if you want this DL to be available to Chat users. 8. If options exist that indicate how users can be added, select either Add Users Manually or Create DL based on Active Directory structure. Note: If these options do not exist, your only option is to add users manually. 9. Click Next. 10. If you are adding users manually: a. Type in the Search field to display only users whose names contain the search string. Click Clear to clear the search string. b. If Enable for Vocera Chat has been selected, select All Users to display all users, or select Chat-Capable Users to display only users that have Chat enabled. Note: If a search string has been specified, only users whose names contain the search string are listed. c. Click to highlight a user, and then click > to move the user to the Distribution List. You can click to highlight one or many users. To move all users to the Distribution List, click >>. Distribution Lists 125

126 Creating a Regular or On-Call Distribution List d. If the DL is an On-Call DL: Select Edit Personal On-Call Status to let users edit their own oncall status. Select Edit On-Call Status For All to let users manage the on-call status for all members of the DL. In the Current On-Call Status dropdown list, specify the on-call status for each user. Select Not On-Call, Monitor, or On-Call. e. Click Next. 11. If you are creating the DL from an existing Active Directory structure, select the users and groups from the tabbed lists, and click Next. 126 Vocera Messaging Platform Administration Guide

127 Creating an Escalation Distribution List 12. The DL Access window appears, which lets you select the users and groups who will have permission to send Alerts to this DL. Type in the Search field to display only users whose names contain the search string. Click Clear to clear the search string. 13. Click to highlight a user, and then click > to give the user permission to send an Alert to this Distribution List. You can click to highlight one or many users. To give all users permission to send Alerts, click >>. 14. Click Finish to create the DL. Creating an Escalation Distribution List Use Escalation Distribution Lists to improve message response times by forwarding the message through a defined escalation workflow. For each list, one or more branches of groups or users is defined. When a message is sent to the list, it is sent to the first branch. If no one in the first branch responds in the specified time, the message is escalated to the next branch. It is then escalated to additional branches if necessary. Creating an Escalation Distribution List 1. Open the VMP Administrator Console application and select: Messaging > Distribution Lists 2. Click New or Alerts > Distribution Lists and select New Escalation Distribution List. Distribution Lists 127

128 Creating an Escalation Distribution List 3. In the Distribution List Name field, enter the name of the new DL. 4. In the Distribution List ID field, enter the ID of the new DL. 5. Use the Delivery Route dropdown list to select from one of the following options: Table 27. Delivery Route Options Option Description Delivery based on the preference of the Recipient Let the user's preference settings determine how alerts and chats sent to the DL are to be delivered. Deliver only to Vocera Voice Users who are on the network and available. Messages sent to the Distribution List are delivered only to active members who are currently logged onto the Vocera Server and are not in DND mode. Deliver only to VMP users (for smart/mobile client) Messages sent to the Distribution List are delivered only to the user's smartphone client. 6. Next, create the branches for the Escalation Distribution List: a. Click New to add a New Branch to the Escalation Distribution List. Each branch contains one set of users to be contacted. If the response criteria are not met, the Escalation Distribution List escalates to the next branch. b. In the New Branch dialog box, type in the Search field to display only users whose names contain the search string. Click Clear to clear the search string. c. Filter the selection criteria using one of the following options: All Users Distribution Lists Note: If a search string has been specified, only users whose names contain the search string are listed. d. Click to highlight a user, and then click > to move the user to the new branch of the Escalation Distribution List. You can click to highlight one or many users. To move all users to the new branch, click >>. 128 Vocera Messaging Platform Administration Guide

129 Creating an Escalation Distribution List e. Use the Criteria dropdown list to specify the response criteria. If these criteria are not met, the message is escalated. The available response criteria are: At least one user(s) delivered At least one user(s) opened At least one user(s) responded All users delivered All users opened All users responded f. Set the timeout value and click OK to continue. g. Repeat these steps as necessary to create additional branches. 7. Click Next. The Group Assignment window appears, which lets specific users and groups access the DL. 8. Click the Users tab to add a user to the access list, or click Groups to add a group: Distribution Lists 129

130 Maintaining a Distribution List a. Click to display a list of users or groups. b. Select one or more users or groups from the list. c. Click OK to add the users or groups to the list. d. Repeat the above steps to add additional users or groups. 9. Click Finish to create the DL. Maintaining a Distribution List When you have created a Distribution List or an Escalation Distribution List, you can edit the list, add or delete users in the list, view the members of the list, or delete the list. Editing a Distribution List 1. Open the VMP Administrator Console application and select: Messaging > Distribution Lists or Alerts > Distribution Lists 2. Click the name of a Distribution List to select it. Note: On-Call Distribution Lists are labeled with the prefix [On-Call]. Escalation Distribution Lists are labeled with the prefix [Escalation]. 3. Click Edit. 4. The instructions for editing a Distribution List are the same as those for creating a list: If you are editing a regular Distribution List, see Creating a Distribution List. If you are editing an Escalation Distribution List, see Creating an Escalation Distribution List. Adding or Deleting Users in a Distribution List 1. Open the VMP Administrator Console application and select: Messaging > Distribution Lists 2. Click the name of a Distribution List or Escalation Distribution List to select it. 3. Click Manage Access. The Distribution List Access dialog box appears. 4. To add users to the list, click Add. In the dialog box that appears, click the names of the users to add, and then click OK. 130 Vocera Messaging Platform Administration Guide

131 Maintaining a Distribution List 5. To delete users from the list, click the names of the users to delete, and then click Delete. When asked whether you want to remove these users, click Yes. 6. When you have finished adding and deleting users, click Close. Viewing the Members of a Distribution List 1. Open the VMP Administrator Console application and select: Messaging > Distribution Lists 2. Click the name of a Distribution List or Escalation Distribution List to select it. 3. Click View Members. A dialog box appears, containing a list of Distribution List members. 4. Click OK to close the dialog box. Deleting a Distribution List 1. Open the VMP Administrator Console application and select: Messaging > Distribution Lists 2. Click the name of a Distribution List or Escalation Distribution List to select it. 3. Click Delete. 4. In the dialog box that appears, click Yes to confirm that you want to delete the list. Distribution Lists 131

132 Maintaining a Distribution List 132 Vocera Messaging Platform Administration Guide

133 Messaging and Chat The VMP Administrator Console Messaging Module provides features for: Creating Distribution Lists and Escalation Distribution Lists Initiating a Chat with a contact Managing Chat logs Creating Notify Alert Templates For information about creating Distribution Lists and Escalation Distribution Lists, see Distribution Lists. The Vocera Messaging Platform provides options for source synchronization to easily import user and group contact data. For details about auto synchronization, see Importing Users and Contacts. Chat The Chat capability lets you communicate with any licensed user in real time. The Chat user base is formed from source users, organized into distribution lists. Chats can be initiated from the VMP Administrator Console. Initiating a Chat from the VMP Administrator Console Use the following steps to initiate a Chat. Initiating a Chat 1. From the VMP Administrator Console, select: Messaging > Chat Messaging and Chat 133

134 Viewing the Chat History 2. From the list of users that appears, select the user with which you want to initiate a Chat. 3. Right-click and select Chat to. A Chat session is started, and a Chat window is displayed. The user's name is displayed in a tab at the bottom of the Chat window. 4. In the bottom pane of the Chat window, type the text that you want to send to the user. Your typed text, and the user's responses, appear in the top pane of the Chat window. 5. To initiate a separate Chat session with an additional user, select the user, right-click, and select Chat to. A tab for this user's Chat session appears. To switch from one Chat to another, click on the tab for the user that you want to Chat with. 6. To close a Chat session, click. Viewing the Chat History From the VMP Administrator Console, you can view the Chat history for a user. Viewing the Chat History 1. From the VMP Administrator Console, select: Messaging > Chat 134 Vocera Messaging Platform Administration Guide

135 Notify Alerts 2. From the list of users that appears, select the user whose Chat history you want to view. 3. Right-click and select View history. The Chat history window appears. 4. Click on the left or right arrow button to select a month to view, then click on a day of that month. Chats for that day are displayed. 5. When you have finished viewing the chat history, click Close to close the chat history window. Notify Alerts Notify Alerts can be sent from the VMP Administrator Console to predefined user groups. You can: Send alerts to licensed and unlicensed users Send alerts using predefined alert templates Request send receipts or provide multiple choice response options Create a Bridge to Conference (if available in your organization) Sending a Notify Alert Use the following steps to send a Notify Alert from the VMP Administrator Console. Creating a New Notify Alert 1. From the VMP Administrator Console, select: Messaging > Alerts Messaging and Chat 135

136 Sending a Notify Alert 2. Click New Notify Alert to open the New Alert dialog. 3. In the Contacts tab, click Configure to select the distribution list or individual contact, and click OK to close the Select Contacts dialog. Note: To filter the list of contacts, click Filter click Filter.. To reset filtering, right- 4. Click the Text tab to compose the alert. Click Load From Template to use an existing alert template. 5. Click the Options tab to select response, receipt, and bridge options. Table 28. Notify Alert Options Option Description Get Response Allow recipients of the alert to respond using multiple choice responses set by the administrator. Click the Responses tab to define the response options. Get Receipt Create a single-option multiple choice response. 136 Vocera Messaging Platform Administration Guide

137 Notify Alert Templates Option Description Bridge to Conference Enter the Bridge number and Bridge ID. If MIR3 textto-speech is used, the bridge information is passed to the MIR3 system. To add a Multiple Choice Response Option, select Get Response from the Options Tab. 6. Click the Contact By tab to configure the response contact point. 7. Click Send to send the alert. Notify Alert Templates Notify Alert Templates are predefined messages that users can leverage to quickly create frequently sent Notify Alerts. In Notify Alert Templates, you can specify the attributes of Notify Alerts created from this template, include: The Distribution Lists and Contacts that are to receive the Notify Alerts The default subject and text for the Notify Alerts Whether a response or receipt is required Creating Notify Alert Templates Use the following steps to create a Notify Alert Template. Create a Notify Alert Template 1. To create a Notify Alert Template, from the VMP Administrator Console, navigate to: Messaging > Alert Templates 2. Click New.. The New Alert Template window appears. Messaging and Chat 137

138 Notify Alert Templates 3. Click the Contacts tab, and click Configure. 4. Select the check boxes next to the Distribution Lists and Contacts that you want to be included in this Notify Alert Template, and click OK. 5. Click the Text tab, and do the following: a. In the Subject field, type the subject header for this Notify Alert Template. b. In the Body field, type the default text to be contained in the Notify Alert Template. c. Click OK. 6. Click the Options tab to select response, receipt, and bridge options: Table 29. Notify Alert Options Option Description Get Response Allow recipients of Notify Alerts sent using this template to respond using multiple choice responses set by the administrator. Click the Response tab to define the response options. Get Receipt Create a single-option multiple choice response. Bridge to Conference Enter the Bridge number and Bridge ID. If MIR3 textto-speech is used, the bridge information is passed to the MIR3 system. To add a Multiple Choice Response Option, select Get Response from the Options Tab. Click OK when you have finished selecting options. 7. Click the Contact By tab, and select the check boxes of the methods to use to contact the users or distribution groups specified in the Contacts tab. 138 Vocera Messaging Platform Administration Guide

139 Notify Alert Templates 8. Click the Assign tab to specify groups that are to be given permissions on this Notify Alert Template. To add a group and specify its permissions, click Add, highlight a group to add, and select one or more permission check boxes: Allow update Allow delete Manage access Click OK when done. 9. To edit permissions for a group, highlight the group and click Edit. In the Edit Permissions dialog, select or unselect the check boxes to update the permissions for the group, and click OK when done. 10. To delete a group from the list of specified groups, highlight the group and click Delete, and then click Yes to confirm that you want to delete the group. 11. Click OK to create the Notify Alert Template. Editing Notify Alert Templates You can edit, delete, or change permissions for a Notify Alert Template that you have created. Editing a Notify Alert Template 1. In the VMP Administrator Console, select: Messaging > Alert Templates 2. Highlight the Notify Alert Template that you want to edit and click Edit. 3. Click the Contacts tab, and click Configure. Select the Distribution Lists and Contacts that you want to add or remove, and click OK. Note: To filter the list of contacts, click Filter click Filter.. To reset filtering, right- 4. Click the Text tab to change the default subject and body for the Notify Alert Template. 5. Click the Options tab to change the response, receipt, and bridge options. Note: For more information on these options, see Creating Notify Alert Templates. 6. Click the Contact By tab to change the contact points to use. Messaging and Chat 139

140 Notify Alert Templates 7. Click OK to finish editing the Notify Alert Template. Deleting a Notify Alert Template 1. In the VMP Administrator Console, select: Messaging > Alert Templates 2. Highlight the Notify Alert Template that you want to delete and click Delete. 3. In the confirmation dialog box that appears, click Yes to confirm that you want to delete the Notify Alert Template. Changing Permissions for a Notify Alert Template 1. In the VMP Administrator Console, select: Messaging > Alert Templates 2. Highlight the Notify Alert Template that you want to change permissions for, and click Manage access. 3. In the Alert Template Permissions dialog box: a. Click Add to add a group to the list of groups with permissions. In the New Permission dialog box, highlight a group and click one or more permission checkboxes: Allow update Allow delete Manage access Click OK when done. b. Click Edit c. Click Delete permissions. to edit the permissions of a group. to delete a group from the list of groups with 4. Click Close to close the Alert Template Permissions dialog box. 140 Vocera Messaging Platform Administration Guide

141 Alerts Use the Alerts module to: Create and send Alerts. View and manage Alerts that have been sent. Create and edit Alert Templates. Create On-Call and Escalation Distribution Lists. Note: Alerts cannot be sent to groups. You must create Distribution Lists for Alert users. For details on creating distribution lists, see Distribution Lists. Creating Alerts Use the following steps to create a new alert. Creating a New Alert 1. To create a new Alert, select: Alerts > Alerts 2. Click New. Alerts 141

142 Creating Alerts 3. Click to highlight the user and click > to move the user to the recipient list. You can click to highlight one or many users. Best Practice: Start typing the name of a user or group in the Search box to quickly find a contact. 4. Click Next. The Message & Options window appears. 5. In the Subject field, enter the subject heading for the Alert. 6. In the Message field, enter the text of the Alert. 7. From the Priority dropdown list, select the message priority: High, Normal, or Low. 142 Vocera Messaging Platform Administration Guide

143 Managing Alerts 8. From the Alert expiration dropdown list, select the time in minutes before the Alert expires. Select Never if you do not want the Alert to expire. Select Other to specify the expiration time. 9. To override the user's Do Not Disturb setting, select the Override notifications check box. This check box is selected by default when the message priority is set to High. Note: You can't override the user's Do Not Disturb setting if the user has also set Do Not Override. 10. Choose a response option from one of the following: None Multiple Choice Responses Text Responses 11. If you selected Multiple Choice Responses, click Next to provide the response options: a. Click Add to add a response. Type the text of the response in the dialog box provided, and click OK. b. Click Edit c. Click Delete to edit a response that you have created. to delete a response that you have created. d. To rearrange the responses, click on a response to highlight it. Click Move Up to move the response up in the list, or click Move Down to move the response down. Repeat until the responses are in the order that you want. 12. Click Finish to send the alert. Managing Alerts The VMP Administrator Console lets you view and manage alerts sent from the VMP Server. To manage alerts, open the Alert view: Alerts > Alerts Click to highlight an alert. The Alert Statuses view provides an at a glance summary of the selected alert. Alerts 143

144 Alert Templates Click Search are available: to display the View Alert window. The following alert details From the To tab, you can view the alert recipient(s). From the Message & Options tab, you can view the following alert details: Subject Message Priority Expired at Override notifications Response Alert Templates Alert Templates are predefined Alert messages that users can leverage to quickly create frequently sent Alerts. 144 Vocera Messaging Platform Administration Guide

145 Creating Alert Templates Templates can be assigned permissions based on distribution lists. Templates can be configured to allow the user to edit the message and delivery parameters from the client. Templates can be assigned to distribution lists for frequently communicating alerts to a set of users. Templates are made available for the smartphone client and the VMP Web Console. Creating Alert Templates Create an Alert Template 1. To create a Template, open the VMP Administrator Console and navigate to: Alert > Alert Templates 2. Click New.. 3. Click to highlight each user or group who will receive an alert when the template is used, and click > to add the users and groups to the alarm Distribution List (DL). When the users are added, click Next. Alerts 145

146 Creating Alert Templates 4. Enter the following template details, and click Next: Table 30. Alert Template Options Option Description Subject The subject line of the message. Message The message text. Priority The message priority can be: High Normal Low Override Notifications Select this check box to override the user's Do Not Disturb setting (if the user has not also set Do Not Override). This check box is selected by default when the message priority is set to High. Response Choose from one of the following response options: None Multiple Choice Responses Text Responses 5. If you selected Multiple Choice Responses, click Next to provide the response options: a. Click Add to add a response. Type the text of the response in the dialog box provided, and click OK. 146 Vocera Messaging Platform Administration Guide

147 Editing Alert Templates b. Click Edit c. Click Delete to edit a response that you have created. to delete a response that you have created. d. To rearrange the responses, click on a response to highlight it. Click Move Up to move the response up in the list, or click Move Down to move the response down. Repeat until the responses are in the order that you want. e. Click Next when you are finished creating responses. 6. Click to highlight each group that can use the template, and click >. When the groups are added, click Finish. Editing Alert Templates You can edit, delete, or change permissions for an Alert Template that you have created. Editing an Alert Template 1. In the VMP Administrator Console, select: Alerts > Alert Templates 2. Highlight the Alert Template that you want to edit and click Edit. 3. Add or remove users or Distribution Lists that will receive an alert when this Alert Template is used: a. To add a user or Distribution List, find the user or Distribution List in the left pane of the Edit Alert Template dialog. Highlight the user or Distribution List, and click >. b. To remove a user or Distribution List, highlight it in the right pane of the Edit Alert Template dialog and click <. When you have finished adding and removing users and Distribution Lists, click Next. 4. Edit the Subject, Message, and Priority fields and change the Response radio button as needed. Click Next when finished. Note: For more information on these options, see Creating Alert Templates. 5. If you selected Multiple Choice Responses, you can update the response options: a. Click Add to add a response. Type the text of the response in the dialog box provided, and click OK. Alerts 147

148 Editing Alert Templates b. Click Edit to edit a response that you have created. c. Click Delete to delete a response that you have created. d. To rearrange the responses, click on a response to highlight it. Click Move Up to move the response up in the list, or click Move Down to move the response down. Repeat until the responses are in the order that you want. e. Click Next when you are finished updating responses. 6. To update the list of groups that can access the Alert Template: a. To add a group, highlight it in the left pane of the Template Access dialog and click >. b. To remove a group, highlight it in the right pane and click <. 7. Click Finish when you have finished editing the Alert Template. Deleting an Alert Template 1. In the VMP Administrator Console, select: Alerts > Alert Templates 2. Highlight the Alert Template that you want to delete and click Delete. 3. In the confirmation dialog box that appears, click Yes to confirm that you want to delete the Alert Template. Changing Permissions for an Alert Template 1. In the VMP Administrator Console, select: Alerts > Alert Templates 2. Highlight the Alert Template that you want to change permissions for, and click Manage access. 3. In the Alert Template Permissions dialog box: a. Click Add to add a group to the list of groups with permissions. In the New Permission dialog box, highlight a group and click one or more permission checkboxes: Allow update Allow delete Manage access Click OK when done. b. Click Edit to edit the permissions of a group. 148 Vocera Messaging Platform Administration Guide

149 Editing Alert Templates c. Click Delete permissions. to delete a group from the list of groups with 4. Click Close to close the Alert Template Permissions dialog box. Alerts 149

150 Editing Alert Templates 150 Vocera Messaging Platform Administration Guide

151 Alarms The Alarms module lets you define how a client device is to be notified when another user or the VMP Server is communicating with it. Distinct notifications can be defined for each of the following methods of communication: Alerts Chat Messages Content Messages Missed Phone Calls PIN Messages SMS Messages Depending on the method of communication selected, the notification can contain some or all of the following: An indication with the device LED light An MP3 file A pop-up message Vibration A pre-defined alarm tone In the Alarms module, notifications are specified by alarm rules. One or more alarm rules are provided for each method of communication listed above. These rules are displayed in the Rules view. The Rules view includes the following options: Table 31. Rules View Options Option Description Create a new alarm rule. Alarms 151

152 Defining Alarm Tones Option Description Create a new mandatory alarm rule. Edit the highlighted alarm rule. Delete the highlighted alarm rule. Move the highlighted rule up. Move the highlighted rule down. Share the alarm rule with specific users or groups. In the Alarms module, the MP3 view allows you to add your own alarm tones, and to edit or delete existing tones. It includes the following options: Table 32. Rules View Options Option Description Import a new alarm tone in MP3 format. Edit the highlighted alarm tone. Delete the highlighted alarm tone. Play the highlighted alarm tone. Stop playing the highlighted alarm tone. Note: The Play option does not work in a virtual environment. Defining Alarm Tones Use the following steps to define an alarm tone. This tone can be included as part of an alarm rule. 152 Vocera Messaging Platform Administration Guide

153 Creating and Managing Alarm Rules Defining Alarm Tones 1. From the VMP Administrator Console, navigate to: Alarms > MP3 2. Select New. 3. Enter a Name for the file and click the browse button desired MP3 file. Best Practice: Use the Play complete the upload. to navigate to the button to test the sound before you 4. Click OK to save the file as an alarm tone. Creating and Managing Alarm Rules In the Alarms module, you can create alarm rules that indicate how a client device is to receive notifications. One or more alarm rules can be defined for each type of communication. For example, you can define separate alarm rules for high priority alerts, normal priority alerts, and low priority alerts. Use the following steps to create an alarm rule: Creating and Updating Alarm Rules 1. Select Alarms > Alarm Rules. Alarms 153

154 Creating and Managing Alarm Rules 2. Select the tab for the event requiring a new or updated alarm rule. 3. Click to highlight an existing rule for modifications, or click New Rule create a new rule. to 4. Configure the following alarm rule options, and click OK. Table 33. Alarm Rule Configuration Options Option Description Name Enter a name for a new rule or change the name to modify an existing rule. Conditions Configure the rule conditions (see Table 34, Alarm Condition Options on page 154). Actions Configure the visual and audible actions the event triggers (see Table 35, Alarm Action Options on page 159). Description The description provides an overview of the rule logic. Edit rule logic from the description by clicking the associated link. Table 34. Alarm Condition Options Option Description Device in holster Select this option to set the rule when the device is in the holster. Double-click this rule to open the invert dialog. If desired, select Invert to set the rule to occur only when the device is not in the holster. 154 Vocera Messaging Platform Administration Guide

155 Creating and Managing Alarm Rules Option Description Severity is Select this option to set the rule when the message severity is one of the following: Normal High Low This rule is only available for Alert events. Double-click this rule and select a severity option from the dropdown menu. If desired, select Invert to set the rule to occur only when the severity is different from the configured severity option. For example, if you want the rule to apply to any alert event that is not low priority, set the severity to Low and select Invert, as shown in the following image: Alarms 155

156 Creating and Managing Alarm Rules Option Description From Select this option if you want the rule event to occur when the message is from a user or set of users. Doubleclick this rule to open the dialog. Use the dropdown list to select from the following filter options: All filters should match One filter match is enough Click New to add a new user to the rule. Click Edit to set the rule to occur only when the message is not from the selected user (select Invert). Click Delete to remove a user from the rule. The following image shows the filter set to match one of the included senders. This option is not available for Content and events. Subject contains Select this option if you want the rule event to occur when the message subject meets a defined criterion. Double-click this rule to open the dialog. Use the dropdown list to select from the following filter options: All filters should match One filter match is enough Click New to add new subject text to the rule. Click Edit to set the rule to occur only when the subject does not contain certain text (select Invert). Click Delete to remove an existing rule. 156 Vocera Messaging Platform Administration Guide

157 Creating and Managing Alarm Rules Option Description Body contains Select this option if you want the rule event to occur when the message body meets a defined criterion. Double-click this rule to open the dialog. Use the dropdown list to select from the following filter options: All filters should match One filter match is enough Click New to add new text to the rule. Click Edit to set the rule to occur only when the message does not contain certain text (select Invert). Click Delete to remove an existing rule. This option is not available for Chat, Content, and Messages. Message contains Select this option if you want the rule event to occur when the Chat message content meets a defined criterion. Double-click this rule to open the dialog. Use the dropdown list to select from the following filter options: All filters should match One filter match is enough Click New to add new text to the rule. Click Edit to set the rule to occur only when the message does not contain certain text (select Invert). Click Delete to remove an existing rule. This option is only available for Chat events. Name contains Select this option if you want the rule event to occur when the Content content meets a defined criterion. Double-click this rule to open the dialog. Use the dropdown list to select from the following filter options: All filters should match One filter match is enough Click New to add new text to the rule. Click Edit to set the rule to occur only when the content does not contain certain text (select Invert). Click Delete to remove an existing rule. This option is only available for Content events. Alarms 157

158 Creating and Managing Alarm Rules Option Description From contains Select this option if you want the rule event to occur when the message is from a user or set of users. Double-click this rule to open the dialog. Use the dropdown list to select from the following filter options: All filters should match One filter match is enough Click New to open the condition dialog box. Use the Type dropdown list to select from the following: Contact Contact in distribution list Address contains Click Select to select a specific distribution list or contact. Click Edit to set the rule to occur only when the message is not from the selected user (select Invert). Click Delete to remove a user from the rule. This option is only available for events. Message priority Select this option to set the rule when the message priority is one of the following: Normal High Low This rule is only available for events. Double-click this rule and select a priority option from the dropdown list. If desired, select Invert to set the rule to occur only when the severity is different than the configured severity option. For example, if you want the rule to apply to any alert event that is not low priority, set the severity to Low, and select Invert. 158 Vocera Messaging Platform Administration Guide

159 Creating and Managing Alarm Rules Table 35. Alarm Action Options Option Description Indicate with LED Select this option to set the alarm action to indicate with the device LED light. Double-click the action to set the following action parameters: Use the Repeat dropdown list to set the action repeat pattern to: None Infinite Custom - When selected, the Repeat time option appears. Use the up or down arrow to set the number of times the action should repeat. Use the Steps menu to configure the type, duration, and precedence of the action. Alarms 159

160 Creating and Managing Alarm Rules Option Description Play MP3 Select this option to set the alert tone for the rule. Double-click the action to select from any of the available alert tones. You can also add new tones from the Action MP3 dialog. This option is not available for events. Popup with brief Content Select this option to set a popup message with text for the rule. Double-click the action to open the dialog and enter the popup text. This option is not available for events. Vibrate Select this option to set the alarm action to indicate with a vibration. Double-click the action to set the following action parameters: Use the Repeat dropdown list to set the action repeat pattern to: None Infinite Custom - When selected, the Repeat time option appears. Use the up or down arrow to set the number of times the action should repeat. Use the Steps menu to configure the duration and precedence of the action. 160 Vocera Messaging Platform Administration Guide

161 Creating and Managing Alarm Rules Option Description Play tone Select this option to set the alarm action to indicate with a tone. Double-click the action to set the following action parameters: Use the Repeat dropdown list to set the action repeat pattern to: None Infinite Custom - When selected, the Repeat (times) option appears. Use the up or down arrow to set the number of times the action should repeat. Use the Tempo (bpm) dropdown list to select the tone tempo. Use the Notes selector to select the tone notes. This option is not available for Alert events. Popup dialog alert Select this option to create a popup dialog for the alarm. Double-click the action to enter the popup title and content. This option is only available for Chat events. Alarms 161

162 Creating and Managing Alarm Rules 162 Vocera Messaging Platform Administration Guide

163 Reports The Reports module gives Vocera administrators the ability to create detailed server and incident reports. Reports can be customized for organizational requirements such as audits and quality of service. Administrators can generate a report at any time and filter specific messaging details. Four categories of reports are available: Incidents Log Messaging Transmit Status Creating Incidents Reports In the Reports module, selecting the Incidents icon lets you print reports related to incidents. The following Incidents reports are available: Table 36. Incidents reports Report Type Description Incidents A chronology of all reported incidents. Voice calls A list of the status of voice calls. Creating Logging Reports In the Reports module, selecting the Log icon displays the logging reports that can be generated. Reports 163

164 Creating Logging Reports The following Log reports can be generated: Table 37. Log reports Report Type Description BIS Push usage The number of BlackBerry Push API messages sent by the server. Smartphone data wipe This lets Administrators view whether a data wipe was successful when sent to a device. This report is the only way to determine the status of a sent device deletion. PIN and SMS log Displays the BlackBerry PIN and SMS log by selected time frame. Security log Provides a record of Administrator actions. The report can record actions such as include logging in and out, creating users, and the deletion of contacts, distribution lists, groups, or other server entities. SMS usage Shows the SMS usage of a device. 164 Vocera Messaging Platform Administration Guide

165 Creating Messaging Reports Creating Messaging Reports In the Reports module, selecting the Messaging icon lets you display reports that list the chat messaging history, alert statuses, and paging alert statuses and statistics for the VMP Server. The following Messaging reports can be generated: Table 38. Messaging reports Report Type Description Chat Displays a timestamp of each chat message and provides the sender name, participants, and message details. Alert status - Detailed Displays specific details for alerts sent to any device. Reports 165

166 Creating Transmit Status Reports Report Type Description Alert statuses Displays the alert statuses for any user. Select the user from the user filter that appears when the Alert statuses report screen is displayed. Paging alert statuses Detailed Displays specific details for paging alerts sent to any device. Paging alert statistics Displays information on all paging alerts sent in a specified time period. Paging alert statuses Displays the paging alert statuses for any user. Select the user from the user filter that appears when the Paging alert statuses report screen is displayed. Creating Transmit Status Reports In the Reports module, selecting the Transmit Status icon lets you display reports that list the status of chat messages, content, and incidents sent from the VMP Server. The following Transmit Status reports can be generated: Table 39. Transmit Status reports Report Type Description Chat by user Displays transmit status information on chat messages. You can specify the user for which chat status information is to be displayed. Content Displays transmit status information on content transmitted from this server. Incidents Displays transmit status information for incidents reported for this server. 166 Vocera Messaging Platform Administration Guide

167 Users and Groups The Users & Groups module provides features to import, create, and manage platform users. Users can be entered and updated manually or synchronized with contact sources from other corporate systems. Users can be entered and updated manually, or VMP can synchronize with contact lists in other corporate systems. Use groups to create user sets and distribution lists to manage access permissions and on-call scheduling. Note: Some of the features found in the Users & Groups module are covered in the Deploying VMP section of this guide: Importing Users and Contacts, which includes synchronization with Active Directory, and importing from Excel, CSV files, or SQL Sending Installation Information to User Devices Editing User Information For any user, you can edit the information, device registration, and list of applications to which access has been granted. To edit user information: 1. From the VMP Administrator Console, select Users & Groups > Users. Users and Groups 167

168 Editing User Rights 2. In the Users pane, click on the name of the user whose information is to be edited. 3. From the toolbar menu, click Edit appears.. The End-User Settings window 4. Edit the end-user settings as needed. For more information on the fields in the End-User Settings pane, see Adding and Deleting Users Manually. 5. Click Next. The Push Technology and Licensing window appears. 6. To enable or disable mobile device access, select or unselect the Enable check box. If Enable is selected, you can change the device type by selecting from the Device type dropdown list, or change the registration information by entering new text in the fields provided. 7. To grant or deny access to a VMP application, select or unselect the check box next to the application name. Access can be granted to an application only if at least one unused license is available. The Available column lists the number of unused licenses available for each application. 8. Click Finish to finish editing the user information. Editing User Rights In the VMP Administrator Console, you can specify the rights that are to be granted to any user on the system. You can also assign a user to one or more Right Groups. Each Right Group grants a specific set of user rights. 168 Vocera Messaging Platform Administration Guide

169 Unlocking a User To edit user rights: 1. From the VMP Administrator Console, select Users & Groups > Users. 2. In the Users pane, click on the name of the user for which user rights are to be edited. 3. From the toolbar menu, from the User preferences drop-down, select User rights. The Edit Rights dialog box appears. 4. In the Right Groups pane, click on a Right Group. The rights associated with the Right Group appear in the Rights pane. To grant these rights to the user, select the check box next to the Right Group. Repeat this for other Right Groups as needed. 5. To grant custom permissions without selecting a Right Group, click Custom permissions to display a list of rights in the Rights pane. Select the check boxes of the rights that you want to grant. Note: Rights that have been granted by assigning a user to a Right Group are already selected, and cannot be changed in this way. 6. Click OK to finish granting rights to the selected user. Unlocking a User If a user has been inactive for a specified number of days, the user is placed in a Locked state, and cannot access the server. You can unlock any user that has been Locked. Users and Groups 169

170 Filtering the User Display To unlock a user: 1. From the VMP Administrator Console, select Users & Groups > Users. 2. In the Users pane, click on the name of the user to be unlocked. 3. From the toolbar menu, from the User preferences drop-down, select Unlock user. The selected user is unlocked. Note: The number of days of inactivity before a user is placed in a Locked state is specified in the Configuration > System Options section of the VMP Administrator Console. Filtering the User Display You can filter the list of users to make it easier to find a particular user. To filter the list of users: 1. From the VMP Administrator Console, select: Users & Groups > Users 2. Click Filter.. The Filter Users popup appears. 3. To improve filtering, enter a search string in any or all of the fields provided, and select an item from any or all of the dropdown lists provided. 4. To filter by group, click Select and add one or groups to the filter list. To remove a group from the list, highlight it and click Remove groups. 5. Click anywhere outside the popup to close it. When you enter a search string in a text field, select an element from a dropdown list, or specify a group, the Users list automatically updates to use the filtering that you have specified, and the Filter button changes color. Click the button again to remove or edit filtering. Groups You can use groups to organize users who have similar roles. From groups, you can manage access permissions and on-call scheduling. Adding and Deleting Groups From the Users & Groups module, you can create a new group, change the name of an existing group, or delete a group. To create a new group: 1. From the VMP Administrator Console, select Users & Groups > Groups 170 Vocera Messaging Platform Administration Guide.

171 Adding Users to a Group 2. From the toolbar menu in the Groups pane, click Add. 3. In the New Group dialog box, enter the name of the new group and click OK. To change the name of a group: 1. From the VMP Administrator Console, select Users & Groups > Groups 2. From the toolbar menu in the Groups pane, click Edit.. 3. In the Edit Group dialog box, enter the new name of the group and click OK. To delete a group: 1. From the VMP Administrator Console, select Users & Groups > Groups 2. From the toolbar menu in the Groups pane, click Delete.. 3. When asked to confirm whether you want to delete the group, click Yes. Adding Users to a Group You can add users to any group that you have created, or remove users that have been added. To add users to a group: 1. From the VMP Administrator Console, select Users & Groups > Groups. 2. In the Groups pane, highlight the group to which you want to add users. Users and Groups 171

172 Granting Group Access 3. In the pane at the right, click the Users tab and then click Add. 4. In the Select Users dialog box, click to highlight the users to be added and click OK. To remove users from a group: 1. From the VMP Administrator Console, select Users & Groups > Groups. 2. In the Groups pane, highlight the group from which you want to delete users. 3. In the pane at the right, click the Users tab and then click Delete. 4. When asked to confirm whether you want to delete the user from the group, click Yes. Granting Group Access You can specify that items such as content, Alert Templates, and Distribution Lists are to be made accessible to a group. To make items accessible to a group: 1. From the VMP Administrator Console, select Users & Groups > Groups 2. In the Groups pane, highlight the group with which you want to associate items. 3. In the pane at the right, click the tab corresponding to the item that you want to make accessible. For example, click Content to make content accessible to the group. 4. Click Add. 172 Vocera Messaging Platform Administration Guide.

173 Group Profiles 5. From the list of available items, highlight the item to be made accessible. 6. To grant additional permissions, click any or all of the following check boxes: Allow update Allow delete Allow manage access Visible on device by default 7. Click OK. Note: To change the permissions for any item that has been made accessible, highlight the item, click Manage access, and click any or all of the permissions check boxes. To make an item inaccessible, highlight the item, click Remove Yes to confirm that you want to remove access to the item., and click Group Profiles Use the Group Profiles module to create group profiles for individual groups. Profiles ease the user configuration process. Assign a profile to all groups sharing the same set of fields and permissions. Managing Group Profiles Use the following steps to create a group profile: Creating Group Profiles 1. Select the Users & Groups module, and select Group Profiles 2. Select New., name the profile, and click OK. 3. With the profile selected under Group profiles, click New Groups and select the groups to include with the profile. under 4. Click OK to close the dialog. Use the following steps to assign a group profile to a user: Users and Groups 173

174 Managing Group Profiles Assigning Group Profiles 1. Select the Users & Groups module, and click to highlight a user. 2. From the Member of tab, select Set Profile. 3. Use the dropdown list to select the profile, and click OK to close the dialog. 4. Click OK to confirm the assigned groups. 174 Vocera Messaging Platform Administration Guide

175 Contacts VMP Contacts provides a secure messaging layer for system communications. The Contacts client provides users a way to quickly send an alert, initiate a chat, , or even call another user. Contact options depend on the information provided by the administrator. Contact field options differ when the contact is entered using the source or distribution list option. The Contact module includes the following configuration views: Table 40. Contact Module Configuration Views View Description Contact Sources Use the Contact Sources view to manually create a new user or to import contacts from a source. Distribution Lists Use the Distribution Lists view to create a new contact distribution list from contacts, users, and groups that are already available on the system. Importing Contacts From a Source Use the following steps to import contacts: Importing Contacts From from a Source 1. Select the Contacts module, and select Contact sources 2. Select New. and choose New Contact Source. Contacts 175

176 Importing Contacts From a Source 3. Enter a name for the new source, select the Associated with remote source check box, and click Next. 4. If you want the VMP server to be synchronized with this source, select the Automatic synchronization check box, select whether you want to synchronize every few hours, daily, or weekly, and then select the time period or time at which synchronization is to take place. 5. Select an existing source or click Add primary source with contacts Note: For more information about synchronizing from a contact source, see Importing Users and Contacts. 6. Select the contacts and groups to import, and click Next. 176 Vocera Messaging Platform Administration Guide.

177 Manually Adding a New Contact 7. If the import is from Active Directory, configure group and distribution list import options, and click Next. 8. Customize the Field Mappings, if desired, and click Finish. Note: For more information about field mappings, see Defining Contact Fields and Defining User Fields. 9. Confirm that the synchronization is successful and click OK to close the dialog. Manually Adding a New Contact Use the following steps to add a new contact from the VMP Administrator Console. Manually adding a new Contact To complete this task, you must already have at least one contact source available in the Contact Sources view. 1. Open the Contact Sources view: Contacts > Contact sources 2. Click to highlight the contact source to contain the new contact. 3. Select New Source and choose New Contact. 4. Enter the contact details in the New Contact dialog, and click OK. Creating a Contacts Distribution List Use the following steps to create a Contact Distribution List. Creating a Contact Distribution List 1. Select the Contacts module, and select Distribution Lists 2. Select New. from the Distribution Lists - Contacts view. 3. Name the Distribution List, select the fields to display on the client, and click Next. Contacts 177

178 Creating a Contacts Distribution List Best Practice: Click Select All to add all available fields. 4. Select the Contact Source in Searches. 5. Select from the following options: Table 41. Contact Source Options Option Description Use all contacts Automatically add all source contacts to the list. Explicit Selection Manually choose the source contacts for the list. Active Directory OU's If the source is imported from Active Directory, you can choose to add Organization Units. Filter Filter for contact to add based on contact fields. 178 Vocera Messaging Platform Administration Guide

179 Managing Contacts Distribution List Access Best Practice: Filter for contacts with crucial fields (mobile phone, address, etc.) to ensure you are adding only contacts with these fields populated. 6. Click Next to configure Group Assignments. Choose the users and groups who have access to the Distribution List and click Finish. Managing Contacts Distribution List Access Use the following steps to manage Contacts Distribution List access. Managing Contacts Distribution List Access 1. Select the Contacts module, and select Distribution Lists 2. Select a list and click Manage Access.. 3. The Distribution List Access dialog allows you to perform the following tasks: Table 42. Distribution List Access Task Options Task Description Add User Click the Users tab, and click Add can access the list. Add Group Click the Groups tab, and click Add can access the list. Delete User Click the Users tab, select the user, and click Remove to revoke access to the list. to select users who to select users who Contacts 179

180 Managing Contacts Distribution List Access Task Description Delete Group Click the Groups tab, select the group, and click Remove to revoke access to the list. 4. Click Close to save the access changes. 180 Vocera Messaging Platform Administration Guide

181 Configuration The VMP Administrator Console Configuration module includes the following views: Table 43. Configuration Module Views View Description Wireless Gateways Use this view to create and modify system wireless gateways. Contact Fields Use this view to customize contact fields for your deployment. Contact Source Mapping Use this view to map contact fields to source fields. User Source Mapping Use this view to map user fields to source fields. Groups and Contact Synchronization Use this view to configure Lotus Domino and SWN synchronization options. Plugin Configuration Use this view to configure integrated plugins. Licensed Applications Use this view to manage application licensing. System Options Use this view to manage system options. Configuration 181

182 Defining Contact Fields Defining Contact Fields The Contact Fields module provides options to define the field source mapping appropriate for your contacts. Field source mappings should be defined before the source import is initiated. You can map contact fields from one or many sources. This view also provides options to define field types specific for your environment. The Contact Fields view includes the following options: Table 44. Contact Field Options Option Description Open the Define Field dialog to create a new field. Delete a highlighted field. Edit a highlighted field. Move the highlighted field up. Move the highlighted field down. Define the fields that are included in a search from the client for indexing. 182 Vocera Messaging Platform Administration Guide

183 Editing Contact Fields Editing Contact Fields Use the Vocera Messaging Platform Administrator Contact Source Mapping module to edit contact fields. This view lists available sources on the left. Click to highlight the source for mapping edits. Each source field is listed on the right. The fields contain a dropdown list to map the source field to a VMP field. Best Practice: The field mappings are also defined during an initial source import. Use this view only when updates are required. Editing User Fields Use the Vocera Messaging Platform Administrator User Source Mapping module to map VMP fields to fields from the import source. This view lists available sources on the left. Click to highlight the source for mapping edits. Each source field is listed on the right. The fields contain a dropdown list to map the source field to a VMP field. Best Practice: The field mappings are also defined during an initial source import. Use this view only when updates are required. Plugin Configuration Use the Plugin configuration view to add and configure licensed plugins for your deployment. Configuration 183

184 Plugin Configuration The following plugin configurations are supported: Note: For details about third-party plugin configuration options, see the Vocera Messaging Platform Integration Guide. Table 45. Plugin Configuration Support Plugin Settings Clickatell SMS connector Enter the following settings: ApiID User Password Confirm Password From MIR3 SMS Enter the following settings: URL Username Password Confirm Password SendWordNow SMS connector Enter the following settings: Login Password Confirm Password MIR3 Voice Enter the following settings: URL Username Password Confirm Password SendWordNow Voice Enter the following settings: Login Password Confirm Password 184 Vocera Messaging Platform Administration Guide

185 Using the Plugin Configuration Module Plugin Settings TFC Voice Enter the following settings: Username Password Confirm Password cli_id user_id caller_id Voice Gate Enter the following settings: Client Name Client ID Confirm Client ID Display Number MIR3 Fax Enter the following settings: Company URL Username Password Confirm Password WIC PIN Blaster Enter the following settings: Server Login Password Confirm Password Using the Plugin Configuration Module Use the following steps to configure a plugin. Configuring Plugins 1. From the VMP Administrator Console, select: Configuration > Plugin Configuration 2. Click the Active checkbox for the plugin you want to configure. Configuration 185

186 Licensed Applications 3. Click to enter the setting Values for each required setting. 4. Click OK to save the configuration. Licensed Applications Use the Vocera Messaging Platform Licensed Application view to display available application licenses and assign licenses to platform users. This view lists each licensed application, the available licenses, and the number of licenses currently assigned to users. Highlight an application to view the assigned users. Add or remove a licensed user from an application by clicking to highlight the user and selecting Add or Delete. System Options Use the System Options view to manage platform configuration options. This module includes the following configuration options: 186 Vocera Messaging Platform Administration Guide

187 System Options Table 46. System Options Option Description User Activity Configure user timeout values for inactivity. Networking Change or view the VMP Server public and internal host names. BB Push API / HTTP(s) Configure BlackBerry Push API settings. Alerts Configure the default timeout for sent alerts. Alert Settings Allow or prohibit alerts sent as . Incoming Mail (Response) Configure incoming mail preferences. Outgoing Mail (Responses, Open Portal Reports) Enable outgoing mail from the system, and configure mailbox settings. PIN Transport Configure PIN gate, failover, and notification settings. You can also include a callback host. SMS Aggregation Configure SMS aggregation. Paging Configure system paging preferences. Override Notification Allow or prohibit alerts to override notification settings. Open Portal Allow or prohibit open portal communications with the VMP server. Disclaimer for Web login Select Yes to include a disclaimer on the VMP Web Console login page. You can add your organization name and the disclaimer text. You can also set the date format. Documents Set the update frequency for Content. WCTP Enter the appropriate Polling IDs. Vocera Enable a Vocera Server integration and configure the server details. Chat Configure inactivity timeouts and allow or prohibit chat conversations to be sent via . Contact Settings Use the dropdown list to allow or prohibit users from uploading a personal image to associate with their profile. Configuration 187

188 System Options 188 Vocera Messaging Platform Administration Guide

189 The VMP Web Console This part of the manual describes the features of the VMP Web Console. The VMP Web Console Managing User Permissions Schedules Web Console Contacts The VMP Web Console 189

190 190 Vocera Messaging Platform Administration Guide

191 The VMP Web Console The VMP Web Console provides administrator and user access to the communication platform using the Internet Explorer browser (version 9 and newer). Use the VMP Web Console to manage the following tasks: Sending Alerts from the Web Console Creating On-Call Schedules The Monitor View Important: For this release, VMP confirms support for Internet Explorer 8 and later. The system has not been tested with Firefox or Chrome. Note: Depending upon the firewall configuration, the VMP Web Console can be opened up to external, off-network users. The default administrator can always log into the VMP Web Console using the administrator credentials. Users are assigned access to the VMP Web Console in the Vocera Messaging Platform Administration Guide console. For details about granting users access to the VMP Web Console, see Granting Existing Users Access to the VMP Web Console. The Monitor View The VMP Web Console Monitor View lists all sent alerts. Access the Monitor view by selecting the Monitor View icon. The view lists each alert. The VMP Web Console 191

192 Monitor View Features Click an alert to view the sent alert details. Monitor View Features The following table lists the features that are available from the Monitor View. Table 47. Monitor View Features Feature Description Search Use the search box to search for alerts by: Sender Recipient Subject Keyword Sent by Click edit to select the user who sent the alert. Sent to Click edit to select the user or distribution list that sent the alert. Alert Templates Templates are predefined alert messages designed to help users quickly send alert communications. Templates are made available on the client and from the Web client. Templates are created and managed from the VMP Administrator Console Alert and Messaging modules. Templates can be: Assigned permissions based on distribution lists Configured to allow the user to edit the message and delivery parameters from the client 192 Vocera Messaging Platform Administration Guide

193 Web Console Alerts Assigned to distribution lists for frequently communicating alerts to a set of users Templates created for the Notify client are available for use from the smartphone client. Templates created for the Alert client are available from the smartphone client and the VMP Web Console. For information about creating templates, see Creating Alert Templates. Web Console Alerts Vocera Messaging Platform users can create or send an alert to users, groups, or distribution lists using the VMP Web Console. The console provides an interface for sending alerts from the Internet Explorer browser (Version 9 and up). User access to the VMP Web Console is granted to the user during user creation or import, or by editing an existing user. Alerts can be created from existing templates. Users can edit templates if the option is enabled. Using the VMP Web Console, alert status can be directed to an address or a badge. Sending Alerts from the Web Console Use the following steps to send an alert from the VMP Web Console. 1. Open the VMP Web Console from the Internet Explorer browser (version 9 and later). 2. Select the Alert tab and click the Compose icon. 3. Select a distribution list or user recipient, or start typing the recipient name in the To: field for an auto-complete option. 4. Enter a Subject and a Message. The VMP Web Console 193

194 Sending Alerts from the Web Console Best Practice: An Alert must have a Subject or a Message. If your communication does not require both, give the message a Subject line. 5. Configure the following Alert Options, and click Send. Table 48. Web Console Alert Options Option Description Priority Set the Priority to: Low Medium High Override Notifications Select this option to override the user preference for notification options. This option is selected by default when the Priority is set to High. Send me an status report Send the status report to your box. Notify me on my badge If the sender is logged onto a Vocera badge, the alert status is sent as a message on the badge. Alert Expiration Set a timeout for alert delivery. The time is indicated on the sent alert. Select Other to enter a timeout in minutes. Response Options If the communication requires a response, set multiple choice options to help the recipient respond quickly. 194 Vocera Messaging Platform Administration Guide

195 Managing User Permissions The administrator provides user permissions for: Access to the VMP Web Console Creating and managing schedules Alerts sent by other users Granting Existing Users Access to the VMP Web Console You can grant access to any user at any time by editing the user or contact record. Use the following steps to edit a user record and add VMP Web Console access: 1. Start the VMP Administrator Console: All Programs > VMP Administrator Console 2. Navigate to the Users view: Users & Groups > Users 3. Click to highlight the desired user, and click the Edit icon (under Users). 4. Click to select Enable Web Console Access. Managing User Permissions 195

196 Granting Users Scheduling Permissions 5. Provide the authentication credentials, and click Next. 6. Click Next and click Finish to save the edited account and complete the task. Granting Users Scheduling Permissions Users must be provided permission to create and manage schedules in the VMP Web Console. Use the following steps to assign scheduling permissions to a system user. To grant a user scheduling permissions: 1. Start the VMP Administrator Console: All Programs > VMP Administrator Console 2. Navigate to the Users view: Users & Groups > Users 3. Click to highlight the desired user, and click User Preferences Rights > User. 4. In the Edit Rights dialog, click to select the Manage Schedules checkbox, and click OK. Allowing Users to View Monitor System Alerts Use the following steps to allow one or more users the ability to view alerts sent by other users. To grant alert viewing permissions: 1. Start the VMP Administrator Console: All Programs > VMP Administrator Console 196 Vocera Messaging Platform Administration Guide

197 Allowing Users to View Monitor System Alerts 2. Navigate to the Users view: Users & Groups > Users 3. Click to highlight the desired user or users, and click the View Sent By Pager tab at the bottom of the user list. 4. Click Add. 5. To allow users to monitor sent alerts, click to highlight the desired users and groups, and click OK. Managing User Permissions 197

198 Allowing Users to View Monitor System Alerts 198 Vocera Messaging Platform Administration Guide

199 Schedules If your license supports the feature, you can manage on-call schedules from the VMP Web Console. Use the Schedules view to create schedules based on OnCall Distribution Lists (DLs). Note: See Regular and On-Call Distribution Lists for more information about creating On-Call DLs. Schedules can be copied from existing schedules, can be drafted and remain unpublished, and can be published at any time. You can view schedules by: Day Week Month Shift When a user's schedule begins, the user's status is set to On-Call. Users can be granted rights to change their own status at any time. Creating On-Call Schedules Use the following steps to create an on-call schedule. 1. Open the VMP Web Console in Internet Explorer (version 9 or later). 2. Click the Schedule tab. 3. Click New Schedule. Schedules 199

200 Creating On-Call Schedules 4. Enter a meaningful Schedule Name. 5. Use the Schedule Distribution List dropdown list to select the on-call distribution list (DL) for the schedule. 6. Click in the Schedule Start Date field to open the calendar picker and select the start date. 7. If needed, use the Time Zone dropdown list to select the appropriate time zone. 8. If you want to copy the shifts for the new schedule from an existing schedule, click to activate the Copy shifts from an existing Schedule checkbox, and select the schedule from the dropdown list. 9. Use the Permissions picker to select Users/Groups with permission to access the schedule. Click to activate the checkbox next to the desired user or group and click > to select. 200 Vocera Messaging Platform Administration Guide

201 Creating On-Call Schedules 10. Click OK to continue. 11. Click the Schedule Name to continue editing. 12. Click and drag users to the selected time slot. Use the Shift Period dialog to set the shift time. Best Practice: Click and drag a schedule entry to quickly change the shift period. 13. Continue to add users to the schedule as appropriate. You can schedule more than one user to a shift period. 14. Click Repeat to set the schedule duration. Schedules 201

202 Creating On-Call Schedules 15. Click to view the schedule for the: Day Week Month Shifts 16. When the schedule is complete, click the back arrow Schedule list. to return to the 17. Click Unpublished (under Status), to open the Schedule Status dialog. 18. Click the Published radio button, and click OK. 202 Vocera Messaging Platform Administration Guide

203 Web Console Contacts The Web Console Contacts view shows all contacts the logged in user is allowed to access. Note: Contact access is defined in the Admin Console. For details about defining contacts distribution lists, see Contacts. Using Web Console Contacts Use the VMP Web Console Contacts view to send an alert or to a contact. The option is available only for users. Only alerts can be sent to group contacts. Use the following steps to send a communication from the VMP Web Console Contacts view. 1. Log on to the VMP Web Console from the Internet Explorer browser (version 9 and later). 2. Click Contacts to display the Contacts view. 3. Select the recipient of the communication from the list of contacts. Best Practice: Start typing the contact name in the search box to quickly find a user or group. 4. Select to send a New or a New Alert. The New option opens your default mail client. Web Console Contacts 203

204 Using Web Console Contacts The New Alert option opens the Compose Alert view. 5. For , compose and send the communication from your client. For an alert, compose and send the communication as an alert. For more information about sending alerts, see Sending Alerts from the Web Console. Note: If a contact is a Vocera Voice Group, the group may contain subgroups. To view a subgroup, click on it. When viewing a subgroup, click to return to the parent Voice Group, or use the breadcrumb navigation provided. 204 Vocera Messaging Platform Administration Guide

205 Appendices These appendices provide additional information that may be useful to you. A list of frequently asked questions is included. Server Sizing Matrix Virtual Environment Support Port Requirements Internet Information Services (IIS) VMP Considerations High Availability for the BES Server Frequently Asked Questions Appendices 205

206 206 Vocera Messaging Platform Administration Guide

207 Server Sizing Matrix The following information provides guidelines for implementing the VMP Server infrastructure. High-Level Sizing Recommendations Table 49. Server Sizing Requirements Item Requirement ios devices Any of the following mobile operating systems: ios 5.0.x ios 6.0.x ios 7.0.x Android Devices Any of the following mobile operating systems: Android OS and later Android OS 3.x.x Android OS 4.0.x Android OS 4.1.x Android OS 4.2.x Android OS 4.3.x BlackBerry Devices OS 5.x OS 6.x OS 7.x Server Sizing Matrix 207

208 VMP Server CPU and Memory Recommendations VMP Server CPU and Memory Recommendations Managed Devices CPU Class Min. Total Cores Min. Memory Xeon 1x2 8 GB 2x2 16 GB 2x2 32 GB 2.6 GHz Xeon 2.6 GHz Xeon 2.6 GHz VMP Server Hard Drive Storage Recommendations Managed Devices Minimum VMP Storage GB GB TB SQL Server Database Growth and Storage Recommendations Managed Devices CPU Class Min. Total Cores Min. Memory Xeon 2x2 16 GB 2x2 32 GB 2x6 64 GB 2.6 GHz Xeon 2.6 GHz x Xeon E5 2.2 GHz Managed Devices Database Size / 2 Years Log File Size / 2 years RAID Configuration GB 200 GB GB 250 GB Vocera Messaging Platform Administration Guide

209 SQL Server Database Growth and Storage Recommendations Managed Devices Database Size / 2 Years Log File Size / 2 years RAID Configuration GB 1 TB 10 The following benchmark test is based on: The number of Alerts in the database: 3,600,000+ The number of Alerts a day: 40,000 The number of recipients per alert: 5 Size of database: KB (6.5GB) Current size of Transaction Logs: KB (38GB) VMP Components Number of Users Disk Space Requirements Fixed WIC Master Database Size 15,000 6GB - 10GB VMP Alert Table log files 15,000 36GB - 60GB Server Sizing Matrix 209

210 SQL Server Database Growth and Storage Recommendations 210 Vocera Messaging Platform Administration Guide

211 Virtual Environment Support VMP can be deployed on a virtual machine (VM). The following VMware platforms are supported: VMware Virtual Infrastructure 3.5 (ESX or ESXi) VMware vsphere 4.1 (ESX or ESXi) VMware vsphere VMware virtualization platform must include VMware vcenter Server (formerly VMware Virtual Center) with a Standard license or better. Table 50. VMP Server VM Requirements Managed Devices CPU Class Minimum Memory Xeon 2.6 GHz 8GB Xeon 2.6 GHz 16GB Xeon 2.6 GHz 32GB Table 51. SQL Server VM Requirements Managed Devices CPU Class Minimum Memory Xeon 2.6 GHz 16GB Xeon 2.6 GHz 32GB x Xeon E5 2.2 GHz 64GB Table 52. Virtual Resource Reservation Component Minimum Server Requirements Processors per VM 2 Virtual Environment Support 211

212 Component Minimum Server Requirements Total RAM 16 GB Min Host Resource Reservation 64 GB Operating System Windows 2008 R2 212 Vocera Messaging Platform Administration Guide

213 Port Requirements To install VMP, you must configure a firewall or proxy firewall with the following conditions: Support for resolving Internet addresses that use DNS A firewall proxy that does not change incoming or outgoing data (transparent proxy) To allow communication between VMP devices and services, configure communication protocols and port numbers on the firewall and within the organization network environment. The following tables describe important system port requirements. Table 53. Protocol and port requirements for VMP Server Description Protocol Port Number VMP Server => Microsoft SQL Server TCP 1433 VMP Web Console Users' computers => VMP Server TCP 80 VMP Web Console Users' computers => VMP Server TCP 443 (Using SSL) Table 54. Protocol and port requirements for BlackBerry device messaging Description Protocol Port Number VMP Server => BlackBerry Enterprise Server (BES) TCP 8080 BlackBerry Enterprise Server (BES) => VMP Server TCP 80 BlackBerry Enterprise Server (BES) => VMP Server TCP 443 (Using SSL) Port Requirements 213

214 Table 55. Protocol and port requirements for Apple ios device messaging Description Protocol Port Number Destination Host VMP Server => Apple Push Notification Service (APNS) TCP 2195 gateway.push.apple.com VMP Server => Apple Push Notification Service (APNS) TCP 443 gateway.push.apple.com Apple ios devices using Wi-Fi connection => Apple Push Notification Service (APNS) TCP 5223 gateway.push.apple.com 2196 Table 56. Protocol and port requirements for Google Cloud Messaging (GCM) for Android devices Description Protocol Port Number Destination Host VMP Server => Google Cloud Messaging (GCM) TCP 5228 android.googleapis.com Table 57. [Deprecated] Protocol and port requirements for C2DM for Google Android device messaging [Deprecated] Description Protocol Port Number Destination Host VMP Server => Android Push Notification Service (C2DM) TCP 5228 android.googleapis.com VMP Server => Android Push Notification Service (C2DM) TCP 443 android.googleapis.com google.com Table 58. Protocol and port requirements for Simple Network Paging Protocol (SNPP) gateways (using default port) Description Protocol Port Number VMP Server => SNPP Gateway TCP Vocera Messaging Platform Administration Guide

215 Table 59. Protocol and port requirements for Wireless Communications Transfer Protocol (WCTP) gateways (using default ports) Description Protocol Port Number VMP Server <=> WCTP Gateway TCP 80 VMP Server <=> WCTP Gateway TCP 443 Port Requirements 215

216 216 Vocera Messaging Platform Administration Guide

217 Internet Information Services (IIS) VMP Considerations To correctly install the VMP platform, the IIS service must be running on the server during installation. When the installation is complete, the World Wide Web Publishing Service must be disabled to open port 80 for the VMP Web Console. The following services must be enabled prior to installation: All Common HTTP options except for WebDAV Publishing. The following Application Development options: ASP.NET.NET Extensibility ISAPI Extensions ISAPI Filters All Health and Diagnostic options must be enabled except for the optional logging options (Custom Logging and ODBC Logging). All Security options must be enabled. All Management Tools must be enabled except for the IIS6-specific options. Internet Information Services (IIS) VMP Considerations 217

218 218 Vocera Messaging Platform Administration Guide

219 High Availability for the BES Server To ensure minimum downtime if the BlackBerry Enterprise Server components stop responding or require maintenance, you can configure VMP for BlackBerry Enterprise Server high availability. High availability requires a minimum of two BlackBerry Enterprise Servers and replication of the BlackBerry Configuration Database across the database servers. High Availability on the corporate BES allows the BES to automatically failover to another server without impacting client use. A clustered BES decreases the chance of VMP Server connection issues. If failover occurs, MDS traffic is routed to the standby server. Configuring VMP for a BES Cluster Use the following steps to configure BES high availability for the VMP platform. Configuring VMP for a BES Cluster 1. Start the VMP Administrator Console: All Programs > VMP > VMP Administrator Console 2. Navigate to the Wireless Gateways view: Configuration > Wireless Gateways 3. Click the New icon. (under Wireless Gateways). High Availability for the BES Server 219

220 Web Console Refresh Rates 4. Select the BES server from the Type dropdown list. 5. Enter the primary BES in the Host field. Web Console Refresh Rates The following table describes web console refresh rates. Table 60. Web Console Refresh Rates Event Basic View Advanced View New Alerts 30 seconds 10 seconds Active Alert 10 seconds for the first minute, 60 seconds for the following 1 to 6 minutes. After 6 minutes, every 2 minutes. 10 seconds for the first minute, 60 seconds for the following 1 to 6 minutes. After 6 minutes, every 2 minutes. 220 Vocera Messaging Platform Administration Guide

221 Frequently Asked Questions 1. Why am I having issues viewing the VMP Web Console in Internet Explorer (IE) 9? The VMP Web Console URL must be added to the list of trusted sites to work correctly from Internet Explorer 8 or newer. For instructions about adding a site to the trusted site list, see: Microsoft Community - Internet Explorer Question, "How do I add a site to my "trusted 1 sites"list? 2. Why am I seeing a Fail to Listen error in the logs when the Vocera Data Exchange Service is started? If your logs list the following error when the Vocera Data Exchange Service is started, another application on the VMP Server is running on port 80: Failed to listen on prefix ' because it conflicts with an existing registration on the machine. In most cases, this error occurs because the IIS Service is using port 80. Turn off the IIS World Wide Web Publishing option as described in Installing the VMP Server. 3. Why can't I install the client on my BlackBerry device? If the BES and VMP are running on the same server, there may be a port conflict. Vocera Data Exchange Service and BES default to use port My server is no longer pushing communications to ios devices. What happened? e011-8dfc-68b599b31bf5 Frequently Asked Questions 221

222 The APNS certificate must be updated annually. Check with your technical account manager to determine if your certificate requires an update. 222 Vocera Messaging Platform Administration Guide