This section contains an alphabetical list of the most common badge properties. These property names appear in the badge.properties file. The list contains cross-references to the fields and pages you can use to set these properties in the Badge Properties Editor (BPE).
The properties for different types of Vocera badges have different names. In the badge.properties file, properties have the following prefixes:
Badge type | Prefix |
---|---|
B3000n |
B3N |
B3000 |
B3 |
B2000 |
B2 |
Property Name | Default Value | Description |
---|---|---|
|
Open |
Specifies the type of authentication required by your wireless network:
Use the Authentication field on the Security tab of the Badge Properties Editor to set this value. |
|
Blank |
Specifies a static IP address for the badge using standard dotted notation (such as 192.168.3.7). Leave this value blank if a DHCP server is assigning IP addresses. If you are setting up badges for a production Vocera environment, allow a DHCP server to assign IP addresses to the badges. Static IP addresses are feasible only for small evaluation systems. |
|
FALSE |
Specifies whether the Bluetooth configuration menu is displayed on the badge. |
|
FALSE |
Vocera broadcast is implemented as IP Multicast. If broadcast commands need to cross a subnet, IGMP must be supported in the switch or router, and this property must be set to TRUE. The B3000n badge auto-detects IGMP and changes its mode dynamically if IGMP is enabled in the infrastructure. Consequently, this property is deprecated in the B3000n badge. Note: This badge property is not available in the Badge Properties Editor. |
|
Blank |
Allows B3000n (on 2.4 GHz networks), B3000, and B2000 badges to scan up to four arbitrary channels when the signal quality drops. By default, badges scan only channels 1, 6, and 11 unless this property is set. To set this property, enter the specific channel numbers in a comma-separated list. For optimal performance of the badge and other wireless clients, Vocera recommends that the access points on your network are set only to the three non-overlapping channels of 1, 6, and 11. Use the Specify Channels field in the 2.4 GHz Channels section of the Wireless tab in the Badge Properties Editor to set this value. |
|
Blank |
Allows B3000n badges on 5 GHz networks to scan an arbitrary set of channels when the signal quality drops. By default, B3000n badges scan all available channels unless this property is set. To set this property, enter the specific channel numbers in a comma-separated list. Use the Specify Channels field in the 5 GHz Channels section of the Wireless tab in the Badge Properties Editor to set this value. |
|
Blank |
Specifies the password for the client private key. This is only needed if you are using external EAP-TLS certificates. The maximum length of the password supported by Vocera badges is 32 alphanumeric characters. |
|
FALSE |
Specifies whether the badge configuration menus are hidden, or if they can be easily accessed through the DND button:
With B3000 and B2000 badges, set this value to TRUE to prevent users from displaying the configuration menus and inadvertently causing configuration problems in a badge. Use the Hide Boot Menus field on the General tab of the Badge Properties Editor to set this value. |
|
FALSE |
Specifies whether your badge has a static IP address, or whether it receives its address from a DHCP server. If a DHCP server is assigning IP addresses, leave this field blank. This value is necessary only if you are using static IP addresses. Note: This badge property is not available in the Badge Properties Editor. |
|
Blank |
Specifies the IP address of the DNS server that your site uses to resolve DNS queries, in standard dotted notation. If a DHCP server is assigning IP addresses, leave this field blank. This value is necessary only if you are using static IP addresses and the value of ServerIPAddr is specified as a DNS style name. Note: This badge property is not available in the Badge Properties Editor. |
|
Blank |
Specifies the IP address of the secondary DNS server that is used if the primary server is not available, in standard dotted notation. If a DHCP server is assigning IP addresses, leave this field blank. This value is necessary only if you are using static IP addresses and the value of ServerIPAddr is specified as a DNS style name. Note: This badge property is not available in the Badge Properties Editor. |
|
FALSE |
Specifies whether to use external certificates instead of the Vocera Manufacturer Certificates. External certificates can be self-signed or signed by a trusted Certificate Authority (CA).
|
|
0 |
Limits the number of times a badge attempts to retry retrieving a PAC from the Cisco ACS after the first attempt failed (for example, due to wireless network problems). Enter a number from 0 to 5. By default, this property is set to 0 (meaning no retries). In order to take advantage of this feature, you must also select EAP-FAST authentication. |
|
FALSE |
Specifies whether the badge will take advantage of the region-based channel selection capabilities of 802.11d.
In order to take advantage of this standard, your access points must also support it. |
|
FALSE |
Specifies whether the badge will take advantage of the Unscheduled Automatic Power Save Delivery Subset (U-APSD) of 802.11e. U-APSD improves power management and potentially increases the talk time of 802.11 clients.
In order to take advantage of this standard, your access points must also support it. Important: The B2.EnableAPSD, B3.EnableAPSD, B2.EnableWMM, and B3.EnableWMM properties should all be set to the same value. The firmware and chip set changes in the B3000n badge make this property unnecessary. Consequently, this property is deprecated in the B3000n badge. Note: This badge property is not available in the Badge Properties Editor. |
|
FALSE |
Specifies whether Cisco Certified Key Management is enabled for Vocera devices. CCKM is a form of fast roaming supported on Cisco access points and on various routers. Using CCKM, Vocera devices can roam from one access point to another without any noticeable delay during reassociation. After a Vocera device is initially authenticated by the RADIUS authentication server, each access point on your network acts as a wireless domain service (WDS) and caches security credentials for CCKM-enabled client devices. When a Vocera device roams to a new access point, the WDS cache reduces the time it needs to reassociate.
In order to take advantage of this feature, your access points must also support it, and you must use either LEAP, WPA-PEAP, EAP-FAST, or EAP-TLS authentication. |
|
FALSE |
Enables automatic provisioning of the Protected Access Credential (PAC) for EAP-FAST authentication. This replaces the manual method of creating a new PAC on the Cisco ACS when it expires and then copying it to the Vocera Server and the Vocera configuration computer. In order to take advantage of this feature, you must also select EAP-FAST authentication. |
|
FALSE |
Enables the automatic provisioning of a new PAC when it expires. If this property is unchecked, a badge whose PAC has completely expired will display the following message: "Expired or invalid PAC credentials." In order to take advantage of this feature, you must also select EAP-FAST authentication. |
|
FALSE |
When set to TRUE, this property causes the cryptographic security module to run in a secure mode that conforms with Federal Information Processing Standard (FIPS) 140-2. |
|
FALSE |
Specifies whether the badge will take advantage of the WiFi Multimedia (WMM) subset of 802.11e. 802.11e QoS provides standards-based QoS to prioritize voice over data traffic and ensure high level voice quality.
In order to take advantage of this standard, your access points must also support it, switches and routers must be configured to honor DSCP markings, and the Vocera QoS Manager service must be enabled on the Vocera Server. Important: The B2.EnableAPSD, B3.EnableAPSD, B2.EnableWMM, and B3.EnableWMM properties should all be set to the same value. If 802.11n is enabled on both the network and the B3000n badge (through the B3N.WirelessBand property), the B3000n takes advantage of WMM and ignores this property. In legacy 802.11n environments, you can continue to use this property for the B3000n badge. This property is not tied to the use of APSD for the B3000n. Note: This badge property is not available in the Badge Properties Editor. |
|
None |
Specifies the type of data encryption your wireless network requires.
Use the Encryption field on the Security tab of the Badge Properties Editor to set this value. |
|
Blank |
Specifies the address of your gateway, if your LAN uses one, in standard dotted notation. Make sure you specify a default DHCP gateway by manually editing this property in the badge.properties file (this property is not currently exposed in the Badge Properties Editor. Vocera uses this property for multicast sessions even when badges and the Vocera Voice Server are in the same VLAN. |
|
1 |
Specifies whether Group Mode is turned on when users are on a call. Group Mode widens the speech zone, allowing other people to speak into the badge's primary microphone.
Note: B3000n and B3000 badge users can change the Group Mode setting on their
badges.
|
|
FALSE |
Specifies whether the in-line button on a wired headset is able to initiate or accept badge calls.
This property is not available for the B2000 badge. The B2000 supports wired headsets, but does not support the use of the headset buttons. Note: This badge property is not available in the Badge Properties Editor. |
|
FALSE |
Specifies whether the Badge Configuration Utility has performed the initial configuration for a badge:
Note: This badge property is not available in the Badge Properties Editor. |
|
5 |
An access point broadcasts a management frame called a beacon at a fixed interval (required to be set to 100 ms by Vocera). The B2.ListenInterval property specifies the frequency with which badges "wake up" and listen for a beacon. When the beacon interval is 100 ms and B2.ListenInterval is 5, the default listen interval is 500 ms. Note: This badge property is not available in the Badge Properties Editor. |
|
Blank |
If AuthenticationType is set to LEAP, WPA-PEAP, or EAP-FAST, specifies the password the badge supplies for authentication. Use the Password field on the Security tab of the Badge Properties Editor to set this value. |
|
Blank |
If AuthenticationType is set to WPA-PSK, specifies the 64-character, hexadecimal pre-shared key the badge supplies for authentication. Use the PreShared Key field on the Security tab of the Badge Properties Editor to set this value. The WPA-PSK standard uses a hexadecimal key to encrypt the association handshake. For B3000n and B3000 badges, you can enter the ASCII passphrase used by your wireless network. For other badges, enter a 64-character, hexadecimal value for the pre-shared key. |
|
FALSE |
Specifies whether the badge resets the volume to the default at boot-up.
|
|
2 |
Specifies how quickly a badge searches for another access point when signal quality drops. Higher values cause a badge to search sooner, and may correct problems with choppy audio. However, a badge cannot send or receive audio packets while searching for an access point, so communication may be interrupted. Lower values allow a badge to tolerate lower signal quality before searching. The optimal threshold value varies from one 802.11 network to another, depending on how the network is configured. Use the Roaming Policy field on the Wireless tab of the Badge Properties Editor to set this value. |
|
Blank |
Specifies the IP address of the machine which is running the Vocera server. Use dotted notation (such as 192.168.3.7) to specify this value. For a Vocera Server cluster, enter multiple IP addresses and separate them with commas. You must specify a value for this property. Use the Vocera Server IP Address field on the General tab of the Badge Properties Editor to set this value. |
|
vocera |
Specifies the SSID of the wireless network or subnet the Vocera badges will use. This value is case sensitive. You must specify a value for this property. Use the SSID field on the General tab of the Badge Properties Editor to set this value. |
|
Blank |
Specifies a subnet mask that indicates which bits in the IP address correspond to the subnet, using standard dotted notation (such as 255.255.255.0). You must specify this property if you are using static IP addresses. Leave this value blank if a DHCP server is assigning IP addresses. Note: This badge property is not available in the Badge Properties Editor. |
|
FALSE
FALSE
FALSE |
Specifies whether users can roam across subnet boundaries while using badges. If subnet roaming is enabled, a badge automatically obtains a new IP address as a badge user makes the transition to an access point on a different subnet. If you enable subnet roaming, you must use a DHCP server to supply your IP addresses. Set this property to TRUE only if the access points on your wireless LAN are divided into multiple subnets, and if you want to allow users to roam across subnet boundaries. If all the access points on your wireless LAN are within a single subnet, set this property to FALSE to minimize DHCP traffic and reduce the chance of a momentary loss of audio when roaming between access points. The subnet where the Vocera server is located is not relevant to this property. Note: This badge property is not available in the Badge Properties Editor. |
|
Blank |
If AuthenticationType is set to LEAP, WPA-PEAP, or EAP-FAST, specifies the user name the badge supplies for authentication. Use the User Name field on the Security tab of the Badge Properties Editor to set this value. |
|
Blank |
Specifies a WEP key the badge can use to transmit or receive data, if EncryptionType is set to WEP64 or WEP128. Enter the value in the following format:
If either the access points or the badges are using the first WEP key to transmit data, the value you specify here must match the first WEP key in the access point. Use the WEP Key field on the Security tab of the Badge Properties Editor to set this value. |
|
Blank |
Specifies a WEP key the badge can use to transmit or receive data, if EncryptionType is set to WEP64 or WEP128. Enter the value in the following format:
If either the access points or the badges are using the second WEP key to transmit data, the value you specify here must match the second WEP key in the access point. Note: This badge property is not available in the Badge Properties Editor. |
|
Blank |
Specifies a WEP key the badge can use to transmit or receive data, if EncryptionType is set to WEP64 or WEP128. Enter the value in the following format:
If either the access points or the badges are using the third WEP key to transmit data, the value you specify here must match the third WEP key in the access point. Note: This badge property is not available in the Badge Properties Editor. |
|
Blank |
Specifies a WEP key the badge can use to transmit or receive data, if EncryptionType is set to WEP64 or WEP128. Enter the value in the following format:
If either the access points or the badges are using the fourth WEP key to transmit data, the value you specify here must match the fourth WEP key in the access point. Note: This badge property is not available in the Badge Properties Editor. |
|
Blank |
If Encryption is set to WEP64 or WEP128, specifies which of the four WEP keys the badge uses to transmit data. Valid values are 1-4. Note: This badge property is not available in the Badge Properties Editor. |
|
ABGN |
Select the wireless bands used by the B3000n badge:
|
|
1 | Lists the default volume level of Privacy Mode when no users are logged on. |
|
True | Displays Privacy Mode in on the badge menu under Settings. |
|
True | Enables Easy Access entry to Privacy mode. |
|
False | Enables or disables Privacy mode using Easy Access. |
|
True | Plays an audible alert, “Entering Handset Mode” while switching to Privacy Mode using Easy Access. |