Cisco Carrier Sensitive Routing User Guide
Version
Cisco Systems, Inc 170 West Tasman Drive San Jose, CA
800 553-NETS Fax 408
Copyright 2002, Cisco Systems, Inc All rights reserved
Cisco Carrier Sensitive Routing User Guide
Prerequisites
Preface
Overview
Overview of Cisco Carrier Sensitive Routing
Database Tables
Saving Configuration Settings
Activating CSR
Adding, Modifying, and Removing Gatekeepers
Deleting Contact Lists
Resetting Call Accounting
Cleaning Test Results
Creating Contact Lists
Examples
Data Schema B-1
Configuration Data Schema
Logging A-1
Overview, page-vii Who Should Use This Guide, page-vii
Preface
Overview
Who Should Use This Guide
Document Conventions
Appendix B, “Data Schema”
Appendix C, “Error Conditions and Recoveries”
Document Organization
Documentation CD-ROM
Related Documentation and References
Obtaining Documentation
World Wide Web
Technical Assistance Center
Obtaining Technical Assistance
Documentation Feedback
Cisco.com
Cisco TAC Escalation Center
Cisco TAC Web Site
Cisco Carrier Sensitive Routing User Guide
Preface Obtaining Technical Assistance
Overview of Cisco Carrier Sensitive Routing
Prerequisites
Prerequisites, page CSR Components, page CSR Basics, page
CSR Limitations, page
CSR Basics
CSR Components
CSR Application
PostgreSQL Database
Selection Rules
CSR GUI
Ingress Rejection Rules
Egress Rejection Rules
CSR Limitations
Chapter1
CSR Limitations Carrier Sensitive Routing User Guide
Overview of Cisco Carrier Sensitive Routing
Database Operations, page Database Functionalities, page
PostgreSQL Database Operations and Functionalities
Database Operations
Activating the Database
etc/init.d/postgresinit restart
Exiting the Database
Reactivating the Database
etc/init.d/postgresinit stop
Backing Up the Database System
Exporting a Database
Reintializing a Database
Exporting to a Text File
Database Tables
Configuration Tables
Database Tables, page PostgreSQL Database Command Summary, page
Database Functionalities
Name
ActiveDataset
text
Default
ThreadCount
integer
Table2-1 Configuration Data Table continued
Allow
RejectSrcUnits
boolean
FALSE
Default
Table2-2 Gatekeeper Table continued
Table2-3 TestRoutes Table
Table2-4 TestOutputs Table
Table2-5 LogEntries Table
Table2-6 StringResources Table
Dataset Tables
2-10
Table2-7 Filters Table
2-11
Table2-8 Carriers Table
Table2-9 MatchPatterns Table
Table2-11 Rules Table
SelectPreferr edCarrier rule is used
2-12
Table2-10 Routes Table
Type
2-13
Default
Name
Name
2-14
Table2-14 ContactLists Table
Lists Table
2-15
Table2-13 Lists Table
Type
2-16
Default
Name
Table2-18 QoS Table
2-17
Table2-16 EgressRouteAttributes Table
Table2-17 QoS Table
2-18
PostgreSQL Database Command Summary
CSR as a Daemon
Cisco Carrier Sensitive Routing Application Operations
Activating CSR
Single Instance
CSR as a User Process
Multiple Instances
Deactivating CSR
Deactivating CSR
Step 4 Click Shutdown CSR
Figure3-2 CSR Window
Chapter3
Activating the GUI
Activating the GUI, page Configuring CSR with the GUI, page
CSR Commands, page Multiple GUI Operation, page
CSR GUI Functionalities
Adding, Modifying, and Removing Gatekeepers, page
Configuring CSR with the GUI
Changing Configuration Settings
Changing Configuration Settings, page
Cisco Carrier Sensitive Routing User Guide
Changing Log Levels
Figure4-2 Configuration Management Tab in CSR Window
Chapter4 CSR GUI Functionalities Configuring CSR with the GUI
Enabling Test Routes Accounting
Saving Configuration Settings
Changing App Priority
Changing Connection Port
Adding Gatekeepers
Adding, Modifying, and Removing Gatekeepers
Figure4-5 Registered Messages and Filters Checkbox
Figure4-8 Sample Filter Display
Chapter4 CSR GUI Functionalities Configuring CSR with the GUI
Step 9 Click a filter on the pop-up menu
Figure4-7 Filters Pop-up Menu
Figure4-9 Sample Filter Display
Figure4-10 Delete Filter Display
Step 12 Click Delete
Modifying Gatekeepers
4-10
Removing Gatekeepers
Figure4-13 Delete Gatekeeper Message
Setting Threads for Processing Calls and Call Queue Size
4-11
Figure4-14 Advanced Configuration Dialog Box
Updating Active Datasets
Swapping Datasets
4-12
4-13
Creating, Modifying, and Deleting Carriers
Creating Carriers
4-14
Figure4-17 Carrier Selection Box in Active Dataset
Modifying Carriers
4-15
Figure4-18 Dialog Box for New Carrier in Active Dataset
4-16
Deleting Carriers
Creating, Modifying, and Deleting Contacts
Creating Contacts
4-17
Figure4-22 Dialog Box for an Existing Contact in Active Dataset
Modifying Contacts
Deleting Contacts
4-18
Creating, Modifying, and Deleting Contact Lists
Creating Contact Lists
4-19
Modifying Contact Lists
4-20
Figure4-24 Dialog Box for an Existing Contact List in Active Dataset
4-21
Creating, Modifying, and Deleting Egress Route Attributes
Deleting Contact Lists
Creating Egress Route Attributes
The key shown on the screen is the primary key of this egress route attribute in the Egress Route Attributes table. When a new egress route attribute is being created, “%%%%” is displayed
4-22
Modifying Egress Route Attributes
4-23
hour0-23min 0-60sec
Cisco Carrier Sensitive Routing User Guide
4-24
Figure4-26 List of Egress Route Attribute Names in Active Dataset
Chapter4 CSR GUI Functionalities Updating Active Datasets
4-25
Deleting Egress Route Attributes
Creating, Modifying, and Deleting Ingress Route Attributes
Creating Ingress Route Attributes
4-26
a. If you select Daily, enter Start Time and End Time
4-27
Cisco Carrier Sensitive Routing User Guide
Modifying Ingress Route Attributes
4-28
Chapter4 CSR GUI Functionalities Updating Active Datasets
4-29
Deleting Ingress Route Attributes
Creating, Modifying, and Deleting Match Patterns
Creating Match Patterns
4-30
Figure4-31 Dialog Box for New Match Pattern in Active Dataset
Modifying Match Patterns
Deleting Match Patterns
4-31
Creating, Modifying, and Deleting Routes
Creating Routes
4-32
Modifying Routes
4-33
Figure4-33 QoS Relationships Dialog Box in Active Dataset
Deleting Routes
4-34
Figure4-34 Dialog Box for an Existing Route in Active Dataset
Creating, Modifying, and Deleting Rules
Creating Rules
4-35
A provisioned minimum QoS
4-36
4-37
Modifying Rules
Deleting Rules
4-38
Figure4-36 Dialog Box for Existing Rule in Active Dataset
Updating Inactive Datasets
Verifying Datasets
4-39
Destroying Inactive Datasets
4-40
Figure4-37 Inactive Dataset Tab in CSR Window
Activating Inactive Datasets
CSR Commands
Resetting Call Accounting, page Updating Gatekeepers, page
Cleaning Test Results, page
4-42
Sending Test Route Request Commands to an Active CSR Application
This entry is optional
4-43
Updating Logging Level
Loading the Active Dataset
4-44
4-45
Resetting Call Accounting
Cleaning Test Results
Updating Gatekeepers
Checking CSR Version
Multiple GUI Operation
4-46
Configuring Syslog
Configuring Syslog Viewing Logs
Logging
Examples
Viewing Logs
Sample logs
Cisco Carrier Sensitive Routing User Guide
AppendixA Logging Viewing Logs
Data Schema
Configuration Data Schema
Configuration Data Schema Dataset Schema
Page
Page
Page
Dataset Schema
Page
Page
Cisco Carrier Sensitive Routing User Guide
Page
CHECK RelativeQoS = 1 AND RelativeQoS =
B-10
B-11
B-12
B-13
B-14
AppendixB Data Schema Dataset Schema
Cisco Carrier Sensitive Routing User Guide
Error Conditions and Recoveries
Database Connectivity Loss
Database Connectivity Loss Gatekeeper Connectivity Loss
Gatekeeper Connectivity Loss
domain naming system
dialed number identification service
automatic number identification
admission request message
GL-4
resource availability indication message
registration request message
unregistration request message
IN-5
I N D E
IN-6