Dialogic Vision CX Video Administration Manual

Dialogic vision cx video gateway
Table of Contents

Advertisement

Quick Links

Dialogic® Vision™ CX Video
Gateway Administration Manual
December 2009
64-0403-02
www.dialogic.com

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the Vision CX Video and is the answer not in the manual?

Questions and answers

Summary of Contents for Dialogic Vision CX Video

  • Page 1 Dialogic® Vision™ CX Video Gateway Administration Manual December 2009 64-0403-02 www.dialogic.com...
  • Page 2 Cavendish Blvd., 5th Floor, Montreal, Quebec, Canada H4M 2V9. Any authorized use of Dialogic's trademarks will be subject to full respect of the trademark guidelines published by Dialogic from time to time and any use of Dialogic’s trademarks requires proper acknowledgement.
  • Page 3: Revision History

    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 5: Table Of Contents

    Creating or revising a configuration...............34 Additional configuration tasks..............35 Backing up a configuration................36 Restoring a configuration................37 Accessing the gateway using a secure shell ............38 Chapter 4: Vision™ Console parameters............39 Configuration menu parameters ..............39 Overview....................39 Date and Time ..................40 Host IP information..................41 Dialogic...
  • Page 6 Introduction Dialogic® Vision™ CX Video Gateway Administration Manual Resource configuration ................42 SIP/RTP parameters.................43 Mobile video parameters................44 Trunks ....................45 PSTN .....................47 Signaling Server..................49 Options ....................52 Port upgrade...................52 Video Transcoder..................52 Import/Export configuration ..............52 Operations menu parameters ...............53 Services ....................53 Maintenance ...................55 Provisioning menu parameters ..............56 Call routing table ..................56...
  • Page 7 Dialogic® Vision™ CX Video Gateway Administration Manual Introduction Viewing gateway route information ............82 Viewing CCXML statistics ................82 Viewing trunk and circuit status information ..........83 Setting up gateway logging .................84 Logging levels ..................84 Logging defaults..................85 Changing the logging level ................85 Changing other logging defaults ..............85 Log file format ..................85...
  • Page 8 Introduction Dialogic® 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 Dialogic...
  • Page 9: Chapter 1: Introduction

    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 the products, as well as the new terminology by which the products are now known.
  • Page 11: Chapter 2: Overview Of The Cx Video Gateway

    The gateway is installed as a daemon on Linux machines and is composed of the following components: Signaling protocols and models • Media capabilities • CCXML scripting engine • SNMP agent and sub-agents • Fast call setup • These components are based on specific hardware support, including media boards and signaling boards. Dialogic...
  • Page 12: Signaling Protocols And Models

    Overview of the CX Video Gateway Dialogic® Vision™ CX Video Gateway Administration Manual Signaling protocols and models The gateway can implement the following signaling protocols: 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 •...
  • Page 13: Media Capabilities

    You can also use CCXML applications to provide call routing and conferencing functionality. For more information, see Managing CCXML applications on page 87, Fine tuning gateway routing on page 126, and the Dialogic® Vision™ CCXML Developer's Manual. Dialogic...
  • Page 14: Snmp Agent And Subagents

    Net-SNMP as a master agent and the DS1, Call Server, and RAID subagents. The master agent supports SNMPv1, SNMPv2c, and SNMPv3. For more information, see the Dialogic® Vision™ SNMP Reference Manual. Fast call setup The CX Video Gateway supports the following techniques for speeding up 3G-324M call setup time: Packed H.245 messages, which groups independent H.245 messages together...
  • Page 15: Isdn Models

    Dialogic® Vision™ CX Video Gateway Administration Manual Overview of the CX Video Gateway ISDN models The CX Video Gateway is available with an ISDN audio model and an ISDN video model. ISDN audio model In the ISDN audio model, the gateway: Provides ISDN signaling.
  • Page 16: Isup Models

    Overview of the CX Video Gateway Dialogic® Vision™ CX Video Gateway Administration Manual ISUP models The CX Video Gateway is available with an ISUP audio model and an ISUP video model. Each of these models can be configured for scalability and redundant capability.
  • Page 17: Basic Isup Video Model

    Dialogic® Vision™ CX Video Gateway Administration Manual Overview of the CX Video Gateway Basic ISUP video model In the basic ISUP video model, the gateway: Provides ISUP signaling with 3G-324M. • Provides SIP signaling. • Provides the option to transcode between AMR and G.711.
  • Page 18: Isup Scalable Deployment Model

    Overview of the CX Video Gateway Dialogic® Vision™ CX Video Gateway Administration Manual ISUP scalable deployment model For scalability, multiple CX Video Gateways can be deployed where the ISUP termination on one gateway provides the signaling between the SS7 access network and each of the other gateways in the system.
  • Page 19: Isup Redundant Deployment Model

    Dialogic® Vision™ CX Video Gateway Administration Manual Overview of the CX Video Gateway ISUP redundant deployment model For a redundant and fault-tolerant system, two CX Video Gateways can be deployed to provide higher availability. The gateways share a single signaling point code and provide node-level redundancy.
  • Page 20: Models With Video Transcoders

    Overview of the CX Video Gateway Dialogic® Vision™ CX Video Gateway Administration Manual Models with Video Transcoders The CX Video Gateway includes options for video transcoders. A video transcoder can be deployed in several configurations based on application need as described in the following topics.
  • Page 21: Video Model With Multiple Video Transcoders

    Dialogic® Vision™ CX Video Gateway Administration Manual Overview of the CX Video Gateway Video model with multiple Video Transcoders For scalability in transcoding requirements, multiple video transcoder systems may be required to satisfy the needs of the application or the connectivity requirements of the target IP endpoints.
  • Page 22: Standards

    Overview of the CX Video Gateway Dialogic® Vision™ CX Video Gateway Administration Manual Standards The CX Video Gateway complies with and supports the following standards, depending on the model: Standard Version Model BICC ITU-T Q.1901, 2000 All ISUP models ITU-T Q.1902-6, 2001 ANSI T1.673-2002[R2007]...
  • Page 23: Document Conventions

    Dialogic® Vision™ CX Video Gateway Administration 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.
  • Page 24: Related Documentation

    Overview of the CX Video Gateway Dialogic® Vision™ CX Video Gateway Administration Manual Related documentation The following manuals provide information related to installing and configuring the CX Video Gateway: Document Description Installing the Dialogic® Vision™ Server Describes how to install and cable the Vision™ TIGI2U TIGI2U hardware.
  • Page 25: Chapter 3: Configuring The Cx Video Gateway

    Restoring a configuration • Accessing the gateway using a secure shell • Note: After you create the CX Video Gateway configuration, you can fine tune it if necessary. For information, see Overview of fine tuning the gateway configuration on page 111. Dialogic...
  • Page 26: Gathering Information

    Configuring the CX Video Gateway Dialogic® Vision™ CX Video Gateway Administration Manual Gathering information Before you configure the CX Video Gateway, have the following information available: Network configuration information (all models) • ISDN configuration information (ISDN models) • ISUP configuration information (ISUP models) •...
  • Page 27: Isup Configuration Information (Isup Models)

    Dialogic® Vision™ CX Video Gateway Administration Manual Configuring the CX Video Gateway ISUP configuration information (ISUP models) If you are using the basic ISUP audio or basic ISUP video model, gather the following ISUP configuration information: MTP 1 information •...
  • Page 28 Configuring the CX Video Gateway Dialogic® Vision™ CX Video Gateway Administration Manual Required information Value Frame type CEPT Label or identification used to physically identify each E1 Voice trunks (can also carry trunk signaling): Trunk 1: ________ Trunk 2: ________...
  • Page 29: Signaling Server Configuration Information (Isup Models)

    Dialogic® Vision™ CX Video Gateway Administration Manual Configuring the CX Video Gateway ISUP information Required information Value Origination point code Subservice field Destination point codes for circuits on each T1/E1 trunk Number of circuits used per trunk Circuit identification code (CIC) for each T1/E1 trunk...
  • Page 30: Video Transcoder Configuration Information

    Configuring the CX Video Gateway Dialogic® Vision™ CX Video Gateway Administration Manual Required information Value Signaling server variant (switch type) ANSI88 ANSI92 ANSI95 ANSIBICC ETSIV2 ETSIV3 ITU97 ITUBICC ITUBLUE ITUWHITE JNTT Q767 Name of the signaling server associated with each trunk.
  • Page 31: Logging Into The Gateway For The First Time

    Dialogic® Vision™ CX Video Gateway Administration Manual Configuring the CX Video Gateway Logging into the gateway for the first time The information in this topic assumes you have installed and cabled the CX Video Gateway, as described in one of the relevant hardware installation manuals (see Related documentation).
  • Page 32: Obtaining An Ip Address Through Dhcp

    Configuring the CX Video Gateway Dialogic® Vision™ CX Video Gateway Administration Manual Obtaining an IP address through DHCP If you need to use DHCP for the gateway IP address, follow these steps: Step Action Set up the DHCP server so the hostname and IP address assigned to the CX Video Gateway is predetermined, for example, based on the gateway's MAC address.
  • Page 33: Accessing The Vision Console

    User Associated rights name root Super-user that can change the CX Video Gateway model with assistance from Dialogic Services and Support. Note: Appropriate licenses are required to change the gateway model. admin Administrator. This user can do everything an end user can do. In addition, this user can change all CX Video Gateway configuration and provisioning settings, and can perform a port capacity upgrade.
  • Page 34: Creating Or Revising A Configuration

    Configuring the CX Video Gateway Dialogic® Vision™ CX Video Gateway Administration Manual Creating or revising a configuration This topic describes how to create or revise a configuration using the Vision™ Console. For information about configuration parameters, see the Vision™ Console parameters section.
  • Page 35: Additional Configuration Tasks

    Dialogic® Vision™ CX Video Gateway Administration Manual Configuring the CX Video Gateway Additional configuration tasks The following table lists additional configuration tasks you may need to perform after using the Vision™ Console, depending on the configured environment: Models Configuration task For more information, see...
  • Page 36: Backing Up A Configuration

    Configuring the CX Video Gateway Dialogic® Vision™ CX Video Gateway Administration Manual Backing up a configuration To back up an existing CX Video Gateway configuration, follow these steps: Step Action Access the Vision™ Console as described in Accessing the Vision Console on page 33, and log in as admin.
  • Page 37: Restoring A Configuration

    Dialogic® Vision™ CX Video Gateway Administration Manual Configuring the CX Video Gateway Restoring a configuration To restore a CX Video Gateway configuration using the Vision™ Console, follow these steps: Step Action Access the Vision™ Console as described in Accessing the Vision Console on page 33, and log in as admin.
  • Page 38: Accessing The Gateway Using A Secure Shell

    The CX Video Gateway is normally managed through the Vision™ Console. However, in some situations (for example, to take actions requested by Dialogic Services and Support), you might need to use a secure shell (ssh) to log into the gateway.
  • Page 39: Chapter 4: Vision™ Console Parameters

    • 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...
  • Page 40: Date And Time

    Vision™ Console parameters Dialogic® Vision™ CX Video Gateway Administration Manual Date and Time The Date and Time page configures date and time settings for the CX Video Gateway. Access this page by clicking Date and Time on the Configuration menu.
  • Page 41: Host Ip Information

    Dialogic® Vision™ CX Video Gateway Administration Manual Vision™ Console parameters Host IP information The Host IP information page configures the IP network settings for the CX Video Gateway. Access this page by clicking Host IP information on the Configuration menu.
  • Page 42: Resource Configuration

    Indicates whether clear channel is enabled. Video models Mobile video Indicates whether 3G-324M is enabled. Implementations with Conferencing Indicates whether conferencing licensed conferencing ports functionality is enabled. Note: Do not use Advanced mode without contacting Dialogic Services and Support. Dialogic...
  • Page 43: Sip/Rtp Parameters

    Dialogic® Vision™ CX Video Gateway Administration Manual Vision™ Console parameters SIP/RTP parameters The SIP/RTP parameters page configures SIP-related settings. Access this page by clicking SIP/RTP on the Configuration menu. Group Associated Parameter Description implementations General Transport Defines whether outbound SIP calls are protocol sent using TCP or UDP.
  • Page 44: Mobile Video Parameters

    Vision™ Console parameters Dialogic® Vision™ CX Video Gateway Administration Manual Mobile video parameters The Mobile video parameters page configures 3G-324M parameters. Access this page by clicking 3G-324M on the Configuration menu. Parameter Description Priority 1 - Indicates the priority level of 3G-324M video codecs. Priority 1 is the highest priority.
  • Page 45: Trunks

    Dialogic® Vision™ CX Video Gateway Administration Manual Vision™ Console parameters Trunks The Trunks page configures trunk settings and circuit groups. Access this page by clicking Trunks on the Configuration menu. Group Associated Parameter Description implementations Trunk Frame type Indicates frame type of T1 or E1.
  • Page 46 Vision™ Console parameters Dialogic® Vision™ CX Video Gateway Administration Manual The following table describes the valid values for each route in the PSTN routes group: Value Description FROM_TOP (Default) Selects the first idle circuit in decreasing CCI order. This strategy always selects the highest available circuit.
  • Page 47: Pstn

    Dialogic® Vision™ CX Video Gateway Administration Manual Vision™ Console parameters Value Description TIMER The selected circuit is the one on which the inactivity timer is the most important. At the beginning, all circuits have the same inactivity timer. The circuits are selected in decreasing CCI order, starting from CCI max down to 1.
  • Page 48 Vision™ Console parameters Dialogic® Vision™ CX Video Gateway Administration Manual Additional settings for ISUP models The following settings apply to the ISUP audio and ISUP video models: Group Parameter Description Signaling server ID. Redundant If checked, the signaling server is part of a redundant pair.
  • Page 49: Signaling Server

    Dialogic® Vision™ CX Video Gateway Administration Manual Vision™ Console parameters Signaling Server The Signaling Server page contains additional configuration information for ISUP models. The information on this page varies with the configuration, such as redundant pair configuration, and MTP or SIGTRAN transport protocol. Access this page by clicking Signaling Server on the Configuration menu.
  • Page 50 Vision™ Console parameters Dialogic® Vision™ CX Video Gateway Administration Manual Group Associated Parameter Description implementations Network Values are determined and appearance configured by network operators on code each side of an association. Service variant Protocol variant of the M3UA service user.
  • Page 51 Dialogic® Vision™ CX Video Gateway Administration Manual Vision™ Console parameters Group Associated Parameter Description implementations Add new DPC Enter the destination point code for another circuit, and click Add New DPC to add another destination point code to the list.
  • Page 52: Options

    Vision™ Console parameters Dialogic® Vision™ CX Video Gateway Administration Manual For more information, see ISUP models on page 16. Options The Options page contains global and advanced settings. Access this page by clicking Options on the Configuration menu. Group Parameter...
  • Page 53: Operations Menu Parameters

    Dialogic® Vision™ CX Video Gateway Administration Manual Vision™ Console parameters Operations menu parameters The Operations menu contains the following pages: Services • Maintenance • Services Use the Services page to start or stop CX Video Gateway services, quiesce the CX Video Gateway, and set up services to start up automatically when the CX Video Gateway starts up.
  • Page 54 Vision™ Console parameters Dialogic® Vision™ CX Video Gateway Administration Manual Starting some CX Video Gateway services automatically causes other gateway services to start up. The following illustration shows the services hierarchy. Process Monitor SNMP master Video agent Transcoder SNMP RAID...
  • Page 55: Maintenance

    Dialogic® Vision™ CX Video Gateway Administration Manual Vision™ Console parameters Maintenance Use the Maintenance page to change the gateway log level, clear the application data cache, deploy licenses, and install patches. For the ISUP model with a Signaling Server, the page also shows the redundancy status of the Signaling Server. Access this page by clicking Maintenance on the Operations menu.
  • Page 56: Provisioning Menu Parameters

    Vision™ Console parameters Dialogic® Vision™ CX Video Gateway Administration Manual Provisioning menu parameters The Provisioning menu contains the following pages: Call routing table • CCXML application configuration • Video transcoder resource configuration • Call routing table The Call routing table page defines routes for the CX Video Gateway using the gateway routing table.
  • Page 57: Monitoring Menu Parameters

    Dialogic® Vision™ CX Video Gateway 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...
  • Page 58: Trunks Page

    Vision™ Console parameters Dialogic® Vision™ CX Video Gateway Administration Manual Trunks page The Trunks page displays a trunk monitoring chart. Access this page by clicking Trunks on the Monitoring menu. Field Description Circuits Total number of configured circuits. Information about circuit states.
  • Page 59: Call Server Status

    Dialogic® Vision™ CX Video Gateway Administration Manual Vision™ Console parameters Call Server status The Call Server status page displays status information for the gateway process (callserver) in the following information groups: Group Description Server Contains the following fields: information Field...
  • Page 60: Signaling Monitor

    Vision™ Console parameters Dialogic® Vision™ CX Video Gateway Administration Manual Signaling Monitor The Signaling Monitor page displays status information for the Signaling Server. Group Field Description Server ID ID of the signaling server. IP address for the signaling server. Signaling server status Role Indicates whether the server acts in a primary or secondary role.
  • Page 61: Video Transcoder Status

    Dialogic® Vision™ CX Video Gateway Administration Manual Vision™ Console parameters Video Transcoder status The Video Transcoder status page displays status information for the video transcoder. Group Field Description Server Active Number of full-duplex video transcoder channels currently in use. information...
  • Page 63: Chapter 5: Creating Routes

    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 provide. For information, see Fine tuning gateway routing on page 126. Dialogic...
  • Page 64: Understanding The Gateway Routing Table

    Creating routes Dialogic® Vision™ CX Video Gateway Administration Manual Understanding the gateway routing table Entries in the gateway routing table include from (calling) and to (called) patterns that are matched against the calling party address and called party address received for an incoming call.
  • Page 65: Routing Table Rules

    Dialogic® Vision™ CX Video Gateway Administration Manual Creating routes Routing table rules The routing engine starts at the top of the routing table and searches for the first pattern to match both the calling/from and called/to patterns for the appropriate incoming call type.
  • Page 66: Using The Gateway Routing Table

    Creating routes Dialogic® Vision™ CX Video Gateway Administration Manual Using the gateway routing table The easiest way to define routing rules is to use the gateway routing table. This topic describes how to: Add a routing rule • Modify a routing rule •...
  • Page 67: Modifying A Routing Rule

    Dialogic® Vision™ CX Video Gateway Administration Manual Creating routes Modifying a routing rule To modify a routing rule, follow these steps: Step Action Access the Vision™ Console, as described in Accessing the Vision Console on page 33. Click Gateway routes in the Provisioning menu.
  • Page 68: Routing Table Expressions

    Matches any single digit, 0 through 9. Matches the preceding character exactly n times. For example, the pattern \d{7} matches the seven-digit telephone number in 1234567@gateway.dialogic.com and the first seven-digits in the called number 0123456789. It does not match anything in 123456@gateway.dialogic.com. * (asterisk) Matches the preceding character zero or more times.
  • Page 69: Pattern Generation Expressions

    2711847. Use multiple enclosed patterns to store multiple matching substrings in different variables. For example, the pattern sip:(.*)@(.*) matches sip: 5082711847@gateway.dialogic.com and sets the variables $1 = 5082711847 and $2 = gateway.dialogic.com. Letters, digits, Match what they represent. and other...
  • Page 70: Routing To A Specific Trunk Group

    Creating routes Dialogic® Vision™ CX Video Gateway Administration Manual Routing to a specific trunk group Each route in the routing table that terminates to the PSTN can be assigned a trunk group number to be used for the outgoing PSTN call. The gateway then chooses an available circuit (based on the configured circuit selection algorithm) in the specified trunk group to use for the resulting call.
  • Page 71: Routing Clear Channel Data

    Dialogic® Vision™ CX Video Gateway Administration Manual Creating routes Routing clear channel data CCXML applications can create an outgoing call using a clear channel media stream for both voice only and video calls. You can create a routing rule to specify that the outgoing SIP call should only supply the Clearmode audio codec in the SDP.
  • Page 73: Chapter 6: Gateway Routing Table Examples

    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 on page 80 • Dialogic...
  • Page 74: Pstn To Sip Pass-Through To A Single Sip Destination

    Gateway routing table examples Dialogic® Vision™ CX Video Gateway Administration Manual PSTN to SIP pass-through to a single SIP destination This example shows a straight pass-through between PSTN calling/called numbers and SIP To/From headers to a single SIP destination. To incoming...
  • Page 75: Routing Pstn To Sip Based On Called Number

    Dialogic® Vision™ CX Video Gateway Administration Manual Gateway routing table examples Routing PSTN to SIP based on called number The following example shows how to route PSTN calls to different SIP servers based on the called number: To incoming From incoming...
  • Page 76: Stripping Unwanted Leading Digits In Both Directions

    Gateway routing table examples Dialogic® Vision™ CX Video Gateway Administration Manual Stripping unwanted leading digits in both directions In this example, unwanted leading digits are stripped from numbers in both directions. You may occasionally need to strip digits from a number; for example, the trunk prefix, area code, and country code.
  • Page 77: Converting Pstn Numbers For Country Code

    Dialogic® Vision™ CX Video Gateway Administration Manual Gateway routing table examples Converting PSTN numbers for country code This example illustrates how incoming PSTN numbers are converted to full international (US eleven-digit) format. Eleven-digit numbers are passed through as is. •...
  • Page 78: Extracting Numbers From Incoming Sip Numbers

    Gateway routing table examples Dialogic® Vision™ CX Video Gateway Administration Manual Extracting numbers from incoming SIP numbers This example shows how to extract numbers from incoming SIP numbers and convert them, if necessary, to full international (US eleven-digit) format for outgoing PSTN calls: Eleven-digit numbers are passed through as is.
  • Page 79: Transferring To Pstn And Sip Destinations

    Dialogic® Vision™ CX Video Gateway Administration Manual Gateway routing table examples Transferring to PSTN and SIP destinations When a single gateway supports transfers to both PSTN and SIP destinations, the Refer-to destination pattern must be able to distinguish between the destinations.
  • Page 80: Blacklisting A Caller

    Gateway routing table examples Dialogic® Vision™ CX Video Gateway Administration Manual Blacklisting a caller This example shows how to blacklist a caller based on the calling number and how to let all other callers through. To incoming From incoming Mode...
  • Page 81: Chapter 7: Managing The Cx Video Gateway

    Click Restart all to stop and restart all gateway services. Note: Once the gateway is in production, you should stop the Call Server service only when you need to troubleshoot a call issue. Always quiesce this service before you stop it, so that existing calls are not disrupted. Dialogic...
  • Page 82: Viewing Gateway Information

    Managing the CX Video Gateway Dialogic® Vision™ CX Video Gateway Administration Manual Viewing gateway information Use the Vision™ Console to view the following types of gateway information: Route information • CCXML statistics • Trunk and circuit status information • Viewing gateway route information...
  • Page 83: Viewing Trunk And Circuit Status Information

    Dialogic® Vision™ CX Video Gateway Administration Manual Managing the CX Video Gateway Viewing trunk and circuit status information To view trunk and circuit status information, follow these steps: Step Action Access the Vision™ Console, as described in Accessing the Vision Console on page 33.
  • Page 84: Setting Up Gateway Logging

    Managing the CX Video Gateway Dialogic® Vision™ CX Video Gateway Administration Manual Setting up gateway logging The CX Video Gateway system log records information about events and alarms. The name format for the log is: callserver_creationdate_[index].log where: creationdate is the date the log file was created, formatted as local server •...
  • Page 85: Logging Defaults

    Maximum size of the log file SystemLogFileMaxSize setting in the callserver.conf file. For more information about the callserver.conf file, see the Dialogic® Vision™ Call Server Administration Manual. Log file format The format of each log message is: timestamp [severity] [origin:code] [UID:threadID] (alarm) [message] where timestamp is formatted in local server time by default.
  • Page 86 Managing the CX Video Gateway Dialogic® Vision™ CX Video Gateway Administration Manual The following table describes gateway log file fields: Field Description severity Level of the log message. Valid values in order of decreasing severity and increasing verbosity: • FATAL (a severe malfunction from which the gateway processor cannot recover) •...
  • Page 87: Managing Ccxml Applications

    Dialogic® Vision™ CX Video Gateway Administration Manual Managing the CX Video Gateway Managing CCXML applications Use the Vision™ Console to specify the following properties for individual CCXML applications, if the routing provided by the gateway call routing table does not provide the required flexibility: A number range that maps to the CCXML application.
  • Page 88 Managing the CX Video Gateway Dialogic® Vision™ CX Video Gateway Administration Manual Step Action To add a CCXML application as a gateway application, click New at the bottom of the Gateway section, and enter the following information: Field Description Number...
  • Page 89 Dialogic® Vision™ CX Video Gateway Administration Manual Managing the CX Video Gateway Step Action To add a CCXML application as a custom application, click New at the bottom of the Custom section, and enter the following information: Field Description Number...
  • Page 90: Removing A Ccxml Application Definition From The Vision Console

    Managing the CX Video Gateway Dialogic® Vision™ CX Video Gateway Administration Manual Step Action Click Apply. The Vision™ Console adds the new definition to the top of the definition list in the associated section (Custom or Gateway). Removing a CCXML application definition from the Vision Console To remove an application from the Vision™...
  • Page 91: Ccxml Application Definition Pattern Matching Syntax

    Dialogic® Vision™ CX Video Gateway Administration Manual Managing the CX Video Gateway CCXML application definition pattern matching syntax The following table describes the syntax used to specify patterns for matching the dialed number (DNIS) for inbound calls. This is based on standard regular expression syntax.
  • Page 92: Using Call Detail Records

    Dialogic® Vision™ CX Video Gateway Administration Manual Using call detail records You can configure the Vision CX Video Gateway to write call detail records (CDRs) when a CCXML session ends or the endpoint hangs up the phone. To do this, enable Billing on the Options page of the Configuration menu in the Vision™...
  • Page 93: Cdr Abbreviations

    Dialogic® Vision™ CX Video Gateway Administration Manual Managing the CX Video Gateway CDR abbreviations The following table describes the CDR abbreviations: Abbreviation Description Call duration Call identifier. Destination information or DNIS in one of the following formats: Full ITU-T Recommendation E.164 telephone number (11 numeric digits) •...
  • Page 94: Managing Video Transcoder Resources

    Managing the CX Video Gateway Dialogic® Vision™ CX Video Gateway Administration Manual Managing video transcoder resources Video transcoding is the process of converting video media from one video codec type to another (for example, from H.264 to H.263) between two endpoints to suit the requirements of the device at each endpoint.
  • Page 95: Defining Video Transcoder Resources For The Cx Video Gateway

    Dialogic® Vision™ CX Video Gateway Administration Manual Managing the CX Video Gateway Defining video transcoder resources for the CX Video Gateway This procedure applies to a CX Video Gateway that is mated with one or more video transcoder systems, which may be external or co-located.
  • Page 96: Specifying Video Transcoding In A Call Leg

    Video transcoder log files are created in the /opt/nms/video/logs directory on the video transcoder system. Note: Video transcoder log files are intended for use by Dialogic Services and Support. The default logging level is ERROR. The logging level is configurable on the Maintenance page, Operations menu of the Vision™...
  • Page 97 Dialogic® Vision™ CX Video Gateway Administration Manual Managing the CX Video Gateway • When an individual log file reaches this maximum size, it is rolled over and a new file is created. The maximum rollover files is five. At any point, there may be six files for each type of log file: one active log file and five rollover log files.
  • Page 98: Video Call Completion To Voice Service

    3G-324M negotiation starts after the address complete message (ACM) rather than the answer message (ANM) is received from the Call Server. Note: The VCCV service requires Dialogic® Vision™ VX Integrated Media Platform licenses. The following topics provide more information about VCCV: Call logic •...
  • Page 99: Using The Service

    Dialogic® Vision™ CX Video Gateway Administration Manual Managing the CX Video Gateway bridges the audio path between the two parties. No audio announcement is played to the called party. 6. A video background file is played to the calling party while the call is in progress.
  • Page 100: Creating A Gateway Routing Table Entry

    Managing the CX Video Gateway Dialogic® Vision™ CX Video Gateway Administration Manual Creating a gateway routing table entry To create a new gateway routing table entry for VCCV, follow these steps: Step Action Access the Vision™ Console, as described in Accessing the Vision Console on page 33.
  • Page 101: Examples For Vccv

    Dialogic® Vision™ CX Video Gateway Administration Manual Managing the CX Video Gateway Examples for VCCV The following examples illustrate routing table entries for VCCV. Example 1: Use system defaults The following routing table entry uses system default prompts. No user-defined media files are specified.
  • Page 102: Configuring Streaming-Only Media Server Applications

    Managing the CX Video Gateway Dialogic® Vision™ CX Video Gateway Administration Manual Configuring streaming-only media server applications In some use cases, you may want a media server to send high-quality 3G video through the CX Video Gateway to a 3G handset without receiving media in return.
  • Page 103: Chapter 8: Sip Interface

    The following topics describe the CX Video Gateway SIP interface: Interoperability • Inbound calls • • Outbound calls ISUP to SIP cause values • SIP to ISUP cause values • For more information, see the Dialogic® Vision™ Call Server Administration Manual. Dialogic...
  • Page 104: Interoperability

    SIP interface Dialogic® Vision™ CX Video Gateway Administration Manual Interoperability The CX Video Gateway SIP interface works with systems that comply with the following specifications: RFC 3261 (SIP core) • RFC 3263 (Locating SIP servers) • RFC 3264 (SDP Offer/Answer) •...
  • Page 105: Inbound Calls

    Dialogic® Vision™ CX Video Gateway Administration Manual SIP interface Inbound calls An inbound call (SIP to PSTN) is initiated through a SIP INVITE. The SDP Offer/Answer model (RFC 3264) is used for media negotiation. The INVITE usually contains the offer, and the 200 OK response contains the answer SDP.
  • Page 106: Outbound Calls

    SIP interface Dialogic® Vision™ CX Video Gateway Administration Manual Outbound calls An outbound call (PSTN to SIP) is placed in response to an incoming call. The SIP call is established through a SIP INVITE. The following table lists the possible responses...
  • Page 107: Isup To Sip Cause Values

    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...
  • Page 108 SIP interface Dialogic® Vision™ CX Video Gateway Administration Manual ISUP cause value SIP response Invalid message 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...
  • Page 109: Sip To Isup Cause Values

    Dialogic® Vision™ CX Video Gateway Administration Manual SIP interface SIP to ISUP cause values The following table shows the default SIP response to ISUP cause code. This mapping follows RFC 3398, ISUP to SIP Mapping. SIP response ISUP cause value...
  • Page 110 SIP interface Dialogic® Vision™ CX Video Gateway Administration Manual SIP response ISUP cause value 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...
  • Page 111: Chapter 9: Fine Tuning The Cx Video Gateway Configuration

    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...
  • Page 112: Fine Tuning The Media Board Configuration

    The setting names are the same, except that <IP_CG_1> indicates the IPv4 address of the second media board. The following example shows the settings in the oamsys.cfg file for a CX Video Gateway with two media boards: Dialogic...
  • Page 113: Media Board Configuration Files

    Dialogic® Vision™ CX Video Gateway Administration ManualFine tuning the CX Video Gateway configuration #------------------------------------------------------------------------------- # oamsys.cfg - VX 5000 #------------------------------------------------------------------------------- [board-0] Product = CG_6565_4 Number Slot IPC.AddRoute[0].DestinationAddress = <IP_CG_0> IPC.AddRoute[0].Mask = <SUBNET_MASK> IPC.AddRoute[0].Interface IPC.AddRoute[1].DestinationAddress = 0.0.0.0 IPC.AddRoute[1].Mask = 0.0.0.0 IPC.AddRoute[1].GatewayAddress = <GATEWAY_IP>...
  • Page 114 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 NetworkInterface.T1E1[0..7].Impedance = DSX1 NetworkInterface.T1E1[0..7].LineCode = B8ZS NetworkInterface.T1E1[0..7].FrameType = ESF NetworkInterface.T1E1[0..7].CRCMFMode = C44ON NetworkInterface.T1E1[0..7].SignalingType = PRI NetworkInterface.T1E1[0..7].D_Channel = ISDN MaxChannels = 512 Dialogic...
  • Page 115 Dialogic® Vision™ CX Video Gateway Administration ManualFine tuning the CX Video Gateway configuration Specifying E1 trunk settings Specify the following settings in the media board configuration file for a media board that uses E1 trunks: Keyword Setting NetworkInterface.T1E1[0..3].Impedance For each trunk on the media board, specify the type of cable connecting the board to the telephone network.
  • Page 116: Fine Tuning The Telecom Configuration

    You can also specify the length of DTMF events that the gateway generates. For more information, see DTMF settings on page 119. Note: The factory sets the parameters for the Media_board and Resources keywords. Do not change these settings without contacting Dialogic Services and Support. Trunk settings Use the Trunk keyword to specify the trunks that the media board uses.
  • Page 117 Dialogic® Vision™ CX Video Gateway Administration ManualFine tuning the CX Video Gateway configuration Parameter Description media_board_num Logical board index of the media board containing the trunk, referring to a board previously declared with the Media_board keyword. Valid values: 1 - 8.
  • Page 118: Route Settings

    Trunk 4 1 2 3 E1 TE # Route 1 contains trunk 2 - selection strategy = DESCENDING Route 1 2 DESCENDING # Route 2 contains trunks 1, 3 and 4 - default selection strategy Route 2 1 3 4 Dialogic...
  • Page 119: Dtmf Settings

    Dialogic® Vision™ CX Video Gateway Administration ManualFine tuning the CX Video Gateway configuration DTMF settings The following table describes the DTMF parameters that you can change if the defaults do not correctly describe your configuration: Parameter Description acceptInboundDTMFInSIPINFO Indicates whether the CX Video Gateway can accept an incoming SIP INFO message with DTMF content.
  • Page 120: Setting For Isdn Models

    KOREAN_OP = Korean operator • NI2 = US National ISDN 2 • NT_DMS = Northern Telecom DMS100 • NT_DMS250 = Northern Telecom DMS250 • NTT = Nippon Telegraph Telephone • TAIWAN_OP = Taiwanese operator • VN6 = France Telecom VN6 • Dialogic...
  • Page 121: Settings For The Isup Models With Vision™ Signaling Servers

    Dialogic® Vision™ CX Video Gateway Administration ManualFine tuning the CX Video Gateway configuration Settings for the ISUP models with Vision™ Signaling Servers Use the VS_isup_server keyword to specify information for ISUP models with Signaling Servers. Replace the parameters shown in the table with the appropriate values.
  • Page 122: Settings For Isup Models That Use Native Isup Signaling

    ETSIV3 = ETSI v3 (ETS 300 356-1 – 1998) • ITU97 = ITU-T 1997 • ITUBLUE = ITU-T Blue Book • ITUWHITE = ITU-T White Book • JTTC = JTTC (Japan TTC) • JNTT = JNTT (Japan NTT) • Q767= ITU-T Q.767 Dialogic...
  • Page 123: Fine Tuning The H.100 Clocking Configuration

    Dialogic® Vision™ CX Video Gateway Administration ManualFine tuning the CX Video Gateway configuration Fine tuning the H.100 clocking configuration The CX Video Gateway includes an H.100 clock manager that synchronizes the server's boards. By default, the H.100 clock manager starts automatically when the gateway starts up, if the gateway has more than one media board.
  • Page 124: H.100 Clock Manager Configuration File

    Maximum number of files in the H.100 clock manager log. When all files are full, the logging subsystem overwrites the contents of the first file. Valid values: 1 - n Default: 5 outputdir Output directory for the log files. Default: vx/clockmgr/logs Dialogic...
  • Page 125: Changing The Default H.100 Clocking Configuration

    Dialogic® Vision™ CX Video Gateway Administration ManualFine tuning the CX Video Gateway configuration Element Description <frequency> Wait timeout for events. If defined, the clocking service executes in polling mode. If not defined, the clocking service executes in asynchronous mode (recommended).
  • Page 126: Fine Tuning Gateway Routing

    The following example shows the application definition for a new gateway application. In this example, calls whose dialed numbers match 333 use the newgateway.ccxml application for routing. All other calls use gateway.ccxml. Both applications reference the gateway routing table. Gateway applications: Number Range Initial URI file:///opt/nms/vx/callserver/www/ccxml/newgateway.ccxml file:///opt/nms/vx/callserver/www/ccxml/gateway.ccxml Dialogic...
  • Page 127 Dialogic® Vision™ CX Video Gateway Administration ManualFine tuning the CX Video Gateway configuration The following example shows the application 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.
  • Page 129 A board that derives its clock signal from a bus cable; the clock signal is driven by the bus clock master. See also clock master. consultation transfer: A call transfer in which the Vision™ Server initiates a transfer between two parties, but does not stay attached to the call once it is Dialogic...
  • Page 130 Glossary Dialogic® Vision™ CX Video Gateway Administration Manual successfully established. The caller remains connected to the Vision™ Server if the transfer fails. DTMF: Dual tone multi frequency; an inband signaling system that uses two simultaneous voiceband tones for dialing. Also called touchtone. Some times DMTF is used to generally describe any telephony keypad press, even if tones are not generated.
  • Page 131 Physically, a list of variables. Logically, a table with rows of variables. MIOSIP: Implements the Media Resource Function of the Dialogic® Vision™ VX Integrated Media Platform. MIOSIP provides SIP call control, media processing over RTP, DTMF generation and recognition, and an MRCP client to automatic speech recognition (ASR) resources.
  • Page 132 (such as pronunciation, volume, pitch, and rate) over a variety of platforms. SSML Processor: Component of the Dialogic® Vision™ VX Integrated Media Platform that processes SSML requests for audio and text-to-speech. T.38 fax: A standard for real-time fax over IP that makes it possible for fax machines from different vendors to talk to each other over IP networks.
  • Page 133 VoiceXML application configuration file: A file that maps individual VoiceXML applications to number ranges that trigger the execution of those applications. VoiceXML Interpreter: Component of the Dialogic® Vision™ VX Integrated Media Platform that interprets VoiceXML dialogs. VoiceXML Subsystem: Component of the Dialogic® Vision™ VX Integrated Media Platform that provides media processing for VoiceXML applications.
  • Page 135 IP address 31 creating or revising a configuration ISDN 11 fine tuning routing 126 ISDN audio model 15 gathering information 26 ISDN video model 15 restoring a configuration 37 ISUP 11, 22 setting up autostart 34 ISUP audio model 16, 16 Dialogic...
  • Page 136 Index Dialogic® Vision™ CX Video Gateway Administration Manual ISUP cause value to SIP response 107 RFC 2833 22, 105 ISUP video model 16, 17 routes 63, 82, 126 routing table 64 Linux 11 adding a routing rule 66 logging 84...
  • Page 137 Dialogic® Vision™ CX Video Gateway Administration Manual Index Video Transcoder models 20 Monitoring menu parameters 57 video 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™...

Table of Contents