Configuring Bria Professional Retail Edition www.counterpath.
CounterPath Corporation CounterPath Corporation Suite 300, One Bentall Centre 505 Burrard Street, Box 95 Vancouver, BC V7X 1M3 Tel: 604.320.3344 sales@counterpath.com www.counterpath.com © June 2009 CounterPath Corporation. All rights reserved. Windows is a registered trademark of Microsoft Corporation in the United States and other countries.
Contents About Configuration .....................................................................................................................2 Configuration Settings by Topic...................................................................................................3 Account Credentials................................................................................................................3 Account Setup......................................................................................
CounterPath Corporation 2
Configuring Bria Professional (Retail Edition) About this Manual This manual is intended for: • • System administrators who are deploying Bria Professional in their enterprise by remotely configuring the client through remote provisioning. (For more information on the options for configuring, see the Bria Professional Administrator Guide). VoIP service providers who have purchased the retail version of Bria Professional and want to remotely configure Bria Professional for their customers.
CounterPath Corporation 1 About Configuration Bria Professional Settings Configuration of Bria Professional is achieved largly through assigning appropriate values to settings. Settings let you: • • • Configure Bria Professional for the environment (network and so on) in which it will work. Configure Bria Professional for server-side functions you support, such as WebDAV storage. Configure how some Bria Professional features work, and configure whether a feature is enabled or disabled.
Configuring Bria Professional (Retail Edition) 2 Configuration Settings by Topic 2.1 Account Credentials For information on these settings, see “Provisioning Bria Retail Edition”. 2.2 Account Setup These settings define the user’s account or accounts. There is one section for each account: proxy0, proxy1, and so on. Each account is either a SIP or an XMPP account, as specified by the proxies:proxyn:protocol setting. For each account type, a different subset of the proxies settings is applicable.
CounterPath Corporation 2.3 Audio Quality These settings provide controls for audio quality. 2.4 Codec Usage Your brand includes a specific set of built-in codecs. A codec may be royalty-bearing or non-royalty-bearing: see the Bria Professional Settings reference documentation for details. You can restrict codec usage by enabling or disabling a codec and by setting the license count (even on non-royalty-bearing codecs).
Configuring Bria Professional (Retail Edition) Handling the Media Capabilities of the Other Party For outgoing audio or video (the audio or video you send the other party), there are two ways to configure Bria Professional: • Let Bria Professional determine the codecs to use for each call. This is the default.
CounterPath Corporation 2.6 Dial Plan The dial plan defines patterns that a number dialed by the user are matched to. A dial plan is used for any combination of these reasons: • • • To prevent unresolvable calls being placed. For example, to prevent using network bandwidth on a call that will certainly fail. You define patterns that you know will work, and only place a call if it matches one of these patterns. To modify the input if that is required to ensure that the call gets established.
Configuring Bria Professional (Retail Edition) Transformation The selected transformation is performed. Place Call Then the call is placed using the transformed input. Quick Reference to the Dial Plan Settings For information on the individual Bria Professional settings that relate to the dial plan: • • • digit_map. See “Dial Plan Syntax”, below. digit_map_timer_critical. See “Timers” on page 8. digit_map_timer_partial. See “Timers” on page 8.
CounterPath Corporation Pattern Valid Content The content for a pattern follows the digit map rules of RFC 2705, supplemented by the rules for regular expressions. Where there is an overlap between the digit map and regular expression rules, the digit map rules apply. For this reason, there are some special cases, included in the table below. The following table describes the most common elements. As mentioned, all regular expression elements are supported. Some elements use the back slash \ character.
Configuring Bria Professional (Retail Edition) • • T timer is set in proxies:common:digit_map_timer_critical. The default value is 4000 milliseconds (4 seconds). The long timer is set in proxies:common:digit_map_timer_partial. The default value is 20000 milliseconds (20 seconds). Transformation Keywords Keyword Description prestrip Strip the first n characters from the input before placing the call. poststrip Remove n number of characters from the end of the input before placing the call.
CounterPath Corporation Results of the Comparison How Call Placed Type of Match Meaning of Match Result User is typing Partial match The characters typed so far follow the pattern but there are not yet enough characters for a pending or complete match. • If the user presses Enter or Dial, then the default account is used. No transformation is performed. • If the user stops typing for the long timer length (usually 20 seconds), then the default account is selected.
Configuring Bria Professional (Retail Edition) Example 2 3xxT|1xxxxxxxxxx|[2-9]xxxxxxxxx|+x.T;match=2;pre="9";match=3; pre="91";match=4;prestrip=1;pre="9011" 3xxT The first pattern is any three-digit number beginning with 3. No transformation. The assumption is that this is an internal extension. The timer forces Bria Professional to wait after detecting a three-digit number beginning with 3, in case the user is actually dialing a local call starting with 3.
CounterPath Corporation 2.7 DTMF This group of settings configures Bria Professional to handle DTMF. DTMF will be sent using either: • • • Out-of-band, using 2833 DTMF packets Out-of-band, using INFO DTMF. In-band, by encoding the DTMF signal in the audio stream. The preferred method is out-of-band. In-band is used only to deal with specific network situations, as described in the reference section for these settings. You must configure Bria Professional to use either in-band or out-of-band.
Configuring Bria Professional (Retail Edition) Encryption Options Supported by Bria Professional You must set up Bria Professional so that security matches one of the four encryption options included on the Bria Professional GUI. Option How Outgoing Calls are Handled How Incoming Calls Are Handled Make and accept only encrypted calls Bria Professional will place all calls with TLS. The call invite will specify SRTP media encryption.
CounterPath Corporation 2.9 Feature Enabling This group of settings covers features that are enabled by only one or two settings. Features that need more extensive configurationare covered in other sections in this manual: “File Transfer” on page 14, “LDAP” on page 15, “MWI Notification” on page 16, “Presence” on page 18, “Voicemail: “Send to Voicemail”” on page 20. For other settings related to features, see “User Experience” on page 19. 2.10 File Transfer File transfer lets users send and receive files.
Configuring Bria Professional (Retail Edition) XMPP file transfer is direct if a peer-to-peer connection exists between the two sides. If such a connection is not possible, then the transfer is sent via the XMPP proxy that the XMPP service provides or via the public server proxy.jabber.org. 2.11 LDAP If you have set up an LDAP directory on a remote server, you can configure Bria Professional to fetch data from it. This data will be displayed in the LDAP directory in the Contacts module.
CounterPath Corporation 2.13 MWI Notification This group of settings let you configure Bria Professional to subscribe to your voicemail server to receive notification that messages are waiting for the user. To use MWI, you must have a voicemail server that supports MWI. MWI is set up in each account, that is, in the proxies:proxyn settings. Receiving MWI Information MWI subscription can be performed using SIP subscriptions or via MWI NOTIFY (implicit subscription).
Configuring Bria Professional (Retail Edition) 2.14 Network This group covers settings in several subtopics, all relating to SIP accounts (not XMPP accounts). Make sure you set them for each of your SIP accounts. For your XMPP accounts, the settings are simply ignored. Firewall Traversal This group of settings lets you configure Bria Professional for firewall traversal. This group can be divided into several groupings: • • • • • • • ICE, one setting.
CounterPath Corporation 2.15 Presence This group of settings lets you configure how presence is supported when presence is handled using SIMPLE on SIP accounts. For presence on XMPP accounts, no special configuration is required: presence subscriptions are always created for XMPP buddies. If you are not supporting presence through SIP, make sure you disable presence on every SIP account.
Configuring Bria Professional (Retail Edition) 2.16 QoS This group of settings lets you configure the quality of service you offer, if applicable. There are two types of services. The service to use depends on what your VoIP service provider supports: • • GQoS, which is available for audio and video. DSCP (also known as ToS), which is available for audio, video and signaling.
CounterPath Corporation 2.21 Voicemail: “Send to Voicemail” You can configure Bria Professional to automatically send unanswered phone calls to voicemail. (Other call handling features are described in “MWI Notification” on page 16). There are two ways to send to voicemail, using a 486 SIP response or using a 302 SIP response.
Configuring Bria Professional (Retail Edition) 2.23 Zero-Touch Configuration These settings control whether zero-touch configuration is enabled. When this configuration is enabled, Bria Professional automatically detects the audio and video devices connected to the Bria Professional computer, automatically detects the type of connection, and displays device configuration messages.
CounterPath Corporation 22
