Cisco PXM Version 1.1 User manual

Corporate Headquarters
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: [phone]
800 553-NETS (6387)
Fax: [phone]
Cisco Carrier Sensitive Routing User Guide
Version 1.1

THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL
STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT
WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.
THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT
SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE
OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.
The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB’s public
domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.
NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS” WITH
ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED ORIMPLIED, INCLUDING, WITHOUT
LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF
DEALING, USAGE, OR TRADE PRACTICE.
IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING,
WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO
OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
Cisco Carrier Sensitive Routing User Guide
Copyright © 2002, Cisco Systems, Inc.
All rights reserved.

iii
Cisco Carrier Sensitive Routing User Guide
CONTENTS
Preface vii
Overview vii
Who Should Use This Guide vii
Document Organization viii
Document Conventions viii
Related Documentation and References ix
Obtaining Documentation ix
World Wide Web ix
Documentation CD-ROM ix
Ordering Documentation ix
Documentation Feedback x
Obtaining Technical Assistance x
Cisco.com x
Technical Assistance Center x
Contacting TAC by Using the Cisco TAC Website xi
Contacting TAC by Telephone xi
CHAPTER 1Overview of Cisco Carrier Sensitive Routing 1-1
Prerequisites 1-1
CSR Components 1-2
CSR Basics 1-2
PostgreSQL Database 1-3
CSR Application 1-3
Ingress Rejection Rules 1-4
Egress Rejection Rules 1-4
Selection Rules 1-4
CSR GUI 1-4
CSR Limitations 1-5
CHAPTER 2PostgreSQL Database Operations and Functionalities 2-1
Database Operations 2-1
Activating the Database 2-1
Exiting the Database 2-2
Reactivating the Database 2-2

Contents
iv
Cisco Carrier Sensitive Routing User Guide
Exporting a Database 2-2
Reintializing a Database 2-3
Database Functionalities 2-3
Database Tables 2-4
Configuration Tables 2-4
Dataset Tables 2-10
PostgreSQL Database Command Summary 2-17
CHAPTER 3Cisco Carrier Sensitive Routing Application Operations 3-1
Activating CSR 3-1
Single Instance 3-1
CSR as a Daemon 3-1
CSR as a User Process 3-2
Multiple Instances 3-2
Deactivating CSR 3-3
CHAPTER 4CSR GUI Functionalities 4-1
Activating the GUI 4-1
Configuring CSR with the GUI 4-2
Changing Configuration Settings 4-2
Changing Log Levels 4-3
Changing App Priority 4-4
Changing Connection Port 4-4
Enabling Test Routes Accounting 4-4
Saving Configuration Settings 4-4
Adding, Modifying, and Removing Gatekeepers 4-5
Adding Gatekeepers 4-5
Modifying Gatekeepers 4-9
Removing Gatekeepers 4-10
Setting Threads for Processing Calls and Call Queue Size 4-11
Swapping Datasets 4-12
Updating Active Datasets 4-12
Creating, Modifying, and Deleting Carriers 4-13
Creating Carriers 4-14
Modifying Carriers 4-15
Deleting Carriers 4-16
Creating, Modifying, and Deleting Contacts 4-17
Creating Contacts 4-17
Modifying Contacts 4-18

Contents
v
Cisco Carrier Sensitive Routing User Guide
Deleting Contacts 4-18
Creating, Modifying, and Deleting Contact Lists 4-19
Creating Contact Lists 4-19
Modifying Contact Lists 4-20
Deleting Contact Lists 4-21
Creating, Modifying, and Deleting Egress Route Attributes 4-21
Creating Egress Route Attributes 4-21
Modifying Egress Route Attributes 4-23
Deleting Egress Route Attributes 4-25
Creating, Modifying, and Deleting Ingress Route Attributes 4-26
Creating Ingress Route Attributes 4-26
Modifying Ingress Route Attributes 4-28
Deleting Ingress Route Attributes 4-29
Creating, Modifying, and Deleting Match Patterns 4-30
Creating Match Patterns 4-30
Modifying Match Patterns 4-31
Deleting Match Patterns 4-31
Creating, Modifying, and Deleting Routes 4-32
Creating Routes 4-32
Modifying Routes 4-33
Deleting Routes 4-34
Creating, Modifying, and Deleting Rules 4-35
Creating Rules 4-35
Modifying Rules 4-37
Deleting Rules 4-38
Verifying Datasets 4-39
Updating Inactive Datasets 4-39
Destroying Inactive Datasets 4-40
Activating Inactive Datasets 4-41
CSR Commands 4-41
Sending Test Route Request Commands to an Active CSR Application 4-42
Updating Logging Level 4-44
Loading the Active Dataset 4-44
Resetting Call Accounting 4-45
Updating Gatekeepers 4-45
Cleaning Test Results 4-45
Checking CSR Version 4-46
Multiple GUI Operation 4-46

Contents
vi
Cisco Carrier Sensitive Routing User Guide
AP PEN DIX ALogging A-1
Configuring Syslog A-1
Examples A-2
Viewing Logs A-2
Sample logs A-3
AP PEN DIX BData Schema B-1
Configuration Data Schema B-1
Dataset Schema B-5
AP PEN DIX CError Conditions and Recoveries C-1
Database Connectivity Loss C-1
Gatekeeper Connectivity Loss C-2
GLOS SARY
IN DEX

vii
Cisco Carrier Sensitive Routing User Guide
Preface
This preface describes the objective, audience, organization, and conventions of the Cisco Carrier
Sensitive Routing User Guide.
It contains the following information:
•Overview, page-vii
•Who Should Use This Guide, page-vii
•Document Organization, page-viii
•Document Conventions, page-viii
•Related Documentation and References, page-ix
•Obtaining Documentation, page-ix
•Obtaining Technical Assistance, page-x
Overview
The CiscoCarrier Sensitive Routing User Guide provides information on operations and functionalities
of Carrier Sensitive Routing (CSR) application, its graphical user interface (GUI) and the databases
associated with it.
Who Should Use This Guide
Users of this guide should have knowledge of the following:
•UNIX operating system and commands
•SQL commands
•TCP/IP network that the CSR is connected to
•Sun/Solariscomputer system

viii
Cisco Carrier Sensitive Routing User Guide
Preface
Document Organization
Document Organization
This guide is organized as follows:
Document Conventions
Following are conventions that might be used in this document.
Chapter1, “Overview of Cisco Carrier Sensitive
Routing”Provides an overview of the postgreSQL database, CSR application, and CSR graphical
user interface (GUI).
Chapter2, “PostgreSQL Database Operations and
Functionalities”Describes the operations and functionalities of the postgreSQL database.
Chapter3, “Cisco Carrier Sensitive Routing
Application Operations”Describes the operations and functionalities of the CSR application.
Chapter4, “CSR GUI Functionalities”Describes the CSR graphical user interface
functionalities.
AppendixA, “Logging”Describes the configuration of syslog and viewing
logs.
AppendixB, “Data Schema”Describes the configuration data schema and
dataset schema.
AppendixC, “Error Conditions and Recoveries”Describes database and gatekeeper connectivity
loss.
Table1
Convention Description
boldface Commands and keywords are in bold face.
italic Arguments for which you supply values are in italic.
[] Keywords or arguments that appear within square brackets are optional.
{x|y|z}Alternative, mutually exclusive, keywords are grouped in braces and
separated by vertical bars.
^ orCtrl Represent the key labeled Control. For example, when you read^D or
Ctrl-D, you should hold down the Control key while you press the D key.
screen font Terminal sessions and information the system displays are in screen
font.
boldface screen font Information you must enter is in boldface screen font.
<> Nonprinting characters, such as passwords, appear in angled brackets.
[] Default responses to system prompts are in square brackets.

ix
Cisco Carrier Sensitive Routing User Guide
Preface Related Documentation and References
Related Documentation and References
•Carrier Sensitive Routing Installation Guide
For Sun/Solaris, Java, and postgreSQL database information, go to the following URLs:
•http://www.sun.com
•http://java.sun.com
•http://www.postgresql.org
Obtaining Documentation
These sections explain how to obtain documentation from Cisco Systems.
World Wide Web
You can access the most current Cisco documentation on the World Wide Web at this URL:
http://www.cisco.com
Translated documentation is available at this URL:
http://www.cisco.com/public/countries_languages.shtml
Documentation CD-ROM
Cisco documentation and additional literature are available in a Cisco Documentation CD-ROM
package, which is shipped with your product. The Documentation CD-ROM is updated monthly and may
be more current than printed documentation. The CD-ROM package is available as a single unit or
through an annual subscription.
Ordering Documentation
You can order Cisco documentation in these ways:
•Registered Cisco.com users (Cisco direct customers) can order Cisco product documentation from
the Networking Products MarketPlace:
http://www.cisco.com/cgi-bin/order/order_root.pl
•Registered Cisco.com users can order the Documentation CD-ROM through the online Subscription
Store:
http://www.cisco.com/go/subscription
•Nonregistered Cisco.com users can order documentation through a local account representative by
calling Cisco Systems Corporate Headquarters (California, U.S.A.) at 408526-7208 or, elsewhere
in North America, by calling 800553-NETS (6387).

x
Cisco Carrier Sensitive Routing User Guide
Preface
Obtaining Technical Assistance
DocumentationFeedback
You can submit comments electronically on Cisco.com. In the Cisco Documentation home page, click
the Fax or Email option in the “Leave Feedback” section at the bottom of the page.
You can e-mail your comments to [email protected].
You can submit your comments by mail by using the response card behind the front cover of your
document or by writing to the following address:
Cisco Systems
Attn: Document Resource Connection
170 West Tasman Drive
San Jose, CA 95134-9883
We appreciate your comments.
Obtaining Technical Assistance
Cisco provides Cisco.com as a starting point for all technical assistance. Customers and partners can
obtain online documentation, troubleshooting tips, and sample configurations from online tools by using
the Cisco Technical Assistance Center (TAC) Web Site. Cisco.com registered users have complete
access to the technical support resources on the Cisco TAC Web Site.
Cisco.com
Cisco.com is the foundation of a suite of interactive, networked services that provides immediate, open
access to Cisco information, networking solutions, services, programs, and resources at any time, from
anywhere in the world.
Cisco.com is a highly integrated Internet application and a powerful, easy-to-use tool that provides a
broad range of features and services to help you with these tasks:
•Streamline business processes and improve productivity
•Resolve technical issues with online support
•Download and test software packages
•Order Cisco learning materials and merchandise
•Register for online skill assessment, training, and certification programs
If you want to obtain customized information and service, you can self-register on Cisco.com. To access
Cisco.com, go to this URL:
http://www.cisco.com
Technical Assistance Center
The Cisco Technical Assistance Center (TAC) is available to all customers who need technical
assistance with a Cisco product, technology, or solution. Two levels of support are available: the Cisco
TAC WebSite and the Cisco TAC Escalation Center.