Application Notes for Configuring Alternate Methods of Domain Based Routing for Outbound SIP Calls with the Avaya SIP Trunk Architecture Issue 1.

Transcription

1 Avaya Solution & Interoperability Test Lab Application Notes for Configuring Alternate Methods of Domain Based Routing for Outbound SIP Calls with the Avaya SIP Trunk Architecture Issue 1.0 Abstract These Application Notes describe alternate methods to configure Domain Based Routing for outbound SIP calls in an Avaya SIP trunk architecture. The Avaya SIP trunk architecture consists of Avaya Communication Manager as well as Avaya SIP Enablement Services. Comparisons with Avaya SIP Enablement Services Host Map provisioning are discussed. Information in these Application Notes has been obtained through testing conducted by the Avaya Solution and Interoperability Test Lab. 1 of 27

2 Table of Contents 1. Introduction Host Map Routing Domain Based Routing Domain Based Routing Using Host Maps Equipment and Software Validated Avaya Communication Manager SIP Trunks Host Map Routing Method (No DNS Query) Host Map Provisioning Example Avaya SES Provisioning Verify the Avaya SES SIP Domain - System Properties Configure a Host Map Avaya Communication Manager Provisioning Configure Signaling Group Far-End Domain Field Domain Based Routing Method (No Avaya SES Host Maps) Domain Based Routing Provisioning Example Avaya SES Provisioning Verify DNS Provisioning on the Avaya SES Add/Change DNS Provisioning on the Avaya SES Avaya Communication Manager Provisioning Configure Signaling Group Far-End Domain Field Domain Based Routing with Host Maps Domain Based Routing with Host Map Provisioning Example Avaya SES Provisioning Verify the Avaya SES SIP Domain - System Properties Configure a Host Map for Domain Based Routing Verify/Add the Avaya SES DNS Provisioning Avaya Communication Manager Provisioning Summary of Avaya SES Outbound Call Routing Methods References APPENDIX A: Specifying Pattern Strings in Host Maps Address Map Caveats Over-lapping Address Map Strings Using a Plus Sign (+) in a Host Map of 27

3 1. Introduction These Application Notes describe alternate methods for provisioning Domain Based Routing for outbound SIP calls from the Avaya SIP trunk architecture to a service provider. The Avaya SIP trunk architecture consists of an Avaya Communication Manager platform (providing PBX functionality) and an Avaya SIP Enablement Services (SES) platform (providing SIP proxy functionality). Figure 1 shows the typical Avaya SIP trunk architecture for outbound SIP calls. From a service provider perspective the Avaya components are considered Customer Premises Equipment (CPE). Outbound calls are those originating from the CPE. Figure 1: Avaya SIP Trunk Architecture for Outbound SIP calls When Avaya Communication Manager sends an outbound SIP call to the Avaya SES, the Avaya SES has two primary methods to determine where to send the call for completion. One of these methods is Host Maps and the other is Domain Based Routing. Each of these methods has advantages and each requires different provisioning on Avaya Communication Manager and the Avaya SES. 3 of 27

4 These Application notes also describe a third method that combines Host Maps with Domain Based Routing. Note - The initial installation, configuration, and provisioning of the Avaya servers for Avaya Communication Manager and Avaya SIP Enablement Services, Avaya Media Gateways and their associated boards, as well as Avaya telephones, are presumed to have been previously completed and are not discussed in these Application Notes Host Map Routing The most common method for the Avaya SES to route outbound calls is to use Host Maps (see Section 3). Host Maps specify matching called number patterns and then specify where these matching calls are to be sent for call completion (typically an IP address). When Host Maps are to be used, Avaya Communication Manager sends outbound SIP calls to the Avaya SES with a Request URI that must match the Avaya SES SIP Domain parameter (see Section 3.2.1). If the Avaya SES receives a Request URI that matches its SIP domain, (the Avaya SES is authoritative for the call), the Avaya SES will use Host Maps to route the call to its destination. Host Maps are not unlike the static routes used in network router configurations. That is, Host Maps typically specify a specific destination IP address that may or may not be accessible at any given time. Outbound call routing issues due to service provider network modifications or outages can only be compensated for by manually adding to or modifying the destination specified in the Host Maps. The advantage of using Host Maps is they give a user control of Avaya SES outbound call processing and provide flexibility to support custom configurations (e.g. non standard transport protocol ports or protocols may be specified) Domain Based Routing An alternative to using Host Maps is to use Domain Based Routing for outbound calls. Domain Based Routing relies on the Avaya SES to issue DNS SRV queries to a service provider network DNS server. Responses to these queries provide the call routing information (typically an IP address) for each outbound call attempt. The service provider must supply the IP address(s) of the DNS server and these addresses must be provisioned in the Avaya SES (see Section 4.2.1). Since the service provider is in control of their DNS server, they have the flexibility to modify the DNS entries to reflect changes to their network (e.g. additions, outages, load balancing, maintenance, etc). This provides for a more dynamic environment with minimal Avaya SES provisioning. When Domain Based Routing is used, Avaya Communication Manager sends outbound SIP calls to the Avaya SES with a Request URI that does not match the Avaya SES SIP Domain parameter (see Section 3.2.1). Typically this foreign domain is provided by the service provider (e.g. sp.foreign.com). When the Avaya SES receives the Request URI that does not match its SIP domain, (the Avaya SES is not authoritative for the call), the Avaya SES ignores any provisioned Host Maps and will issue the DNS SRV query to resolve the foreign domain. Since Avaya Communication Manager is specifying a foreign domain for these outbound calls, a separate SIP trunk must be provisioned to the Avaya SES for these calls (see Section 4.3.1). 4 of 27

5 Table 1 shows a summary of the methods described in Sections 1.1 and 1.2. Avaya SES Outbound Call Routing Method Avaya Communication Manager Outbound SIP Trunk Far End Domain Considerations Host Maps Avaya SES SIP Domain Host Maps offer flexibility as to the transport protocol and port specified. Host Maps may specify any destination. Host Map matching criteria may be as wide or narrow as required. Each Host Map can only specify one destination. If a service provider supports multiple service access nodes, a Host Map may be defined to each, although the matching pattern must be unique for each Host Map. Possibility for over-lapping/ contradictory Host Maps to be provisioned resulting in indeterministic Avaya SES call processing. Host Maps are static in that network changes must be compensated for manually by editing the Host Map list. Domain Based Routing (DNS query) Foreign Domain Domain Based Routing requires that a service provider network aware DNS server(s) is provisioned in the Avaya SES. No Host Maps are required. Requires a dedicated outbound trunk provisioned on Avaya Communication Manager that specifies a foreign domain. Domain Based Routing is dynamic in that no Avaya SES provisioning is required to reflect service provider network changes. Alternate transport protocols and ports cannot be specified via the 5 of 27

6 Avaya SES although DNS exchanges can specify which transport protocols and ports to use (as provisioned by the service provider). Domain Based Routing offers maximum flexibility for the service provider since they can manipulate the DNS records to reflect load balancing, network changes, network outages, etc. Table 1: Host Map versus Domain Based Routing for outbound calls Note - The Avaya SES has an option to specify an Outbound Proxy. The Outbound Proxy is an external device (e.g. a SIP Gateway) that the Avaya SES will route outbound calls to if the request URI specifies a foreign domain. Since specifying an Outbound Proxy precludes the use of Domain Based Routing, Outbound Proxy functionality is not discussed in these Application Notes Domain Based Routing Using Host Maps As shown in Table 1, there are advantages to using Domain Based Routing. However there may be circumstances where a user may not wish to add additional SIP trunks required for Domain Based Routing, or wishes to use Host Maps for all outbound calls. Even though Host Maps are being used, the user may still want the service provider network to control the destination of outbound calls via SES DNS SRV queries. In these cases Domain Based Routing can still be utilized in conjunction with Host Maps. A Host Map can be provisioned so that the Avaya SES will perform a DNS SRV query (see Section 1.2) instead of specifying a specific destination as described in Section 1.1. The user must still define the matching pattern of the outbound call to a Host Map, but instead of a static destination being defined (IP address), a foreign domain provided by the service provider is specified. This foreign domain will trigger the same DNS SRV query as described in Section 1.2. As with the typical Host Map provisioning, Avaya Communication Manager sends outbound SIP calls to the Avaya SES with a Request URI that must match the Avaya SES SIP Domain parameter (see Section 3.2.1), making the SES authoritative for the call. 6 of 27

7 1.4. Equipment and Software Validated The following Avaya components, software and firmware were used to test the configurations described in these application notes. Equipment Firmware Software Avaya S8720 Server - - Avaya G650 Media Gateway IPSI TN2312BP CLAN TN799DP MedPro TN2302AP HW3 FW43 HW0 FW28 HW2 FW41 Avaya Communication Manager R015x (5.1.1) Avaya SIP Enablement Services (SES) - ses Avaya 4610 SW IP Telephones a10d01b2-8-3.bin (H.323) - a10d01b2-2-2.bin (SIP) Avaya 9620 and 9630 IP 1.5 (H323) - Telephones (SIP) Avaya 6408D+ Digital Phones - - Table 2 Hardware, firmware, and software configuration list 2. Avaya Communication Manager SIP Trunks SIP trunks defined on Avaya Communication Manager are comprised of a Signaling Group and a Trunk Group. These SIP trunks terminate on the Avaya SES. The Signaling Group form contains a Far-End Domain parameter (see Section 3.3.1). This parameter determines what domain name will be inserted in the Request URI of the INVITE message of the outbound call to the Avaya SES. When the Avaya SES is provisioned, a SIP Domain parameter is defined on the Avaya SES System Properties form (see Section 3.2.1). Based on how the SIP Signaling Group Far-End Domain and the Avaya SES SIP Domain fields are provisioned, the Avaya SES may use Host Maps (Avaya SES Host Map form, Section 3.2.2), or Domain Based Routing DNS SRV queries (see Section 4.2.1) to direct the outbound SIP calls. At a minimum, one SIP trunk is defined between Avaya Communication Manager and the Avaya SES. This trunk is used for communication between the Avaya SES and Avaya Communication Manager to support Avaya SIP telephone registration as well as to support inbound and outbound SIP calls. This Local SIP trunk must specify the SIP Domain of the Avaya SES in the Signaling Group form Far-End Domain parameter so that the Avaya SES is authoritative for the calls. Additional SIP trunks may be specified on Avaya Communication Manager for inbound or outbound calls as required by the user. If Domain Based Routing is to be used for outbound calls then a new SIP trunk must be created that specifies a foreign domain in the SIP trunk Signaling Group Far-End Domain field of 27

8 As described in Section 1, if the SIP trunk Signaling Group Far-End Domain field specifies the Avaya SES SIP Domain, the Avaya SES is authoritative for the call and will query Host Maps to determine where to send the call. If the SIP trunk Signaling Group Far-End Domain field specifies a foreign domain, the Avaya SES is not authoritative for the call and will attempt a DNS SRV query (Domain Based Routing). See the references in Section 7 for more information on provisioning for Avaya SIP Trunking. 3. Host Map Routing Method (No DNS Query) This section describes the provisioning of Avaya Communication Manager and the Avaya SES to support Avaya SES Host Map routing for outbound calls. A specific destination is provisioned for the outbound call and no DNS query is issued. When Avaya SES Host Map routing is performed for outbound calls, Avaya Communication Manager specifies the SIP domain of the Avaya SES in the Request URI of the INVITE message it sends to the Avaya SES. The Avaya SES sees that it is authoritative for the call, and looks for a Host Map that matches the called pattern in the Request URI. Then the Avaya SES looks for a Contact that is associated with the matching Host Map and sends the INVITE to the destination specified in the Contact. Note Only the Avaya Communication Manager and Avaya SES provisioning specific to Host Map or Domain Based Routing is discussed in the following sections. See reference [1] and [2] for more information on SIP trunk provisioning on Avaya Communication Manager and the Avaya SES Host Map Provisioning Example The following steps describe how to provision Avaya Communication Manager and the Avaya SES to support Host Map Routing. 1. Avaya Communication Manager a. Avaya Communication Manager has the Authoritative Domain field of the ipnetwork-region form provisioned with the FQDN of the Avaya SES SIP Domain (e.g. ses.domain.com - see Section 3.2.1). This is the region associated with IP telephones or the region associated with the C-LAN/Procr for legacy phones. Avaya Communication Manager will use this value in the INVITE From header. b. The Avaya Communication Manager outbound trunk has the FQDN of the Avaya SES SIP Domain specified in the Far-End Domain field of the associated Signaling Group form (e.g. ses.domain.com see Section 3.3.1). Avaya Communication Manager will use the FQDN of the Avaya SES SIP Domain in the Request URI of the INVITE. c. Avaya Communication Manager sends the INVITE to the Avaya SES. 2. Avaya SES a. The Avaya SES compares the Request URI (ses.domain.com) of the INVITE received from Avaya Communication Manager to its SIP Domain (ses.domain.com) and sees that it is authorative for the FQDN. Therefore, the Avaya SES will look at any provisioned Host Maps. 8 of 27

9 b. The Avaya SES will send the call to the destination specified in the associated Contact (see Section 3.2.2). Note If no port or protocol value is specified in a Host Map contact, the SES will use port 5060 and UDP protocol for outbound calls. However there may be cases where the user may need to over-ride these values. If the user needs to specify a different destination port and/or protocol, then Avaya SES Host Maps must be used to specify these new values Avaya SES Provisioning The following sections access the Avaya SES web interface from any web browser. See the references in Section 7 for more information on Avaya SES provisioning for Avaya SIP Trunking Verify the Avaya SES SIP Domain - System Properties 1. After login, the Integrated Management page is displayed. Select Launch SES Administration Interface. 2. The Top SIP Server Management page will open. Select Server Configuration option and then select System Properties. 3. Note the domain specified in the SIP Domain field (e.g. ses.domain.com). This will be used in the Avaya Communication Manager Far-End Domain field of the SIP trunk used for outbound calls to the Avaya SES (see Section 3.3.1). Figure 2 Avaya SES View System Properties SIP Domain Configure a Host Map 1. Navigate back to the Top SIP Server Management page. 2. Display the List Hosts page by following the Hosts link in the left navigation pane and then clicking on List. Next click on the Map option under the Commands section of the List Hosts screen (Figure 3). 9 of 27

10 Figure 3: Avaya SES List Hosts 3. The List Host Address Map page will open (Figure 4). 4. Select Add Map In New Group Figure 4: Avaya SES List Host Address Map 5. The Add Host Address Map window will open (Figure 5). 6. In the Name field enter a name for the Map (e.g. Outbound). 7. In the Pattern field enter a called number string to match on. In this example a pattern to match on all 1800 numbers is entered ^sip:1800[0-9]{7} Note See Appendix A for details on specifying Host Map patterns. 8. Verify that the Replace URI option is checked. 10 of 27

11 9. Click on the Add button. Figure 5: Avaya SES Add Host Address Map 10. Click on the Continue button when prompted. The updated List Host Address Map window will open (Figure 6). 11. Select Add Another Contact and the Add Host Contact window will open (Figure 7). Figure 6: Avaya SES Updated List Host Address Map 12. In the Contact field enter the destination IP address for this outbound call (e.g ) using the following format: 11 of 27

12 Note For clarity the default port 5060 was specified as was default transport protocol UDP. A different port and/or transport protocol may be specified if required. Figure 7: Avaya SES Add Host Contact 13. Click on Add and then Continue when prompted Avaya Communication Manager Provisioning For Host Map based routing, the Far-End Domain in the Signaling Group form is the SIP Domain of the Avaya SES (see Section 3.2.1). Note - The Avaya Communication Manager commands described in these Application Notes were administered using the System Access Terminal (SAT). SSH was used to connect to the SAT via the appropriate IP address, login and password. Note Only the Avaya Communication Manager provisioning specific to Host Map or Domain Based Routing is discussed in the following section. See the references in Section 7 for more information on Avaya SIP Trunk provisioning Configure Signaling Group Far-End Domain Field 1. Using the add signaling-group x command (where x is the next available Signaling Group number) or the change signaling-group x command, configure the Signaling Group as follows: Enter the Avaya SES SIP Domain (see Section 3.2.1) in the Far-end Domain field (e.g. ses.domain.com). add signaling-group 10 SIGNALING GROUP Group Number: 10 Group Type: sip Transport Method: tls Near-end Node Name: clan Far-end Node Name: SES Near-end Listen Port: 5061 Far-end Listen Port: of 27

13 Far-end Network Region: 1 Far-end Domain: ses.domain.com Bypass If IP Threshold Exceeded? n DTMF over IP: rtp-payload Direct IP-IP Audio Connections? y Enable Layer 3 Test? n IP Audio Hairpinning? n Session Establishment Timer(min): 3 Alternate Route Timer(sec): 6 Figure 8: Host Map Routing - Signaling Group Far-End Domain Field 4. Domain Based Routing Method (No Avaya SES Host Maps) When Domain Based Routing is used, Avaya Communication Manager specifies a foreign FQDN in the Request URI of the INVITE message it sends to the Avaya SES. The Avaya SES is therefore not authoritative for the call, does a DNS SRV query for this foreign domain, and forwards the INVITE based on the DNS response. The service provider may modify the DNS server entries to reflect network changes or outages, or provide multiple DNS entries for load balancing and redundancy. Therefore the IP address of the associated service providers DNS server(s) must be provisioned on the Avaya SES (see Sections and 4.2.2). When a foreign FQDN is specified in conjunction with Domain Based Routing, any provisioned Host Maps are ignored. Domain Based Routing provides for more flexible outbound call provisioning for the CPE, as all the call route decisions take place in the service provider network Domain Based Routing Provisioning Example The following steps describe provisioning on Avaya Communication Manager and the Avaya SES to support Domain Based Routing. 1. Avaya Communication Manager a. Avaya Communication Manager has the Authoritative Domain field of the ipnetwork-region form provisioned with the FQDN of the Avaya SES SIP Domain (e.g. ses.domain.com - see Section 3.2.1). Avaya Communication Manager will use this value in the INVITE From header. b. The Avaya Communication Manager outbound trunk has a foreign FQDN specified in the Far-End Domain field of the associated Signaling Group form (e.g. sp.foreign.com see Section 1.2). The term Foreign means that the FQDN does not match the FQDN specified in the SIP Domain field of the Avaya SES. Avaya Communication Manager will use this foreign FQDN in the Request URI of the INVITE. c. Avaya Communication Manager sends the INVITE to the Avaya SES. 2. Avaya SES a. The Avaya SES compares the Request URI (sp.foreign.com) of the INVITE received from Avaya Communication Manager to its SIP Domain (ses.domain.com) and sees that it is not authorative for the foreign FQDN. Therefore, the Avaya SES will not reference any provisioned Host Maps. 13 of 27

14 b. The Avaya SES will send a DNS SRV request to the DNS server(s) that has(have) been provisioned in the Avaya SES (see Sections and 4.2.2). c. The Avaya SES will send the call to the destination specified in the DNS response. Note By default the Avaya SES will use port 5060 and UDP protocol for outbound calls. The DNS SRV responses may also specify which port and/or protocol the Avaya SES is to use. However there may be cases where the user may need to over-ride these values. If a different destination port and/or protocol are required, then Domain Based Routing should not be used and Avaya SES Host Maps must be used to specify these new values. See Section 3 for Host Map provisioning Avaya SES Provisioning When Domain Based Routing is used for outbound calls, no Host Map provisioning is needed. However a DNS server(s) entry must be verified or added as shown below Verify DNS Provisioning on the Avaya SES The IP address of the DNS server used by the Avaya SES is typically specified during the Avaya SES installation process. The DNS address can be verified by logging on to the Avaya SES Linux shell (using SSH and the appropriate credentials). Go to the /etc directory and enter the cat resolv.conf command. The current DNS entry is displayed (e.g & Figure 9). craft@avaya_sil_ses> cat resolv.conf # resolv.conf generated by CCS Installer nameserver nameserver search company.com Figure 9: Avaya SES Display Current DNS Configuration Add/Change DNS Provisioning on the Avaya SES If a DNS entry needs to be added or changed, connect to the Avaya SES Linux shell (any directory) and enter the initial_setup command (the setup process may execute several background functions that may take a few minutes). The screen shown in Figure 10 below will be displayed. 14 of 27

15 Warning The initial_setup procedure described in this section for modifying/adding DNS information could result in the re-initialization of the Avaya SES data base and all existing provisioning would be lost. It is strongly recommended that the Avaya SES be backed up prior to this procedure. Note Running initial_setup will cause the SES processes to restart. This will interrupt SIP call processing as well as unregistering any SIP phones associated with the SES. Using the Tab key, move the cursor to the Primary DNS IP Address line and enter the new DNS address. If there is a secondary DNS address, enter it in the next line. Press the Tab key until the OK button is highlighted. Then press the Enter key. You can press the Exit button at any time to abort the process. Note The Avaya SES DNS Domain Name shown in Figure 10 below does not have the same meaning as the Avaya SES SIP Domain described in Section The DNS Domain is the domain name that network DNS servers use to resolve the Avaya SES IP address. The SIP Domain is the domain the Avaya SES uses for SIP messaging and to determine its authoritative state for SIP calls. These two domain name fields are typically provisioned with the same value, although this is not required. Figure 10: - Changing the Avaya SES DNS IP Address 15 of 27

16 After the OK button is pressed, the screen shown in Figure 11 will be displayed. Leaving the default value selected (e.g. Simplex), press the Tab key until the OK button is highlighted. Press the Enter key. Figure 11: Avaya SES - Default Redundancy Configuration After the OK button is pressed, the screen shown in Figure 12 will open. Verify the Finish button is highlighted (use the Tab key to change the selection) and press the Enter key. Figure 12: Avaya SES - Finish Changing the DNS IP Address 16 of 27

17 Next, the screen shown in Figure 13 will open asking to stop the Avaya SES processes. Verify that the option [y] is offered. If not, enter y. Press the Enter key to accept the default value [y]. Figure 13: Changing the DNS IP Address Stopping the Avaya SES Processes The screen shown in Figure 14 will open regarding the Avaya SES database. Verify that the option [n] is offered. If not, enter n. Press the Enter key to accept the default value [n]. Note This step must be performed with caution. If y is entered and confirmed, the database will be initialized and all existing Avaya SES provisioning will be lost! Figure 14: Do Not Initialize the Avaya SES Database 17 of 27

18 Next, the screen shown in Figure 15 will open asking to restart the Avaya SES processes. Verify that the option [y] is offered. If not, enter y. Press the Enter key to accept the default value [y]. Figure 15: Changing the DNS IP Address Restarting Avaya SES The Avaya SES will then restart with the new DNS parameters Avaya Communication Manager Provisioning For Domain Based Routing, Avaya Communication Manager specifies a foreign domain that does not match the Avaya SES SIP Domain. Therefore a separate SIP trunk must be provisioned for outbound SIP traffic to the Avaya SES. Note The Avaya Communication Manager commands described in these Application Notes were administered using the System Access Terminal (SAT). SSH was used connect to the SAT via the appropriate IP address, login and password. Note Only the Avaya Communication Manager provisioning specific to Host Map or Domain Based Routing is discussed in the following section. See the references in Section 7 for more information on Avaya Communication Manager and Avaya SES provisioning Configure Signaling Group Far-End Domain Field 1. Using the add signaling-group x command (where x is the next available Signaling Group number), configure a new Signaling Group (Figure 16) as follows: Enter the FQDN provided by the service provider, that will be used to resolve outbound calls via DNS, in the Far-end Domain field (e.g. sp.foreign.com). 18 of 27

19 add signaling-group 10 SIGNALING GROUP Group Number: 10 Group Type: sip Transport Method: tls Near-end Node Name: clan Far-end Node Name: SES Near-end Listen Port: 5061 Far-end Listen Port: 5061 Far-end Network Region: 1 Far-end Domain: sp.foreign.com Bypass If IP Threshold Exceeded? n DTMF over IP: rtp-payload Direct IP-IP Audio Connections? y Enable Layer 3 Test? n IP Audio Hairpinning? n Session Establishment Timer(min): 3 Alternate Route Timer(sec): 6 Figure 16: Domain Based Routing - Signaling Group Far-End Domain Field 2. Add a corresponding Trunk Group per Avaya Communication Manager SIP trunk provisioning. 3. Provision Avaya Communication Manager outbound call routing to use this new SIP trunk. 5. Domain Based Routing with Host Maps As described in previous sections, the use of Domain Based Routing requires the provisioning of a new Avaya Communication Manager SIP trunk that specifies a foreign domain in the Far-End Domain field of the Signaling Group. In addition, the Avaya SES will not use Host Maps when it receives an outbound call from Avaya Communication Manager containing a foreign domain in the Request URI. As described in Section 1.3, there may be circumstances where a user may not wish to add additional SIP trunks required for Domain Based Routing, or wishes to use Host Maps for all outbound calls. Even though Host Maps are being used, the user may still want the service provider network to control the destination of outbound calls via SES DNS SRV queries. In these cases Domain Based Routing can still be utilized in conjunction with Host Maps Domain Based Routing with Host Map Provisioning Example The following steps describe how to provision Avaya Communication Manager and the Avaya SES to support Domain Based Routing with Host Maps. 1. Avaya Communication Manager a. Avaya Communication Manager has the Authoritative Domain field of the ipnetwork-region form provisioned with the FQDN of the Avaya SES SIP Domain (e.g. ses.domain.com). This is the region associated with IP telephones or the region associated with the C-LAN/Procr for legacy phones. Avaya Communication Manager will use this value in the INVITE From header. b. The Avaya Communication Manager outbound trunk has the FQDN of the Avaya SES SIP Domain specified in the Far-End Domain field of the associated Signaling Group form (e.g. ses.domain.com see Section 3.3.1). Avaya 19 of 27

20 Communication Manager will use the FQDN of the Avaya SES SIP Domain in the Request URI of the INVITE. c. Avaya Communication Manager sends the INVITE to the Avaya SES. 2. Avaya SES a. The Avaya SES compares the Request URI (ses.domain.com) of the INVITE received from Avaya Communication Manager to its SIP Domain (ses.domain.com) and sees that it is authorative for the FQDN. Therefore, the Avaya SES will look at any provisioned Host Maps. b. The Avaya SES has a Host Map defined with a Contact (Figure 21 below) that specifies the foreign domain supplied by the service provider (e.g. sp.foreign.com) as the destination. c. The Avaya SES will issue a DNS SRV query for the foreign domain to the provisioned DNS server (see Section and 4.2.2). d. The Avaya SES sends the call to the destination specified in the DNS response Avaya SES Provisioning The following sections access the Avaya SES web interface from any web browser. See the references in Section 7 for more information on Avaya SES provisioning Verify the Avaya SES SIP Domain - System Properties 1. Follow Steps 1 through 3 in Section to verify the SIP Domain of the Avaya SES Configure a Host Map for Domain Based Routing 1. Navigate back to the Top SIP Server Management page. 2. Display the List Hosts page by following the Hosts link in the left navigation pane and then clicking on List. Next click on the Map option under the Commands section of the List Hosts screen (Figure 17). 20 of 27

21 Figure 17: Avaya SES List Hosts 3. The List Host Address Map page will open (Figure 18). 4. Select Add Map In New Group Figure 18: Avaya SES List Host Address Map 5. The Add Host Address Map window will open (Figure 19). 6. In the Name field enter a name for the Map (e.g. Outbound_DBR). 7. In the Pattern field enter a called number string to match on. In this example a pattern to match on all 1555 numbers is entered ^sip:1555[0-9]{7} Note See Appendix A for details on specifying Host Map patterns. 8. Verify that the Replace URI option is checked. 9. Click on the Add button. 21 of 27

22 Figure 19: Avaya SES Add Host Address Map 10. Click on the Continue button when prompted. The updated List Host Address Map window will open (Figure 20). Figure 20: Avaya SES Updated List Host Address Map 11. Select Add Another Contact and the Add Host Contact window will open (Figure 21). 12. In the Contact field (Figure 21) enter the foreign domain provided by the service provider (e.g. sp.foreign.com) for this outbound call using the following format: 22 of 27

23 Figure 21: Avaya SES Add Host Contact 13. Click on Add and then Continue when prompted Verify/Add the Avaya SES DNS Provisioning Follow the procedures described in Section and Avaya Communication Manager Provisioning The Avaya Communication Manager provisioning is identical to provisioning described for Host Map routing (see Section 3). 6. Summary of Avaya SES Outbound Call Routing Methods Table 3 summarizes the provisioning described in the previous sections. Avaya SES Outbound Call Routing Method Host Map Domain Based Routing Domain based Routing with Host Map Avaya Communication Manager SIP Signaling Group Far-End Domain Avaya SES SIP Domain (e.g. ses.domain.com) Service provider supplied foreign domain (e.g. sp.foreign.com) Avaya SES SIP Domain (e.g. ses.domain.com) New SIP Trunk Required? DNS Required? Host Map Required? n n y Avaya SES Host Map Contact Specific destination IP address (e.g. sip:$(user)@ ) y y n N/A n y y Table 3: Summary of Host Map and Domain Based Routing Methods Service provider supplied foreign domain (e.g. sip:$(user)@sp.foreign.com ) 23 of 27

24 7. References The following Avaya product documentation is available at [1] Administrator Guide for Avaya Communication Manager, January 2008, Issue 4.0, Document Number [2] Administering SIP Enablement Services on the Avaya S8300 Server, Document number , Issue 1.0, January 2008 [3] Installing and Administering SIP Enablement Services, January 2008, Issue 5.0, Document Number [4] SIP Support in Avaya Communication Manager Running on Avaya S8xxx Servers, Document Number , Issue 8, January [5] Application Notes for Configuring the Avaya SIP Trunk Architecture with the Verizon Business IP Trunking Service in a 2-CPE Environment, January 2009, Issue 1.0 [6] Application Notes for Configuring SIP Trunks between the Verizon Business IP Contact Center (IPCC) Services and Avaya SIP Telephony Using Domain Based Routing, January 2009, Issue of 27

25 8. APPENDIX A: Specifying Pattern Strings in Host Maps The syntax for the pattern matching used within the Avaya SIP Enablement Services is a Linux regular expression used to match against the URI string found in the SIP INVITE message. Regular expressions are a way to describe text through pattern matching. The regular expression is a string containing a combination of normal text characters, which match themselves, and special metacharacters, which may represent items like quantity, location or types of character(s). In the pattern matching string used in the Avaya SIP Enablement Services: Normal text characters and numbers match themselves. Common metacharacters used are: o A period. matches any character once (and only once). o An asterisk * matches zero or more of the preceding characters. o Square brackets enclose a list of any character to be matched. Ranges are designated by using a hyphen. Thus the expression [12345] or [1-5] both describe a pattern that will match any single digit between 1 and 5. o Curly brackets containing an integer n indicate that the preceding character must be matched exactly n times. Thus 5{3} matches 555 and [0-9]{10} indicates any 10 digit number. o The circumflex character ^ as the first character in the pattern indicates that the string must begin with the character following the circumflex. Putting these constructs together as used in this document, the pattern to match the SIP INVITE string for any valid digit number in the North American dial plan would be: ^sip:1[0-9]{10} This reads as: Strings that begin with exactly sip:1 and having any 10 digits following will match. A typical INVITE request below uses the shaded portion to illustrate the matching pattern. INVITE sip: @ :5060;transport=udp SIP/ Address Map Caveats Over-lapping Address Map Strings If over-lapping address maps are provisioned, the Avaya SES may select the first matching address map string in the list, even if there is a more definitive string further down the list. For example: 25 of 27

26 If the following address map strings are listed in this order: ^sip:555[0-9]{4} with a contact of ^sip:555[0-9]{4}[0-2]{5} with a contact of And the following dialed string is received: The Avaya SES may send the call to instead of the intended destination of (the match will be on ). A way to alleviate this situation is to indicate the end of the intended pattern by specifying character. Using the example above: If the following address map strings are listed in this order: ^sip:555[0-9]{4}@ with a contact of ^sip:555[0-9]{4}[0-2]{5} with a contact of And the following dialed string is received: The Avaya SES will send the call to the intended destination of Using a Plus Sign (+) in a Host Map Some service providers require that outbound call dial strings begin with a + character (e.g. A call to would be sent as ). When the + character is then defined as part of an outbound Host Map, the Avaya SES will interpret the + character as a control character, not as part of a dial string, causing the route to fail. Normally this situation can be fixed by specifying a backslash character \ before the + character to indicate that the + is not a control character. For example: ^sip:\ [0-9] However in the loads of the Avaya SES, two backslash characters are required to perform this function. ^sip:\\ [0-9] Note - If you go back to edit the map in the Avaya SES GUI (even if you don't change anything), the Avaya SES may remove a \ character each time. As a result, each time you edit or create a map, ensure that you have the proper number of \ characters before submitting it. 26 of 27

27 Avaya and the Avaya Logo are trademarks of Avaya Inc. All trademarks identified by and are registered trademarks or trademarks, respectively, of Avaya Inc. All other trademarks are the property of their respective owners. The information provided in these Application Notes is subject to change without notice. The configurations, technical data, and recommendations provided in these Application Notes are believed to be accurate and dependable, but are presented without express or implied warranty. Users are responsible for their application of any products specified in these Application Notes. Please any questions or comments pertaining to these Application Notes along with the full title name and filename, located in the lower right corner, directly to the Avaya Solution & Interoperability Test Lab at 27 of 27