Cisco PXM Version 1.1 User Manual
  1. Manuals
  2. Brands
  3. Cisco Manuals
  4. Network Router
  5. PXM Version 1.1
  6. User manual
Cisco PXM Version 1.1 User Manual

Cisco PXM Version 1.1 User Manual

Cisco sensitive routing user guide
Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
Cisco Carrier Sensitive Routing User Guide
Version 1.1
Corporate Headquarters
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: 408 526-4000
800 553-NETS (6387)
Fax: 408 526-4100

Advertisement

Table of Contents
loading

Related Manuals for Cisco Cisco PXM Version 1.1

Summary of Contents for Cisco Cisco PXM Version 1.1

  • Page 1 Cisco Carrier Sensitive Routing User Guide Version 1.1 Corporate Headquarters Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 http://www.cisco.com Tel: 408 526-4000 800 553-NETS (6387) Fax: 408 526-4100...
  • Page 2 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.

  • Page 3: Table Of Contents

    Preface Overview Who Should Use This Guide Document Organization Document Conventions Related Documentation and References Obtaining Documentation World Wide Web Documentation CD-ROM Ordering Documentation Documentation Feedback Obtaining Technical Assistance Cisco.com Technical Assistance Center Contacting TAC by Using the Cisco TAC Website Contacting TAC by Telephone Overview of Cisco Carrier Sensitive Routing C H A P T E R...
  • Page 4 Contents Exporting a Database Reintializing a Database Database Functionalities Database Tables Configuration Tables Dataset Tables PostgreSQL Database Command Summary Cisco Carrier Sensitive Routing Application Operations C H A P T E R Activating CSR Single Instance CSR as a Daemon CSR as a User Process Multiple Instances Deactivating CSR...
  • Page 5 Deleting Contacts 4-18 Creating, Modifying, and Deleting Contact Lists Creating Contact Lists 4-19 Modifying Contact Lists 4-20 Deleting Contact Lists 4-21 Creating, Modifying, and Deleting Egress Route Attributes Creating Egress Route Attributes Modifying Egress Route Attributes Deleting Egress Route Attributes Creating, Modifying, and Deleting Ingress Route Attributes Creating Ingress Route Attributes Modifying Ingress Route Attributes...
  • Page 6 Contents Logging A P P E N D I X Configuring Syslog Examples Viewing Logs Sample logs Data Schema A P P E N D I X Configuration Data Schema Dataset Schema Error Conditions and Recoveries A P P E N D I X Database Connectivity Loss Gatekeeper Connectivity Loss G L O S S A R Y...

  • Page 7: Overview

    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 •...

  • Page 8: Document Organization

    Document Organization Document Organization This guide is organized as follows: Chapter1, “Overview of Cisco Carrier Sensitive Routing” Chapter2, “PostgreSQL Database Operations and Functionalities ” Chapter3, “Cisco Carrier Sensitive Routing Application Operations” Chapter4, “CSR GUI Functionalities” Appendix A, “Logging” Appendix B, “Data Schema ” Appendix C, “Error Conditions and Recoveries ”...

  • Page 9: Related Documentation And References

    • 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). Related Documentation and References Cisco Carrier Sensitive Routing User Guide...

  • Page 10: Documentation Feedback

    You can e-mail your comments to bug-doc@cisco.com. 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.
  • Page 11 Preface Cisco TAC inquiries are categorized according to the urgency of the issue: • Priority level 4 (P4)—You need information or assistance concerning Cisco product capabilities, product installation, or basic product configuration. • Priority level 3 (P3)—Your network performance is degraded. Network functionality is noticeably impaired, but most business operations continue.
  • Page 12 Preface Obtaining Technical Assistance Cisco Carrier Sensitive Routing User Guide...

  • Page 13: Overview Of Cisco Carrier Sensitive Routing

    Overview of Cisco Carrier Sensitive Routing The Cisco Carrier Sensitive Routing (CSR) application provides end users with the capability to manipulate the routing of calls from the gatekeeper based on the ingress carrier and the DNIS. The routing can be based on QoS along with many other attributes pertaining to a carrier. With CSR, you can provision data specific to carriers that pertain to your network to maximize cost, QoS, and carrier relations.

  • Page 14: C H A P T E R 1 Overview Of Cisco Carrier Sensitive Routing

    CSR Components CSR Components The three major components of CSR are as follows. • postgreSQL Database • CSR application • CSR GUI The CSR GUI and the CSR application are not directly connected. They are both connected to the database. Figure1-1 Figure1-1 CSR Components...

  • Page 15: Postgresql Database

    Chapter1 Overview of Cisco Carrier Sensitive Routing CSR evaluates the predetermined selection and rejection criteria as part of the source carrier and DNIS information to determine what routing information to return to the gatekeeper. Note CSR can operate with multiple gatekeepers. CSR passes through the ANI, but its work is not based on the ANI.

  • Page 16: Ingress Rejection Rules

    CSR Basics Ingress Rejection Rules • Reject Max Origination Percentage • Reject Max Ingress Units • Reject Max Ingress Units per Route Egress Rejection Rules • Reject Egress Cost Greater than Ingress • Reject Insufficient QoS • Reject Max Egress Units Exceeded •...

  • Page 17: Csr Limitations

    Chapter1 Overview of Cisco Carrier Sensitive Routing CSR Limitations • When two rules are available (a rule associated with the carrier and a rule associated with a route), the rule associated with the carrier is chosen first. If one of the rules (carrier’s rule) does not exist, the rule associated with a route is used.
  • Page 18 Chapter1 Overview of Cisco Carrier Sensitive Routing CSR Limitations Carrier Sensitive Routing User Guide...

  • Page 19: Postgresql Database Operations And Functionalities

    PostgreSQL Database Operations and Functionalities This chapter describes the operations and functionalities of the postgreSQL database and contains the following sections: • Database Operations, page 2-1 • Database Functionalities , page 2-3 The postgreSQL database is a relational database management system. A database in this management system stores entities such as carriers, rules, contacts, routes, and the relationships among the entities.

  • Page 20: C H A P T E R 2 Postgresql Database Operations And Functionalities

    Database Operations • -S—Tells the postmaster to run in silent mode. This is not recorded to a log file. • -i—Tells postmaster to allow network connections. If this is not set, the postmaster accepts connections only from the local host. Note This is needed for the GUI to connect to the database even when it is running on the same machine.

  • Page 21: Exporting A Database

    Chapter2 PostgreSQL Database Operations and Functionalities Exporting a Database To export a database to a text file or to back up the entire database system, perform the following steps: Exporting to a Text File Step 1 Export a database into a text file by entering the following command: pg_dump –x databasename >...

  • Page 22: Database Functionalities

    Database Functionalities Database Functionalities This section describes the following: • Database Tables, page 2-4 • PostgreSQL Database Command Summary , page 2-17 Database Tables This section describes database tables, constraints placed on each table, and relationships between tables. Note Advanced knowledge of SQL is required to access the database through SQL commands. Use the psql interface to access an SQL prompt.
  • Page 23 Chapter2 PostgreSQL Database Operations and Functionalities Table2-1 Configuration Data Table Name ActiveDataset LoggingLevel CSR_ID CSR_Version GKTMP_Version integer Priority ListenPort Allow Type Null Default Constraints text ‘_1’ Valid values: • • text ‘Error’ Valid values: • • • varchar(64) text integer >=1 integer >0 and <...
  • Page 24 Database Functionalities Table2-1 Configuration Data Table (continued) Name ThreadCount MaxSizeOfQueue integer TestRoutesAccou ntingEnabled RejectSrcCarrierI nactive RejectNullSrcCar rier RejectSrcCarrier Unknown RejectDestination Unknown RejectSrcPercent Cisco Carrier Sensitive Routing User Guide Chapter2 Allow Type Null Default Constraints integer 5000 boolean FALSE boolean FALSE boolean FALSE boolean...
  • Page 25 Chapter2 PostgreSQL Database Operations and Functionalities Table2-1 Configuration Data Table (continued) Name RejectSrcUnits RejectNoDstCarri Table2-2 Gatekeeper Table Name GKKey GKID GK_IP GK_Port ListenARQ ListenLRQ ListenIRR ListenDRQ ListenRRQ ListenURQ ListenLCF Allow Type Null Default Constraints boolean FALSE boolean FALSE Allow Type Null Default Constraints...
  • Page 26 Database Functionalities Table2-2 Gatekeeper Table (continued) Name ListenLRJ ListenRAI ListenBRQ ConnectionState Table2-3 TestRoutes Table Name TestKey TestTime TestDate DatasetID DNIS SrcCarrierID DstCarrierID RunMe HomeCarrierID ResultCode Cisco Carrier Sensitive Routing User Guide Chapter2 Allow Type Null Default Constraints boolean FALSE boolean FALSE boolean FALSE...
  • Page 27 Chapter2 PostgreSQL Database Operations and Functionalities Table2-4 TestOutputs Table Name TestKey SelectOrder DstCarrierID ListKey IsSelected Table2-5 LogEntries Table Name TestKey EntryOrder LogString Caution The following table should not be modified or deleted. It consists of error messages that are logged. The CSR application does not work without this table.

  • Page 28: Dataset Tables

    Database Functionalities Table2-7 Filters Table Name FilterKey GKID MsgType FilterType Value Dataset Tables The dataset tables use functionality that is specific to postgreSQL, that is, table inheritance. This allows a table to be created and other tables to be inherited from it. For example, you can create a Carriers Table and have tables Carriers_1 and Carriers_2 inherit from it.
  • Page 29 Chapter2 PostgreSQL Database Operations and Functionalities Table2-8 Carriers Table Name CarrierKey CarrierName CarrierType CarrierID MaxIngressUnits MaxEgressUnits RuleKey ListKey isActive Note Tables Carriers_1 and Carriers_2 can inherit from the Carriers table. Table2-9 MatchPatterns Table Name PatternKey Pattern RouteKey Allow Type Null Default integer varchar(64)
  • Page 30 Database Functionalities Note Tables MatchPatterns_1 and MatchPatterns_2 can inherit from this table. Table2-10 Routes Table Name RouteKey RouteName RuleKey Note Tables Routes_1 and Routes_2 can inherit from the Routes table. Table2-11 Rules Table Name RuleKey RuleName IsDefaultRule MinQoS PreferredCarrierKey Cisco Carrier Sensitive Routing User Guide 2-12 Chapter2 Allow...
  • Page 31 Chapter2 PostgreSQL Database Operations and Functionalities Table2-11 Rules Table (continued) Name RejectMaxOriginationPercentage boolean RejectMaxIngressUnits RejectMaxIngressUnitsPerRoute RejectEgressCostMoreThanIngre RejectInsufficientQoS RejectMaxEgressUnits RejectMaxEgressUnitsPerRoute PreventITSPtoITSP SelectMinCostPerEgressRoute SelectBestQoS SelectSameCarrier Allow Type Null Default Constraints FALSE boolean FALSE boolean FALSE boolean FALSE boolean FALSE boolean FALSE boolean FALSE boolean FALSE...
  • Page 32 Database Functionalities Table2-11 Rules Table (continued) Name SelectPreferredCarrier SelectPercentageEgress Note Tables Rules_1 and Rules_2 can inherit from the Rules table. Table2-12 Contacts Table Name ContactKey RASAddress AddressType Cost Priority Note Tables Contacts_1 and Contacts_2 can inherit from the Contacts table. Cisco Carrier Sensitive Routing User Guide 2-14 Chapter2...
  • Page 33 Chapter2 PostgreSQL Database Operations and Functionalities Lists Table Table2-13 Lists Table Name ListKey ListName Note Tables Lists_1 and Lists_2 can inherit from the Lists table. Table2-14 ContactLists Table Name ListKey ContactKey Note Tables ContactLists_1 and ContactLists_2 can inherit from this table. Table2-15 RouteAttributes Table Name AttributeKey...
  • Page 34 Database Functionalities Table2-15 RouteAttributes Table (continued) Name DaypartType WeekDay StartTime EndTime Cost MaxUnits MaxPercentage Note Tables IngressRouteAttributes_1 and IngressRouteAttributes _2 can inherit from the RouteAttributes table. Cisco Carrier Sensitive Routing User Guide 2-16 Chapter2 Allow Type Null Default Constraints text Valid values: •...
  • Page 35 Chapter2 PostgreSQL Database Operations and Functionalities Table2-16 EgressRouteAttributes Table Name ListKey Note EgressRouteAttributes_1 and EgressRouteAttributes_2 can inherit from the EgressRouteAttributes and RouteAttriubtes tables. Table2-17 QoS Table Name IngressCarrierKey EgressCarrierKey RouteKey RelativeQoS Note Tables QoS_1 and QoS_2 can inherit from this QoS table. Table2-18 QoS Table Name RouteKey...

  • Page 36: Postgresql Database Command Summary

    Database Functionalities Note Tables IngressRoutes_1, IngressRoutes_2, EgressRoutes_1, and EgressRoutes_2 can inherit from this QoS table. PostgreSQL Database Command Summary Following is a summary of frequently used postgreSQL commands. Refer to the online manual pages and help section for more information. •...

  • Page 37: Cisco Carrier Sensitive Routing Application Operations

    Cisco Carrier Sensitive Routing Application Operations This chapter describes the following Cisco Carrier Sensitive Routing application operations: • Activating CSR , page 3-1 • Deactivating CSR , page 3-3 Activating CSR This section provides instructions on running single and multiple instances of the CSR application. The CSR application typically is installed to run at one instance on a dedicated machine, although it can be run at multiple instances on the same machine.

  • Page 38: C H A P T E R 3 Cisco Carrier Sensitive Routing Application Operations

    Activating CSR CSR as a User Process While the CSR is running as a daemon, other instances may run as user processes. If all instances are connected to the same database at startup, startup errors can occur because the following processes are attempted by all instances: •...

  • Page 39: Deactivating Csr

    Chapter3 Cisco Carrier Sensitive Routing Application Operations Deactivating CSR To stop CSR, log in to the CSR GUI by performing the following steps: Step 1 At the system prompt, enter the following command: /usr/local/csr/gui/csrgui & The login dialog box in Figure3-1 Login Dialog Box Step 2...
  • Page 40 Deactivating CSR Figure3-2 CSR Window Step 3 Click the CSR Commands tab. Click Shutdown CSR . Step 4 This shuts down all CSRs connected to this database. All current calls are dropped, and connections to gatekeepers are terminated. Cisco Carrier Sensitive Routing User Guide Chapter3 Cisco Carrier Sensitive Routing Application Operations...

  • Page 41: Csr Gui Functionalities

    CSR GUI Functionalities This chapter describes CSR functionalities and commands, and contains the following sections: • Activating the GUI, page 4-1 • Configuring CSR with the GUI, page 4-2 • Updating Active Datasets, page 4-12 • Updating Inactive Datasets, page 4-39 •...

  • Page 42: Chapter4 Csr Gui Functionalitie

    Configuring CSR with the GUI Step 2 Enter the information in the Login dialog box as follows: Enter the user name. The range is 1 to 32 characters. Enter the password. The range is 1 to 32 characters. Enter the host name where the database is located. This can be a remote or local machine. The range is 1 to 32 characters.

  • Page 43: Changing Log Levels

    Chapter4 CSR GUI Functionalities Configuring CSR with the GUI Figure4-2 Configuration Management Tab in CSR Window Changing Log Levels To change the logging level for the messages to be logged to syslog, select from the Logging Level pull-down menu. The following menu appears (Figure4-3 “Logging Level Pull-down Menu ”): Cisco Carrier Sensitive Routing User Guide...

  • Page 44: Changing App Priority

    Configuring CSR with the GUI Figure4-3 Logging Level Pull-down Menu The available levels are as follows: • Error—Only messages containing severe errors are logged. Optimally, this level may not generate any error messages. • Information—Informational messages are generated and sent to syslog. A message at this level is likely to be generated for each route request.

  • Page 45: Adding, Modifying, And Removing Gatekeepers

    Chapter4 CSR GUI Functionalities Adding, Modifying, and Removing Gatekeepers To add, modify, and remove gatekeepers, log in to CSR and select the Configuration Management tab in the CSR window. Use the Current Gatekeepers area on the screen to add, modify, or remove gatekeepers. Adding Gatekeepers This section describes the steps to add a gatekeeper and its associated messages and filters.
  • Page 46 Configuring CSR with the GUI Step 2 nter the ID of the gatekeeper to be added. The range is 1 to 64 characters. Step 3 nter remote address (IP address) of the gatekeeper to be connected to. The format is x.x.x.x where x is a number from 0 to 255.
  • Page 47 Chapter4 CSR GUI Functionalities Figure4-7 Filters Pop-up Menu Step 9 Click a filter on the pop-up menu. Step 10 Enter or select a value for the filter, as shown in the following sample displays Filter Display”, Figure4-8 Sample Filter Display Figure4-9 “Sample Filter Display”): Configuring CSR with the GUI...
  • Page 48 Configuring CSR with the GUI Figure4-9 Sample Filter Display Step 11 To delete a filter to the message, select from the pull-down menu for the filter. The following screen appears (Figure4-10 “Delete Filter Figure4-10 Delete Filter Display Step 12 Click Delete. Step 13 Click OK to save the changes, or click Cancel to cancel the changes.

  • Page 49: Modifying Gatekeepers

    Chapter4 CSR GUI Functionalities Modifying Gatekeepers This section describes how to modify an existing gatekeeper. Step 1 Select a gatekeeper from the gatekeeper list in the Current Gatekeepers area, as follows ( “Current Gatekeepers Area in CSR Figure4-11 Current Gatekeepers Area in CSR Window Step 2 Click Modify.

  • Page 50: Removing Gatekeepers

    Configuring CSR with the GUI Figure4-12 Registered Messages and Filters Dialog Box for an Existing Gatekeeper Step 3 To modify a message and its filters associated with the gatekeeper, click the round button to the left of the message. Step 4 Use the steps in adding messages and filters in the Step 5 Click OK to save the changes, or click Cancel to cancel the changes.

  • Page 51: Setting Threads For Processing Calls And Call Queue Size

    Chapter4 CSR GUI Functionalities Step 1 To remove an existing gatekeeper, select a gatekeeper from the gatekeeper list in the Current Gatekeepers area. Step 2 Click Remove. The following message appears Figure4-13 Delete Gatekeeper Message Step 3 Click Yes to remove the gatekeeper, or click No to retain the gatekeeper. Setting Threads for Processing Calls and Call Queue Size This section describes how to set the number of working threads for processing calls in the queue and the maximum number of calls allowed to be queued.

  • Page 52: Swapping Datasets

    Updating Active Datasets Step 3 To enter the maximum number of calls allowed to be queued, enter a number for “Maximum Queue Size.” The default is 5000. If this number is too low, the gatekeeper connection waits for the CSR to catch up. If this number is too high, the turnaround time per message may be too long during busy hours and the gatekeeper routes the call on its own.

  • Page 53: Creating, Modifying, And Deleting Carriers

    Chapter4 CSR GUI Functionalities • Egress and ingress route attributes • Match patterns • Routes • Rules After you log in to CSR and select the Active Dataset tab in the CSR window, the following screen appears (Figure4-16 “Active Dataset Tab in CSR Figure4-16 Active Dataset Tab in CSR Window The following sections describe functionalities and operations of the Active Dataset tab.

  • Page 54: Creating Carriers

    Updating Active Datasets Creating Carriers Note At least one contact list must be created before a carrier can be created. There must be a single carrier of “Home” type created for the provisioned data. See the Lists ” section on Step 1 In the Active Dataset screen in the CSR window, if Carriers is not selected in the Selection box, click the down arrow in that box.

  • Page 55: Modifying Carriers

    Chapter4 CSR GUI Functionalities Figure4-18 Dialog Box for New Carrier in Active Dataset The carrier key is the primary key of this carrier in the Carriers table. When a new carrier is being created, “ %%%%” is displayed. Step 3 In the Carrier ID box, enter the ID of the carrier.

  • Page 56: Deleting Carriers

    Updating Active Datasets Figure4-19 Dialog Box for an Existing Carrier in Active Dataset Step 3 Change the information accordingly. Step 4 Click Modify to save the changes, or click Cancel to cancel the changes. Deleting Carriers Step 1 In the Active Dataset tab in the CSR window, if Carriers is not selected in the Selection box, click the down arrow in that box, then select Carrier from the pull-down menu.

  • Page 57: Creating, Modifying, And Deleting Contacts

    Chapter4 CSR GUI Functionalities Note Alternatively, you can delete a carrier by clicking Delete when you are in the dialog box for modifying the carrier. Creating, Modifying, and Deleting Contacts This section describes the steps to create, modify, and delete contacts. Creating Contacts Step 1 In the Active Dataset tab screen in the CSR window, click the down arrow in the Selection box, then...

  • Page 58: Modifying Contacts

    Updating Active Datasets Step 5 In the Cost box, enter cost associated with this contact. The entry must be greater than 0. This is optional. Step 6 In the Priority box, enter priority of this contact. The entry must be greater than 0. This is optional. Step 7 Click New to add this contact, or click Cancel to exit.

  • Page 59: Creating, Modifying, And Deleting Contact Lists

    Chapter4 CSR GUI Functionalities Step 2 In the Contacts area, click a contact. You can select more than one contact by holding down the Ctrl key while clicking each contact. Step 3 Click Delete . A Delete message appears: Step 4 Click Yes to delete the contact, or click No to stop the deletion.

  • Page 60: Modifying Contact Lists

    Updating Active Datasets The key shown on the screen is the primary key of this contact list in the Contact List table. When a new contact list is being created, “%%%%” is displayed. Step 3 In the Contact List Name box, enter the name of the contact list. The range is 1 to 64 characters. Step 4 In the Available Contacts box, you can select a contact and click Add to add that contact to the Associated Contacts box.

  • Page 61: Deleting Contact Lists

    Chapter4 CSR GUI Functionalities Step 4 Click Modify to save the changes, or click Cancel to cancel the changes. Deleting Contact Lists Step 1 In the Active Dataset tab in the CSR window, click the down arrow in the Selection box, then select Contact Lists from the pull-down menu.
  • Page 62 Updating Active Datasets Figure4-25 Dialog Box for New Egress Route Attribute in Active Dataset 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. Step 3 In the Name box, enter the name of this egress route attribute.

  • Page 63: Modifying Egress Route Attributes

    Chapter4 CSR GUI Functionalities Step 10 In the Date/Time area, click Daily, Weekly, Absolute or Constant . The egress route attribute is being applied according to these time segments. If you select Daily, enter Start Time and End Time. Use the format shown in the example at the bottom of the Date/Time area: hour(0-23):min (0-60):sec (0-60) If you select Weekly, select day of the week from the pull-down menu and enter the Start Time and...
  • Page 64 Chapter4 CSR GUI Functionalities Updating Active Datasets Figure4-26 List of Egress Route Attribute Names in Active Dataset Cisco Carrier Sensitive Routing User Guide 4-24...

  • Page 65: Deleting Egress Route Attributes

    Chapter4 CSR GUI Functionalities Step 3 From the list, select an Egress Route Attribute by double-clicking on that attribute. Egress Route Attributes information similar to the following appears ( Route Attribute in Active Figure4-27 Dialog Box for an Existing Egress Route Attribute in Active Dataset Step 4 Change the information accordingly.

  • Page 66: Creating, Modifying, And Deleting Ingress Route Attributes

    Updating Active Datasets Step 4 Click Delete. A Delete message appears: Step 5 Click Yes to delete the attribute, or click No to stop the deletion. Note Alternatively, you can delete an attribute by clicking Delete when you are in the dialog box for modifying the attribute.
  • Page 67 Chapter4 CSR GUI Functionalities Figure4-28 Dialog Box for New Ingress Route Attribute in Active Dataset The key shown on the screen is the primary key of this Ingress Route Attribute in the Ingress Route Attributes table. When a new ingress route attribute is being created, “%%%%” is displayed. Step 3 In the Name box, enter the name of this ingress route attribute.

  • Page 68: Modifying Ingress Route Attributes

    Updating Active Datasets hour(0-23):min (0-60):sec (0-60) If you select Weekly, select day of the week from the pull-down menu and enter the Start Time and the End Time. If you select Absolute, enter the Start Date, Start Time, End Date, and End Time. The Start Date is the date when the ingress route attribute becomes active.

  • Page 69: Deleting Ingress Route Attributes

    Chapter4 CSR GUI Functionalities Figure4-29 Dialog Box for an Existing Ingress Route Attribute in Active Dataset Step 4 Change the information accordingly. Step 5 Click Modify to save the changes, or click Cancel to leave the changes. Deleting Ingress Route Attributes Step 1 In the Active Dataset tab in the CSR window, click the down arrow in the Selection box, then select Ingress Route Attributes from the pull-down menu.

  • Page 70: Creating, Modifying, And Deleting Match Patterns

    Updating Active Datasets Note Alternatively, you can delete an attribute by clicking Delete when you are in the dialog box for modifying the attribute. Creating, Modifying, and Deleting Match Patterns This section describes the steps to create, modify, and delete Match Patterns. Creating Match Patterns Step 1 In the Active Dataset tab in the CSR window, click the down arrow in the Selection box, then select...

  • Page 71: Modifying Match Patterns

    Chapter4 CSR GUI Functionalities Modifying Match Patterns Step 1 In the Active Dataset tab in the CSR window, click the down arrow in the Selection box, then select Match Patterns from the pull-down menu. Step 2 In the Match Pattern area, select a pattern by double-clicking on that pattern. Match Pattern information similar to the following appears ( Figure4-31 Dialog Box for New Match Pattern in Active Dataset Step 3...

  • Page 72: Creating, Modifying, And Deleting Routes

    Updating Active Datasets Creating, Modifying, and Deleting Routes This section describes the steps to create, modify, and delete routes. Creating Routes Step 1 In the Active Dataset tab in the CSR window, click the down arrow in the Selection box, then select Match Patterns from the pull-down menu.

  • Page 73: Modifying Routes

    Chapter4 CSR GUI Functionalities Figure4-33 QoS Relationships Dialog Box in Active Dataset In the Ingress Carrier box, click the down arrow, then select the ingress carrier from the pull-down menu. In the Egress Carrier box, click the down arrow, then select the egress carrier from the pull-down menu.

  • Page 74: Deleting Routes

    Updating Active Datasets Figure4-34 Dialog Box for an Existing Route in Active Dataset Step 3 Change the information accordingly. Step 4 Click Modify to save the changes, or click Cancel to leave the changes. Deleting Routes Step 1 In the Active Dataset tab in the CSR window, click the down arrow in the Selection box, then select Routes from the pull-down menu.

  • Page 75: Creating, Modifying, And Deleting Rules

    Chapter4 CSR GUI Functionalities Creating, Modifying, and Deleting Rules This section describes the steps to create, modify and delete rules. Creating Rules Step 1 In the Active Dataset tab in the CSR window, click the down arrow in the Selection box, then select Rules from the pull-down menu.
  • Page 76 Updating Active Datasets • Reject Max Origination Percentage—If the ingress carrier’s current percentage of calls is greater than its provisioned maximum, the call is rejected. Note This rule rejects a call if the percentage of calls originated by this ingress carrier to a specific route or match pattern exceeds the maximum percentage defined in the ingress route attributes for this ingress carrier.

  • Page 77: Modifying Rules

    Chapter4 CSR GUI Functionalities • Select Same Carrier—If the ingress carrier is also a egress carrier candidate, it is selected and all others are deselected. • Select Percentage Egress—Carriers with a zero percentage egress and sharing the greatest difference between their percentage egress and their maximum percentage egress are selected. The purpose is to select the best egress carrier candidates that are furthest from meeting their provisioned maxPercentage on this route (based on their Egress Routing Attribute's maxPercentage value).The other carriers are moved to the deselect list.

  • Page 78: Deleting Rules

    Updating Active Datasets Figure4-36 Dialog Box for Existing Rule in Active Dataset Step 3 Change the information accordingly. Step 4 Click Modify to save the changes, or click Cancel to leave the changes. Deleting Rules Step 1 In the Active Dataset tab in the CSR window, click the down arrow in the Selection box, then select Rules from the pull-down menu.

  • Page 79: Verifying Datasets

    Chapter4 CSR GUI Functionalities Verifying Datasets To verify whether a dataset is valid, click Verify Dataset in the Dataset Commands area. This command ensures that all the provisioned data for the active dataset is valid. If the dataset is not valid, it cannot be loaded into the active CSR memory.

  • Page 80: Destroying Inactive Datasets

    Chapter4 CSR GUI Functionalities Updating Inactive Datasets After you log in to CSR and click the Inactive Dataset tab in the CSR window, the following screen appears (Figure4-37 “Inactive Dataset Tab in CSR Window”): Figure4-37 Inactive Dataset Tab in CSR Window Only one functionality in the Inactive Dataset tab is different from those in the Active Dataset tab.

  • Page 81: Activating Inactive Datasets

    Chapter4 CSR GUI Functionalities Figure4-38 Destroy Message in Inactive Dataset Step 2 Click Yes to destroy the inactive dataset, or No to quit destroying. Activating Inactive Datasets An inactive dataset is not loaded into the CSR memory, with the exception of test commands. To place the dataset in the CSR memory for routing, use the following steps: Step 1 In the Inactive Dataset tab in the CSR window, click Verify Dataset in the Dataset Commands area to...

  • Page 82: Sending Test Route Request Commands To An Active Csr Application

    CSR Commands Sending Test Route Request Commands to an Active CSR Application Step 1 Click the CSR Commands tab in the CSR window. The following screen appears ( in CSR Window, page Figure4-39 CSR Commands Tab in CSR Window Step 2 In the ANI box, enter the origination pattern.

  • Page 83: Step 6

    Chapter4 CSR GUI Functionalities Note If an egress carrier is specified, the call is ignored. It is assumed that the egress carrier has been found. Step 6 In the Time box, enter the simulated time to test time-sensitive calls. If this is not specified, the current time is used.

  • Page 84: Updating Logging Level

    CSR Commands Step 11 To display a log of actions used to process the test results, click Show Log. The following screen appears (Figure4-41 “Log Entries Generated by the CSR Commands Figure4-41 Log Entries Generated by the CSR Commands Tab The log messages, normally routed to syslog, are logged to the database.

  • Page 85: Resetting Call Accounting

    Chapter4 CSR GUI Functionalities Resetting Call Accounting To reset all call units to zero, click Reset Call Accounting. This sets all accounting per carrier and per route/carrier for the CSR. This is the same data used by the Test Route Request functionality. Updating Gatekeepers To update the CSR gatekeepers table, click Update GateKeepers.

  • Page 86: Checking Csr Version

    Checking CSR Version Checking CSR Version To check the CSR version number, select the About tab in the CSR window. Multiple GUI Operation Multiple GUIs can run against a single database and multiple databases. If all users are working in a read-only mode, the following results occur: •...

  • Page 87: Appendix

    Logging This appendix describes the following activities: • Configuring Syslog • Viewing Logs Configuring Syslog This section provides an overview of the UNIX syslog. For more detail, refer to the online manual page for syslog.conf. Syslog is a general location or mechanism for logging informational messages or error messages. The messages are categorized by level, and each level can be directed to a different location specified by files, consoles, and e-mail addresses.

  • Page 88: Examples

    Viewing Logs Messages can originate from the following locations or facilities: • user—User processes from the CSR application. • kern—Kernel • mail—Mail system • daemon—System daemons • auth—Authorization system, such as login or su. • lpr—Print spooler • news—Network new systems Examples ExampleA-1 *.err...

  • Page 89: Sample Logs

    AppendixA Logging • Name of the machine that generated the log • Application/PID • Log level • Message content Sample logs • 2 13:01:14 ciscoe250 CSR01[8333]: ERROR: CSR Started. Note This is logged at err level to note when the CSR was started, even if debug and informational logging is off.
  • Page 90 AppendixA Logging Viewing Logs Cisco Carrier Sensitive Routing User Guide...

  • Page 91: Appendix

    Data Schema This appendix describes the following: • Configuration Data Schema • Dataset Schema Configuration Data Schema BEGIN WORK; SET CONSTRAINTS ALL DEFERRED; CREATE TABLE ConfigurationData ( ActiveDataset text ActiveDatasetSuffixInvalid CHECK ( lower(ActiveDataset) = '_1' OR lower(ActiveDataset) = '_2' LoggingLevel text LoggingLevelInvalid CHECK ( lower(LoggingLevel) = 'error' OR...
  • Page 92 Configuration Data Schema ListenPort 32767), ThreadCount MaxSizeOfQueue integer TestRoutesAccountingEnabled boolean NOT NULL DEFAULT FALSE, RejectSrcCarrierInactive RejectNullSrcCarrier RejectSrcCarrierUnknown RejectDestinationUnknown RejectSrcPercentage RejectSrcUnits RejectNoDstCarrier CREATE TABLE GateKeepers ( GKKey GKID GK_IP GK_Port ListenARQ ListenLRQ ListenIRR ListenDRQ ListenRRQ ListenURQ ListenLCF ListenLRJ ListenRAI ListenBRQ ConnectionState text ConnectionStateInvalid Cisco Carrier Sensitive Routing User Guide integer...
  • Page 93 AppendixB Data Schema CREATE TABLE TestRoutes ( TestKey TestTime TestDate DatasetID lower(DatasetID) = '_2' DNIS SrcCarrierID DstCarrierID RunMe HomeCarrierID varchar(64), ResultCode CREATE TABLE TestOutputs ( TestKey SelectOrder DstCarrierID ListKey IsSelected CREATE TABLE LogEntries ( TestKey EntryOrder LogString CREATE TABLE StringResources ( ResourceKey integer ResourceStringtext integer...
  • Page 94 Configuration Data Schema CREATE TABLE Filters ( FilterKey GKID MsgType FilterType 'destinationinformation' 'remoteextensionaddress' Value ALTER TABLE TestOutputs ADD FOREIGN KEY (TestKey) REFERENCES TestRoutes (TestKey) DEFERRABLE; ALTER TABLE LogEntries ADD FOREIGN KEY (TestKey) REFERENCES TestRoutes (TestKey) DEFERRABLE; ALTER TABLE Filters (GKID) DEFERRABLE;...

  • Page 95: Dataset Schema

    AppendixB Data Schema Dataset Schema BEGIN WORK; SET CONSTRAINTS ALL DEFERRED; CREATE TABLE Carriers ( CarrierKey CarrierName CarrierType CarrierID MaxIngressUnits integer MaxEgressUnitsinteger RuleKey ListKey isActive CREATE TABLE Carriers_1 () INHERITS (Carriers); CREATE TABLE Carriers_2 () INHERITS (Carriers); CREATE TABLE MatchPatterns ( PatternKey Pattern RouteKey...
  • Page 96 Dataset Schema CREATE TABLE Routes ( RouteKey RouteName RuleKey CREATE TABLE Routes_1 () INHERITS (Routes); CREATE TABLE Routes_2 () INHERITS (Routes); CREATE TABLE Rules ( RuleKey RuleName IsDefaultRule boolean MinQoS PreferredCarrierKey integer, RejectMaxOriginationPercentage boolean NOT NULL DEFAULT FALSE, RejectMaxIngressUnits RejectMaxIngressUnitsPerRoute boolean RejectEgressCostMoreThanIngress boolean NOT NULL DEFAULT FALSE, RejectInsufficientQoS RejectMaxEgressUnits...
  • Page 97 AppendixB Data Schema SelectSameCarrier SelectPreferredCarrier SelectPercentageEgress CREATE TABLE Rules_1 () INHERITS (Rules); CREATE TABLE Rules_2 () INHERITS (Rules); CREATE TABLE Contacts ( ContactKey RASAddress AddressType ContactAddressTypeInvalid CHECK ( SelectBestQoS >= 0 AND SelectBestQoS <= 5 integer NOT NULL DEFAULT 0 CONSTRAINT SelSameCarrierInvalid CHECK ( SelectSameCarrier >= 0 AND...
  • Page 98 Dataset Schema Cost Priority CREATE TABLE Contacts_1 () INHERITS (Contacts); CREATE TABLE Contacts_2 () INHERITS (Contacts); CREATE TABLE Lists ( ListKey ListName text CREATE TABLE Lists_1 () INHERITS (Lists); CREATE TABLE Lists_2 () INHERITS (Lists); CREATE TABLE ContactLists ( ListKey ContactKey CREATE TABLE ContactLists_1 () INHERITS (ContactLists);...
  • Page 99 AppendixB Data Schema StartTime EndTime (StartDate < WeekDay NOTNULL) StartDate EndDate Cost MaxUnits MaxPercentage integer MaxPercentage <= CREATE TABLE IngressRouteAttributes_1 () INHERITS (RouteAttributes); CREATE TABLE IngressRouteAttributes_2 () INHERITS (RouteAttributes); CREATE TABLE EgressRouteAttributes ( ListKey integer ) INHERITS (RouteAttributes); CREATE TABLE EgressRouteAttributes_1 () INHERITS (EgressRouteAttributes);...
  • Page 100 Dataset Schema CREATE TABLE QoS ( IngressCarrierKeyinteger EgressCarrierKey integer RouteKey RelativeQoS CREATE TABLE QoS_1 () INHERITS (QoS); CREATE TABLE QoS_2 () INHERITS (QoS); CREATE TABLE RouteParent ( RouteKey AttributeKey CREATE TABLE IngressRoutes_1 () INHERITS (RouteParent); CREATE TABLE IngressRoutes_2 () INHERITS (RouteParent); CREATE TABLE EgressRoutes_1 CREATE TABLE EgressRoutes_2 COMMIT;...
  • Page 101 AppendixB Data Schema Dataset Schema CREATE UNIQUE INDEX Contacts_1_PKey ON Contacts_1 (ContactKey); CREATE UNIQUE INDEX Contacts_2_PKey ON Contacts_2 (ContactKey); CREATE UNIQUE INDEX Lists_1_PKey ON Lists_1 (ListKey); CREATE UNIQUE INDEX Lists_2_PKey ON Lists_2 (ListKey); CREATE UNIQUE INDEX Match_1_Pattern ON MatchPatterns_1(Pattern); CREATE UNIQUE INDEX Match_2_Pattern ON MatchPatterns_2(Pattern); CREATE UNIQUE INDEX IRA_1_PKey ON IngressRouteAttributes_1 (AttributeKey);...
  • Page 102 Dataset Schema ALTER TABLE Carriers_1 ADD FOREIGN KEY (RuleKey) REFERENCES Rules_1 (RuleKey) DEFERRABLE; ALTER TABLE Carriers_1 ADD FOREIGN KEY (ListKey) REFERENCES Lists_1 (ListKey) DEFERRABLE; ALTER TABLE Carriers_2 ADD FOREIGN KEY (RuleKey) REFERENCES Rules_2 (RuleKey) DEFERRABLE; ALTER TABLE Carriers_2 ADD FOREIGN KEY (ListKey) REFERENCES Lists_2 (ListKey) DEFERRABLE;...
  • Page 103 AppendixB Data Schema ALTER TABLE EgressRouteAttributes_2 ADD FOREIGN KEY (CarrierKey) REFERENCES Carriers_2 (CarrierKey) DEFERRABLE; ALTER TABLE EgressRouteAttributes_2 ADD FOREIGN KEY (ListKey) REFERENCES Lists_2 ALTER TABLE QoS_1 ADD FOREIGN KEY (IngressCarrierKey) REFERENCES Carriers_1 (CarrierKey) DEFERRABLE; ALTER TABLE QoS_1 ADD FOREIGN KEY (EgressCarrierKey) REFERENCES Carriers_1 (CarrierKey) DEFERRABLE;...
  • Page 104 AppendixB Data Schema Dataset Schema Cisco Carrier Sensitive Routing User Guide B-14...

  • Page 105: Appendix

    Error Conditions and Recoveries This appendix describes the following error conditions and recoveries: • Database Connectivity Loss • Gatekeeper Connectivity Loss Database Connectivity Loss During connectivity loss, CSR attempts to reconnect to the database every minute, and it continues to handle gatekeeper requests with the current dataset in memory.

  • Page 106: Gatekeeper Connectivity Loss

    Gatekeeper Connectivity Loss Gatekeeper Connectivity Loss Gatekeeper Connectivity Loss can occur for any of the following reasons: • Power failure on gatekeeper • General network problem • Network problem related to the Sun/Solaris During connectivity loss, CSR attempts to reconnect to the gatekeepers every minute. You can also use the GUI to attempt a reconnection by clicking Update GateKeepers in the CSR Commands tab in the CSR window.

  • Page 107: G L O S S A R Y

    automatic number identification. admission request message. bandwidth request message. DNIS dialed number identification service. domain naming system. disengage request message. graphical user interface. information request response message. location confirm message. location reject message. location request message. G L O S S A R Y Cisco Carrier Sensitive Routing User Guide GL-3...
  • Page 108 Glossary resource availability indication message. registration request message. unregistration request message. Cisco Carrier Sensitive Routing User Guide GL-4...

  • Page 109: I N D E X

    active and inactive datasets 4-12 Active Dataset tab Configuration Management tab 4-41 CSR Commands tab Destination carrier DNIS DNS server GateKeeper Transaction Message Protocol 4-39 Inactive Dataset Tab LogEntries Logging StringResources Logging Level Debug Error Information see also Updating Logging Level registration messages root Rules...
  • Page 110 Index Source carrier Tables Carrier Configuration Settings Contact List Contacts Egress Route Attributes Egress Routes Filters Gatekeepers Ingress Route Attributes Ingress Routes Match Patterns Routes Rules see also Database Tables TestOutputs TestRoutes Cisco Carrier Sensitive Routing User Guide IN-6...

Table of Contents