cc/td/doc/product/access/sc/r2
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Preface

Preface

Purpose

This guide provides instructions for operating the Cisco telephony controller software, including configuration, operation, and maintenance tasks. It also includes troubleshooting and technical support information.


Note This guide uses the terms telephony controller software or telephony controller application to mean the Cisco virtual switch controller software that runs in the UNIX environment on a host server. The terms telephony controller or telephony controller node refer to the combination of this software and the host server. The Cisco telephony controller software supports a variety of solutions, including the Cisco VSC2700 with the Catalyst 8500 series Multiservice Switch Routers solution and the Cisco SS7/CCS7 Dial Access solution. This guidepertains to single or failover configurations.

Before You Start

Cisco provides documentation for setting up your total telephony solution, as well as documents for setting up each element of your solution. Be sure to read the system solution document for your solution before using this guide. That document contains information on setting up your solution, as well pointers to documentation for system components, such as access servers, ATM switches, and server hardware.

For the Cisco VSC2700 virtual switch controller (VSC), see the Cisco VSC2700 Network Solution Integration Guidelines (78-6463-xx) that ship with your hardware and software.

For the Cisco SS7/CCS7 Dial Access solution (DAS), see the Cisco SS7/CCS7 Dial Access Solution System Integration Guidelines (78-6011-xx) that ships with your hardware and software.

In addition, this document refers you to other documents that contain instructions for configuring your telephony controller. You should have these documents available for reference when using this guide to configure and operate your system.

For the VSC, you need the following documents:

For the DAS, you need the following documents:

The most up-to-date versions of these documents are available on the Cisco web site at:

http://www.cisco.com/univercd/cc/td/doc/product/access/sc/index.htm

You can print documentation on this site by clicking the PDF icon on the upper right of each screen.

Audience

This guide is intended for two different audiences: the system administrator and the operator. The system administrator should have the following:

The operator should have the following:

Table 1 shows the tasks associated with each audience and which chapters in this document contain important information that each of these audiences will need to know.


Table 1: Audience, Tasks, and Relevant Chapters
Audience Tasks Chapters

System administrator

Configure and manage high-end host administrative functions, including:

  • Setting up and managing group and user IDs

  • Setting up and maintaining software library and file directories

  • Backing up system files

Configure other network components and connections, including:

  • SNMP

  • NTP

  • Peripheral equipment such as routers, A/B switches, ATM switches, and Network Access Servers (NASes)

"Overview of the Telephony Controller Software"

"Preparing Your Telephony Controller"

"Maintenance Procedures"

"UNIX System Operation"

"Reference Materials"

Operator

Configure telephony controller software

Operate and maintain software and components

  • signaling links

  • channels

Retrieve and clear alarms

Perform traces and other troubleshooting tasks

"Overview of the Telephony Controller Software"

"Preparing Your Telephony Controller"

"Operating Your Telephony Controller"

"Retrieving Call Detail Records and Network Measurements"

"Maintenance Procedures"

"Troubleshooting Your System"

"Configuration Data File Reference"

"MML Commands"

"Reference Materials"

Document Organization

Chapter or Appendix Title Description

Chapter 1

Overview of the Telephony Controller Software

Presents an overview of the telephony controller software, including supported telephony features, software architecture, and a brief description of software features.

Chapter 2

Preparing Your Telephony Controller

Contains steps that must be performed before you operate your signaling software. Also presents an overview of configuration, including procedures for configuring the software, Simple Network Management Protocol (SNMP), Network Time Protocol (NTP), and Network File Sharing (NFS).

Chapter 3

Operating Your Telephony Controller

Describes how to manage signaling node operations, including starting and stopping the application, running the process manager, stopping and starting the processes, retrieving the signal channel attributes, and changing the signal service state.

Chapter 4

Retrieving Call Detail Records and Network Measurements

Describes how to use the signaling software to retrieve network measurements and statistics, including call detail and measurement records.

Chapter 5

Maintenance Procedures

Contains information about maintaining your telephony controller software, including setting disk space use and backing up your system.

Chapter 6

Troubleshooting Your System

Discusses how to troubleshoot your system, including retrieving, acknowledging, and clearing alarms; retrieving system logs; and performing call traces. Also includes information on contacting Cisco's Technical Assistance Center (TAC) for software support.

Appendix A

Configuration Data File Reference

Describes the specifications, formats, and relationships for the data files associated with the telephony controller.

Appendix B

MML Commands

Provides an overview of MML, steps for using MML to query the system, and a list of MML command definitions.

Appendix C

UNIX System Operation

Lists basic UNIX commands to interface with the telephony controller software and provides a directory map of the software.

Appendix D

Reference Materials

Lists pointers to reference materials for Cisco's telephony controller solutions.

Conventions

Convention Meaning Example

Boldface

Commands and keywords you type literally as shown.

offset-list

Italics or

Angle brackets (<>)

Variables for which you supply values.

command type interface

You replace the variable with the type of interface.

In contexts that do not allow italics, such as online help, arguments are enclosed in angle brackets (< >).

Square brackets ([ ])

Optional elements.

command [term]

The term is optional (not required), but you can choose to enter it.

Vertical bars ( | )

Separated alternative elements.

command [ abc | def ]

You can choose either abc or def, or neither, but not both.

Braces ({ })

Required choices.

command { abc | def }

You must use either abc or def, but not both.

Braces and vertical bars within square brackets ([ { | } ])

A required choice within an optional element.

command [ abc { def | ghi } ]

You have three options:

nothing

abc def

abc ghi

Caret character (^)

Control key.

The key combinations ^D and Ctrl-D are equivalent. Both mean hold down the Control key while you press the D key. Keys are indicated in capital letters, but are not case sensitive.

A string

A nonquoted set of characters.

For example, when setting an SNMP community string to public, do not use quotation marks around the string, because the string will include the quotation marks.

System prompts

Denotes interactive sessions, indicates that the user enters commands at the prompt.

The system prompt indicates the current command mode. For example, the prompt Router (config) # indicates global configuration mode.

Screen font (in Courier type)

Terminal sessions and information the system displays.

Angle brackets (< >)

Nonprinting characters, such as passwords.

Exclamation points (!) at the beginning of a line

A comment line.

Comments are sometimes displayed by the Cisco IOS software.

Caution
Means be careful. In this situation, you might do something that could result in equipment damage or loss of data.

Note Means reader take note. Notes contain helpful suggestions or references to material not covered in this manual.

Table 2: Data Type Conventions
Data Type Definition Example

Integer

A series of decimal digits from the set of 0 through 9 that represents a positive integer. An integer may have one or more leading zero ("0") digits added to the left side to align the columns. Leading zeros are always valid as long as the number of digits is less than or equal to ten digits. Values of this type have a range of zero to 4294967295.

123
000123
4200000000

Signed integer

This data type has the same basic format as the integer but can be either positive or negative. When negative, it is preceded by the sign ("-") character. As with the integer data type, this can be up to 10 digits in length, not including the sign character. The value of this type has a range of -2147483647 to 2147483647.

123
-000123
-2100000000l

Hexadecimal

A series of sixteen-based digits from the set of 0-9, a-f, or A-F. The hexadecimal number may have one or more leading zero (0) digits added to the left side. For all hexadecimal values, the maximum size is 0xffffffff (8 hexadecimal digits).

1f3
01f3000

Text

A series of alphanumeric characters from the ASCII character set, where defined. Tab, space, and double quote (" " ) characters cannot be used. Text can be up to 255 characters; however, we recommend that you limit the characters to no more than 32, for readability.

EntityID
LineSES_Threshold999

String

A series of alphanumeric characters and white-space characters. A string is surrounded by double quotes on the left and right sides (" " ). Text can be up to 255 characters; however, it is recommended that you limit the characters to no more than 80, for readability.

"This is a 
descriptive string."

Note Hexadecimal and integer fields in files may have different widths (number of characters) for column alignment.

Primary Key

Every table in "Configuration Data File Reference" has one or more primary key fields. These fields are marked in the description with a "[Primary Key]" indicator. The Primary Key is the unique identifier of a record in the table.

Foreign Key

One or more fields in a table may have a foreign key entry. These fields are marked in the description with a "[Foreign Key]" indicator. The Foreign Key is the unique identifier of a record in another table. It is used to reference a record from one table in another table.

IP Address

This is the standard TCP/IP address expressed as four numbers, where each is between 0 and 255 and seperated by periods, such as 123.45.66.77.


Note All known exceptions to these conventions are explained in the specific format sections of this document.

Cisco Connection Online

Cisco Connection Online (CCO) is Cisco Systems' primary, real-time support channel. Maintenance customers and partners can self-register on CCO to obtain additional information and services.

Available 24 hours a day, 7 days a week, CCO provides a wealth of standard and value-added services to Cisco's customers and business partners. CCO services include product information, product documentation, software updates, release notes, technical tips, the Bug Navigator, configuration notes, brochures, descriptions of service offerings, and download access to public and authorized files.

CCO serves a wide variety of users through two interfaces that are updated and enhanced simultaneously: a character-based version and a multimedia version that resides on the World Wide Web (WWW). The character-based CCO supports Zmodem, Kermit, Xmodem, FTP, and Internet e-mail, and it is excellent for quick access to information over lower bandwidths. The WWW version of CCO provides richly formatted documents with photographs, figures, graphics, and video, as well as hyperlinks to related information.

You can access CCO in the following ways:

WWW:  http://www.cisco.com

WWW:  http://www-europe.cisco.com

WWW:  http://www-china.cisco.com

Telnet:  cco.cisco.com

Modem:  From North America, 408 526-8070; from Europe, 33 1 64 46 40 82. Use the following terminal settings: VT100 emulation; databits: 8; parity: none; stop bits: 1; and connection rates up to 28.8 kbps.

For a copy of CCO's Frequently Asked Questions (FAQ), contact cco-help@cisco.com. For additional information, contact cco-team@cisco.com.

If you are a network administrator and need personal technical assistance with a Cisco product that is under warranty or covered by a maintenance contract, contact Cisco's Technical Assistance Center (TAC) at 800 553-2447, 408 526-7209 (U.S.), or tac@cisco.com. To obtain general information about Cisco Systems, Cisco products, or upgrades, contact 800 553-6387, 408 526-7208 (U.S.), or cs-rep@cisco.com.

Cisco Documentation CD-ROM

Cisco documentation and additional literature are available in a CD-ROM package, that ships with your product. The Documentation CD-ROM, a member of the Cisco Connection Family, is updated monthly. Therefore, it might be more current than printed documentation. To order additional copies of the Documentation CD-ROM, contact your local sales representative or call customer service. The CD-ROM package is available as a single package or as an annual subscription. You can also access Cisco documentation on the World Wide Web at http://www.cisco.com, http://www-china.cisco.com, or http://www-europe.cisco.com.

Cisco Documentation Feedback

If you are reading Cisco product documentation on the World Wide Web, you can submit comments electronically. Click Feedback in the toolbar and select Documentation. After you complete the form, click Submit to send it to Cisco. We appreciate your comments.


hometocprevnextglossaryfeedbacksearchhelp
Posted: Fri Apr 30 15:37:18 PDT 1999
Copyright 1989-1999©Cisco Systems Inc.