VMP Administrator Configuration Options

You can set configuration options to control the behavior of the VMP Administrator.

These options are organized into categories, and some categories are divided into subcategories. To access these options, start the VMP Administrator and select Configuration > System Options.

Table 1. System and Networking
Option Description
Networking
Vocera Messaging Server Public Host Name / IP The IP address or fully-qualified domain name (friendly DNS name) that is used to reach VMP when sending email registrations to end-users.
Vocera Messaging Server Internal Host Name / IP The IP address or fully-qualified domain name (friendly DNS name) that V5000 devices use to reach VMP and the VMP Administrator uses to retrieve the list of users from a Vocera Voice Server group.
Email
Enable Outgoing Email Allow outbound email messages to be sent from the VMP Server through SMTP. These include administrative messages and message responses.
Display Name The name under which outgoing email is to be sent.
Email Address The email address that outgoing email is to be sent from.
SMTP Server The SMTP server through which outgoing mail is to be sent.
SMTP Port The port that the SMTP server uses. The default is 25.
SMTP Authentication Whether SMTP authentication is required with the SMTP relay host.
Security
Device validation certificate The approved certificate for device validation. Devices must have installed the corresponding device certificate to be able to access this server.
Enable smartphone authentication by certificate Whether to enable device authentication using a certificate. This option is currently not in use.
Enforce SSL for smartphone connections

Enforce that all communications between the VMP Server and VMP smartphone clients are to use SSL. This is required when using iOS clients.

Before you can set this option, you must supply an SSL certificate using the NetworkSecureCertificate option in the VMP Enterprise Manager.

Enforce server certificate validation on smartphone Whether the smartphone is to validate the server certificate against the local operating system's keystore. If this option is set to No, smartphone clients use an HTTPS connection with VMP regardless of whether the SSL certificate on the VMP Server is trusted or self-signed. If this option is set to Yes, the certificate must be trusted to allow an HTTPS connection.
Enforce App PIN

Enforce that access to the client application must require PIN entry. Valid settings are OFF, ON, and Shared (PIN required for shared devices only). This option is set to either Shared or OFF in the Security Options dialog box during installation - see Installing the VMP Server for more details.

You can override this setting for any individual user. For more information, see Editing User Information.

If you change the Enforce App PIN setting to ON, device users will not be able to set a PIN if they registered by email or using a registration key and do not have either a valid VMP Server username and password or a valid Active Directory username and password.

Enforce Smartbadge PIN Enforce that access to the Vocera Smartbadge must require PIN entry. Valid settings are Yes and No.
PIN Timeout If Enforce App PIN or Enforce Smartbadge PINhas been activated, set the number of seconds that the device can remain idle before the PIN must be re-entered.
Enforce device password for all smartphones Indicate that the client app is not enabled to run on a device unless a password has been specified for the device. This ensures that sensitive information is kept safe if the device is lost or stolen. Valid settings are OFF, ON, and Shared (device password required for shared devices only).
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.
Auto Lock

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 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.
Accept client log uploads Indicates whether log files can be uploaded to the server from Vocera Collaboration Suite clients.
User Inactivity
Time of inactivity for automatic logout The number of minutes that the browser and VMP can be inactive before automatic logout. This does not affect clients or the VMP Enterprise Manager.
Days of inactivity before user is placed into Warning state The number of days before a Warning icon is placed on a user account.
Days of inactivity before user is placed into Locked state The number of days before an inactive user is locked. Locked users cannot access the VMP Administrator. See Unlocking a User for more details.
Time of inactivity for auto logout of smartphone client The number of minutes that a client can be inactive before automatic logout. Users in Dual Mode are logged out of the smartphone client but not the badge.
Device inactivity timeout interval If a user is offline for more than the number of minutes specified in this option, the user's status is set to "not available". The maximum value for this option is 1440 minutes (24 hours).
VCS logout in dual mode also causes a badge logout Whether a user in Dual Mode who logs out of the VCS app should also be automatically logged out of the badge.
Table 2. Notifications
Option Description
Enforce Notification Settings

Whether VCS clients must be forced to accept the vibration and ringtone settings specified in the VMP Administrator. Valid values are:

  • ON - all clients must be forced to accept system settings
  • OFF - any client can configure vibration and ringtone settings
  • Shared - all shared devices must be forced to accept system settings
Secure Messages Priority: Normal The vibration pattern and ringtone for Normal priority secure messages. Click Configure to display the notification specification dialog box.
Secure Messages Priority: High The vibration pattern and ringtone for High priority secure messages. Click Configure to display the notification specification dialog box.
Secure Messages Priority: Urgent The vibration pattern and ringtone for Urgent priority secure messages. Click Configure to display the notification specification dialog box.
Calls The vibration pattern and ringtone for calls. Click Configure to display the notification specification dialog box.
Notify Me The vibration pattern and ringtone for notifications that are generated when the Notify Me checkbox is selected for messages that require a response, and a response is not provided in the specified time. Click Configure to display the notification specification dialog box.
Other The vibration pattern and ringtone for notifications for changes in On-Call status, new or updated Content, missed calls, and voicemails. Click Configure to display the notification specification dialog box.

For a more detailed description of notification options, see Specifying Notification Options.

Table 3. Contacts
Option Description
Allow User to upload personal image Whether a user can upload a photo to their Contact entry from a client application.
Allow Email Communication This setting controls whether client applications can use email as a mode of communication. If this setting is enabled, the client uses the device's default email editor.
Table 4. Secure Messaging
Option Description
Enable Remind Me Later Option Whether to display the Remind Me Later / View Later button when displaying a message on the client application. For the Vocera Collaboration Suite app, this displays both the Remind Me Later and Remind Me Later For Normal Messages settings.
Default Subject Line for 3rd Party Integrations The subject line to use when messages are sent from a third-party WCTP source.
Response waiting interval The number of seconds to wait for a user response when an SNPP or WTCP message is sent.
Retain Message History in Database The number of weeks that messages are kept in the Microsoft SQL database.
Deliver message content to SMS users Determines whether the content of an Alert is delivered to an SMS user. The default is No, since SMS channels are non-secure.
Allow Urgent messages Whether messages can be marked as Urgent.
Include attached images in the report Whether to include attached images when generating a report
Number of days of inactivity to archive a conversation The number of days that a conversation is to be inactive before the conversation is archived.
Allow users to forward messages Whether users can forward messages to another user. Forwarding can also be turned on or off for any specific user.
Forward clinical system messages

Whether to employ user-specified message forwarding settings for messages from clinical systems, including VMI and CWE.

Note: Vocera recommends that you disable this setting, as the behavior is inconsistent when clinical system messages are forwarded to badges.
Allow attaching pictures from a file If enabled, allow VMP Web Console users and users on mobile clients to attach pictures to secure messages by selecting an existing file. Setting this option to No disables access to the photo gallery on mobile devices.
Allow attaching pictures from the camera If enabled, allows users on mobile clients to use the device camera to take pictures to attach to secure messages.
Table 5. Override Notifications
Option Description
Enable Do Not Disturb Mode on Smartphone Clients Whether Do Not Disturb is to be allowed in the client application.
Table 6. Content
Option Description
Minimum document update frequency For the Content module, the minimum number of minutes between updates of documents in shared folders.
Allow Content sync with Mapped Network Drives Whether to support synchronization of Content module documents on mapped network drives (not recommended).
Table 7. Web Console
Option Description
Disclaimer for Web Logon
Enabled Whether a disclaimer popup appears when users log in to the VMP Web Console.
Organization Name The organization name to appear in the disclaimer popup.
Text The content of the disclaimer popup.
Web Console Date Format The format in which dates are displayed in the VMP Web Console.
Enabled Whether HTML, CSS, and JavaScript static files are sent to the browser in compressed format.
Table 8. Integrations
Option Description
Vocera Voice
Important: If any of these values are changed, you must manually restart the VMP Server by restarting the Vocera Data Exchange Service. See Starting and Stopping the VMP Server for details on how to do this.
Enabled Whether the VMP Server is to interact with a Vocera Voice Server.
IP Addresses The IP address of the Vocera Voice Server, or comma-separated addresses if the Vocera Voice Server is operating in a clustered environment. This option can be set in the Voice Server dialog box during installation. See Installing the VMP Server for more details.
Port The Vocera Voice Server port number.
Use HTTPS Whether to use HTTPS for secure communication with the Vocera Voice Server.
VCG IP Addresses The Vocera Client Gateway IP address, or comma-separated addresses if the Vocera Client Gateway is operating in a clustered environment. These addresses are configured when the Vocera Voice Server is installed and has been synchronized with the VMP Server, and cannot be edited here.
VMI Message Expiry The number of minutes before VMI (Vocera Messaging Interface) messages sent from the Vocera Voice Server expire.
Enable Enhanced Voice Server NIO Tomcat Feature Whether to enable support for scaling changes included in the Vocera Voice Server. Ensure that this feature is enabled in the Vocera Voice Server before enabling it in the VMP Server.
Retain call and voice mail history in the database The number of days to retain calls and voice mail messages from client devices in the server database.
Use VCG for VCS client connection management

When enabled, the VCS client will use the Vocera Client Gateway server for enhanced connection management. This setting is recommended to improve resource management on the clients. Requires Vocera Client Gateway version 5.2.2 or later and VCS version 3.2 or later.

See the Vocera Voice Server Telephony Configuration Guide for details on the VCG properties that configure the VCS and VMP interface.

Send user-generated messages to Vocera badges

Specifies whether messages generated from Vocera Collaboration Suite and the VMP Web Console are to be displayed on Vocera badges. All other types of messages are always sent to Vocera badges.

Consider Call Forwarding in User Presence Status

Specifies whether a user is to be considered available if he or she has configured call forwarding on the Vocera Voice Server, even if he or she is not logged into VMP.

Prevent voice enunciation on user-generated messages

Specifies whether to disallow voice enunciation on badges of messages sent from Vocera Collaboration Suite and the VMP Web Console regardless of the priority-based enunciation rules configured on the Vocera Voice Server. This can prevent personal health information being heard.

This feature requires Vocera Voice Server 5.3.2 or later.

Allow Accept/Decline for Urgent Calls Specifies whether to disallow auto-answering of urgent calls. When enabled, the user must accept or decline the call.
Show integration messages on device lock screen

Whether to allow messages sent from systems integrated with VMP to appear on the lock screens of client devices.

Important: If a message contains confidential patient health information, displaying the message on the lock screen may violate privacy regulations.
Patient Context
Enabled Set to Yes to enable integration with the Engage Patient Context Adapter. See Engage Integration for more details.
Vocera Secure Texting App - Message Exchange
Enabled Set to Yes to enable messages and images to be exchanged between Vocera Collaboration Suite users and Vocera Secure Texting mobile applications.
User ID This ID is configured by the VST cloud server to identify the connected Vocera organization.
Shared Key Authenticates the connection between the VST cloud server and the connected Vocera organization.
Manage VST Contacts

Specifies the server that manages VST contacts.

If this field is set to Voice, VST contacts are managed on the Vocera Voice Server.

If this field is set to VMP, VST contacts are managed on the VMP Server in the VSTContacts distribution list.

Email
Enable Secure Message Initiation Enables the configuration of a user's email into the Messaging feature.
Secure Message Initiation - Incoming Mail
Protocol

The protocol for the mailbox. This is one of POP3, IMAP4, or Exchange Web Services.

Depending on the protocol selected, additional connection parameters must be specified, including POP3/IMAP/EWS Host and POP3/IMAP4/EWS Port.

Email Scan Interval The number of seconds between scans for new incoming email.
Initiation Permitted

Who can initiate messages by email. This is one of the following:

  • From any email address: Anyone that can send email can initiate a message.
  • From VMP users only: Only registered VMP users can initiate a message.
EWS Domain The Exchange Web Services domain. Appears only when Protocol is set to Exchange Web Services.
Email Username The username associated with the mailbox that the VMP Server is to monitor.
Email Password The password for the mailbox username.
Confirm Email Password The password for the mailbox username (repeated).
POP3/IMAP4/EWS Host The hostname for the server hosting email account. This must be the domain name, not the URL. For example, use mail.customer.com, not https://mail.customer.com/owa.
POP3/IMAP4/EWS Port The port number for email account connections to the host. See Port Requirements for the default port requirements for these protocols.
IMAP4/EWS Use Secure Connection Whether the connection to the email server must be secured. Appears only when Protocol is set to either IMAP4 or Exchange Web Services.
IMAP4/EWS Security Port The port number at which the email server is accepting secure connections. See Port Requirements for the default secure port requirements for these protocols. Appears only when Protocol is set to either IMAP4 or Exchange Web Services.
IMAP4 Authentication Type The type of login that the IMAP4 email server supports. Select either Login or Authentication. Appears only when Protocol is set to IMAP4.
IMAP4/EWS Mailbox The mailbox name to access within the specified email account (for example, Index). Appears only when Protocol is set to either IMAP4 or Exchange Web Services.
Delete Email Once Processed How often the VMP Server will remove emails from the monitored mailbox. This is one of the following:
  • Immediately: The VMP Server deletes the email immediately after it has been converted to a message.
  • Once/Day: The VMP Server deletes all processed emails that are older than 24 hours.
  • Never: The VMP Server never deletes any email. Select this setting only if email is deleted by another process or person.
WCTP
PollingID 1 The polling IDs to use when communicating with a WCTP source.
PollingID 2
PollingID 3
SMS Aggregation
Configure SMS aggregator plug-in Link to the Plugin Configuration window in which you can configure an SMS aggregator service.
Table 9. Scheduling
Option Description
When does daily validation happen The time at which schedule validation takes place when it has been specified for on-call schedules. When automatic validation is performed, a report is generated that is emailed to all users that have edit access on the schedule.
Validation look ahead interval The number of days to look ahead in an on-call schedule when validating. This number can be between 1 and 14.
Table 10. VBI Data Export
Option Description
Enable VBI Data Export Whether or not the Vocera Business Intelligence (VBI) Data Export function is active.
Time of Data Export The time at which to run the VBI Data Export job.
Location of Data Export Where to store the VBI Data Export logs. The default is the <drive>\Vocera\Support\Upload folder, where <drive> is the drive on which VMP is installed.