Cisco Cisco PXM Version 1.1 manuel d'utilisation

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110

Aller à la page of

Un bon manuel d’utilisation

Les règles imposent au revendeur l'obligation de fournir à l'acheteur, avec des marchandises, le manuel d’utilisation Cisco Cisco PXM Version 1.1. Le manque du manuel d’utilisation ou les informations incorrectes fournies au consommateur sont à la base d'une plainte pour non-conformité du dispositif avec le contrat. Conformément à la loi, l’inclusion du manuel d’utilisation sous une forme autre que le papier est autorisée, ce qui est souvent utilisé récemment, en incluant la forme graphique ou électronique du manuel Cisco Cisco PXM Version 1.1 ou les vidéos d'instruction pour les utilisateurs. La condition est son caractère lisible et compréhensible.

Qu'est ce que le manuel d’utilisation?

Le mot vient du latin "Instructio", à savoir organiser. Ainsi, le manuel d’utilisation Cisco Cisco PXM Version 1.1 décrit les étapes de la procédure. Le but du manuel d’utilisation est d’instruire, de faciliter le démarrage, l'utilisation de l'équipement ou l'exécution des actions spécifiques. Le manuel d’utilisation est une collection d'informations sur l'objet/service, une indice.

Malheureusement, peu d'utilisateurs prennent le temps de lire le manuel d’utilisation, et un bon manuel permet non seulement d’apprendre à connaître un certain nombre de fonctionnalités supplémentaires du dispositif acheté, mais aussi éviter la majorité des défaillances.

Donc, ce qui devrait contenir le manuel parfait?

Tout d'abord, le manuel d’utilisation Cisco Cisco PXM Version 1.1 devrait contenir:
- informations sur les caractéristiques techniques du dispositif Cisco Cisco PXM Version 1.1
- nom du fabricant et année de fabrication Cisco Cisco PXM Version 1.1
- instructions d'utilisation, de réglage et d’entretien de l'équipement Cisco Cisco PXM Version 1.1
- signes de sécurité et attestations confirmant la conformité avec les normes pertinentes

Pourquoi nous ne lisons pas les manuels d’utilisation?

Habituellement, cela est dû au manque de temps et de certitude quant à la fonctionnalité spécifique de l'équipement acheté. Malheureusement, la connexion et le démarrage Cisco Cisco PXM Version 1.1 ne suffisent pas. Le manuel d’utilisation contient un certain nombre de lignes directrices concernant les fonctionnalités spécifiques, la sécurité, les méthodes d'entretien (même les moyens qui doivent être utilisés), les défauts possibles Cisco Cisco PXM Version 1.1 et les moyens de résoudre des problèmes communs lors de l'utilisation. Enfin, le manuel contient les coordonnées du service Cisco en l'absence de l'efficacité des solutions proposées. Actuellement, les manuels d’utilisation sous la forme d'animations intéressantes et de vidéos pédagogiques qui sont meilleurs que la brochure, sont très populaires. Ce type de manuel permet à l'utilisateur de voir toute la vidéo d'instruction sans sauter les spécifications et les descriptions techniques compliquées Cisco Cisco PXM Version 1.1, comme c’est le cas pour la version papier.

Pourquoi lire le manuel d’utilisation?

Tout d'abord, il contient la réponse sur la structure, les possibilités du dispositif Cisco Cisco PXM Version 1.1, l'utilisation de divers accessoires et une gamme d'informations pour profiter pleinement de toutes les fonctionnalités et commodités.

Après un achat réussi de l’équipement/dispositif, prenez un moment pour vous familiariser avec toutes les parties du manuel d'utilisation Cisco Cisco PXM Version 1.1. À l'heure actuelle, ils sont soigneusement préparés et traduits pour qu'ils soient non seulement compréhensibles pour les utilisateurs, mais pour qu’ils remplissent leur fonction de base de l'information et d’aide.

Table des matières du manuel d’utilisation

  • Page 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 Cisco Carrier Sensitive Routing User Guide Version 1.1[...]

  • Page 2

    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 [...]

  • Page 3

    iii Cisco Carrier Sensitive Routing User Guide C ON TE N T S 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 A[...]

  • Page 4

    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 CH A P TE R 3 Cisco Carrier Sensitive Routing Application Operations 3-1 Activating CSR 3-1 Single Instanc[...]

  • Page 5

    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 [...]

  • Page 6

    Contents vi Cisco Carrier Sensitive Routing User Guide A P P E N D I X A Logging A-1 Configuring Syslog A-1 Examples A-2 Viewing Logs A-2 Sample logs A-3 A P P E N D I X B Data Schema B-1 Configuration Data Schema B-1 Dataset Schema B-5 A P P E N D I X C Error Conditions and Recoveries C-1 Database Connectivity Loss C-1 Gatekeeper Connectivity Loss[...]

  • Page 7

    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 Convention[...]

  • Page 8

    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, an[...]

  • Page 9

    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 Obtai[...]

  • Page 10

    x Cisco Carrier Sensitive Routing User Guide Preface Obtaining Technical Assistance Documentation Feedback 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 bug-doc@cisco.com. You can [...]

  • Page 11

    xi Cisco Carrier Sensitive Routing User Guide Preface Obtaining Technical Assistance 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 n[...]

  • Page 12

    xii Cisco Carrier Sensitive Routing User Guide Preface Obtaining Technical Assistance[...]

  • Page 13

    CH A P TE R 1-1 Carrier Sensitive Routing User Guide 1 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 attrib[...]

  • Page 14

    1-2 Carrier Sensitive Routing User Guide Chapter1 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 illus[...]

  • Page 15

    1-3 Carrier Sensitive Routing User Guide Chapter1 Overview of Cisco Carrier Sensitive Routing CSR Basics 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 thr[...]

  • Page 16

    1-4 Carrier Sensitive Routing User Guide Chapter1 Overview of Cisco Carrier Sensitive Routing 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 Egres[...]

  • Page 17

    1-5 Carrier Sensitive Routing User Guide Chapter1 Overview of Cisco Carrier Sensitive Routing CSR Limitations 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 [...]

  • Page 18

    1-6 Carrier Sensitive Routing User Guide Chapter1 Overview of Cisco Carrier Sensitive Routing CSR Limitations[...]

  • Page 19

    CH A P TE R 2-1 Cisco Carrier Sensitive Routing User Guide 2 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 d[...]

  • Page 20

    2-2 Cisco Carrier Sensitive Routing User Guide Chapter2 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 hos[...]

  • Page 21

    2-3 Cisco Carrier Sensitive Routing User Guide Chapter2 PostgreSQL Database Operations and Functionalities Database Operations 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 co[...]

  • Page 22

    2-4 Cisco Carrier Sensitive Routing User Guide Chapter2 PostgreSQL Database Operations and 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 plac[...]

  • Page 23

    2-5 Cisco Carrier Sensitive Routing User Guide Chapter2 PostgreSQL Database Operations and Functionalities Database Functionalities Table2-1 Configuration Data Table Name Type Allow Null Default Constraints Comments ActiveDataset text NO ‘_1’ Valid values: • _1 • _2 There are two datasets in the CSR (active and inactive). There are two of e[...]

  • Page 24

    2-6 Cisco Carrier Sensitive Routing User Guide Chapter2 PostgreSQL Database Operations and Functionalities Database Functionalities ThreadCount integer NO 10 Number of threads in the working pool that handle routes in the rules engine. This number must be adjusted for different systems. MaxSizeOfQueue integer NO 5000 Maximum size of the queue to ha[...]

  • Page 25

    2-7 Cisco Carrier Sensitive Routing User Guide Chapter2 PostgreSQL Database Operations and Functionalities Database Functionalities RejectSrcUnits boolean NO FALSE If this rejection rule applies, the CSR returns a rejection instead of a null body. RejectNoDstCarri er boolean NO FALSE If this rejection rule applies, the CSR returns a rejection inste[...]

  • Page 26

    2-8 Cisco Carrier Sensitive Routing User Guide Chapter2 PostgreSQL Database Operations and Functionalities Database Functionalities ListenLRJ boolean NO FALSE Set to TRUE if registering for this type of message. ListenRAI boolean NO FALSE Set to TRUE if registering for this type of message. ListenBRQ boolean NO FALSE Set to TRUE if registering for [...]

  • Page 27

    2-9 Cisco Carrier Sensitive Routing User Guide Chapter2 PostgreSQL Database Operations and Functionalities Database Functionalities 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. Table2-4 TestOutputs Table Name Type Allow Null Defaul[...]

  • Page 28

    2-10 Cisco Carrier Sensitive Routing User Guide Chapter2 PostgreSQL Database Operations and Functionalities Database Functionalities 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[...]

  • Page 29

    2-11 Cisco Carrier Sensitive Routing User Guide Chapter2 PostgreSQL Database Operations and Functionalities Database Functionalities Note Tables Carriers_1 and Carriers_2 can inherit from the Carriers table. Table2-8 Carriers Table Name Type Allow Null Default Constraints Comments CarrierKey integer NO <>0 Primary key. Key of the carrier. Car[...]

  • Page 30

    2-12 Cisco Carrier Sensitive Routing User Guide Chapter2 PostgreSQL Database Operations and Functionalities Database Functionalities Note Tables MatchPatterns_1 and MatchPatterns_2 can inherit from this table. Note Tables Routes_1 and Routes_2 can inherit from the Routes table. Table2-10 Routes Table Name Type Allow Null Default Constraints Comment[...]

  • Page 31

    2-13 Cisco Carrier Sensitive Routing User Guide Chapter2 PostgreSQL Database Operations and Functionalities Database Functionalities RejectMaxOriginationPercentage boolean NO FALSE Indicates whether to reject this rule. RejectMaxIngressUnits boolean NO FALSE Indicates whether to reject this rule. RejectMaxIngressUnitsPerRoute boolean NO FALSE Indic[...]

  • Page 32

    2-14 Cisco Carrier Sensitive Routing User Guide Chapter2 PostgreSQL Database Operations and Functionalities Database Functionalities Note Tables Rules_1 and Rules_2 can inherit from the Rules table. Note Tables Contacts_1 and Contacts_2 can inherit from the Contacts table. SelectPreferredCarrier integer NO 0 >= 0 and <= 5 Specifies preferred [...]

  • Page 33

    2-15 Cisco Carrier Sensitive Routing User Guide Chapter2 PostgreSQL Database Operations and Functionalities Database Functionalities Lists Table Note Tables Lists_1 and Lists_2 can inherit from the Lists table. Note Tables ContactLists_1 and ContactLists_2 can inherit from this table. Table2-13 Lists Table Name Type Allow Null Default Constraints C[...]

  • Page 34

    2-16 Cisco Carrier Sensitive Routing User Guide Chapter2 PostgreSQL Database Operations and Functionalities Database Functionalities Note Tables IngressRouteAttributes_1 and IngressRouteAttributes _2 can inherit from the RouteAttributes table. DaypartType text NO Valid values: • absolute • weekly • daily • always The CSR searches for the co[...]

  • Page 35

    2-17 Cisco Carrier Sensitive Routing User Guide Chapter2 PostgreSQL Database Operations and Functionalities Database Functionalities Note EgressRouteAttributes_1 and EgressRouteAttributes_2 can inherit from the EgressRouteAttributes and RouteAttriubtes tables. Note Tables QoS_1 and QoS_2 can inherit from this QoS table. Table2-16 EgressRouteAttribu[...]

  • Page 36

    2-18 Cisco Carrier Sensitive Routing User Guide Chapter2 PostgreSQL Database Operations and Functionalities 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. Refe[...]

  • Page 37

    CH A P TE R 3-1 Cisco Carrier Sensitive Routing User Guide 3 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 multipl[...]

  • Page 38

    3-2 Cisco Carrier Sensitive Routing User Guide Chapter3 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 [...]

  • Page 39

    3-3 Cisco Carrier Sensitive Routing User Guide Chapter3 Cisco Carrier Sensitive Routing Application Operations Deactivating CSR 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 Di[...]

  • Page 40

    3-4 Cisco Carrier Sensitive Routing User Guide Chapter3 Cisco Carrier Sensitive Routing Application Operations Deactivating CSR Figure3-2 CSR Window Step 3 Click the CSR Commands tab. Step 4 Click Shutdown CSR . This shuts down all CSRs connected to this database. All current calls are dropped, and connections to gatekeepers are terminated.[...]

  • Page 41

    CH A P TE R 4-1 Cisco Carrier Sensitive Routing User Guide 4 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 • CSR C[...]

  • Page 42

    4-2 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities Configuring CSR with the GUI Step 2 Enter the information in the Login dialog box as follows: a. Enter the user name. The range is 1 to 32 characters. b. Enter the password. The range is 1 to 32 characters. c. Enter the host name where the database is located. This can [...]

  • Page 43

    4-3 Cisco Carrier Sensitive Routing User Guide 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 Le[...]

  • Page 44

    4-4 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities 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 ar[...]

  • Page 45

    4-5 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities Configuring CSR with the GUI Adding, Modifying, and Removing Gatekeepers To add, modify, and remove gatekeeper s, 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 gateke[...]

  • Page 46

    4-6 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities 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. Step 4 Ε nter po[...]

  • Page 47

    4-7 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities Configuring CSR with the GUI 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 ( Figure4-8 “ Sample Filter Display ” , Figure4-9 “ Sample Filter Display[...]

  • Page 48

    4-8 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities 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 Display ” ): Figure4-10 Delete Filter Display Step 12 Cli[...]

  • Page 49

    4-9 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities Configuring CSR with the GUI 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 ( Figure4-11 “ Current Gatekeepers Area in CSR Window ” ).[...]

  • Page 50

    4-10 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities 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 me[...]

  • Page 51

    4-11 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities Configuring CSR with the GUI 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 ” ). Figure4-13 Delete G[...]

  • Page 52

    4-12 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities 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, [...]

  • Page 53

    4-13 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities Updating Active Datasets • 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 Window ” ): F[...]

  • Page 54

    4-14 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities 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 “ Deleting Contact Lists ” section on page4-21 . S[...]

  • Page 55

    4-15 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities Updating Active Datasets 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 [...]

  • Page 56

    4-16 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities 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[...]

  • Page 57

    4-17 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities Updating Active Datasets 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. Creati[...]

  • Page 58

    4-18 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities 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 Ne[...]

  • Page 59

    4-19 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities Updating Active Datasets 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 [...]

  • Page 60

    4-20 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities 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 ran[...]

  • Page 61

    4-21 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities Updating Active Datasets 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 m[...]

  • Page 62

    4-22 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities 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, “ %[...]

  • Page 63

    4-23 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities Updating Active Datasets 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. a. If you select Daily, enter Start Time and End Time. Use the format shown in the exampl[...]

  • Page 64

    4-24 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities Updating Active Datasets Figure4-26 List of Egress Route Attribute Names in Active Dataset[...]

  • Page 65

    4-25 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities Updating Active Datasets 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 ( Figure4-27 “ Dialog Box for an Existing Egress Route Attribute in Active Datas[...]

  • Page 66

    4-26 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities 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 attr[...]

  • Page 67

    4-27 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities Updating Active Datasets 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, ?[...]

  • Page 68

    4-28 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities Updating Active Datasets hour(0-23):min (0-60):sec (0-60) b. If you select Weekly, select day of the week from the pull-down menu and enter the Start Time and the End Time. c. If you select Absolute , enter the Start Date, Start Time, End Date, and End Time. The Start [...]

  • Page 69

    4-29 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities Updating Active Datasets 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 I[...]

  • Page 70

    4-30 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities 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[...]

  • Page 71

    4-31 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities Updating Active Datasets 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[...]

  • Page 72

    4-32 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities 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 Pat[...]

  • Page 73

    4-33 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities Updating Active Datasets Figure4-33 QoS Relationships Dialog Box in Active Dataset a. In the Ingress Carrier box, click the down arrow , then select the ingress carrier from the pull-down menu. b. In the Egress Carrier box, click the down arrow , then select the egress[...]

  • Page 74

    4-34 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities 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 [...]

  • Page 75

    4-35 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities Updating Active Datasets 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 th[...]

  • Page 76

    4-36 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities 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 ca[...]

  • Page 77

    4-37 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities Updating Active Datasets • 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[...]

  • Page 78

    4-38 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities 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 windo[...]

  • Page 79

    4-39 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities Updating Inactive Datasets 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 i[...]

  • Page 80

    4-40 Cisco Carrier Sensitive Routing User Guide 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 [...]

  • Page 81

    4-41 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities CSR Commands 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[...]

  • Page 82

    4-42 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities 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 ( CSR Commands Tab in CSR Window , page 4-42 ): Figure4-39 CSR Commands Tab in CSR Window Step 2 In the ANI b[...]

  • Page 83

    4-43 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities CSR Commands 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. The format[...]

  • Page 84

    4-44 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities 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 Tab ” ): Figure4-41 Log Entries Generated by the CSR Commands Tab The log messa[...]

  • Page 85

    4-45 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities CSR Commands 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 upd[...]

  • Page 86

    4-46 Cisco Carrier Sensitive Routing User Guide Chapter4 CSR GUI Functionalities 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[...]

  • Page 87

    A-1 Cisco Carrier Sensitive Routing User Guide A PP E ND I X A 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 logg[...]

  • Page 88

    A-2 Cisco Carrier Sensitive Routing User Guide AppendixA Logging 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 • ne[...]

  • Page 89

    A-3 Cisco Carrier Sensitive Routing User Guide AppendixA Logging Viewing Logs • Name of the machine that generated the log • Application/PID • Log level • Message content Sample logs • Jan 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 informationa[...]

  • Page 90

    A-4 Cisco Carrier Sensitive Routing User Guide AppendixA Logging Viewing Logs[...]

  • Page 91

    B-1 Cisco Carrier Sensitive Routing User Guide A PP E ND I X B 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 NOT NULL DEFAULT '_1' CONSTRAINT ActiveDatasetSuffixInval[...]

  • Page 92

    B-2 Cisco Carrier Sensitive Routing User Guide AppendixB Data Schema Configuration Data Schema ListenPort integer CONSTRAINT CSRListenPortInvalid CHECK (ListenPort > 0 AND ListenPort <= 32767), ThreadCount integer NOT NULL DEFAULT 10, MaxSizeOfQueue integer NOT NULL DEFAULT 5000, TestRoutesAccountingEnabled boolean NOT NULL DEFAULT FALSE, Rej[...]

  • Page 93

    B-3 Cisco Carrier Sensitive Routing User Guide AppendixB Data Schema Configuration Data Schema ) ); CREATE TABLE TestRoutes ( TestKey integer NOT NULL PRIMARY KEY, TestTime time, TestDate date, DatasetID text DEFAULT '_1' CONSTRAINT DatasetIDInvalid CHECK ( lower(DatasetID) = '_1' OR lower(DatasetID) = '_2' ), ANI varc[...]

  • Page 94

    B-4 Cisco Carrier Sensitive Routing User Guide AppendixB Data Schema Configuration Data Schema CREATE TABLE Filters ( FilterKey integer NOT NULL PRIMARY KEY, GKID varchar(64) NOT NULL, MsgType text NOT NULL CONSTRAINT MsgTypeInvalid CHECK ( lower(MsgType) = 'arq' OR lower(MsgType) = 'lrq' OR lower(MsgType) = 'rrq' OR l[...]

  • Page 95

    B-5 Cisco Carrier Sensitive Routing User Guide AppendixB Data Schema Dataset Schema Dataset Schema BEGIN WORK; SET CONSTRAINTS ALL DEFERRED; CREATE TABLE Carriers ( CarrierKey integer NOT NULL PRIMARY KEY CONSTRAINT CarrierKeyNotZero CHECK (CarrierKey <> 0), CarrierName varchar(64) NOT NULL, CarrierType text NOT NULL CONSTRAINT CarrierTypeInv[...]

  • Page 96

    B-6 Cisco Carrier Sensitive Routing User Guide AppendixB Data Schema Dataset Schema CREATE TABLE Routes ( RouteKey integer NOT NULL PRIMARY KEY CONSTRAINT RouteKeyNotZero CHECK (RouteKey <> 0), RouteName text, RuleKey integer ); CREATE TABLE Routes_1 () INHERITS (Routes); CREATE TABLE Routes_2 () INHERITS (Routes); CREATE TABLE Rules ( RuleKe[...]

  • Page 97

    B-7 Cisco Carrier Sensitive Routing User Guide AppendixB Data Schema Dataset Schema CHECK ( SelectBestQoS >= 0 AND SelectBestQoS <= 5 ), SelectSameCarrier integer NOT NULL DEFAULT 0 CONSTRAINT SelSameCarrierInvalid CHECK ( SelectSameCarrier >= 0 AND SelectSameCarrier <= 5 ), SelectPreferredCarrier integer NOT NULL DEFAULT 0 CONSTRAINT S[...]

  • Page 98

    B-8 Cisco Carrier Sensitive Routing User Guide AppendixB Data Schema Dataset Schema Cost integer CONSTRAINT CostInvalid CHECK (Cost >= 0), Priority integer CONSTRAINT PriorityInvalid CHECK (Priority >= 0) ); CREATE TABLE Contacts_1 () INHERITS (Contacts); CREATE TABLE Contacts_2 () INHERITS (Contacts); CREATE TABLE Lists ( ListKey integer NOT[...]

  • Page 99

    B-9 Cisco Carrier Sensitive Routing User Guide AppendixB Data Schema Dataset Schema CHECK (Weekday >=0 AND Weekday <= 6), StartTime time, EndTime time CONSTRAINT TimeRangeInvalid CHECK ( (StartTime ISNULL AND EndTime ISNULL AND lower(DaypartType) = 'always') OR (StartTime NOTNULL AND EndTime NOTNULL AND (StartTime < EndTime) OR ([...]

  • Page 100

    B-10 Cisco Carrier Sensitive Routing User Guide AppendixB Data Schema Dataset Schema CREATE TABLE QoS ( IngressCarrierKey integer NOT NULL, EgressCarrierKey integer NOT NULL, RouteKey integer NOT NULL, RelativeQoS integer NOT NULL CONSTRAINT RelativeQoSInvalid CHECK (RelativeQoS >= 1 AND RelativeQoS <= 9) ); CREATE TABLE QoS_1 () INHERITS (Qo[...]

  • Page 101

    B-11 Cisco Carrier Sensitive Routing User Guide 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[...]

  • Page 102

    B-12 Cisco Carrier Sensitive Routing User Guide AppendixB Data Schema 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) DEFERRA[...]

  • Page 103

    B-13 Cisco Carrier Sensitive Routing User Guide AppendixB Data Schema Dataset 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 (ListKey) DEFERRABLE; ALTER TABLE QoS_1 ADD FOREIGN KEY (IngressCarrierK[...]

  • Page 104

    B-14 Cisco Carrier Sensitive Routing User Guide AppendixB Data Schema Dataset Schema[...]

  • Page 105

    C-1 Cisco Carrier Sensitive Routing User Guide A PP E ND I X C 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 cont[...]

  • Page 106

    C-2 Cisco Carrier Sensitive Routing User Guide AppendixC Error Conditions and Recoveries 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  system During conne[...]

  • Page 107

    GL-3 Cisco Carrier Sensitive Routing User Guide G L O SS A R Y A ANI automatic number identification. ARQ admission request message. B BRQ bandwidth request message. D DNIS dialed number identification service. DNS domain naming system. DRQ disengage request message. G GUI graphical user interface. I irr information request response message. L LCF [...]

  • Page 108

    Glossary GL-4 Cisco Carrier Sensitive Routing User Guide R RAI resource availability indication message. RRQ registration request message. U URQ unregistration request message.[...]

  • Page 109

    IN-5 Cisco Carrier Sensitive Routing User Guide INDEX A active and inactive datasets 1-3 Active Dataset tab 4-12 ANI 1-2 ARQ 1-2 B BRQ 1-2 C Configuration Management tab 4-2 CSR Commands tab 4-41 D Destination carrier 1-2 DNIS 1-2 DNS 3-5 DNS server 3-5 DRQ 1-2 G GateKeeper Transaction Message Protocol A-1 I Inactive Dataset Tab 4-39 IRR 1-2 L LCF [...]

  • Page 110

    Index IN-6 Cisco Carrier Sensitive Routing User Guide S Source carrier 1-2 T Tables Carrier 1-3 Configuration Settings 1-3 Contact List 1-3 Contacts 1-3 Egress Route Attributes 1-3 Egress Routes 1-3 Filters 1-3 Gatekeepers 1-3 Ingress Route Attributes 1-3 Ingress Routes 1-3 Match Patterns 1-3 QoS 1-3 Routes 1-3 Rules 1-3 see also Database Tables 2-[...]