Cisco Signaling Interface H.323 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
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199

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 Signaling Interface H.323. 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 Signaling Interface H.323 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 Signaling Interface H.323 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 Signaling Interface H.323 devrait contenir:
- informations sur les caractéristiques techniques du dispositif Cisco Signaling Interface H.323
- nom du fabricant et année de fabrication Cisco Signaling Interface H.323
- instructions d'utilisation, de réglage et d’entretien de l'équipement Cisco Signaling Interface H.323
- 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 Signaling Interface H.323 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 Signaling Interface H.323 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 Signaling Interface H.323, 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 Signaling Interface H.323, 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 Signaling Interface H.323. À 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 He adquarters Cisc o Syst ems , Inc . 170 West Ta sman Drive San Jos e, CA 95 134-1706 USA http://www.ci sco.com Tel: 408 526-4000 800 553- NETS (638 7) Fax: 408 526-4100 Cisco H.323 Signaling Interface User Guide Cisco HSI Release 4.1 No vem ber 2007 Text Pa rt Nu mber: OL-4806- 01 R ev. A14[...]

  • Page 2

    THE SPECIFICATIONS AND INFORMATION REGARDING TH E PRODUCTS IN THIS MANUAL ARE SUBJE CT TO CHANGE WITHOUT NO TICE. ALL STATEMENT S, INFORMATI ON, AND RECOMMENDA TIONS IN T HIS MANUAL ARE BELIEVED TO BE ACCURATE BU T ARE PRESEN TED WITHOUT WARRANTY OF ANY KIND, EXPRE SS OR IMPLIED. USERS MUST TA KE FULL RESPONSIBILITY FOR THEIR AP PLICATION OF ANY PR[...]

  • Page 3

    iii Cisco H.323 Sign aling Int erface User Gui de OL-4806-01 Rev. A14 CONTENTS Preface 13 Docume nt Obje ctiv es 13 Audienc e 13 System Admi nistra tor 13 System Oper ator 14 System Tec hnicia n 14 Document Organi zation 14 Document Conv entions 15 Relat ed D ocum ent atio n 16 Releas e Notes 16 Hardwa re Docu mentat ion 16 Softwar e Documentat ion[...]

  • Page 4

    Cont ents iv Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 E-ISU P 4 New Featur es in Cisc o HSI Releas e 4.1 4 Operati onal Env ironment 4 Hardwa re Requ irements 4 Softw are Requ irem ents 5 Securi ty 5 Cisco HSI Recovery 5 Cisco HSI System Limi tation s 5 CHAPTER 2 Instal ling and Confi guring C isco HSI Software 1 Introd uct io[...]

  • Page 5

    Cont ents v Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 H.323 Sta ck Conf igurat ion 10 Nonprov isionable Data 11 MML P rov isio nable Dat a 11 H.323 Sy stem Par ame ters 11 Q.931 Par ameters 11 RAS Pa rame ters 13 H.245 Par ameters 15 Code c Selec tion 18 Quick Re feren ce f or Imp ort ant Pa ram eters 18 HSI Fe ature Conf igu[...]

  • Page 6

    Cont ents vi Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Overlo ad Level 2 7 Overlo ad Level 3 7 Settin g Ov erlo ad Da ta 8 Retri eving Ov erload Data 8 Logg ing 9 Rotati ng Log Fil es 9 Convent ion for Naming the Log File 9 Log F ile L ocati on 9 Log Messag es 10 Log Messag e Packages 10 Loggin g Levels 10 Setti ng Logging Leve[...]

  • Page 7

    Cont ents vii Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Cause 7 Troubl eshoo ting 7 EISUP_PA TH_FAILURE 7 Descri ption 7 Severi ty Leve l and Trap Ty pe 7 Cause 7 Troubl eshoo ting 7 GATEKEEPE R_INTERFACE _FAILURE 8 GENERAL_PR OCESS_FAILUR E 8 Descri ption 8 Severi ty Leve l and Trap Ty pe 8 Cause 8 Troubl eshoo ting 8 IP_LIN[...]

  • Page 8

    Cont ents viii Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Severi ty Leve l and Trap Ty pe 11 Cause 11 Troubl eshoo ting 11 ENDPOINT_C ALL_CONTRO L_INTERFA CE_FAILURE 12 Descri ption 12 Severi ty Leve l and Trap Ty pe 12 Cause 12 Troubl eshoo ting 12 ENDPOINT_C HANNEL_INTER FACE_FAILUR E 12 Descri ption 12 Severi ty Leve l and Tr[...]

  • Page 9

    Cont ents ix Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Severi ty Leve l and Trap Ty pe 15 Cause 15 Troubl eshoo ting 16 Deta iled L oggin g 16 APPENDI X A MML User Inter face and Command Refer ence 1 Intro duction 1 Start ing an M ML Comm and Sess ion in t he Ci sco HSI 1 MML Commands 2 MML Command Synta x 2 MML Command Conve[...]

  • Page 10

    Cont ents x Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 radlog 23 restar t-softw 24 rtrv-a lms 25 rtrv-c alls 26 rtrv-c tr 26 rtrv-d est 27 rtrv- gapping 28 rtrv-l og 28 rtrv-m ml 29 rtrv-n e 30 rtrv- ne-he alth 30 rtrv-o ver load 31 rtrv-s oftw 32 set-de st-state 33 set-ga pping 34 set-lo g 35 set-ov erload 36 sta-ca llproc 37 s[...]

  • Page 11

    Cont ents xi Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 APPENDI X B Skeleton Con f igurat ion File 1 APPENDI X C Example o f an HSI Configuration File 1 APPENDI X D E-ISUP Na m e-to-C ause Value Lookup 1 APPENDI X E E-ISUP Ca use Value-to-Name Lookup 1 APPENDI X F H.323 Name-t o-Cause Valu e Lookup 1 APPENDI X G H.323 Cause V [...]

  • Page 12

    Cont ents xii Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14[...]

  • Page 13

    xiii Cisco H.323 Sign aling Int erface User Gui de OL-4806-01 Rev. A14 Preface This p refac e descr ibes the objecti ves, au dience , org ani zation , and con ve ntion s of the Cisco H .323 Signali ng Interfac e User Gui de , and explai ns how to find addition al inf ormat ion on re lated pr oduct s and services . It contains the fo llo wing sectio[...]

  • Page 14

    xiv Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Prefac e Docum ent Organ izatio n The sys tem admin istrato r should hav e an in-depth know ledge of UNIX and a bas ic kno wledge of da ta and teleco mmuni cations ne tworking. System Operato r The syst em operator is a ssumed t o have knowledge o f the following : • T elecomm uni[...]

  • Page 15

    xv Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Pre face Document C onventi ons • Appendix E, “E-I SUP Cause V alue- to-Name Lookup” • Appendix F , “H.323 Nam e-to-Caus e V alue Look up” • Appendix G, “H.3 23 Cause V alu e-to-N ame Look up” Document Co nventions This manu al uses the documen t conv e ntions lis[...]

  • Page 16

    xvi Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Prefac e Related Documenta tion Note Means r eader tak e note . Notes contain helpf ul suggestions or referen ces to material not co vered in the manual . Ti p Mean s the fo llowing informat ion will help you solve a pr oblem . The tip info rmation might not be troublesh ooting or e[...]

  • Page 17

    xvii Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Pre face Obtaining Documentat ion Softwa re Docume ntation • Cisco Media Gateway Co ntr ol ler So ftware Release 9 In stallati on and Configuration Guid e • Cisco Media Gateway Co ntr ol ler So ftware Release 9 P r ovisi oning Gui de • Cisco Media Gateway Co ntr oll er Soft[...]

  • Page 18

    xviii Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Prefac e Obtain ing Techni cal Ass istance Ordering Docume ntation Y ou can order Cisco documen tation i n these ways: • Re gister ed Cisc o.com u sers (C isco di rect cus tomers ) can or der Cis co pro duct do cumen tation from the Ne tworking Pr oducts MarketPl ace: http://www[...]

  • Page 19

    xix Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Pre face Obtainin g Technica l A ssistan ce • Regist er for online sk ill assessment, training, and c ertifi cation programs If you want to o btain c ustomize d infor mation and se rvice, you c an self- register on Cisco.co m. T o acc ess Cisco.com , go to this URL : http://www [...]

  • Page 20

    xx Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Prefac e Obtain ing Techni cal Ass istance Cisco TAC Escalation Center The Cisco T A C Escalation Cent er addresses priority le ve l 1 or priority lev e l 2 issu es. T hese classifications a re assigne d when severe network degra dation si gnificantly impacts business operat ions. Wh[...]

  • Page 21

    C HAPTER 1-1 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 1 Cisco H.323 Signaling Inte rface Overview Introduction This c hapter p rovides an overview of the Cisco H.323 Signali ng Inte rface ( HSI) syste m an d subsyste ms and co ntains the following sect ions: • Cisco HSI Overview , page 1-1 • Cisco HSI System Description [...]

  • Page 22

    1-2 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Chapter 1 Cisco H.323 Signalin g Interface Ove rview Cisco HSI System Desc ription Figur e 1 -1 Cisco HS I System Overview PGW 2200 The PG W 2200 consist s of the har dware a nd software that perfo rm the signal ing a nd call contr ol tasks (such as digit an alysis, routing, and cir[...]

  • Page 23

    1-3 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Chapter 1 Cisco H.323 Si gnaling I nterface O verview Cisco HSI Sy stem D esc riptio n Figur e 1 -2 Cisco HSI Subsy stems OAM Subsystem The O AM subsystem provid es the fol low ing services: • Man-Ma chine Langua ge (MML) interf ace that enab les you to retrie ve operatio nal pa[...]

  • Page 24

    1-4 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Chapter 1 Cisco H.323 Signalin g Interface Ove rview Operati onal Envi ronmen t RUDP R UD P transpo rts the E- ISUP message s betwee n the PGW 2200 a nd the Cisco HSI . R UDP is a Cisco pr oprietar y , conne ction-o rien ted, pa cket-bas ed tra nsport pro toco l. RADVis ion H.323 Th[...]

  • Page 25

    1-5 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Chapter 1 Cisco H.323 Si gnaling I nterface O verview Cisco H SI Re covery Softwa re Re quireme nts The softwa re requi remen ts for the Ci sco HSI are docume nted in the Cisco Media Gateway Controller Sof twar e R elease 9 In stallat ion and Co nf igu ra tion Guide . Security The[...]

  • Page 26

    1-6 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Chapter 1 Cisco H.323 Signalin g Interface Ove rview Cisco H SI System L imitati ons[...]

  • Page 27

    C HAPTER 2-1 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 2 Installing and Configuring Cisco HSI Software Introduction This cha pter contai ns instruct ions for inst alling an d configurin g the Cisco H.3 23 Signali ng Interface (HSI). This chapter contains the follo wing sect ions: • Hardware and Software Req uirement s, page[...]

  • Page 28

    2-2 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Chapter 2 Installing and Configuring Cisco HSI Software Instal ling the Cisc o HSI Installing the Cisco HSI This sec tion prov ides step-b y-step instr uctions for in stalling the Cisco HSI. Before Yo u Star t Complete the p reinstallation tasks listed in Ta b l e 2-1 before i nstal[...]

  • Page 29

    2-3 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Chapter 2 Installing and Configuring Ci sco HSI Softw are Installing the Cisco HSI Step 5 Enter the follo wing command: # vi .c shrc Step 6 Enter th e vi in sert mode b y entering the follo wing comma nd: i (enter insert mode) Step 7 Enter the follo wing text on t he first lin e: [...]

  • Page 30

    2-4 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Chapter 2 Installing and Configuring Cisco HSI Software Instal ling the Cisc o HSI The Cisco HSI application is distrib uted as a tar file (with f ilename GoldW ing- xxxx .tar in which xxxx is the version ID, for example , Gold W ing-4.1 .tar) or as a C D-ROM. The defau lt installat[...]

  • Page 31

    2-5 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Chapter 2 Installing and Configuring Ci sco HSI Softw are Installing the Cisco HSI Installing Cisco HSI This section pro vides step-b y-step instructions for insta lling a single Cisco HSI for use with a simplex PGW 2200 configurati on (a c onfiguration w ith one Cisco PG W 2200 h[...]

  • Page 32

    2-6 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Chapter 2 Installing and Configuring Cisco HSI Software Instal ling the Cisc o HSI Step 5 At the # prompt, e nter th e follo wing commands : # cd /export/B UILDS/4.1 # ./insta ll.sh The follo wing text displays: Processing package instance <OTTgw000> from </export/BUILDS/4.[...]

  • Page 33

    2-7 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Chapter 2 Installing and Configuring Ci sco HSI Softw are Installing the Cisco HSI Step 14 T ype th e gat ekeep er I D (s ee Ta b l e 2- 2 ) and press Enter . Note The gatekeepe r ID must m atch the e ntry configur ed in the gatekeeper. The follo wing text displays: Enter E-ISUP H[...]

  • Page 34

    2-8 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Chapter 2 Installing and Configuring Cisco HSI Software Instal ling the Cisc o HSI Step 20 T ype the installat ion location (see Ta b l e 2-2 ) an d press Enter . Note The installa tion loca tion field is a text fi eld typi cally use d by network designers for identif ication purpos[...]

  • Page 35

    2-9 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Chapter 2 Installing and Configuring Ci sco HSI Softw are Installing the Cisco HSI [ verifying class <script> ] ## Executing postinstall script. Installed package instance is: OTTgw000 Installation of <OTTgw000> was successful. Installed package instance environment va[...]

  • Page 36

    2-10 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Chapter 2 Installing and Configuring Cisco HSI Software Instal ling the Cisc o HSI Installing Multiple Cisco HSIs in a Redundant PGW 2200 Configuration This section describ es how to install and con figure two Cisco HSI fo r use with a redu ndant Ci sco PGW 2200 configurat ion (See[...]

  • Page 37

    2-11 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Chapter 2 Installing and Configuring Ci sco HSI Softw are Start ing the Ci sco HSI Dual HSI Exa mple Confi guration S cript The fo llowing example script configures th e network top ology depic ted in Figure 2-1 . Exam ple HSI-A (Blue network) prov-add:name="SYS_CONFIG_STATI[...]

  • Page 38

    2-12 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Chapter 2 Installing and Configuring Cisco HSI Software Stopping the Cisco HSI Stopping the Cisc o HSI T o stop th e Cisc o HSI, log i n as root user and ent er th e fo llowing com mand: # /etc/init .d/CiscoGW stop Note The command to stop the Cisco HSI returns informatio n such as[...]

  • Page 39

    2-13 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Chapter 2 Installing and Configuring Ci sco HSI Softw are Removing the Cisco HSI • The system sh ould be r estarted to e nable the r e-initializa tion of th e SNMP processes. The crafts person need s to ch ange th e user to ro ot and issue the fo llo wing U NIX com mand: shutdo[...]

  • Page 40

    2-14 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Chapter 2 Installing and Configuring Cisco HSI Software Removing the Cisc o HSI Step 6 T ype y and press Ent er . The following text displays: ## Removing installed package instance <OTTgw000> This package contains scripts which will be executed with super-user permission dur[...]

  • Page 41

    C HAPTER 3-1 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 3 Provisioning the Cisco HSI Introduction This cha pter desc ribes the d ata th at must be pr ovisioned f or the Cisc o H.323 Signa ling Inte rface (H SI). The data is di vided into two are as: system conf iguration and H.323 stac k data. This chap ter contai ns the follo[...]

  • Page 42

    3-2 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Chapte r 3 Provisio ning the Cisco HSI Cisco HSI Configura tion HSI star ts up, it attem pts to rea d the ac tiv e configur ation, checks t hat the configurat ion has been verified, and ensures that th e checksum matches. If the acti ve con figu ration is not ver ifie d or if the ch[...]

  • Page 43

    3-3 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Chapter 3 Prov isioning the Cisco HSI Cisco HSI Configuration Introduction to MML Co mmand Op eration for HSI After the HSI software is insta lled, you can confi gure additio nal items. The follo wing MML comman d exa mples sho w how to en able DTMF capa bility on the H SI. (F or [...]

  • Page 44

    3-4 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Chapte r 3 Provisio ning the Cisco HSI Cisco HSI Configura tion Step 2 T o display the entire confi guration, issue the follo wing command: rtrv-config T o display a subse t of t he co nfiguration, one can issue a co mmand su ch a s th e foll owing: rtrv-config:sys_config_static Ste[...]

  • Page 45

    3-5 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Chapter 3 Prov isioning the Cisco HSI Cisco HSI Configuration Ta b l e 3-3 Static System D ata P arameters Para meter Ty p e Description HOST_POR T_N UMBER1 [0- 65535] The first port number to be used by the Cisco HSI . The de fault value is 0. Note This val ue must match the peer[...]

  • Page 46

    3-6 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Chapte r 3 Provisio ning the Cisco HSI Cisco HSI Configura tion Pa vo RedirPresInd [0-3] The v alue of the Pa vo redi recting num ber presentat ion indicator . (If this parameter is n ot pro visioned, t he defau lt is Q.93 1 zero—no indication. ) CliInDi splaySup ported STRI NG If[...]

  • Page 47

    3-7 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Chapter 3 Prov isioning the Cisco HSI Cisco HSI Configuration Changing Static System Data T o change static system data, you must f irst determine if it is acceptable to stop currently acti ve calls in 20 secon ds. If it is accepta ble to sto p acti ve calls in 20 se conds, change[...]

  • Page 48

    3-8 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Chapte r 3 Provisio ning the Cisco HSI Cisco HSI Configura tion Dynamic System Data T o modify the d ynamic system data param eters in Ta b l e 3-4 , use the sy s_config_dyn amic MML nam e variable fo r the pro v-add , pr ov-dlt , and prov -ed commands. Y ou need not halt an d resta[...]

  • Page 49

    3-9 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Chapter 3 Prov isioning the Cisco HSI Cisco HSI Configuration O V LDLEV EL1 PERCEN T Indi cates wh at per centage of ca lls s hould b e rej ected wh en an ov erload condition occurs. This parameter is us ed in conjunct io n with the O VLDL EVEL1FIL TER parameter . The ov erloa d l[...]

  • Page 50

    3-10 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Chapte r 3 Provisio ning the Cisco HSI H.323 St ack Configu ration H.323 Stack Configuration The para meter name is based on th e ASN.1 pat hs; but, in some cases, t he param eter name has been shortened for con veni ence. F or example, “capabilitie s” has b een shorten ed to ?[...]

  • Page 51

    3-11 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Chapter 3 Prov isioning the Cisco HSI H.323 Sta ck Configu ration Nonprovisionable Data The paramete rs in Ta b l e 3-5 ca nnot be alt ered t hroug h MML comm ands. MML Prov isionabl e Data H.323 System Parameters The paramete rs in Ta b l e 3-6 are required for H.323 stac k init[...]

  • Page 52

    3-12 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Chapte r 3 Provisio ning the Cisco HSI H.323 St ack Configu ration Exam ple prov-add:name=q931,maxCalls=2000 The Upda te T ype co lumn in Ta b l e 3-7 shows when the chan ge to a parameter takes e ffect o nce a change is made: • Immediat e means that th e ef fect of t he change i[...]

  • Page 53

    3-13 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Chapter 3 Prov isioning the Cisco HSI H.323 Sta ck Configu ration RAS Parameters The paramete rs in Ta b l e 3-8 are requi red fo r RAS stack initia lizati on. T o modi fy the RAS pa ramet ers, use the ras MML name v ariable for the pr ov-add , pro v -dlt, and prov-ed comm ands. [...]

  • Page 54

    3-14 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Chapte r 3 Provisio ning the Cisco HSI H.323 St ack Configu ration allo wCallsWhenNon Reg If this paramete r is present, it allo ws calls to proceed e ven if gatekee per registra tion has not been d one for the PGW 2200. NULL Not prese nt Immediate manualRegistra tion If this para [...]

  • Page 55

    3-15 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Chapter 3 Prov isioning the Cisco HSI H.323 Sta ck Configu ration H.245 Parameters T o modify the H.245 para meters listed in Ta b l e 3-9 , use the h245 M ML na me variable for the prov-add, pro v -dlt and pro v-ed command s. In th e foll owing examp le, the prov- ad d command s[...]

  • Page 56

    3-16 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Chapte r 3 Provisio ning the Cisco HSI H.323 St ack Configu ration Ta b l e 3-1 0 , Ta b l e 3-11 , and Ta b l e 3-1 2 list the parameters and modes relate d to the configu ring of codecs. The arra y index [i ] must be replace d wit h a valid brace d index f rom 1 to 20. The brace [...]

  • Page 57

    3-17 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Chapter 3 Prov isioning the Cisco HSI H.323 Sta ck Configu ration caps.tabl e[i].a udio.g72 2at56k INTE GER(1, 256) caps.tabl e[i].a udio.g72 2at48k INTE GER(1, 256) caps.tabl e[i].a udio.g72 31.maxAud ioFrame s INTEG ER(1,256 ) caps.tabl e[i].a udio.g7231. silence Suppressi on I[...]

  • Page 58

    3-18 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Chapte r 3 Provisio ning the Cisco HSI H.323 St ack Configu ration Codec Selection The Cisco HSI n egotia tes the media stream codec to establish a m atch betwe en the PSTN MGCP media gateway (for exam ple, the Cisc o AS5 xxx se ries o r Cisco MGX series) and the H. 323 e ndpoint o[...]

  • Page 59

    3-19 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Chapter 3 Prov isioning the Cisco HSI H.323 Sta ck Configu ration The fol lowing MML com mand example s hows the com mand se quenc e used t o pr ovision the cal l contro l paramete rs pro vided in t h e preced ing tabl e. Exam ple mml > prov-sta::srcver=active, dstver=myconf &[...]

  • Page 60

    3-20 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Chapte r 3 Provisio ning the Cisco HSI H.323 St ack Configu ration Ta b l e 3-14 Co mmon Static S ystem D ata P aramet ers Parameter N ame Paramete r V alues Description Carr ierC ode Mappi ng • “enabled” —a string that indi cates the feat ure is enable d. • Blank (“ ?[...]

  • Page 61

    3-21 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Chapter 3 Prov isioning the Cisco HSI H.323 Sta ck Configu ration The fo llowing M ML co mmand example shows the command sequ ence u sed t o provisi on the stati c system data pa ramet ers provided in th e preced ing table . Exam ple mml > prov-sta::srcver=active, dstver=mycon[...]

  • Page 62

    3-22 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Chapte r 3 Provisio ning the Cisco HSI HSI Feature Config uration Ta b l e 3-1 6 pre sents com mon H.2 45 pa ramet ers f or e nabli ng the G.7 29 co dec. The following M ML co mmand example shows the comma nd sequ ence used to provision the H .245 paramete rs provid ed in the prece[...]

  • Page 63

    3-23 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Chapter 3 Prov isioning the Cisco HSI HSI Feature Configuration • Configuring G.726 on the Cisco HSI • Configuring G .729 Annex and G.729 Annex B Asymmetric Codec Treatment The Asymmetric Codec T reatment featur e av erts the potential for inconsistencies in codec se lection,[...]

  • Page 64

    3-24 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Chapte r 3 Provisio ning the Cisco HSI HSI Feature Config uration Refer to Cisco PGW a nd Cisco I OS do cument ation a t www . cisco.co m for furthe r info rmati on on these comm ands. T.38 Fax The T .38 Fa x feature enables the HSI to alter a call, init ially established fo r vo i[...]

  • Page 65

    3-25 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Chapter 3 Prov isioning the Cisco HSI HSI Feature Configuration Support fo r the H.22 5 INFORMA T ION message is enabled by default. A craf ts person ca n disable H.255 INFORMA TIO N mess age support thro ugh a new prop erty called Inform atio n MsgDi sable d by issuing the follo[...]

  • Page 66

    3-26 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Chapte r 3 Provisio ning the Cisco HSI HSI Feature Config uration Ta b l e 3-1 7 presen ts e xampl es of c onfig uratio n comman ds that may b e requ ired to i m plemen t a partic ular G.Clea r config uration . Ta b l e 3-1 7 Configur ing Clear Cha nnel Clea r C hanne l Pa ramet er[...]

  • Page 67

    3-27 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Chapter 3 Prov isioning the Cisco HSI HSI Feature Configuration Configuring G.726 on the Cisco HSI The G.726 codec enab les transc oding a PCM chann el to or from an ADPCM da ta stream . The stand ard supports fo ur data rat es:16, 24, 32 and 40 kbit/se c. G.726 cap ability is ad[...]

  • Page 68

    3-28 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Chapte r 3 Provisio ning the Cisco HSI HSI Feature Config uration If a non- preferred G.726 data rate is selec ted ov er a higher- preferenc e codec, the HSI will co ntinue with the call us ing the non- preferred d ata rate. Th is is prefer able to the a lternati ve (abortin g the [...]

  • Page 69

    3-29 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Chapter 3 Prov isioning the Cisco HSI HSI Feature Configuration H245, cap s.tabl e[i]. entr yNo 7261 , 7262, … Note Set this p arameter to a unique i nteger val u e prov-add:nam e=h245, caps.t able[5 ].en tryNo=726 1 prov-add:nam e=h245, caps.t able[6 ].en tryNo=726 2 H245, cha[...]

  • Page 70

    3-30 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Chapte r 3 Provisio ning the Cisco HSI HSI Feature Config uration H245, caps. table[i]. audio.g72 6-gen eric. bitOrde r 1,2 o r 3 Note This f ield is a bitmask o f 8 b its, and can take an y va lu e from 0...2 55. Refe r to G.726 Annex B, sect ion B4.2 for a m ore detailed descr ip[...]

  • Page 71

    3-31 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Chapter 3 Prov isioning the Cisco HSI HSI Feature Configuration Configuring G.7 29 Annex and G.7 29 Annex B Ta b l e 3-1 8 present s examples of co nfiguration comma nds that may be required t o impleme nt a parti cular configurati on of G.729 A nnex A or G.729 Annex B . H245, mo[...]

  • Page 72

    3-32 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Chapte r 3 Provisio ning the Cisco HSI HSI Feature Config uration H245, modes[i]. name “g72 9AnnexA” “g729Ann exB” “g729A nnexA wAnnex B” prov-add:nam e=h245, modes[ 4].name ="g729 AnnexA" prov-add:nam e=h245, modes[ 5].name ="g729 AnnexB" prov-add:n[...]

  • Page 73

    C HAPTER 4-1 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 4 Managing the Cisco HSI Introduction This c hapter pr ovides infor mation a bout op erat ion a nd mana gement t asks for the Cisc o H.32 3 Signal ing Interf ace (HSI) applicatio n. This c hapter c ontains th e follo wing sections: • Rest art ing th e Cisc o HSI App lic[...]

  • Page 74

    4-2 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Cha pter 4 Man aging th e Cis co HS I Starting Cal l Processing Starting Call Processing T o start ca ll pr oces sing, use the sta-callproc MML command. F or more information abo ut this comm and, se e Appe ndix A, “MML User Inter face and Comman d Refer ence. ” Stopping the Cal[...]

  • Page 75

    4-3 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Chapter 4 Managing t he Cisco HSI Meas ure men ts Call-Relate d Measure ments The Cisco HSI a pplication ha ndles all call-re lated measurem ents. An SNMP MI B handles the col lection of call-relate d measurement data. The cal l-rela ted mea suremen ts are organized into count er [...]

  • Page 76

    4-4 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Cha pter 4 Man aging th e Cis co HS I Measure ments Ta b l e 4-2 Q.9 31 Cou nter Group Coun ter Na me Meas ureme nt Ty p e Comments FC_INC_CAL L_A TT_ TO T H.225 Incomi ng Fast Connect Call Attempts Integer Incr emented when a se tup contain ing the fa stStart elemen t is r ecei ved[...]

  • Page 77

    4-5 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Chapter 4 Managing t he Cisco HSI Meas ure men ts Ta b l e 4-3 H.245 Count er Gr oup Coun ter Na me Meas ureme nt Ty p e Comments MAS TER_ SLA VE_A TT_TO T H.245 Master Slave Determinatio n Attempt s Integer Incr emented w h ene ver ei ther si de of the call initia tes the master [...]

  • Page 78

    4-6 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Cha pter 4 Man aging th e Cis co HS I Overl oad Resetting Measurements The clr-meas MML comm and res ets the measurement counte rs. T his com mand res ets a n indi vidual counte r or all count ers in a count er group. The following are valid counte r groups : • RAS • Q.931 • H[...]

  • Page 79

    4-7 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Chapter 4 Managing t he Cisco HSI Overload Disk usag e can tri gger a LO W_DISK_ SP A CE ala rm. For more i nformat ion about this alar m, see Chapter 5, “T roublesho oting Cisc o HSI Alarms. ” Overload Level 1 Use the following con figurati on param eters fo r overload level [...]

  • Page 80

    4-8 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Cha pter 4 Man aging th e Cis co HS I Overl oad Setting Overload Data The follo wing MML comman ds set ov erload d ata : set-ov erload:level1 |leve l2|lev el3:cpu, lower= number , upper= number set-ov erload:level1 |leve l2|lev el3:calls, lower = number , upper= number set-ov erload[...]

  • Page 81

    4-9 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Chapter 4 Managing t he Cisco HSI Log gin g Logging The l ogging l evel of one or m ore serv ice p ackage s is set using the set-lo g MML comm and. F or mo re inform ation a bout this com mand, see Appe ndix A, “MM L User Int erface an d Comma nd Refe rence. ” Rotating Log Fil[...]

  • Page 82

    4-10 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Cha pter 4 Man aging th e Cis co HS I Logging Log M essages Log messag es have the following format: Date an d timestamp, P ac kag e Name, <log le vel>, LogID: <text of the me ssag e>. The fol lo wing are exam ples of log mess ages: Thu Dec 7 03:55:32:837 2000, Infrastr[...]

  • Page 83

    4-11 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Chapter 4 Managing t he Cisco HSI Gapping Note W e strongly reco mmend that you set all packages to log le vel 0x0000 in a li ve network. Set them to higher le vels only wh en you debug on an offline networ k. Setting Logging Levels The set-log MML command dyna mically alter s th[...]

  • Page 84

    4-12 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Cha pter 4 Man aging th e Cis co HS I Gappin g Step 4 Ente r t he set-gapping MML co mmand. F or e xampl e, to g ap 60 perc ent of all calls f or bo th dir ections , ent er: set-gapping:both:calltype=all,per cent=60 Retrieving Call Gapping Data T o retrie ve the curr ent lev els of[...]

  • Page 85

    C HAPTER 5-1 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 5 Troubleshooting Cisco HSI Alarms Introduction This c hapte r co ntains inform ation about Cis co H.3 23 Signa ling In terface (HSI) alar ms, tr oublesho oting proc edures f or these al arms, and infor mation abo ut detai led logging. Th is chapte r contain s the foll ow[...]

  • Page 86

    5-2 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Chapt er 5 Troublesho oting Ci sco HSI Alarms Alarms Ove rview Retrieving and Reporting Alarms Ev ents wi th a se verity le ve l of cr itical, m ajor , or m inor a re clas sif ied as alarms a n d can b e retr ie ve d through the M an-Ma chin e Lang uage ( MML) i nterfa ce and a Sim [...]

  • Page 87

    5-3 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Chapter 5 Troubleshoot ing Cisco HSI Alarms Retriev ing Alarm Messages Retrieving Alarm Messages Alarms c an be displa yed i n noncon tinuous mode or in continu ous mo de. Noncontinuous Mode T o display all current alarms, u se the rtrv- alms MML comm an d. Figure 5-1 sho ws an e [...]

  • Page 88

    5-4 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Chapt er 5 Troublesho oting Ci sco HSI Alarms Acknow ledging and Cl earing A larms Acknowledging an d Cleari ng Alarms T o ackno wledge t h at a n alarm i s reco gnized b ut no t cleared , us e the ack-alm MML comman d. See Appendix A, “MML User Interfa ce and Comm and Ref erence,[...]

  • Page 89

    5-5 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Chapter 5 Troubleshoot ing Cisco HSI Alarms Alarms List Alarms List Ta b l e 5-4 list s alar ms an d infor matio n events. Troubleshoo ting inf orma tion f or e ach of the a larms and inform ation events can be foun d in the “Troubleshoo ting” section on pa ge 5-6 . Ta b l e 5[...]

  • Page 90

    5-6 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Chapt er 5 Troublesho oting Ci sco HSI Alarms Troubles hooting Troubleshooting This se ction provides troubl eshooting proc edure s for t he al arms l isted in Ta b l e 5-4 . H323_STAC K_FAILURE Description Irreco verable f ailure in the RAD V ision stac k. This a larm is rep orted [...]

  • Page 91

    5-7 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Chapter 5 Troubleshoot ing Cisco HSI Alarms Troubl eshooti ng Cause A major error has occurred in the con f iguratio n of the software packag es. This is a potentially nonrecov erable situation that requires an application restart. Troubleshooting T o clear the CONFIG URA TI ON_F [...]

  • Page 92

    5-8 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Chapt er 5 Troublesho oting Ci sco HSI Alarms Troubles hooting GATEKEEP ER_INTERFA CE_FAILURE This alar m has not been i mplem ent ed. GENERAL_PROCESS_FAILURE Description A gener al process failu re has occu rred. Th is alarm is re ported to the managem ent inter face an d can be ob[...]

  • Page 93

    5-9 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Chapter 5 Troubleshoot ing Cisco HSI Alarms Troubl eshooti ng Troubleshooting T o clear the IP link failure alarm, complete the follo wing steps: Step 1 Use the rtrv- dest command to assess wh ich PGW 2200 (st andby or active ) has been lost. Step 2 Check the netw ork con nection [...]

  • Page 94

    5-10 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Chapt er 5 Troublesho oting Ci sco HSI Alarms Troubles hooting Cause The O VERLO AD_LEVEL3 alarm is triggered when the CPU occu pancy or the number of acti ve calls rises abo ve the upper lim its set in the ove rload conf iguration for le vel 3. Gapping is then initiate d . Trouble[...]

  • Page 95

    5-11 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Chapter 5 Troubleshoot ing Cisco HSI Alarms Troubl eshooti ng OVERLOAD_LEVEL2 Description An ov erload le vel 2 condition e xists. This alarm is reported to the management inter face an d can be obtained w ith SNMP . This a larm auto matically c lears whe n the CPU oc cupancy or [...]

  • Page 96

    5-12 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Chapt er 5 Troublesho oting Ci sco HSI Alarms Troubles hooting ENDPOINT_CALL_CONTRO L_INTERFACE_FAILURE Description An indi vidual call fail ure has occur red. This infor mational e vent is reporte d to the managemen t interfac e and can be obtaine d with SNMP . Severity Level and [...]

  • Page 97

    5-13 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Chapter 5 Troubleshoot ing Cisco HSI Alarms Troubl eshooti ng GAPPED_CALL_NORMAL Description A norma l call has b een reje cted due to call gapping. T his inf ormational e vent is reported to the manageme nt inter face and can be obta ined wit h SNMP . Severity Level and Trap Typ[...]

  • Page 98

    5-14 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Chapt er 5 Troublesho oting Ci sco HSI Alarms Troubles hooting Troubleshooting T o clear the GAPPED_CALL_PRIORITY informational e vent, complete the follo wing steps: Step 1 Change the M ML gapp ing lev els t o less than 1 00 pe rcent and ch ange the c all type to norm al. Step 2 C[...]

  • Page 99

    5-15 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Chapter 5 Troubleshoot ing Cisco HSI Alarms Troubl eshooti ng Cause The provisio ning session has been inacti ve for 20 minutes. The pro visioning session will be closed if there is no acti vity within the next 5 minutes. Troubleshooting Ensure that acti vity in the provisioning [...]

  • Page 100

    5-16 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Chapt er 5 Troublesho oting Ci sco HSI Alarms Det aile d L og ging Troubleshooting This is an informatio nal ev ent. Detailed Loggin g Logging occu rs on 16 differen t levels for eac h packa ge, and the lo gging mask ( which is a 1 6-bit n umber from 0x0000 to 0xFFFF) allows each s[...]

  • Page 101

    A- 1 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 APPEND IX A MML User Interface and Command Reference Introduction This appe ndix p rovides infor mati on about Ma n-Mac hine Lan guage (M ML) co mman d syntax and conv en tions, batch files, and pr oced ures for starti ng and stopp ing MML sessions in th e Cisco H.323 Signaling I[...]

  • Page 102

    A- 2 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendix A MML User Interf ace and C ommand Refe rence MML Commands MML Commands T o execute MML c omma nds, log in to Cisco H SI and per form one of t he following tasks: • Start the MML session (see the “Starting a n MML Session” sectio n on pa ge A-3 ) and en ter a comm an[...]

  • Page 103

    A-3 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix A MML Use r Interface and Comman d Reference Start ing an MML Sess ion The MML commands c an be inte rpret ed and moni tored th rough a network T rans action La nguag e 1 (TL1) in terface. The TL1 symbols shown in Ta b l e A-2 ar e used in MML . Case Sensitivity Command [...]

  • Page 104

    A- 4 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendix A MML User Interf ace and C ommand Refe rence Batch Fil es Batch Files The Cisco HSI applica tion supports the use of batch f iles. Y ou can create an ASCII file of MML pro vision ing comman ds for use as a batch f ile. Y ou can also use a script fi le. When the co mmands [...]

  • Page 105

    A-5 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix A MML Use r Interface and Comman d Reference MML Responses The follo wing example sho w s the start of a batch f ile named nolog.b at with these contents: prov-sta:srcver=active,dstver=nolog prov-ed:name=logging,eisup=0x0000 prov-cpy and thi s output: gp-capetown-16->[...]

  • Page 106

    A- 6 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendix A MML User Interf ace and C ommand Refe rence MML Hel p Error Messages If an MML comma nd does n ot p erform, an er ror m essag e is di splayed. Ta b l e A-4 lists the MML error messages a nd their d escriptions. . MML Help MML ha s an onli ne help featu r e. Th e MML help[...]

  • Page 107

    A-7 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix A MML Use r Interface and Comman d Reference MML Command R eferen ce MML Command Reference This sect ion desc ribe s th e fo llowing MM L co mmand s: • ack-alm • clr-alm • clr-meas • diaglog • h • help • pro v -add • prov-cpy • prov-dlt • pro v -ed ?[...]

  • Page 108

    A- 8 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendix A MML User Interf ace and C ommand Refe rence ack-alm • stp-call • stp-callpr oc • stp-softw • stp-trc ack-alm The ack-alm command ack now ledges that a n alarm e ven t is reco gnized b ut does n ot clea r the alarm. ack-alm:event= alarm even t Syntax Desc ripti on[...]

  • Page 109

    A-9 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix A MML Use r Interface and Comman d Reference clr- alm clr-alm The clr-alm command clea rs an alar m e vent. clr-alm:even t= al arm event Syntax Descript ion Usage Guid elines The alarm category must m atch th e form at sh ow n in th e alarm when the rt rv-alms command d [...]

  • Page 110

    A-10 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendix A MML User Interf ace and C ommand Refe rence diaglog Exam ples In this exampl e, a measurement cou nter , GK_DISC_A TT_TO T (Gatek eeper Discov ery Attempts ), is reset in the co unter gro up RAS: gw mml> clr-meas:RAS GW Signaling Interface 2000-12-05 14:19:22 M SUCC m[...]

  • Page 111

    A-11 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix A MML Use r Interface and Comman d Reference h h The h comma nd redi splays a c ommand or a se ries of comma nds. Item s displaye d depe nd on a specified number or ra nge. If no number is spec ified, only the last comma nd is display ed. h [:: start =numbe r [ , end =n[...]

  • Page 112

    A-12 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendix A MML User Interf ace and C ommand Refe rence help Exam ples Th e comm and s hown in the following example di splays he lp for a speci fic command: mml> help:rtrv-ctr H323 Signalling Gateway Tue Feb 12 19:09:58 2002 M SUCC RTRV-CTR -- Display the measurements for a coun[...]

  • Page 113

    A-13 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix A MML Use r Interface and Comman d Reference prov-a dd prov-add The pro v -add command adds a compone n t to the Cisco HSI. pro v -add:name= MML name , param name = par am val ue ,... Syntax Descript ion Usage Guid elines T o def ine more than one p arameter , enter add[...]

  • Page 114

    A-14 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendix A MML User Interf ace and C ommand Refe rence prov- cpy prov-cpy The pro v -cpy command acti v ates the current pro visioning session. I f any client-le vel pa rsing fails during the pr ov-cpy command, the sy stem might prompt fo r conf irmation to force t h e HSI t o acti[...]

  • Page 115

    A-15 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix A MML Use r Interface and Comman d Reference prov-dlt prov-dlt The pr ov-dlt comman d delet es a provisioned c omponent . It allows you to de lete a param eter rat her than deleting th e MML group. pro v -dlt:name= MML name pro v -dlt:name= MML name ,param= para m name [...]

  • Page 116

    A-16 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendix A MML User Interf ace and C ommand Refe rence prov- ed prov-ed The pro v -ed command mo difies a provisio ned compo nent . pro v -ed:name= MML name , par am name = param value ,... Note Enter on ly tho se pa ramet ers th at must be m odified. Syntax Desc ripti on Usage Gui[...]

  • Page 117

    A-17 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix A MML Use r Interface and Comman d Reference prov-e xp Relat ed Comma nds prov-exp The pro v-exp com mand export s the current provisione d configuration of t he Cisco HS I in MML comman d for m to a file. With this configuratio n file, y ou can prim e a syst em w ith a[...]

  • Page 118

    A-18 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendix A MML User Interf ace and C ommand Refe rence prov- rtrv Relat ed Comma nds prov-rtrv The prov-rtrv command retriev es information about an exis ting provisioni ng session. prov-rtrv:nam e= MML name prov-rtrv:all prov-rtrv:sessio n prov-rtrv:list Note Th e prov-rtrv: list [...]

  • Page 119

    A-19 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix A MML Use r Interface and Comman d Reference prov- rtr v Usage Guid elines See Chapter 3, “ Pro visi oning th e Cisc o HSI, ” for a lis t of MML name s, parame ter nam es and thei r associ ated va lues. Exam ples Th e p rov-rtrv comm and shown in the foll owing e xa[...]

  • Page 120

    A-20 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendix A MML User Interf ace and C ommand Refe rence prov- sta prov-sta The pro v-sta comman d establ ishes a provisio ning ses sion. Th e data f iles are copied from the source versio n to the d estination v ersion. pro v-st a::srcver= versio n ,dstver= version Syntax Desc ripti[...]

  • Page 121

    A-21 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix A MML Use r Interface and Comman d Reference prov-st p The M ML com mand shown in the following exa mple sta rts a provisioni ng sessi on, o pens th e existing configurati on na med ver1 , and saves the u pdated configuratio n as ve r 2 : gw mml> PROV-STA::SRCVER=&qu[...]

  • Page 122

    A-22 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendix A MML User Interf ace and C ommand Refe rence prov- stp Exam ples Th e MML command i n the fo llowing example te rminat es the cu rrent prov isioning session: gw mml> prov-stp:confirm H323 Signaling Interface Sun Jan 7 14:46:01 2001 M SUCC Successfully stopped provision[...]

  • Page 123

    A-23 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix A MML Use r Interface and Comman d Reference quit quit The quit comman d ends an MML sessio n. quit Syntax Descript ion Exam ples Th e co mman d in the foll owing examp le en ds an MML s ession . gw mml> quit radlog The radl og command star ts or stops RAD V ision lo[...]

  • Page 124

    A-24 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendix A MML User Interf ace and C ommand Refe rence restart -soft w restart-softw The restart-sof tw comma nd resta rts the cal l processin g applic ation. It applies th e provisioni ng data specif ied in the conf igV ersion (if present) that o verrides the ex isting acti ve pro[...]

  • Page 125

    A-25 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix A MML Use r Interface and Comman d Reference rtrv-a lms rtrv-alms The rtrv-a lms command r etrie ves all acti ve a larms. rtrv-a lms rtrv-a lms:c ont Syntax Descript ion Exam ples In the following exam ple, the output co ntain s the stan dard alarm definition and a lso [...]

  • Page 126

    A-26 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendix A MML User Interf ace and C ommand Refe rence rtrv-calls rtrv-calls The rtrv-cal ls command displa ys all acti ve ly connected calls. I f t he time elapsed p arameter is provided (in units of minutes), calls d isplay only if the y ex ceed the specified time. The output inc[...]

  • Page 127

    A-27 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix A MML Use r Interface and Comman d Reference rtrv-d est rtrv-dest The rtrv-dest command r etrieve s status i nformatio n about the IP links an d EISUP si gnalling pat h to the PGW 2200 . The outp ut produce d by this command shows the stat es of the H323 sig nalling gat[...]

  • Page 128

    A-28 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendix A MML User Interf ace and C ommand Refe rence rtrv-gap ping rtrv-gapping The rtrv-gapping command retri ev es inf ormati on abou t overload- triggere d cal l gapp ing. The follo w ing information displays: • The active or inact iv e sta tus of call gapping • The pe rce[...]

  • Page 129

    A-29 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix A MML Use r Interface and Comman d Reference rtrv- mml Exam ples In the followi ng exam ple, the command displ ays the logging le vels of all packages: gw mml> rtrv-log:all H323 Signaling Interface Thu Dec 14 16:28:44 2000 M RTRV Logging levels: Application........0x[...]

  • Page 130

    A-30 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendix A MML User Interf ace and C ommand Refe rence rtrv-ne Exam ples In the follow ing exampl e, the command display s all acti ve MML sessions, their sessio ns numbers, and the user IDs of the session or iginators. gw mml> rtrv-mml VSC H-323 Signaling Interface - H323-GW1 2[...]

  • Page 131

    A-31 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix A MML Use r Interface and Comman d Reference rtrv -over loa d Exam ples In the follo wing e xample , the comman d displ ays informa tion about the Cisco HSI statu s: gw mml> rtrv-ne-health VSC H-323 Signaling Interface - H323-GW1 2000-06-20 10:04:28 M RTRV CPU Load: [...]

  • Page 132

    A-32 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendix A MML User Interf ace and C ommand Refe rence rtrv-so ftw Relat ed Comma nds rtrv-softw The rt rv-soft w c omman d displays th e statu s of the Cisco HSI and call p rocessing ac tivity . The following soft ware st ates can be display ed for the C isco HSI: • Not runn ing[...]

  • Page 133

    A-33 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix A MML Use r Interface and Comman d Reference set-dest-state set-dest-state The set-dest- state comma nd ch ange s the s ervice state of an IP link or E-I SUP signali ng pat h to I S (in serv ice) or OOS (out of ser vice). set-dest- state :ipLink 1toVs cA:IS |OOS set-des[...]

  • Page 134

    A-34 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendix A MML User Interf ace and C ommand Refe rence set-gap ping set-gappin g The set-gapping comman d sets the typ e of calls to be gapped . set-gapping: inc | otg | bo th : calltype=normal | all, percent= numb er Syntax Desc ripti on Usage Guid elines If call gap ping is set t[...]

  • Page 135

    A-35 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix A MML Use r Interface and Comman d Reference set-log set-log The set-l og com mand se ts the logging l ev el of a pa ckag e or all packag es. set-log :packag e:level= level , [c onfi rm] set-log :all:level= level , [c onfir m] Syntax Descript ion Usage Guid elines Loggi[...]

  • Page 136

    A-36 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendix A MML User Interf ace and C ommand Refe rence set-overl oad set-overlo ad The set-overload comma nd de fines the overlo ad ha ndlin g crite ria a nd be havior . set-ov erload: lev el1|lev el2|leve l3:cpu,lower = number , upper= numb er set-ov erload: lev el1|lev el2|leve l[...]

  • Page 137

    A-37 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix A MML Use r Interface and Comman d Reference sta-cal lproc Relat ed Comma nds sta-callproc The sta-callpr oc command star ts call processi ng. sta-callpr oc Syntax Descript ion Exam ples In the follo wing e xample, the comm and starts call proc essing: gw mml> sta-so[...]

  • Page 138

    A-38 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendix A MML User Interf ace and C ommand Refe rence sta-trc Relat ed Comma nds sta-trc The sta-trc command starts t h e call processing trac ing functi on. sta-trc: Ca llty pe= calltype , T raceLeve l= trace le vel [,CdAddr ess= addr es s ] [,CgAddre ss= address ], log= file nam[...]

  • Page 139

    A-39 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix A MML Use r Interface and Comman d Reference stp-call Exam ples In the followi ng example , the command starts the call p rocessing tracing function: gw mml> sta-trc:Calltype=both, TraceLevel=terse, dAddress=012,CgAddress=013, log=tlog.txt, prd=10 H323 Signaling Inte[...]

  • Page 140

    A-40 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendix A MML User Interf ace and C ommand Refe rence stp-callp roc stp-callproc The stp-callproc command stop s further ca ll processin g by immediat ely termi nating t he handli ng of new call requests. stp-callpr oc[ :timeout=T ] Syntax Desc ripti on Exam ples In the follo wing[...]

  • Page 141

    A-41 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix A MML Use r Interface and Comman d Reference stp-t rc stp-trc The stp-trc comman d halts th e curren tly acti ve tra cing and c lo ses the trace fi le. stp-trc Syntax Descript ion This comm and ha s no a rguments o r keywords Exam ples In the followi n g exam ple, the c[...]

  • Page 142

    A-42 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendix A MML User Interf ace and C ommand Refe rence stp-trc[...]

  • Page 143

    B-1 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 APPEND IX B Skeleton Configuration File Provisiona ble an d co nfigurable data elem ents w ithi n the Cisco H .323 Signali ng In terface ( HSI) are grouped as dy namic, static, or co nstant data. Y ou c an modi fy d ynamic a nd sta tic d ata throu gh the provisioni ng MM L co mman[...]

  • Page 144

    B-2 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendi x B Skeleton Conf igurat ion File #****** sys_co nfig_static * ****** ****** ********** * #Static SYS_CONFIG_ST A TIC Nodeid S STRING SYS_CONFIG_ST A TIC HOST_POR T_NUMBE R1 S [0- 65535] SYS_CONFIG_ST A TIC HOST_POR T_NUMBE R2 S [0- 65535] SYS_CONFIG_ST A TIC HOST_IP ADDR 1 [...]

  • Page 145

    B-3 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix B Skeleton Configu ration File SYS_CONFIG_ST A TIC CC_ EC_Bl acklist BNumbe rMatche d S STRING SYS_CONFIG_ST A TIC CC_ EC_BlacklistCliLen gthIn valid S STRING SYS_CONFIG_ST A TIC CC_ EC_BlacklistCliMa tched S STRING SYS_CONFIG_ST A TIC CC_ EC_BlacklistCpcRestricte d S ST[...]

  • Page 146

    B-4 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendi x B Skeleton Conf igurat ion File SYS_CONF IG_ST A TIC CC _EC_Pre emption CctUnavailable S STRING SYS_ CONF IG_ ST A TIC CC_E C_Pr efix0 Dialled InErro r S ST RI NG SYS_ CONF IG_ ST A TIC CC_E C_Pr efix1 Dialled InErro r S ST RI NG SYS_CONFIG _ST A TIC CC_EC_Pr efix1NotDiall[...]

  • Page 147

    B-5 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix B Skeleton Configu ration File #****** s ystem **** ******* ********* **** #Static H323_SYS cid Associat e S NULL H323_SYS vtNodeCount S [0-65535] H323_SYS ch annels S [0-65 535] H323_SYS messag es S [0-6553 5] H323_SYS pktChans S [ 0-6553 5] H323_SYS pr otoc ols S [0-6 [...]

  • Page 148

    B-6 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendi x B Skeleton Conf igurat ion File SYS_CONFIG_D YNAMI C Ovl dLevel2Th reshU pp erCP U D [0-1 00] SYS_CONFIG_D YNAMI C OvldLe vel3Percent D [0-100 ] SYS_CONFIG_D YNAMI C Ovl dLevel3F ilt er D STRING SYS_CONFIG_D YNAMI C Ovl dLevel3Th reshL owerCa lls D [ 1-5000 ] SYS_CONFIG_D [...]

  • Page 149

    B-7 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix B Skeleton Configu ration File #****** q 931 * ******* ****** ******* *** #Dynam ic Q931 respons eT imeOut D [1-200 ] Q931 connectT imeOut D [1-20 000] Q931 callSignalingPor t D [0 -65535 ] Q931 maxCal ls D [0-5 000] Q931 notEstablishControl D NULL Q931 ov erlappe dSen d[...]

  • Page 150

    B-8 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendi x B Skeleton Conf igurat ion File H245 caps.table[i ].audio. g7231.ma xAudi oFrames D [1- 256] H245 caps.table[i]. audio.g72 31.sil enceSupp ression D [1-256] H245 chan [i]. name D STRING H245 chan[i ].audi o.g711 Alaw64k D [1-25 6] H245 chan[i ].audi o.g711 Alaw56k D [1-25 [...]

  • Page 151

    B-9 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix B Skeleton Configu ration File Logging F ault Man ager D [0-65535] Logging Gapping D [0-6553 5] Logging H323 D [0 -65535 ] Logging In frastructure D [0 -65535 ] Logging Overlo ad D [0 -65535 ] Logging Pro cessMan ager D [0-65 535] Logging Pro visioning D [0- 65535] Loggi[...]

  • Page 152

    B-10 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendi x B Skeleton Conf igurat ion File CCP ackage A_CC_BNumDataN O A D [] CCP ackage A_CC_BNumDataN PI C [] CCP ackage A_CC_BNumDataI NN D [] CCP ackage A_CC_ANumDataNO A D [] CCP ackage A_CC _Clir D [] CCP ackage A_CC_ANumDataSI D [] CCP ackage A_CC_ANumDataNPI C [] CCP ackage [...]

  • Page 153

    B-11 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix B Skeleton Configu ration File CCP ackage A_CC_NUM_REL_RETRI ES C [] CCP ackage A_CC_W AI T_REL_RET R Y C [] CCP ackage A_CC_W AIT_RLC_F AIL C [] # Cause c ode map CCPackage CC_EC_Unallocate dNumbe r C STRING CCPackage CC_EC_No RouteT oTns C STRING CCPackage CC_EC_NoRou[...]

  • Page 154

    B-12 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendi x B Skeleton Conf igurat ion File CCP acka ge CC_EC _Preced enceB lock ed C ST RI NG CCP ackage CC_EC _Res our cesU na v ail Unspe c C ST RI NG CCPackage CC_EC_Quality Unav ail C ST RI NG CCPackage CC_EC_ReqFacilityNotSu bscr C ST RI NG CCP ackage CC_ EC_Out goingCa llsBa r[...]

  • Page 155

    B-13 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix B Skeleton Configu ration File CCP ackage CC_HC _Misd iale dT runkPr ef ix C STR ING C C Pa c k a g e C C _ H C _ C h a n n e l U na c c e p t a b l e C STR ING CCP ackage C C_HC _Cal lA war dedE stabl ished Chan nel C STRING C C P a c k a g e C C _ H C _ P r e e m p t [...]

  • Page 156

    B-14 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendi x B Skeleton Conf igurat ion File CCPacka ge CC_HC_BearerCapabilityNo tImplemented C ST RING CCPackage CC_HC_ChannelT ypeNotIm pleme nted C STRING CCP ackage CC _HC_Requ estedF acilityNotIm plemen ted C STRING CCPacka ge CC_HC_ OnlyRestrict e dDigitalBear erInfoCapabili ty [...]

  • Page 157

    B-15 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix B Skeleton Configu ration File # # Priori ty treatment determines t h e treatme nt of prior ity calls # during gappi ng. # GapAl ways i ndicates priority ca lls are t reated as n ormal calls # GapNe ver indicate p riority c alls are ne ver to be g apped # GapOn100Pe rce[...]

  • Page 158

    B-16 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendi x B Skeleton Conf igurat ion File T race T r igger2 .h323. CalledPartyN umber C STRING T race T r igger2 .h323.O riginat ingIP Address C STRING T race T r igger2 .h323. Originat ingIPMa sk C STRING T race T r igger2 .h323. T erminatin gIP A ddress C STRING T race T r igger2[...]

  • Page 159

    B-17 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix B Skeleton Configu ration File T race Tr i g g er Ga t e 2 C STR ING T race Tr i g g er Ga t e 3 C STR ING T race Tr i g g er Ga t e 4 C STR ING T race Tr i g g er Ga t e 5 C STR ING ## ## P ackag e EISUP ## # #The period for CISCO's R UDP timer manager in milli se[...]

  • Page 160

    B-18 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendi x B Skeleton Conf igurat ion File ## H323 maxT imers C [] H323 tickPerio d C [] H323 defaultSD Pt C STRING H323 overrideConfig S [0-1] H323 defaultRadLog S [0-4] ## ## Statistic s ## Statistics StatLogFil eName D STRING Statistics StatOutputT ime D [0-6 5535] # # T est entr[...]

  • Page 161

    C-1 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 APPEND IX C Example of an HSI Configuration File This append ix p resen ts a n examp le of an H SI co nfigurati on file. Note Th e configurat ion file does not contai n a comp lete lis t of all configurab le items . #ver ifie d # # $Id: GWmai n.bas e.conf ,v 1.6 2002/ 09/09 15: 27[...]

  • Page 162

    C-2 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendi x C Example of an HSI Confi guratio n File Conn ecti on = 0x 0000 #Connec tion = 0 xFF00 DataMa nager = 0 x0000 #Eisup = 0xFF00 Eisup = 0x 0000 FaultM anag er = 0x0000 Gapping = 0x0000 H323 = 0 x0000 Infrast ructur e = 0 x0000 Overl oad = 0x 0000 Proce ssM anag er = 0x 0000 [...]

  • Page 163

    C-3 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix C Example of an HS I Configurat ion File # Not modif iable at runtim e (Static Provisio nable Data) # Pa ckage = H323 _SYS # maxCall s = 2 500 max Chann els = 2 ######### ####### ###### ###### ####### ########## ###### ###### ####### ###### ####### ###### ## # Q931 RAD V[...]

  • Page 164

    C-4 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendi x C Example of an HSI Confi guratio n File #manualRe gistration = endpo intV endor .product ID = "Go ldW ing" endpoi ntV endor .t35Coun tryCode = 11 endpoi ntV endor .t35Exte nsion = 11 endpo intV endor .manufact urerCode = 9 timeT oLive = 600 rasPort = 0 #compar e[...]

  • Page 165

    C-5 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix C Example of an HS I Configurat ion File caps.t able[ 3].en tryNo = 728 caps.t able[ 3].au dio.g72 8 = 20 chan [1].n ame = g711A law64k chan [1].aud io.g 711Alaw6 4k = 20 chan [2].n ame = g711U law64k chan [2].aud io.g 711Ulaw6 4k = 20 chan [3].n ame = g728 chan [3].aud [...]

  • Page 166

    C-6 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendi x C Example of an HSI Confi guratio n File A_CC_tEc hoCancI r = A_CC_t LineAccess = A_CC_BNu mDataNO A = # Called PN A_CC_BNu mDataNPI = A_CC_BNumDa taINN = A_CC_AN umD ataN O A = # Ca llingP N A_CC_Clir = A_CC_ANumDa taSI = A_CC_ANumDa taNPI = A_CC_A_Cli = A_CC_oLinecall = [...]

  • Page 167

    C-7 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix C Example of an HS I Configurat ion File # CC: Call Control, EC: Eisup Cause, HC: H323 Cause # For th e H323 cau se code value s s ee ITU -T : Q.8 50 # The mapping s below are consi dered co nstant and not provisiona ble. # They can be mad e provisionable by mo ving th e[...]

  • Page 168

    C-8 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendi x C Example of an HSI Confi guratio n File CC_E C_Nor malUnspe cif ied = CC_HC_N ormalUnspecified CC_EC_NoCircuitA vailab le = CC_ HC_N oCircuit Chan nelA vailable CC_EC_ NetworkO utOfO rder = CC_HC_Net workOutOfO rder CC_EC_P ermane ntFrameM odeOos = CC_HC_P ermane ntFrameM[...]

  • Page 169

    C-9 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix C Example of an HS I Configurat ion File CC_EC_Msg T ypeNotImpOrW rongState = CC_HC_M essageT ypeNotC ompati bleW ithStat eOrNo nExistant OrNo tImplem ented CC_EC_El emT ypeNotI mp = CC_HC_I nformat ionElem entParamet erNonE xistant OrNotIm pleme nted CC_EC_I n validE le[...]

  • Page 170

    C-10 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendi x C Example of an HSI Confi guratio n File CC_HC_N oCircuitC hannel A v ailable = CC_EC_No CircuitA vailable CC_ HC_N etwor kOut OfO rder = CC_EC_Net workOutOf Order CC_HC_Pe rmanentFra meMod eConnec tionOut OfService = CC _EC_Perma nentFr ameModeO os CC_HC_Pe rmanentFra me[...]

  • Page 171

    C-11 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix C Example of an HS I Configurat ion File CC_HC_In forma tionE lemen tParameter NonE xistan tOrNot Implem ented = CC _EC_E lemT ypeNot Imp CC_HC_In validI nformationElementContents = CC_EC _In v alidE lemConte nts CC_HC_MessageNotCompatibleW ithCallState = CC _EC_M sgInW[...]

  • Page 172

    C-12 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendi x C Example of an HSI Confi guratio n File # GapOn100Pe rcent Gap ping indic ates prior ity calls ar e only gapped when 100 percen t # gapping is appli ed. # #Priorit yCallTreatment = GapO n100Perc entGap ping #PriorityCall Treatment = Gap Nev er Prio ri tyC all Treatm ent [...]

  • Page 173

    C-13 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix C Example of an HS I Configurat ion File T r igger2 .eisup. CalledPart yNumbe r=190 0 #T rigger 2.h323 .Call ingPartyNum ber= 0299 #T rigger 2.h323 .Call edPartyNu mber=03 88 #T rigger 2.h323 .Orig inating IP Add ress= 203.188.2 .3 #T rigger 2.h323 .Orig inating IPMask [...]

  • Page 174

    C-14 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendi x C Example of an HSI Confi guratio n File # T r igge rGat e1=ON T r igge rGat e2=ON T r igge rGat e3=ON T r igge rGat e4=ON T r igge rGat e5=ON ######### ####### ###### ###### ####### ########## ###### ###### ####### ###### ####### ###### ## # EISUP P A CKAGE # # Pa ckage [...]

  • Page 175

    C-15 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix C Example of an HS I Configurat ion File ######### ####### ###### ###### ####### ########## ###### ###### ####### ###### ####### ###### ## # D YNA MIC SYSTEM D A T A # # Pa ckage = SYS_CO NFIG_D YN AMIC # # Alter nate Ga tekeeper AL TE RNA T EGA TEK EEPER IP = " &q[...]

  • Page 176

    C-16 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendi x C Example of an HSI Confi guratio n File O VLDLEVEL2 FIL TER = "NORMAL" #Choic e {"NORMAL", "AL L"}. Def ault: "NORMAL " O VLDLEVEL2THRESHUPPERCPU = 80 #Default: 100 O VL DLEV EL2THR ESHLOWERC PU = 7 0 #Def ault: 100 O VLDLEVE L2THR[...]

  • Page 177

    C-17 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix C Example of an HS I Configurat ion File CC_EC_BlacklistBNumber Matched = CC_ HC_DEF A UL T CC_EC_BlacklistCliLen gthIn valid = CC_HC_DEF A UL T CC_EC_BlacklistCliMatch ed = CC_HC _DEF A UL T CC_EC_BlacklistCpcRestrict ed = C C_HC_ DEF A UL T CC_EC_BlacklistNoCli = CC_H[...]

  • Page 178

    C-18 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendi x C Example of an HSI Confi guratio n File CC_EC_PreemptionCctUn av ailable = CC_H C_DEF A UL T CC_E C_Pr ef ix0Dial ledI nError = CC_HC_DEF A UL T CC_E C_Pr ef ix1Dial ledI nError = CC_HC_DEF A UL T CC_E C_Pref ix1No tDi alle d = CC_HC_DEF A UL T CC_E C_Pri orit yF orcedR [...]

  • Page 179

    C-19 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix C Example of an HS I Configurat ion File # T38 Fa x default configuratio n # T38Max V al = " MaxBi t 0x90, FxMaxBu f 0xc8, FxMaxD ata 0 x48" T38Opti ons = "FxFillBit 0, FxT ra nsMMR 0, FxTransJBIG 0, FxRate Trans, FxUdpEC Red " # # # EISUP Se ttings [...]

  • Page 180

    C-20 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendi x C Example of an HSI Confi guratio n File[...]

  • Page 181

    D- 1 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 APPEND IX D E-ISUP Name-to - Cause Value Lookup This a ppend ix list s the Cisco E -ISUP prot ocol nam es an d thei r assoc iated c ause values. Name Value ----- ----- CC_EC_AccessBarred 54 CC_EC_AccessInfoDiscarded 1 CC_EC_Acknowledgement 55 CC_EC_AddressIncomplete 56 CC_EC_Anon[...]

  • Page 182

    D- 2 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendix D E-I SUP Name-to- Cause Valu e Lookup CC_EC_IncomingCallsBarred 63 CC_EC_IncomingCallsBarredInCug 81 CC_EC_IncompatibleDest 15 CC_EC_InconOutgoingAccAndSubClass 126 CC_EC_InterceptedSubscriber 53 CC_EC_InterworkUnspec 16 CC_EC_InvalidCallRef 143 CC_EC_InvalidCallReference[...]

  • Page 183

    D-3 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix D E-ISUP Name-to-Caus e Value Lookup CC_EC_ReqCircuitUnavail 41 CC_EC_ReqFacilityNotImp 42 CC_EC_ReqFacilityNotSubscr 43 CC_EC_ResourcesUnavailUnspec 44 CC_EC_ResponseToStatusEnquiry 45 CC_EC_RouteOutOfService 71 CC_EC_RoutingError 93 CC_EC_SelectiveCallBarring 104 CC_EC[...]

  • Page 184

    D- 4 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendix D E-I SUP Name-to- Cause Valu e Lookup[...]

  • Page 185

    E-1 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 APPEND IX E E-ISUP Cause Value-to-Name Lookup This appendix lists the Cisco E-I SUP cause va lues and their associated names. Value Name ----- ---- 1 CC_EC_AccessInfoDiscarded 2 CC_EC_BearcapNotAuthorized 3 CC_EC_BearcapNotAvail 4 CC_EC_BearcapNotImp 5 CC_EC_CallAwardedDeliveredEs[...]

  • Page 186

    E-2 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendi x E E-ISUP Cause Val ue-to-N ame Lookup 42 CC_EC_ReqFacilityNotImp 43 CC_EC_ReqFacilityNotSubscr 44 CC_EC_ResourcesUnavailUnspec 45 CC_EC_ResponseToStatusEnquiry 46 CC_EC_ServiceOrOptionNotImpUnspec 47 CC_EC_ServiceOrOptionNotAvail 48 CC_EC_SuspendExistButNotThisId 49 CC_EC_[...]

  • Page 187

    E-3 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 Append ix E E-ISUP Cause Value -to-Name L ookup 106 CC_EC_TemporaryOos 107 CC_EC_OperatorPriorityAccess 108 CC_EC_CugAccessBarred 109 CC_EC_SubscriberCallTerminate 110 CC_EC_FlowControlledCongestion 111 CC_EC_OutOfCatchmentArea 112 CC_EC_TranslationOos 113 CC_EC_PermanentIcb 114 C[...]

  • Page 188

    E-4 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendi x E E-ISUP Cause Val ue-to-N ame Lookup[...]

  • Page 189

    F-1 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 APPEND IX F H.323 Name-to-Cause Value Lookup This a ppend ix list s the H.323 names and their a ssociat ed ca use values. Name Value ---- ----- CC_HC_ASuspendedCallExistsThisCallIdDoesNot 83 CC_HC_AccessInformationDiscarded 43 CC_HC_BearerCapabilityNotAuthorized 57 CC_HC_BearerCap[...]

  • Page 190

    F-2 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendix F H.323 Nam e-to-Cau se Value Loo kup CC_HC_NumberChanged 22 CC_HC_OnlyRestrictedDigitalBearerInfoCapability 70 CC_HC_OutgoingCallsBaredWithinCUG 53 CC_HC_ParameterNonExistantOrNotImplementedPassedOn 103 CC_HC_PermanentFrameModeConnectionOperational 40 CC_HC_PermanentFrameM[...]

  • Page 191

    G- 1 Cisco H.323 Sign aling Interfa ce User Guide OL-4806-01 Rev. A14 APPEND IX G H.323 Cause Value-to-Name Lookup This appen dix lists the H.32 3 cause v a lues and their associate d names. Value Name ----- ---- 1 CC_HC_UnallocatedNumber 2 CC_HC_NoRouteToSpecifiedTransitNetwork 3 CC_HC_NoRouteToDestination 4 CC_HC_SendSpecialInformationTone 5 CC_H[...]

  • Page 192

    G- 2 Cisco H.323 Signaling Interface User Guide OL-4806-01 Rev. A14 Appendi x G H.323 Cause Value- to-Name Lookup 63 CC_HC_ServiceOrOptionUnavailable 65 CC_HC_BearerCapabilityNotImplemented 66 CC_HC_ChannelTypeNotImplemented 69 CC_HC_RequestedFacilityNotImplemented 70 CC_HC_OnlyRestrictedDigitalBearerInfoCapability 79 CC_HC_ServiceOrOptionNotImplem[...]

  • Page 193

    IN-3 Cisco H.323 Sign aling Int erface User Gui de OL-4806-01 Rev. A14 INDEX A ack-al m c omma nd A-8 acknow ledgi ng alarm s 5-4 active log file 4-9 ALARMDE BOUNCETIM E p arame ter 5-1 alar m mess ages continou s mode 5-3 nonco ntinuous m ode 5-3 alarm s acknow ledgi ng 5-4 cleared state 5-4 clearin g 5-4 CONFIG_CHANGE 5-11 CONFIGURAT ION_FAIL URE[...]

  • Page 194

    Index IN-4 Cisco H.3 23 Signal ing Inter face User Gu ide OL-4806-01 Rev. A14 CIAGEN TSCANPERIOD p arameter 4-2 Cisco HSI See HSI clear ing al arms 5-4 clr- alm comman d 5-4, A-8 clr- meas comm and 4-6, A-9 codec pa rame ters 3-15 comm ands ack-al m A- 8 clr- alm 5-4, A -8 clr- mea s 4-6, A-9 diaglog A-4, A-10 h A- 10 help A-6 , A-11 MML config ura[...]

  • Page 195

    Inde x IN-5 Cisco H.323 Sign aling Int erface User Gui de OL-4806-01 Rev. A14 dynam ic B-1 provisi onable B- 1 static B-1 debounc e 5-1 default active l og file 4-9 detailed logging 5-16 diaglog co mman d A-4 , A-10 documen tatio n related xiv documen t conv en tions xi ii dynam ic config urati on data 3-1 system data para meters 3-6 E E-ISU P over[...]

  • Page 196

    Index IN-6 Cisco H.3 23 Signal ing Inter face User Gu ide OL-4806-01 Rev. A14 HSI INFORMATI ON Message Support 3-19 HSI Su pport for T ech Prefixe s 3-19 installing previo us versi on 2-12 proc edures 2-2 required informa tion 2-3 subdirecto ries 2-4 MML sessions, configuring A-1 overvi ew 1-1 perfo rma nce and s izing 1-5 preinstall ation tasks 2-[...]

  • Page 197

    Inde x IN-7 Cisco H.323 Sign aling Int erface User Gui de OL-4806-01 Rev. A14 syntax A-2 MML c onfigur ation com mands comp onent 3-2 expor t 3-2 session 3-2 MML response messages erro r A-5 status A-5 MML sessions config uring A-1 help A-6 quitting A-6 starting A-3 N noncont inuous m ode alarm message s 5-3 nonpro visionabl e data par ameters 3-9 [...]

  • Page 198

    Index IN-8 Cisco H.3 23 Signal ing Inter face User Gu ide OL-4806-01 Rev. A14 OVLDLEVE L3PERCEN T 4- 7 OVLDL EVEL3TH RESHLOWER CPU 4-7 OVLDLEVE L3THRESHUPPE RCALLS 4-7 OVLDL EVEL3TH RESHUPP ERCPU 4-7 Q.931 3-10 RAS 3-11 PGW 2200 descript ion 1-2 PKINST file 2-9, 2-12 protoc ols E-ISU P 1-4 H.225 1-4 Q.931 1-4 RUDP 1-4 prov-add com mand 3-3, 3-6, 3-[...]

  • Page 199

    Inde x IN-9 Cisco H.323 Sign aling Int erface User Gui de OL-4806-01 Rev. A14 signaling int erface See HSI Sim ple Netw ork Ma nageme nt Pr otocol See SNMP skeleton conf igurat ion f ile 3-2 SNMP manager 5-2 MIB 4-3 subagent 2-11, 4-2 trap types 5-2 soft ware re quirem ents 1-5 Solaris 8 oper ating system installati on 2-1 plat form requ iremen ts [...]