Carrier-Sensitive Routing User Guide

Table of Contents



This preface describes the objective, audience, organization, and conventions of the Cisco Carrier Sensitive Routing User Guide.

It contains the following information:


The Cisco Carrier 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(TM) computer system

Document Organization

This guide is organized as follows:

"Overview of Cisco Carrier Sensitive Routing"

Provides an overview of the postgreSQL database, CSR application, and CSR graphical user interface (GUI).

"PostgreSQL Database Operations and Functionalities"

Describes the operations and functionalities of the postgreSQL database.

"Cisco Carrier Sensitive Routing Application Operations"

Describes the operations and functionalities of the CSR application.

"CSR GUI Functionalities"

Describes the CSR graphical user interface functionalities.


Describes the configuration of syslog and viewing logs.

"Data Schema"

Describes the configuration data schema and dataset schema.

"Error Conditions and Recoveries"

Describes database and gatekeeper connectivity loss.

Document Conventions

Table 1

Convention Description


Commands and keywords are in bold face.


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.

^ or Ctrl

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.

Following are conventions that might be used in this document.

Related Documentation and References

  • Carrier Sensitive Routing Installation Guide

For Sun/Solaris(TM), Java, and postgreSQL database information, go to the following URLs:

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:

Translated documentation is available at this URL:

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 users (Cisco direct customers) can order Cisco product documentation from the Networking Products MarketPlace:

  • Registered users can order the Documentation CD-ROM through the online Subscription Store:

  • Nonregistered users can order documentation through a local account representative by calling Cisco Systems Corporate Headquarters (California, U.S.A.) at 408 526-7208 or, elsewhere in North America, by calling 800 553-NETS (6387).

Documentation Feedback

You can submit comments electronically on 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

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 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. registered users have complete access to the technical support resources on the Cisco TAC Web Site. 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. 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 To access, go to this URL:

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 Web Site and the Cisco TAC Escalation Center.

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.

  • Priority level 2 (P2)—Your production network is severely degraded, affecting significant aspects of business operations. No workaround is available.

  • Priority level 1 (P1)—Your production network is down, and a critical impact to business operations will occur if service is not restored quickly. No workaround is available.

The Cisco TAC resource that you choose is based on the priority of the problem and the conditions of service contracts, when applicable.

Cisco TAC Web Site

You can use the Cisco TAC Web Site to resolve P3 and P4 issues yourself, saving both cost and time. The site provides around-the-clock access to online tools, knowledge bases, and software. To access the Cisco TAC Web Site, go to this URL:

All customers, partners, and resellers who have a valid Cisco service contract have complete access to the technical support resources on the Cisco TAC Web Site. The Cisco TAC Web Site requires a login ID and password. If you have a valid service contract but do not have a login ID or password, go to this URL to register:

If you are a registered user, and you cannot resolve your technical issues by using the Cisco TAC Web Site, you can open a case online by using the TAC Case Open tool at this URL:

If you have Internet access, we recommend that you open P3 and P4 cases through the Cisco TAC Web Site.

Cisco TAC Escalation Center

The Cisco TAC Escalation Center addresses priority level 1 or priority level 2 issues. These classifications are assigned when severe network degradation significantly impacts business operations. When you contact the TAC Escalation Center with a P1 or P2 problem, a Cisco TAC engineer automatically opens a case.

To obtain a directory of toll-free Cisco TAC telephone numbers for your country, go to this URL:

Before calling, please check with your network operations center to determine the level of Cisco support services to which your company is entitled: for example, SMARTnet, SMARTnet Onsite, or Network Supported Accounts (NSA). When you call the center, please have available your service agreement number and your product serial number.