background image

Dialogic® Vision™ CX Video Gateway Administration Manual 

SIP interface 

ISUP to SIP cause values 

The following table shows the default ISUP cause code to SIP response. This 

mapping follows RFC 3398, ISUP to SIP Mapping. 

ISUP cause value  

SIP response 

Normal event 

1  Unallocated number 

404 Not found 

2  No route to network  

404 Not found 

3  No route to destination 

404 Not found 

16  Normal call clearing 

(Typically results in a BYE or CANCEL) 

17  User busy 

486 Busy here 

18  No user responding 

408 Request timeout 

19  No answer from user 

480 Temporarily unavailable 

20  Subscriber absent 

480 Temporarily unavailable 

21  Call rejected 

403 Forbidden 

22  Number changed (without diagnostic) 

410 Gone 

22  Number changed (with diagnostic) 

301 Moved permanently 

23  Redirection to new destination 

410 Gone 

26  Non-selected user clearing 

404 Not found 

27  Destination out of order 

502 Bad gateway 

28  Address incomplete 

484 Address incomplete 

29  Facility rejected 

510 Not implemented 

31  Normal unspecified 

480 Temporarily unavailable or Resource 
unavailable 

34  No circuit available 

503 Service unavailable 

38  Network out of order 

503 Service unavailable 

41  Temporary failure 

503 Service unavailable 

42  Switching equipment congestion 

503 Service unavailable 

47  Resource unavailable 

503 Service unavailable 

55  Incoming calls barred within CUG 

403 Forbidden 

57  Bearer capability not authorized 

403 Forbidden 

58  Bearer capability not presently available 

503 Service unavailable 

65  Bearer capability not implemented 

488 Not acceptable here 

70  Only restricted digital bearer capability available 

488 Not acceptable here 

(national use)  

79  Service or option not implemented  

501 Not implemented 

Dialogic  

107 

Summary of Contents for Vision CX Video

Page 1: ...Dialogic Vision CX Video Gateway Administration Manual December 2009 64 0403 02 www dialogic com ...

Page 2: ...with intellectual property owned or validly licensed by Dialogic and no such licenses are provided except pursuant to a signed agreement with Dialogic More detailed information about such intellectual property is available from Dialogic s legal department at 9800 Cavendish Blvd 5th Floor Montreal Quebec Canada H4M 2V9 Dialogic encourages all users of its products to procure all necessary intellect...

Page 3: ...gust 2009 BK Dialogic Vision CX Video Gateway 4 2 and Dialogic Vision VX Integrated Media Platform 4 2 64 0403 01 Rev A June 2009 DEH BK Dialogic Vision CX Video Gateway 4 1 and Dialogic Vision VX Integrated Media Platform 4 1 Last modified November 12 2009 Refer to www dialogic com for product updates and for information about support policies warranty information and service offerings ...

Page 4: ......

Page 5: ...ards 22 Document conventions 23 Related documentation 24 Chapter 3 Configuring the CX Video Gateway 25 Overview of configuring the CX Video Gateway 25 Gathering information 26 Network configuration information all models 26 ISDN configuration information ISDN models 26 ISUP configuration information ISUP models 27 Signaling Server configuration information ISUP models 29 Video Transcoder configura...

Page 6: ... table 64 Routing table fields 64 Routing table rules 65 Using the gateway routing table 66 Adding a routing rule 66 Modifying a routing rule 67 Deleting a routing rule 67 Reordering routing rules 67 Routing table expressions 68 Pattern matching expressions 68 Pattern generation expressions 69 Routing to a specific trunk group 70 Routing clear channel data 71 Chapter 6 Gateway routing table exampl...

Page 7: ...call completion to voice service 98 Call logic 98 Using the service 99 Adding the gateway ccxml application 99 Enabling the Call Server for early media 99 Creating a gateway routing table entry 100 Examples for VCCV 101 Configuring streaming only media server applications 102 Chapter 8 SIP interface 103 Overview of the SIP interface 103 Interoperability 104 Inbound calls 105 Outbound calls 106 ISU...

Page 8: ...alogic Vision CX Video Gateway Administration Manual Fine tuning gateway routing 126 Creating a new gateway application for routing 126 Creating a custom application for routing 126 Chapter 10 Glossary 129 8 Dialogic ...

Page 9: ...d the VX Integrated Media Platform collectively Note Products to which this document pertains are part of the NMS Communications Platforms business that was sold by NMS Communications Corporation NMS to Dialogic Corporation Dialogic on December 8 2008 Accordingly certain terminology relating to the products has been changed Below is a table indicating terminology that was formerly associated with ...

Page 10: ......

Page 11: ...in band DTMF support Optionally connects incoming faxes to a third party T 38 server Optionally provides fast call setup techniques to speed up 3G 324M call setup time Produces detailed event logs with multiple information levels Provides a web based console called the Vision Console to configure and manage the gateway Provides an SNMP interface for monitoring application usage and server health T...

Page 12: ...rotocols ISDN which is available with the ISDN audio and ISDN video models ISUP which is available with the ISUP audio and ISUP video models These models are available with one or more signaling servers All CX Video Gateway models use SIP RTP signaling to interface with the IP network For more information see ISDN models on page 15 and ISUP models on page 16 12 Dialogic ...

Page 13: ...fc3984bis 06 txt ITU T Recommendation H 264 and 3GPP specifications TS 26 111 TS 26 911 TS 26 140 Encoding format Profile Level Baseline profile level 1 0 1b 1 1 and 1 2 Packetization mode single NAL and non interleave Picture format frame rate and encoding bit rate are the same as H 263 except that CIF at 30 fps is not supported Video MPEG 4 Standard IETF RFC 3016 ISO IEC 14496 2 2004 and 3GPP sp...

Page 14: ... into a single NSRP command frame This reduces the number of message round trips and thus reduces call setup time Windowed Simple Retransmission protocol WNSRP an H 245 transport improvement technique that is standardized in ITU T Recommendation H 324 and accepted into the 3G 324M standard by 3GPP Media oriented negotiation acceleration MONA which unites the technologies for H 324 call setup accel...

Page 15: ...tion shows the ISDN audio model RTP G 711 E1 ISDN SIP CX Video Gateway ISDN access network IP network ISDN video model In the ISDN video model the gateway Provides ISDN signaling with 3G 324M Provides SIP signaling Provides the option to transcode between AMR and G 711 Supports the Call Control Extensible Markup Language CCXML for call control The ISDN video model requires a mobile video device th...

Page 16: ... This topic describes the Basic ISUP audio model Basic ISUP video model ISUP scalable deployment model ISUP redundant deployment model Basic ISUP audio model In the basic ISUP audio model the gateway Provides ISUP signaling Provides SIP signaling Supports the Call Control Extensible Markup Language CCXML for call control The following illustration shows the basic ISUP audio model RTP G 711 E1 ISUP...

Page 17: ...des SIP signaling Provides the option to transcode between AMR and G 711 Supports the Call Control Extensible Markup Language CCXML for call control The basic ISUP video model requires a mobile video device that supports 3G 324M The following illustration shows the basic ISUP video model SIP RTP AMR audio RTP H 263 video E1 3G 324M ISUP CX Video Gateway IP network SS7 access network Dialogic 17 ...

Page 18: ...d each of the other gateways in the system In this model the gateways are configured to share the single signaling point code terminated by the gateway with ISUP interface This configuration allows for high density deployments for a single signaling point code The following illustration shows the ISUP scalable deployment model CX Video Gateway CX Video Gateway CX Video Gateway IP network SIP SIP S...

Page 19: ...le signaling point code and provide node level redundancy The following illustration shows an ISUP model with two CX Video Gateways to support redundancy The redundant pair of gateways with ISUP terminations seamlessly provides signaling services for multiple gateways as in the scalable deployment model CX Video Gateway CX Video Gateway CX Video Gateway IP network SIP SIP SIP RTP G 711 RTP G 711 R...

Page 20: ...s and inserts the transcoder in the video media path between the gateway and the target IP endpoint The communication interface to the IP endpoint is SIP The interworking of the gateway has proprietary control of the video transcoder Video traffic is routed to and from the video transcoder via RTP Audio traffic flows separately from the gateway to the IP endpoint via RTP PSTN Network IP Network CX...

Page 21: ... multiple CX Video Gateways may be configured to share multiple video transcoder systems In this configuration the solution provider can view the composite of these servers as a single node or scalable gateway PSTN Network IP Network CX Video Gateway Video Transcoder Video Transcoder Video Transcoder CX Video Gateway PSTN Network PSTN network IP Network IP network CX Video Gateway CX Video Gateway...

Page 22: ...3 1998 ETS 300 121 ETSI ISUP V 1 1992 ETS 300 356 1 ETSI ISUP V 2 1995 ETS 300 356 33 ETSI ITU T Q 730 737 1992 ITU T Q 761 764 1997 ITU T Q 767 1992 ITU T Q 784 1996 1997 ANSI T1 113 236 1995 NTT Q 761 764 future MTP ETSI ETS 300 008 1 300 308 2 1997 All ISUP models GF001 9001 SS7 for National Telephone Network of China ITU T Q 701 702 1992 ITU T Q 703 704 1996 ITU T Q 707 1992 ITU T Q 781 782 19...

Page 23: ...stration Manual Overview of the CX Video Gateway Document conventions By default the CX Video Gateway software is installed in the opt nms vx directory This manual uses the string vx to refer to the default installation directory Dialogic 23 ...

Page 24: ... Supplements the Call Server configuration information in this manual Dialogic Vision Signaling Server Administration Manual Describes how to configure the Vision Signaling Server Supplements the Vision Signaling Server configuration information in this manual Dialogic Vision CCXML Developer s Manual Describes how to use the CCXML interface to configure and develop CCXML applications for the CX Vi...

Page 25: ...alues and the tool automatically modifies the configuration files for your model This section describes how to use the Vision Console to set up the gateway software It contains the following topics Gathering information Logging into the gateway for the first time Accessing the Vision Console Creating or revising a configuration Backing up a configuration Restoring a configuration Accessing the gat...

Page 26: ...formation Value Domain name for the CX Video Gateway node Primary and secondary DNS server IP address CX Video Gateway Ethernet 1 IP address subnet mask and default gateway CX Video Gateway Ethernet 2 IP address subnet mask and default gateway Media board 0 IP address subnet mask and default gateway Media board 1 IP address subnet mask and default gateway if present Optional IP address to use for ...

Page 27: ... video model gather the following ISUP configuration information MTP 1 information MTP 2 and MTP 3 information ISUP Information MTP 1 information Required information Value Number of E1s T1s required T1 ________ E1 ________ How E1s are being presented BNC Male 75 ohms RJ48 120 ohms RJ45 120 ohms Line coding AMI B8ZS T1 HDB3 E1 AMI_ZCS T1 AMI_BELL T1 AMI_DS T1 AMI_GTE T1 Dialogic 27 ...

Page 28: ...________ Trunk 7 ________ Trunk 8 ________ Signaling only trunks Trunk 9 ________ Trunk 10 ________ MTP 2 and MTP 3 information Required information Value PC format 3 8 3 14 bit 8 8 8 24 bit Other ________ Local point code Number of links SS7 variant Trunk number for link 1 Timeslot for link 1 Adjacent point code for link 1 Signaling link code SLC for link 1 Subservice field link for link 1 Trunk ...

Page 29: ...ation code CIC for each T1 E1 trunk Trunk direction for each T1 E1 trunk Subservice field ISUP variant Is inbound call required Is outbound call required Is transfer required If yes what type Range of numbers to use for the CX Video Gateway Signaling Server configuration information ISUP models The following information is required for ISUP models that have a Signaling Server Required information ...

Page 30: ...ons with multiple CG media boards Trunk 2 ________ Trunk 3 ________ Trunk 4 ________ CG media board 1 Trunk 1 ________ Trunk 2 ________ Trunk 3 ________ Trunk 4 ________ CG media board 2 Trunk 1 ________ Trunk 2 ________ Trunk 3 ________ Trunk 4 ________ Video Transcoder configuration information The following information is required for models that use video transcoding Required information Value...

Page 31: ...he following URL from an Internet Explorer or Mozilla browser on the Vision Console computer http 192 168 0 1 You can also enter this URL from the CX Video Gateway itself after connecting a mouse keyboard and monitor to the gateway 4 Log into the Vision Console using the following information User admin Password vision The Overview page appears 5 Click Host IP information in the Configuration menu...

Page 32: ...hub 4 Enter the following URL from an Internet Explorer or Mozilla browser on the Vision console computer http 192 168 0 1 You can also enter this URL from the CX Video Gateway after connecting a mouse keyboard and monitor to the gateway 5 Log into the Vision Console using the following information User admin Password vision The Overview page appears 6 Click Host IP information in the Configuratio...

Page 33: ...splays the Overview page which contains information about the servers media boards port rating software version installed patches and licensing information for the CX Video Gateway This page also shows whether conferencing is enabled The user names for the Vision Console have the following rights User Associated rights name root Super user that can change the CX Video Gateway model with assistance...

Page 34: ... Click Trunks on the Configuration menu and fill in the displayed field values Click Submit 6 Click PSTN on the Configuration menu and fill in the displayed field values Click Submit 7 Click Services on the Operations menu and then click Restart all Once the status of all gateway services is STARTED you can proceed 8 Configure gateway routes by adding routes to the gateway routing table For inform...

Page 35: ... media board configuration on page 112 All Add additional settings for trunks and routes in the telecom conf Fine tuning the file telecom configuration on Note You can also specify telecom conf settings in the Options page 116 page on the Configuration menu Add additional settings for SS7 signaling trunk in opt nmstx etc cx txcfg1 txt Add TX IP information required for SIGTRAN in opt nmstx etc cx ...

Page 36: ...ion Console on page 33 and log in as admin 2 Click Import Export on the Configuration menu The Import Export configuration page appears 3 Click Download The File Download window appears 4 Click Save locate the directory where you want to store the downloaded configuration and enter the file name in the File name field The configuration is downloaded to a zip file 5 Click Save The system backs up t...

Page 37: ...ssing the Vision Console on page 33 and log in as admin 2 Click Import Export in the Configuration menu The Import Export configuration page appears 3 Click Browse and locate the configuration you want to restore 4 Click Apply A confirmation message displays 5 Click OK The system restores the configuration 6 Click Refresh to display the Overview page 7 Click Services on the Operations menu and the...

Page 38: ...ke actions requested by Dialogic Services and Support you might need to use a secure shell ssh to log into the gateway To use ssh to log into the gateway follow these steps Step Action 1 Use an ssh client to establish a secure shell connection For example ssh root 192 168 0 1 Replace 192 168 0 1 with the IP address of your CX Video Gateway 2 When prompted enter the root password vision You now hav...

Page 39: ...ration SIP RTP parameters Mobile video parameters Trunks PSTN Signaling Server Options Port upgrade Video transcoder Import Export configuration Overview The Overview page displays information about the current CX Video Gateway configuration such as Model type and version Media board information Port rating Whether conferencing is enabled License information Dialogic 39 ...

Page 40: ...zone Example America Montreal Click the arrow in the drop down list to change the time zone Time Time Click the up or down arrow to change the hour or minutes NTP Network Time Protocol Use NTP to synchronize time and date across multiple servers Click the check box to enable Network Time Protocol If enabled the NTP Server 1 and NTP Server 2 parameters are displayed NTP Server 1 IP address of NTP S...

Page 41: ...rnet interface on the CX Video Gateway if DHCP is not enabled Eth0 Gateway IP address of the default gateway for the CX Video Gateway network card if DHCP is not enabled Status Indicates whether the second Ethernet interface on the CX Video Gateway is activated when the gateway starts up DHCP setting Indicates whether DHCP is enabled for the second Ethernet interface IP address IP address for the ...

Page 42: ...mode that is with no audio transcoding Global resources Implementations with Video Indicates whether video transcoder licensed video transcoding transcoding resources are available for the CX Video ports Gateway If enabled video transcoding is inserted in the video path if the CX Video Gateway finds incompatible video codec characteristics between call legs If disabled the call is dropped if the C...

Page 43: ...odec bandwidth control The format for this parameter is b modifier bandwidth value For more information on the format see RFC 4566 section 5 8 IP address IP address of media board 0 Subnet mask Subnet mask for media board 0 Board 0 All Gateway IP address of the router for media board 0 IP address IP address of media board 1 Subnet mask Subnet mask for media board 1 Board 1 Implementations where th...

Page 44: ...nabled on the Resource configuration page this parameter specifies the priority order in which 3G 324M video codecs are selected by the video transcoder In this case video codec selection on the 3G 324M side does not depend on results of negotiation from the IP side When video transcoding is disabled on the Resource configuration page the CX Video Gateway uses this setting in conjunction with the ...

Page 45: ... circuits are selected For a description of the valid values see Values for the PSTN routes group on page 45 Click Add to reserve another route circuit for outgoing PSTN calls Board 0 trunks All Trunk 1 Trunkn Indicates whether the specified trunk on Board 0 is enabled or disabled and specifies the PSTN route associated with the trunk Trunk 1 Trunkn Indicates whether the specified trunk on Board 1...

Page 46: ...ING Selects a circuit by rotating circuits in decreasing CCI order from the highest circuit CCI max down to the middle of the route CCI max 2 1 If no circuit is idle on the second half of the route a circuit on the first half of the route is selected With this circuit selection strategy a series of calls might be placed as follows 1 A first call is placed on the last circuit CCI max 2 A second cal...

Page 47: ... When all circuits have been used once they are selected by the inactivity timer PSTN The PSTN page contains additional configuration settings for the following CX Video Gateway models ISDN models ISUP models Access this page by clicking PSTN on the Configuration menu Additional settings for ISDN models The following settings apply to the ISDN audio and ISDN video models Group Parameter Descriptio...

Page 48: ...C Signaling servers Point code Point code for the signaling server or signaling server pair Specify the point code value as a decimal or hexadecimal number Edit Click Remove to remove the associated signaling server from the list Trunk T1 or E1 trunk handled by the previously defined signaling servers The values in this field vary depending on the number of boards and the trunk configuration Trunk...

Page 49: ...e TX board network interface used for redundancy TX Board Redundant IP information Mate IP address IP address of the other TX board used in the redundancy pair Node point code Point code for the signaling server or signaling server pair Specify the point code value as a decimal or hexadecimal number All ISUP Local routing context Used when transport is set to SIGTRAN ISUP MTP base configuration SS...

Page 50: ... the IPSP mode is single ended or double ended Indicates whether this peer signaling process can send and receive dynamic routing key management DRKM messages Dynamic routing key management Use network appearance Determines whether the optional network appearance parameter is included when communicating with the remote peer Peer signaling process ASP Indicates whether an ASP identifier is required...

Page 51: ...he range of this circuit group that are not controlled by ISUP Edit Removes the current circuit definition Trunk T1 or E1 trunk used for signaling The values in this field vary depending on the number of boards and the trunk configuration Implementations where transport is MTP Status If checked indicates that the MTP link is enabled DPC Destination point code associated with each route MTP links S...

Page 52: ...annels Number of full duplex video transcoder channels that are available for this system Usage warning High water mark for CPU usage in percentage If this threshold is reached the high water system issues an SNMP notification Usage warning Low water mark for CPU usage in percentage If this threshold is reached the low water system issues an SNMP notification to indicate that the CPU level has ret...

Page 53: ...es that have been started The advanced Services page provides more detail on each service This page contains the following parameters Each row in the table represents one service Field Description Service Name of the service name Status Indicates whether the service is started starting stopped or quiesced CX Video Gateway service only When the CX Video Gateway is starting stopped or quiesced it ca...

Page 54: ...following illustration shows the services hierarchy SNMP master agent SNMP RAID agent Board manager SNMP DS1 Agent H 100 clock manager Signaling Server ISUP models only Media boards Process Monitor CX Video Gateway Video Transcoder Note In ISUP models both the Signaling Server process and the media boards process must be started in order to start the CX Gateway process 54 Dialogic ...

Page 55: ...ice Log level CX Video Gateway log level Valid values are as follows in order of decreasing severity and increasing verbosity FATAL ERROR WARNING INFO1 INFO2 INFO3 INFO4 INFO5 Logging All settings Cache Click Cache to clear the application data cache for the associated service Current status Indicates whether the Signaling Server being managed is the primary or backup server Signaling ISUP Server ...

Page 56: ... 126 Video transcoder resource configuration The Video transcoder resource configuration page defines video transcoder resources for the CX Video Gateway for implementations with licensed video transcoding ports Access this page by clicking Video transcoder resources on the Provisioning menu To enable video transcoding see the Resource configuration page on the Configuration menu For more informat...

Page 57: ...eway Administration Manual Vision Console parameters Monitoring menu parameters The Monitoring menu contains the following pages Trunks page CCXML statistics Call Server status Signaling Monitor Video Transcoder status Dialogic 57 ...

Page 58: ...g displays this information when you hover over an unknown circuit in the trunk monitoring chart Information about blocked circuits if any The Vision Console displays this information when you hover over a blocked circuit in the trunk monitoring chart Valid values local maintenance Circuit is locally blocked for maintenance Blocked remote maintenance Circuit is remotely blocked for maintenance loc...

Page 59: ...ersion Name and version of the CX Video Gateway with the process name in brackets Startup Time the process started in coordinated universal time UTC time Uptime Total time in days hours and minutes since process startup Channel Configured number of channels accepting calls available to place calls or both Licenses Available number of CX Video Gateway licenses CCXML Displays the following statistic...

Page 60: ...erver ID ID of the signaling server IP IP address for the signaling server Role Indicates whether the server acts in a primary or secondary role Location Indicates whether the server is local or remote Signaling server status Status Status of the signaling server Link index MTP link identifier Server ID ID of the signaling server owning this link Signaling links status Status MTP link status 60 Di...

Page 61: ...artup Time the video transcoder was last started in coordinated universal time time UTC Total time in days hours and minutes since the video transcoder was Uptime last started Maximum number of full duplex video transcoder channels that have been configured for use on this system Note The number of channels configured for use may be less than or Channels equal to the maximum allowed by the license...

Page 62: ......

Page 63: ...y to perform lookups manipulate digits and route calls in the following directions PSTN to PSTN PSTN to SIP SIP to PSTN SIP to SIP The gateway routing table does not have default routes After you configure the CX Video Gateway you must define default routes as described in this section In rare circumstances you might need routing functionality that goes beyond what the gateway routing table can pr...

Page 64: ...he called party on the incoming side of the CX Video Gateway From Regular expression for valid PSTN numbers or valid URIs that signify the calling party incoming on the incoming side of the CX Video Gateway Mode Routing mode for the routing rule entry Use the Route mode for routing regular calls and the Transfer mode for routing call transfers To outgoing Regular expression for valid PSTN numbers ...

Page 65: ...call is routed For transfer mode the pattern only needs to match on the transfer to address Because the routing engine starts the search at the top of the table the first rule in the table is the highest priority and the last rule is the lowest priority List matches for more specific patterns before matches for less specific patterns within a particular incoming call type tel or sip in the table E...

Page 66: ... routing table page appears 3 Click New The Edit Routing Entry page appears 4 Complete the fields on this page Enter regular expressions for the To incoming and From incoming fields Select a routing mode Route or Transfer Enter regular expressions for the To outgoing and From outgoing fields For implementations with licensed video transcoding ports in the Video transcoder field select whether vide...

Page 67: ...e until the route is in the correct position Deleting a routing rule To delete a routing rule follow these steps Step Action 1 Access the Vision Console as described in Accessing the Vision Console on page 33 2 Click Gateway routes in the Provisioning menu The Call routing table page appears 3 Click Remove next to the routing rule you want to delete A confirmation message appears 4 Click OK The Vi...

Page 68: ... in the called number 0123456789 It does not match anything in 123456 gateway dialogic com asterisk Matches the preceding character zero or more times For example the pattern d matches all of the digits in 5082711847 gateway dialogic com and also matches user gateway dialogic com although the matching substring in this case is empty plus Matches the preceding character one or more times For exampl...

Page 69: ...ial variables and tokens used for generating routing expressions in the To outgoing and From outgoing fields of the gateway routing table Pattern Usage tel Must prefix the expression Routes calls to the PSTN sip Must prefix the expression Routes calls to a SIP destination reject Valid for the To outgoing column only Rejects calls that match the routing rule n where n is a Inserts substrings into t...

Page 70: ...ier any outgoing or two way trunk can be used To route calls to a specific trunk group follow these steps Step Action 1 Create route definitions in the Vision Console by associating trunks with route identifiers and defining the circuit selection strategy for each trunk For information see Trunks on page 45 2 In the gateway routing table append the route number to the pattern in the To Outgoing fi...

Page 71: ...eway routes in the Provisioning menu The Call routing table page appears 4 Click New to create a new routing entry or click Edit to edit an existing routing rule The Edit Routing Entry page appears 5 In the To outgoing field enter the hint string clearchannel true Enter values for other fields on this page 6 Click Apply The Vision Console adds the new rule to the routing table If a syntax error oc...

Page 72: ......

Page 73: ...ng The following examples are shown PSTN to SIP pass through to a single SIP destination on page 74 Routing PSTN to SIP based on called number on page 75 Stripping unwanted leading digits in both directions on page 76 Converting PSTN numbers for country code on page 77 Extracting numbers from incoming SIP numbers on page 78 Transferring to PSTN and SIP destinations on page 79 Blacklisting a caller...

Page 74: ... and captures all digits at least 1 from PSTN calling called numbers inserts the digits into SIP From To headers 2 Matches a sip URI in From To headers captures all digits before and inserts the digits into PSTN calling called numbers Sample Input Output Incoming PSTN call rule 1 match Calling tel 8479258900 sip 8479258900 gateway Called tel 5082711000 sip 5082711000 hostname com Sample Input Outp...

Page 75: ...rver3 com sip 1 gateway The following rules are used in this example Rule Description 1 Matches a call from any PSTN calling number to 8479258900 and routes the call to service1 server1 com 2 Matches a call from any PSTN calling number to 5082711000 and routes the call to service2 server2 com 3 Matches a call from any PSTN calling number to any other number and routes the call to service3 server3 ...

Page 76: ...1 hostname com sip 1 gateway 2 sip d d 7 sip d d 7 Route tel 1 tel 1 The following rules are used in this example Rule Description 1 Matches any PSTN calling called numbers containing at least seven digits captures only the last seven digits to insert into SIP From To headers 2 Matches From To URI containing at least seven digits before captures only the last seven digits to insert into PSTN calli...

Page 77: ... hostname com sip 1847 1 gateway The following rules are used in this example Rule Description 1 Matches and captures any PSTN calling called numbers containing exactly eleven digits and insert the numbers into SIP From To headers 2 Matches and captures any PSTN calling called numbers containing exactly ten digits prefixes one 1 and inserts the resulting numbers into SIP From To headers 3 Matches ...

Page 78: ... sip d 7 Route tel 1847 1 tel 1847 1 The following rules are used in this example Rule Description 1 Matches and captures any SIP From To numbers containing exactly eleven digits and inserts the numbers into PSTN calling called numbers called numbers 2 Matches and captures any SIP From To numbers containing exactly ten digits prefixes one 1 and inserts the numbers into PSTN calling called numbers ...

Page 79: ... pstn rule must appear first in the table because the transfer to sip rule would otherwise match PSTN destinations as well ID To incoming From incoming Mode To outgoing From outgoing 1 sip d 10 3 6 1 sip d Transfer tel 1 tel 1 2 sip sip Transfer sip 1 sip 1 The following rules are used in this example Rule Description 1 Matches any sip URI with one or more digits and a destination IP address of th...

Page 80: ...rs through ID To incoming From incoming Mode To outgoing From outgoing 1 tel tel 8479258900 Route reject NA 2 tel d tel d Route sip 1 hostname com sip 1 gateway The following rules are used in this example Rule Description 1 Matches any call from 8479258900 and rejects it 2 Matches and captures all digits at least one from PSTN calling called numbers and inserts the digits into SIP From To headers...

Page 81: ... it is fully started Note Starting the Call Server service starts the gateway Stop Stops the associated service The service status changes to Stopped when the service is stopped If you click Stop for the Call Server service the gateway stops without completing the in process calls Quiesce Clicking Quiesce for the Call Server service forces the gateway to stop processing new calls but does not affe...

Page 82: ...tions on the Provisioning menu The CCXML application configuration page appears This page displays all customized routes routes that are not configured by the gateway routing table The Outbound routes column in the Custom applications group lists configured PSTN routes and their defined circuits as well as configured SIP routes The default outbound route is Route 0 0 which routes a call on the sam...

Page 83: ...Vision Console on page 33 2 Click Trunks in the Monitoring menu The Trunks page appears It displays an illustration of trunk and circuit states which shows The total number of circuits Whether a circuit is idle busy out of service or blocked Whether a trunk is in sync or in an alarm state If a trunk is in an alarm state the Trunks page shows the alarm Note Trunk states unavailable unequipped conge...

Page 84: ...opic describes Logging levels Logging defaults Changing the logging level Changing other logging defaults Log file format Logging levels The following table describes the logging levels in decreasing severity and increasing verbosity order Logging Description level FATAL Logs only critical errors ERROR Logs all errors WARNING Logs all errors and warnings INFO1 Logs information useful for first lev...

Page 85: ...ging other logging defaults The following table describes how to change the other logging defaults To change the Modify the Log file location LogDir setting in the callserver conf file Maximum number of log files in the specified SystemLogFileMaxNum setting in the callserver conf directory file Maximum size of the log file SystemLogFileMaxSize setting in the callserver conf file For more informati...

Page 86: ... UID Reserved for future use The UID is represented by a hyphen in the log file threadID Identifier associated with the thread that generated the message Use this field to track the progress of a single session or call when several requests are being processed simultaneously alarm Optional field that is included only when the log message refers to an alarm notification In this situation the field ...

Page 87: ...h calls to custom CCXML applications Calls that do not match a custom CCXML application are then handled by the gateway routing table This topic describes how to Add a CCXML application definition to the Vision Console Remove a CCXML application definition from the Vision Console Modify a CCXML application definition It also describes the pattern matching syntax used to match the dialed numbers of...

Page 88: ...characters and wildcards The gateway checks if the dialed number of an incoming call matches this If it finds a match the corresponding CCXML application is executed If the dialed number matches the number range of multiple applications the call is matched to the most specific number range For more information see CCXML application definition pattern matching syntax on page 91 Initial URI Initial ...

Page 89: ... routes for the calls that the CCXML application creates routes Separate each route with a comma PSTN routes For a PSTN route the syntax is route Route_Number Priority where Route_Number identifies a PSTN route as defined in the telecom conf file Priority specifies the priority level for load balancing over the telecom routes If Route_Number is set to 0 the route is chosen automatically according ...

Page 90: ...onfiguration page is displayed 3 Locate the row that contains the application you want to remove and click Remove A confirmation message appears 4 Click OK to remove the application Modifying a CCXML application definition To modify a CCXML application definition follow these steps Step Action 1 Access the Vision Console as described in Accessing the Vision Console on page 33 2 Click CCXML applica...

Page 91: ...ime or Preceding digit occurred zero or more times Preceding digit occurred one or more times The following table provides examples of destination patterns and how they are interpreted Pattern Translation 408555 408555 followed by one or more wildcard digits Indicates the string must contain at least 7 digits starting with 408555 408555 408555 followed by zero or more wildcard digits Indicates the...

Page 92: ...as a directory structure and name that uses the following format YYYY DD MM hour cdr The CDR file rolls over on the hour every hour using UTC time For example the CDR file called 2008 08 06 05 cdr is the file recorded at 5 am on the 8th of June 2008 CDR entry format The CX Video Gateway uses the following format for CDR entries name value name value with multiple name value pairs separated by comm...

Page 93: ...tination type Defaults to e64 or to a URI et Service end time in GMT format For example et 2007 11 08T08 00 58 345Z se Source type Defaults to e164 or can be a URI For example se e164 si Source information or ANI st Service start time in GMT format For example st 2007 11 08T08 00 51 355Z tc Termination code Valid values 1016 Normal call clearing 0017 Busy 0018 No answer 0038 Network out of order 0...

Page 94: ...logging Configuring a video transcoder system Follow these steps to configure each video transcoder system in your environment Step Action 1 Access the Vision Console for your video transcoder system 2 Click Video Transcoder on the Configuration menu and the Video Transcoder page is displayed with default values based on your license Modify the number of full duplex video transcoder channels that ...

Page 95: ...y the change 3 Click Services on the Operations menu On the Services page start or restart the Call Server service to apply the new configuration 4 Click Video transcoder resources on the Provisioning menu and the Video transcoder resource configuration page is displayed Specify the IP address of a video transcoder system to be attached to the CX Video Gateway and click Add video transcoder The IP...

Page 96: ... OK When Force is specified for the routing entry video transcoding is inserted in the video path regardless of the negotiated video codec on either side When Dynamic is specified for the routing entry video transcoding only applies to calls with different video codec characteristics such as a different codec or a different picture frame For more information on routing tables see Understanding the...

Page 97: ...r installation all logs are created in the logs directory If the video transcoder services are stopped and restarted logs 1 directory is created which stores past log files Current logging occurs in the logs directory The logs directory rollover value is 2 At any point there may be three logs directories logs logs 1 and logs 2 For example in a system that uses 60 video transcoder channels the maxi...

Page 98: ...Server Note The VCCV service requires Dialogic Vision VX Integrated Media Platform licenses The following topics provide more information about VCCV Call logic Using the service Adding the gateway ccxml application Enabling the Call Server for early media Creating a gateway routing table entry Examples for VCCV Call logic At a high level the call logic for Video Call Completion to Voice VCCV is as...

Page 99: ...he early media option you must create a gateway routing table entry that specifies VCCV For details see Creating a gateway routing table entry Adding the gateway ccxml application The VCCV application logic is integrated in the default gateway ccxml script If it is not already listed add the gateway ccxml application in the Vision Console as a gateway application For step by step instructions see ...

Page 100: ...ions in the From outgoing field Note that the Video transcoder field is not used and has no effect for VCCV 5 Click Apply The Vision Console adds the new rule to the routing table 6 If a syntax error occurs in the new routing rule the Vision Console displays an error message Correct the rule and click OK For more information about routing tables and expressions see Understanding the gateway routin...

Page 101: ...ip d Route sip 1 10 3 6 1 mode voice video_bg sip 1 http 127 0 0 1 9002 vxml examples helloworld media helloworld H263 3gp annc_out http 11127 0 0 1 9002 vxml examples helloworld media helloworld wav Example 3 Use a combination of system default file and user defined media file The following routing table entry uses the default audio announcement and a user defined video background file from the o...

Page 102: ...o helps to conserve video transcoder resources To support this use case the media server application must specify a sendonly in SDP media lines and must comply with RFC 3264 An Offer Answer Model with SDP The CX Video Gateway must be in receive only mode On the VX Integrated Media Platform you must also set these two parameters in the vxmlinterpreter conf file to sendonly com vision miosip media V...

Page 103: ... Video Gateway The following illustration shows how the CX Video Gateway routes SIP calls through a SIP proxy to an application server In this example the gateway also routes SIP calls directly to the VX Integrated Media Platform using RTP RTP SIP SIP SIP Proxy SIP Location service VX Integrated Media Platform SIP application server SIP proxy CX Video Gateway The following topics describe the CX V...

Page 104: ...89 RTP RTCP RFC 1890 RTP profiles RFC 2833 RTP payload for DTMF digits RFC 4040 RTP payload format for a 64 kbit s transparent call The SIP interface supports the following audio video codecs AMR RFC 3267 AMR IF2 Comfort noise payload type 13 G 711 A law payload type 8 G 711 mu law payload type 0 G 723 payload type 4 G 279 payload type 18 H 263 payload type 34 RFC 2190 H 263 RFC 2429 H 264 RFC 398...

Page 105: ...ion 200 OK Success 480 Temporarily Unavailable Call not authorized 503 Service Unavailable No channels available to take call By default the CX Video Gateway handles incoming DTMF content in the following manner If RFC 2833 is negotiated then the gateway obtains the DTMF tone and duration through an RFC 2833 DTMF event If RFC 2833 is not negotiated then the gateway obtains the DTMF tone and durati...

Page 106: ... call is established through a SIP INVITE The following table lists the possible responses to the INVITE Response Description 100 Trying Provisional response 180 Ringing Provisional response starts the connecttimeout timer 200 OK Success 404 Not Found Bad destination 408 Request Timeout No answer 486 Busy Here Engaged 500 Server Internal Error Fail 106 Dialogic ...

Page 107: ...y 23 Redirection to new destination 410 Gone 26 Non selected user clearing 404 Not found 27 Destination out of order 502 Bad gateway 28 Address incomplete 484 Address incomplete 29 Facility rejected 510 Not implemented 31 Normal unspecified 480 Temporarily unavailable or Resource unavailable 34 No circuit available 503 Service unavailable 38 Network out of order 503 Service unavailable 41 Temporar...

Page 108: ...age 87 User not member of CUG 403 Forbidden 88 Incompatible destination 503 Service unavailable 102 Call setup time out failure 504 Gateway timeout 111 Protocol error unspecified 500 Server internal error 127 Interworking unspecified 500 Server internal error Other 500 Server internal error default 108 Dialogic ...

Page 109: ...Request Entity too long 127 Interworking 414 Request URI too long 127 Interworking 415 Unsupported media type 79 Service option not implemented 416 Unsupported URI Scheme 127 Interworking 420 Bad extension 127 Interworking 421 Extension Required 127 Interworking 423 Interval Too Brief 127 Interworking 480 Temporarily unavailable 18 No user responding 481 Call Transaction Does not Exist 41 Temporar...

Page 110: ...alue 504 Server time out 102 Recovery on timer expiry 504 Version Not Supported 127 Interworking 513 Message Too Large 127 Interworking 600 Busy everywhere 17 User busy 603 Decline 21 Call rejected 604 Does not exist anywhere 1 Unallocated number 606 Not acceptable by Warning header 110 Dialogic ...

Page 111: ... tune the configuration by editing configuration files This topic describes how to fine tune the following types of configuration information Media board Telecom including signaling and media capabilities H 100 clocking Gateway routing For information about using the Vision Console to configure the gateway see Overview of configuring the CX Video Gateway on page 25 Dialogic 111 ...

Page 112: ...ile to configure the media boards Keyword What to do IPC AddRoute 0 DestinationAddress Replace IP CG_0 with the IPv4 address for the media board Ethernet interface IPC AddRoute 0 Mask Replace SUBNET_MASK with the subnet mask for the IPv4 address specified in IPC AddRoute x DestinationAddress IPC AddRoute 0 Interface Specify 2 in place of 1 to associate Ethernet interface 2 with IPv4 connections Le...

Page 113: ... IPC AddRoute 0 Interface 1 IPC AddRoute 1 DestinationAddress 0 0 0 0 IPC AddRoute 1 Mask 0 0 0 0 IPC AddRoute 1 GatewayAddress GATEWAY_IP Clocking HBus ClockMode STANDALONE File opt nms vx callserver conf cg board 1 cfg Media board configuration files The media board configuration files board n cfg that ship with the CX Video Gateway differ depending on the gateway model type of trunks T1 or E1 a...

Page 114: ...lt AMI AMI_ZCS AMI_BELL AMI_DDS AMI_GTE NetworkInterface T1E1 0 3 FrameType For each trunk on the media board specify the T1 trunk framing format for the current trunk Valid values D4 ESF Default The following example shows the default settings in the media board files for the ISDN audio and ISDN video models Replace the bold default values if necessary NetworkInterface T1E1 0 7 Type T1 NetworkInt...

Page 115: ...use 75 ohm lines For more information see the Dialogic CG 6565 Media Board Installation and Developer s Manual NetworkInterface T1E1 0 3 LineCode For each trunk on the media board optionally specify the ones density maintenance method used on the trunk line to maintain a clear channel transmission Valid values AMI HDB3 Default The following example shows the settings in a board n cfg file for the ...

Page 116: ...formation for each route including the route identifier logical identifiers for associated trunks and route selection strategy For more information see Route settings on page 118 DTMF Determines whether the gateway can Accept an incoming SIP INFO message with DTMF content Detect in band DTMF in 3G 324M communications Send an outbound DTMF You can also specify the length of DTMF events that the gat...

Page 117: ...runk Valid values 0 15 trunk_type Optional Type of trunk Valid values E1 30 media channels T1 23 media channels E1RAW 31 media channels T1RAW 24 media channels Default E1 isdn_equipment ISDN models only Type of equipment connected to the trunk Valid values NT Network equipment TE Terminal equipment Default TE r ISUP models only Reserved channel channel_reserved Use the r switch to declare a voice ...

Page 118: ...identifiers refer to trunks previously declared with the Trunk keyword Valid values 0 15 The circuit_list and trunk_num parameters are mutually exclusive select_strategy Optional Defines the route circuits reserved for outgoing calls and specifies how the circuits are selected Valid values FROM_TOP default FROM_BOTTOM DESCENDING ASCENDING TIMER For more information see Values for the PSTN routes g...

Page 119: ...ile video calls Valid values 0 Gateway does not detect in band DTMF in mobile video calls 1 Gateway detects in band DTMF when audio transcoding is required 2 Gateway always detects in band DTMF This forces audio transcoding even if the audio codecs on both call legs are the same Default 1 This setting is useful for supporting handsets that do not support User Input Indication UII Note Detecting in...

Page 120: ...C 2833 If the other party does not support RFC 2833 the gateway sends the DTMF in a SIP INFO message Default 0 Setting for ISDN models For the ISDN audio or ISDN video model the default ISDN type for the ISDN_board keyword is ETSI for ETSI ISDN Replace this value with any of the following values if necessary ATT_4ESS AT T 4ESS ATT_5E10 AT T 5ESS10 AUSTEL_1 Australian Telecom 1 ECMA_QSIG ECMA 143 Q...

Page 121: ... T1 BICC 1 2000 to T1 BICC 7 2000 ETSIV2 ETSI v2 ETS 300 356 ETSIV3 ETSI v3 ETS 300 356 1 1998 ITU97 ITU T 1997 ITUBICC ITU T BICC Q 1901 Q 1902 6 ITUBLUE ITU T Blue Book ITUWHITE ITU T White Book JTTC JTTC Japan TTC JNTT JNTT Japan NTT Q767 ITU T Q 767 signaling_and_bearer_type Signaling and bearer type that the signaling server uses Valid values are ISUP ISUP BICC IP BICC with IP bearer channels...

Page 122: ...SUP network This value should be the same as the value for SS7_node_pc in the Overall MTP parameters section of the MTP3cp1 cfg file and the General configuration section of the ISUPcp1 cfg file SS7_switch_type SS7 protocol variant Declare the same SS7 protocol variant in the isupcp1 cfg file and in the ss7load bat or ss7load file Valid values are ANS88 ANSI 88 ref T1 123 1988 ANS92 ANSI 92 ref T1...

Page 123: ...timing reference Falls back to NETREF Secondary Set on media board 2 and drives B_CLOCK master Uses the primary master as the first timing reference Falls back to the most reliable trunk on the given media board other than the one driving the primary master Note For servers with one media board there is no secondary master Signaling board Slave on A_CLOCK Falls back to B_CLOCK Note For servers wit...

Page 124: ...Element Description clockmanager Root element of the priorities xml configuration file clocksources Root element for all timing references This element is a child of the clockmanager element All elements besides clockmanager are children of the clocksources element log Log settings for the H 100 clock manager All attributes are optional Attribute Description basefilename Base file name of the log ...

Page 125: ...l oscillator OSC as the clock source Default None priority Reliability of the trunk specified in the trunk attribute Trunks with equivalent reliability can be given identical priority numbers Valid values 0 best 99 worst Default None txboard ISUP models only Defines the signaling board in the system This element only applies when signaling is embedded in the voice trunks Attribute Description boar...

Page 126: ...application that uses the gateway routing table follow these steps Step Action 1 Copy the gateway ccxml application to use as an application template 2 Modify the logic of the new application as needed Define the new application to the Vision Console as described in Managing CCXML applications 3 on page 87 When you define the new application add it to the Gateway section of the CCXML Application C...

Page 127: ...pplication definition for a new custom application In this example calls whose dialed numbers match 222 use dialog server 127 0 0 1 5070 and are routed to route 2 Custom applications Number Range Initial URI Dialog Servers Outbound Routes 222 file opt nms vx callserver www 127 0 0 1 5070 0 route 2 0 ccxml customapp ccxml Dialogic 127 ...

Page 128: ......

Page 129: ...he callee and remains as a listener C Call Server Component of the Vision Server that manages call control and routing capabilities CallPlacer interface XML over HTTP mechanism for initiating outbound sessions or calls for VoiceXML applications CCXML Call Control Extensible Markup Language a W3C Working Draft standard language for providing telephony call control support for dialog systems gateway...

Page 130: ...ses video into lower bandwidth compared to H 263 and MPEG 4 H 264 is also called MPEG 4 Part 10 I INAP Intelligent Network Application Part an SS7 protocol that facilitates building platform independent transport independent and vendor independent applications Such applications include service switching points SSPs internet protocol IP applications service control points SCPs enhanced services pla...

Page 131: ... and TTS engines connected over an IP network MTP Message transfer part the SS7 protocol layers responsible for the reliable in sequence delivery of packets between two SS7 signaling points The MTP functions include message routing signaling link management signaling route management and congestion control MVIP 95 Device driver specification for H MVIP H 100 and H 110 telephony buses N NETANN Basi...

Page 132: ...t provides fast call setup using circuit switched connections and transaction capabilities for remote database interactions SSML Speech Synthesis Markup Language a proposed standard for enabling access to the internet using speech SSML provides a standard way to control various aspects of speech such as pronunciation volume pitch and rate over a variety of platforms SSML Processor Component of the...

Page 133: ...t converts written language to speech V Vision Console Web based configuration tool that configures the Vision Server VoiceXML Voice Extensible Markup Language a language that enables users to interact with the internet through voice recognition technology VoiceXML application configuration file A file that maps individual VoiceXML applications to number ranges that trigger the execution of those ...

Page 134: ......

Page 135: ...es 73 clear channel data 71 expressions 68 clearmode audio codec 71 routing to a trunk group 70 clocking 123 working with routing rules 66 components 11 gateway ccxml file 63 64 configuration files 111 gathering information 26 cg6565 board files 113 H oamsys cfg 112 123 H 100 clocking 123 priorities xml 124 host IP settings 41 telecom conf file 116 I Configuration menu parameters 39 image resizing...

Page 136: ...1 ISUP audio 16 16 SIP 103 ISUP video 16 17 inbound calls 105 MONA 13 incoming SIP numbers 78 Monitoring menu parameters 57 interoperability 104 MTP 22 ISUP to SIP cause value 107 N outbound calls 106 Net SNMP 13 SIP to ISUP cause value 109 O standards 22 112 oamsys cfg file SNMP 13 Operations menu parameters 53 software components 11 outbound calls 106 standards 22 Overview of creating routes 63 ...

Page 137: ... transcoder resources 94 Operations menu parameters 53 video transcoding 94 Provisioning menu parameters 56 video transrating 94 starting quiescing and stopping the gateway 81 Vision Console 25 viewing gateway information 82 accessing 33 W Configuration menu parameters 39 WNSRP 13 managing CCXML applications 87 Dialogic 137 ...

Reviews: