For final production, import color definitions from docs/Routers/Omniaccess 5510/OmniAcc… · save...

1034
Beta 1 2 Notes on numbered items on banner & legal pages 1 Manu26801 West Agoura Road Calabasas, CA 91301 (818) 880-3500 FAX (818) 880-3505 [email protected] US Customer Support—(800) 995-2696 International Customer Support—(818) 878-4507 Internet—service.esd.alcatel-lucent.com Website: www.alcatel-lucent.com Part No: 060286-00, Rev B For final production, import color definitions from \\daldoc01\docteam\templates\framemaker\book-template\color-defs\ production-colors.fm. OmniAccess 5510 Unified Services Gateway CLI Command Reference Guide Release 3.0

Transcript of For final production, import color definitions from docs/Routers/Omniaccess 5510/OmniAcc… · save...

1

For final production, import color definitions from\\daldoc01\docteam\templates\framemaker\book-template\color-defs\ production-colors.fm.

OmniAccess 5510Unified Services Gateway

CLI Command Reference Guide

2

Release 3.0

Beta

Notes on numbered items on banner & legal pages1 Manu26801 West Agoura Road

Calabasas, CA 91301

(818) 880-3500

FAX (818) 880-3505

[email protected]

US Customer Support—(800) 995-2696

International Customer Support—(818) 878-4507

Internet—service.esd.alcatel-lucent.com

Website: www.alcatel-lucent.com

Part No: 060286-00, Rev B

34

5

This command reference guide documents release 3.0 of the OmniAccess 5510-AA/AB USG, OmniAccess 5510-SR USG, and OmniAccess 5510-TE USG. The

functionality described in this guide is subject to change without notice.

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 SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE.

This equipment has been tested and found to comply within the limits pursuant to the (Centre for Telecom) rules. These limits are designed to provide protection against harmful interference when the equipment is operated in a commercial environment.

The following information is for the Users of the OmniAccess 5510 Unified Services Gateway: If it is not installed in accordance with the installation instructions, it may not function exactly to the said specifications. Modifying the equipment without Alcatel-Lucent’s written authorization may result in the equipment no longer complying with the said dimensions.

Copyright © 2010, Alcatel-Lucent. All rights reserved. Alcatel-Lucent and Alcatel-Lucent logo are registered trademarks of Alcatel-Lucent. The contents or specifications contained within this document are subject to change without notice.

Not withstanding any other warranty herein, all hardware and software are provided "as is" with all faults. Alcatel-Lucent disclaim all warranties, expressed or implied, including, without limitation, those of merchantability, fitness for a particular purpose and non-infringement or arising from a course of dealing, usage, or trade practice. In no event shall Alcatel-Lucent be liable for any indirect, special, consequential, or incidental damages, including, without limitation, lost profits or loss or damage to data arising out of the use or inability to use this manual, even if Alcatel-Lucent have been advised of the possibility of such damages.

Table of Contents

1 Preface.............................................................................................................1About This Guide ......................................................................................................................1Supported Platforms .................................................................................................................1Audience ...................................................................................................................................1Organization..............................................................................................................................2Document Conventions.............................................................................................................7Obtaining Documentation..........................................................................................................8Reference Publications .............................................................................................................8Obtaining Technical Assistance ................................................................................................9Documentation Feedback .........................................................................................................9

Part 1: Introduction

2 Using the Command Line Interface ............................................................13CLI Overview...........................................................................................................................13backup interface......................................................................................................................14clear counters..........................................................................................................................14configure terminal....................................................................................................................15controller .................................................................................................................................18enable .....................................................................................................................................19interface atm <port>.<subinterface-id> ...................................................................................21interface <name> <interface-number>....................................................................................22interface <name> <port>.........................................................................................................23interface Serial <port:channel> ...............................................................................................24interface Serial <port:subinterface-id> ....................................................................................25interface <name> <port:subinterface-id> ................................................................................26interface Serial <port:channel.subchannel>............................................................................27interface Serial <port:subinterface-id> ....................................................................................28ip address................................................................................................................................29mtu ..........................................................................................................................................29no backup interface.................................................................................................................30no shutdown............................................................................................................................30show........................................................................................................................................30show history ............................................................................................................................32show interfaces brief ...............................................................................................................33show interfaces .......................................................................................................................34show ip interfaces brief ...........................................................................................................36shutdown.................................................................................................................................36

3 System Configuration and Monitoring .......................................................37aaa authentication console .....................................................................................................38aaa authentication enable .......................................................................................................38

aaa authentication remotelogin ...............................................................................................39aaa authentication web ...........................................................................................................39aaa authentication password-prompt ......................................................................................40aaa authentication username-prompt .....................................................................................40aaa pre-authentication banner ................................................................................................41aaa login-success banner .......................................................................................................42aaa login-fail banner................................................................................................................43aaa method-list........................................................................................................................44aaa services............................................................................................................................44aaa server-group radius ..........................................................................................................45aaa server-group tacacs .........................................................................................................46certificate.................................................................................................................................47clear known_hosts ..................................................................................................................48clear logging............................................................................................................................48clear session ...........................................................................................................................49clock set ..................................................................................................................................49clock synchronize....................................................................................................................50clock timezone ........................................................................................................................51copy.........................................................................................................................................52delete all..................................................................................................................................53delete config-file ......................................................................................................................53delete fp-key............................................................................................................................54delete user ..............................................................................................................................54dir ............................................................................................................................................55enable secret...........................................................................................................................56hostname ................................................................................................................................56http ..........................................................................................................................................57https ........................................................................................................................................57import ca-cert ..........................................................................................................................58import signed-cert ...................................................................................................................59line console baudrate ..............................................................................................................60line console exec-timeout........................................................................................................60line vty exec-timeout ...............................................................................................................61list config-files..........................................................................................................................61load config-file .........................................................................................................................62logging buffered ......................................................................................................................62logging console .......................................................................................................................63logging on................................................................................................................................63logging rate-limit......................................................................................................................64logging rate-limit unique ..........................................................................................................65logging rate-limit no unique.....................................................................................................65logging remote ........................................................................................................................66logging system ........................................................................................................................67logging watermark...................................................................................................................67mkdir .......................................................................................................................................68no aaa authentication banner..................................................................................................68

no aaa authentication fail-message ........................................................................................68no aaa authentication password-prompt .................................................................................68no aaa authentication success-message ................................................................................68no aaa authentication username-prompt ................................................................................69no aaa services .......................................................................................................................69no aaa authentication console ................................................................................................69no aaa authentication enable ..................................................................................................69no aaa authentication remotelogin ..........................................................................................69no aaa authentication web ......................................................................................................69no aaa method-list...................................................................................................................69no aaa server-group radius .....................................................................................................69no aaa server-group tacacs ....................................................................................................70no certificate............................................................................................................................70no clock synchronize...............................................................................................................70no clock timezone ...................................................................................................................70no enable-authentication.........................................................................................................70no line console exec-timeout...................................................................................................70no line vty exec-timeout ..........................................................................................................71no logging buffered .................................................................................................................71no logging console ..................................................................................................................71no logging on...........................................................................................................................71no logging rate-limit.................................................................................................................71no logging remote ...................................................................................................................71no logging system ...................................................................................................................71no logging watermark..............................................................................................................71no radius-server ......................................................................................................................72no radius-server auth-port.......................................................................................................72no radius-server deadtime ......................................................................................................72no radius-server key................................................................................................................72no radius-server retransmit .....................................................................................................72no radius-server timeout .........................................................................................................72no service timestamps log.......................................................................................................72no snmp agent ........................................................................................................................73no snmp-server access ...........................................................................................................73no snmp-server group .............................................................................................................73no snmp-server user ...............................................................................................................73no snmp-server view...............................................................................................................73no snmp system......................................................................................................................73no snmp trap ...........................................................................................................................73no snmp trap enable ...............................................................................................................73no tacacs-server......................................................................................................................74no tacacs-server auth-port ......................................................................................................74no tacacs-server key ...............................................................................................................74no tacacs-server timeout.........................................................................................................74no username ...........................................................................................................................74package backup......................................................................................................................75

package install ........................................................................................................................76package install flash................................................................................................................78package remove......................................................................................................................79ping .........................................................................................................................................81radius-server ...........................................................................................................................82radius-server auth-port............................................................................................................83radius-server deadtime ...........................................................................................................83radius-server key.....................................................................................................................84radius-server retransmit ..........................................................................................................84radius-server timeout ..............................................................................................................85reload ......................................................................................................................................85reload factory defaults.............................................................................................................86rmdir ........................................................................................................................................87save running-config.................................................................................................................87save running-config file-name.................................................................................................88save logging ............................................................................................................................88save logging file name ............................................................................................................89save logging priority ................................................................................................................89save logging string ..................................................................................................................90save logging tag ......................................................................................................................90service timestamps log............................................................................................................91show aaa.................................................................................................................................92show aaa-client-methodlist-associations.................................................................................92show aaa-local-users-details...................................................................................................93show aaa-methodlists .............................................................................................................93show aaa-radius......................................................................................................................94show aaa-tacacs .....................................................................................................................94show aaa-users.......................................................................................................................95show access-server status......................................................................................................95show config-file .......................................................................................................................96show certificate ca-cert ...........................................................................................................98show certificate identity .........................................................................................................100show certificate signed-cert...................................................................................................101show chassis.........................................................................................................................103show clock.............................................................................................................................103show inband sessions ...........................................................................................................104show logging .........................................................................................................................105show logging priority .............................................................................................................106show logging string ...............................................................................................................107show logging tag ...................................................................................................................107show memory........................................................................................................................108show packages .....................................................................................................................109show processes ....................................................................................................................110show running-config ..............................................................................................................112show snmp............................................................................................................................113show snmp access................................................................................................................113

show snmp details.................................................................................................................114show snmp group..................................................................................................................115show snmp stats ...................................................................................................................116show snmp user ....................................................................................................................117show snmp view....................................................................................................................117show startup-config ...............................................................................................................118show tech-support.................................................................................................................119show version .........................................................................................................................120snmp agent ...........................................................................................................................120snmp disable .........................................................................................................................121snmp enable..........................................................................................................................121snmp-server access ..............................................................................................................122snmp-server group................................................................................................................123snmp-server user ..................................................................................................................124snmp-server view..................................................................................................................125snmp system.........................................................................................................................125snmp trap ..............................................................................................................................126snmp trap enable ..................................................................................................................126ssh enable|disable ................................................................................................................127ssh.........................................................................................................................................127tacacs-server.........................................................................................................................128tacacs-server auth-port .........................................................................................................129tacacs-server key ..................................................................................................................129tacacs-server timeout............................................................................................................130telnet enable|disable .............................................................................................................131telnet .....................................................................................................................................131terminal length.......................................................................................................................132terminal monitor ....................................................................................................................133traceroute ..............................................................................................................................133username password..............................................................................................................134write erase.............................................................................................................................134

4 Virtual Router Redundancy Protocol........................................................135debug vrrp control .................................................................................................................136debug vrrp management .......................................................................................................136interface ................................................................................................................................137no vrrp group-id.....................................................................................................................137no vrrp group-id IP ................................................................................................................137no vrrp group-ID ip ip-address secondary.............................................................................137no vrrp group-id preempt.......................................................................................................137no vrrp group-id priority .........................................................................................................138no vrrp group-id timers advertise ..........................................................................................138no vrrp group-id timers learn .................................................................................................138no vrrp group-id track-interface .............................................................................................138show vrrp all ..........................................................................................................................139show vrrp interface................................................................................................................140

vrrp group-id authentication text............................................................................................141vrrp group-id description .......................................................................................................142vrrp group-ID ip-address .......................................................................................................142vrrp group-id IP ip-address secondary ..................................................................................143vrrp group-id preempt............................................................................................................143vrrp group-id priority value ....................................................................................................144vrrp group-id timers advertise ...............................................................................................145vrrp group-id timers learn ......................................................................................................146vrrp group-id track-interface ..................................................................................................147

Part 2: LAN Interfaces and Configuration

5 Fast Ethernet Interface...............................................................................151clear counters........................................................................................................................152clear counters........................................................................................................................152duplex....................................................................................................................................153encapsulation dot1q..............................................................................................................154interface ................................................................................................................................155interface <name> ..................................................................................................................155ip address..............................................................................................................................156mtu ........................................................................................................................................156no duplex...............................................................................................................................157no encapsulation dot1q.........................................................................................................157no mtu ...................................................................................................................................157no speed ...............................................................................................................................157show......................................................................................................................................158show interfaces .....................................................................................................................160speed ....................................................................................................................................161

6 Switching on L2 Ports................................................................................163clear lan counters..................................................................................................................164clear mac-address-table dynamic .........................................................................................164duplex....................................................................................................................................165interface switchport ...............................................................................................................165no duplex...............................................................................................................................165no shutdown..........................................................................................................................165no speed ...............................................................................................................................166no switchport access vlan .....................................................................................................166no switchport hybrid native vlan ............................................................................................166no switchport mode ...............................................................................................................166no switchport trunk allowed vlan ...........................................................................................166no switchport trunk allowed vlan range.................................................................................166show interfaces .....................................................................................................................167show lan counters .................................................................................................................168show mac-address-table .......................................................................................................169

show vlan ..............................................................................................................................170shutdown...............................................................................................................................170speed ....................................................................................................................................171switchport access vlan ..........................................................................................................171switchport hybrid native vlan .................................................................................................172switchport mode....................................................................................................................172switchport trunk allowed vlan ................................................................................................173switchport trunk allowed vlan range ......................................................................................173

7 Spanning Tree Protocol .............................................................................175no spanning-tree enable .......................................................................................................176no spanning-tree cost............................................................................................................176no spanning-tree fwd-time/hello-time/max-age/priority .........................................................176no spanning-tree port-priority ................................................................................................176no spanning-tree spanning-disabled .....................................................................................176show spanning-tree...............................................................................................................177show spanning-tree brief.......................................................................................................178show spanning-tree summary ...............................................................................................179spanning-tree ........................................................................................................................180spanning-tree cost.................................................................................................................180spanning-tree enable fwd-time/hello-time/max-age/priority ..................................................181spanning-tree port-priority .....................................................................................................182spanning-tree spanning-disabled ..........................................................................................182

8 Integrated Routing and Bridging ..............................................................183IRB CLI Commands ..............................................................................................................184interface vlan.........................................................................................................................184show interfaces vlan..............................................................................................................185

Part 3: WAN Interfaces and Protocols

9 ADSL (Asymmetric Digital Subscriber Line)............................................189cbr .........................................................................................................................................190clear counters........................................................................................................................190dsl operating-mode ...............................................................................................................191encapsulation ........................................................................................................................193interface atm .........................................................................................................................194interface atm <port>.<subinterface-id> .................................................................................195ip address..............................................................................................................................196mtu ........................................................................................................................................197no cbr ....................................................................................................................................198no encapsulation aal5-llc-snap..............................................................................................198no mtu ...................................................................................................................................198no pvc....................................................................................................................................198

no ubr ....................................................................................................................................198no ubr+..................................................................................................................................198no vbr-rt.................................................................................................................................198no vbr-nrt...............................................................................................................................198no shutdown..........................................................................................................................199pvc.........................................................................................................................................200show atm vc ..........................................................................................................................201show dsl interface atm ..........................................................................................................202show interfaces atm ..............................................................................................................203shutdown...............................................................................................................................204ubr .........................................................................................................................................205ubr+.......................................................................................................................................206vbr-rt......................................................................................................................................207vbr-nrt....................................................................................................................................208

10 Universal Serial Port (USP)........................................................................209clear counters........................................................................................................................210clockrate................................................................................................................................210crc .........................................................................................................................................211interface serial.......................................................................................................................211Invert txc................................................................................................................................212ip address..............................................................................................................................212loopback................................................................................................................................213encapsulation ........................................................................................................................213mtu ........................................................................................................................................214no clockrate...........................................................................................................................214no crc ....................................................................................................................................214no invert-txc...........................................................................................................................215no loopback...........................................................................................................................215no shutdown..........................................................................................................................215show interface .......................................................................................................................216shutdown...............................................................................................................................217

11 T1E1 Interface .............................................................................................219E1 CLI Commands................................................................................................................220card type ...............................................................................................................................220clocksource ...........................................................................................................................221channel-group .......................................................................................................................222controller ...............................................................................................................................223encapsulation ........................................................................................................................223framing ..................................................................................................................................224interface serial.......................................................................................................................224linecode.................................................................................................................................225line-termination......................................................................................................................225loopback................................................................................................................................226mtu ........................................................................................................................................227

no clocksource ......................................................................................................................227no channel group ..................................................................................................................227no encapsulation...................................................................................................................227no framing .............................................................................................................................227no linecode............................................................................................................................228no line-termination.................................................................................................................228no loopback...........................................................................................................................228no mtu ...................................................................................................................................228no shutdown..........................................................................................................................228show controller ......................................................................................................................229show interfaces .....................................................................................................................230shutdown...............................................................................................................................231T1 CLI Commands................................................................................................................232cablelength long....................................................................................................................232cablelength short...................................................................................................................233card type ...............................................................................................................................234channel-group .......................................................................................................................235clocksource ...........................................................................................................................236controller ...............................................................................................................................236encapsulation ........................................................................................................................237framing ..................................................................................................................................237interface serial.......................................................................................................................238linecode.................................................................................................................................238loopback................................................................................................................................239mtu ........................................................................................................................................240no cablelength.......................................................................................................................240no clocksource ......................................................................................................................240no channel-group ..................................................................................................................240no encapsulation...................................................................................................................240no framing .............................................................................................................................241no linecode............................................................................................................................241no loopback...........................................................................................................................241no mtu ...................................................................................................................................241no shutdown..........................................................................................................................241show controller ......................................................................................................................242show interfaces .....................................................................................................................243shutdown...............................................................................................................................244

12 Third Generation (3G) Wireless WAN Interface .......................................245change ..................................................................................................................................246dialer group ...........................................................................................................................247dialer idle-timeout..................................................................................................................248dialer in-band ........................................................................................................................249dialer-list................................................................................................................................250dialer string............................................................................................................................251encapsulation ppp.................................................................................................................252

gsm network-selection ..........................................................................................................253gsm plmn search...................................................................................................................254gsm plmn select ....................................................................................................................255gsm profile activate ...............................................................................................................256gsm profile create..................................................................................................................257gsm profile deactivate ...........................................................................................................258gsm profile delete..................................................................................................................259gsm sim.................................................................................................................................260interface cellular ....................................................................................................................261no dialer group ......................................................................................................................262no dialer idle-timeout.............................................................................................................262no dialer-list...........................................................................................................................262no rule ...................................................................................................................................262no shutdown..........................................................................................................................263renumber...............................................................................................................................263show cellular <port> all .........................................................................................................264show cellular <port> hardware ..............................................................................................266show cellular <port> network ................................................................................................267show cellular <port> profile ...................................................................................................268show cellular <port> radio .....................................................................................................269show cellular <port> security.................................................................................................270show dialer-list ......................................................................................................................271shutdown...............................................................................................................................272

13 High-level Data Link Control .....................................................................273debug hdlc all ........................................................................................................................274debug hdlc keepalive ............................................................................................................275encapsulation hdlc ................................................................................................................276hdlc keepalive .......................................................................................................................276hdlc down-when-looped ........................................................................................................277no debug hdlc........................................................................................................................277no encapsulation...................................................................................................................277no hdlc down-when-looped ...................................................................................................278no hdlc keepalive ..................................................................................................................278show interface .......................................................................................................................278

14 Frame Relay ................................................................................................281debug frame-relay .................................................................................................................282debug frame-relay all ............................................................................................................282encapsulation frame-relay.....................................................................................................283frame relay interface-dlci.......................................................................................................283frame-relay keepalive............................................................................................................284frame-relay lmi-type ..............................................................................................................284frame-relay lmi-n391dte ........................................................................................................285frame-relay lmi-n392dte ........................................................................................................285frame-relay lmi-n393dte ........................................................................................................286

no debug frame-relay ............................................................................................................286no encapsulation frame-relay................................................................................................286no frame-relay interface-dlci..................................................................................................286no frame-relay keepalive.......................................................................................................287no frame-relay lmi-type .........................................................................................................287no frame-relay lmi-n391dte ...................................................................................................287no frame-relay lmi-n392dte ...................................................................................................287no frame-relay lmi-n393dte ...................................................................................................287show frame-relay lmi .............................................................................................................288show frame-relay pvc ............................................................................................................289

15 Point to Point Protocol...............................................................................291debug ppp all.........................................................................................................................292debug ppp echo ....................................................................................................................293encapsulation ppp.................................................................................................................294no debug ppp ........................................................................................................................294no encapsulation ppp............................................................................................................294no ppp authentication............................................................................................................294no ppp authentication client-password..................................................................................294no ppp authentication client-username .................................................................................294no ppp authentication password ...........................................................................................295no ppp authentication username...........................................................................................295no ppp ipcp address accept-local..........................................................................................295no ppp ipcp address accept-peer..........................................................................................295no ppp ipcp address pool local..............................................................................................295no ppp lcp echo-interval ........................................................................................................296no ppp lcp max-echo.............................................................................................................296no ppp timeout max-configure...............................................................................................296no ppp timeout max-failure....................................................................................................296no ppp timeout max-terminate ..............................................................................................296no ppp timeout restart-interval ..............................................................................................297no ppp timeout restart-timer ..................................................................................................297ppp authentication.................................................................................................................297ppp authentication client-password.......................................................................................298ppp authentication client-username ......................................................................................298ppp authentication password ................................................................................................299ppp authentication username................................................................................................299ppp ipcp address accept-local...............................................................................................300ppp ipcp address accept-peer...............................................................................................300ppp ipcp address pool local...................................................................................................301ppp ipcp negotiate.................................................................................................................301ppp lcp echo-interval .............................................................................................................302ppp lcp negotiate...................................................................................................................302ppp lcp max-echo..................................................................................................................303ppp timeout restart-interval ...................................................................................................303ppp timeout restart-timer .......................................................................................................304

ppp timeout max-configure....................................................................................................304ppp timeout max-failure.........................................................................................................305ppp timeout max-terminate ...................................................................................................305show interfaces .....................................................................................................................306show ppp all configuration.....................................................................................................307show ppp all statistics ...........................................................................................................308show ppp authentication configuration..................................................................................309show ppp authentication statistics.........................................................................................310show ppp ipcp configuration..................................................................................................311show ppp ipcp statistics ........................................................................................................311show ppp lcp configuration....................................................................................................312show ppp lcp statistics ..........................................................................................................313show ppp timeout configuration ............................................................................................314show ppp session statistics...................................................................................................314

16 Point-to-Point Protocol over Ethernet (PPPoE).......................................315encapsulation pppoe.............................................................................................................316no encapsulation pppoe........................................................................................................317no pppoe ac-name ................................................................................................................317no pppoe max-retry ...............................................................................................................317no pppoe retry-timer..............................................................................................................317no pppoe service-name.........................................................................................................317pppoe ac-name .....................................................................................................................318pppoe max-retry ....................................................................................................................319pppoe negotiate ....................................................................................................................320pppoe retry-timer...................................................................................................................321pppoe service-name..............................................................................................................322show pppoe configuration atm ..............................................................................................323show pppoe statistics atm.....................................................................................................324

17 Multilink Point to Point Protocol ...............................................................325interface mlppp......................................................................................................................326encapsulation mlppp .............................................................................................................326mlppp load-threshold.............................................................................................................327no encapsulation mlppp ........................................................................................................327no mlppp load-threshold........................................................................................................327show interfaces mlppp ..........................................................................................................328show mlppp...........................................................................................................................329

18 Ethernet OAM (Operations, Administration, and Maintenance).............331ccm........................................................................................................................................332ccm-interval...........................................................................................................................333eth-ais ...................................................................................................................................334eth-ais interval.......................................................................................................................335eth-cfm association ...............................................................................................................336

eth-cfm domain .....................................................................................................................337eth-cfm 1dmtest ....................................................................................................................338eth-cfm 2dmtest ....................................................................................................................339eth-cfm eth-test .....................................................................................................................340eth-cfm linktrace....................................................................................................................341eth-cfm loopback...................................................................................................................342eth-test ..................................................................................................................................343eth-test test-pattern ...............................................................................................................344fault-alarm lowest-priority-defect ...........................................................................................345fault-alarm reset-time ............................................................................................................346fault-alarm set-time ...............................................................................................................347macaddress...........................................................................................................................348mep .......................................................................................................................................349no ccm-interval......................................................................................................................350no eth-ais interval..................................................................................................................350no eth-cfm domain ................................................................................................................350no eth-cfm association ..........................................................................................................350no fault-alarm lowest-priority-defect ......................................................................................350no fault-alarm reset-time .......................................................................................................351fault-alarm set-time ...............................................................................................................351no macaddress......................................................................................................................351no mep ..................................................................................................................................351no priority ..............................................................................................................................351no remote-mep......................................................................................................................351no shutdown..........................................................................................................................351oam .......................................................................................................................................352remote-mep...........................................................................................................................353show eth-cfm association......................................................................................................354show eth-cfm cfm-stack-table ...............................................................................................355show eth-cfm domain ............................................................................................................356show eth-cfm mep.................................................................................................................357show eth-cfm mep - loopback and linktrace..........................................................................358show eth-cfm mep - 1dm-test-results....................................................................................360show eth-cfm mep - 2dm-test-results....................................................................................361show eth-cfm mep - eth-test-results......................................................................................362show eth-cfm mep - remote-mepid .......................................................................................363shutdown...............................................................................................................................364

19 Bridging Configuration ..............................................................................365Bridging Configuration Commands .......................................................................................366clear bridge statistics.............................................................................................................366no vlan...................................................................................................................................366show bridge statistics ............................................................................................................367show frame-relay pvc ............................................................................................................368show hdlc statistics ...............................................................................................................369show interfaces mlppp ..........................................................................................................370

show ppp bcp statistics Serial ...............................................................................................371show ppp session statistics Serial.........................................................................................372show vlan ..............................................................................................................................373vlan........................................................................................................................................374

20 Link Fragmentation and Interleaving (LFI)...............................................377LFI Configuration on MLPPP CLI Commands ......................................................................378fragment delay ......................................................................................................................378no fragment delay .................................................................................................................379no service-policy ...................................................................................................................379no slippage mru.....................................................................................................................379service-policy ........................................................................................................................379slippage mru..........................................................................................................................380show interfaces mlppp ..........................................................................................................381LFI Configuration on FR CLI Commands..............................................................................382fragment-size ........................................................................................................................382no frame-relay fragment........................................................................................................383no service-policy ...................................................................................................................383no slippage mru.....................................................................................................................383service-policy ........................................................................................................................383slippage mru..........................................................................................................................384show frame-relay fragments..................................................................................................385show frame-relay pvc ............................................................................................................386show interface serial .............................................................................................................387

Part 4: Common Classification

21 Common Classifiers...................................................................................391ethernet .................................................................................................................................392include...................................................................................................................................393list..........................................................................................................................................395match-list...............................................................................................................................397match-lists (rule sets) ............................................................................................................398no include..............................................................................................................................401no list.....................................................................................................................................401no match-list..........................................................................................................................402no rule ...................................................................................................................................402show include .........................................................................................................................403show list ................................................................................................................................403show match-list .....................................................................................................................404show rule...............................................................................................................................405

Part 5: Routing Protocols

22 Protocol Independent Features.................................................................409access-list (extended) ...........................................................................................................410access-list (standard) ............................................................................................................411clear ip route .........................................................................................................................412default-metric ........................................................................................................................412distance.................................................................................................................................413distance bgp..........................................................................................................................414distance ospf .........................................................................................................................415distribute-list ..........................................................................................................................416ip access-list extended..........................................................................................................417ip access-list standard...........................................................................................................419ip as-path access-list.............................................................................................................420ip community-list (extended) .................................................................................................421ip community-list (standard) ..................................................................................................422ip prefix-list ............................................................................................................................423ip route ..................................................................................................................................424ip tcp adjust-mss ...................................................................................................................425ip unnumbered ......................................................................................................................426match as-path .......................................................................................................................427match community ..................................................................................................................427match interface......................................................................................................................428match ip address...................................................................................................................428match ip next-hop..................................................................................................................429match ip route-source ...........................................................................................................430match metric..........................................................................................................................431maximum-paths.....................................................................................................................431match route-type ...................................................................................................................432no passive-interface ..............................................................................................................432no ip tcp adjust-mss ..............................................................................................................433no ip unnumbered .................................................................................................................433passive-interface ...................................................................................................................433passive-interface default .......................................................................................................434redistribute ............................................................................................................................435route-map..............................................................................................................................437set as-path ............................................................................................................................438set community .......................................................................................................................439set comm-list .........................................................................................................................440set dampening.......................................................................................................................440set local-preference number value........................................................................................441set metric...............................................................................................................................442set metric-type.......................................................................................................................442set origin................................................................................................................................443set weight ..............................................................................................................................443

show access-lists ..................................................................................................................444show ip access-lists ..............................................................................................................445show ip as-path-access-list ...................................................................................................445show ip community-list ..........................................................................................................446show ip prefix-list...................................................................................................................446show ip protocols ..................................................................................................................447show ip route.........................................................................................................................449show route-map ....................................................................................................................451

23 Router Information Protocol......................................................................453auto-summary ......................................................................................................................454clear ip rip .............................................................................................................................454default information originate (rip) ..........................................................................................455default-metric ........................................................................................................................455distance.................................................................................................................................456distribute-list ..........................................................................................................................457ip rip authentication key-chain...............................................................................................458ip rip authentication mode.....................................................................................................458ip rip {send|receive} ..............................................................................................................459ip split-horizon.......................................................................................................................459key.........................................................................................................................................460key-chain...............................................................................................................................460key-string...............................................................................................................................461network..................................................................................................................................461neighbor ................................................................................................................................462no auto-summary ..................................................................................................................463no default-information originate.............................................................................................463no default-metric ...................................................................................................................463no distance............................................................................................................................463no distribute-list .....................................................................................................................463no ip rip authentication key-chain..........................................................................................463no ip rip authentication mode................................................................................................464no ip split-horizon .................................................................................................................464no neighbor ...........................................................................................................................464no network.............................................................................................................................464no offset-list...........................................................................................................................464no passive-interface ..............................................................................................................465no redistribute .......................................................................................................................465no timers basic ......................................................................................................................465no validate-update-source.....................................................................................................465no version..............................................................................................................................465no ip rip v2-broadcast............................................................................................................465offset-list................................................................................................................................466passive-interface ...................................................................................................................467redistribute ............................................................................................................................468router rip................................................................................................................................469

show ip protocols ..................................................................................................................469show ip rip database .............................................................................................................471show ip rip interfaces ............................................................................................................472show ip rip peers ...................................................................................................................473show ip rip statistics ..............................................................................................................474show key-chain .....................................................................................................................475timers basic ...........................................................................................................................476validate-update-source .........................................................................................................477version...................................................................................................................................478v2-broadcast (rip) ..................................................................................................................479

24 Border Gateway Protocol ..........................................................................481address-family ipv4 unicast...................................................................................................482aggregate-address................................................................................................................483bgp always-compare-med.....................................................................................................484bgp bestpath as-path ignore .................................................................................................484bgp bestpath compare-cluster-length....................................................................................485bgp bestpath compare-routerid .............................................................................................485bgp bestpath med .................................................................................................................486bgp client-to-client reflection .................................................................................................486bgp cluster-id.........................................................................................................................487bgp confederation identifier...................................................................................................487bgp confederation peers .......................................................................................................488bgp dampening .....................................................................................................................489bgp default local-preference..................................................................................................490bgp enforce-first-as ...............................................................................................................491bgp fast-external-fallover.......................................................................................................491bgp graceful-restart-timers ....................................................................................................492bgp log-neighbor-changes ....................................................................................................492bgp router-id..........................................................................................................................493bgp write config .....................................................................................................................493clear ip bgp............................................................................................................................494clear ip bgp dampening.........................................................................................................494clear ip bgp external..............................................................................................................495clear ip bgp flap-statistics......................................................................................................496clear ip bgp peer-group.........................................................................................................497clear ip bgp neighbor.............................................................................................................498default-information originate..................................................................................................498ip bgp-community new-format...............................................................................................499neighbor activate...................................................................................................................500neighbor advertisement-interval............................................................................................500neighbor capability ................................................................................................................501neighbor default-originate .....................................................................................................501neighbor description..............................................................................................................502neighbor distribute-list ...........................................................................................................503neighbor ebgp-multihop ........................................................................................................504

neighbor filter-list...................................................................................................................505neighbor local-as...................................................................................................................506neighbor maximum-prefix......................................................................................................507neighbor next-hop-self ..........................................................................................................508neighbor peer-group (adding members) ...............................................................................508neighbor peer-group (creating) .............................................................................................509neighbor prefix-list.................................................................................................................510neighbor remove-private-as ..................................................................................................511neighbor remote-as ...............................................................................................................511neighbor route-map...............................................................................................................512neighbor route-reflector-client ...............................................................................................513neighbor send-community.....................................................................................................513neighbor shutdown................................................................................................................514neighbor soft-reconfiguration inbound...................................................................................514neighbor timers .....................................................................................................................515neighbor unsupress-map ......................................................................................................516neighbor update-source ........................................................................................................517neighbor version....................................................................................................................518neighbor weight.....................................................................................................................518network..................................................................................................................................519router bgp..............................................................................................................................520show ip bgp...........................................................................................................................521show ip bgp cidr-only ............................................................................................................524show ip bgp community.........................................................................................................525show ip bgp community-list ...................................................................................................526show ip bgp dampened-paths ...............................................................................................527show ip bgp filter-list..............................................................................................................528show ip bgp flap-statistics .....................................................................................................529show ip bgp inconsistent-as ..................................................................................................529show ip bgp neighbors ..........................................................................................................530show ip bgp paths .................................................................................................................534show ip bgp peer-group ........................................................................................................535show ip bgp regexp ...............................................................................................................535show ip bgp summary ...........................................................................................................536synchronization .....................................................................................................................537timers bgp .............................................................................................................................538

25 Open Shortest Path First ...........................................................................539alt-abr ....................................................................................................................................540area authentication................................................................................................................540area default-cost ...................................................................................................................541area nssa ..............................................................................................................................542area range.............................................................................................................................543area stub ...............................................................................................................................544area virtual-link......................................................................................................................545auto-cost ...............................................................................................................................546

clear ip ospf...........................................................................................................................546compatible RFC1583 ............................................................................................................547default-information originate..................................................................................................548default-metric ........................................................................................................................549distance.................................................................................................................................550distance ospf .........................................................................................................................551ip ospf authentication ............................................................................................................552ip ospf authentication-key .....................................................................................................552ip ospf cost ............................................................................................................................553ip ospf database-filter all out .................................................................................................553ip ospf dead-interval..............................................................................................................554ip ospf flood-reduction...........................................................................................................554ip ospf hello-interval ..............................................................................................................555ip ospf message-digest-key ..................................................................................................555ip ospf mtu-ignore .................................................................................................................556ip ospf network ......................................................................................................................556ip ospf priority........................................................................................................................557ip ospf retransmit-interval......................................................................................................557ip ospf transmit-delay ............................................................................................................558log-adjacency-changes .........................................................................................................558neighbor ................................................................................................................................559network area .........................................................................................................................560no passive-interface ..............................................................................................................560no log-adjacency-changes ....................................................................................................561no area authentication...........................................................................................................561no area default-cost ..............................................................................................................561no area nssa .........................................................................................................................561no area range........................................................................................................................561no area stub ..........................................................................................................................561no area virtual-link.................................................................................................................561passive-interface ...................................................................................................................562router-id.................................................................................................................................562router ospf .............................................................................................................................563show ip ospf ..........................................................................................................................563show ip ospf border-routers ..................................................................................................565show ip ospf database ..........................................................................................................566show ip ospf flood-list............................................................................................................577show ip ospf interface ...........................................................................................................578show ip ospf interface-process..............................................................................................580show ip ospf neighbor ...........................................................................................................581show ip ospf process-interface..............................................................................................583show ip ospf request-list........................................................................................................584show ip ospf retransmission-list ............................................................................................585show ip ospf route .................................................................................................................586show ip ospf summary-address ............................................................................................587show ip ospf virtual-links .......................................................................................................588

summary-address .................................................................................................................589timers lsa-group-pacing.........................................................................................................590timers spf...............................................................................................................................591write ospf...............................................................................................................................592

26 Multicast Routing .......................................................................................593PIM Configuration Commands..............................................................................................594clear ip pim neighbor.............................................................................................................594clear ip pim state-info ............................................................................................................594ip multicast-routing ................................................................................................................595ip pim bsr-candidate..............................................................................................................596ip pim dr-priority ....................................................................................................................597ip pim message-interval ........................................................................................................597ip pim neighbor-filter..............................................................................................................598ip pim rp-address ..................................................................................................................598ip pim rp-candidate................................................................................................................599ip pim rp-candidate-priority....................................................................................................600ip pim sparse-mode...............................................................................................................600ip pim spt-threshold...............................................................................................................601ip pim query-interval..............................................................................................................602no ip pim sparse-mode..........................................................................................................602show ip pim rp-hash..............................................................................................................603show ip pim bsr-router...........................................................................................................603show ip pim interface ............................................................................................................604show ip pim neighbor ............................................................................................................605show ip pim rp mapping ........................................................................................................606show ip pim state-info ...........................................................................................................607IGMP Configuration Commands ...........................................................................................608ip igmp access-group ............................................................................................................608ip multicast-routing ................................................................................................................608ip igmp join-group..................................................................................................................609ip igmp last-member-query-count .........................................................................................609ip igmp last-member-query-interval.......................................................................................610ip igmp query-interval............................................................................................................610ip igmp query-max-response-time.........................................................................................611ip igmp querier-timeout .........................................................................................................611ip pim sparse-mode...............................................................................................................612no ip pim sparse-mode..........................................................................................................612show ip igmp groups .............................................................................................................613show ip igmp interface ..........................................................................................................614Multicast Global Commands .................................................................................................615clear ip mroute ......................................................................................................................615clear ip multicast traffic..........................................................................................................615show ip mroute......................................................................................................................616show ip multicast traffic .........................................................................................................617

27 Policy Based Routing.................................................................................619clear ip-policy statistics .........................................................................................................620ip-policy .................................................................................................................................620ip-policy <ip-policy name>.....................................................................................................622no ip-policy ............................................................................................................................622no ip-policy <ip-policy name>................................................................................................622no rule ...................................................................................................................................622show ip-policy........................................................................................................................623show ip-policy statistics.........................................................................................................624

28 Virtual Routing and Forwarding................................................................625address family .......................................................................................................................626address family .......................................................................................................................627arp .........................................................................................................................................628clear arp-cache .....................................................................................................................628clear arp traffic ......................................................................................................................629clear ip bgp............................................................................................................................629clear ip traffic.........................................................................................................................630clear ip route .........................................................................................................................630description.............................................................................................................................631ip route ..................................................................................................................................631ip vrf ......................................................................................................................................632ip vrf forwarding.....................................................................................................................632ping .......................................................................................................................................633router ospf .............................................................................................................................634show arp................................................................................................................................634show arp traffic......................................................................................................................635show ip bgp...........................................................................................................................636show ip bgp community.........................................................................................................636show ip bgp community-list ...................................................................................................637show ip bgp flap-statistics .....................................................................................................637show ip bgp neighbors ..........................................................................................................638show ip bgp peer-group ........................................................................................................638show ip fib .............................................................................................................................639show ip protocols ..................................................................................................................640show ip route.........................................................................................................................641show ip traffic ........................................................................................................................642show ip vrf .............................................................................................................................643ssh.........................................................................................................................................644telnet .....................................................................................................................................645traceroute ..............................................................................................................................645

Part 6: Network Security

29 Network Address Translation....................................................................649Source Nat (SNAT) Configuration Commands .....................................................................650source-nat .............................................................................................................................650source-nat host .....................................................................................................................651source-nat pool .....................................................................................................................652source-nat port-range............................................................................................................653source-nat static....................................................................................................................654Destination NAT (DNAT) Configuration Commands .............................................................655destination-nat.......................................................................................................................655port ........................................................................................................................................656destination-nat static .............................................................................................................657Common Commands for SNAT and DNAT...........................................................................658bypass...................................................................................................................................658clear ip nat statistics..............................................................................................................658clear ip nat statistics..............................................................................................................659change ..................................................................................................................................659debug firewall nat ..................................................................................................................660ip nat .....................................................................................................................................660ip nat {in | out} .......................................................................................................................661ip nat statistics {in|out|both} ..................................................................................................662no debug firewall nat .............................................................................................................662no ip nat-force .......................................................................................................................662no ip nat {in | out} ..................................................................................................................663no ip nat statistics {in | out | both} .........................................................................................663no rule ...................................................................................................................................663renumber...............................................................................................................................663show ip nat ............................................................................................................................664show ip nat statistics .............................................................................................................665show ip nat statistics <interface-name>................................................................................666

30 Filter and Firewall .......................................................................................667Filter CLI Commands ............................................................................................................668change ..................................................................................................................................668clear ip filter statistics ............................................................................................................669clear l2 filter statistics ............................................................................................................670ip filter....................................................................................................................................670ip filter {in | out} .....................................................................................................................672l2 filter....................................................................................................................................673l2 filter {in|out} .......................................................................................................................675no ip filter...............................................................................................................................676no ip filter {in|out} ..................................................................................................................676no l2 filter...............................................................................................................................676no l2 filter {in|out} ..................................................................................................................676

no rule ...................................................................................................................................676no stateless ...........................................................................................................................677renumber...............................................................................................................................677show ip filter ..........................................................................................................................678show ip filter statistics ...........................................................................................................679show l2 filter ..........................................................................................................................680show l2 filter statistics ...........................................................................................................681stateless................................................................................................................................682Network Attack Prevention Configuration Commands..........................................................683all...........................................................................................................................................683attack.....................................................................................................................................683change ..................................................................................................................................684clear firewall session session-id............................................................................................685default ...................................................................................................................................686default timeout.......................................................................................................................688firewall ...................................................................................................................................688firewall policy {in|out}.............................................................................................................689icmp-block-trace-route ..........................................................................................................689icmp-dest-unrch-storm ..........................................................................................................690icmp-ip-address-sweep.........................................................................................................691icmp-ping-flood......................................................................................................................692icmp-ping-of-death ................................................................................................................693icmp-redirect .........................................................................................................................693icmp-router-advertisement ....................................................................................................694icmp-smurf-attack..................................................................................................................694ip-land-attack.........................................................................................................................695ip-source-routing ...................................................................................................................695ip-spoofing.............................................................................................................................696ip-tear-drop............................................................................................................................696ip-tiny-frag .............................................................................................................................697ip-zero-length ........................................................................................................................698no all......................................................................................................................................698no attack................................................................................................................................698no attack name force.............................................................................................................698no debug firewall ...................................................................................................................699no default ..............................................................................................................................699no firewall policy {in|out}........................................................................................................699no policy ................................................................................................................................700no rule ...................................................................................................................................700policy .....................................................................................................................................700port-scan ...............................................................................................................................702renumber...............................................................................................................................702show firewall attack ...............................................................................................................703show firewall attack system-default.......................................................................................704show firewall policy ...............................................................................................................705show firewall policy system-default .......................................................................................705

show firewall session ............................................................................................................706show firewall session detail...................................................................................................707show firewall session proto ...................................................................................................708show firewall session destination ..........................................................................................709show firewall session source.................................................................................................710tcp-fin-no-ack ........................................................................................................................710tcp-fin-scan............................................................................................................................711tcp-header-frag......................................................................................................................711tcp-invalid-urgent-offset.........................................................................................................712tcp-null-scan..........................................................................................................................712tcp-syn-fin..............................................................................................................................713tcp-syn-flood..........................................................................................................................714tcp-xmas-scan.......................................................................................................................715udp-flood ...............................................................................................................................715udp-fraggle-attack .................................................................................................................716udp-port-loopback .................................................................................................................716udp-snork-attack ...................................................................................................................717Time-Range CLI Commands ................................................................................................718absolute|periodic ...................................................................................................................718no time-range........................................................................................................................719show time-range....................................................................................................................719time-range.............................................................................................................................719ALG CLI Commands.............................................................................................................720clear firewall alg sip statistics................................................................................................720show firewall alg dns debug-counters ...................................................................................720show firewall alg dns statistics ..............................................................................................721show firewall alg ftp debug-counters.....................................................................................721show firewall alg ftp statistics ................................................................................................722show firewall alg rpc debug-counters....................................................................................722show firewall alg rpc statistics ...............................................................................................723show firewall alg rtsp debug-counters...................................................................................723show firewall alg rtsp statistics ..............................................................................................724show firewall alg sip debug-counters ....................................................................................724show firewall alg sip statistics ...............................................................................................725show firewall alg tftp debug-counters....................................................................................725show firewall alg tftp statistics ...............................................................................................726tcp any any service ...............................................................................................................726udp any any service ..............................................................................................................727Customized-service Rule Based ALG Configuration Commands .........................................728change ..................................................................................................................................728customized-service ...............................................................................................................728no rule ...................................................................................................................................730show customized-service ......................................................................................................730

31 IP Security - Virtual Private Network ........................................................731authentication........................................................................................................................732clear crypto ipsec counters ...................................................................................................732clear crypto ipsec sa .............................................................................................................733crypto ca cert.........................................................................................................................733crypto ca identity ...................................................................................................................734crypto certificate-database refresh........................................................................................734crypto certificate-request export............................................................................................735crypto certificate-request generate key-name.......................................................................735crypto crl-check strict ............................................................................................................736crypto ike dpd interval ...........................................................................................................736crypto ike identity ..................................................................................................................737crypto ike key ........................................................................................................................738crypto ike policy.....................................................................................................................739crypto ipsec transform-set.....................................................................................................740crypto key export rsa <name>...............................................................................................741crypto key generate rsa.........................................................................................................742crypto key import rsa name...................................................................................................743crypto nat-traversal ...............................................................................................................743crypto map ............................................................................................................................744crypto map <map-name>......................................................................................................744crypto peer-certificate import.................................................................................................745crypto peer-certificate delete.................................................................................................746crypto rsa-key delete.............................................................................................................746crypto signed-cert..................................................................................................................747dpd interval............................................................................................................................747ike-identity .............................................................................................................................748import ca-cert ........................................................................................................................748import crl ...............................................................................................................................749import signed-cert .................................................................................................................750ipsec security-association lifetime.........................................................................................751lifetime seconds ....................................................................................................................751lifetime...................................................................................................................................752match ....................................................................................................................................752my-ca ....................................................................................................................................753my-cert ..................................................................................................................................753my-id .....................................................................................................................................754no crypto crl-check strict .......................................................................................................754no crypto ike dpd...................................................................................................................754no crypto ike key ...................................................................................................................754no crypto ike policy................................................................................................................755no crypto map .......................................................................................................................755no dpd ...................................................................................................................................755no ike-identity ........................................................................................................................755no ipsec security-association lifetime....................................................................................755no lifetime..............................................................................................................................755

no lifetime seconds ...............................................................................................................755no match ...............................................................................................................................756no peer ..................................................................................................................................756no pfs ....................................................................................................................................756no proposal ...........................................................................................................................756no transform-set ....................................................................................................................756no crypto ipsec transform-set................................................................................................757peer .......................................................................................................................................757peer-ca ..................................................................................................................................758peer-cert................................................................................................................................758peer-id ...................................................................................................................................759pfs .........................................................................................................................................759proposal ................................................................................................................................760show crypto ...........................................................................................................................760show crypto ca-cert ...............................................................................................................762show crypto ca identity..........................................................................................................763show crypto certificate-request .............................................................................................764show crypto crl ca .................................................................................................................765show crypto ike identity .........................................................................................................766show crypto ike key...............................................................................................................767show crypto ike policy ...........................................................................................................768show crypto ipsec sa.............................................................................................................769show crypto ipsec transform-set ...........................................................................................770show crypto map...................................................................................................................771show crypto peer-certificate ..................................................................................................772show crypto rsa-key ..............................................................................................................774show crypto signed-cert ........................................................................................................775show running-config ..............................................................................................................777subject-name.........................................................................................................................779transform set .........................................................................................................................779IPsec Tunnel Interface CLI Commands ................................................................................780crypto ipsec profile ................................................................................................................780ike-identity .............................................................................................................................780ike-policy ...............................................................................................................................781interface tunnel......................................................................................................................781ip address..............................................................................................................................782ipsec-profile...........................................................................................................................782lifetime...................................................................................................................................783mode .....................................................................................................................................784no ike-identity ........................................................................................................................784no ike-policy ..........................................................................................................................784no ipsec-profile......................................................................................................................785no lifetime..............................................................................................................................785no pfs ....................................................................................................................................785no shutdown..........................................................................................................................785no transform-set ....................................................................................................................785

no tunnel destination .............................................................................................................785no tunnel source....................................................................................................................785pfs .........................................................................................................................................786show crypto ipsec profile.......................................................................................................787shutdown...............................................................................................................................788transform-set .........................................................................................................................788tunnel destination ..................................................................................................................789tunnel source.........................................................................................................................789Dynamic Multipoint Virtual Private Network (DMVPN) CLI Commands................................790authentication........................................................................................................................790clear ip nhrp ..........................................................................................................................791holdtime.................................................................................................................................792ip nhrp ...................................................................................................................................793map .......................................................................................................................................794network-id..............................................................................................................................795nhrp.......................................................................................................................................796nhs ........................................................................................................................................797no authentication...................................................................................................................797no holdtime............................................................................................................................797no nhrp ..................................................................................................................................798no ip nhrp ..............................................................................................................................798no map ..................................................................................................................................798no network-id.........................................................................................................................798no nhs ...................................................................................................................................798no registration timeout...........................................................................................................798registration timeout................................................................................................................799show ip nhrp..........................................................................................................................800show ip nhrp configuration ....................................................................................................801show ip nhrp object ...............................................................................................................802show ip nhrp interface Tunnel ...............................................................................................803IPsec VPN Server CLI Commands .......................................................................................804client firewall..........................................................................................................................804client-ip-list ............................................................................................................................805client-object ...........................................................................................................................806crypto client object ................................................................................................................807crypto client profile ................................................................................................................808ike-policy ...............................................................................................................................809ipsec security-association lifetime seconds ..........................................................................810keep-alive..............................................................................................................................811no client-object ......................................................................................................................811no crypto client object ...........................................................................................................811no crypto client profile ...........................................................................................................812no primary_dns_ip.................................................................................................................812no primary_wins_ip ...............................................................................................................812no secondary_dns_ip ............................................................................................................812no secondary_wins_ip...........................................................................................................812

pfs .........................................................................................................................................813primary_dns_ip......................................................................................................................814primary_wins_ip ....................................................................................................................815save-password ......................................................................................................................816show crypto client object .......................................................................................................817show crypto client profile.......................................................................................................818transform-set .........................................................................................................................819Hardware Crypto Engine CLI Commands.............................................................................820clear crypto engine statistics .................................................................................................820crypto engine accelerator......................................................................................................821no crypto engine accelerator.................................................................................................821show crypto engine configuration..........................................................................................822show crypto engine statistics ................................................................................................823

32 Intrusion Detection/Intrusion Prevention System...................................825clear firewall intrusion snort statistics....................................................................................826clear firewall intrusion snort statistics preprocessor..............................................................826clear firewall intrusion snort statistics rule.............................................................................827debug trace firewall intrusion selector...................................................................................828firewall policy {in | out}...........................................................................................................829intrusion sensor.....................................................................................................................830intrusion snort........................................................................................................................830match intrusion {detection | prevention} ................................................................................831no debug trace firewall intrusion selector..............................................................................831no intrusion sensor................................................................................................................832no update ..............................................................................................................................832rebuild ...................................................................................................................................832rollback..................................................................................................................................833rule detection.........................................................................................................................833rule disable............................................................................................................................834rule enable ............................................................................................................................834rule modify.............................................................................................................................835rule prevention ......................................................................................................................836show firewall intrusion sensor ...............................................................................................836show firewall intrusion snort archives....................................................................................837show firewall intrusion snort file list .......................................................................................838show firewall intrusion snort rule ...........................................................................................839show firewall intrusion snort rule disable...............................................................................840show firewall intrusion snort statistics ...................................................................................841show firewall intrusion snort statistics preprocessor .............................................................842show firewall intrusion snort statistics rule ............................................................................843show firewall intrusion snort update ......................................................................................844show firewall policy ...............................................................................................................844update ...................................................................................................................................845

33 Generic Routing Encapsulation................................................................847gre-keep-alive-interval...........................................................................................................848gre-keep-alive-max-tries .......................................................................................................848interface tunnel......................................................................................................................849ip address..............................................................................................................................849mode .....................................................................................................................................850no gre-keep-alive-interval......................................................................................................851no gre-keep-alive-max-tries ..................................................................................................851no shutdown..........................................................................................................................851no tunnel destination .............................................................................................................851no tunnel source....................................................................................................................851shutdown...............................................................................................................................851tunnel destination ..................................................................................................................852tunnel df-bit ...........................................................................................................................853tunnel source.........................................................................................................................853tunnel vrf ...............................................................................................................................854

Part 7: Quality of Service

34 Quality of Service .......................................................................................857auto qos diff-serv...................................................................................................................858auto qos template..................................................................................................................858auto qos voip.........................................................................................................................859bandwidth..............................................................................................................................859class......................................................................................................................................860class-map..............................................................................................................................861clear queuing statistics..........................................................................................................862description.............................................................................................................................862fair-queue..............................................................................................................................863l2-service-policy ....................................................................................................................864network-control......................................................................................................................865no auto qos diff-serv..............................................................................................................865no auto qos template.............................................................................................................865no auto qos voip....................................................................................................................865no bandwidth.........................................................................................................................865no class.................................................................................................................................866no class-map.........................................................................................................................866no fair-queue.........................................................................................................................866no l2-service-policy ...............................................................................................................866no network-control.................................................................................................................866no police................................................................................................................................866no policy-map........................................................................................................................866no priority ..............................................................................................................................867no qos-preclassify .................................................................................................................867

no random-detect ..................................................................................................................867no rule ...................................................................................................................................867no set ....................................................................................................................................867no service-policy ...................................................................................................................867no service-policy <child policy-map name> ..........................................................................868no shape ...............................................................................................................................868no tunnel tunnel bandwidth ...................................................................................................868no queue-limit........................................................................................................................868police.....................................................................................................................................869policy-map.............................................................................................................................870priority ...................................................................................................................................870priority bandwidth ..................................................................................................................871qos credits debug..................................................................................................................872qos-preclassify ......................................................................................................................872random-detect .......................................................................................................................873service-policy ........................................................................................................................877service-policy <child policy-map name> ...............................................................................878set .........................................................................................................................................879shape ....................................................................................................................................881show auto qos .......................................................................................................................882show class-map ....................................................................................................................884show policy-map ...................................................................................................................885show random-detect-defaults................................................................................................886show service-policy ...............................................................................................................887show qos config ....................................................................................................................888show qos running-config .......................................................................................................889show queuing interface .........................................................................................................890show queuing statistics .........................................................................................................891tunnel ....................................................................................................................................892tunnel bandwidth ...................................................................................................................893queue-limit.............................................................................................................................894QoS on FR Configuration Commands ..................................................................................895frame-relay qos-bandwidth percent.......................................................................................895no frame-relay qos-bandwidth percent..................................................................................895no service-policy ...................................................................................................................896service-policy ........................................................................................................................896show qos frame-relay bandwidth-config................................................................................897

Part 8: TCP/IP Services

35 DHCP (Dynamic Host Configuration Protocol) Server............................901exclude ip ..............................................................................................................................902host .......................................................................................................................................903ip dhcp option bootfile-name.................................................................................................904ip dhcp option dns-server......................................................................................................905

ip dhcp option domain-name.................................................................................................906ip dhcp option lease-time ......................................................................................................907ip dhcp option log server .......................................................................................................908ip dhcp option next-server.....................................................................................................909ip dhcp option ntp server.......................................................................................................910ip dhcp option routers............................................................................................................911ip dhcp option subnet-mask ..................................................................................................912ip dhcp option tftp-server.......................................................................................................913ip dhcp option time-offset ......................................................................................................914option bootfile-name..............................................................................................................914option dns-server ..................................................................................................................915option domain-name .............................................................................................................915option lease-time...................................................................................................................916option log server....................................................................................................................916option next-server .................................................................................................................917option ntp server ...................................................................................................................918option routers ........................................................................................................................918option subnet-mask...............................................................................................................919option tftp-server ...................................................................................................................919option time-offset...................................................................................................................920ip dhcp pool...........................................................................................................................921network..................................................................................................................................922no host ..................................................................................................................................922no ip dhcp option bootfile-name............................................................................................922no ip dhcp option dns-server.................................................................................................922no ip dhcp option domain-name............................................................................................922no ip dhcp option lease-time .................................................................................................923no ip dhcp option log-server..................................................................................................923no ip dhcp option next-server................................................................................................923no ip dhcp option ntp-server..................................................................................................923no ip dhcp option routers.......................................................................................................923no ip dhcp option subnet-mask .............................................................................................923no ip dhcp option tftp-server..................................................................................................923no ip dhcp option time-offset .................................................................................................923no option bootfile-name.........................................................................................................924no option dns-server .............................................................................................................924no option domain-name ........................................................................................................924no option lease-time..............................................................................................................924no option log-server ..............................................................................................................924no option next-server ............................................................................................................924no option ntp-server ..............................................................................................................924no option routers ...................................................................................................................924no option subnet-mask..........................................................................................................925no option tftp-server ..............................................................................................................925no option time-offset..............................................................................................................925no ip dhcp pool......................................................................................................................925

no network.............................................................................................................................925no range................................................................................................................................925range.....................................................................................................................................926service dhcp enable ..............................................................................................................927service dhcp disable..............................................................................................................927show ip dhcp bindings...........................................................................................................928show ip dhcp options.............................................................................................................929show ip dhcp pools................................................................................................................930show ip dhcp server statistics ...............................................................................................931

36 DHCP (Dynamic Host Configuration Protocol) Client.............................933client-id..................................................................................................................................934dhcp client .............................................................................................................................935ip dhcp client .........................................................................................................................936ip dhcp client option hostname..............................................................................................937no client-id.............................................................................................................................937no dhcp client ........................................................................................................................937no ip dhcp client ....................................................................................................................937no ip dhcp client option hostname.........................................................................................938no parameter-req-list.............................................................................................................938no requested-address ...........................................................................................................938no request-type .....................................................................................................................938no user-class.........................................................................................................................938no vendor-class-identifier ......................................................................................................938parameter-req-list..................................................................................................................939requested-address ................................................................................................................940request-type ..........................................................................................................................941show ip dhcp client................................................................................................................942show ip dhcp client status .....................................................................................................943user-class..............................................................................................................................944vendor-class-identifier ...........................................................................................................945

37 TFTP (Trivial File Transfer Protocol) Server ............................................947no tftp-server .........................................................................................................................948show tftp files ........................................................................................................................948tftp-server disable..................................................................................................................949tftp-server enable ..................................................................................................................949tftp-server ..............................................................................................................................950

38 DHCP (Dynamic Host Configuration Protocol) Relay .............................951ip dhcp relay..........................................................................................................................952ip dhcp relay interface ...........................................................................................................952no ip dhcp relay.....................................................................................................................953no ip dhcp relay interface ......................................................................................................953show ip dhcp relay ................................................................................................................953

39 DNS (Domain Name Service) Client..........................................................955clear host...............................................................................................................................956ip domain-list .........................................................................................................................956ip domain-lookup...................................................................................................................957ip domain-name ....................................................................................................................957ip host....................................................................................................................................958ip host-max-age ....................................................................................................................958ip name-server ......................................................................................................................959no ip domain-list ....................................................................................................................960no ip domain-lookup..............................................................................................................960no ip domain-name ...............................................................................................................960no ip host...............................................................................................................................960no ip host-max-age ...............................................................................................................960no ip name-server .................................................................................................................960nslookup................................................................................................................................961show hosts ............................................................................................................................961

40 Dynamic DNS (DDNS) Client .....................................................................963http ........................................................................................................................................964interval...................................................................................................................................965ip ddns update hostname......................................................................................................966ip ddns update method..........................................................................................................967ip ddns method......................................................................................................................968no interval..............................................................................................................................969no ip ddns update method.....................................................................................................969no ip ddns update hostname.................................................................................................969no ip ddns method.................................................................................................................969no server ...............................................................................................................................969no url .....................................................................................................................................969server ....................................................................................................................................970show ip ddns .........................................................................................................................971show ip ddns update .............................................................................................................972url ..........................................................................................................................................973

41 TR-069 Client...............................................................................................975cwmp acs-url .........................................................................................................................976cwmp default .........................................................................................................................977cwmp disable ........................................................................................................................978cwmp enable .........................................................................................................................979cwmp password ....................................................................................................................980cwmp periodic-inform............................................................................................................981cwmp periodic-inform-interval ...............................................................................................982cwmp periodic-inform-time....................................................................................................983cwmp username....................................................................................................................984cwmp wan .............................................................................................................................985

no cwmp acs-url ....................................................................................................................986no cwmp default ....................................................................................................................986no cwmp password ...............................................................................................................986no cwmp periodic-inform.......................................................................................................986no cwmp periodic-inform-interval ..........................................................................................986no cwmp periodic-inform-time ...............................................................................................986no cwmp username...............................................................................................................986no cwmp wan ........................................................................................................................986show cwmp ...........................................................................................................................987show cwmp-interface ............................................................................................................988

Part 9: License Manager

42 License Manager ........................................................................................991dir licenses ............................................................................................................................992license backup ......................................................................................................................993license install.........................................................................................................................994license remove......................................................................................................................996list licenses............................................................................................................................996show licenses feature-list ......................................................................................................997show licenses........................................................................................................................998

Preface

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 1 PREFACE

ABOUT THIS GUIDEThis guide explains the syntax of the various commands needed to configure different services available in the OmniAccess 5510 ADSL Annex A/Annex B Unified Services Gateway (OmniAccess 5510 AA/AB USG), OmniAccess 5510 SR Unified Services Gateway (OmniAccess 5510-SR USG), and OmniAccess 5510 TE Unified Services Gateway (OmniAccess 5510-TE USG).

It focuses on accessing OmniAccess 5510 USG by using the Command Line Interface (CLI). All commands are described in alphabetical order. They do not follow the sequence of configuration. Each chapter includes table of parameters, default values and configuration examples as quick-start and reference information.

For more detailed information on using and configuring different services, refer to the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

SUPPORTED PLATFORMSThe information in this guide applies to the following products:• OmniAccess 5510-AA/AB USG• OmniAccess 5510-SR USG• OmniAccess 5510-TE USG

AUDIENCEThis guide is intended for networking professionals who are responsible for designing, implementing, and managing enterprise networks.

1Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

OmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Left running head: Chapter name (automatic)

ORGANIZATIONThe chapters in the CLI Command Reference Guide are organized into following parts:

PART I - INTRODUCTION

The first part provides an introduction to CLI “Using the Command Line Interface” in Chapter 2. This is a preparatory chapter that describes the CLI configuration considerations, tools required, an overview of the Command Line Interface and procedures that should be performed before the actual configuration.

Chapter 3 “System Configuration and Monitoring” chapter includes commands for Inband and Out-of-band management, setting system parameters, software management, configuration management, AAA services, SNMP, etc. The various commands include SSH, Telnet, show version, update, show environment, show mem, show proc, etc.

Chapter 4 “Virtual Router Redundancy Protocol” chapter documents the commands for Virtual Router Redundancy Protocol (VRRP). These commands are used to configure VRRP on an interface.

PART II - LAN INTERFACES

Chapter 5 “Fast Ethernet Interface”documents the CLI commands for the Ethernet interfaces.

Chapter 6 “Switching on L2 Ports” deals with the L2 switching Configuration on OmniAccess 5510 USG. This chapter documents the commands for Layer 2 switching. These commands are used to configure switching on the L2 protocols.

Chapter 7 “Spanning Tree Protocol” details the VLAN commands in switching.

Chapter 8 “Integrated Routing and Bridging” covers the commands used to configure Integrated Routing and Bridging (IRB) on OmniAccess 5510 USG.

2

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Organization

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

PART III- WAN INTERFACES

This part details the commands to configure an ATM interface on the OmniAccess 5510-AA/AB USG in Chapter 9 “ADSL (Asymmetric Digital Subscriber Line)”.

This chapter details the commands to configure a Serial interface (V.35/X2.21/RS-232) on the OmniAccess 5510-SR USG in Chapter 10 “Universal Serial Port (USP)”.

This chapter introduces the commands and steps to configure a T1 or an E1 interface on the OmniAccess 5510-TE USG in Chapter 11 “T1E1 Interface”.

Chapter 12 “Third Generation (3G) Wireless WAN Interface” documents the CLI commands for configuration of 3G wireless WAN interface on the OmniAccess 5510 USG.

Chapter 13 “High-level Data Link Control” documents the CLI commands for High Level Data Link Control (HDLC) Protocol. These commands are used to configure HDLC encapsulation on an interface.

Chapter 14 “Frame Relay” documents the Frame-Relay (FR) CLI commands. These commands are used to configure FR encapsulation on an interface.

Chapter 15 “Point to Point Protocol” documents the CLI commands for the Point-to-Point Protocol (PPP). These commands are used to configure PPP encapsulation on an interface.

Chapter 16 “Point-to-Point Protocol over Ethernet (PPPoE)” documents the CLI commands for configuring PPPoE encapsulation on an ADSL ATM sub-interface or a Fast Ethernet interface.

Chapter 17 “Multilink Point to Point Protocol” documents the CLI commands for the Multilink Point-to-Point Protocol (MLPPP). These commands are used to configure Multilink PPP encapsulation on a serial interface.

Chapter 18 “Ethernet OAM (Operations, Administration, and Maintenance)” documents the CLI commands for Ethernet OAM feature on OmniAccess 5510 USG.

Chapter 19 “Bridging Configuration” documents the CLI commands for bridging on OmniAccess 5510 USG.

Chapter 20 “Link Fragmentation and Interleaving (LFI)” provides the CLI commands for Link Fragmentation and Interleaving on a MLPPP and Frame Relay interface.

3Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

OmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Left running head: Chapter name (automatic)

PART IV - PACKET CLASSIFICATION

This part consists of Chapter 21 “Common Classifiers” that focuses on Common Classifier commands. These commands are generic across all applications. You are required to have a thorough knowledge of this chapter before you proceed to configure the NATs, Filters, etc.

PART V - ROUTING PROTOCOLS

The aim of this part is to get the most out of addressing and routing. The routing function moves data through the network efficiently and finds new paths when network changes occur. Routing also affects how large the network can grow - that is, the complexity of the topology and the stability of the network as it expands. All the chapters in this part focus on configuring the routing services.

Chapter 22 “Protocol Independent Features” lists the protocol independent commands that are generic across all routing protocols. You are required to have a thorough knowledge of this chapter before you proceed to configure the RIP, OSPF and BGP.

Chapter 23 “Router Information Protocol” and Chapter 24 “Border Gateway Protocol” and Chapter 25 “Open Shortest Path First” provides configuration commands for configuring RIP, OSPF and BGP routing protocols.

Chapter 26 “Multicast Routing” provides Multicast routing configuration on OmniAccess 5510 USG.

Chapter 27 “Policy Based Routing” covers the commands for Policy Based Routing (PBR) configuration on OmniAccess 5510 USG.

Chapter 28 “Virtual Routing and Forwarding” covers the commands for configuring Virtual Routing and Forwarding Customer Edge (VRF-CE) on the OmniAccess 5510 USG. VRF-CE is a feature that enables a service provider to support two or more VPNs, where IP addresses can be overlapped among the VPNs.

4

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Organization

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

PART VI - NETWORK SECURITY CLIThis part deals with the methodologies to secure the network, protect data and users, and extend connectivity with confidence. Security services protect the confidentiality and integrity of information on the network. You are required to have a complete knowledge in configuring the match-lists (access lists) before you proceed to configure the Filters, NATs, Firewalls, and IPsecs.

Chapter 29 “Network Address Translation” provides NATs (SNAT and DNAT configuration) CLI commands.

Chapter 30 “Filter and Firewall” documents the Filter and Firewall configuration commands. The Filter CLI and Firewall CLI commands basically deals with the Denial of Service attack prevention CLI commands.

Chapter 31 “IP Security - Virtual Private Network” provides the CLI syntax of the various commands needed to configure IPsec.

Chapter 32 “Intrusion Detection/Intrusion Prevention System” comprehends the commands to configure Intrusion Detection and Intrusion Prevention on OmniAccess 5510 USG.

Chapter 33 “Generic Routing Encapsulation” provides the commands for GRE (Generic Routing Encapsulation) configuration.

PART VII - QUALITY OF SERVICE Quality of Service (QoS) refers to a broad collection of shaping technologies/ techniques. QoS is an increasingly important area of research and development in computer networking. It is especially important for the new generation of internet applications such as video-on-demand and other consumer services. QoS tools help in alleviating most congestion problems especially when there is too much traffic and a network monitoring system becomes a must.

Chapter 34 “Quality of Service” provides the configuration commands for QoS. It includes CLI commands for configuring policing, shaping, queueing network traffic, auto Qos, etc.

5Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

OmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Left running head: Chapter name (automatic)

PART VIII - TCP/IP SERVICES This part consists of Chapter 35 “DHCP (Dynamic Host Configuration Protocol) Server” that focuses on DHCP Server configuration commands.

Chapter 36 “DHCP (Dynamic Host Configuration Protocol) Client” documents the commands for DHCP client configuration.

Chapter 37 “TFTP (Trivial File Transfer Protocol) Server” that documents the TFTP Server configuration commands.

Chapter 38 “DHCP (Dynamic Host Configuration Protocol) Relay” focuses on DHCP Relay configuration commands.

and Chapter 39 “DNS (Domain Name Service) Client” documents the DNS Client configuration commands.

Chapter 40 “Dynamic DNS (DDNS) Client” covers the commands for DDNS Client configuration.

Chapter 41 “TR-069 Client” documents the commands for TR-069 (Technical Report 069) configuration on OmniAccess 5510 USG.

PART IX - LICENSE MANAGER

This part consists of Chapter 42 “License Manager” documents the commands on how to install, view and take back up of license files.

6

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Document Conventions

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

DOCUMENT CONVENTIONSThe following table describes the document conventions used with the commands in this document:

The following conventions are used to attract the attention of the reader:

Note: A note contains helpful suggestions or information that may be easily overlooked.

Caution: Indicates a situation where the reader needs to be careful. Failure to observe the cautionary note could result in equipment damage or loss of data.

Convention Description

Bold Indicates commands and keywords.

Italics Indicates arguments/command input supplied by you.

[ ] Square brackets enclose an optional element (keyword or argument).

< > Braces enclose a mandatory element (keyword or argument).

| Line indicates an optional choice.

[x | y] Square brackets enclosing keywords or arguments separated by a vertical line indicates an optional choice.

{x | y} Braces enclosing keywords or arguments separated by a vertical line indicate a required choice. You must select one.

[w {x|y}............] Nested sets of square brackets or braces indicate optional or required choices within the optional or required elements.

{x|y}... OR[x|y]...

Braces enclosing keywords or arguments with ‘...’ indicate that the element within the brace can be repeated.

Courier font Examples of information displayed on the screen.

< > Angle brackets enclose text that is not printed on the screen such as passwords.

“no” form of the commands

The 'no' form of a command is issued to either set it to its default value or to negate it.

[ ^ ] [ ^ ] in the command indicate negation.

7Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

OmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Left running head: Chapter name (automatic)

Warning: Warning is used in similar cases as caution. This also indicates a situation where the reader needs to pay extra attention to avoid hazardous situations.

OBTAINING DOCUMENTATIONAlcatel-Lucent provides several ways to obtain technical assistance and other technical resources. Documents can be downloaded from our support site service.esd.alcatel-lucent.com.

REFERENCE PUBLICATIONSThe following publications are part of the Alcatel-Lucent documentation suite:• OmniAccess 5510 Unified Services Gateway CLI Configuration Guide• OmniAccess 5510 Unified Services Gateway CLI Command Reference Guide• OmniAccess 5510 Unified Services Gateway Web GUI Users Guide• OmniAccess 5510 Unified Services Gateway Getting Started Guide• OmniAccess 5510 Unified Services Gateway Hardware Users Guide.

8

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Obtaining Technical Assistance

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

OBTAINING TECHNICAL ASSISTANCEFor all customers, partners, resellers, and distributors who hold valid Alcatel-Lucent service contracts, the Alcatel-Lucent Technical Support Team provides 24-hour-a-day, technical support services online and over the phone.

Alcatel-LucentUS Customer Support: (800) 995-2696

International Customer Support: (818) 878-4507

E-mail: [email protected]

Website: service.esd.alcatel-lucent.com

DOCUMENTATION FEEDBACKWe value your comments and suggestions about our documentation. If you have any comments about this guide, please enter them through the Feedback link on the Alcatel-Lucent website. We will use your feedback to improve the documentation.

9Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

OmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Left running head: Chapter name (automatic)

10

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

For final production, import color definitions from\\daldoc01\docteam\templates\framemaker\book-template\color-defs\ production-colors.fm. Do not import other template elements such as page layout.

To return to the draft version, import color def’ns from draft-colors.fm.To switch to the beta version, import color def’ns from beta-colors.fm

For final production, import color definitions from\\daldoc01\docteam\templates\framemaker\book-template\color-defs\ production-colors.fm. Do not import other template elements such as page layout.

To return to the draft version, import color def’ns from draft-colors.fm.To switch to the beta version, import color def’ns from beta-colors.fm

Optional footer: Manual title (to set, redefine ManualTitlevariable)

agination: umeric & ntinuous

PNco

Part 1 Introduction

Beta BetaAlcatel-Lucent

11

Beta Betawith preceding section of book

OmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Left running head: Chapter name (automatic)

12

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Using the Command Line Interface

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 2 USING THE COMMAND LINE INTERFACE

CLI OVERVIEWThe Command Line Interface (CLI) is the primary interface to access OmniAccess 5510 USG. The CLI is the interface for console and connections via SSH and Telnet. The CLI, which automatically starts once the required processes are up provides commands that can be used to perform various tasks, including configuring OmniAccess 5510 USG, monitoring and troubleshooting the system, enabling network connectivity, and verifying the system hardware.

13Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Using the Command Line Interface

Left running head: Chapter name (automatic)

BACKUP INTERFACEbackup interface <interface-name>

DESCRIPTION

This command is entered in the Interface Configuration mode.This command is used to configure an interface as a backup interface.

PARAMETERS

EXAMPLEALU(config-if FastEthernet0)# backup interface atm 0.1

CLEAR COUNTERSclear counters [<interface-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to clear counters on an interface.

PARAMETERS

EXAMPLEALU(config)# clear counters FastEthernet 0Clear counters on this interface [confirm] yALU(config)#

Parameter Description

interface-name Name of the interface.

Parameter Description

interface-name Name of the interface.

14

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

configure terminal

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CONFIGURE TERMINALconfigure terminal

DESCRIPTION

This command is entered in the Configuration Mode. This enters Configuration Mode. This mode allows you to configure system related configuration or modify running system configuration. If you later save the configuration, these commands are stored across router reboots.

PARAMETERS

None.

EXAMPLEALU#configure terminalALU(config)#Enter configuration commands, one per line. End with CNTL/Z.

To exit the Configuration Mode and return to the SUM, enter the Control-Z command.ALU(config)#^ZALU#

CM COMMAND SET

Command (in CM) Description

aaa Authentication, Authorization, and Accounting

access-list Add an access list entry

arp ARP setting

auto Create Auto-QoS template

certificate Certificate to perform encryption and decryption of HTTPS connections.

change Change a dialer list rule's line number

class-map Set QoS Class Map.

clear Terminating the Session

clock System clock settings

crypto IPSEC VPN module

customized-service Customize services

debug Debugging functions (see also 'undebug')

15Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Using the Command Line Interface

Left running head: Chapter name (automatic)

dialer-list Dial-on-demand commands

enable Modify enable secret parameters

end Exit from configure mode

firewall Firewall configuration mode

gre-keep-alive-interval GRE Keep Alive interval

gre-keep-alive-max-tries GRE Keep Alive maximum try count

hostname Set system's network name

http HTTP Web server

https Secure HTTP

interface Select an interface to configure

ip Global IP configuration sub commands

ip-policy Define/Modify PBR policy

key-chain Key management

l2 Configure L2 filter

license License operations

line Configure a terminal line

list Define a new list/Modify an existing list

logging Modify message logging facilities

mac-address-table Configure the mac address table

match-list Define/Modify a match-list

nat-ip NAT port reservation

no Negate a command or set its defaults

oam Enters OAM global configuration mode

package Package Manipulation

policy-map Add a Policy-Map

radius-server Modify RADIUS query parameters

renumber Renumber all rules in this Dialer

route-map Create route-map or enter route-map command mode

router Enable a routing process

service Modify use of network based services

Command (in CM) Description

16

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

configure terminal

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

show Show running system information

snmp Configure SNMP parameters

snmp-server snmp-server configuration

spanning-tree Spanning-tree configurations

ssh SSH service

tacacs-server Modify TACACS+ query parameters

telnet Telnet service

tftp-server To provide TFTP service for file requests

time-range Define/modify a time range object

top Enter top level configuration mode

undebug Debugging functions (see also 'undebug')

up Go up one mode

username Establish user name authentication

Command (in CM) Description

17Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Using the Command Line Interface

Left running head: Chapter name (automatic)

CONTROLLERcontroller <port>

DESCRIPTION

This command is entered in the Configuration Mode. This command enables you to configure T1 or an E1 interface. This enters Controller mode.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510-TE USG.

EXAMPLEThe following command configures a E1 controller:

ALU(config)# controller E1 0ALU(config-controller E1)#

Parameter Description

name Name of the interface.

port Port number of the interface.

18

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

enable

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

ENABLEenable

DESCRIPTION

This command is entered in the User Mode. This command enables Super Users Mode. SUM is a superset of the UM command set and allows you to perform tasks like process reset, clearing counters, debugging, and entering configuration modes.

PARAMETERS

None.

EXAMPLEALU> enableALU#

Notes:• As the SUM command set contains all of the commands available in UM, some

commands can be entered in either mode. • It is recommend that you set up password authentication for users who need to

access the SUM command set.

The SUM mode prompt consists of the host name of the device followed by a pound sign (#) or if no host name is configured, the prompt is displayed as ‘ALU#’.

SUM COMMAND SET

Command (in SUM) Description

clear Reset functions

clock System Clock

configure Enter configuration mode

copy Copy from one file to another

crypto IPsec VPN Module

debug Debugging functions

delete Delete a file

dir List files on a filesystem

disable Turn off privileged commands.Exits from the SUM to the UM mode.

erase Erase a filesystem

exit Exit from current mode

19Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Using the Command Line Interface

Left running head: Chapter name (automatic)

help Description of the interactive help system

list Listing files

load Load dynamically loadable resourcesLoading the configuration file

logging Modify message logging facilities

logout Exit from the EXEC

mkdir Create directory

mtrace Trace reverse multicast path from destination to source

no Negate a command or set its defaults

qos Show QoS Debug Information

nslookup Translate a DNS name to an IP address or vice-versa

package Package Manipulation

ping Send echo messages

quit Quit this session

reload Reboot the Chassis

rmdir Delete directory

save Saving the configuration file

service Set terminal line parameters

show Show running system information

system-traffic System-traffic keyword

ssh Open a ssh connection

telnet Open a telnet connection

terminal Set terminal line parameters

traceroute Trace route to destination

undebug Disable debugging functions

write Write running configuration to memory, network, or terminal

Command (in SUM) Description

20

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

interface atm <port>.<subinterface-id>

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

INTERFACE ATM <PORT>.<SUBINTERFACE-ID>interface atm <port>.<subinterface-id>

DESCRIPTION

This command enables you to configure a sub-interface on the ATM interface. This enters the Sub-interface Configuration Mode (S-ICM).

Note: You can configure a maximum of 15 sub-interfaces per ATM interface.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510-AA/AB USG

EXAMPLEALU(config)# interface atm 0.1ALU(config-subif atm0.1)#

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

port Port number of the ATM interface.

subinterface-id Sub-interface number of the interface. The range for sub-interface is 1-15.

21Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Using the Command Line Interface

Left running head: Chapter name (automatic)

INTERFACE <NAME> <INTERFACE-NUMBER>interface <name> <interface-number>

DESCRIPTION

This command is entered in the Configuration Mode. This command enables you to configure logical interfaces such as tunnel interface, loopback, VLAN.

PARAMETERS

EXAMPLEThe following command configures a loopback interface:

ALU(config)# interface loopback 1ALU(config-if loopback1)#

Parameter Description

name Name of the interface.

interface-number The interface number.

22

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

interface <name> <port>

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

INTERFACE <NAME> <PORT>interface <name> <port>

DESCRIPTION

This command is entered in the Configuration Mode. This command enables you to configure virtual interfaces such as Fast Ethernet, Switchport (L2 port), ATM, Serial (V.35/X.21/RS-232) interface.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510-SR USG (Serial (V.35/X.21/RS-232)

OmniAccess 5510-AA/AB USG (ATM interface)

EXAMPLE

The following command configures a Fast Ethernet interface:ALU(config)# interface FastEthernet 0ALU(config-if FastEthernet0)#

The following command configures an ATM interface:ALU(config)# interface atm 0ALU(config-if atm0)#

The following command configures a serial interface (V.35/X.21/RS-232):ALU(config)# interface Serial 0ALU(config-if Serial0)#

Parameter Description

name Name of the interface.

port Port number of the interface.

23Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Using the Command Line Interface

Left running head: Chapter name (automatic)

INTERFACE SERIAL <PORT:CHANNEL>interface Serial <port:channel>

DESCRIPTION

This command is entered in the Configuration Mode. This command enables you to configure a serial interface on the T1/E1 controller.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510-TE USG.

EXAMPLEThe following command configures a serial interface:

ALU(config)# interface Serial 0:0ALU(config-if Serial0:0)#

Parameter Description

port:channel Port and the channel number of the interface.

24

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

interface Serial <port:subinterface-id>

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

INTERFACE SERIAL <PORT:SUBINTERFACE-ID>interface Serial <port:subinterface-id>

DESCRIPTION

This command is entered in the Configuration Mode. This command enables you to configure a sub-interface on a serial interface (if the encapsulation on the serial interface is set to Frame Relay). This enters the S-ICM.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510-SR USG.

EXAMPLE

The following command configures a sub-interface on a serial interface:ALU(config)# interface Serial 0.1ALU(config-if Serial0.1)#

Parameter Description

port:subinterface-id Port and the sub-interface number of the interface. The range for sub-interface is 0-15.

25Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Using the Command Line Interface

Left running head: Chapter name (automatic)

INTERFACE <NAME> <PORT:SUBINTERFACE-ID>interface <name> <port:subinterface-id>

DESCRIPTION

This command is entered in the Configuration Mode. This command enables you to configure a sub-interface on the Fast Ethernet (FE) interface. This enters the S-ICM.

Note: VLAN encapsulation is supported on FE in the form of FE sub-interfaces. The frames coming out of FE sub-interfaces are tagged with sub-interface indicies. Note that the complete 802.1Q (VLAN support) is not supported, but limited to VLAN encapsulation.

PARAMETERS

EXAMPLE

The following command configures a sub-interface on Fast Ethernet interface:ALU(config)# interface FastEthernet 0:1ALU(config-subif FastEthernet0:1)#

Parameter Description

name Interface name.

port:subinterface-id Port and the sub-interface number of the interface. The range for sub-interface is 1-4094.

26

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

interface Serial <port:channel.subchannel>

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

INTERFACE SERIAL <PORT:CHANNEL.SUBCHANNEL>interface Serial <port:channel.subchannel>

DESCRIPTION

This command is entered in the Configuration Mode. This command enables you to configure a sub-interface on a serial interface (if the encapsulation on the serial interface is set to Frame Relay). This enters the S-ICM.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510-TE USG.

EXAMPLE

The following command configures a sub-interface on a serial interface:ALU(config)# interface Serial 0:0.1ALU(config-if Serial0:0.1)#

Parameter Description

port:subinterface-id Port and the sub-interface number of the interface. The range for sub-interface is 0-15.

27Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Using the Command Line Interface

Left running head: Chapter name (automatic)

INTERFACE SERIAL <PORT:SUBINTERFACE-ID>interface Serial <port:subinterface-id>

DESCRIPTION

This command is entered in the Configuration Mode. This command enables you to configure a sub-interface on a serial interface (if the encapsulation on the serial interface is set to Frame Relay). This enters the S-ICM.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510-SR USG.

EXAMPLE

The following command configures a sub-interface on a serial interface:ALU(config)# interface Serial 0.1ALU(config-if Serial0.1)#

Parameter Description

port:subinterface-id Port and the sub-interface number of the interface. The range for sub-interface is 0-15.

28

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ip address

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IP ADDRESS ip address {<ip-address subnet-mask>|<ip-address/prefix-length>}

DESCRIPTION

This command is entered in the Interface Configuration Mode. Assigns an IP address and subnet mask to the interface.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-if FastEthernet0)# ip address 20.20.20.20/24

MTUmtu <64-1500>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to configure the MTU of the interface.

PARAMETERS

DEFAULT VALUE

The default MTU is 1500 bytes.

EXAMPLEALU(config-if FastEthernet0)# mtu 1000

Parameter Description

ip-address subnet-mask IP address with subnet mask.

ip-address/prefix-length IP address with prefix length.

Parameter Description

64-1500 Size of packet in bytes in the range 64 - 1500.

29Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Using the Command Line Interface

Left running head: Chapter name (automatic)

NO BACKUP INTERFACEno backup interface <interface-name>

This command is entered in the Interface Configuration Mode. This command is used to remove an interface as a backup interface.

NO SHUTDOWNno shutdown

This command is entered in the Interface Configuration Mode. This command is used to administratively bring up the interface.

SHOWshow

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command displays the interface configuration details along with the backup interface.

PARAMETERS

None.

EXAMPLEALU(config-if FastEthernet0)# show

FastEthernet0 is up, line protocol is up Hardware is Intel 82546, address is 0011.8b00.2712 (0011.8b00.2712) Internet address is not set Interface atm0.1 is backup interface MTU 1500 bytes, BW 10000 Kbit, DLY 0 usec, reliability 0/255, txload 0/255, rxload 0/255 Loopback not set Encapsulation ARPA, keepalive not set Auto-duplex(Half), Auto(10), 1000BaseTx/Fx ARP type: ARPA, ARP Timeout never Last input never, output never, output hang never Last clearing of "show interface" counters never Queueing strategy: fifo Output queue 0/0 (size/max), 0 drops; Input queue 0/0 (size/max), 0 drops 5 minute input rate 0 bits/sec, 0 packets/sec 5 minute output rate 0 bits/sec, 0 packets/sec 10 packets input, 7468 bytes, 0 no buffer Received 7 broadcasts, 0 runts, 0 giants 0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored 0 watchdog, 0 multicast, 0 pause input 0 packets output, 0 bytes, 0 underruns 0 output errors, 0 collisions, 0 interface resets 0 babbles, 0 late collision, 0 deferred 0 lost carrier, 0 no carrier, 0 pause output 0 output buffer copied, 0 interrupts, 0 failures

30

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

ALU(config-if atm0.1)# show

atm0.1 is up, line protocol is up Internet address is 3.3.3.50/24 Interface is backing FastEthernet0 interface Encapsulation pppoe keepalive set (10 sec) LCP: Open IPCP: Open VPI: 0, VCI: 33 MTU: 1492 Output queue 0/0 (size/max), 0 drops; Input queue 0/0 (size/max), 0 drops 5 minute input rate 96 bits/sec, 0 packets/sec 5 minute output rate 566936 bits/sec, 1042 packets/sec 430 packets input, 26035 bytes, 0 no buffer Received 0 broadcasts, 0 runts, 0 giants 0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored 0 watchdog, 0 multicast, 0 pause input 1927611 packets output, 143138361 bytes, 0 underruns 0 output errors, 0 collisions, 0 interface resets 0 babbles, 0 late collision, 0 deferred 0 lost carrier, 0 no carrier, 0 pause output 0 output buffer copied, 0 interrupts, 0 failures

31Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Using the Command Line Interface

Left running head: Chapter name (automatic)

SHOW HISTORYshow history

DESCRIPTION

This command is entered in the Configuration Mode. This gives the list of all commands entered in the present session, with a maximum limit of 2000 commands.

PARAMETERS

None.

EXAMPLEALU(config)# show history

1: enable2: disable3: en4: disable5: enable6: configure t7: interface FastEthernet 08: exit9: interface FastEthernet 010: ip address 10.91.0.24/2411: top12: configure t13: interface FastEthernet 014: interface switchport 315: exit16: interface switchport 217: interface switchport 118: interface switchport 019: service completion spacebar-complete20: no service completion spacebar-complete21: no service completion22: show history

32

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show interfaces brief

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW INTERFACES BRIEFshow interfaces brief

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode, or Interface Configuration Mode. This command displays information of all the IP and non-IP interfaces configured.

PARAMETERS

None.

EXAMPLEALU(config)# show interfaces brief

Interface Status ProtocolFastEthernet0 administratively down downswitchport0 administratively down downswitchport1 administratively down downswitchport2 administratively down downswitchport3 administratively down downLoopback1 up up

33Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Using the Command Line Interface

Left running head: Chapter name (automatic)

SHOW INTERFACESshow interfaces [<name>]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode, or Interface Configuration Mode.

This command displays the information of all the interfaces configured. If the interface name is specified, then the information for the specified interface is displayed.

PARAMETERS

EXAMPLE 1

ALU(config)# show interfaces FastEthernet 0

FastEthernet0 is up, line protocol is down Hardware is PowerQUICC II, address is 0000.0000.0001 (0000.0000.0001) Internet address not set MTU 1500 bytes, BW 100000 Kbit, DLY 0 usec, reliability 0/255, txload 0/255, rxload 0/255 Loopback not set Encapsulation ARPA, keepalive not set Auto-duplex, Auto, 100BaseTx/Fx ARP type: ARPA, ARP Timeout never Last input never, output never, output hang never Last clearing of "show interface" counters never Queueing strategy: fifo Output queue 0/0 (size/max), 0 drops; Input queue 0/0 (size/max), 0 drops 5 minute input rate 0 bits/sec, 0 packets/sec 5 minute output rate 0 bits/sec, 0 packets/sec 0 packets input, 0 bytes, 0 no buffer Received 0 broadcasts, 0 runts, 0 giants 0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored 0 watchdog, 0 multicast, 0 pause input 0 packets output, 0 bytes, 0 underruns 0 output errors, 0 collisions, 0 interface resets 0 babbles, 0 late collision, 0 deferred 0 lost carrier, 0 no carrier, 0 pause output 0 output buffer copied, 0 interrupts, 0 failures

Parameter Description

name Name of the interface.

34

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show interfaces

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

EXAMPLE 2ALU# show interfaces loopback 1

loopback1 is up, line protocol is up Hardware is Loopback Internet address not set MTU 1500 bytes, BW 1000000 Kbit, DLY 0 usec, reliability 0/255, txload 0/255, rxload 0/255 Encapsulation LOOPBACK, loopback not set Last input never, output never, output hang never Last clearing of "show interface" counters never Input queue: 0/0/0/0 (size/max/drops/flushes); Total output drops: (null) Queueing strategy: fifo Output queue: 0/0 (size/max) 5 minute input rate 0 bits/sec, 0 packets/sec 5 minute output rate 0 bits/sec, 0 packets/sec 0 packets input, 0 bytes Received 0 broadcasts, 0 runts, 0 giants, 0 throttles 0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored 0 packets output, 0 bytes, 0 underruns 0 output errors, 0 collisions, 0 interface resets 0 output buffer failures, 0 output buffers swapped out

35Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Using the Command Line Interface

Left running head: Chapter name (automatic)

SHOW IP INTERFACES BRIEFshow ip interfaces brief

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode, or Interface Configuration Mode. This command displays information about IP interfaces only.

PARAMETERS

None.

EXAMPLEALU(config)# show ip interface brief

Interface IP Address Status ProtocolFastEthernet0 unassigned administratively down downLoopback1 10.10.10.1 up up

SHUTDOWNshutdown

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to administratively bring down the interface.

PARAMETERS

None.

EXAMPLEALU(config-if FastEthernet0)# shutdown

36

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

System Configuration and Monitoring

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 3 SYSTEM CONFIGURATION AND MONITORING

This chapter documents the Command Line Interface (CLI) commands for configuring the basic functionalities at the system level.

This chapter includes tables of parameters, default values and configuration examples for configuring the system as quick-start and reference information. In this chapter, all commands are described in alphabetical order. For more detailed information on using and configuring OmniAccess 5510 USG, refer to the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

37Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

AAA AUTHENTICATION CONSOLEaaa authentication console <method-list-name>

DESCRIPTION

This command is entered in the Configuration Mode. This command associates an already configured method-list with the console client-type.

PARAMETERS

EXAMPLEALU(config)# aaa authentication console m1

AAA AUTHENTICATION ENABLEaaa authentication enable <method-list-name>

DESCRIPTION

This command is entered in the Configuration Mode. This command associates an already configured method-list with clients seeking access to Super User Mode.

PARAMETERS

EXAMPLEALU(config)# aaa authentication enable m1

Parameter Description

method-list-name Name of the method-list.

Parameter Description

method-list-name Name of the method-list.

38

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

aaa authentication remotelogin

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

AAA AUTHENTICATION REMOTELOGINaaa authentication remotelogin <method-list-name>

DESCRIPTION

This command is entered in the Configuration Mode. This command associates an already configured method-list with remote login client-type.

Note: The client-type 'Remote-Login' is a reference to SSH and Telnet clients.

PARAMETERS

EXAMPLEALU(config)# aaa authentication remotelogin m1

AAA AUTHENTICATION WEBaaa authentication web <method-list-name>

DESCRIPTION

This command is entered in the Configuration Mode. This command associates an already configured method-list with the web client-type (HTTP clients).

PARAMETERS

EXAMPLEALU(config)# aaa authentication web m1

Parameter Description

method-list-name Name of the method-list.

Parameter Description

method-list-name Name of the method-list.

39Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

AAA AUTHENTICATION PASSWORD-PROMPTaaa authentication password-prompt <prompt-text>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to customize the text, which is displayed to request the user trying to log in, to enter his password. The default password-prompt is "Password:".

The 'no' command brings the default back into effect.

PARAMETERS

EXAMPLEALU(config)# aaa authentication password-prompt p1

AAA AUTHENTICATION USERNAME-PROMPTaaa authentication username-prompt <prompt-text>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to customize the text, which is displayed to request the user trying to log in, to enter his user name. The default username-prompt is "Username:".

The 'no' command brings the default back into effect.

PARAMETERS

EXAMPLEALU(config)# aaa authentication username-prompt u1

Parameter Description

prompt-text The text to be used as prompt for the password.

Parameter Description

prompt-text The text to be used as prompt for the user name.

40

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

aaa pre-authentication banner

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

AAA PRE-AUTHENTICATION BANNERaaa authentication banner <delimiter> <multi-lined string> <delimiter>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to enter a descriptive message to be displayed before the user is asked for user-name and password credentials.

PARAMETERS

EXAMPLEALU(config)# aaa authentication banner @Only authorized access permitted.@

Parameter Description

delimiter Delimiting character to start the message. This character will not appear in the message to be displayed.

multi-lined string The message to be displayed before the user is asked for user-name and password credentials. (You can enter a multi-lined descriptive message.)

delimiter Used delimiting character to end the message.

41Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

AAA LOGIN-SUCCESS BANNERaaa authentication success-message <delimiter> <multi-lined string> <delimiter>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to enter a descriptive message to be displayed after a successfully authenticated login.

PARAMETERS

EXAMPLEALU(config)# aaa authentication success-message $Login attempt successfull.$

Parameter Description

delimiter Delimiting character to start the message. This character will not appear in the message to be displayed.

multi-lined string The message to be displayed after a successfully authenticated login. (You can enter a multi-lined descriptive message.)

delimiter Used delimiting character to end the message.

42

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

aaa login -fail banner

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

AAA LOGIN-FAIL BANNERaaa authentication fail-message <delimiter>< multi-lined string> <delimiter>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to enter a descriptive message to be displayed after a failed login attempt.

PARAMETERS

EXAMPLEALU(config)# aaa authentication fail-message $Login failed!$

Parameter Description

delimiter Delimiting character to start the message. This character will not appear in the message to be displayed.

multi-lined string The message to be displayed after a failed login attempt. (You can enter a multi-lined descriptive message.)

delimiter Used delimiting character to end the message.

43Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

AAA METHOD-LISTaaa method-list <name> <methods>...

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure a method-list. A method list can be successfully configured only if the lists do not contain any invalid method like – empty radius/TACACS+ groups, etc.

PARAMETERS

EXAMPLEALU(config)# aaa method-list m1 rad1 tac1 local

AAA SERVICESaaa services

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to enable the AAA services.

PARAMETERS

None.

EXAMPLEALU(config)# aaa services

Parameter Description

name Name of the method-list.

methods Authentication method to be included in the method-list.

44

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

aaa server-group radius

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

AAA SERVER-GROUP RADIUSaaa server-group radius <name>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure a RADIUS server group. This command enters the RADIUS Server- Group Mode.

Note: You cannot enter a RADIUS server group as ‘local’ or ‘enable’, as they are reserved keywords for pre-defined authentication methods.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# aaa server-group radius rad1ALU(config-rad-grp)#

Parameter Description

name Name of the RADIUS server group.

45Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

AAA SERVER-GROUP TACACSaaa server-group tacacs <name>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure a TACACS+ server group. This command enters the TACACS+ Server- Group Mode.

Note: You cannot enter a TACACS+ server group as ‘local’ or ‘enable’, as they are reserved keywords for pre-defined authentication methods.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# aaa server-group tacacs tac1ALU(config-tac-grp)#

Parameter Description

name Name of the TACACS+ server group.

46

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

certificate

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CERTIFICATEcertificate <name>

DESCRIPTION

This command is entered in the Configuration Mode. This command creates a certificate identity with the name specified to perform encryption and decryption of HTTPS connection.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# certificate ALUCA ALU(config-ALUCA)#

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

name Certificate identity.

47Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

CLEAR KNOWN_HOSTSclear known_hosts [<ip-address>]

DESCRIPTION

This command is entered in the Configuration Mode. This command enables you to clear the address key mapping for all the IP addresses/a single IP address from the known_hosts file.

SSH client maintains a list of IP addresses and associated RSA keys in the file called known_hosts.

It is not possible to initiate a SSH session with a host whose IP address and key does not match with the one stored in the known_hosts file. This mismatch can happen if the an IP address is assigned to a different host or if the key of the host is regenerated. In such cases, you have to clear the known_host file before you can successfully initiate the SSH client session. Also, the known_hosts file is not VRF aware and is based only on the IP address. Hence, it is required to clear the file before you can establish a session to the same IP address across VRFs.

PARAMETERS

EXAMPLEALU(config)# clear known_hosts

CLEAR LOGGINGclear logging

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This clears the contents of the logging buffer.

PARAMETERS

None.

EXAMPLEALU(config)# clear logging

Parameter Description

ip-address Clears the address key mapping for a specified IP address.

48

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

clear session

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CLEAR SESSIONclear session <session-id>

DESCRIPTION

This command is entered in the Configuration Mode. The command clears the session corresponding to the AAA session ID provided. This can be used to clear a misbehaving or an unnecessary session.

The session ID can be obtained from the ‘show aaa-users’ command.

PARAMETERS

EXAMPLEALU(config)# clear session 5

CLOCK SETclock set <hh:mm:ss> <mm/dd/yyyy> [timezone <zone> <sub-timezone>]

DESCRIPTION

This command is entered in the Configuration Mode. This command allows you to set the RTC as well as the system’s clock - date and time. The time must be specified as GMT/UTC. The year range is between 2000 - 2036.

PARAMETERS

EXAMPLEALU(config)# clock set 11:50:01 09/29/2009 The system clock is changed. Current setting is Tue Sep 29 11:50:01 2009

Parameter Description

session-id Clears the session corresponding to the specified AAA session ID.

Parameter Description

hh:mm:ss Time in hh:mm:ss format.

mm/dd/yyyy Date in mm/dd/yyyy format. The range ofthe year is 2000 - 2036.

timezone <zone> <sub-timezone> Use this paramter to set the clock timezone.

49Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

CLOCK SYNCHRONIZEclock synchronize [{using {ntp server <name> [vrf <vrf-name>]|rdate server <name> |rtc} [every <1-1440> minutes]

DESCRIPTION

This command is entered in the Configuration Mode. This command establishes how the chassis should synchronize its time with an external source.

Note: Currently ‘rdate’ is not supported.

PARAMETERS

EXAMPLE ALU(config)# clock synchronize using ntp server 10.91.2.87 every 120 minutes

This command has no output. To verify the settings, use the ‘show clock’ command described in this section.

Parameter Description

ntp Network Time Protocol.

vrf-name Name of the VRF.

rtc Real Time Compression protocol.

name Name of the DNS (Domain Name Server). The server name can be specified either in dotted numeric or domain name format.

1-1440 Number of minutes between the updates.

50

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

clock timezone

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CLOCK TIMEZONEclock timezone <time-zone> <sub-timezone>

DESCRIPTION

This command is entered in the Configuration Mode. This command allows you to set the time zone. This command lists the names of the time zones and the sub time zones.

PARAMETERS

DEFAULT VALUE

GMT/UTC is the default time zone.

EXAMPLE ALU(config)# clock timezone asia calcutta

Parameter Description

<zone> <sub-timezone> Specify the time zone and the sub-time zone.

51Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

COPYcopy <from-location> <to-location>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to copy files between the two locations.

PARAMETERS

EXAMPLE

The following command copies the running configuration to the config: area and renames it as startup-config.

ALU# copy running-config startup-config

The following command is used to copy the config file to the user area, fpkey, tftp, or ftp server: HTTP and HTTPS are not supported in this command.

ALU(config)# copy running-config tftp:Address name of remote host [10.91.2.87]?Remote Port [ Enter for default ] :Destination Path/File [running-config]?URL specification sanity OK, proceeding with copy (please wait)Copy successful

Parameter Description

config: Copy to config area.

fpkey: Copy from/to FPKey.

ftp: Copy through FTP from/to remote file system.

running-config Copy from/to current system configuration.

startup-config Copy from/to startup configuration.

user: Copy from/to user area.

tftp: Copy through tftp from/to remote file system.

52

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

delete all

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

DELETE ALLdelete all {fpkey:|user:}

DESCRIPTION

This command is entered in the Configuration Mode. This command deletes all the files in fpkey or user directory.

PARAMETERS

EXAMPLEALU(config)# delete all fpkey:

DELETE CONFIG-FILE delete config-file <file-name>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to delete the configuration file from the config directory.

PARAMETERS

EXAMPLEALU(config)# delete config-file my-config

Parameter Description

{fpkey:|user:} Name of the directory.

Parameter Description

file-name Name of the file to be deleted.

53Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

DELETE FP-KEY delete fpkey:<file-name>

DESCRIPTION

This command is entered in the Configuration Mode. This command deletes a file in fpkey.

Note: Enter the file name after fpkey: keyword without any space.

PARAMETERS

EXAMPLEALU(config)# delete fpkey:backup_package

DELETE USER delete user:<file-name>

DESCRIPTION

This command is entered in the Configuration Mode. This command deletes the given file from the user area.

Note: Enter the file name after user: keyword without any space.

PARAMETERS

EXAMPLEALU(config)# delete user:backup_config

Parameter Description

file-name Name of the file to be deleted.

Parameter Description

file-name Name of the file to be deleted.

54

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

dir

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

DIRdir {fpkey:|licenses|user:}

DESCRIPTION

This command is entered in the Configuration Mode. This command displays all the directories and files configured in fpkey or user location. If none of the options are given, “user” is taken by default.

PARAMETERS

EXAMPLEALU(config)# dirPermission Size Date modified Name--------- ---- ------------- ------drwx 3072 Sep 15 06:25 coresdrwx 12288 Jun 26 06:00 lost+found-rw- 30734 Sep 13 06:46 n-rw- 30664 Sep 13 06:45 test

Parameter Description

fpkey: Lists all the files in FPKey.

licenses Lists all the installed licenses.

user: Lists all the files in user directory.

55Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

ENABLE SECRETenable {secret|password} [5] <password>

DESCRIPTION

This command is entered in the Configuration Mode. This command sets the password to grant access to the Privileged Mode.

PARAMETERS

Note: The password cannot contain the '!' character as it marks the beginning of a comment.

EXAMPLEALU(config)# enable secret test Secret for level 15 is set

ALU(config)# enable password pass Secret for level 15 is set

HOSTNAMEhostname <name>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure the system name. By default the system name is ”ALU”.

PARAMETERS

EXAMPLEALU(config)# hostname ALU

Parameter Description

secret Use this keyword to store the password in an encrypted format.

5 When this keyword is used, enter the encrypted format of the password.

password The password to be used.

Parameter Description

hostname Host name of the router.

56

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

http

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

HTTPhttp {enable|disable}

DESCRIPTION

This command is entered in the Configuration Mode. Use this command to enable/disable the HTTP service.

PARAMETERS

EXAMPLEALU(config)# http enable

HTTPShttps {enable|disable}

DESCRIPTION

This command is entered in the Configuration Mode. Use this command to enable/disable the HTTPS service.

PARAMETERS

EXAMPLEALU(config)# https enable

Parameter Description

enable Enable HTTP service.

disable Disable HTTP service.

Parameter Description

enable Enable HTTPS service.

disable Disable HTTPS service.

57Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

IMPORT CA-CERT import ca-cert {<certificate-content>|fpkey <file-path> |ftp:|tftp:|http:|https:|scp:}

DESCRIPTION

This command is entered in the ca-identity mode. This command imports a CA certificate.

You also have an option to directly enter or paste the certificate content after the command. Enter upto 80 characters on a line. Enter a blank line to exit.

Note: Currently, SCP option is not supported.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-ALUCA)# import ca-cert ftp:

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

certificate-content Directly enter or paste the certificate content after the command.

fpkey <file-path> FPkey file path. To copy the certificate into the front panel USB memory.

58

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

import signed-cert

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IMPORT SIGNED-CERT import signed-cert <name> {<certificate-content>|fpkey <file-path>|ftp:|tftp:|http:|https:|scp:}

DESCRIPTION

This command is entered in the ca-identity mode. This command imports X.509 certificate signed by the CA from a remote location.

You also have an option to directly enter or paste the certificate after the command. Enter upto 80 characters on a line. Enter a blank line to exit.

Note: Currently, SCP option is not supported.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-ALUCA)# import signed-cert cert_Simpson ftp:

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

name Name that is used to identify the certificate.

certificate-content Directly enter or paste the certificate conetent after the command.

fpkey <file-path> FPkey file path. To copy the certificate into the front panel USB memory.

59Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

LINE CONSOLE BAUDRATEline console baudrate {2400|4800|9600|19200|38400|57600|115200}

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure the baud rate.

PARAMETERS

DEFAULT VALUE

Default is 9600 baud.

EXAMPLEALU(config)# line console baudrate 19200

LINE CONSOLE EXEC-TIMEOUTline console exec-timeout <0-35791> [<0-60>]

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure the timeout (in minutes or seconds) for console session. The console CLI session closes if it is idle for the specified time.

A zero input specifies that the console CLI should never exit when left idle.

PARAMETERS

DEFAULT VALUE

The default time-out is 20 minutes.

EXAMPLEALU(config)# line console exec-timeout 0

ALU(config)# line console exec-timeout 45 15

Parameter Description

2400|4800|9600|19200|38400|57600|115200

The baud rate.

Parameter Description

0-35791 Time-out in minutes.

0-60 Time-out in seconds.

60

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

line vty exec-timeout

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

LINE VTY EXEC-TIMEOUTline vty exec-timeout <0-35791> [<0-60>]

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure the timeout (in minutes or seconds) for SSH, Telnet CLI sessions. These sessions close if they are idle for the specified time. A zero input specifies that the SSH and Telnet CLI sessions should never exit when left idle.

PARAMETERS

DEFAULT VALUE

The default time-out is 20 minutes.

EXAMPLEALU(config)# line vty exec-timeout 0

ALU(config)# line vty exec-timeout 45 15

LIST CONFIG-FILESlist config-files

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to load a configuration file to the running configuration. This effectively leads to the execution of all the commands in the given file.

This file should be present in the alu-config directory. (Use the copy commands to copy the file to the alu-config directory.)

PARAMETERS

None.

EXAMPLEALU# list config-files

Permission Size Date modified Name--------- ---- ------------- -------rw- 10464 Dec 26 15:25 my-config-rw- 10461 Dec 25 08:13 startup-config

Parameter Description

0-35791 Time-out in minutes.

0-60 Time-out in seconds.

61Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

LOAD CONFIG-FILEload config-file <file-name>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to load a configuration file to the running configuration. This effectively leads to the execution of all the commands in the given file. This file should be present in the alu-config directory. (Use the copy commands to copy the file to the alu-config directory.)

PARAMETERS

EXAMPLEALU# load config-file config1Loading config1 to running-config.../-------- Percent Complete --------|*********************************

LOGGING BUFFEREDlogging buffered [priority {<0-7>|alerts |critical|debugging |emergencies|errors|informational|notifications|warnings}|size <4-1024>]

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to store the log information in the memory buffer. If a priority value is given, messages of that priority and higher (numerically lower) will be buffered.

PARAMETERS

DEFAULT VALUE

By default, logging is sent to the buffer.

EXAMPLEALU(config)# logging buffered priority 5

Parameter Description

file-name Name of the file in the alu-config directory from where the configuration is to be loaded.

Parameter Description

0-7 Priority level.

4-1024 Logging buffer size.

62

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

logging console

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

LOGGING CONSOLElogging console [<0-7>|alerts|critical|debugging|emergencies| errors|informational|notifications|warnings]

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to display the log messages of the specified priority and higher on the console.

PARAMETERS

EXAMPLEALU(config)# logging console 5

LOGGING ONlogging on

DESCRIPTION

This command is entered in the Configuration Mode. This enables logging of messages.

PARAMETERS

None.

DEFAULT VALUE

By default, logging of messages is enabled.

EXAMPLEALU(config)# logging on

Parameter Description

0-7 Priority level of the messages.

63Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

LOGGING RATE-LIMITlogging rate-limit <1-10000> [<1-3600>] {{priority <0-7>|alerts |critical|debugging|emergencies|errors|informational| notifications|warnings}|tag <string> [subtag <string>]}}

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to limit the number of messages (in the range 1-10000) generated by a process during a specified time interval. Tag and subtag string can have only one word.

PARAMETERS

DEFAULT VALUE

Default interval is 1 second.

EXAMPLE2008 Nov 16 20:46:14: %snort-5-LOG: [1:499:4] ICMP Large ICMP Packet

In the above message the tag is snort, priority is 5 and subtag is LOG.

To limit the number of messages coming from snort to, say, 5 in 2 seconds execute the following command:

ALU(config)# logging rate-limit 5 2 tag snort

2008 Dec 22 18:41:10: %CLI-6-ACL: User created Filter policy f5

In this message the sub-tag is ACL. To have finer control, the subtag of a particular tag can also be rate-limited.

To limit the number of messages coming from ACL's CLI plugin to 10 in a second, execute the following command:

ALU(config)#logging rate-limit 10 tag cli subtag acl

Parameter Description

1-10000 Permissible number of messages. Variesfrom 1-10000.

1-3600 Interval under consideration in seconds.

tag <string> The name of the process.

subtag <string> The name of the sub-process.

0-7 The priority of the message which has to be rate-limited. Messages of lower-priority will also be rate-limited.

64

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

logging rate-limit unique

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

LOGGING RATE-LIMIT UNIQUElogging rate-limit unique

DESCRIPTION

This command is entered in the Configuration Mode. This command restores the default setting and enables logging of unique messages.

PARAMETERS

None.

EXAMPLEALU(config)# logging rate-limit unique

LOGGING RATE-LIMIT NO UNIQUElogging rate-limit no unique

DESCRIPTION

This command is entered in the Configuration Mode. This command restricts the number of messages in a given interval to that specified in the rate-limiting command and prevents logging of unique messages.

By default, rate limiting does not prevent unique messages from being logged. If the number of messages does not exceed the number specified in the rate limiting command, the unique messages will continue to be logged.

No preference is given to unique messages with this command.

PARAMETERS

None.

EXAMPLEALU(config)# logging rate-limit no unique

65Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

LOGGING REMOTElogging remote <ip-address> [port <0-65535>|priority {<0-7>| alerts|critical|debugging|emergencies|errors|informational |notifications|warnings}]

DESCRIPTION

This command is entered in the Configuration Mode. Use this command to configure an external server to store log messages.

PARAMETERS

DEFAULT VALUE

The default port is 514 and the default priority level is 7.

EXAMPLEALU(config)# logging remote 1.1.1.1

Parameter Description

ip-address IP address of the external log server.

0-65535 UDP port number of the external logserver.

0-7 Priority level of the messages.

66

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

logging system

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

LOGGING SYSTEMlogging system [<0-7>|alerts|critical|debugging|emergencies |errors|informational|notifications|warnings]

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to logs all the Kernel messages.

PARAMETERS

DEFAULT VALUE

By default, messages with a priority of 5 and lower will be logged.

EXAMPLEALU(config)# logging system

LOGGING WATERMARKlogging watermark <100-10000>

DESCRIPTION

This command is entered in the Configuration Mode. To set a watermark level (in terms of number of log messages) up to which the log messages get stored.

PARAMETERS

DEFAULT VALUE

By default, no watermark level is set.

EXAMPLEALU(config)# logging watermark 10000

Parameter Description

0-7 Priority level of the messages.

Parameter Description

100-10000 Denotes the maximum number of log messages to be stored.

67Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

MKDIRmkdir {fpkey:|user:}

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to create a new directory, inside the user area or fpkey.

PARAMETERS

EXAMPLEALU(config) # mkdir fpkey:Directory []? alutest

ALU(config) # mkdir user:Directory []? alutest

NO AAA AUTHENTICATION BANNERno aaa authentication banner [<delimiter> <multi-lined string> <delimiter>]

This command is entered in the Configuration Mode. The ‘no’ command removes the configured authentication banner.

NO AAA AUTHENTICATION FAIL-MESSAGEno aaa authentication fail-message [<delimiter> <multi-lined string> <delimiter>]

This command is entered in the Configuration Mode. The ‘no’ command removes the configured authentication fail message.

NO AAA AUTHENTICATION PASSWORD-PROMPTno aaa authentication password-prompt

This command is entered in the Configuration Mode. The 'no' command brings the default password into effect. The default password-prompt is "Password:".

NO AAA AUTHENTICATION SUCCESS-MESSAGEno aaa authentication success-message [<delimiter> <multi-lined string> <delimiter>]

This command is entered in the Configuration Mode. The ‘no’ command removes the configured authentication success message.

Parameter Description

fpkey:|user: Name of the directory to be created.

68

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

no aaa authentication username-prompt

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NO AAA AUTHENTICATION USERNAME-PROMPTno aaa authentication username-prompt

This command is entered in the Configuration Mode. The 'no' command brings the default user name into effect. The default user name-prompt is "Username:".

NO AAA SERVICESno aaa services

This command is entered in the Configuration Mode. The ‘no’ command is used to disable the AAA services.

NO AAA AUTHENTICATION CONSOLEno aaa authentication console <method-list-name>

This command is entered in the Configuration Mode. The ‘no’ command removes the associated method-list from the console client-type.

NO AAA AUTHENTICATION ENABLEno aaa authentication enable <method-list-name>

This command is entered in the Configuration Mode. The 'no' command removes the associated method list from the enable client-type.

NO AAA AUTHENTICATION REMOTELOGINno aaa authentication remotelogin <method-list-name>

This command is entered in the Configuration Mode. The ‘no’ command removes the associated method list from the remote login client-type.

NO AAA AUTHENTICATION WEBno aaa authentication web <method-list-name>

This command is entered in the Configuration Mode. The ‘no’ command removes the associated method-list from the web client-type.

NO AAA METHOD-LISTno aaa method-list <name>

This command is entered in the Configuration Mode. This command deletes the specified method-list. You cannot delete a method list if it is associated to any client-type.

NO AAA SERVER-GROUP RADIUSno aaa server-group radius <name>

This command deletes the specified RADIUS server group. You cannot delete a RADIUS server group if it is associated to any method list.

69Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

NO AAA SERVER-GROUP TACACSno aaa server-group tacacs <name>

This command is entered in the Configuration Mode. This command deletes the specified TACACS+ server group. You cannot delete a TACACS+ server group if it is associated to any method list.

NO CERTIFICATEno certificate <name>

This command is entered in the Configuration Mode. This command deletes a certificate identity.

NO CLOCK SYNCHRONIZEno clock synchronize

This command is entered in the Configuration Mode. This command unconfigures the clock synchronization.

NO CLOCK TIMEZONEno clock timezone

This command is entered in the Configuration Mode. This command will remove the timezone settings, and sets it to the default, GMT/UTC.

NO ENABLE-AUTHENTICATIONno enable-authentication

This command is entered in the Configuration Mode. The ‘no’ command deletes the existing enable-password configuration, thereby disabling enable-authentication.

Note: As a result, console clients will be granted access to the enable-mode without being prompted the password.Remote clients will be denied access with the message 'No password Set'.This is the default behavior.

NO LINE CONSOLE EXEC-TIMEOUTno line console exec-timeout

This command is entered in the Configuration Mode. This command removes the time-out configured for CLI session.

70

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

no line vty exec-timeout

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NO LINE VTY EXEC-TIMEOUTno line vty exec-timeout

This command is entered in the Configuration Mode. This command removes the time-out configured for SSH and Telnet CLI sessions.

NO LOGGING BUFFEREDno logging buffered

This command is entered in the Configuration Mode. This command disables the log messages from getting stored into the memory buffer.

NO LOGGING CONSOLEno logging console

This command is entered in the Configuration Mode. This command disables the log messages from getting displayed on the console.

NO LOGGING ONno logging on

This command is entered in the Configuration Mode. This command disables the functionality of logging the messages.

NO LOGGING RATE-LIMITno logging rate-limit <1-10000> [<1-3600>] {priority <0-7>|tag <string> [subtag <string>]}

This command is entered in the Configuration Mode. The 'no' command removes the specified rate limiting configuration.

NO LOGGING REMOTEno logging remote <ip-address> [port <0-65535> priority <0-7>]

This command is entered in the Configuration Mode. This command disables logging messages from getting directed to an external server.

NO LOGGING SYSTEMno logging system

This command is entered in the Configuration Mode. This command disables the functionality of logging of Kernel messages.

NO LOGGING WATERMARKno logging watermark

This command is entered in the Configuration Mode. This command disables the watermark functionality.

71Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

NO RADIUS-SERVERno radius-server [vrf <vrf-name>] <ip-address>

This command is entered in the the RADIUS Server Group Mode. This command removes the RADIUS Server from the server group.

NO RADIUS-SERVER AUTH-PORTno radius-server auth-port

This command is entered in the Configuration Mode. The ‘no’ command deletes the global RADIUS auth-port from the configuration, and resets it to default (for all servers that do not have a server specific port).

NO RADIUS-SERVER DEADTIMEno radius-server deadtime

This command is entered in the Configuration Mode. The ‘no’ command deletes the global RADIUS deadtime value from the configuration, and resets it to default (for all servers that do not have a server specific deadtime value).

NO RADIUS-SERVER KEYno radius-server key

This command is entered in the Configuration Mode. The ‘no’ command deletes the global RADIUS key from the configuration, and resets it to default (for all servers that do not have a server specific key).

NO RADIUS-SERVER RETRANSMITno radius-server retransmit

This command is entered in the Configuration Mode. The ‘no’ command deletes the global RADIUS retrasmit value from the configuration, and resets it to default (for all servers that do not have a server specific retransmit value).

NO RADIUS-SERVER TIMEOUTno radius-server timeout

This command is entered in the Configuration Mode. The ‘no’ command deletes the global RADIUS timeout value from the configuration, and resets it to default (for all servers that do not have a server specific timeout value).

NO SERVICE TIMESTAMPS LOGno service timestamps log

This command is entered in the Configuration Mode. This command disables the date and time display in the log messages.

72

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

no snmp agent

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NO SNMP AGENTno snmp agent {rocommunity|rwcommunity}

This command removes read-only/read-write community string configured on the SNMP agent.

NO SNMP-SERVER ACCESS no snmp-server access <group-name> security-model {v1|v2c|v3} {auth|noauth|priv}

This command is entered in the Configuration Mode. This command removes the access control configuration.

NO SNMP-SERVER GROUP no snmp-server group <group-name> <security-name> security-model {v1|v2c|v3}

This command is entered in the Configuration Mode. This command removes the configured USM group.

NO SNMP-SERVER USER no snmp-server user <user-name>

This command is entered in the Configuration Mode. This command deletes a SNMPv3 user.

NO SNMP-SERVER VIEW no snmp-server view <view-name> <MIB-family-name>

This command is entered in the Configuration Mode. This command deletes a view.

NO SNMP SYSTEMno snmp system {contact|location|name}

This command is entered in the Configuration Mode. This command removes the specified SNMP system details.

NO SNMP TRAPno snmp trap <ip-address> {v1|v2c} <1-65536> vrf <vrf-name>

This command is entered in the Configuration Mode. This command removes the SNMP trap configuration.

NO SNMP TRAP ENABLEno snmp trap enable

This command is entered in the Configuration Mode. This command disables sending the SNMP traps to the configured host.

73Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

NO TACACS-SERVER no tacacs-server <ip-address>

This command is entered in the TACACS+ Server Group Mode. This command removes a TACACS+ Server from the server group.

NO TACACS-SERVER AUTH-PORTno tacacs-server auth-port

This command is entered in the Configuration Mode. The ‘no’ command deletes the global TACACS+ auth-port from the configuration, and resets it to default (for all servers that do not have a server specific port).

NO TACACS-SERVER KEYno tacacs-server key

This command is entered in the Configuration Mode. The ‘no’ command deletes the global TACACS+ key from the configuration, and resets it to default (for all servers that do not have a server specific key).

NO TACACS-SERVER TIMEOUTno tacacs-server timeout

This command is entered in the Configuration Mode. The ‘no’ command deletes the global TACACS timeout value from the configuration, and resets it to default (for all servers that do not have a server specific timeout value).

NO USERNAME no username <user-name>

This command is entered in the Configuration Mode. The ‘no’ command deletes the specified user account.

74

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

package backup

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

PACKAGE BACKUPpackage backup {fpkey:|ftp:|tftp:|user:|vrf <vrf-name>}

DESCRIPTION

This command is entered in the Configuration Mode. Backs up the default package at a given destination. The backup file can be stored in user area or fpkey. The backup file can be stored in user area or fpkey. It can also be sent to a remote location using ftp or tftp.

PARAMETERS

EXAMPLE

The default package can be backed-up locally in user: or fpkey: or in a remote location using ftp or tftp.

ALU(config)# package backup ftp:Remote Host : 10.91.2.87Remote Port [ Enter for default ] :Path : backup-alu-apps.5510.3.0.0.81.0.npmUsername [Enter for none] : user1Password :

Backing up Applications package... Creating...Uploading file. This could take a while...Completed.

Parameter Description

fpkey: Backup the default package to fpkey.

ftp: Backup the default package to a remote location using ftp.

tftp: Backup the default package to a remote location using tftp.

user: Backs-up the default package in user area.

vrf-name Backup the default package to a remote location through an interface associated with the specified VRF.

75Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

PACKAGE INSTALLpackage install {fpkey:|ftp:|http:|https:|tftp:|user:|vrf <vrf-name>}

DESCRIPTION

This command is entered in the Configuration Mode. This command installs a release or a component package from the given location. The package file can be obtained from the user area or fpkey: or it can be obtained from a remote site using FTP, TFTP, HTTP, or HTTPS.

Note: If the package is installed from a remote location, it is temporarily downloaded into the user area, and deleted after the installation. So care must be taken to have enough space for the package before proceeding with the installation.

PARAMETERS

EXAMPLE

The following command installs a package after downloading it from remote site using ftp:ALU(config)# package install ftp:Remote Host : 10.91.0.87Remote Port [ Enter for default ] :Path/Filename : /packages/alu-apps.5510.3.0.0.81.0.npmUsername [Enter for none] : user1Password :Downloading remote file. This could take a while...Verifying package... NPM v1.0 formatOK.

Parameter Description

fpkey: Install the package from fpkey:

ftp: Download the package to be installed through ftp from remote file system.

http: Download the package to be installed through http from remote file system.

https Download the package to be installed through https from remote file system.

tftp Download the package to be installed through tftp from remote file system.

user: Install the package from user area.

vrf-name Download the package to be installed through an interface associated with the specified VRF.

76

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

package install

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

Checking the package type ... Release: 3.0.0.81.0

Are you sure you want to install alu-apps.5510.3.0.0.81.0.npm? (y/[n]) : y

Installing new release alu-apps.5510.3.0.0.81.0.npm...OK.Complete.Deleting temporary file...OK.

Do you want to set-default immediately? Yes: Chassis will be rebooted automatically No : Manually run set-default at a later timeProceed? (y/[n]) : y

Do you want to save config before proceeding ([y]/n) : yBuilding configuration...[OK]Setting Default image to 3.0.0.81.0...

77Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

PACKAGE INSTALL FLASHpackage install flash {fpkey:|ftp:|http:|https:|tftp:|user:|vrf <vrf-name>}

DESCRIPTION

This command is entered in the Configuration Mode. This command installs a flash image on the system. The package file can be obtained from the user area or fpkey: or it can be obtained from a remote site using FTP, TFTP, HTTP, or HTTPS.

PARAMETERS

EXAMPLEALU(config)# package install flash user:Path/Filename : fw-5510-2.0.npmThe system will need to reboot after a flash upgradeDo you want to continue? (y/[n]) : yDo you want to save config before proceeding ([y]/n) : nVerifying and Extracting firmware image==================================Checking for free space in User area...OKExtracting firmware image...OK

Verifying and Decompressing flash images========================================Verifying and decompressing...OK

Firmware Version : 2.0Status DoneFlash updated successfully

Parameter Description

fpkey: Install the flash image from fpkey:

ftp: Download the flash image to be installed through ftp from remote file system.

http: Download the flash image to be installed through http from remote file system.

https: Download the flash image to be installed through https from remote file system.

tftp Download the flash image to be installed through tftp from remote file system.

user: Install the flash image from user area.

vrf-name Download the flash image to be installed through an interface associated with the specified VRF.

78

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

package remove

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

PACKAGE REMOVEpackage remove <package-name>

DESCRIPTION

This command is entered in the Configuration Mode. This command removes the specified package. However, the default package cannot be removed.

PARAMETERS

EXAMPLE

To remove 3.0.0.80.0 package:

ALU(config)# package remove 3.0.0.80.0Remove package 3.0.0.80.0? (y/[n]) : yUninstalling application package 3.0.0.80.0...OK.

Parameter Description

package-name Name of the package to be removed.

79Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

PACKAGE SET-DEFAULTpackage set-default <package-name>

DESCRIPTION

This command is entered in the Configuration Mode. If the specified package is not the default package, it is set as default.

The system can have multiple application packages (like 3.0.0.80.0, 3.0.0.80.1). The package being set as default should exist in the system.

PARAMETERS

EXAMPLE

To set the package 3.0.0.80.0 as default:

ALU(config)# package set-default 3.0.0.80.0

Do you want to activate 3.0.0.80.0 immediately? Yes: Chassis will be rebooted automatically No : Manually run set-default at a later timeProceed? (y/[n]) : y

Do you want to save config before proceeding ([y]/n) : yBuilding configuration...[OK]

Setting 3.0.0.80.0 as the default image...OK.

Parameter Description

package-name Name of the package to be set as default.

80

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ping

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

PINGping [vrf <vrf-name>] {<ip-address>|<hostname>}

DESCRIPTION

This command is entered in the Configuration Mode. Use this command to check the connectivity between OmniAccess 5510 USG and any remote machine.

PARAMETERS

EXAMPLEALU(config)# ping 192.168.10.121

Sending 5,64-byte ICMP Echos to 192.168.10.121,timeout is 10 seconds !!!!!Success rate is 100 percent (5/5), round-trip min/avg/max = 0.124/0.191/0.356 ms

Parameter Description

vrf-name If the VRF name is specified, the packets will be routed using the routing table of the specified VRF on a interface associated with the VRF.

ip-address IP Address of the remote host.

hostname Name of the host.

81Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

RADIUS-SERVER radius-server [vrf <vrf-name>] <ip-address> [{auth-port <0-65535>|deadtime <1-1440>|key <string>|retransmit <1-100>|timeout <1-1000>}]

DESCRIPTION

This command is entered in the RADIUS Server Group Configuration Mode.

This command is used to add the RADIUS server of the specified IP address to a RADIUS server group.

PARAMETERS

EXAMPLEALU(config-rad-grp)# radius-server 1.1.1.1

Parameter Description

vrf-name Name of the VRF.

ip-address IP address of the remote RADIUS server to be added to the group.

auth-port <0-65535> Destination port on which RADIUS server is listening.

deadtime <1-1440> The time (in minutes) that should elapse, before you try again to connect to a non-responding server.

key <string> The key string between OmniAccess 5510 USG and the radius server.

retransmit <1-100> Number of retries after each “timeout” interval, before giving up on the server.

timeout <1-1000> Number of seconds that OmniAccess 5510 USG should wait for a reply from the RADIUS server before retrying.

82

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

radius-server auth-port

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

RADIUS-SERVER AUTH-PORTradius-server auth-port <0-65535>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to specify a global authentication port that will be applied to all the Radius Server groups (provided there is no server specific port configured).

PARAMETERS

DEFAULT VALUE

The default authentication port is 1812.

EXAMPLEALU(config)# radius-server auth-port 1800

RADIUS-SERVER DEADTIMEradius-server deadtime <1-1440>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to specify a global deadtime value that will be applied to all the RADIUS Server groups (provided there is no server specific deadtime configured).

PARAMETERS

DEFAULT VALUE

The default deadtime value is 5 minutes.

EXAMPLEALU(config)# radius-server deadtime 10

Parameter Description

auth-port <0-65535> Destination port on which RADIUS server is listening.

Parameter Description

deadtime <1-1440> The time (in minutes) that should elapse, before you try again to connect to a non-responding server.

83Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

RADIUS-SERVER KEYradius-server key {5 [<string>]|<string>}

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to specify a global key that will be applied to all the RADIUS groups (provided there is no server specific key configured).

PARAMETERS

DEFAULT VALUE

The default key is “” (empty string).

EXAMPLEALU(config)# radius-server key test

RADIUS-SERVER RETRANSMITradius-server retransmit <1-100>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to specify a global retransmit value that will be applied to all the RADIUS groups (provided there is no server specific retrasmit value configured).

PARAMETERS

DEFAULT VALUE

The default retrasmit value is 3.

EXAMPLEALU(config)# radius-server retransmit 5

Parameter Description

string The key string.

5 When this keyword is used, enter the encrypted format of the key.

Parameter Description

retransmit <1-100> Number of retries after each “timeout” interval, before giving up on the server.

84

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

radius-server timeout

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

RADIUS-SERVER TIMEOUTradius-server timeout <1-1000>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to specify a global timeout value that will be applied to all the RADIUS groups (provided there is no server specific timeout value configured).

PARAMETERS

DEFAULT VALUE

The default timeout value is 5 seconds.

EXAMPLEALU(config)# radius-server timeout 10

RELOADreload [line]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode.

The reload command can be used to reload the system. Reload is immediate and once issued cannot be revoked. Hence, confirmation is required before the command is actually accepted. Reload has the same effect as power cycling the chassis. This is also referred as a soft reboot.

PARAMETERS

EXAMPLEALU(config)# reloadDo you really want to reboot the Chassis (y/[n])?yDo you want to save config before rebooting (y/[n])nRestarting system.

Parameter Description

timeout <1-1000> Number of seconds that OmniAccess 5510 USG should wait for a reply from the RADIUS server before retrying.

Parameter Description

line Short description as to why the system is being reloaded.

85Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

RELOAD FACTORY DEFAULTSreload factory defaults

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to reload OmniAccess 5510 USG with the factory default configuration. When this command is executed, the startup configuration is erased, and the chassis is rebooted with the factory default configuration.

PARAMETERS

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# reload factory defaultsSystem will boot with factory default configurationALL current config will be lostDo you really want to continue (y/[n])?

RELEASE HISTORY

Release 3.0: command was introduced.

86

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

rmdir

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

RMDIRrmdir {fpkey:|user:}

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to remove the specified directory, from the user area or fpkey.

PARAMETERS

EXAMPLEALU(config)# rmdir user:Directory []? abcdeleted directory abc

SAVE RUNNING-CONFIGsave running-config

DESCRIPTION

This command is entered in the Configuration Mode. This command saves the running configuration to the start-up configuration.The command "write memory" can also be used to save the running configuration to the start-up configuration.

PARAMETERS

None.

EXAMPLEALU# save running-configSaving to startup-config ...

Parameter Description

fpkey:|user: Directory Name.

87Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

SAVE RUNNING-CONFIG FILE-NAMEsave running-config <file-name>

DESCRIPTION

This command is entered in the Configuration Mode. This command saves the running configuration under the specified file name in the config directory.

PARAMETERS

EXAMPLEALU# save running-config my-config

Saving to my-config ...

SAVE LOGGINGsave logging

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to save the information in the log buffer. By default, the information is saved in the user:log/default.log file.

PARAMETERS

None.

EXAMPLEALU# save logging

Parameter Description

file-name Name of the file where you want to save the running configuration.

88

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

save logging file name

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SAVE LOGGING FILE NAMEsave logging filename {fpkey:|user:}

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to save the log messages with the file name provided in the front-panel USB or entered by the user in the user area.

PARAMETERS

EXAMPLEALU# save logging filename user:logs

This saves the log messages to a file named logs in the ALU user area.

SAVE LOGGING PRIORITYsave logging priority [<0-7>|alerts|critical|debugging| emergencies|errors|informational|notifications|warnings]

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to save the log messages of the specified priority and higher.

PARAMETERS

EXAMPLEALU# save logging priority 5

This saves all log messages of priority warning (= 4) and higher. i.e. all messages from (0 -4) priorities are stored. By default, messages up to informational level (= 6) are stored.

ALU# save logging priority 5 exact

This saves log messages with priority equal to 5.

Parameter Description

fpkey:|user: Name of the file under which you can save the log messages.

Parameter Description

0-7 Priority of the log messages to be saved.

89Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

SAVE LOGGING STRINGsave logging string <string-value>

DESCRIPTION

This command is entered in the Configuration Mode. This command saves all the messages, which holds the value of the specified string.

PARAMETERS

EXAMPLE

ALU# save logging string time

This saves log messages with string time. This is case sensitive.

SAVE LOGGING TAGsave logging tag <tag-name>

DESCRIPTION

This command is entered in the Configuration Mode. This command saves all the messages that come from a particular process specified by the tag.

PARAMETERS

EXAMPLE

ALU# save logging tag cli

This saves log messages originating from CLI.

Parameter Description

string-value String value of the log messages to be saved.

Parameter Description

tag-name Name of the of the log messages to be saved.

90

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

service timestamps log

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SERVICE TIMESTAMPS LOGservice timestamps log

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to display the date and time of the log messages.

PARAMETERS

None.

DEFAULT VALUE

By default, Service timestamps log is enabled.

EXAMPLEALU(config)# service timestamps log

91Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

SHOW AAA show aaa

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. Displays all the AAA configuration details.

PARAMETERS

None.

EXAMPLEaaa services!username admin password 5 21232f297a57a5a743894a0e4a801fc3username recovery password 5 e35dfd3c8ba8a900381051844a603a6eusername superadmin password 5 21232f297a57a5a743894a0e4a801fc3enable password 5 21232f297a57a5a743894a0e4a801fc3!!!!aaa authorization disable

!

SHOW AAA-CLIENT-METHODLIST-ASSOCIATIONSshow aaa-client-methodlist-associations

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the associations between client types and method-lists.

PARAMETERS

None.

EXAMPLEALU(config)# show aaa-client-methodlist-associations

aaa authentication remotelogin m2 aaa authentication web m1

92

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show aaa-local-users-details

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW AAA-LOCAL-USERS-DETAILSshow aaa-local-users-details

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the details of all the locally configured users on the system.

PARAMETERS

None.

EXAMPLEALU(config)# show aaa-local-users-details

username admin password 5 21232f297a57a5a743894a0e4a801fc3username recovery password 5 e35dfd3c8ba8a900381051844a603a6eusername superadmin password 5 21232f297a57a5a743894a0e4a801fc3

SHOW AAA-METHODLISTSshow aaa-methodlists

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays all the configured method-lists on the system.

PARAMETERS

None.

EXAMPLEALU(config)# show aaa-methodlists

aaa method-list m1 rad1 tac1 localaaa method-list m2 tac1

93Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

SHOW AAA-RADIUSshow aaa-radius

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command shows the details of the RADIUS Server groups configured.

PARAMETERS

None.

EXAMPLEALU(config)# show aaa-radius

!aaa server-group radius rad1radius-server 1.1.1.1!!aaa server-group radius rad3radius-server 1.1.1.1 auth-port 300!

SHOW AAA-TACACSshow aaa-tacacs

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command shows the details of all the TACACS+ Server groups configured.

PARAMETERS

None.

EXAMPLEALU(config)# show aaa-tacacs!aaa server-group tacacs tac1tacacs-server 12.34.42.2tacacs-server 23.4.2.232 auth-port 2050 key some!

94

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show aaa-users

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW AAA-USERSshow aaa-users

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. The command displays the AAA session details, such as client type, session ID, user name, and the remote address of all the currently logged-in users.

PARAMETERS

None.

EXAMPLEALU(config)# show aaa-users

Session-ID UserName ClientType Remote-Address*1 superadmin Console N.A 2 guest SSH 10.91.2.87 3 firewall-admin TELNET 154.34.222.1 4 superadmin HTTP 143.23.34.12

SHOW ACCESS-SERVER STATUS show access-server status

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to see the list of inband-management services that are currently enabled.

PARAMETERS

None.

EXAMPLE

ALU(config)# show access-server statushttp enablehttps enablessh enable

95Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

SHOW CONFIG-FILEshow config-file [<file-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to show the contents of the specified configuration file.

PARAMETERS

EXAMPLEALU# show config-file my-config

!Current Configuration:!! NVRAM config last updated at 00:59:49 GMT Fri Sep 26 2008 by superadmin! Statlog Configuration!logging onlogging buffered priority 7logging buffered size 128logging console 3logging system 5service timestamps loglogging rate-limit 1 10 tag SWE subtag DOSlogging rate-limit 1 10 tag PVSTD subtag PKTlogging rate-limit 1 10 tag SWE subtag SESSION!!VRF Configuration!! MULTICAST Configuration!NOE port reservation!!!! SNMP Configurations!!aaa services!username recovery password 5 c69ab28cffbe009202b1dcf79f025b04username superadmin password 5 8ec760e45da5b29afb19ed8d68a3eb5e!!!!!interface FastEthernet0 shutdown top

Parameter Description

file-name File name whose contents need to be displayed.

96

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show config-file

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

!interface switchport0 shutdown top!interface switchport1 shutdown top!interface switchport2 shutdown top!interface switchport3 shutdown top!!!! Filter Policy configuration!!!! Dos attack configuration!!!!Snort configurationfirewall intrusion snorttop!!! Firewall configuration!!! IPSEC Policy configuration!

!

!!QoS Configuration!!!Customized-Services!!!top!!! DHCP Server Configuration!!

top!end

97Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

SHOW CERTIFICATE CA-CERT show certificate ca-cert [<name> [pem]]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. Displays the details of the all/specified CA certificate in a readable format.

PARAMETER

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show certificate ca-cert ALUCA

Certificate: Data: Version: 3 (0x2) Serial Number: 0 (0x0) Signature Algorithm: md5WithRSAEncryption Issuer: CN=CA_0x01, O=ALU Validity Not Before: Dec 28 12:30:49 2005 GMT Not After : Jan 27 12:30:49 2006 GMT Subject: CN=CA_0x01, O=ALU Subject Public Key Info: Public Key Algorithm: rsaEncryption RSA Public Key: (1024 bit) Modulus (1024 bit): 00:b2:bf:d4:a9:46:f0:d3:38:3c:46:e1:52:0e:e4: 31:1c:0c:81:70:90:1a:95:dd:79:44:c6:e3:1b:c6: a3:ec:d7:d5:18:9e:c2:d0:14:a3:8c:35:c0:34:e1: 9f:ff:2c:ae:fd:0e:b2:6f:5a:59:3e:c8:67:e8:f8: a7:a2:ba:84:d9:e5:0a:cc:af:e0:cf:67:36:a4:e6: f5:22:d5:88:72:3c:aa:85:be:92:06:87:78:6a:6e: 69:3b:ab:73:bd:c0:5c:eb:85:1d:18:76:c4:f8:aa: a9:c1:bb:14:1f:15:38:cc:8f:8c:e6:5c:3c:a1:b8: 10:4b:1a:98:c2:7d:b4:d0:cd Exponent: 65537 (0x10001) X509v3 extensions: X509v3 Subject Key Identifier: 05:98:D2:25:D3:18:12:A1:C7:4B:7A:98:D2:D8:25:73:2B:6B:AE:B1 X509v3 Authority Key Identifier: keyid:05:98:D2:25:D3:18:12:A1:C7:4B:7A:98:D2:D8:25:73:2B:6B:AE:B1 DirName:/CN=CA_0x01/O=ALU

Parameter Description

name Name of the CA certificate.

pem If ‘pem’ option is specified, the command displays the details of the specified CA certificate in the base64 pem format.

98

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show certificate ca-cert

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

serial:00

X509v3 Basic Constraints: CA:TRUE Signature Algorithm: md5WithRSAEncryption 0c:0b:92:9c:1d:60:ac:62:e0:7f:f3:1d:9c:7b:e8:de:67:09: 43:a1:2e:47:d1:78:c1:17:f6:0c:aa:ef:51:55:e2:9b:5f:8a: 0e:9f:ba:51:55:57:48:2b:4c:8f:f7:6b:7c:65:4b:cf:99:b2: dc:83:2d:da:99:63:0c:ad:6b:33:66:19:91:ef:35:cb:dd:d8: 74:48:34:a6:40:c2:f0:8d:b6:8a:32:63:8c:f0:82:14:14:5a: a3:56:de:b1:50:42:6f:b3:0f:ea:f1:26:be:2e:ce:9e:61:f5: 24:c3:88:ab:13:42:70:82:80:f9:f1:d2:8f:02:d5:5b:62:ff: 3e:cc

ALU(config)# show certificate ca-cert ALUCA pem

-----BEGIN CERTIFICATE-----MIICMjCCAZugAwIBAgIBADANBgkqhkiG9w0BAQQFADAhMRAwDgYDVQQDFAdDQV8weDAxMQ0wCwYDVQQKEwROZXRkMB4XDTA1MTIyODEyMzA0OVoXDTA2MDEyNzEyMzA0OVowITEQMA4GA1UEAxQHQ0FfMHgwMTENMAsGA1UEChMETmV0ZDCBnzANBgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEAsr/UqUbw0zg8RuFSDuQxHAyBcJAald15RMbjG8aj7NfVGJ7C0BSjjDXANOGf/yyu/Q6yb1pZPshn6PinorqE2eUKzK/gz2c2pOb1ItWIcjyqhb6SBod4am5pO6tzvcBc64UdGHbE+KqpwbsUHxU4zI+M5lw8obgQSxqYwn200M0CAwEAAaN6MHgwHQYDVR0OBBYEFAWY0iXTGBKhx0t6mNLYJXMra66xMEkGA1UdIwRCMECAFAWY0iXTGBKhx0t6mNLYJXMra66xoSWkIzAhMRAwDgYDVQQDFAdDQV8weDAxMQ0wCwYDVQQKEwROZXRkggEAMAwGA1UdEwQFMAMBAf8wDQYJKoZIhvcNAQEEBQADgYEADAuSnB1grGLgf/MdnHvo3mcJQ6EuR9F4wRf2DKrvUVXim1+KDp+6UVVXSCtMj/drfGVLz5my3IMt2pljDK1rM2YZke81y93YdEg0pkDC8I22ijJjjPCCFBRao1besVBCb7MP6vEmvi7OnmH1JMOIqxNCcIKA+fHSjwLVW2L/Psw=-----END CERTIFICATE-----

RELEASE HISTORY

Release 3.0: command was introduced.

99Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

SHOW CERTIFICATE IDENTITYshow certificate identity <name>

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. Displays all the certificate identities and also displays the specified certificate.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show certificate identity

certificate SomeOtherCA subject-name /O=ALU/C=IN/CN=CM Burnscertificate ALUCA subject-name /CN=Bart Simpson/O=ALU/C=US

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

name Name of the certificate.

100

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show certificate signed-cert

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW CERTIFICATE SIGNED-CERTshow certificate signed-cert [<name> [pem]]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. Displays the names of all the signed certificates. And, details of the specified signed certificate in a readable format.

If the signed-cert name is specified, it displays the details of only that signed certificate.

If the "pem" option is used, then the certificate/CRL will be displayed in base64 PEM format.

PARAMETER

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show certificate signed-cert

cert_Simpsoncert_Burn

ALU(config)# show certificate signed-cert cert_Simpson

Certificate: Data: Version: 3 (0x2) Serial Number: 8 (0x8) Signature Algorithm: md5WithRSAEncryption Issuer: CN=CA_0x01, O=ALU Validity Not Before: Jan 27 09:22:03 2006 GMT Not After : Jan 27 09:22:03 2007 GMT Subject: C=US, O=ALU, CN=Bart Simpson Subject Public Key Info: Public Key Algorithm: rsaEncryption RSA Public Key: (512 bit) Modulus (512 bit): 00:ba:f3:af:cf:09:49:f4:ef:13:df:a7:e3:ee:28: 32:b5:ef:06:e2:f8:c9:31:6d:44:44:81:d2:3f:49: 82:c9:6b:5a:d1:73:d0:7b:af:3f:5e:82:34:15:54: 49:a7:d3:5e:69:29:c4:72:57:25:6a:ee:02:f8:2c: dd:59:2f:03:ad Exponent: 65537 (0x10001) X509v3 extensions: X509v3 Basic Constraints:

Parameter Description

name Name of the signed certificate.

101Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

CA:FALSE Netscape Comment: OpenSSL Generated Certificate X509v3 Subject Key Identifier: 88:75:2D:47:AC:E8:AB:C3:5F:9F:E1:93:6B:7E:07:9C:A3:B0:24:CB X509v3 Authority Key Identifier: keyid:05:98:D2:25:D3:18:12:A1:C7:4B:7A:98:D2:D8:25:73:2B:6B:AE:B1 DirName:/CN=CA_0x01/O=ALU serial:00

Signature Algorithm: md5WithRSAEncryption 0c:30:3a:96:bb:2a:be:6c:53:47:b9:5d:b4:40:1d:0e:4a:85: f3:99:57:82:07:58:a1:bf:f6:36:3a:03:9b:81:7a:3d:6c:fa: b7:24:70:78:c4:15:75:4a:58:69:ad:aa:3d:82:f1:ae:1a:76: 82:79:b9:43:05:26:b8:34:cc:59:ee:b6:0b:82:4b:a2:70:2a: 2a:72:4c:1a:c7:a8:74:30:fb:24:52:21:b9:2f:ef:b9:56:ae: f1:45:75:0b:46:2f:e4:94:ec:8c:b6:99:47:a8:68:c3:a8:0c: e3:56:f0:bc:54:53:02:ed:c0:17:1e:72:be:7b:fd:11:76:91: 05:db

ALU(config)# show certificate signed-cert cert_Simpson pem

-----BEGIN CERTIFICATE-----MIICLTCCAZagAwIBAgIBCDANBgkqhkiG9w0BAQQFADAhMRAwDgYDVQQDFAdDQV8weDAxMQ0wCwYDVQQKEwROZXRkMB4XDTA2MDEyNzA5MjIwM1oXDTA3MDEyNzA5MjIwM1owMzELMAkGA1UEBhMCVVMxDTALBgNVBAoTBE5ldEQxFTATBgNVBAMTDEJhcnQgU2ltcHNvbjBcMA0GCSqGSIb3DQEBAQUAA0sAMEgCQQC686/PCUn07xPfp+PuKDK17wbi+MkxbUREgdI/SYLJa1rRc9B7rz9egjQVVEmn015pKcRyVyVq7gL4LN1ZLwOtAgMBAAGjgaYwgaMwCQYDVR0TBAIwADAsBglghkgBhvhCAQ0EHxYdT3BlblNTTCBHZW5lcmF0ZWQgQ2VydGlmaWNhdGUwHQYDVR0OBBYEFIh1LUes6KvDX5/hk2t+B5yjsCTLMEkGA1UdIwRCMECAFAWY0iXTGBKhx0t6mNLYJXMra66xoSWkIzAhMRAwDgYDVQQDFAdDQV8weDAxMQ0wCwYDVQQKEwROZXRkggEAMA0GCSqGSIb3DQEBBAUAA4GBAAwwOpa7Kr5sU0e5XbRAHQ5KhfOZV4IHWKG/9jY6A5uBej1s+rckcHjEFXVKWGmtqj2C8a4adoJ5uUMFJrg0zFnutguCS6JwKipyTBrHqHQw+yRSIbkv77lWrvFFdQtGL+SU7Iy2mUeoaMOoDONW8LxUUwLtwBcecr57/RF2kQXb-----END CERTIFICATE-----

RELEASE HISTORY

Release 3.0: command was introduced.

102

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show chassis

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW CHASSISshow chassis

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the chassis hardware information and chassis temperature reading.

PARAMETERS

None.

EXAMPLEALU(config)#> show chassis

Physical inventory at Thu Jan 1 00:37:02 1970 System started approximately Thu Jan 1 00:00:18 1970 Uptime is 0 days 0 hours 36 minutes 44 seconds Current temperature is 34.5 Celsius

OA5510 - OA5510-SR (active) Part number: 050503-28T Module type: 00002002 Serial number: J4380193 Revision: 201 FRU#: 902697-90 Format: 3 Base MAC (MAC bank 1): 00:11:8b:00:11:11

SHOW CLOCKshow clock

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the RTC and system’s operational date and time.

PARAMETERS

None.

EXAMPLEALU(config)# show clock

RTC set to Wed Jul 15 15:42:39 2009System time is Wed Jul 15 21:12:39 IST 2009Timezone set to ASIA/CALCUTTAConfigured to synchronize using RTC every 10 minutesLast successful synchronization : 12 secs ago

103Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

SHOW INBAND SESSIONSshow inband sessions

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the inband sessions.

PARAMETERS

None.

EXAMPLEALU(config)# show inband sessions

Local IP Foreign IP Protocol State135.250.26.202:80 135.250.26.187:3763 TCP ESTABLISHED135.250.26.202:23 135.250.26.187:3773 TCP ESTABLISHED

104

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show logging

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW LOGGINGshow logging

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays log messages with priority 6 and higher.

PARAMETERS

None.

EXAMPLEALU(config)# show logging!! Statlog Configuration!statlog global logging: enabledbuffer logging: level debugging (7)buffer logging: size (128 k)buffer logging: used (4.46%)console logging: level errors (3)system logging: level notifications (5)logging timestamp : enabledlogging rate-limit: tag SWE,subtag DOS,upto 1 messages in 10 secondslogging rate-limit: tag PVSTD,subtag PKT,upto 1 messages in 10 secondslogging rate-limit: tag SWE,subtag SESSION,upto 1 messages in 10 seconds!2009 Feb 12 12:13:18: %sshd-6-LOG: Server listening on 0.0.0.0 port 22.2009 Feb 12 12:13:18: %AAAMgr-6-AAA: Local User Database Updated byUser-superadmin@boot-time2009 Feb 12 12:13:18 UTC: %AAAMgr-6-AAA: AAA services enabled by [email protected] Feb 12 12:13:19: %snort-5-LOG: Detection:2009 Feb 12 12:13:19: %snort-5-LOG: Search-Method = Low-Mem Trie2009 Feb 12 12:13:23: %AAAMgr-6-AAA: Connection with RIB MGR Succeded--More--

105Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

SHOW LOGGING PRIORITYshow logging priority [<0-7>|alerts|critical|debugging |emergencies|errors|informational|notifications|warnings]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. Displays the log messages of specified priority and higher (numerically lower).

PARAMETERS

DEFAULT VALUE

Default priority is 7.

EXAMPLEThe following example shows messages of priority 3 or higher.

ALU(config)# show logging priority 3

2008 Oct 13 04:41:30:%MIM-1-LOG:Interface FastEthernet0,changed state to down2008 Oct 13 04:41:30: %MIM-1-LOG: Line protocol on InterfaceFastEthernet0, changed state to down2008 Oct 13 14:13:06: %ntpdate-3-LOG: No server suitable for synchronization found

The following example shows only the messages with priority 3.

ALU(config)# show logging priority 3 exact

2008 Oct 13 14:13:06: %ntpdate-3-LOG: No server suitable for synchronization found

Parameter Description

0-7 Range of priority level.

106

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show logging string

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW LOGGING STRING show logging string <string-value>

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. Displays all the messages that hold the value of the given string. A case sensitive search is performed. If you enter string values like “running” “Dec 02”, all messages containing these strings will be displayed.

PARAMETERS

EXAMPLEALU(config)# show logging string temperature

2009 Sep 19 09:59:23: %CM-7-LOG: SCAN chassis temperature 47; setting fan speed to high succeeded2009 Sep 19 10:00:59: %ENVAGT-4-LOG: EA.7: Cannot read temperature sensor

SHOW LOGGING TAG show logging tag <tag-name>

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. Displays the log messages in reference to the tag value. The tag is the module that generated the log. The tag name is case insensitive.

PARAMETERS

EXAMPLEThe following example shows messages from a particular module, say, CLI

ALU(config)# show logging tag cli2008 Oct 13 03:49:59: %CLI-6-LOG: User: successfully entered into Super user mode2008 Oct 13 10:44:47: %CLI-6-LOG: A Client Logged in to the Box through SSH from 10.91.2.87

2008 Oct 13 10:45:41: %CLI-6-LOGSRV: Logging buffer size set to 128K by User:privileged user.

Parameter Description

string-value Value of the string.

Parameter Description

tag-name The tag-value can be “BGP” “RIP” “FW” “ChassisMgr”, etc. All the messages relating to the these modules will be displayed.

107Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

SHOW MEMORYshow memory

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays all the necessary information related to the system memory, such as the Memory usage, memory free space, memory buffers configured, shared memory space, etc.

PARAMETERS

None.

EXAMPLEALU(config)# show memory

MemTotal: 257040 kBMemFree: 32104 kBBuffers: 10836 kBCached: 59696 kBSwapCached: 0 kBActive: 146636 kBInactive: 39356 kBHighTotal: 0 kBHighFree: 0 kBLowTotal: 257040 kBLowFree: 32104 kBSwapTotal: 0 kBSwapFree: 0 kBDirty: 0 kBWriteback: 0 kBMapped: 132720 kBSlab: 8064 kBCommitLimit: 128520 kBCommitted_AS: 203708 kBPageTables: 1464 kBVmallocTotal: 640000 kBVmallocUsed: 44264 kB

VmallocChunk: 595596 kB

108

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show packages

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW PACKAGESshow packages [detail <package-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command shows the various packages currently installed.

PARAMETERS

EXAMPLEALU(config)# show packages

Default Name Size (KB) Build Date * 3.0.0.81.0 76599 Mon Jun 28 13:21:55 IST 2010 3.0.0.80.0 21248 Tue Jun 22 18:15:21 IST 2010 42128 of 142035 Kb free (70% used)

ALU(config)# show packages detail 3.0.0.81.0

Current components: Version Name Description 3.0.0.81.0 BGP BGP Routing Module 3.0.0.81.0 DHCP-relay DHCP Relay service 3.0.0.81.0 Ethernet SE GigE / L2-GE software 3.0.0.81.0 GRE GRE Encapsulation and Base/Routing/tunneling 3.0.0.81.0 HTTP HTTP server 3.0.0.81.0 IDS Intrusion Detection/Prevention System 3.0.0.81.0 Management-OOB Out-Of-Band Management 3.0.0.81.0 Management-Tools Internal support tools 3.0.0.81.0 Startup ModuLive Operating system 3.0.0.81.0 Networking-base Networking infrastructure 3.0.0.81.0 OSPF OSPF Protocol 3.0.0.81.0 QoS Quality of Service 3.0.0.81.0 RIP Routing Information Protocol 3.0.0.81.0 NHRP Next Hop Resolution Protocol 3.0.0.81.0 Routing-base Routing Infrastructure 3.0.0.81.0 SNMP SNMP-v2 support 3.0.0.81.0 TR069 TR069 Client 3.0.0.81.0 SSH Secure Shell Access 3.0.0.81.0 Security Network Security Services 3.0.0.81.0 Serial FR,HDLC,T1E1,SERIAL,DIALER,Wireless WAN 3.0.0.81.0 Lifeline Lifeline Management

Parameter Description

detail <package-name> If the keyword 'detail' and a package name are specified, then all the components present in that package are listed. If a package name is not specified when the 'detail' keyword is used, then the components of the default package are listed.

109Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

3.0.0.81.0 VRRP Virtual Router Redundancy Protocol 3.0.0.81.0 Third-Party Third Party Utilities 3.0.0.81.0 MCAST Multicast Routing Protocol 3.0.0.81.0 WDOGMGR Hardware Watchdog Manager Sample 3.0.0.81.0 IPSec IPSec VPN service 3.0.0.81.0 ADSL ADSL28 Components Listed

SHOW PROCESSESshow processes

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the CPU information.

PARAMETERS

None.

EXAMPLEALU(config)# show processes

PID Uid VmSize Stat Command 1 root 572 S init 2 root SWN [ksoftirqd/0] 3 root SW< [events/0] 4 root SW< [khelper] 5 root SW< [kthread] 6 root SW< [kblockd/0] 8 root SW [pdflush] 7 root SW [khubd] 9 root SW [pdflush] 11 root SW< [aio/0] 10 root SW [kswapd0] 12 root SW [mtdblockd] 57 root 560 S /usr/sbin/inetd /etc/inetd.conf 96 root SW [kjournald] 103 root SW [kjournald] 442 root 596 S /bin/ash /bin/tm-sh 448 root 300 S /bin/clim-sh -- 503 root 556 S sh -c clim -c 504 root 10360 S clim -c 510 root 1440 S tm -w pm -A 511 root 408 D /netd/usr/sbin/wdogEventMgr 512 root 1440 S tm -w pm -A 513 root 1440 S tm -w pm -A 514 root 1440 S tm -w pm -A 515 root DW [vmMonitord] 516 root 2324 S pm -A 517 root 632 S /bin/sh /apps/usr/sbin/core_mover.sh 566 root 2440 S vrrpfs 569 root 2504 S vrrp 570 root 1980 S vrfmgr 571 root 2132 S vlan_fs

110

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show processes

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

572 root 2728 S rsrv -m 0 -l 1 573 root 2596 S tunnel_fs 574 root 1828 S tftpd -lD -s /tftp 575 root 1644 S statsserver 576 root 1656 S statsagent 577 root 2972 S statlogd 578 root 2820 S start-aaamgr 579 root 3092 S sshd -D -f /netd/etc/routing/sshd_config 580 root 2684 S ribmgr ribmgr initial 581 root 2844 S srm srm initial 583 root 5280 S snmpd -f 584 root 2372 S sbcFeature 585 root 2120 S aclmgr aclmgr initial 586 root 2392 S rip rip initial 587 root 2440 S qosMgr 588 root 2432 S pvstd 589 root 1872 S pppoed 590 root 2292 S pppfs 591 root 2048 S pluto --nofork --nat_traversal 592 root 2804 S pim pim pim 593 root 2092 S pbr_fs 594 root 2376 S ospfd ospfd initial 595 root 3248 S mim im_ip.so irb_im.so tunnel-im.so mlppp_im.so mlfr_ 596 root 2484 S mgmtutil_fs 597 root 2252 S mgmt-gw 598 root 2488 S mcribmgr mcribmgr initial 601 root 2200 S cm 83000059 602 root 2200 S license_mgr 606 root 1692 S l2agent -t 607 root 1856 S ike_wr 608 root SW [switch_stats] 609 root SW [switch_evtm] 612 root 2112 S ike_fs 613 root 2796 S igmp igmp igmp 615 root 2224 S hdlc_fs 616 root 1608 S gre 617 root 2400 S fw-policy initial 624 root 2316 S fmrlyfs 625 root 1992 S dot1x_fs 626 root 2392 S dnsproxy initial 627 root 2324 S dhcprelay initial 628 root 2368 S dhcpd 631 root 1932 S dhcp_fs 632 root 2580 S dbgd dbgd initial 633 root 4104 S controld 634 root 16476 S switchd 14 635 root 2076 S cc_fs 636 root 2528 S bgp bgp initial 639 root 1972 S arp 640 root 8240 S appWeb -f appWeb.conf 641 root 2200 S acMgr 649 root 2164 S NatFeature 650 root 2160 S IdsFeature 714 root 616 S /sbin/tftpd -l -u root -s /images/boot -a 0.0.0.0:60 715 root 2088 S FwcommonFeature 725 root 2028 S FilterFeature 727 root SW< [ucc-wan] 970 root 35816 S snort -i eth0 -c /apps/etc/snort/snort.conf14862 root 380 S sleep 30

111Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

14865 root 452 S more14866 root 684 R ps aux

Note: In addition to the total memory displayed, 16 MB is reserved for data buffers. This is not displayed in the total system memory.

SHOW RUNNING-CONFIGshow running-config

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. Shows the configuration currently running on the system. The command "write terminal" can also be used to view the same output.

PARAMETERS

None.

EXAMPLEALU(config)# show running-config

!Current Configuration:!! NVRAM config last updated at 00:59:49 GMT Fri Sep 26 2008 by superadmin! Statlog Configuration!logging onlogging buffered priority 7logging buffered size 128logging console 3logging system 6service timestamps loglogging rate-limit 1 10 tag SWE subtag DOSlogging rate-limit 1 10 tag PVSTD subtag PKTlogging rate-limit 1 10 tag SWE subtag SESSION!!VRF Configuration!! MULTICAST Configuration!NOE port reservation!!--More--

112

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show snmp

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW SNMPshow snmp

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the SNMP running configuration.

PARAMETERS

None.

EXAMPLEALU(config)# show snmp!! SNMP Configurations!snmp trap enablesnmp system contact [email protected] name alu1snmp agent rocommunity privatesnmp trap 1.1.1.1 v1 test 10snmp trap 1.1.1.11 v1 test1 11snmp-server user user123 auth MD5 passpass1snmp-server group testgroup user123 security-model v3snmp-server view view123 .1.3.6.1 includedsnmp-server access testgroup security-model v3 auth read read-view write write-view

SHOW SNMP ACCESSshow snmp access

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the SNMP access configuration.

PARAMETERS

None.

EXAMPLEALU(config)# show snmp access

---------------------------------------Group Name: testgroupSecurity Level: authSecurity model: v3Read View: read-viewWrite View: write-view---------------------------------------

113Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

SHOW SNMP DETAILSshow snmp details

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to view the SNMP configuration details.

PARAMETERS

None.

EXAMPLEALU(config)# show snmp details

SNMP status : EnabledSNMP version : [Not configured]Traps : [Not configured]

System information------------------System Contact : testSystem Location : [Not configured]

Community-Access Community-String---------------- ----------------read-only t1read-write [Not configured]

Trap-Host Trap-Port Version Trap-Community--------- --------- ------- --------------10.91.0.224 8001 v1 trapcomm10.91.0.225 162 v2c notifcomm

114

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show snmp group

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW SNMP GROUPshow snmp group

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the configuration of the configured SNMP groups.

PARAMETERS

None.

EXAMPLEALU(config)# show snmp group

---------------------------------------Group Name : testgroupSecurity Model: v3Security Name: user123---------------------------------------

115Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

SHOW SNMP STATSshow snmp stats

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the SNMP statistics.

PARAMETERS

None.

EXAMPLEALU(config)# show snmp stats

560 SNMP packets input 0 Bad SNMP version errors 0 Unknown community names 0 Bad community uses 0 Encoding errors 0 Silent drops 0 Proxy drops557 SNMP packets output 0 Too big errors 2 No such name errors 0 Bad values errors 0 General errors 557 Get Responses 0 Traps

116

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show snmp user

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW SNMP USERshow snmp user <user-name>

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the configuration of the configured SNMP users.

PARAMETERS

EXAMPLEALU(config)# show snmp user

---------------------------------------User Name : user123Authentication Protocol: MD5Security Level: Auth---------------------------------------

SHOW SNMP VIEWshow snmp view

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the SNMP view configuration.

PARAMETERS

None.

EXAMPLEALU(config)# show snmp view

ViewName Status MIBFamily-------- ------ ---------view123 included .1.3.6.1

Parameter Description

user-name Name of the SNMP user. If the user name is specified, the configuration for the specified user is displayed.

117Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

SHOW STARTUP-CONFIGshow startup-config

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. Shows the configuration currently stored on the permanent storage media. This configuration is read at system startup. The command “write memory” has to be entered to view the output of this command.

PARAMETERS

None.

EXAMPLEALU(config)# show startup-config

! NVRAM config last updated at 00:59:49 GMT Fri Sep 26 2008 by superadmin!! Statlog Configuration!logging onlogging buffered priority 7logging buffered size 128logging console 3logging system 5service timestamps loglogging rate-limit 1 10 tag SWE subtag DOSlogging rate-limit 1 10 tag SWE subtag SESSION!!VRF Configuration!! MULTICAST Configuration!NOE port reservation!!!!--More--

118

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show tech-support

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW TECH-SUPPORTshow tech-support

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays details of all the modules running in the system.

PARAMETERS

None.

EXAMPLE

The ‘show tech-support’ command collectively shows the output of these commands:

show versionshow clockdir user:coresshow chassisshow running-configshow controllershow interfacesshow vlan Briefshow access-listsshow ip protocolsshow ip routeshow netio show arpshow arp trafficshow mac-address-tableshow subsystemshow logging priority 7

Note: You can save the tech-support logs to the user area or fpkey using the command “save tech-support [filename {fpkey:|user:}”.

119Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

SHOW VERSIONshow version

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command shows the version details of the running package and flash image.

PARAMETERS

None.

EXAMPLEALU(config)# show version

Alcatel-Lucent Software, Version 3.0.0, Build 81 Copyright (c) 2003-2010 by Alcatel-Lucent Inc. Built on Mon Jun 28 13:21:55 IST 2010

Flash version - 1.5

SNMP AGENTsnmp agent {rocommunity|rwcommunity} <community-string>

DESCRIPTION

This command is entered in the Configuration Mode. This command configures the SNMP agent read-only/read-write community.

Note: The SNMP agent can be accessed only after setting the SNMP version. Use the 'snmp agent version (v1|v2c)' command to set the version of the SNMP agent.

PARAMETERS

EXAMPLE ALU(config)# snmp agent rocommunity private

Parameter Description

community-string Read-only/read-write community string.Community string is the text string used to authenticate messages between a management station and an agent.

120

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

snmp disable

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SNMP DISABLEsnmp disable

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to disable the SNMP service.

PARAMETERS

None.

DEFAULT None

EXAMPLEALU(config)# snmp disable

SNMP ENABLEsnmp enable

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to enable the SNMP service.

PARAMETERS

None.

DEFAULT None

EXAMPLEALU(config)# snmp enable

121Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

SNMP-SERVER ACCESSsnmp-server access <group-name> security-model {v1|v2c|v3} {auth|noauth|priv} {context <context-name> {exact|prefix}|read <read-view-name>|write <write-view-name>|notify <notify-view-name>}

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure access control for a group.

PARAMETERS

EXAMPLEALU(config)# snmp-server access testgroup security-model v3 auth read read-view write write-view notify notify-view

Parameter Description

group-name The group associated with access control policy.

v1|v2c|v3 SNMP version.

auth Provides authentication based on the MD5 or SHA algorithms.

noauth No authentication is used.

priv Provides authentication based on the MD5 or SHA algorithms, and encryption based on the CBC-DES (DES-56) standard.

context-name The context name associated with access control policy.

exact Checks for the exact match of the specified context name to provide access to specific group.

prefix Checks for the prefix match of the specified context name to provide access to specific group.

read-view-name A view name that defines the list of object identifiers (OIDs) that are accessible for reading by users belonging to a specific group.

write-view-name A view name that defines the list of OIDs that are able to be created or modified by users belonging to a specific group.

notify-view-name A view name that defines the list of notifications that can be sent to each user belonging to a specific group.

122

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

snmp-server group

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SNMP-SERVER GROUPsnmp-server group <group-name> <security-name> security-model {v1|v2c|v3}

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure a User Security Model (USM) group.

PARAMETERS

EXAMPLEALU(config)# snmp-server group testgroup user123 security-model v3

Parameter Description

group-name Name used to represent the combination of security model and security user (SNMP v3 user).

security-name v3 user name to be associated with the group.

security-model {v1|v2c|v3} Defines the SNMP version to be associated with the group.

123Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

SNMP-SERVER USERsnmp-server user <user-name> [auth {MD5|SHA} <auth-password> priv DES <privilege-password>]

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure a SNMPv3 user.

PARAMETERS

EXAMPLEALU(config)# snmp-server user user123 auth MD5 pass123456 priv DES test123456

Parameter Description

user-name A string identifying the name of the SNMP user.

auth Indicates that the message sent on behalf of the user is to be authenticated.

MD5|SHA Uses HMAC MD5/SHA algorithm for authentication.

auth-password Password specified for authentication protocol. Authentication password should be minimum of 8 characters.

priv Indicates the message sent on behalf of the user is to be protected from disclosure.

DES Algorithm used for encryption of the date.

privilege-password Privacy password used for encryption/decryption of the message sent by the user. This should be a minimum of 8 characters.

124

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

snmp-server view

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SNMP-SERVER VIEWsnmp-server view <view-name> <MIB-family-name> {included| excluded}

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure a SNMP view.

PARAMETERS

EXAMPLEALU(config)# snmp-server view view123 .1.3.6.1 included

SNMP SYSTEMsnmp system {contact <contact-details>|location <location>| name <name>}

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure the SNMP system contact details, system’s physical location information and SNMP system name.

PARAMETERS

EXAMPLEALU(config)# snmp system contact [email protected]

Parameter Description

view-name A name representing the MIB view.

MIB-family-name Represents MIB view sub tree associated with the view name.

included When this option is selected, the MIB family is excluded from the view.

excluded When this option is selected, the MIB family is included from the view.

Parameter Description

contact-details Contact details of the SNMP system.

location Physical location of the SNMP system.

name Name of the SNMP system.

125Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

SNMP TRAPsnmp trap <ip-address> {v1|v2c} <community-string> <1-65536>} vrf <vrf-name>

DESCRIPTION

This command is entered in the Configuration Mode. This command configures the trap destination where the agent will send the SNMP traps.

Note: Cannot add more than 3 trap receivers.

PARAMETERS

EXAMPLEALU(config)# snmp trap 10.1.1.1 v1 trapcommunity 162

SNMP TRAP ENABLEsnmp trap enable

DESCRIPTION

This command is entered in the Configuration Mode. This command enables the agent to send the SNMP traps to the configured host.

PARAMETERS

None.

EXAMPLEALU(config)# snmp trap enable

Parameter Description

ip-address The host IP address to which the trap messages are to be sent.

{v1|v2c} SNMP version: v1/v2c

community-string SNMP v1/v2c community string.

1-65536 The notification host's UDP port number

vrf <vrf-name> Name of the VRF associated with the interface through which the trap messages are to be routed.

126

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ssh enable|disable

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SSH ENABLE|DISABLEssh {enable|disable}

DESCRIPTION

This command is entered in the Configuration Mode. Use this command to enable/disable the SSH service.

PARAMETERS

EXAMPLEALU(config)# ssh enable

SSHssh [vrf <vrf-name>] {<ip-address>|<hostname>} <user-name> [version {1|2}]

DESCRIPTION

This command is entered in the Configuration Mode. Use this command to access a remote computer by SSH.

PARAMETERS

Parameter Description

enable Enable SSH service.

disable Disable SSH service.

Parameter Description

vrf-name Name of the VRF. If the VRF name is specified, the packets will be routed using the routing table of the specified VRF on a interface associated with the VRF.

ip address IP Address of the remote system.

hostname Host name of the remote system.

user-name The login/user name to be used.

version {1|2} SSH version number - version 1 or version 2.

127Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

EXAMPLEALU(config)# ssh 172.25.19.1

ALU(config)# ssh 172.25.19.1 root The authenticity of host '172.25.19.1(172.25.19.1)' can't be established.RSA key fingerprint is b5:b8:c9:6b:0e:28:df:a8:b0:06:7a:23:7f:03:96:6b.

Are you sure you want to continue connecting (yes/no)? yesWarning: Permanently added '172.25.19.1' (RSA) to the list of known [email protected]'s password:

Last login: Mon Dec 8 17:34:48 2008[root@linux-sw root]# exitlogout Connection to 172.25.19.1 closed.

TACACS-SERVERtacacs-server <ip-address> [{auth-port <1-65535>|key <string> |timeout <1-1000>}]

DESCRIPTION

This command is entered in the Configuration Mode. This command is entered in the TACACS+ Server group Configuration Mode. This command is used to add the TACACS+ server of the specified IP address to a TACACS+ server group.

PARAMETERS

EXAMPLEALU(config-tac-grp)# tacacs-server 1.1.1.2

Parameter Description

ip-address IP address of the remote TACACS+ server to be added to the group.

auth-port <1-65535> Destination port on which TACACS+ server is listening.

key <string> This is the encryption key between OmniAccess 5510 USG and the TACACS+ server.

timeout <1-1000> Number of seconds that OmniAccess 5510 USG should wait for a reply from the TACACS+ server before retrying.

128

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

tacacs-server auth-port

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

TACACS-SERVER AUTH-PORTtacacs-server auth-port <1-65535>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to specify a global authentication port that will be applied to all the TACACS+ Server groups (provided there is no server specific port configured).

PARAMETERS

DEFAULT VALUE

The default authentication port is 49.

EXAMPLEALU(config)# tacacs-server auth-port 100

TACACS-SERVER KEYtacacs-server key {5 [<string>]|<string>}

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to specify a global key that will be applied to all the TACACS+ Groups (provided there is no server specific key configured).

PARAMETERS

DEFAULT VALUE

The default key is “” (empty string).

EXAMPLEALU(config)# tacacs-server key test1

Parameter Description

auth-port <1-65535> Destination port on which TACACS+ server is listening.

Parameter Description

string The key string.

5 When this keyword is used, enter the encrypted format of the key.

129Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

TACACS-SERVER TIMEOUTtacacs-server timeout <1-1000>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to specify a global timeout value that will be applied to all the TACACS+ Groups (provided there is no server specific timeout value configured).

PARAMETERS

DEFAULT VALUE

The default timeout value is 5 seconds.

EXAMPLEALU(config)# tacacs-server timeout 10

Parameter Description

timeout <1-1000> Number of seconds that OmniAccess 5510 USG should wait for a reply from the TACACS+ server before retrying.

130

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

telnet enable|disable

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

TELNET ENABLE|DISABLEtelnet {enable|disable}

DESCRIPTION

This command is entered in the Configuration Mode. Use this command to enable/disable the Telnet service.

PARAMETERS

EXAMPLEALU# telnet enable

TELNETtelnet [vrf <vrf-name>] {<ip-address>|<hostname>}

DESCRIPTION

This command is entered in the Configuration Mode. This command starts a telnet connection to a remote computer.

PARAMETERS

EXAMPLEALU(config)# telnet 10.91.0.1

Parameter Description

enable Enable telent service.

disable Disable telnet service.

Parameter Description

vrf-name If the VRF name is specified, the packets will be routed using the routing table of the specified VRF on a interface associated with the VRF.

ip address IP address of the remote host.

hostname Host name of the remote host.

131Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

TERMINAL LENGTHterminal length {0|<5-512>}

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to set the terminal length for this session.

PARAMETERS

EXAMPLE ALU(config)# terminal length 10

Parameter Description

0 0 for no pausing.

0-512 Number of lines on screen.

132

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

terminal monitor

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

TERMINAL MONITORterminal monitor [<0-7>|alerts|critical|debugging|emergencies |errors|informational|notifications|warnings]

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to display the log messages of specified and higher (numerically lower) priorities in the terminal window. This terminal could be launched through SSH or Telnet.

PARAMETERS

EXAMPLEALU(config)# terminal monitor

TRACEROUTE traceroute [vrf <vrf-name>] {<ip-address>|<hostname>}

DESCRIPTION

This command is entered in the Configuration Mode. This command displays the route taken by IP packets.

PARAMETERS

EXAMPLEALU(config)# traceroute 10.91.10.178

traceroute to (10.91.10.178), 30 hops max, 38 byte packets. 1 10.91.0.1 (10.91.0.1) 0.700 ms 0.703 ms 0.621 ms 2 10.91.10.178 (10.91.10.178) 0.951 ms 0.961 ms 0.960 ms

Parameter Description

0-7 Priority level of the messages.

Parameter Description

vrf-name If the VRF name is specified, the packets will be routed using the routing table of the specified VRF on a interface associated with the VRF.

ip-address IP address of the host.

hostname Name of the host.

133Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

System Configuration and Monitoring

Left running head: Chapter name (automatic)

USERNAME PASSWORDusername <user-name> {password [5] <password>|nopassword|secret [5] <password>}

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to create/modify a user account and user password. The user accounts configured using this command will form a part of the local database.

PARAMETERS

EXAMPLEALU(config)# username alu1 password pass1

WRITE ERASEwrite erase

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to delete the startup-config permanently.

The command "erase startup-config" can also be used to delete the startup-config permanently.

PARAMETERS

None.

EXAMPLEALU(config)# write eraseAre you sure you want to erase startup-config file yes/no [yes]:yes[OK] startup-config file erased.

Parameter Description

user-name Name of the user account.

password The password for the user account.

5 When this keyword is used, enter the encrypted format of the password.

nopassword If this keyword is used, no password is required for a a user to login.

secret Password is encrypted.

134

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Virtual Router Redundancy Protocol

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 4 VIRTUAL ROUTER REDUNDANCY PROTOCOL

This chapter documents the Command Line Interface (CLI) commands for Virtual Router Redundancy Protocol (VRRP). These commands are used to configure VRRP on an interface.

This chapter includes table of parameters, default values, and configuration examples for configuring VRRP as quick-start and reference information. In this chapter, all commands are described in an alphabetical order. For more detailed information on using and configuring VRRP, refer to the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

135Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Virtual Router Redundancy Protocol

Left running head: Chapter name (automatic)

DEBUG VRRP CONTROLdebug vrrp control {rib|protocol|all}

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Interface Configuration Mode. This command displays VRRP control debug messages.

PARAMETERS

EXAMPLEALU# debug vrrp control all

DEBUG VRRP MANAGEMENTdebug vrrp management {all|protocol|vrrpfs}

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Interface Configuration Mode. This command displays VRRP management debug messages.

PARAMETERS

EXAMPLEALU# debug vrrp management all

Parameter Description

rib Displays the VRRP RIB-related debug messages.

protocol Displays the VRRP protocol-related debug messages.

all Displays all the VRRP debug messages.

Parameter Description

all Displays all the VRRP debug messages.

protocol Displays the VRRP protocol-related debug messages.

vrrpfs Displays the VRRP management debug messages.

136

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

interface

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

INTERFACEinterface <name>

DESCRIPTION

This command is entered in the Configuration Mode. VRRP is enabled on a per-interface basis. VRRP runs on multi-access networks, such as Ethernet. This command is used to configure an interface.

PARAMETERS

EXAMPLEALU(config)# interface FastEthernet 0ALU(config-if FastEthernet0)#

NO VRRP GROUP-IDno vrrp <1-8>

This command is entered in the Interface Configuration Mode. This command removes all configuration associated with the VRRP group on the interface.

NO VRRP GROUP-ID IP no vrrp <1-8> ip <ip-address>

This command is entered in the Interface Configuration Mode. This command removes the primary IP address for the specified VRRP group on an interface. VRRP group is disabled as a result.

NO VRRP GROUP-ID IP IP-ADDRESS SECONDARYno vrrp <1-8> ip <ip-address> secondary

This command is entered in the Interface Configuration Mode. This command removes the secondary IP address from the specified VRRP group.

NO VRRP GROUP-ID PREEMPTno vrrp <1-8> preempt

This command is entered in the Interface Configuration Mode. This command is used to disable pre-emption of the VRRP group.

Parameter Description

name Type of interface used.

137Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Virtual Router Redundancy Protocol

Left running head: Chapter name (automatic)

NO VRRP GROUP-ID PRIORITY no vrrp <1-8> priority

This command is entered in the Interface Configuration Mode. This command restores the default priority for the VRRP group. The default priority is 100.

NO VRRP GROUP-ID TIMERS ADVERTISE no vrrp <1-8> timers advertise

This command is entered in the Interface Configuration Mode. This command restores the default advertisement interval.

NO VRRP GROUP-ID TIMERS LEARN no vrrp <1-8> timers learn

This command is entered in the Interface Configuration Mode. This command disables the learning of the advertisement interval of the master virtual router. The backup router uses the configured or the default advertisement interval to determine the downtime for the master.

NO VRRP GROUP-ID TRACK-INTERFACE no vrrp <1-8> track-interface

This command is entered in the Interface Configuration Mode. This command removes tracking of the interface in a VRRP group.

138

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show vrrp all

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW VRRP ALL show vrrp all [brief]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Interface Configuration Mode. This command displays a brief or detailed status of all the VRRP groups configured on OmniAccess 5510 USG.

PARAMETERS

EXAMPLEALU(config)# show vrrp all

Interface FastEthernet0 - Group 1State is MasterVirtual IP address is 10.1.1.1Virtual MAC address is 0000.5e00.0101Advertisement interval is 1.000 secPreemption enabledPriority is 255Master Router is 10.1.1.1 (local), priority is 255Master Advertisement interval is 1.000 secsMaster Down interval is 3.000 secs

Interface FastEthernet0 - Group 2State is MasterVirtual IP address is 20.1.1.1Virtual MAC address is 0000.5e00.0102Advertisement interval is 1.000 secPreemption enabledPriority is 100Master Router is 10.1.1.1 (local), priority is 100Master Advertisement interval is 1.000 secsMaster Down interval is 3.000 secs

Parameter Description

all This keyword displays a detailed information on all the VRRP groups.

brief Displays a brief information on all the VRRP groups.

139Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Virtual Router Redundancy Protocol

Left running head: Chapter name (automatic)

SHOW VRRP INTERFACEshow vrrp interface <interface-name> [brief]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Interface Configuration Mode. This command displays the VRRP groups and their status on a specified interface (in the brief format, if specified).

PARAMETERS

EXAMPLEALU# show vrrp interface FastEthernet 0

Interface FastEthernet0 - Group 1State is MasterVirtual IP address is 10.1.1.1Virtual MAC address is 0000.5e00.0101Advertisement interval is 1.000 secPreemption enabledPriority is 255Master Router is 10.1.1.1 (local), priority is 255Master Advertisement interval is 1.000 secsMaster Down interval is 3.000 secs

Interface FastEthernet0 - Group 2State is MasterVirtual IP address is 20.1.1.1Virtual MAC address is 0000.5e00.0102Advertisement interval is 1.000 secPreemption enabledPriority is 100Master Router is 10.1.1.1 (local), priority is 100Master Advertisement interval is 1.000 secsMaster Down interval is 3.000 secs

Parameter Description

interface-name Type of interface used.

brief This keyword displays a brief information on the VRRP groups configured on any interface.

140

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

vrrp group-id authentication text

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

VRRP GROUP-ID AUTHENTICATION TEXTvrrp <1-8> authentication text <password>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to set authentication for the VRRP group. The authentication string can have a maximum of 8 characters.

Note: OmniAccess 5510 USG supports null authentication and plain-text authentication.

PARAMETERS

DEFAULT VALUE

By default, no authentication is set on the VRRP group.

EXAMPLEALU(config-if FastEthernet0)# vrrp 7 authentication text net123

Parameter Description

1-8 Specifies the group number. It is in the range 1 - 8.

password Denotes the authentication password used. A maximum of 8 characters are allowed.

141Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Virtual Router Redundancy Protocol

Left running head: Chapter name (automatic)

VRRP GROUP-ID DESCRIPTIONvrrp <1-8> description <string>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command assigns a textual description for the VRRP group. The description string can be up to 80 characters.

PARAMETERS

EXAMPLEALU(config-if FastEthernet0)# vrrp 7 description ALU-vrrp

VRRP GROUP-ID IP-ADDRESSvrrp <1-8> ip <ip-address>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to configure a VRRP group with the specified group ID on an interface, and primary IP address for the VRRP group. A VRRP group is enabled only after the primary IP address is configured on the interface.

PARAMETERS

EXAMPLEALU(config-if FastEthernet0)# vrrp 5 ip 10.91.0.8

Parameter Description

1-8 Specifies the group number. It is in the range 1 - 8.

string A descriptive text ranging from 1 - 80 characters.

Parameter Description

1-8 Specifies the group number. It is in the range 1 - 8.

ip-address Primary IP address of the VRRP group.

142

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

vrrp group-id IP ip-address secondary

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

VRRP GROUP-ID IP IP-ADDRESS SECONDARYvrrp <1-8> ip <ip-address> secondary

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to configure the secondary IP address for a VRRP group on an interface.

Note: The maximum number of secondary IP addresses allowed per VRRP group is 8.

PARAMETERS

EXAMPLEALU(config-if FastEthernet0)# vrrp 7 ip 10.91.0.101 secondary

VRRP GROUP-ID PREEMPTvrrp <1-8> preempt

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command enables the preempt mode. By enabling the preempt mode, the configured router takes over as the master of a group if it has a higher priority than the existing master virtual router.

PARAMETERS

DEFAULT VALUE

Pre-emption is enabled by default.

EXAMPLEALU(config-if FastEthernet0)# vrrp 7 preempt

Parameter Description

1-8 Specifies the group number. It is in the range 1 - 8.

ip-address The secondary IP address of the VRRP group.

secondary Use this keyword to set the IP address as the secondary IP address for the VRRP group.

Parameter Description

1-8 Specifies the group number. It is in the range 1 - 8.

143Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Virtual Router Redundancy Protocol

Left running head: Chapter name (automatic)

VRRP GROUP-ID PRIORITY VALUEvrrp <1-8> priority <1-254>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to set the priority for the router within a group.

PARAMETERS

DEFAULT VALUE

By default, priority is 100

EXAMPLEALU(config-if FastEthernet0)# vrrp 7 priority 104

Parameter Description

1-8 Specifies the group number. It is in the range 1 - 8.

value Refers to the priority level which ranges between 1- 254.

144

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

vrrp group-id timers advertise

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

VRRP GROUP-ID TIMERS ADVERTISE vrrp <1-8> timers advertise {<1-255>|msec <50-999>}

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command configures the interval between successive advertisements by the master virtual router in a VRRP group. The unit is in seconds unless the optional "msec" parameter is specified.

PARAMETERS

DEFAULT VALUE

Default is one second.

EXAMPLEALU(config-if FastEthernet0)# vrrp 7 timers advertise 5

Parameter Description

1-8 Specifies the group number. It is in the range 1 - 8.

1-255 By default the timer value is configured in seconds. Its in the range: 1 - 255 seconds.

50-999 The timer value can be configured in milliseconds by using the keyword ‘msec’. Its in the range: 50 - 999 milliseconds.

145Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Virtual Router Redundancy Protocol

Left running head: Chapter name (automatic)

VRRP GROUP-ID TIMERS LEARN vrrp <1-8> timers learn

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command configures the backup virtual router to learn the advertisement interval used by the master virtual router. Learning and millisecond timers are mutually exclusive. That is, learning cannot be enabled when millisecond timers are enabled and millisecond timers cannot be enabled if learning is enabled.

PARAMETERS

DEFAULT VALUE

By default, the master advertisement learning interval is disabled.

EXAMPLEALU(config-if FastEthernet0)# vrrp 7 timers learn

Parameter Description

1-8 Specifies the group number. It is in the range 1 - 8.

146

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

vrrp group-id track-interface

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

VRRP GROUP-ID TRACK-INTERFACE vrrp <1-8> track-interface <interface-name> decrement <1-255>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to configure the interface to be tracked for a VRRP group. Also, decrements the priority of the VRRP group from the configured VRRP priority when the tracked interface goes down.

If the priority of a VRRP group is 100, and the decrement value is set to 60, when the tracked interface goes down, the VRRP priority is set to 40.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-if FastEthernet0)# vrrp group track-interface Serial 0 decrement 60

RELEASE HISTORY

Release 3.0: parameter ‘decrement <1-255>’ was introduced.

Parameter Description

1-8 Specifies the group number. It is in the range 1 - 8.

interface-name Interface name.

1-255 Priority value to be set.

147Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Virtual Router Redundancy Protocol

Left running head: Chapter name (automatic)

148

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

For final production, import color definitions from\\daldoc01\docteam\templates\framemaker\book-template\color-defs\ production-colors.fm. Do not import other template elements such as page layout.

To return to the draft version, import color def’ns from draft-colors.fm.To switch to the beta version, import color def’ns from beta-colors.fm

For final production, import color definitions from\\daldoc01\docteam\templates\framemaker\book-template\color-defs\ production-colors.fm. Do not import other template elements such as page layout.

To return to the draft version, import color def’ns from draft-colors.fm.To switch to the beta version, import color def’ns from beta-colors.fm

Optional footer: Manual title (to set, redefine ManualTitlevariable)

agination: umeric & ntinuous

PNco

Part 2 LAN Interfaces and Configuration

Beta BetaAlcatel-Lucent

149

Beta Betawith preceding section of book

OmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Left running head: Chapter name (automatic)

150

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Fast Ethernet Interface

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 5 FAST ETHERNET INTERFACE

This chapter documents the Command Line Interface (CLI) commands for the Fast Ethernet interface.

This chapter includes table of parameters, default values, and configuration examples for the physical interface as quick-start and reference information. The commands are described in alphabetical order. For more detailed information about using and configuring Fast Ethernet interface, refer OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

151Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Fast Ethernet Interface

Left running head: Chapter name (automatic)

CLEAR COUNTERSclear

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command clears the counters on a specific Fast Ethernet interface.

PARAMETERS

None

EXAMPLEALU(config-if FastEthernet0)#clearClear counters on this interface [confirm]yALU(config)#

CLEAR COUNTERSclear counters FastEthernet <port>

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Interface Configuration Mode. This command clears the counters on a specific Fast Ethernet interface.

PARAMETERS

EXAMPLEALU(config)# clear counters FastEthernet 0Clear counters on this interface [confirm]yALU(config)#

Parameter Description

port This command clears the counters on the Fast Ethernet interface.

152

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

duplex

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

DUPLEXduplex {auto|full|half}

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command configures duplex operation on an interface.

PARAMETERS

DEFAULT VALUE

The default Duplex mode is “auto”.

EXAMPLEALU(config-if FastEthernet0)# duplex full

Parameter Description

auto Enable Auto duplex configuration

full Force full duplex operation

half Force half-duplex operation

153Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Fast Ethernet Interface

Left running head: Chapter name (automatic)

ENCAPSULATION DOT1Qencapsulation dot1q <2-4094>

DESCRIPTION

This command is entered in the Sub-interface Configuration Mode. This command is to set dot1q encapsulation on a FE sub-interface.

Note: 1. Bridging is not allowed on FE sub-interface. It can be configured to receive tagged packets by setting the encapsulation to “dot1q”. 2. The VLAN ID configured on the sub-interface should not be same as configured on the main interface or any other sub-interface. 3. Only one VLAN ID per sub-interface is allowed.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-subif FastEthernet0:1)# encapsulation dot1q 10

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

2-4094 VLAN ID.

154

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

interface

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

INTERFACEinterface FastEthernet <port>

DESCRIPTION

This command is entered in the Configuration Mode. This command allows you to configure Fast Ethernet interface.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# interface FastEthernet 0ALU(config-if FastEthernet0)#

INTERFACE <NAME>interface <name> <port:subinterface-id>

DESCRIPTION

This command is entered in the Configuration Mode. This command enables you to configure a sub-interface on the Fast Ethernet (FE) interface. This enters the S-ICM. The range for sub-interface is 1 to 4094. VLAN encapsulation is supported on FE in the form of FE sub-interfaces.

PARAMETERS

EXAMPLEALU(config)# interface FastEthernet 0:1ALU(config-subif FastEthernet0:1)#

Parameter Description

port Port number of the interface.

Parameter Description

port:subinterface-id Port number of the interface and the sub-interface number.

155Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Fast Ethernet Interface

Left running head: Chapter name (automatic)

IP ADDRESS ip address {<ip-address subnet-mask>|<ip-address/prefix-length>}

DESCRIPTION

This command is entered in the Interface Configuration Mode to configure the IP address for the interface.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-if FastEthernet0)# ip address 20.20.20.20/24

MTUmtu <64-1500>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to configure the MTU of the interface, i.e., the maximum size of the transmitted layer 2 payload.

PARAMETERS

DEFAULT VALUE

The default MTU is 1500 bytes.

EXAMPLEALU(config-if FastEthernet0)# mtu 1000

Parameter Description

ip-address subnet-mask IP address with subnet mask.

ip-address/prefix-length IP address with prefix length.

Parameter Description

64-1500 Size of packet in bytes in the range 64 - 1500.

156

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

no duplex

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NO DUPLEXno duplex

This command is entered in the Interface Configuration Mode. This command restores the default duplex operation. The default on a Fast Ethernet interface is auto.

NO ENCAPSULATION DOT1Qno encapsulation dot1q

This command is entered in the Sub-interface Configuration Mode. This command is used to remove the dot1q encapsulation on the FE sub-interface.

NO MTUno mtu

This command is entered in the Interface Configuration Mode. This command restores the interface default Maximum Transmission Unit (MTU).The default MTU is 1500.

NO SPEEDno speed

This command is entered in the Interface Configuration Mode. This command resets the interface speed to its default value which is 1000.

157Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Fast Ethernet Interface

Left running head: Chapter name (automatic)

SHOW show

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command displays traffic on the Fast Ethernet interface.

This command when used in the Sub-interface Configuration Mode displays traffic on the Fast Ethernet sub-interface.

PARAMETERS

None.

EXAMPLEALU(config-if FastEthernet0)# show

FastEthernet0 is up, line protocol is upHardware is PowerQUICC II, address is 0000.0000.0001 (0000.0000.0001) Internet address not set MTU 1500 bytes, BW 100000 Kbit, DLY 0 usec, reliability 0/255, txload 0/255, rxload 0/255 Loopback not set Encapsulation ARPA, keepalive not set Auto-duplex, Auto, 100BaseTx/Fx ARP type: ARPA, ARP Timeout never Last input never, output never, output hang never Last clearing of "show interface" counters never Queueing strategy: fifo Output queue 0/0 (size/max), 0 drops; Input queue 0/0 (size/max), 0 drops 5 minute input rate 0 bits/sec, 0 packets/sec 5 minute output rate 0 bits/sec, 0 packets/sec 0 packets input, 0 bytes, 0 no buffer Received 0 broadcasts, 0 runts, 0 giants 0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored 0 watchdog, 0 multicast, 0 pause input 0 packets output, 0 bytes, 0 underruns 0 output errors, 0 collisions, 0 interface resets 0 babbles, 0 late collision, 0 deferred 0 multicast 0 lost carrier, 0 no carrier, 0 pause output 0 output buffer copied, 0 interrupts, 0 failures

158

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

ALU(config-subif FastEthernet0:1)# show

FastEthernet0:1 is up, line protocol is up Hardware is PowerQUICC II, address is 0011.8b00.1111 (0011.8b00.1111) Internet address not set MTU 1500 bytes, BW 100000 Kbit, DLY 0 usec, reliability 0/255, txload 0/255, rxload 0/255 Loopback not set Encapsulation ARPA, keepalive not set ARP type: ARPA, ARP Timeout never Auto-duplex, Auto-Speed, 100BaseTx/Fx Last input never, output never, output hang never Last clearing of "show interface" counters never 0 packets input, 0 bytes, 0 no buffer Received 0 broadcasts, 0 runts, 0 giants 0 input errors, 0 CRC, 0 frame, 0 overrun,0 ignored 0 watchdog, 0 multicast, 0 pause input 0 packets output, 0 bytes, 0 underruns 0 output errors, 0 collisions, 0 interface resets 0 babbles, 0 late collision, 0 deferred 0 lost carrier, 0 no carrier, 0 pause output 0 output buffer copied, 0 interrupts, 0 failures

159Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Fast Ethernet Interface

Left running head: Chapter name (automatic)

SHOW INTERFACESshow interfaces [<interface-name>]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode, or Interface Configuration Mode.

This command displays traffic and all the corresponding details of all the interfaces configured. If interface name is specified, corresponding details for a specified interface is displayed.

PARAMETERS

.

EXAMPLE 1ALU# show interfaces

FastEthernet0 is up, line protocol is upHardware is PowerQUICC II, address is 0000.0000.0001 (0000.0000.0001) Internet address not set MTU 1500 bytes, BW 100000 Kbit, DLY 0 usec, reliability 0/255, txload 0/255, rxload 0/255 Loopback not set Encapsulation ARPA, keepalive not set Auto-duplex, Auto, 100BaseTx/Fx ARP type: ARPA, ARP Timeout never Last input never, output never, output hang never Last clearing of "show interface" counters never Queueing strategy: fifo Output queue 0/0 (size/max), 0 drops; Input queue 0/0 (size/max), 0 drops 5 minute input rate 0 bits/sec, 0 packets/sec 5 minute output rate 0 bits/sec, 0 packets/sec 0 packets input, 0 bytes, 0 no buffer Received 0 broadcasts, 0 runts, 0 giants 0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored 0 watchdog, 0 multicast, 0 pause input 0 packets output, 0 bytes, 0 underruns 0 output errors, 0 collisions, 0 interface resets 0 babbles, 0 late collision, 0 deferred 0 multicast 0 lost carrier, 0 no carrier, 0 pause output 0 output buffer copied, 0 interrupts, 0 failures

Parameter Description

interface name Name of the interface.

160

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

speed

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

EXAMPLE 2ALU# show interfaces FastEthernet 0

FastEthernet0 is up, line protocol is upHardware is PowerQUICC II, address is 0000.0000.0001 (0000.0000.0001) Internet address not set MTU 1500 bytes, BW 100000 Kbit, DLY 0 usec, reliability 0/255, txload 0/255, rxload 0/255 Loopback not set Encapsulation ARPA, keepalive not set Auto-duplex, Auto, 100BaseTx/Fx ARP type: ARPA, ARP Timeout never Last input never, output never, output hang never Last clearing of "show interface" counters never Queueing strategy: fifo Output queue 0/0 (size/max), 0 drops; Input queue 0/0 (size/max), 0 drops 5 minute input rate 0 bits/sec, 0 packets/sec 5 minute output rate 0 bits/sec, 0 packets/sec 0 packets input, 0 bytes, 0 no buffer Received 0 broadcasts, 0 runts, 0 giants 0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored 0 watchdog, 0 multicast, 0 pause input 0 packets output, 0 bytes, 0 underruns 0 output errors, 0 collisions, 0 interface resets 0 babbles, 0 late collision, 0 deferred 0 multicast 0 lost carrier, 0 no carrier, 0 pause output 0 output buffer copied, 0 interrupts, 0 failures

SPEEDspeed [10|100|auto]

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command configures the interface speed.

PARAMETERS

None.

DEFAULT VALUE

The default speed is “auto”.

EXAMPLE

ALU(config-if FastEthernet0)# speed 100

161Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Fast Ethernet Interface

Left running head: Chapter name (automatic)

162

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Switching on L2 Ports

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 6 SWITCHING ON L2 PORTS

This chapter documents the Command Line Interface (CLI) commands for Layer 2 switching. These commands are used to configure L2 interface.

This chapter includes the table of parameters, default values, and configuration examples for L2 switching as quick-start and reference information. In this chapter, all the commands are described in alphabetical order. For more detailed information about using and configuring switching on the L2 ports, refer OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

163Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Switching on L2 Ports

Left running head: Chapter name (automatic)

CLEAR LAN COUNTERSclear lan counters

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command clears the statistics of the packets processed at the main switching process for all the switchports.

PARAMETERS

None.

EXAMPLEALU(config)# clear lan countersClearing LAN counters ....

CLEAR MAC-ADDRESS-TABLE DYNAMICclear mac-address-table Dynamic [vlan <1-4094>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command clears the mac-address-table learnt by the system.

PARAMETERS

EXAMPLEALU# clear mac-address-table Dynamic

Parameter Description

1-4094 User configured VLAN-ID or 1 if it is a default VLAN-ID.

164

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

duplex

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

DUPLEXduplex {auto|full|half}

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command configures duplex operation on an interface.

PARAMETERS

None.

DEFAULT VALUE

The default Duplex mode is “auto”.

EXAMPLEALU(config-if switchport0)# duplex full

INTERFACE SWITCHPORTinterface switchport <port>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure an L2 interface.

PARAMETERS

EXAMPLEALU(config)# interface switchport 0ALU(config-if switchport0)#

NO DUPLEXno duplex

This command is entered in the Interface Configuration Mode. This command restores the default duplex operation. The default duplex mode is auto.

NO SHUTDOWNno shutdown

This command is entered in the Interface Configuration Mode. This command is used to administratively bring up the interface.

Parameter Description

port The port number of the interface.

165Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Switching on L2 Ports

Left running head: Chapter name (automatic)

NO SPEEDno speed

This command is entered in the Interface Configuration Mode. This command resets the interface speed to its default value, which is auto.

NO SWITCHPORT ACCESS VLANno switchport access vlan

This command is entered in the Interface Configuration Mode. This command deletes the access VLAN-ID configured on the port. This makes it to switch over to the pure bridging mode.

NO SWITCHPORT HYBRID NATIVE VLANno switchport hybrid native vlan <2-4094>

This command is entered in the Interface Configuration Mode. This command deletes the native VLAN configured on the interface, and resets it to its default. The default hybrid native VLAN ID is 1.

NO SWITCHPORT MODEno switchport mode

This command is entered in the Interface Configuration Mode.

This command first removes the hybrid/trunk mode configured on the interface. If the interface is configured with access VLAN configuration, it changes to access mode since it takes precedence over the bridging mode. If no access VLAN is not configured, then the interface moves to pure bridging mode.

NO SWITCHPORT TRUNK ALLOWED VLAN no switchport trunk allowed vlan <2-4094>...

This command is entered in the Interface Configuration Mode. This command deletes the trunk VLANs configured on the interface.

NO SWITCHPORT TRUNK ALLOWED VLAN RANGEno switchport trunk allowed vlan range <2-4094> <2-4094>

This command is entered in the Interface Configuration Mode. This command deletes the range of trunk VLANs configured on the interface.

166

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show interfaces

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW INTERFACESshow interfaces

DESCRIPTION

This command if issued in the Super User Mode or Configuration Mode, displays the statistics of all the interfaces including the information of all the L2 ports.

The ‘show’ command if issued in the Interface Configuration Mode displays the statistics of only that particular interface.

PARAMETERS

None.

EXAMPLEALU(config-if switchport0)# show

switchport0 is Administratively down, line protocol is down Hardware is MARVELL 88E6063, address is 0000.0000.0002 (0000.0000.0002) MTU 1500 bytes, BW 100000 Kbit, DLY 0 usec, reliability 255/255, txload 0/255, rxload 0/255 loopback not set, Keepalive not set Auto-duplex, Auto, 100BaseTx/Fx Last input never, output never, output hang never Last clearing of "show interface" counters never Queueing strategy: fifo Output queue 0/0 (size/max), 0 drops; Input queue 0/0 (size/max), 0 drops 5 minute input rate 0 bits/sec, 0 packets/sec 5 minute output rate 0 bits/sec, 0 packets/sec 0 packets input, 0 bytes Received 0 broadcasts, 0 runts, 0 giants,0 throttles 0 input errors, 0 CRC, 0 frame, 0 overrun,0 ignored 0 watchdog, 0 In multicast, 0 pause input 0 input packets with dribble condition detected 0 packets output, 0 bytes, 0 Sent broadcasts 0 output errors, 0 collisions, 0 interface resets 0 babbles, 0 late collision, 0 deferred 0 Out multicast, 0 lost carrier, 0 no carrier, 0 pause output 0 output buffer failures, 0 output buffers swapped out

167Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Switching on L2 Ports

Left running head: Chapter name (automatic)

SHOW LAN COUNTERSshow lan counters

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the statistics of the packets processed at the main switching process for all the switchports.

PARAMETERS

None.

EXAMPLEALU(config)# show lan counters

****LAN STATISTICS **** Output queue 0/0 (size/max), 0 drops; Input queue 0/0 (size/max), 0 drops 5 minute input rate 0 bits/sec, 0 packets/sec 5 minute output rate 0 bits/sec, 0 packets/sec 72416 packets input, 9595569 bytes, 0 no buffer Received 13106 broadcasts, 28630 multicasts 0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored 49311 packets output, 28454005 bytes, 0 underruns 0 broadcast, 0 multicast 0 output errors, 0 collisions, 0 interface resets 0 babbles, 0 late collision, 0 deferred 0 lost carrier, 0 no carrier 0 output buffer copied, 0 interrupts, 0 failures

168

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show mac-address-table

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW MAC-ADDRESS-TABLEshow mac-address-table [aging-time|interface <name>|vlan <1-4094>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the mac-address-table learnt by the system.

Note: The current release supports only dynamic learning of MAC-addresses.

PARAMETERS

EXAMPLEALU# show mac-address-table

Mac Address Interface Vlan Type-------------- ------------- ------ -------0001.2924.2959 switchport0 10 Dynamic0001.e6b0.77eb switchport0 10 Dynamic0006.1bd4.3847 switchport0 10 Dynamic0006.1bd4.655d switchport0 10 Dynamic00c0.9f33.6d23 switchport0 10 Dynamic00c0.9f33.6e54 switchport0 10 Dynamic00c0.9f33.7c84 switchport0 10 Dynamic0000.5e00.0101 switchport1 20 Dynamic0008.a16b.6597 switchport1 20 Dynamic0008.a170.59ea switchport1 20 Dynamic0008.a170.5e1d switchport1 20 Dynamic0008.a170.5e21 switchport1 20 Dynamic0008.a177.fecc switchport1 20 Dynamic0008.a177.fece switchport1 20 Dynamic0008.a178.4b19 switchport1 20 Dynamic0008.a17b.ba3d switchport1 20 Dynamic000c.f1c3.85a9 switchport1 20 Dynamic

Parameter Description

1-4094 User configured VLAN-ID or 1 if it is a default VLAN-ID.

name The interface name.

169Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Switching on L2 Ports

Left running head: Chapter name (automatic)

SHOW VLANshow vlan {Brief|id <1-4094>}

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. Displays the configuration of the VLANs configured.

PARAMETERS

EXAMPLEALU# show vlan id 10

VLAN_ID Status Interface name Mode --------- ---------- ------------------- ----- 10 Inactive switchport0 Access

ALU(config)# show vlan Brief

VLAN_ID Interface name Mode --------- ----------------- -------- 1 switchport0 No-Mode switchport1 No-Mode switchport2 No-Mode switchport3 No-Mode

SHUTDOWNshutdown

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to administratively bring down the interface.

PARAMETERS

None.

EXAMPLEALU(config-if switchport0)# shutdown

Parameter Description

Brief Displays all the VLANs that are configured on OmniAccess 5510 USG.

id Displays the configuration for a specific VLAN.

170

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

speed

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SPEEDspeed {10|100|auto}

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command configures the interface speed.

PARAMETERS

None.

DEFAULT VALUE

The default speed is “auto”.

EXAMPLE

ALU(config-if switchport0)# speed 100

SWITCHPORT ACCESS VLANswitchport access vlan <2-4094>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to configure VLANs for access mode in the range 2-4094.

PARAMETERS

EXAMPLEALU(config-if switchport0)# switchport access vlan 10

Parameter Description

2-4094 The VLAN ID configured.

171Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Switching on L2 Ports

Left running head: Chapter name (automatic)

SWITCHPORT HYBRID NATIVE VLANswitchport hybrid native vlan <2-4094>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to configure Native VLAN for hybrid mode in the range 2-4094.

PARAMETERS

EXAMPLEALU(config-if switchport0)# switchport hybrid native vlan 7

SWITCHPORT MODEswitchport mode {trunk|hybrid}

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to configure the L2 interface in the trunk or hybrid mode.

PARAMETERS

EXAMPLEALU(config-if switchport0)# switchport mode trunk

Parameter Description

2-4094 The VLAN ID configured.

Parameter Description

trunk Use this keyword to configure the L2 interface in the Trunk mode.

hybrid Use this keyword to configure the L2 interface in the Hybrid mode.

172

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

switchport trunk allowed vlan

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SWITCHPORT TRUNK ALLOWED VLANswitchport trunk allowed vlan <2-4094>...

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to configure VLANs for trunk mode in the range 2-4094. Multiple VLANs can be configured.

PARAMETERS

EXAMPLEALU(config-if switchport0)# switchport trunk allowed vlan 3

SWITCHPORT TRUNK ALLOWED VLAN RANGEswitchport trunk allowed vlan range <2-4094> <2-4094>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to configure a range of VLANs in trunk mode under a switchport interface.

PARAMETERS

EXAMPLEALU(config-if switchport0)# switchport trunk allowed vlan range 30 40

Parameter Description

<2-4094>... The VLAN ID configured.

Parameter Description

<2-4094> <2-4094> Low Vlan ID and the high Vlan ID.

173Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Switching on L2 Ports

Left running head: Chapter name (automatic)

174

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Spanning Tree Protocol

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 7 SPANNING TREE PROTOCOL

This chapter documents the Command Line Interface commands for Spanning Tree Protocol (STP). These commands are used to configure the Spanning Tree Protocol.

This chapter includes tables of parameters, default values, and configuration examples for bridging configurations as quick-start and reference information. The commands are described in alphabetical order. For more detailed information about using and configuring spanning tree, refer to the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

175Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Spanning Tree Protocol

Left running head: Chapter name (automatic)

NO SPANNING-TREE ENABLEno spanning-tree enable

This command is entered in the Configuration Mode. The “no” command disables the spanning-tree. By default, spanning tree is disabled.

NO SPANNING-TREE COSTno spanning-tree cost

This command is entered in the Interface Configuration Mode. The “no” command resets the spanning tree cost to its default value. The default spanning tree cost is 4.

NO SPANNING-TREE FWD-TIME/HELLO-TIME/MAX-AGE/PRIORITYno spanning-tree enable {forward-time <4-30>|hello-time <1-10>|max-age<6-40>|priority <0-65535>}

This command is entered in the Configuration Mode. The “no” command resets the spanning tree forward-time/hello-time/maximum-age/bridge priority.to its default.

NO SPANNING-TREE PORT-PRIORITYno spanning-tree port-priority

This command is entered in Interface Configuration Mode. The “no” command resets the spanning tree port priority to its default value. The default spanning tree port priority is 128.

NO SPANNING-TREE SPANNING-DISABLEDno spanning-tree spanning-disabled

This command is entered in the Interface Configuration Mode. The “no” command enables the spanning-tree on a specified interface.

176

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show spanning-tree

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW SPANNING-TREEshow spanning-tree

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the spanning tree details.

PARAMETERS

None.

EXAMPLE

ALU(config)# show spanning-tree

Spanning tree 1 is executing the IEEE compatible Spanning Tree Protocol Bridge Identifier has priority 50000, address 00.00.00.00.00.02 Configured hello time 2, max age 20,forward delay 15 Current root has priority 32768, address 00.11.8b.00.27.13 Root port is 128.10 cost of root path is 4 Topology change flag not set, detected flag not set Times: hold 1, topology change 35, notification 2 hello 2, max age 20, forward delay 15 Timers: hello 0, topology change 0, notification 0

Interface switchport0 (port 9) in Spanning tree 1 is Disabled Port path cost 4, Port priority 128 Designated root has priority 32768, address 00.11.8b.00.27.13 Designated bridge has priority 50000, address 00.00.00.00.00.02 Designated port Id is 128.9 path cost 4 Timers: message age 0, forward delay 0, hold 0 BPDU: sent 0, received 0 Interface switchport1 (port 10) in Spanning tree 1 is Forwarding Port path cost 4, Port priority 128 Designated root has priority 32768, address 00.11.8b.00.27.13 Designated bridge has priority 32768, address 00.11.8b.00.27.13 Designated port Id is 128.12 path cost 0 Timers: message age 1, forward delay 0, hold 0 BPDU: sent 40, received 84 Interface switchport2 (port 11) in Spanning tree 1 is Disabled Port path cost 4, Port priority 128 Designated root has priority 32768, address 00.11.8b.00.27.13 Designated bridge has priority 50000, address 00.00.00.00.00.02 Designated port Id is 128.11 path cost 4 Timers: message age 0, forward delay 0, hold 0 BPDU: sent 0, received 0 Interface switchport3 (port 12) in Spanning tree 1 is Blocking Port path cost 4, Port priority 128 Designated root has priority 32768, address 00.11.8b.00.27.13 Designated bridge has priority 32768, address 00.11.8b.00.27.13 Designated port Id is 128.14 path cost 0 Timers: message age 1, forward delay 0, hold 0 BPDU: sent 40, received 84

177Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Spanning Tree Protocol

Left running head: Chapter name (automatic)

SHOW SPANNING-TREE BRIEFshow spanning-tree brief

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the spanning tree configuration details in brief.

PARAMETERS

None.

EXAMPLEALU# show spanning-tree brief

VLAN1Spanning tree enabled protocol IEEEROOT ID Priority 32768 Address 00.11.8b.00.27.13 Hello Time 2 sec Max Age 20 sec Forward Delay 15 sec

Bridge ID Priority 50000 Address 00.00.00.00.00.02 Hello Time 2 sec Max Age 20 sec Forward Delay 15 sec

Port DesignatedName Port ID Prio Cost Sts Cost Bridge ID Port ID-------------- ------- ---- ---- --- ---- ----------------- ------- switchport0 128.9 128 4 DIS 4 00.00.00.00.00.02 128.9 switchport1 128.10 128 4 FWD 0 00.11.8b.00.27.13 128.12 switchport2 128.11 128 4 DIS 4 00.00.00.00.00.02 128.11 switchport3 128.12 128 4 BLK 0 00.11.8b.00.27.13 128.14

178

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show spanning-tree summary

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW SPANNING-TREE SUMMARYshow spanning-tree summary

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays only a summary of the spanning tree information.

PARAMETERS

None.

EXAMPLEALU(config)# show spanning-tree summary

Name Blocking Listening Learning Forwarding STP Active--------------- -------- --------- -------- ---------- ----------VLAN1 4 0 0 0 4--------------- -------- --------- -------- ---------- --------1 VLANs 4 0 0 0 4

179Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Spanning Tree Protocol

Left running head: Chapter name (automatic)

SPANNING-TREEspanning-tree enable

DESCRIPTION

This command is entered in the Configuration Mode. This command enables a spanning-tree for the default VLAN, i.e., VLAN-1.

PARAMETERS

None.

DEFAULT VALUE

By default, spanning tree is disabled.

EXAMPLE

The following command enables the spanning tree for the default VLAN, i.e., VLAN-1:

ALU(config)# spanning-tree enable

SPANNING-TREE COST spanning-tree cost <1-65535>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command calculates the path cost of spanning tree on an interface.

Note: When two bridges compete for position as the root bridge, configure the spanning tree cost to prioritize an interface.

The spanning tree cost is configured on a per port basis.

PARAMETERS

DEFAULT VALUE

Default value: 4

EXAMPLEALU(config-if switchport1)# spanning-tree cost 1000

Parameter Description

1-65535 Spanning tree port cost.

180

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

spanning-tree enable fwd-time/hello-time/max-age/priority

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SPANNING-TREE ENABLE FWD-TIME/HELLO-TIME/MAX-AGE/PRIORITY

spanning-tree enable {forward-time <4-30>|hello-time <1-10>|max-age <6-40>|priority <0-65535>}

DESCRIPTION

This command is entered in the Configuration Mode to configure a spanning tree forward-time/hello-time/maximum-age/bridge priority.

Note: The following formula has to be satisfied when configuring the forward-time, hello-time, and max-age:((forward-time - 1) * 2) >= max-age && max-age >= ((hello-time + 1) * 2).

PARAMETERS

DEFAULT VALUE

The default for each of the parameter is given below:• Forward time: 15 seconds• Hello-time: 2 seconds• Max-age: 20 seconds• Priority: 32768

EXAMPLE

The following examples configures the spanning tree forward-time to 30, hello-time to 10 and maximum-age to 40:

ALU(config)# spanning-tree enable forward-time 30

ALU(config)# spanning-tree enable hello-time 10

ALU(config)# spanning-tree enable max-age 40

ALU(config)# spanning-tree enable priority 100

Parameter Description

4-30 Forward delay time.

1- 10 The spanning tree hello-time.

6-40 The spanning tree maximum aging time.

0-65535 The spanning tree bridge priority.

181Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Spanning Tree Protocol

Left running head: Chapter name (automatic)

SPANNING-TREE PORT-PRIORITYspanning-tree port-priority <0-255>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to prioritize an interface.

Note: When two bridges compete for position as the root bridge, port priority command is used to prioritize an interface.

Spanning tree port priority is configured on a per port basis.

PARAMETERS

DEFAULT VALUE

The default value for port priority is: 128

EXAMPLEALU(config-if switchport1)# spanning-tree port-priority 250

SPANNING-TREE SPANNING-DISABLEDspanning-tree spanning-disabled

DESCRIPTION

This command is entered in the Interface Configuration Mode. This disables the spanning tree on a specific interface.

PARAMETERS

None.

DEFAULT VALUE

None.

EXAMPLEALU(config-if switchport1)# spanning-tree spanning-disabled

Parameter Description

0-255 Spanning tree port priority.

182

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Integrated Routing and Bridging

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 8 INTEGRATED ROUTING AND BRIDGING

This chapter documents the Command Line Interface (CLI) commands for Integrated Routing and Bridging (IRB).

This chapter includes tables of parameters, default values, and configuration examples for configuring the IRB as quick-start and reference information. In this chapter, all commands are described in alphabetical order. For more detailed information on using and configuring IRB refer to the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

183Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Integrated Routing and Bridging

Left running head: Chapter name (automatic)

IRB CLI COMMANDSThis section deals with the commands related to configuring IRB on an interface.

INTERFACE VLANinterface vlan <1-4094>

DESCRIPTION

This is entered in the Interface Configuration Mode. This command is used to configure a VLAN.

PARAMETERS

Note: Vlan ID = 1 can also be configured for IRB.

EXAMPLEALU(config)# interface vlan 10

Parameter Description

1-4094 VLAN-ID configured on the interface.

184

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show interfaces vlan

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW INTERFACES VLAN show interfaces vlan <1-4094>

DESCRIPTION

This is entered in the Super User Mode, Configuration Mode or Interface Configuration Mode. This command displays the VLAN statistics of the VLAN-ID specified on the interface.

PARAMETERS

EXAMPLEALU(config)# show interfaces vlan 10

vlan10 is upHardware is none, address is 0011.8b00.0e28 (0011.8b00.0e28)Internet address is 10.91.0.1/24MTU 1500 bytes, BW 0 Kbit, DLY 0 usec, reliability 0/255, txload 0/255, rxload 0/255loopback not set, Keepalive not setAuto-duplex, Auto, 1000BaseTx/FxLast input never, output never, output hang neverLast clearing of "show interface" counters neverQueueing strategy: fifoOutput queue 0/0(size/max),0 drops;Input queue 0/0 (size/max), 0 drops5 minute input rate 0 bits/sec, 0 packets/sec5 minute output rate 0 bits/sec, 0 packets/sec2034961 packets input, 0 bytes, 0 no bufferReceived 0 broadcasts, 0 runts, 0 giants0 input errors,0 CRC, 0 frame,0 overrun,1580 ignored0 watchdog, 0 multicast, 0 pause input2035879 packets output, 0 bytes, 0 underruns0 output errors, 0 collisions, 0 interface resets0 babbles, 0 late collision, 0 deferred0 lost carrier, 0 no carrier, 0 pause output

Parameter Description

1-4094 The VLAN-ID configured on the interface whose VLAN statistics is to be viewed.

185Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Integrated Routing and Bridging

Left running head: Chapter name (automatic)

186

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

For final production, import color definitions from\\daldoc01\docteam\templates\framemaker\book-template\color-defs\ production-colors.fm. Do not import other template elements such as page layout.

To return to the draft version, import color def’ns from draft-colors.fm.To switch to the beta version, import color def’ns from beta-colors.fm

For final production, import color definitions from\\daldoc01\docteam\templates\framemaker\book-template\color-defs\ production-colors.fm. Do not import other template elements such as page layout.

To return to the draft version, import color def’ns from draft-colors.fm.To switch to the beta version, import color def’ns from beta-colors.fm

Optional footer: Manual title (to set, redefine ManualTitlevariable)

agination: umeric & ntinuous

PNco

Part 3 WAN Interfaces and Protocols

Beta BetaAlcatel-Lucent

187

Beta Betawith preceding section of book

OmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Left running head: Chapter name (automatic)

188

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ADSL (Asymmetric Digital Subscriber Line)

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 9 ADSL (ASYMMETRIC DIGITAL SUBSCRIBER LINE)

This chapter documents the CLI commands for ATM interface on the OmniAccess 5510-AA/AB USG.

This document includes tables of parameters, default values, and configuration examples for ATM interface configuration as quick-start and reference information. Within each of these sections the commands are described in alphabetical order. For more detailed information about using and configuring ATM interface, refer to the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

Note: ATM interface can be configured only on OmniAccess 5510-AA/AB USG. OmniAccess 5510-SR USG and OmniAccess 5510-TE USG do not support ATM interface configuration.

The underlying encapsulation on the ADSL link is ATM. Hence, the ADSL link is addressed as the ATM interface in the OmniAccess 5510 USG.

189Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

ADSL (Asymmetric Digital Subscriber Line)

Left running head: Chapter name (automatic)

CBRcbr <1-4000>

DESCRIPTION

This command is entered in the Sub-interface Configuration Mode. This command is used to configure CBR on the interface using Peak Cell Rate in Kbps.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510-AA/AB USG

EXAMPLEALU(config-subif atm0.1)# cbr 1000

RELEASE HISTORY

Release 3.0: command was introduced.

CLEAR COUNTERSclear counters atm

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command clears the packet counters for the specified ATM interface.

PARAMETERS

None.

EXAMPLEALU(config)# clear counters atm

Parameter Description

1-4000 Peak Cell Rate in Kbps.

190

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

dsl operating-mode

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

DSL OPERATING-MODEdsl operating-mode {adsl2plus [annexm]|ansi-dmt|auto| glite|itu-dmt|itu-dmt-bis [annexm]}

This command is entered in the Interface Configuration Mode. This command is used to configure DSL operating mode for the ATM interface on OmniAccess 5510-ADSL Annex A system.

dsl operating-mode {adsl2plus|etsi|auto|itu-dmt|itu-dmt-bis}

This command is entered in the Interface Configuration Mode. This command is used to configure DSL operating mode for the ATM interface on OmniAccess 5510-ADSL Annex B system.

DESCRIPTION

By default, ATM interface will come up in 'Auto' operating mode. It automatically detects DSLAM’s operating mode and train itself.

PARAMETERS

Parameter Description

adsl2plus Configures the ADSL interface to train in ITU G.992.5 mode. You can configure this mode only when it is supported on the DSLAM.

ansi-dmt Configures the ATM interface to train in the ANSI T1.413 Issue II mode.

etsi Configures the ATM interface to train in the ETSI mode.

auto Configures the ADSL interface to auto negotiate settings with the DSLAM located at the central office.

glite Configures the ATM interface to train in ITU G.992.2 mode.

itu-dmt Configures the ADSL interface to train in ITU G.992.1 mode.

itu-dmt-bis Configures the ADSL interface to train in ITU G.992.3 mode. You can configure this mode only when it is supported on the DSLAM.

annexm Configures the ATM interface to train for higher (upto 3 Mbps) upstream rate.

191Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

ADSL (Asymmetric Digital Subscriber Line)

Left running head: Chapter name (automatic)

DEFAULT VALUE

Default is ‘auto’.

PLATFORMS SUPPORTED

OmniAccess 5510-AA/AB USG

EXAMPLEALU(config-if atm0)# dsl operating-mode etsi

RELEASE HISTORY

Release 3.0: Keyword ‘glite’ and ‘annexm’ was added.

192

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

encapsulation

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

ENCAPSULATION encapsulation {aal5-llc-snap|aal5-vc-mux} {bridged|ip|mer|pppoa|pppoe}

DESCRIPTION

This command is entered in the Sub-interface Configuration Mode. This command is entered in the Sub-interface Configuration Mode to set the encapsulation on the interface.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510-AA/AB USG

EXAMPLEALU(config-subif atm0.1)# encapsulation aal5-llc-snap ip

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

bridged Set 1483 bridged encapsulation on the interface.

ip Set 1483 routed encapsulation on the interface.

mer Set MER encapsulation on the interface.

pppoa Set PPPoA encapsulation on the interface.

pppoe Set PPPoE encapsulation on the interface.

193Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

ADSL (Asymmetric Digital Subscriber Line)

Left running head: Chapter name (automatic)

INTERFACE ATMinterface atm <port>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure an ATM interface. Enters ATM Interface Configuration Mode.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# interface atm 0ALU(config-if atm0)#

Parameter Description

port Port number of the interface.

194

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

interface atm <port>.<subinterface-id>

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

INTERFACE ATM <PORT>.<SUBINTERFACE-ID>interface atm <port>.<subinterface-id>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command enables you to configure a sub-interface on the ATM interface. This enters the Sub-interface Configuration Mode (S-ICM).

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510-AA/AB USG

EXAMPLEALU(config)# interface atm 0.1ALU(config-subif atm0.1)#

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

<port>.<subinterface-id> Port number of the interface and sub interface ID.The range for sub-interface is 1-15.

195Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

ADSL (Asymmetric Digital Subscriber Line)

Left running head: Chapter name (automatic)

IP ADDRESSip address {<ip-address subnet-mask>|<ip-address/prefix-length>}

DESCRIPTION

This command is entered in the Sub-interface Configuration Mode. This command is used to assign an IP address and subnet mask on an ATM sub-interface.

Note: - The IP address configuration is optional when MER/1483 Routed encapsulation is configured on the ATM sub-interface provided DHCP client is enabled on the interface.ORYou can have a static IP address configured on the MER/1483 Routed enabled interface provided DHCP client is not enabled on the interface.

- The IP address configuration is optional when PPPoE/PPPoA encapsulation is configured on the ATM sub-interface. The IP address is obtained from the PPPoE server/PPPoA peer during IPCP negotiation. For this, you need to configure “ppp ipcp address accept-local” on the sub-interface. For more details on this, refer to the IPCP configuration section documented in the “Point-to-Point Protocol” chapter.ORYou can have a static IP address configured on the PPPoE/PPPoA enabled interface provided appropriate configurations are done at the remote end.

- It is not required to configure the IP address on the ATM sub-interface when 1483 Bridged encapsulation is set on the interface. The IP address configured will not be applicable once the BCP is enabled on the interface.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510-AA/AB USG

EXAMPLEALU(config-subif atm0.1)# ip address 192.168.3.4/24

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

{<ip-address subnet-mask>|<ip-address/prefix-length>

IP address with its subnet mask or prefix length.

196

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

mtu

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

MTUmtu <64-1500>

DESCRIPTION

This command is entered in the Sub-interface Configuration Mode. This command is used to configure the MTU of the sub-interface, i.e., the maximum packet size that the interface can accept.

PARAMETERS

DEFAULT VALUE

1500 bytes.

PLATFORMS SUPPORTED

OmniAccess 5510-AA/AB USG

EXAMPLEALU(config-subif atm0.1)# mtu 100

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

64-1500 Maximum packet size that the interface can accept.

197Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

ADSL (Asymmetric Digital Subscriber Line)

Left running head: Chapter name (automatic)

NO CBRno cbr

This command is entered in the Sub-interface Configuration Mode. This command disables the CBR on the interface.

NO ENCAPSULATION AAL5-LLC-SNAPno encapsulation {aal5-llc-snap|aal5-vc-mux} {bridged|pppoa|pppoe|ip}

This command is entered in the Sub-interface Configuration Mode. This command removes the configured encapsulation on the interface, and sets it to default. The default encapsulation on ATM sub-interface is MER.

NO MTUno mtu <64-1500>

The “no” command sets the MTU to its default. The default MTU is 1500 bytes.

NO PVCno pvc vpi <0-255> vci <32-2047>

This command is entered in the Sub-interface Configuration Mode. This command removes the configured PVC value on the sub-interface.

NO UBRno ubr

This command is entered in the Sub-interface Configuration Mode. This command disables UBR on the interface.

NO UBR+no ubr+

This command is entered in the Sub-interface Configuration Mode. This command disables UBR+ on the interface.

NO VBR-RTno vbr-rt

This command is entered in the Sub-interface Configuration Mode. This command disables the VBR-rt on the interface.

NO VBR-NRTno vbr-nrt

This command is entered in the Sub-interface Configuration Mode. This command disables the VBR-nrt on the interface.

198

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

no shutdown

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NO SHUTDOWNno shutdown

DESCRIPTION

This command when entered in the Interface Configuration Mode is used to administratively bring up the interface.

Note: If the operating-mode for ATM interface is "auto" (default), then upon "no shutdown", ATM interface would train itself to DSLAM's operating-mode.

If the operating-mode on DSLAM is "auto", then upon "no shutdown", the ATM interface would train itself to configured operating-mode.

If the operating-mode configured on the ATM interface is other than ‘auto’, and does not match the DSLAM's operating-mode, the interface will not come up.

If the operating-mode configured on the ATM interface and DSLAM is ‘auto’, then the operating-mode will be negotiated to the maximum possible bandwidth supported by DSLAM.

This command when entered in the Sub-interface Configuration Mode is used to administratively bring up the sub-interface.

PARAMETERS

None.

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510-AA/AB USG

EXAMPLEALU(config-if atm0)# no shutdown

ALU(config-subif atm0.1)# no shutdown

RELEASE HISTORY

Release 3.0: ‘no shutdown’ command in sub-interface configuration mode was introduced.

199Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

ADSL (Asymmetric Digital Subscriber Line)

Left running head: Chapter name (automatic)

PVCpvc vpi <0-255> vci <32-2047>

DESCRIPTION

PVC is a manually provisioned circuit between a specific source and destination.

This command is entered in the Sub-interface Configuration Mode. This command is used to bring up the data channel. This command is used to configure ATM PVC value on the sub-interface.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510-AA/AB USG

EXAMPLEALU(config-subif atm0.1)# pvc vpi 1 vci 32

RELEASE HISTORY

Release 3.0: command was introduced in ATM sub-interface configuration mode.

Parameter Description

0-255 VPI range.

32-2047 VCI range.

200

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show atm vc

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW ATM VCshow atm vc

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. Displays the PVC specific details of the ATM interface.

PARAMETERS

None.

EXAMPLEALU(config)# show atm vc

atm0.3: VPI: 0 VCI: 0PPPoE over AAL5-LLC/SNAPTraffic Class: UBRatm0.2: VPI: 0 VCI: 33PPPoE over AAL5-VC-MUXTraffic Class: UBRatm0.1: VPI: 0 VCI: 0PPPoE over AAL5-LLC/SNAPTraffic Class: UBR

201Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

ADSL (Asymmetric Digital Subscriber Line)

Left running head: Chapter name (automatic)

SHOW DSL INTERFACE ATMshow dsl interface atm [<port>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. Displays the DSL specific details of the interface.

PARAMETERS

EXAMPLEALU(config)# show dsl interface atm 0

ADSL Modem Status: SHOWTIME TC SYNCDSL Mode: ITU G.992.5 (ADSL2+)ADSL alarms: ATU-R: None ATU-C: NoneLatency Type: Fast ATU-R (DS) ATU-C (US)Attenuation(dB) : 11.1 11.2Noise Margin(dB) : 7.5 7.2Trellis Encoding : ON ON Interleave Fast Interleave FastMax Negotiated data rate (kbps): 0 23766 0 1255Max attainable data rate (kbps): 0 24672 0 771CRC : 0 52 0 5772FEC : 0 0 0 0HEC : 0 105 0 33998

Parameter Description

port Port number of an interface.

202

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show interfaces atm

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW INTERFACES ATMshow interfaces atm <port>.<sub-interface-id>

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. Displays the statistics for a specific ATM sub-interface.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510-AA/AB USG

EXAMPLEALU# show interfaces atm 0.2

atm0.2 is up, line protocol is up Internet address is 24.4.4.19/24 Encapsulation pppoe PPPoE session self-MAC: 00e0.b1c4.d7c0 PPPoE session remote-MAC: 0002.a54e.9404 keepalive set (10 sec) LCP: Open IPCP: Open VPI: 0, VCI: 33 UBR MTU: 1492 Output queue 0/0 (size/max), 0 drops; Input queue 0/0 (size/max), 0 drops 5 minute input rate 64 bits/sec, 0 packets/sec 5 minute output rate 56 bits/sec, 0 packets/sec 9706 packets input, 623254 bytes, 0 no buffer Received 0 broadcasts, 0 runts, 0 giants 0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored 0 watchdog, 0 multicast, 0 pause input 9681 packets output, 620504 bytes, 0 underruns 0 output errors, 0 collisions, 0 interface resets 0 babbles, 0 late collision, 0 deferred 0 lost carrier, 0 no carrier, 0 pause output 0 output buffer copied, 0 interrupts, 0 failures

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

<port>.<sub-interface-id> Port number of the interface, and sub-interface ID.

203Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

ADSL (Asymmetric Digital Subscriber Line)

Left running head: Chapter name (automatic)

SHUTDOWNshutdown

DESCRIPTION

This command when entered in the Interface Configuration Mode is used to administratively bring down the interface.

This command when entered in the Sub-interface Configuration Mode is used to administratively bring down the sub-interface.

PARAMETERS

None.

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510-AA/AB USG

EXAMPLEALU(config-if atm0)# shutdown

ALU(config-subif atm0.1)# shutdown

RELEASE HISTORY

Release 3.0: ‘shutdown’ command in sub-interface configuration mode was introduced.

204

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ubr

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

UBRubr [<1-4000>]

DESCRIPTION

This command is entered in the Sub-interface Configuration Mode. This command is used to configure UBR on the interface using Peak Cell Rate in Kbps.

PARAMETERS

DEFAULT VALUE

By default, UBR is configured on the ATM sub-interface.

PLATFORMS SUPPORTED

OmniAccess 5510-AA/AB USG

EXAMPLEALU(config-subif atm0.1)# ubr

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

1-4000 Peak Cell Rate in Kbps.

205Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

ADSL (Asymmetric Digital Subscriber Line)

Left running head: Chapter name (automatic)

UBR+ubr+ [<1-4000>] [<1-4000>]

DESCRIPTION

This command is entered in the Sub-interface Configuration Mode. This command is used to configure UBR+ on the interface.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510-AA/AB USG

EXAMPLEALU(config-subif atm0.1)# ubr+

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

1-4000 Peak Cell Rate in Kbps.

1-4000 Minimum Cell Rate in Kbps.

206

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

vbr-rt

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

VBR-RTvbr-rt <1-4000> <1-4000> <1-500>

DESCRIPTION

This command is entered in the Sub-interface Configuration Mode. This command is used to configure VBR-rt on the interface.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510-AA/AB USG

EXAMPLEALU(config-subif atm0.1)# vbr-rt 1000 1000 100

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

1-4000 Peak Cell Rate in Kbps.

1-4000 Average Cell Rate in Kbps.

1-500 Maximum Burst Size (no. of cells).

207Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

ADSL (Asymmetric Digital Subscriber Line)

Left running head: Chapter name (automatic)

VBR-NRTvbr-nrt <1-4000> <1-4000> <1-500>

DESCRIPTION

This command is entered in the Sub-interface Configuration Mode. This command is used to configure VBR-nrt on the interface.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510-AA/AB USG

EXAMPLEALU(config-subif atm0.1)# vbr-nrt 1000 1000 100

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

1-4000 Peak Cell Rate in Kbps.

1-4000 Sustained Cell Rate in Kbps.

1-500 Maximum Burst Size (no. of cells).

208

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Universal Serial Port (USP)

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 10 UNIVERSAL SERIAL PORT (USP)

This chapter documents the CLI commands for the Universal Serial Port (V.35/X.21/RS-232) on the OmniAccess 5510-SR USG.

This document includes tables of parameters, default values, and configuration examples for the V.35/X.21/RS-232 interface configuration as quick-start and reference information. Within each of these sections the commands are described in alphabetical order. For more detailed information about using and configuring the V.35/X.21/RS-232, refer to the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

Note: Serial (V.35/X.21/RS-232) interface can be configured only on OmniAccess 5510-SR USG. OmniAccess 5510-AA/AB USG and OmniAccess 5510-TE USG do not support serial interface configuration.

209Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Universal Serial Port (USP)

Left running head: Chapter name (automatic)

CLEAR COUNTERSclear counters Serial <port>

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Interface Configuration Mode. This command clears the counters for the specified serial interface.

PARAMETERS

EXAMPLEALU(config)# clear counters Serial 0Clear counters on this interface [confirm] y

CLOCKRATE clockrate {1024000|128000|2048000|256000|512000|64000}

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command configures the clock rate.

Note: In RS-232 mode, maximum clock rate of 256 Kbps is supported.

PARAMETERS

DEFAULT VALUE

The default value for clock rate is 64000 bps.

EXAMPLEALU(config-if Serial0)# clockrate 256000

Parameter Description

port Port number of the serial interface.

Parameter Description

1024000|128000|2048000|256000|512000|64000

These are values you can set for the clock rate.

210

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

crc

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CRC crc {16|32}

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to enable CRC.

PARAMETERS

DEFAULT VALUE

The default CRC value is 16.

EXAMPLEALU(config-if Serial0)# crc 16

INTERFACE SERIAL interface Serial <port>

DESCRIPTION

This command is entered in the Configuration Mode to configure a serial interface. Enters Interface Configuration Mode.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)#interface Serial 0ALU(config-if Serial0)#

Parameter Description

16|32 These are the values you can set for the CRC.

Parameter Description

port Port number of the interface.

211Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Universal Serial Port (USP)

Left running head: Chapter name (automatic)

INVERT TXC invert-txc

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command inverts the transmit clock to correct phase shift between the clock and the data.

PARAMETERS

None.

DEFAULT VALUE

By default, the transmit clock is not inverted.

EXAMPLEALU(config-if Serial0)# invert-txc

IP ADDRESS ip address {<ip-address subnet-mask>|<ip-address/prefix-length>}

DESCRIPTION

This command is entered in the Interface Configuration Mode to configure the IP address for the interface.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-if Serial0)# ip address 20.20.20.20/24

Parameter Description

ip-address subnet-mask IP address with subnet mask.

ip-address/prefix-length IP address with prefix length.

212

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

loopback

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

LOOPBACK loopback

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command configures an interface in the loopback mode.

PARAMETERS

None.

DEFAULT VALUE

None

EXAMPLEALU(config-if Serial0)# loopback

ENCAPSULATION encapsulation {frame-relay|hdlc|ppp}

DESCRIPTION

This command is entered in the Interface Configuration Mode to set encapsulation on the serial interface.

PARAMETERS

DEFAULT VALUE

Default is HDLC.

EXAMPLE

The following example sets the encapsulation to FR:ALU(config-if Serial0)# encapsulation frame-relay

Parameter Description

frame-relay|hdlc|ppp Sets the encapsulation to Frame Relay/Point to Point Protocol./High Level Data Link Control.

213Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Universal Serial Port (USP)

Left running head: Chapter name (automatic)

MTUmtu <64-1500>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to configure the MTU value on the serial interface, i.e., the maximum size of the transmitted layer 2 payload.

PARAMETERS

DEFAULT VALUE

The default MTU is 1500 Mbps.

EXAMPLE

ALU(config-if Serial0)# mtu 1200

NO CLOCKRATEno clockrate {1024000|128000 |2048000|256000|512000|64000}

This command is entered in the Interface Configuration Mode. The “no” command sets the clock rate to default 64000 bps.

NO CRCno crc {16|32}

This command is entered in the Interface Configuration Mode. The “no” keyword sets the CRC value to default 16.

Parameter Description

64-1500 Size of packet in bytes in the range 64 - 1500.

214

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

no invert-txc

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NO INVERT-TXCno invert-txc

This command is entered in the Interface Configuration Mode. The “no” command will set the clock to the original phase.

NO LOOPBACKno loopback

This command is entered in the Interface Configuration Mode. The “no” command removes the loopback configured on the interface.

NO SHUTDOWNno shutdown

DESCRIPTION

This command is entered in the Interface Configuration Mode to administratively bring up the interface.

PARAMETERS

None.

EXAMPLEALU(config)#interface Serial 0ALU(config-if Serial0)# shutdown

215Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Universal Serial Port (USP)

Left running head: Chapter name (automatic)

SHOW INTERFACE show interfaces Serial [<port>]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Interface Configuration Mode. Displays the configuration details of the specified serial interface.

PARAMETERS

EXAMPLEALU# show interfaces Serial 0Serial0 is up, line protocol is up X.21 DTE Serial attached Internet address is 15.0.0.1/8 MTU 1500 bytes, BW 2048 Kbit, DLY 0 usec, reliability 0/255, txload 0/255, rxload 0/255 loopback not set Encapsulation hdlc, keepalive set (10 sec) Last input never, output never, output hang never Last claring of "show interface" counters never Queueing strategy: fifo Output queue: 0 0 (size/max) 0 drops:Input queue 0/0 (size/max) 0 drops Conversations: 0/0/0 (active/max active/max total) Reserved Conversations: 0/0 (allocated/max allocated) Available Bandwidth 2048 kilobits/sec 5 minute input rate 0 bits/sec, 0 packets/sec 5 minute output rate 0 bits/sec, 0 packets/sec 12105 packets input, 167342 bytes, 0 no buffer 0 Received 0 broadcasts, 0 runts, 0 giants, 0 throttles 0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort 31734317 packets output, 3037327615 bytes, 0 no buffer 8833175 output errors, 0 collisions, 0 interface resets 0 output buffer failures, 0 output buffers swapped out 0 carrier transitions DCD=up DSR=up DTR=up RTS=up CTS=up

Parameter Description

port Port number of the serial interface.

216

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

shutdown

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHUTDOWNshutdown

DESCRIPTION

This command is entered in the Interface Configuration Mode to administratively bring down the interface.

PARAMETERS

None.

EXAMPLE

The following example administratively brings down the V.35/X.21/RS-232 interface:ALU(config)#interface Serial 0ALU(config-if Serial0)# shutdown

217Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Universal Serial Port (USP)

Left running head: Chapter name (automatic)

218

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

T1E1 Interface

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 11 T1E1 INTERFACE

This chapter documents the CLI commands for the T1 and E1 interface on the OmniAccess 5510-TE USG. Some commands vary depending on whether you are configuring a T1 or an E1 interface. The chapter is hence divided into commands relating to E1 interface and T1 interface separately (“E1 CLI Commands” and “T1 CLI Commands”).

This chapter includes table of parameters, default values, and configuration examples for both the E1 and T1 interface configuration as a quick-start and reference information. Within each of these sections, the commands are described in alphabetical order. For more detailed information about using and configuring the T1 or E1 CLI, refer to the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

Note: T1 and E1 interface can be configured only on OmniAccess 5510-TE USG. OmniAccess 5510-AA/AB USG and OmniAccess 5510-SR USG do not support T1/E1 interface configuration.

219Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

T1E1 Interface

Left running head: Chapter name (automatic)

E1 CLI COMMANDSThis section deals with the commands relevant to only the E1 interface.

CARD TYPEcard type {E1|T1} <port>

DESCRIPTION

This command is entered in the Configuration Mode. This command is entered in the Configuration mode to set the mode of the T1E1 port.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# card type E1 0

Note: The T1E1 port is not functional until the mode is set to either T1 or E1. Reboot/Reload the system to change the mode, which will remove the previous configuration.

Parameter Description

E1|T1 Sets the mode of the T1E1 port.Use E1 keyword to set the mode to E1.

port Enter the port number.

220

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

clocksource

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CLOCKSOURCE clocksource {internal|line}

DESCRIPTION

This command is entered in the Controller Configuration Mode to set clocksource for E1 interface. The keyword "clocksource" is used to transmit clock signals. If a controller is specified as a primary or backup clocksource by the network-clock-select command, it must be set for clocksource line. Only one T1 or E1 controller at a time can recover network clock and distribute it to the internal clock generator.

PARAMETERS

DEFAULT VALUE

The default value for clocksource is internal.

EXAMPLEALU(config-controller E1)# clocksource line

Parameter Description

internal The controller synchronizes itself to the internal (system) clock.

line The controller recovers external clock from the line and provides the recovered clock to the internal (system) clock generator.

221Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

T1E1 Interface

Left running head: Chapter name (automatic)

CHANNEL-GROUP channel-group <0-0> timeslots <1-31> speed [56K|64K]

DESCRIPTION

This command is entered in the Controller Configuration Mode. This command is used to create a channel-group and set timeslots that vary from 1-31. This enables the interface on the controller.

PARAMETERS

DEFAULT VALUE

Default speed is 64 Kbps.

EXAMPLE

The following example configures a channel group on controller port:

a) To associate all the timeslots with the controller:ALU(config-controller E1)#channel-group 0 timeslots 1-31

b) To associate contiguous timeslots with the controller:ALU(config-controller E1)#channel-group 0 timeslots 1-10ALU(config-controller E1)#channel-group 0 timeslots 4,5,6

c) To associate non-contiguous timeslots with the controller:ALU(config-controller E1)#channel-group 0 timeslots 1,4,20

Parameter Description

0-0 The channel group that can be configured on the controller.

1-31 Range of the timeslots that can be associated with the controller. Could be specified as contiguous: 1,2,3 or 1-3 or could be specified as non-contiguous: 1,4,7.

56K|64K The speed of the underlying DS0s: 56 Kbps/64 Kbps.

222

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

controller

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CONTROLLER controller {E1|T1} <port>

DESCRIPTION

This command is used in Configuration Mode. This command configures an E1 or T1 controller.

PARAMETERS

EXAMPLEALU(config)# controller E1 0ALU(config-controller E1)#

ENCAPSULATION encapsulation {frame-relay|hdlc|ppp}

DESCRIPTION

This command is entered in the Interface Configuration Mode to set encapsulation on the interface.

PARAMETERS

DEFAULT VALUE

Default is HDLC.

EXAMPLEALU(config-if Serial0:0)# encapsulation frame-relay

Parameter Description

E1|T1 Configures an E1 or T1 controller. Use E1 keyword to configure an E1 controller.

port Enter the port number.

Parameter Description

frame-relay|hdlc|ppp Encapsulation type: Framerelay/ Point to Point Protocol/High Level Data Link Control.

223Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

T1E1 Interface

Left running head: Chapter name (automatic)

FRAMING framing {crc4|no-crc4}

DESCRIPTION

This command is entered in the Controller Configuration Mode. This is used to configure framing to either crc4 or no-crc4. The service provider determines which framing type, either crc4 or no-crc4 is required for your E1 circuit.

PARAMETERS

DEFAULT VALUE

The default framing value is crc4 in case of E1.

EXAMPLEALU(config-controller E1)# framing no-crc4

ALU(config-controller E1)# no framing

INTERFACE SERIAL interface Serial <port:channel>

DESCRIPTION

This command is entered in the Configuration Mode to configure a serial interface.

PARAMETERS

EXAMPLEALU(config)#interface Serial 0:0ALU(config-if Serial0:0)#

Parameter Description

crc4 4-bit cyclic redundancy check i.e., CRC4 frame is the E1 frame type.

no-crc4 No cyclic redundancy check i.e.,CRC4 frame is not the E1 frame type.

Parameter Description

port:channel Specifies the port number and the channel number.

224

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

linecode

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

LINECODE linecode {ami|hdb3}

DESCRIPTION

This command is entered in the Controller Configuration Mode to set a linecode for the E1 interface. The E1 service provider determines which line-code type, ami or hdb3, is required for your E1 circuit.

PARAMETERS

DEFAULT VALUE

HDB3 line code is the default for E1 lines.

EXAMPLEALU(config-controller E1)# linecode hdb3

LINE-TERMINATION line-termination {120ohm|75ohm}

DESCRIPTION

This command is entered in the Controller Configuration Mode to configure a line impedance of 75 or 120 ohm.

PARAMETERS

DEFAULT VALUE

The default line-termination value is 120 ohm.

EXAMPLEALU(config-controller E1)#line-termination 120

Parameter Description

ami Type of linecode.

hdb3 High-density bipolar 3 (HDB3) line-codetype. Valid for E1 controller only.

Parameter Description

120ohm|75ohm The line impedance value: 75 or 120 ohms.

225Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

T1E1 Interface

Left running head: Chapter name (automatic)

LOOPBACK loopback {local|network {line|payload}}

DESCRIPTION

This command is entered in the Controller Configuration Mode. Use the loopback controller configuration command to put the T1 or E1 line into loopback mode. It can be used to verify connectivity.

PARAMETERS

DEFAULT VALUE

Loopback is disabled by default for E1 lines.

EXAMPLEALU(config-controller E1)# loopback network line

Parameter Description

local The controller loops the internal signal back to the internal bus.

line The controller loops the external line signal back towards the network without re-framing the signal.

payload The controller loops the external line signal back towards the network and re-frames the signal.

226

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

mtu

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

MTUmtu <64-1500>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to configure the MTU value on the serial interface, i.e., the maximum size of the transmitted layer 2 payload.

PARAMETERS

DEFAULT VALUE

The default MTU is 1500 bytes.

EXAMPLE

ALU(config-if Serial0:0)# mtu 1200

NO CLOCKSOURCEno clocksource

This command is entered in the Controller Configuration Mode. The “no” keyword sets the clocksource to its default. The default value for clocksource is internal.

NO CHANNEL GROUPno channel-group <0-0>

This command is entered in the Controller Configuration Mode. This command removes the channel group configured on the controller.

NO ENCAPSULATIONno encapsulation

This command is entered in the Interface Configuration Mode. The “no” command restores the encapsulation to its default. The default is HDLC.

NO FRAMINGno framing

This command is entered in the Controller Configuration Mode. The “no” command resets the framing value to its default. The default framing value is crc4 for E1.

Parameter Description

64-1500 Size of packet in bytes in the range 64 - 1500.

227Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

T1E1 Interface

Left running head: Chapter name (automatic)

NO LINECODEno linecode

This command is entered in the Controller Configuration Mode. The “no” command sets the linecode to its default value.The default linecode value is HDB3.

NO LINE-TERMINATIONno line-termination

This command is entered in the Controller Configuration Mode. The “no” command sets the impedance value to its default. The default line-termination value is 120.

NO LOOPBACKno loopback

This command is entered in the Controller Configuration Mode. This command disables the loopback on the interface.

NO MTUno mtu

This command is entered in the Interface Configuration Mode. This command sets the MTU to its default.Default being 1500 bytes.

NO SHUTDOWNno shutdown

This command when entered in the Controller Configuration mode brings up the controller.

This command when entered in the Interface Configuration mode brings up the interface.

228

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show controller

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW CONTROLLER show controller [{E1|T1} <port>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays controller status that is specific to the controller hardware. The show controller E1 command displays the status of the E1 controller and displays information about clocksources and other settings for the ports.

EXAMPLEALU(config)# show controller

E1 0 is up. Controller type is Fractional E1 Line termination is 120ohm No Alarm Detected Framing is crc4, Line Code is hdb3, Clock Source is internal Total Data (Since last clearing of counters) 0 Line Code Violation, 0 Framing Errors 0 CRC Errors, 0 Far End Block Errors

ALU(config)# show controller E1 0

E1 0 is up. Controller type is Fractional E1 Line termination is 120ohm No Alarm Detected Framing is crc4, Line Code is hdb3, Clock Source is internal Total Data (Since last clearing of counters) 0 Line Code Violation, 0 Framing Errors 0 CRC Errors, 0 Far End Block Errors

229Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

T1E1 Interface

Left running head: Chapter name (automatic)

SHOW INTERFACESshow interfaces <name>

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the configuration of the specified interface.

PARAMETERS

None

EXAMPLEALU(config)# show interfaces Serial 0:0

Serial0:0 is Administratively down, line protocol is down Internet address not set MTU 1500 bytes, BW 64 Kbit, DLY 0 usec, reliability 255/255, txload 0/255, rxload 0/255 Loopback not set Encapsulation frame-relay, Keepalive set (10 sec) LMI enq sent 0, LMI stat recvd 0, LMI upd recvd 0, DTE LMI down LMI enq recvd 0, LMI stat sent 0, LMI upd sent 0 LMI DLCI 0 LMI type is Autosense frame relay DTE Last input never, output never, output hang never Last clearing of "show interface" counters never Queueing strategy: fifo Output queue: 0/0 (size/max) 0 drops; Input queue: 0/0 (size/max) 0 drops Conversations: 0/0/0/53298 (active/max active/max total) Reserved Conversations: 0/0 (allocated/max allocated) Available Bandwidth 64 kilobits/sec 5 minute input rate 0 bits/sec, 0 packets/sec 5 minute output rate 0 bits/sec, 0 packets/sec 0 packets input, 0 bytes, 0 no buffer Received 0 broadcasts, 0 runts, 0 giants, 0 throttles 0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort 0 packets output, 0 bytes, 0 underruns 0 output errors, 0 collisions, 0 interface resets 0 output buffer failures, 0 output buffers swapped out 0 carrier transitions

230

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

shutdown

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHUTDOWNshutdown

DESCRIPTION

This command is entered in the Controller Configuration Mode on the E1 controller. The keyword “shutdown” will administratively bring down the controller.

This command when entered in the Interface Configuration Mode is used to shutdown the interface. The keyword "no" will bring it up.

PARAMETERS

EXAMPLEALU(config-controller E1)# shutdown

ALU(config-if Serial0:0)# shutdown

Parameter Description

shutdown Shuts down the controller (when entered in the controller configuration mode).Shuts down the interface (when entered in the interface configuration mode).

231Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

T1E1 Interface

Left running head: Chapter name (automatic)

T1 CLI COMMANDSThe following section gives a succinct overview on the commands that are used only on the T1 controller.

CABLELENGTH LONGcablelength long {-15db|-22.5db|-7.5db|0db}

DESCRIPTION

This command is entered in the Controller Configuration Mode. This command is used to configure transmit and receive levels for a cable length (line build-out) longer than 660 ft for a T1 trunk.

PARAMETERS

DEFAULT VALUE

Cablelength of long 0 db is the default for T1 .

EXAMPLEALU(config-controller)# cablelength long -22.5db

Parameter Description

-15db Sets the receive sensitivity to -15db if the hardware has configurable receive sensitivity.

-22.5db Sets the receive sensitivity to -22.5db if the hardware has configurable receive sensitivity.

-7.5db Sets the receive sensitivity to -7.5 dB if the hardware has configurable receive sensitivity.

0db Sets the receive sensitivity to 0 dB if the hardware has configurable receive sensitivity.

232

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

cablelength short

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CABLELENGTH SHORTcablelength short {110ft|220ft|330ft|440ft|550ft|660ft}}

DESCRIPTION

This command is entered in the Controller Configuration Mode to set the cablelength for the T1 interface.

PARAMETERS

DEFAULT VALUE

The default length of the cable for a T1 interface is 110ft.

EXAMPLEALU(config-controller T1)# cablelength short 220

Parameter Description

110ft Cable length of 0 to 110 feet.

220ft Cable length of 111 to 220 feet.

330ft Cable length of 221 to 330 feet.

440ft Cable length of 331 to 440 feet.

550ft Cable length of 441 to 550 feet.

660ft Cable length of 551 to 660 feet.

233Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

T1E1 Interface

Left running head: Chapter name (automatic)

CARD TYPEcard type {E1|T1} <port>

DESCRIPTIONThis command is entered in the Configuration Mode to set the mode of the T1E1 port.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# card type T1 0

Note: The T1E1 port is not functional until the mode is set to either T1 or E1. Reboot/Reload the chassis to change the mode, which will remove the previous configuration.

Parameter Description

E1|T1 Sets the mode of the T1E1 port.Use T1 keyword to set the mode to T1.

port Enter the port number.

234

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

channel-group

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHANNEL-GROUPchannel-group <0-0> timeslots <1-24> speed [56K|64K]

DESCRIPTION

This command is entered in the Controller Configuration Mode. This command is used to create a channel-group and set timeslots that vary from 1-24. This enables the interface on the controller.

PARAMETERS

DEFAULT VALUE

Default speed is 64kbps.

EXAMPLE

The following example configures a channel group on controller T1:

a) To associate all the timeslots with the controller:

ALU(config-controller T1)#channel-group 0 timeslots 1-24

b) To associate contiguous timeslots with the controller:ALU(config-controller T1)#channel-group 0 timeslots 1-10ALU(config-controller T1)#channel-group 0 timeslots 1,2,3

c) To associate non-contiguous timeslots with the controller:ALU(config-controller T1)#channel-group 0 timeslots 1,4,20

Parameter Description

0-0 Channel group that can be configured on the controller.

1-24 Range of the timeslots that can be associated with the controller. Could be specified as contiguous: 1,2,3 or 1-3 or could be specified as non-contiguous: 1,4,7.

56K|64K The speed of the underlying DS0s: 56 kbps or 64 kbps. Default speed is 64 kbps.

235Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

T1E1 Interface

Left running head: Chapter name (automatic)

CLOCKSOURCE clocksource {internal|line}

DESCRIPTION

This command is entered in the Controller Configuration Mode to set clocksource for T1 interface. The keyword "clocksource" is used to transmit clock signals.

PARAMETERS

DEFAULT VALUE

Default clocksource is internal.

EXAMPLEALU(config-controller T1)# clocksource line

CONTROLLER controller {E1|T1} <port>

DESCRIPTION

This command is entered in the Configuration Mode. This command configures a E1 or T1 controller.

PARAMETERS

EXAMPLEALU(config)# controller T1 0ALU(config-controller T1)#

Parameter Description

internal The controller synchronizes itself to the internal (system) clock.

line The controller recovers external clock from the line and provides the recovered clock to the internal (system) clock generator.

Parameter Description

E1|T1 Configures an E1 or T1 controller. Use T1 keyword to configure a port in the T1 mode. The T1 has a bandwidth of 1.544 Mbps.

port Enter the port number.

236

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

encapsulation

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

ENCAPSULATION encapsulation {frame-relay|hdlc|ppp}

DESCRIPTION

This command is entered in the Interface Configuration Mode to set encapsulation on the interface.

PARAMETERS

DEFAULT VALUE

Default is HDLC encapsulation.

EXAMPLE ALU(config-if Serial0:0)# encapsulation frame-relay

FRAMING framing {esf|sf}

DESCRIPTION

This command is entered in the Controller Configuration Mode. This command is used to configure framing type. The service provider determines which framing type, either sf or esf is required for your T1 circuit.

PARAMETERS

DEFAULT VALUE

The default framing on T1 line is esf.

EXAMPLEALU(config-controller T1)#framing sf

Parameter Description

frame-relay|hdlc|ppp Encapsulation type: Framerelay/ Point to Point Protocol/High Level Data Link Control.

Parameter Description

esf Extended super frame is the T1 frame type.

sf Super frame is the T1 frame type.

237Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

T1E1 Interface

Left running head: Chapter name (automatic)

INTERFACE SERIAL interface Serial <port:channel>

DESCRIPTION

This command is entered in the Interface Configuration Mode to configure a serial interface.

PARAMETERS

EXAMPLEALU(config)#interface Serial 0:0ALU(config-if Serial0:0)#

LINECODE linecode {ami|b8zs}

DESCRIPTION

This command is entered in the Controller Configuration Mode. Use this command to configure the line-code type for a T1 line. The T1 service provider determines which line-code type, ami or b8zs, is required for your T1 circuit.

PARAMETERS

DEFAULT VALUE

The default linecode value is b8zs.

EXAMPLEALU(config-controller T1)# linecode ami

Parameter Description

port Specifies the port number.

channel Specifies the channel number.

Parameter Description

ami Alternate Mark Inversion (AMI) line-code type. If ‘ami’ linecode is configured, configure timeslot speed to 56Kbps to ensure 1st density.

b8zs b8zs line-code type.

238

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

loopback

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

LOOPBACK loopback {local|network {line|payload}}

DESCRIPTION

This command is entered in the Controller Configuration Mode. Use the loopback controller configuration command to put the T1 or E1 line into loopback mode. It can be used to verify connectivity.

PARAMETERS

DEFAULT VALUE

Loopback is disabled by default for T1 lines.

EXAMPLEALU(config-controller T1)# loopback network payload

Parameter Description

local The controller loops the internal signal back to the internal bus.

line The controller loops the external line signal back towards the network without reframing the signal.

payload The controller loops the external line signal back towards the network and reframes the signal.

239Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

T1E1 Interface

Left running head: Chapter name (automatic)

MTUmtu <64-1500>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to configure the MTU value on the serial interface, i.e., the maximum size of the transmitted layer 2 payload.

PARAMETERS

DEFAULT VALUE

The default MTU is 1500 bytes.

EXAMPLE

ALU(config-if Serial0:0)# mtu 1000

NO CABLELENGTHno cablelength

This command is entered in the Controller Configuration Mode. This command is used to restore the value to its default.

NO CLOCKSOURCEno clocksource

This command is entered in the Controller Configuration Mode. The “no” keyword sets the clocksource to its default.

NO CHANNEL-GROUPno channel-group <0-0>

This command is entered in the Controller Configuration Mode. This command removes the channel-group configured on the controller.

NO ENCAPSULATION no encapsulation

This command is entered in the Interface Configuration Mode. This command restores the encapsulation to its default.

Parameter Description

64-1500 Size of packet in bytes in the range 64 - 1500.

240

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

no framing

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NO FRAMINGno framing

This command is entered in the Controller Configuration Mode. This command resets the framing value to its default.

NO LINECODEno linecode

This command is entered in the Controller Configuration Mode. This command sets the line coding to its default value.For b8zs the default line coding value is b8zs. For hdb3 the default line code value is HDB3.

NO LOOPBACKno loopback

This command is entered in the Controller Configuration Mode. The command disables the loopback mode set on the interface. The default loopback for T1 lines is Local.

NO MTUno mtu

This command is entered in the Interface Configuration Mode. This command sets the MTU to its default.

NO SHUTDOWNno shutdown

This command when entered in the Controller Configuration mode brings up the controller.

This command when entered in the Interface Configuration mode brings up the interface.

241Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

T1E1 Interface

Left running head: Chapter name (automatic)

SHOW CONTROLLER show controller [{E1|T1} <port>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays controller status that is specific to the controller hardware.

PARAMETERS

EXAMPLEALU(config)# show controller

T1 0 is down. Controller type is Fractional T1 Cablelength is long 0db Transmitter is sending remote alarm Receiver has loss of signal, loss of frame, Framing is esf, Line Code is b8zs, Clock Source is internal Total Data (Since last clearing of counters) 0 Line Code Violation, 0 Framing Errors 0 Out of Frame, 0 Bit Errors

ALU(config)# show controller T1 0

T1 0 is down. Controller type is Fractional T1 Cablelength is long 0db Transmitter is sending remote alarm Receiver has loss of signal, loss of frame, Framing is esf, Line Code is b8zs, Clock Source is internal Total Data (Since last clearing of counters) 0 Line Code Violation, 0 Framing Errors 0 Out of Frame, 0 Bit Errors

Parameter Description

port Specifies the port number.

242

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show interfaces

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW INTERFACESshow interfaces <name>

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the configuration of the specified interface.

PARAMETERS

None.

EXAMPLEALU(config-if Serial0:0)# show interfaces Serial 0:0

Serial0:0 is up, line protocol is up Internet address 1.1.1.1/24 MTU 1500 bytes, BW 64 Kbit, DLY 0 usec, reliability 255/255, txload 0/255, rxload 0/255 Loopback not set Encapsulation hdlc, keepalive set (10 sec) Last input never, output never, output hang never Last clearing of "show interface" counters never Queueing strategy: fifo Output queue: 0/0 (size/max) 0 drops; Input queue: 0/0 (size/max) 0 drops Conversations: 0/0/0/53298 (active/max active/max total) Reserved Conversations: 0/0 (allocated/max allocated) Available Bandwidth 64 kilobits/sec 5 minute input rate 0 bits/sec, 0 packets/sec 5 minute output rate 0 bits/sec, 0 packets/sec 0 packets input, 0 bytes, 0 no buffer Received 0 broadcasts, 0 runts, 0 giants, 0 throttles 0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort 0 packets output, 0 bytes, 0 underruns 0 output errors, 0 collisions, 0 interface resets 0 output buffer failures, 0 output buffers swapped out 0 carrier transitionsTimeslot(s) Used:1 (64Kbps each), Transmitter delay is 0 flags

243Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

T1E1 Interface

Left running head: Chapter name (automatic)

SHUTDOWNshutdown

DESCRIPTION

This command is entered in the Controller Configuration Mode on the T1 controller. The keyword “shutdown” will administratively bring down the controller.

This command when entered in the Interface Configuration Mode is used to shutdown the interface. The keyword "no" will bring it up.

PARAMETERS

EXAMPLEALU(config-controller T1)# shutdown

ALU(config-if Serial0:0)# shutdown

Parameter Description

shutdown Shuts down the controller (when entered in the controller configuration mode).Shuts down the interface (when entered in the interface configuration mode).

244

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Third Generation (3G) Wireless WAN Interface

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 12 THIRD GENERATION (3G) WIRELESS WAN INTERFACE

This chapter documents the CLI commands for configuration of 3G wireless WAN interface on the OmniAccess 5510 USG.

This document includes tables of parameters, default values, and configuration examples for the 3G wireless WAN interface configuration as quick-start and reference information. Within each of these sections the commands are described in alphabetical order. For more detailed information about using and configuring the 3G wireless WAN interface, refer to the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

245Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Third Generation (3G) Wireless WAN Interface

Left running head: Chapter name (automatic)

CHANGEchange {<1-65535> <1-65535>}

DESCRIPTION

This command is entered in the Dialer-list Configuration Mode. This command is used to change the priority of a specific dialer rule configured.

PARAMETERS

EXAMPLE

Consider the following configuration: ALU(config)# dialer-list list1ALU(config-dialer-list-list1)# 10 match m1 deny 20 match m2 permit 30 match m3 deny 40 match m4 permit default permit

In the above example, m4 has a priority 40. Use the “change“ keyword to change the priority of m4.

ALU(config-dialer-list-list1)# change 40 15

To view the dialer list configuration after changing the priority, give the show command. The output appears as shown:show dialer-list list1

dialer-list list1 10 match m1 deny 15 match m4 permit 20 match m2 permit 30 match m3 deny default permit

Parameter Description

1-65535 Denotes the dialer rule number. This rule number signifies the priority of a rule.

246

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

dialer group

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

Now, to generate a numbering scheme with a proper order, use the keyword “renumber”, as follows:

ALU(config-dialer-list-list1)# renumber

To view the filter configuration after renumbering, give the show command. The output appears as shown:show dialer-list list1

dialer-list list1 10 match m1 deny 20 match m4 permit 30 match m2 permit 40 match m3 denydefault permit

DIALER GROUPdialer group <dialer-list-name>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to attach a dialer list to the Celluar interface.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-if Cellular0)# dialer group list1

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

dialer-list-name Name of the dialer list.

247Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Third Generation (3G) Wireless WAN Interface

Left running head: Chapter name (automatic)

DIALER IDLE-TIMEOUTdialer idle-timeout <0-65000>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to specify the duration of idle time (in seconds) after which dialer will hang up the connection, if there is no interesting traffic.

PARAMETERS

DEFAULT VALUE

The default idle-time out is 120 seconds.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-if Cellular0)# dialer idle-timeout 25

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

0-65000 Specifies the duration of idle time (in seconds).

248

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

dialer in-band

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

DIALER IN-BANDdialer in-band

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to enable DDR on the Cellular interface.

PARAMETERS

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-if Cellular0)# dialer in-band

RELEASE HISTORY

Release 3.0: command was introduced.

249Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Third Generation (3G) Wireless WAN Interface

Left running head: Chapter name (automatic)

DIALER-LISTdialer-list <name>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to create a dialer list.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# dialer-list list1ALU(config-dialer-list-list1)#

RELEASE HISTORY

Release 3.0: command was introduced.

To Configure a Rule for a Dialer List:[<1-65535>] match [any|all] <match-list name>..{permit|deny}

The above command is used to configure rules (set priority for the rule, associate match-lists and action) for a dialer list, and also set the action deny or permit for the configured rules.

ExampleALU(config-dialer-list-list1)# 10 match m1 m2 permit

Parameter Description

name Name of the dialer list.

Parameter Description

1-65535 Denotes the dialer list number. The range for the dialer list rule.

match [any|all] <match-list name>

match all - In this type of match, the relevant action is performed only when all the match-list criteria is satisfied.match any - In this type of match, the relevant action is performed even if any one of the match-list criterion is satisfied.

permit Allows traffic through it. The dialer list has to be set to this mode to enable it.

deny This command prohibits the traffic through it.

250

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

dialer string

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

DIALER STRINGdialer string <string>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to configure the dial out number or string provided by the service provider prefixed with “ATDT”.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-if Cellular0)# dialer string ATDT*99#

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

string Specifies the dial out number or string for the dialer.

251Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Third Generation (3G) Wireless WAN Interface

Left running head: Chapter name (automatic)

ENCAPSULATION PPPencapsulation ppp

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command sets the encapsulation on the cellular interface.

PARAMETERS

None.

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-if Cellular0)# encapsulation ppp

RELEASE HISTORY

Release 3.0: command was introduced.

252

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

gsm network-selection

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

GSM NETWORK-SELECTIONgsm network-selection {GSM-Only|UTRAN-Only|auto}

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to configure the 3G network type for PLMN search operation.

Note: Execute this command before PLMN search command.

PARAMETERS

DEFAULT VALUE

The default network type is ‘auto’.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-if Cellular0)# gsm network-selection auto

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

GSM-Only Searches for all the currently available GSM networks at your location.

UTRAN-Only Searches for all the currently available 3G networks at your location.

auto Searches for all the currently available networks at your location (2G and 3G networks).

253Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Third Generation (3G) Wireless WAN Interface

Left running head: Chapter name (automatic)

GSM PLMN SEARCHgsm plmn search

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to search for the available PLMNs at your location.

Note: After you execute this command, wait for the search completion message. Use “show cellular 0 network” command to view the list of the PLMNs available. It may take a few minutes for the search to be completed.

PARAMETERS

None.

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-if Cellular0)# gsm plmn search

RELEASE HISTORY

Release 3.0: command was introduced.

254

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

gsm plmn select

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

GSM PLMN SELECTgsm plmn select {auto|manual <1-999> <1-999>}

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to configure the 3G modem to manually or automatically select the PLMN from the list of available networks in an area to attach the modem to.

PARAMETERS

DEFAULT VALUE

By default, the PLMN network option is set to “auto”.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-if Cellular0)# gsm plmn select auto

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

1-999 Specify the mobile country code for the the selected PLMN network.

1-999 Specify the mobile network code for the the selected PLMN network.

auto Select this option to automatically select the PLMN network from the list of available networks.

255Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Third Generation (3G) Wireless WAN Interface

Left running head: Chapter name (automatic)

GSM PROFILE ACTIVATEgsm profile activate <1-16>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to activate the specified GSM profile on 3G modem.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-if Cellular0)# gsm profile activate 1

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

1-16 Specify the GSM profile to be activated.

256

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

gsm profile create

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

GSM PROFILE CREATEgsm profile create <1-16> <profile-name> <access-point-name>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to create a new GSM data profile. You can create up to 16 profiles. You must get access point name from the service provider.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-if Cellular0)# gsm profile create 1 ATT isp.cingular

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

1-16 Specify the number for the profile you are creating.

profile-name Specify the name for the profile.

access-point-name Specify the access point for the profile.This name should be entered as given by the service provider.

257Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Third Generation (3G) Wireless WAN Interface

Left running head: Chapter name (automatic)

GSM PROFILE DEACTIVATEgsm profile deactivate <1-16>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to deactivate the specified GSM profile on 3G modem.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-if Cellular0)# gsm profile deactivate 1

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

1-16 Specify the GSM profile to be deactivated.

258

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

gsm profile delete

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

GSM PROFILE DELETEgsm profile delete <1-16>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to delete a GSM data profile.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-if Cellular0)# gsm profile delete 1

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

1-16 Specify the number for the profile you are deleting.

259Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Third Generation (3G) Wireless WAN Interface

Left running head: Chapter name (automatic)

GSM SIMgsm sim {lock|unlock} <0000-99999999>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to lock or unlock the SIM card. The 3G USG dongle is going to be locked only after the power cycle or modem removal and insertion.

Note: Note that post three unsuccessful attempts to unlock the SIM card, the SIM will be blocked for security reasons and becomes unusable, and can be unlocked only from the service provider.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-if Cellular0)# gsm sim lock

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

0000-99999999 Password to lock the SIM card.

260

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

interface cellular

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

INTERFACE CELLULARinterface Cellular <port>

DESCRIPTION

This command is entered in the Configuration Mode to configure a cellular interface. This enters the Interface Configuration Mode.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# interface Cellular 0ALU(config-if Cellular0)#

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

port Port number of the cellular interface.

261Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Third Generation (3G) Wireless WAN Interface

Left running head: Chapter name (automatic)

NO DIALER GROUPno dialer group <dialer-list-name>

This command is entered in the Interface Configuration Mode. This command detaches the dialer list attached to the Celluar interface.

Note: You cannot delete a dialer list that is attached to the interface. To delete, first detach the dialer list from the interface.

NO DIALER IDLE-TIMEOUTno dialer idle-timeout

This command is entered in the Interface Configuration Mode. The “no” command resets the idle timeout to its default. The default idle-time out is 120 seconds.

NO DIALER-LISTno dialer-list <name> [force]

This command is entered in the Configuration Mode. This command is used to delete a dialer list. If the dialer list is attached to an interface, it cannot be deleted.

The "force" keyword will automatically detach the specified dialer list from the interface, and deletes the dialer list. This command when used also deletes all the rules configured under a dialer list.

NO RULEno rule

This command is entered in the Dialer-list Configuration Mode. The command deletes a rule corresponding to the rule number in the dialer list.

262

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

no shutdown

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NO SHUTDOWNno shutdown

DESCRIPTION

This command is entered in the Interface Configuration Mode to administratively bring up the interface.

PARAMETERS

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-if Cellular0)# no shutdown

RELEASE HISTORY

Release 3.0: command was introduced.

RENUMBERrenumber

DESCRIPTION

This command is entered in the Dialer-list Configuration Mode. This command is used to generate a numbering scheme for the dialer rules configured.

PARAMETERS

None.

EXAMPLEALU(config-filter-f1)# renumber

263Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Third Generation (3G) Wireless WAN Interface

Left running head: Chapter name (automatic)

SHOW CELLULAR <PORT> ALLshow cellular <port> all

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Interface Configuration Mode. This command is used to display consolidated information about the 3G modem, profiles created, modem security information, and so on.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show cellular 0 all

Hardware Information=====================Manufacturer = huaweiModem Model = E220Modem Firmware Version = 11.117.10.00.00International Mobile Subscrber Identity (IMSI) = 310410285366870International Mobile Equipment Identity (IMEI) = 356635022837184Modem Status = Ready

Current Network Information===========================Packet Service = GSMPacket Session Status = InactiveCurrent Roaming Status = Registred,Home NetworkNetwork Selection Mode = AutomaticCountry = USA, Network =Mobile Country Code = 310Mobile Network Code = 410Location Area Code (LAC) = 1790Cell ID = 170EPLMN Selection = AutomaticRegisterd PLMN = , Abbrevated =Service Provider =

Radio Information=================Current Band = NA, Channel Number = NA

Parameter Description

port Port number of the cellular interface.

264

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show cellular <port> all

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

Current RSSI = -107 dbm

Modem Security Information==========================Card Holder Verification(CHV1) = DisabledSIM Status = OKSIM User Operation required = NoneNumber Of Retries Remaining = 3

Profile Information===================

RELEASE HISTORY

Release 3.0: command was introduced.

265Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Third Generation (3G) Wireless WAN Interface

Left running head: Chapter name (automatic)

SHOW CELLULAR <PORT> HARDWAREshow cellular <port> hardware

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Interface Configuration Mode. This command is used to display 3G modem hardware information.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show cellular 0 hardware

Hardware Information=====================Manufacturer = huaweiModem Model = E220Modem Firmware Version = 11.117.10.00.00International Mobile Subscrber Identity (IMSI) = 310410285366870International Mobile Equipment Identity (IMEI) = 356635022837184Modem Status = Ready

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

port Port number of the cellular interface.

266

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show cellular <port> network

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW CELLULAR <PORT> NETWORKshow cellular <port> network

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Interface Configuration Mode. This command is used to display information about the carrier network and service.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show cellular 0 network

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

port Port number of the cellular interface.

267Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Third Generation (3G) Wireless WAN Interface

Left running head: Chapter name (automatic)

SHOW CELLULAR <PORT> PROFILEshow cellular <port> profile {<1-16>|all}

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Interface Configuration Mode. This command is used to display information on a specific 3G modem data profile or profiles created in the system.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show cellular 0 profile all

Profile 1 = ACTIVE----------PDP Type = IPv4Header Compression = OFFData Compression = OFFProfile Name = 3g_1Access Point Name (APN) = IAPN16

Profile 2 = INACTIVE----------PDP Type = IPv4Header Compression = OFFData Compression = OFFProfile Name = 3G_2Access Point Name (APN) = IAPN16

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

port Port number of the cellular interface.

1-16 Displays information on a specific 3G modem data profile.

all Displays information on a specific 3G modem data profile or profiles created in the system

268

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show cellular <port> radio

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW CELLULAR <PORT> RADIOshow cellular <port> radio

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Interface Configuration Mode. This command is used to display the 3G modem radio statistics.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show cellular 0 radio

Radio Information=================Current Band = NA, Channel Number = NACurrent RSSI = -101 dbm

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

port Port number of the cellular interface.

269Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Third Generation (3G) Wireless WAN Interface

Left running head: Chapter name (automatic)

SHOW CELLULAR <PORT> SECURITYshow cellular <port> security

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Interface Configuration Mode. This command is used to display 3G modem security information such as the SIM and modem lock state.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show cellular 0 security

Modem Security Information==========================Card Holder Verification(CHV1) = DisabledSIM Status = OKSIM User Operation required = NoneNumber Of Retries Remaining = 0

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

port Port number of the cellular interface.

270

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show dialer-list

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW DIALER-LISTshow dialer-list <name>

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode. This command displays all the dialer lists configured. If the dialer list name is specified, it displays the details for the specified dialer list.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show dialer-list l1

dialer-list l1 default denytop!

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

name Name of the dialer list.

271Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Third Generation (3G) Wireless WAN Interface

Left running head: Chapter name (automatic)

SHUTDOWNshutdown

DESCRIPTION

This command is entered in the Interface Configuration Mode to administratively bring down the interface.

PARAMETERS

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-if Cellular0)# shutdown

RELEASE HISTORY

Release 3.0: command was introduced.

272

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

High-level Data Link Control

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 13 HIGH-LEVEL DATA LINK CONTROL

This chapter documents the Command Line Interface (CLI) commands for High Level Data Link Control (HDLC) Protocol. These commands are used to configure HDLC encapsulation on a Serial interface (V.35/X.21/RS-232) or a T1 or an E1 interface. You are required to refer to the “Universal Serial Port (USP)” and “T1E1 Interface” chapters before proceeding to this.

This chapter includes tables of parameters, default values, and configuration examples for HDLC configurations as quick-start and reference information. In this chapter, all the commands are described in alphabetical order. For more detailed information about using and configuring the HDLC Protocol, refer to the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

Note: HDLC encapsulation is supported on OmniAccess 5510-SR USG and OmniAccess 5510-TE USG. OmniAccess 5510-AA/AB USG do not support HDLC encapsuation.

The HDLC configuration commands in this chapter are shown for a serial (V.35/X.21/RS-232) interface as an example. The steps are similar for configuration of HDLC on a T1 or an E1 interface.

273Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

High-level Data Link Control

Left running head: Chapter name (automatic)

DEBUG HDLC ALLdebug hdlc all [detail-level <1-9>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command shows all the debug messages pertaining to HDLC functionality.

PARAMETERS

DEFAULT VALUE

By default, debug is disabled.

EXAMPLEALU(config)# debug hdlc all

Parameter Description

all Displays all the debug messages pertaining to HDLC functionality.

detail-level Displays detail level (default is 1).

1-9 Enable with specific detail level.

274

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

debug hdlc keepalive

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

DEBUG HDLC KEEPALIVEdebug hdlc keepalive [output {all|log|vty}]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command shows the HDLC keepalive messages.

PARAMETERS

DEFAULT VALUE

By default, debug is disabled.

EXAMPLEALU(config)# debug hdlc keepalive

Parameter Description

keepalive Displays Keepalive messages.

output all Output to all possible locations.

output log Output to system log.

output vty Output to VTY.

275Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

High-level Data Link Control

Left running head: Chapter name (automatic)

ENCAPSULATION HDLCencapsulation hdlc

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to configure HDLC encapsulation on the interface.

PARAMETERS

None.

DEFAULT VALUE

HDLC is the default encapsulation on serial interface.

EXAMPLEALU(config-if Serial0)# encapsulation hdlc

HDLC KEEPALIVE hdlc keepalive <0-32767>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command configures the HDLC keepalive interval. The same value shall be configured on the peer. A value of ‘0’ turns off the keepalive feature.

PARAMETERS

DEFAULT VALUE

Default is 10 seconds.

EXAMPLEALU(config-if Serial0)# hdlc keepalive 12

Parameter Description

0-32767 HDLC keepalive interval in the range of 0 - 32767 seconds.

276

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

hdlc down-when-looped

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

HDLC DOWN-WHEN-LOOPEDhdlc down-when-looped

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to bring down the line protocol when loopback is detected on the interface.

PARAMETERS

None.

DEFAULT VALUE

By default, bringing down of line protocol when the detected loopback is disabled.

EXAMPLEALU(config-if Serial0)# hdlc down-when-looped

NO DEBUG HDLCno debug hdlc {all|keepalive [output {all|log|vty}]}

This command is entered in the Super User Mode, Configuration Mode or Interface Configuration Mode. This command is used to disable the debug functionality. By default, debug is disabled.

NO ENCAPSULATIONno encapsulation {frame-relay|ppp}

DESCRIPTION

This command is entered in the Interface Configuration Mode.

This command is used to set the encapsulation to HDLC on the interface. This command is applicable only if the encapsulation is already set to Frame Relay or PPP.

PARAMETERS

EXAMPLEALU(config-if Serial0)# no encapsulation frame-relay

Parameter Description

frame-relay Frame-relay encapsulation.

ppp Point to Point Protocol encapsulation.

277Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

High-level Data Link Control

Left running head: Chapter name (automatic)

NO HDLC DOWN-WHEN-LOOPEDno hdlc down-when-looped

This command is entered in the Interface Configuration Mode. This command disables bringing down of the line protocol when loopback is detected on the interface. This is the default behavior.

NO HDLC KEEPALIVEno hdlc keepalive

This command is entered in the Interface Configuration Mode. This command resets the keepalive interval to its default, which is 10 seconds.

SHOW INTERFACEshow interfaces Serial [<port>]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Interface Configuration Mode. Use this command to verify the encapsulation type and the interface details.

PARAMETERS

EXAMPLEALU# show interfaces Serial 0

Serial0 is up, line protocol is up X.21 DTE Serial attached Internet address is 15.0.0.1/8 MTU 1500 bytes, BW 2048 Kbit, DLY 0 usec, reliability 0/255, txload 0/255, rxload 0/255 loopback not set Encapsulation hdlc, keepalive set (10 sec) Last input never, output never, output hang never Last claring of "show interface" counters never Queueing strategy: fifo Output queue: 0 0 (size/max) 0 drops:Input queue 0/0 (size/max) 0 drops Conversations: 0/0/0 (active/max active/max total) Reserved Conversations: 0/0 (allocated/max allocated) Available Bandwidth 2048 kilobits/sec 5 minute input rate 0 bits/sec, 0 packets/sec 5 minute output rate 0 bits/sec, 0 packets/sec 12105 packets input, 167342 bytes, 0 no buffer 0 Received 0 broadcasts, 0 runts, 0 giants, 0 throttles 0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort 31734317 packets output, 3037327615 bytes, 0 no buffer

Parameter Description

<port> Port number of the interface.

278

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show interface

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

8833175 output errors, 0 collisions, 0 interface resets 0 output buffer failures, 0 output buffers swapped out 0 carrier transitions DCD=up DSR=up DTR=up RTS=up CTS=up

279Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

High-level Data Link Control

Left running head: Chapter name (automatic)

280

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Frame Relay

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 14 FRAME RELAY

This chapter documents the Frame-Relay (FR) Command Line Interface (CLI) commands. These commands are used to configure FR encapsulation on a Serial interface (V.35/X.21/RS-232) or a T1 or an E1 interface. You are required to refer to the “Universal Serial Port (USP)” and “T1E1 Interface” chapters before proceeding to this.

This chapter includes tables of parameters, default values, and configuration examples for FR configurations as quick-start and reference information. In this chapter, all the commands are described in alphabetical order. For more detailed information about using and configuring the frame-relay Protocol, refer to the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

Note: FR encapsulation is supported on OmniAccess 5510-SR USG and OmniAccess 5510-TE USG. OmniAccess 5510-AA/AB USG do not support FR encapsuation.

The FR configuration commands in this chapter are shown for a serial (V.35/X.21/RS-232) interface as an example. The steps are similar for configuration of FR encapsulation on a T1 or an E1 interface.

281Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Frame Relay

Left running head: Chapter name (automatic)

DEBUG FRAME-RELAYdebug frame-relay {fse|keepalive|mlfr} [{output {all|log|vty {<1-256>|all|console|this}}]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command shows the debug FR Full Status/Keepalive messages.

PARAMETERS

DEFAULT VALUE

By default, debug is disabled.

EXAMPLEALU(config)# debug frame-relay fse

DEBUG FRAME-RELAY ALLdebug frame-relay all [detail-level <1-9>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command shows all the debug messages pertaining to FR functionality.

PARAMETERS

DEFAULT VALUE

By default, debug is disabled.

EXAMPLEALU(config)# debug frame-relay all

Parameter Description

output all Output to all possible locations.

output log Output to system log.

output vty Output to VTY.

Parameter Description

all Displays all the debug messages pertaining to FR functionality.

detail-level Displays detail level (default is 1).

1-9 Enable with specific detail level.

282

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

encapsulation frame-relay

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

ENCAPSULATION FRAME-RELAYencapsulation frame-relay

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to set Frame Relay encapsulation on an interface.

PARAMETERS

None.

DEFAULT VALUE

HDLC is the default encapsulation on an interface.

EXAMPLEALU(config-if Serial0)# encapsulation frame-relay

FRAME RELAY INTERFACE-DLCIframe-relay interface-dlci <16-1007>

DESCRIPTION

This command is entered in the Interface Configuration Mode/Sub Interface Configuration Mode. This command is used to configure a DLCI on an interface/sub-interface.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLE

The following example sets the DLCI value to 100:ALU(config-if Serial0)# frame-relay interface-dlci 100

Parameter Description

16-1007 The DLCI value.

283Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Frame Relay

Left running head: Chapter name (automatic)

FRAME-RELAY KEEPALIVEframe-relay keepalive <0-32767>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to configure the LMI Keepalive interval. The LMI keepalive value should typically be equal to the corresponding interval at the switch.

PARAMETERS

DEFAULT VALUE

The default LMI keepalive value is 10.

EXAMPLE

The following example sets the LMI keepalive interval to 12.ALU(config-if Serial0)# frame-relay keepalive 12

FRAME-RELAY LMI-TYPE frame-relay lmi-type {ansi|q933a}

DESCRIPTION

This command sets the LMI type to either ANSI or Q933A.

PARAMETERS

DEFAULT VALUE

The default LMI type is auto-sense.

LMI Autosense is activated by default as the system acts as a DTE. The LMI autosense will be activated when the physical interface is up and LMI type is not configured on that interface.

EXAMPLE

The following example sets the LMI to ansi standard.ALU(config-if Serial0)# frame-relay lmi-type ansi

Parameter Description

0-32767 LMI keep alive interval in the range 0 to 32767.

Parameter Description

ansi American National Standards Institute T1.617 Annex D.

q933a ITU-T Q.933 Annex A.

284

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

frame-relay lmi-n391dte

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

FRAME-RELAY LMI-N391DTE frame-relay lmi-n391dte <1-255>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to set the full status polling interval on a DTE interface.

PARAMETERS

DEFAULT VALUE

The default polling interval is 6.

EXAMPLE

The following example sets the polling interval to 8.ALU(config-if Serial0)# frame-relay lmi-n391dte 8

FRAME-RELAY LMI-N392DTE frame-relay lmi-n392dte <1-10>

DESCRIPTION

This command is entered in the Interface Configuration Mode. It sets the DTE error threshold.

PARAMETERS

DEFAULT VALUE

The default value is 3.

EXAMPLE

The following example sets the DTE error threshold to 6.ALU(config-if Serial0)# frame-relay lmi-n392dte 6

Parameter Description

1-255 Interval in events when a full status request is sent out.

Parameter Description

1-10 DTE error threshold value.

285Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Frame Relay

Left running head: Chapter name (automatic)

FRAME-RELAY LMI-N393DTEframe-relay lmi-n393dte <1-10>

DESCRIPTION

This command is entered in the Interface Configuration Mode. It sets the DTE monitored events count.

PARAMETERS

DEFAULT VALUE

The default value is 4.

EXAMPLE

The following example sets the DTE monitored events count to 7.ALU(config-if Serial0)# frame-relay lmi-n393dte 7

NO DEBUG FRAME-RELAYno debug frame-relay {all|fse|keepalive|mlfr}

This command is entered in the Super User Mode or Configuration Mode. The “no” command disables the debug functionality. By default, debug is disabled.

NO ENCAPSULATION FRAME-RELAYno encapsulation frame-relay

This command is entered in the Interface Configuration Mode. The “no” command resets the encapsulation on an interface to its default. The default encapsulation is HDLC.

NO FRAME-RELAY INTERFACE-DLCIno frame-relay interface-dlci <16-1007>

This command is entered in the Interface Configuration Mode. The “no” command deletes the configured DLCI from the interface.

Parameter Description

1-10 The range for DTE monitor event count.

286

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

no frame-relay keepalive

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NO FRAME-RELAY KEEPALIVEno frame-relay keepalive

This command is entered in the Interface Configuration Mode. The “no” command resets the FR LMI keep alive interval to ‘0’.

NO FRAME-RELAY LMI-TYPEno frame-relay lmi-type

This command is entered in the Interface Configuration Mode. The “no” command resets the LMI type to its default value. The default LMI type is auto-sense.

NO FRAME-RELAY LMI-N391DTEno frame-relay lmi-n391dte

This command is entered in the Interface Configuration Mode. The “no” command sets the polling interval to its default value, which is 6.

NO FRAME-RELAY LMI-N392DTEno frame-relay lmi-n392dte

This command is entered in the Interface Configuration Mode. The “no” command sets the lmi-n392dte to its default value, which is 3.

NO FRAME-RELAY LMI-N393DTEno frame-relay lmi-n393dte

This command is entered in the Interface Configuration Mode. The “no” command sets the lmi-n393dte to its default, which is 4.

287Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Frame Relay

Left running head: Chapter name (automatic)

SHOW FRAME-RELAY LMI show frame-relay lmi [interface Serial <port>]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Interface Configuration Mode. Displays the frame-relay LMI configuration details and parameters for all the interfaces or a specific interface.

PARAMETERS

EXAMPLE

The following example displays the FR LMI configuration details and parameters for all the interfaces:

ALU(config)# show frame-relay lmi

LMI Statistics for interface Serial0 (Frame Relay DTE) LMI TYPE = AUTOSENSEInvalid Unnumbered info 0 Invalid Prot Disc 0Invalid dummy Call Ref 0 Invalid Msg Type 0Invalid Status Message 0 Invalid Lock Shift 0Invalid Information ID 0 Invalid Report IE Len 0Invalid Report Request 0 Invalid Keep IE Len 0Num Status Enq. Sent 0 Num Status msgs Rcvd 0Num Update Status Rcvd 0 Num Status Timeouts 0

The following example displays the FR LMI configuration details and parameters for a specific interface:

ALU(config)# show frame-relay lmi interface Serial 0 LMI Statistics for interface Serial0 (Frame Relay DTE) LMI TYPE = AUTOSENSEInvalid Unnumbered info 0 Invalid Prot Disc 0Invalid dummy Call Ref 0 Invalid Msg Type 0Invalid Status Message 0 Invalid Lock Shift 0Invalid Information ID 0 Invalid Report IE Len 0Invalid Report Request 0 Invalid Keep IE Len 0Num Status Enq. Sent 0 Num Status msgs Rcvd 0Num Update Status Rcvd 0 Num Status Timeouts 0

Parameter Description

port Port and channel group number of the serial interface.

288

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show frame-relay pvc

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW FRAME-RELAY PVC show frame-relay pvc [{<16-1022>|interface Serial <port>}]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Interface Configuration Mode. This command displays the status of the Frame Relay Permanent Virtual Circuit (PVC).

PARAMETERS

EXAMPLEALU(config)# show frame-relay pvc interface Serial 0

PVC Statistics for interface Serial0 (Frame Relay DTE)DLCI = 200, DLCI USAGE = LOCAL, PVC STATUS = ACTIVE, INTERFACE = Serial0 input pkts 0 output pkts 0 in bytes 0 out bytes 0 in pkts dropped 0 out pkts dropped 0

in FECN pkts 0 out FECN pkts 0 in BECN pkts 0 out BECN pkts 0 in DE pkts 0 out DE pkts 0 out bcast pkts 0 out bcast bytes 0

Parameter Description

16-1007 DLCI value.

port Port number of the interface.

289Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Frame Relay

Left running head: Chapter name (automatic)

290

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Point to Point Protocol

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 15 POINT TO POINT PROTOCOL

This chapter documents the Command Line Interface (CLI) commands for the Point-to-Point Protocol (PPP). These commands are used to configure PPP encapsulation on a Serial interface (V.35/X.21/RS-232) or a T1 or an E1 interface. You are required to refer to the “Universal Serial Port (USP)” and “T1E1 Interface” chapters before proceeding to this.

This chapter includes table of parameters, default values, and configuration examples for PPP configurations as quick-start and reference information. In this chapter, all the commands are described in alphabetical order. For more detailed information about using and configuring the Point-to-Point Protocol, refer to the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

Note: PPP encapsulation is supported on OmniAccess 5510-SR USG and OmniAccess 5510-TE USG. OmniAccess 5510-AA/AB USG do not support PPP encapsuation.

The PPP configuration commands in this chapter are shown for a serial (V.35/X.21/RS-232) interface as an example. The steps are similar for configuration of PPP on a T1 or an E1 interface.

291Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Point to Point Protocol

Left running head: Chapter name (automatic)

DEBUG PPP ALLdebug ppp all [detail-level <1-9>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command shows all the debug messages pertaining to the PPP functionality.

PARAMETERS

DEFAULT VALUE

By default, debug is disabled.

EXAMPLEALU(config)# debug ppp all

Parameter Description

all Displays all the debug messages pertaining to PPP functionality.

detail-level Displays detail level (default is 1).

1-9 Enable with specific detail level.

292

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

debug ppp echo

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

DEBUG PPP ECHOdebug ppp echo [output {all|log|vty}]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command shows the LCP echo requests and reply messages.

PARAMETERS

DEFAULT VALUE

By default, debug is disabled.

EXAMPLEALU(config)# debug ppp echo

Parameter Description

echo Displays the LCP echo requests and reply messages only.

output all Output to all possible locations.

output log Output to system log.

output vty Output to VTY.

293Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Point to Point Protocol

Left running head: Chapter name (automatic)

ENCAPSULATION PPPencapsulation ppp

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command sets PPP encapsulation on an interface.

PARAMETERS

None.

DEFAULT VALUE

The default encapsulation on a serial interface is HDLC.

EXAMPLEALU(config)# interface Serial 0ALU(config-if Serial0)# encapsulation ppp

NO DEBUG PPP no debug ppp {echo|all}

This command is entered in the Super User Mode or Configuration Mode. The “no” command disables the debug functionality. By default, debug is disabled.

NO ENCAPSULATION PPPno encapsulation ppp

This command is entered in the Interface Configuration Mode. This command sets the encapsulation to its default, HDLC.

NO PPP AUTHENTICATIONno ppp authentication

This command is entered in the Interface Configuration Mode. The “no” command removes the authentication protocol for authenticating the peer.

NO PPP AUTHENTICATION CLIENT-PASSWORDno ppp authentication client-password

This command is entered in the Interface Configuration Mode. The “no” command deletes the configured authentication password on the client side.

NO PPP AUTHENTICATION CLIENT-USERNAMEno ppp authentication client-username

This command is entered in the Interface Configuration Mode. The “no” command deletes the configured authentication user name on the client side.

294

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

no ppp authentication password

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NO PPP AUTHENTICATION PASSWORDno ppp authentication password

This command is entered in the Interface Configuration Mode. The “no” command deletes the configured PPP authentication password on the server side.

NO PPP AUTHENTICATION USERNAMEno ppp authentication username

This command is entered in the Interface Configuration Mode. The “no” command deletes the configured PPP authentication user name on the server side.

NO PPP IPCP ADDRESS ACCEPT-LOCALno ppp ipcp address accept-local

This command is entered in the Interface Configuration Mode. The “no” command sets the flag to reject the local IP address given to it by its peer during IPCP. This is the default behavior.

NO PPP IPCP ADDRESS ACCEPT-PEERno ppp ipcp address accept-peer

This command is entered in the Interface Configuration Mode. The “no” command sets the flag to reject the peer’s IP address during IPCP.

Note: On a PPPoE enabled interface, ‘no ppp ipcp address accept-peer’ should not be configured as the interface is always in PPPoE client mode.

NO PPP IPCP ADDRESS POOL LOCALno ppp ipcp address pool local

This command is entered in the Interface Configuration Mode. The “no” command removes the IP address pool for IPCP.

295Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Point to Point Protocol

Left running head: Chapter name (automatic)

NO PPP LCP ECHO-INTERVALno ppp lcp echo-interval

This command is entered in the Interface Configuration Mode. The “no” command sets the echo-interval to its default value. The default value is 10 seconds.

NO PPP LCP MAX-ECHOno ppp lcp max-echo

This command is entered in the Interface Configuration Mode. The “no” command sets the maximum number of unanswered LCP echo requests to is default, i.e., 5.

NO PPP TIMEOUT MAX-CONFIGUREno ppp timeout max-configure

This command is entered in the Interface Configuration Mode. This command sets the max-configure value to its default, i.e., 10.

NO PPP TIMEOUT MAX-FAILUREno ppp timeout max-failure

This command is entered in the Interface Configuration Mode. The “no” command sets the max-failure value to its default, 5.

NO PPP TIMEOUT MAX-TERMINATEno ppp timeout max-terminate

This command is entered in the Interface Configuration Mode. The “no” command sets the max-terminate value to its default, i.e., 2.

296

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

no ppp timeout restart-interval

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NO PPP TIMEOUT RESTART-INTERVALno ppp timeout restart-interval

This command is entered in the Interface Configuration Mode. The “no” command sets the LCP/NCP restart-interval to its default, i.e., 30 seconds.

NO PPP TIMEOUT RESTART-TIMERno ppp timeout restart-timer

This command is entered in the Interface Configuration Mode. The “no” command resets the restart-timer to its default, i.e., 3 seconds.

PPP AUTHENTICATION ppp authentication {pap|chap|eap}

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command enables you to configure an authentication protocol for authenticating the peer.

PARAMETERS

EXAMPLEALU(config-if Serial0)# ppp authentication pap

Parameter Description

pap Password Authentication Protocol.

chap Challenge Authentication Protocol.

eap Extensible Authentication Protocol.

297Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Point to Point Protocol

Left running head: Chapter name (automatic)

PPP AUTHENTICATION CLIENT-PASSWORDppp authentication client-password <password>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command enables you to set the password for PPP authentication on the client side.

PARAMETERS

EXAMPLE ALU(config-if Serial0)# ppp authentication client-password pass1

PPP AUTHENTICATION CLIENT-USERNAMEppp authentication client-username <username>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to set user name for PPP authentication on the client side.

PARAMETERS

EXAMPLEALU(config-if Serial0)# ppp authentication client-username client1

Parameter Description

password Denotes the password for PPP authentication.

Parameter Description

username Denotes the user name for PPP authentication.

298

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ppp authentication password

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

PPP AUTHENTICATION PASSWORD ppp authentication password <password>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command enables you to set a password for PPP authentication on the server side.

PARAMETERS

EXAMPLEALU(config-if Serial0)# ppp authentication password pass1

PPP AUTHENTICATION USERNAME ppp authentication username <username>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to set a user name for PPP authentication on the server side.

PARAMETERS

EXAMPLE ALU(config-if Serial0)# ppp authentication username alcatel-lucent

Parameter Description

password Denotes the password for PPP authentication.

Parameter Description

username Denotes the user name for PPP authentication.

299Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Point to Point Protocol

Left running head: Chapter name (automatic)

PPP IPCP ADDRESS ACCEPT-LOCAL ppp ipcp address accept-local

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command sets a flag to accept a local IP address given to it by the peer during IPCP.

PARAMETERS

None.

DEFAULT VALUE

By default, the flag is set to reject the local IP address from the peer during IPCP.

EXAMPLEALU(config-if Serial0)# ppp ipcp address accept-local

PPP IPCP ADDRESS ACCEPT-PEERppp ipcp address accept-peer

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command sets the flag to accept the peer’s IP address during IPCP. This is the default behaviour.

PARAMETERS

None.

DEFAULT VALUE

By default, the flag is set to accept the peer’s IP address during IPCP.

EXAMPLEALU(config-if Serial0)# ppp ipcp address accept-peer

300

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ppp ipcp address pool local

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

PPP IPCP ADDRESS POOL LOCALppp ipcp address pool local <ip-address>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command enables you to configure an IP address pool for IPCP to give an IP address to its peer.

PARAMETERS

DEFAULT VALUE

By default, no IP address pool is configured for IPCP.

EXAMPLEALU(config-if Serial0)# ppp ipcp address pool local 10.10.10.10

Note: On a PPPoE enabled interface, ‘ppp ipcp address pool local <ip-address>’ should not be configured as the interface is always in PPPoE client mode.

PPP IPCP NEGOTIATEppp ipcp negotiate

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to initiate the IPCP negotiation on the interface.

PARAMETERS

None.

DEFAULT VALUE

By default, OmniAccess 5510 USG system responds to IPCP negotiation initiated by the peer. Auto-negotiation happens when the IP address is changed on the interface.

EXAMPLEALU(config-if Serial0)# ppp ipcp negotiate

Parameter Description

ip-address IP address to be given to the peer.

301Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Point to Point Protocol

Left running head: Chapter name (automatic)

PPP LCP ECHO-INTERVAL ppp lcp echo-interval <0-255>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to set the interval between the LCP echo requests sent. “0” implies that no echo requests are sent.

PARAMETERS

DEFAULT VALUE

The default value is 10 seconds.

EXAMPLE ALU(config-if Serial0)# ppp lcp echo-interval 200

PPP LCP NEGOTIATEppp lcp negotiate

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to initiate the LCP negotiation on the interface.

Note: LCP negotiation is automatically started when the encapsulation is set to PPP or when the link is administratively brought up on a PPP interface, or when the MTU is changed on the interface.

On a PPPoE interface, LCP negotiation is automatically started when PPPoE discovery phase is completed successfully or when the MTU is changed on the interface.

PARAMETERS

None.

EXAMPLEALU(config-if Serial0)# ppp lcp negotiate

Parameter Description

0-255 Denotes the interval between echo requests.

302

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ppp lcp max-echo

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

PPP LCP MAX-ECHO ppp lcp max-echo <0-30>

DESCRIPTION

The command is used in the Interface Configuration Mode. This command denotes the maximum number of unanswered LCP echo requests sent before LCP decides that the peer is down. The value “0” implies that the link will not be brought down on the basis of unanswered echo requests.

PARAMETERS

DEFAULT VALUE

The “no” command sets the maximum number of unanswered LCP echo requests to is default, i.e., 5.

EXAMPLEALU(config-if Serial0)# ppp lcp max-echo 20

PPP TIMEOUT RESTART-INTERVALppp timeout restart-interval <0-255>

DESCRIPTION

The command is used in the Interface Configuration Mode. This command defines the interval after which the LCP/NCP negotiation will be reattempted after it is terminated.

PARAMETERS

DEFAULT VALUE

The default LCP/NCP restart-interval is 30 seconds.

EXAMPLEALU(config-if Serial0)# ppp timeout restart-interval 10

Parameter Description

0-30 Denotes the maximum number of unanswered requests.

Parameter Description

0-255 Specifies the interval after which the LCP negotiation will be reattempted after it is terminated.

303Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Point to Point Protocol

Left running head: Chapter name (automatic)

PPP TIMEOUT RESTART-TIMER ppp timeout restart-timer <1-30>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command sets a timer for re-transmission of LCP and NCP packets.

PARAMETERS

DEFAULT VALUE

The default restart-timer value is “3 seconds”.

EXAMPLEALU(config-if Serial0)# ppp timeout restart-timer 13

PPP TIMEOUT MAX-CONFIGUREppp timeout max-configure <1-30>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command sets the maximum number of configure request packets (LCP or NCP) sent without receiving a valid Ack/NaK/Reject, before assuming that the peer is unable to respond.

PARAMETERS

DEFAULT VALUE

The default max-configure value is “10”.

EXAMPLEALU(config-if Serial0)# ppp timeout max-configure 15

Parameter Description

1-30 The timer for retransmission (in seconds) of LCP and NCP packets. The range varies from 1-30.

Parameter Description

1-30 Maximum number of configure request packets (LCP or NCP) to be sent without receiving a valid Ack/NaK/Reject, before assuming that the peer is unable to respond.

304

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ppp timeout max-failure

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

PPP TIMEOUT MAX-FAILURE ppp timeout max-failure <1-30>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command sets the maximum number of configure NaK packets (LCP or NCP) sent without sending a Configure Ack before assuming that configuration is not converging.

PARAMETERS

DEFAULT VALUE

The default max-failure value is “5”.

EXAMPLEALU(config-if Serial0)#ppp timeout max-failure 10

PPP TIMEOUT MAX-TERMINATE ppp timeout max-terminate <1-30>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command sets the maximum number of terminate request packets (LCP or NCP) sent without receiving a Terminate Ack, before assuming that the peer is unable to respond.

PARAMETERS

DEFAULT VALUE

The default max-terminate value is “2”.

EXAMPLEALU(config-if Serial0)# ppp timeout max-terminate 10

Parameter Description

1-30 Maximum number of configure NaK packets (LCP or NCP) to be sent without sending a Configure Ack, before assuming that configuration is not converging.

Parameter Description

1-30 The maximum number of terminate request packets to be sent, before assuming that the peer is unable to respond.

305Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Point to Point Protocol

Left running head: Chapter name (automatic)

SHOW INTERFACESshow interfaces <name>

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Interface Configuration Mode. Displays detailed statistics and other information for a specified interface.

PARAMETERS

EXAMPLE

The following example shows the states for LCP, CHAP Client, EAP Server, and IPCP in the "show interfaces" output.

ALU(config-if Serial0)# show interfaces Serial 0

Serial0 is up, line protocol is upInternet address is 100.101.102.103/24MTU 1200 bytes, BW 1544 Kbit, DLY 0 usec,reliability 0/255, txload 0/255, rxload 0/255 loopback not set Encapsulation ppp, Keepalive set (10 sec) LCP: Open CHAP Client: Open EAP Server: Open IPCP: Open

Last input never, output never, output hang neverLast clearing of "show interface" counters neverQueueing strategy: fifoOutput queue: 0/0 (size/max) 0 drops; Input queue: 0/0 (size/max) 0 drops Conversations: 0/0/0/0 (active/max active/max total) Reserved Conversations: 0/0 (allocated/max allocated) Available Bandwidth 1544 kilobits/sec5 minute input rate 0 bits/sec, 0 packets/sec5 minute output rate 0 bits/sec, 0 packets/sec 50 packets input, 0 bytes, 0 no buffer Received 0 broadcasts, 0 runts, 0 giants, 0 throttles 0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort 60 packets output, 0 bytes, 0 underruns 0 output errors, 0 collisions, 0 interface resets 0 output buffer failures, 0 output buffers swapped out 0 carrier transitionsTimeslot(s) Used:1-31, Transmitter delay is 0 flags

Parameter Description

name Name of the interface.

306

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ppp all configuration

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW PPP ALL CONFIGURATIONshow ppp all configuration Serial <port>

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Interface Configuration Mode. This command displays all the PPP configuration information for a specified interface.

PARAMETERS

EXAMPLEALU# show ppp all configuration Serial 0

LCP Max Echoes : 5LCP Echo Interval : 60 (sec)LCP Restart Interval : 30 (sec)

IPCP pool IP address : 50.51.52.54IPCP local IP address from peer: RejectIPCP peer IP address : Reject PPP Restart timer : 3 (sec)PPP Max Terminate : 2PPP Max Configure : 10PPP Max Failure : 5 Authentication protocol : papAuthentication username : user1Authentication password : secret1Authentication client-username : user2Authentication client-password : secret2

Parameter Description

port Port number of the interface.

307Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Point to Point Protocol

Left running head: Chapter name (automatic)

SHOW PPP ALL STATISTICS show ppp all statistics Serial <port>

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Interface Configuration Mode. Displays detailed statistics for PPP for a specified interface.

PARAMETERS

EXAMPLEALU# show ppp all statistics Serial 0

PPP data packets received: 0PPP control packets received: 22Packets dropped: 0

PPP sessions initiated: 1PPP sessions received: 1PPP sessions successful: 2PPP sessions terminated: 1

IN OUT

LCP Configure Requests: 2 2LCP Configure Acks: 2 2LCP Configure Naks: 0 0LCP Configure Rejects: 0 0LCP Terminate Requests: 0 0LCP Terminate Acks: 0 0LCP Code Rejects: 0 0LCP Protocol Rejects: 0 0LCP Echo Requests: 4 4LCP Echo Replies: 4 4LCP Discard Requests: 0 0LCP Invalid Packets: 0 0

IN OUT

IPCP Configure Requests: 4 2IPCP Configure Acks: 2 2IPCP Configure Naks: 0 2IPCP Configure Rejects: 0 0IPCP Terminate Requests: 0 0IPCP Terminate Acks: 0 0IPCP Code Rejects: 0 0IPCP Invalid Packets: 0 0

Parameter Description

port Port number of the interface.

308

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ppp authentication configuration

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IN OUT

PAP Authentication Requests: 2 2PAP Authentication Acks: 2 2PAP Authentication Naks: 0 0PAP Invalid Packets: 0 0

IN OUT

CHAP Challenges: 0 0CHAP Responses: 0 0CHAP Successes: 0 0CHAP Failures: 0 0CHAP Invalid Packets: 0 0 IN OUT

EAP Requests: 0 4EAP Responses: 4 0EAP Successes: 0 2EAP Failures: 0 0EAP Invalid Packets: 0 0

SHOW PPP AUTHENTICATION CONFIGURATION show ppp authentication configuration Serial <port>

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Interface Configuration Mode. Displays the PPP authentication configuration information for a specified interface.

PARAMETERS

EXAMPLEALU# show ppp authentication configuration Serial 0

Authentication protocol: papAuthentication username: user1Authentication password: secret1Authentication client username: Not configuredAuthentication client password: Not configured

Parameter Description

port Port number of the interface.

309Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Point to Point Protocol

Left running head: Chapter name (automatic)

SHOW PPP AUTHENTICATION STATISTICS show ppp authentication statistics Serial <port>

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Interface Configuration Mode. Displays detailed statistics for PPP authentication for a specified interface.

PARAMETERS

EXAMPLE ALU# show ppp authentication statistics Serial 0

IN OUT

PAP Authentication Requests: 2 2PAP Authentication Acks: 2 2PAP Authentication Naks: 0 0PAP Invalid Packets: 0 0

IN OUT

CHAP Challenges: 0 0CHAP Responses: 0 0CHAP Successes: 0 0CHAP Failures: 0 0CHAP Invalid Packets: 0 0

IN OUT

EAP Requests: 0 4EAP Responses: 4 0EAP Successes: 0 2EAP Failures: 0 0EAP Invalid Packets: 0 0

Parameter Description

port Port number of the interface.

310

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ppp ipcp configuration

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW PPP IPCP CONFIGURATION show ppp ipcp configuration Serial <port>

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Interface Configuration Mode. Displays PPP IPCP configuration information for a specified interface.

PARAMETERS

EXAMPLEALU# show ppp ipcp configuration Serial 0

IPCP pool IP address: 50.51.52.54IPCP local IP address from peer: RejectIPCP peer IP address: Reject

SHOW PPP IPCP STATISTICS show ppp ipcp statistics Serial <port>

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Interface Configuration Mode. Displays detailed IPCP statistics for a specified interface.

PARAMETERS

EXAMPLEALU# show ppp ipcp statistics Serial 0

IN OUT

IPCP Configure Requests: 6 13IPCP Configure Acks: 6 6IPCP Configure Naks: 5 0IPCP Configure Rejects: 2 0IPCP Terminate Requests: 0 2IPCP Terminate Acks: 2 0IPCP Code Rejects: 0 0IPCP Invalid Packets: 0 0

Parameter Description

port Port number of the interface.

Parameter Description

port Port number of the interface.

311Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Point to Point Protocol

Left running head: Chapter name (automatic)

SHOW PPP LCP CONFIGURATION show ppp lcp configuration Serial <port>

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Interface Configuration Mode. Displays the PPP LCP configuration information for a specified interface.

PARAMETERS

EXAMPLE ALU# show ppp lcp configuration Serial 0

LCP Max Echoes : 5LCP Echo Interval : 60 (sec)LCP Restart Interval : 30 (sec)

Parameter Description

port Port number of the interface.

312

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ppp lcp statistics

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW PPP LCP STATISTICS show ppp lcp statistics Serial <port>

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Interface Configuration Mode. Displays detailed LCP statistics for a specified interface.

PARAMETERS

EXAMPLEALU# show ppp lcp statistics Serial 0

IN OUT

LCP Configure Requests: 2 2LCP Configure Acks: 2 2LCP Configure Naks: 0 0LCP Configure Rejects: 0 0LCP Terminate Requests: 0 0LCP Terminate Acks: 0 0LCP Code Rejects: 0 0LCP Protocol Rejects: 0 0LCP Echo Requests: 2 2LCP Echo Replies: 2 2LCP Discard Requests: 0 0LCP Invalid Packets: 0 0

Parameter Description

port Port number of the interface.

313Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Point to Point Protocol

Left running head: Chapter name (automatic)

SHOW PPP TIMEOUT CONFIGURATION show ppp timeout configuration Serial <port>

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Interface Configuration Mode. Displays the timer and counter configuration information for a specified interface.

PARAMETERS

EXAMPLEALU# show ppp timeout configuration Serial 0

PPP Restart timer: 3 (sec)PPP Max Terminate: 2PPP Max Configure: 10PPP Max Failure : 5

SHOW PPP SESSION STATISTICS show ppp session statistics Serial <port>

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Interface Configuration Mode. Displays detailed statistics for PPP sessions for a specified interface.

PARAMETERS

EXAMPLEALU# show ppp session statistics Serial 0

PPP data packets received: 0PPP control packets received: 20Packets dropped: 0

PPP sessions initiated: 1PPP sessions received: 1PPP sessions successful: 2PPP sessions terminated: 1

Parameter Description

port Port number of the interface.

Parameter Description

port Port number of the interface.

314

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Point-to-Point Protocol over Ethernet (PPPoE)

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 16 POINT-TO-POINT PROTOCOL OVER ETHERNET (PPPOE)

This chapter documents the Command Line Interface (CLI) commands for the Point-to-Point Protocol over Ethernet (PPPoE). These commands are used to configure PPPoE encapsulation on an ADSL ATM sub-interface or a Fast Ethernet interface. You are required to refer to “ADSL (Asymmetric Digital Subscriber Line)” or “Fast Ethernet Interface” chapter before proceeding with this.

This chapter includes table of parameters, default values, and configuration examples for PPPoE configurations as quick-start and reference information. All the commands are described in alphabetical order. For more detailed information about using and configuring the PPPoE, refer OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

Note: PPPoE encapsulation is supported on both ATM sub-interface as well as Fast Ethernet interface on OmniAccess 5510-AA/AB USG.

OmniAccess 5510-SR USG and and OmniAccess 5510-TE USG supports PPPoE encapsuation on Fast Ethernet interface.

315Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Point-to-Point Protocol over Ethernet (PPPoE)

Left running head: Chapter name (automatic)

ENCAPSULATION PPPOEencapsulation pppoe

DESCRIPTION

This command is entered in the Sub-interface Configuration Mode. This command sets PPPoE encapsulation on the ATM sub-interface. The interface comes up in the ‘PPPoE client’ mode.

PARAMETERS

None.

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510-AA/AB USG

EXAMPLEALU(config)# interface atm 0.1ALU(config-subif atm0.1)# encapsulation pppoe

RELEASE HISTORY

Release 3.0: command was introduced in ATM sub-interface configuration mode.

316

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

no encapsulation pppoe

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NO ENCAPSULATION PPPOEno encapsulation pppoe

This command is entered in the Sub-interface Configuration Mode. This command removes the configured encapsulation on the interface.

NO PPPOE AC-NAME no pppoe ac-name

This command is entered in the Sub-interface Configuration Mode. The “no” command removes the access concentrator name configured.

NO PPPOE MAX-RETRYno pppoe max-retry

This command is entered in the Sub-interface Configuration Mode. The “no” command sets the max-retry value to its default, which is infinite.

NO PPPOE RETRY-TIMERno pppoe retry-timer

This command is entered in the Sub-interface Configuration Mode. The “no” command resets the retry-timer to its default, 10 seconds.

NO PPPOE SERVICE-NAME no pppoe service-name

This command is entered in the Sub-interface Configuration Mode. This command removes the service name configured.

317Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Point-to-Point Protocol over Ethernet (PPPoE)

Left running head: Chapter name (automatic)

PPPOE AC-NAMEpppoe ac-name <access-concentrator-name>

DESCRIPTION

This command is entered in the Sub-interface Configuration Mode. This command is used to configure the access concentrator name of the PPPoE server.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510-AA/AB USG

EXAMPLEALU(config-subif atm0.1)# pppoe ac-name ISP123

Note: The access concentrator name configured on OmniAccess 5510 USG should match the concentrator name of the server.

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

access-concentrator-name Access concentrator name of the PPPoE server.

318

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

pppoe max-retry

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

PPPOE MAX-RETRYpppoe max-retry <1-255>

DESCRIPTION

This command is entered in the Sub-interface Configuration Mode. This command sets an upper limit on the number of unanswered PADIs/PADRs sent by the PPPoE client before the attempted session is given up. When the session is given up, the retry-timer will go back to the configured value.

PARAMETERS

DEFAULT VALUE

The default max-retry value is ‘infinite’.

PLATFORMS SUPPORTED

OmniAccess 5510-AA/AB USG

EXAMPLEALU(config-subif atm0.1)# pppoe max-retry 10

RELEASE HISTORY

Release 3.0: command was introduced in ATM sub-interface configuration mode.

Parameter Description

1-255 Denotes the number of unanswered PADIs/PADRs sent by the PPPoE client before the attempted session is reset.

319Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Point-to-Point Protocol over Ethernet (PPPoE)

Left running head: Chapter name (automatic)

PPPOE NEGOTIATEpppoe negotiate

DESCRIPTION

This command is entered in the Sub-interface Configuration Mode. This command is used to initiate the PPPoE negotiation on the interface.This command helps to terminate the existing PPPoE session, if any, and re-negotiate the session.

Note: When the interface is administratively brought up, the link comes up within 20 to 40 seconds. PPPoE negotiation is automatically started by sending a PADI provided “encapsulation pppoe” is configured.

PARAMETERS

None.

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510-AA/AB USG

EXAMPLEALU(config-subif atm0.1)# pppoe negotiate

RELEASE HISTORY

Release 3.0: command was introduced in ATM sub-interface configuration mode.

320

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

pppoe retry-timer

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

PPPOE RETRY-TIMERpppoe retry-timer <0-300>

DESCRIPTION

This command is entered in the Sub-interface Configuration Mode. This command sets the initial timer for re-transmission of PPPoE PADI (or PADR) packets in the absence of a PADO (or PADS) from a server.

Wait period doubles between successive PADIs. However, after three unanswered PADIs, wait period is reset to configured retry-timer.

If the retry-timer value is set to ‘0’, PPPoE client sends only one PADI/PADR. With max-retry value ‘infinite’ (default), PPPoE client keeps sending PADIs till a PADO is received.

PARAMETERS

DEFAULT VALUE

The default retry-timer value is 10 seconds.

PLATFORMS SUPPORTED

OmniAccess 5510-AA/AB USG

EXAMPLEALU(config-subif atm0.1)# pppoe retry-timer 15

RELEASE HISTORY

Release 3.0: command was introduced in ATM sub-interface configuration mode.

Parameter Description

0-300 Denotes the initial timer for re-transmission of PPPoE PADI (or PADR) packets.

321Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Point-to-Point Protocol over Ethernet (PPPoE)

Left running head: Chapter name (automatic)

PPPOE SERVICE-NAMEpppoe service-name <name>

DESCRIPTION

This command is entered in the Sub-interface Configuration Mode. This command is used to configure PPPoE service name, like the name of the Internet service provider (ISP).

Note: The PPPoE service name configured on OmniAccess 5510 USG should match the service name configured on the server.

If “service-name” is not configured, then the PPPoE client accepts any service offered by the PPPoE server.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510-AA/AB USG

EXAMPLEALU(config-subif atm0.1)# pppoe service-name ISP1

RELEASE HISTORY

Release 3.0: command was introduced in ATM sub-interface configuration mode.

Parameter Description

name Service name. Maximum length of the service name is 50 characters.

322

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show pppoe configuration atm

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW PPPOE CONFIGURATION ATMshow pppoe configuration atm <port>.<subinterface-id>

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. Displays the PPPoE configuration information on the ATM interface.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510-AA/AB USG

EXAMPLEALU(config)# show pppoe configuration atm 0.1

pppoe max-retry: 0 pppoe retry-timer: 10(s) pppoe ac-name: cisco-qos pppoe service-name: s1

RELEASE HISTORY

Release 3.0: command was introduced in ATM sub-interface configuration mode.

Parameter Description

<port>.<subinterface-id> Port number of the interface and sub interface ID.

323Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Point-to-Point Protocol over Ethernet (PPPoE)

Left running head: Chapter name (automatic)

SHOW PPPOE STATISTICS ATMshow pppoe statistics atm <port>.<subinterface-id>

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. Displays the PPPoE statistics information on the ATM sub-interface.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510-AA/AB USG

EXAMPLEALU(config)# show pppoe statistics atm 0.1

PADI sent: 2 PADO received: 1 PADO dropped: 0 PADR sent: 1 PADS received: 1 PADT sent: 0 PADT received: 0

RELEASE HISTORY

Release 3.0: command was introduced in ATM sub-interface configuration mode.

Parameter Description

<port>.<subinterface-id> Port number of the interface and sub interface ID.

324

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Multilink Point to Point Protocol

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 17 MULTILINK POINT TO POINT PROTOCOL

This chapter documents the Command Line Interface (CLI) commands for the Multilink Point-to-Point Protocol (MLPPP). These commands are used to configure Multilink PPP encapsulation on a Serial Interface (V.35/X.21/RS-232) or a T1 or an E1 interface. You are required to refer to the “Universal Serial Port (USP)” and “T1E1 Interface” chapters before proceeding to this.

This chapter includes table of parameters, default values, and configuration examples for MLPPP configurations as quick-start and reference information. In this chapter, all the commands are described in alphabetical order. For more detailed information about using and configuring the Multilink Point-to-Point Protocol, refer to the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

Note: MLPPP encapsulation is supported on OmniAccess 5510-SR USG and OmniAccess 5510-TE USG. OmniAccess 5510-AA/AB USG do not support MLPPP encapsuation.

The MLPPP configuration commands in this chapter are shown for a serial (V.35/X.21/RS-232) interface as an example. The steps are similar for configuration of MLPPP on a T1 or an E1 interface.

325Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Multilink Point to Point Protocol

Left running head: Chapter name (automatic)

INTERFACE MLPPP interface mlppp <1-256>

DESCRIPTION

This command is entered in the Configuration Mode. This command creates a MLPPP bundle interface that is identified by the bundle ID.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# interface mlppp 100ALU(config-if mlppp100)#

ENCAPSULATION MLPPP encapsulation mlppp <1-256>

DESCRIPTION

This command is entered in the Interface Configuration Mode.

This command sets MLPPP encapsulation on an interface. The interface becomes a member link of the bundle interface identified by the bundle ID.

PARAMETERS

DEFAULT VALUE

The default encapsulation on a serial interface is HDLC.

EXAMPLEALU(config)#interface Serial 0ALU(config-if Serial0)# encapsulation mlppp 100

Parameter Description

1-256 Bundle Identification. The range of the bundle ID is between 1 and 256.

Parameter Description

1-256 Bundle Identification. The range of the bundle ID is between 1 and 256.

326

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

mlppp load-threshold

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

MLPPP LOAD-THRESHOLD mlppp load-threshold {high|low} {outbound|inbound} <1-255>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command sets the load-threshold on an MLPPP bundle.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-if mlppp100)# mlppp load-threshold high outbound 100

NO ENCAPSULATION MLPPPno encapsulation mlppp

This command is entered in the Interface Configuration Mode. This command sets the encapsulation on a serial interface to its default, i.e., HDLC.

NO MLPPP LOAD-THRESHOLDno mlppp load-threshold {high|low} {outbound|inbound}

This command is entered in the Interface Configuration Mode. This command removes the load threshold on the MLPPP bundle.

Parameter Description

high High threshold value.

low Low threshold value.

outbound Outbound traffic.

inbound Inbound traffic.

1-255 Load threshold value in the range 1-255.

327Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Multilink Point to Point Protocol

Left running head: Chapter name (automatic)

SHOW INTERFACES MLPPP show interfaces mlppp <1-256>

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the configuration of the MLPPP bundle interface specified.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# show interfaces mlppp 10

mlppp10 is up, line protocol is up Internet address is 1.11.1.1/24 MTU 1494 bytes, BW 128 Kbit, DLY 0 usec, reliability 255/255, txload 237/255, rxload 0/255 Encapsulation mlppp, loopback not set IPCP: Initial Last input never, output never, output hang never Last clearing of "show interface" counters never 0 packets input (0 Control packets, 0 Data packets), 0 bytes 0 packets output (0 Control packets, 0 Data packets), 0 bytes 0 packets dropped, 0 giants received Fragmentation: Fragment Delay 0 ms 0 fragmented, 0 couldn't fragment 0 fragments created, 0x0 sent sequence Reassembly: Slippage MRU 32 0 fragments in reassembly list 0 lost fragments, 0 reordered 0 discarded fragments, 0 reassembled 0 lost received, 0 couldn't reassemble 0 fragments received, 0x0 received sequence.

Parameter Description

1-256 Bundle Identification. This varies from 1-256.

328

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show mlppp

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW MLPPPshow mlppp <1-256>

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the PPP status on the member links of the specified MLPPP bundle interface.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# show mlppp 10

MLPPP bundle 10 link state information: IPCP: Initial MEMBER LINKS LCP AUTH CLIENT AUTH SERVER Serial0 Initial ----- -----

Parameter Description

1-256 Bundle Identification. This varies from 1-256.

329Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Multilink Point to Point Protocol

Left running head: Chapter name (automatic)

330

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Ethernet OAM (Operations, Administration, and Maintenance)

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 18 ETHERNET OAM (OPERATIONS, ADMINISTRATION, AND MAINTENANCE)

This chapter documents the Command Line Interface (CLI) commands for Ethernet OAM (Operations, Administration, and Maintenance feature on OmniAccess 5510 USG.

This chapter includes tables of parameters, default values, and configuration examples for configuring OAM on OmniAccess 5510 USG as quick-start and reference information. In this chapter, all commands are described in alphabetical order. For more detailed information on using and configuring BCP refer to the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

331Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Ethernet OAM (Operations, Administration, and Maintenance)

Left running head: Chapter name (automatic)

CCMccm {disable|enable}

DESCRIPTION

This is entered in the OAM Domain Association MEP Configuration Mode. This command is used to enable/disable CCM messages on a MEP (Maintenance Association End Point).

PARAMETERS

DEFAULT VALUE

By default, the CCM will be disabled.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-oam-domain-assoc-mep)# ccm enable

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

disable|enable Enable/disable CCM messages on a MEP.

332

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ccm-interval

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CCM-INTERVALccm-interval {10m|10s|1m|1s}

DESCRIPTION

This is entered in the OAM Domain Association Configuration Mode. This command is used to configure the time interval between two CCMs for a maintenance association. This interval will be applied to all the MEPs within a MA.

PARAMETERS

DEFAULT VALUE

The default CCM interval is 1 second.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-oam-domain-assoc)# ccm-interval 1m

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

10m|10s|1m|1s Specify the time interval between two CCMs (seconds or minutes).

333Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Ethernet OAM (Operations, Administration, and Maintenance)

Left running head: Chapter name (automatic)

ETH-AISeth-ais {enable|disable}

DESCRIPTION

This is entered in the OAM Domain Association MEP Configuration Mode. This command is used to enable/disable AIS.

PARAMETERS

DEFAULT VALUE

By default, the ETH-AIS will be disabled.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-oam-domain-assoc-mep)# eth-ais enable

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

enable|disable Enable/disable ETH-AIS.

334

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

eth-ais interval

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

ETH-AIS INTERVALeth-ais interval {1s|60s}

DESCRIPTION

This is entered in the OAM Domain Association MEP Configuration Mode. This command is used to configure the AIS frame periodicity in seconds

PARAMETERS

DEFAULT VALUE

The default AIS interval is 1 second.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-oam-domain-assoc-mep)# eth-ais interval 60s

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

1s|60s Specify the AIS transmission period (in seconds).

335Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Ethernet OAM (Operations, Administration, and Maintenance)

Left running head: Chapter name (automatic)

ETH-CFM ASSOCIATIONeth-cfm association <0-65535> domain <0-65535> [assocName {id <0-65535>|string <string>|vlan <2-4094>|vpnid <0-65535>}]

DESCRIPTION

This is entered in the OAM Configuration Mode.

This command is used to configure a maintenance association within a MD. This command enters the Domain Association Configuration Mode.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-oam)# eth-cfm association 1 domain 1 assocName string asso123ALU(config-oam-domain-assoc)#

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

association <0-65535> An unique integer identifying a specific maintenance association.

domain <0-65535> Index value for maintenance domain.

assocName {id <0-65535>|string <string> |vlan <2-4094>|vpnid <0-65535>}

Name for the MA. It can be specified in the following format: Index value, text string, VLAN number, VPN ID.

336

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

eth-cfm domain

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

ETH-CFM DOMAINeth-cfm domain <0-65535> [name {dns <dns-name> |mac <mac-address>|string <string>} level <0-7>]

DESCRIPTION

This is entered in the OAM Configuration Mode. This command is used to configure a MD. This command also allows you to configure an identity for the MD (index and name) and the domain level.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-oam)# eth-cfm domain 1 name string domain123 level 1

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

0-65535 An unique integer identifying a specific maintenance domain.

dns <dns-name>|mac <mac-address>|string <string>

Name for the MD. It can be specified in the following format: DNS name, MAC address or a text string.

0-7 Specifies the domain level.Domain level is used to differentiate various administrative networks like customer network, service provider network and operator network. Domain levels are assigned based on the administrative network.

Note: It is preferable to set the domain level as 6 or 7 for a MD.

337Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Ethernet OAM (Operations, Administration, and Maintenance)

Left running head: Chapter name (automatic)

ETH-CFM 1DMTESTeth-cfm 1DMtest <mac-address> mep <1-8191> domain <0-65535> association <0-65535> [priority <0-7>]

DESCRIPTION

This is entered in the OAM Configuration Mode. This command is used to initiate a ETH-CFM one-way delay test.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-oam)# eth-cfm 1DMtest 1111.1111.1111 mep 10 domain 1 association 10 priority 2

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

mac-address MAC address given on the interface.

1-8191 An integer, unique over a given MA, identifying a specific MEP.

0-65535 An unique integer identifying a specific maintenance domain.

0-65535 An unique integer identifying a specific maintenance association.

0-7 Value set for CCM and LTMs on a MEP.

338

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

eth-cfm 2dmtest

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

ETH-CFM 2DMTESTeth-cfm 2DMtest <mac-address> mep <1-8191> domain <0-65535> association <0-65535> [priority <0-7>]

DESCRIPTION

This is entered in the OAM Configuration Mode. This command is used to initiate a ETH-CFM two-way delay test.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-oam)# eth-cfm 2DMtest 1111.1111.1111 mep 10 domain 1 association 10 priority 2

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

mac-address MAC address given on the interface.

1-8191 An integer, unique over a given MA, identifying a specific MEP.

0-65535 An unique integer identifying a specific maintenance domain.

0-65535 An unique integer identifying a specific maintenance association.

0-7 Value set for CCM and LTMs on a MEP.

339Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Ethernet OAM (Operations, Administration, and Maintenance)

Left running head: Chapter name (automatic)

ETH-CFM ETH-TESTeth-cfm eth-test <mac-address> mep <1-8191> domain <0-65535> association <0-65535> [{datasize <1-1480>|priority <0-7>}]

DESCRIPTION

This is entered in the OAM Configuration Mode. This command is used to initiate an Ethernet test signal.

PARAMETERS

DEFAULT VALUE

By default, Ethernet test is disabled.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-oam)# eth-cfm eth-test 1111.1111.1111 mep 10 domain 1 association 10 priority 2

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

mac-address MAC address given on the interface.

1-8191 An integer, unique over a given MA, identifying a specific MEP.

0-65535 An unique integer identifying a specific maintenance domain.

0-65535 An unique integer identifying a specific maintenance association.

1-1480 Specifies the size of data (in bytes) to be sent as a part of the Ethernet test.

0-7 Value set for CCM and LTMs on a MEP.

340

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

eth-cfm linktrace

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

ETH-CFM LINKTRACEeth-cfm linktrace <mac-address> mep <1-8191> domain <0-65535> association <0-65535> [ttl <1-255>]

DESCRIPTION

This is entered in the OAM Configuration Mode. This command is used to initiate a linktrace test.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-oam)# eth-cfm linktrace 1111.1111.1111 mep 10 domain 1 association 10 ttl 10

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

mac-address MAC address given on the interface.

1-8191 An integer, unique over a given MA, identifying a specific MEP.

0-65535 An unique integer identifying a specific maintenance domain.

0-65535 An unique integer identifying a specific maintenance association.

1-255 Time to live value.The number of hops remaining to this LTM. Decremented by 1 by each Linktrace Responder that handles the LTM. One less than this value is returned in the LTR. If 0 or 1 on input, the LTM is not transmitted to the next hop. If 0 on input, no LTR is returned.

341Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Ethernet OAM (Operations, Administration, and Maintenance)

Left running head: Chapter name (automatic)

ETH-CFM LOOPBACKeth-cfm loopback <mac-address> mep <1-8191> domain <0-65535> association <0-65535> [{datasize <1-255>|priority <0-7>|send-count <1-5>}]

DESCRIPTION

This is entered in the OAM Configuration Mode. This command is used to initiate a loopback test.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-oam)# eth-cfm loopback 1111.1111.1111 mep 10 domain 1 association 10 datasize 100

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

mac-address MAC address given on the interface.

1-8191 An integer, unique over a given MA, identifying a specific MEP.

0-65535 An unique integer identifying a specific maintenance domain.

0-65535 An unique integer identifying a specific maintenance association.

1-255 Specifies the size of data (in bytes) to be sent as a part of loopback test.

priority Priority value set for CCM and LTMs on a MEP.

1-5 Specifies the total number of loopback frames to be sent as a part of loopback test.

342

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

eth-test

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

ETH-TESTeth-test {enable|disable}

DESCRIPTION

This is entered in the OAM Domain Association MEP Configuration Mode. This command is used to enable/disable Ethernet test signal on a MEP.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-oam-domain-assoc-mep)# eth-test enable

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

enable|disable Enable/disable Ethernet test signal on a MEP.

343Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Ethernet OAM (Operations, Administration, and Maintenance)

Left running head: Chapter name (automatic)

ETH-TEST TEST-PATTERNeth-test test-pattern {all-ones|all-zeros} crc {enable|disable}

DESCRIPTION

This is entered in the OAM Domain Association MEP Configuration Mode. This command is used to configure test pattern for Ethernet test signal on a MEP.

PARAMETERS

DEFAULT VALUE

By default, the test pattern is all 0's and no CRC.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-oam-domain-assoc-mep)# eth-test test-pattern all-ones crc enable

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

all-ones Indicates to send all 1's in the test pattern.

all-zeros Indicates to send all 0's in the test pattern.

enable|disable Enable/disable CRC (Cyclic Redundancy Check).

344

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

fault-alarm lowest-priority-defect

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

FAULT-ALARM LOWEST-PRIORITY-DEFECTfault-alarm lowest-priority-defect <1-6>

DESCRIPTION

This is entered in the OAM Domain Association MEP Configuration Mode. This command is used to configure the lowest priority fault alarm for a MEP.

PARAMETERS

DEFAULT VALUE

The default lowest priority defect value is 2.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-oam-domain-assoc-mep)# fault-alarm lowest-priority-defect 1

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

1-6 Specify the priority value for the fault alarm.

345Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Ethernet OAM (Operations, Administration, and Maintenance)

Left running head: Chapter name (automatic)

FAULT-ALARM RESET-TIMEfault-alarm reset-time <250-1000>

DESCRIPTION

This is entered in the OAM Domain Association MEP Configuration Mode. This command configures the fault alarm reset time (in milliseconds) on a MEP. During this time interval, no fault alarms are generated.

PARAMETERS

DEFAULT VALUE

The default reset-time is 1000 milliseconds.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-oam-domain-assoc-mep)# fault-alarm reset-time 400

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

250-1000 Specify the fault alarm reset time (in milliseconds) on a MEP in the range 250-1000.

346

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

fault-alarm set-time

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

FAULT-ALARM SET-TIMEfault-alarm set-time <250-1000>

DESCRIPTION

This is entered in the OAM Domain Association MEP Configuration Mode. This command is used to specify the time interval (in milliseconds) after which the fault alarm is raised for all the defects detected for a MEP.

PARAMETERS

DEFAULT VALUE

The default time interval is 250 milliseconds.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-oam-domain-assoc-mep)# fault-alarm set-time 300

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

250-1000 Specify the time interval (in milliseconds) in the range 250-1000.

347Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Ethernet OAM (Operations, Administration, and Maintenance)

Left running head: Chapter name (automatic)

MACADDRESSmacaddress <mac-address>

DESCRIPTION

This is entered in the OAM Domain Association MEP Configuration Mode. This command is used to configure MAC address for a MEP.

In order to differentiate different MEPs on the same physical interface, you can configure the MAC address for each MEP.

PARAMETERS

DEFAULT VALUE

By default, MEP takes the interface MAC address as the default address.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-oam-domain-assoc-mep)# macaddress 1111.2222.3333

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

mac-address MAC address for a MEP.

348

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

mep

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

MEPmep <1-8191> direction {Down|Up} interface <name> [vlan <1-4094>]

DESCRIPTION

This is entered in the OAM Domain Association Configuration Mode. This command is used to create a MEP identifier (MEPID) within a Maintenance Association. This enters MEP Configuration Mode.

Note: The MEP (source) should always be configured in the Down direction.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-oam-domain-assoc)# mep 1 direction Down interface FastEthernet 0ALU(config-oam-domain-assoc-mep)#

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

1-8191 An integer, unique over a given MA, identifying a specific MEP.

Down|Up Down: Indicates that the MEP receives CFM PDUs (Protocol Data Unit) from, and transmits them towards the direction of the LAN.Up: Indicates that a MEP residing in a Bridge transmits CFM PDUs towards, and receives them from, the direction of the Bridge Relay Entity.

name Name of the interface.

1-4094 VLAN range.

349Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Ethernet OAM (Operations, Administration, and Maintenance)

Left running head: Chapter name (automatic)

NO CCM-INTERVALno ccm-interval [10m|10s|1m|1s]

This is entered in the OAM Domain Association Configuration Mode. This command is used to delete the configured CCM interval and reset it to the default value. The default CCM interval is 1 second.

NO ETH-AIS INTERVALno ais-interval {1s|60s}

This is entered in the OAM Domain Association MEP Configuration Mode. This command is used to delete the configured AIS interval and reset it to the default. The default AIS interval is 1 second.

NO ETH-CFM DOMAINno eth-cfm domain <0-65535> [name {dns <dns-name>|mac <mac-address>|string <string>} <md-name> level <0-7>]

This is entered in the OAM Configuration Mode. This command is used to delete a maintenance domain.

Note: You cannot delete a MD if its associated with a MA. First delete the MA to delete the MD.

NO ETH-CFM ASSOCIATIONno eth-cfm association <0-65535> domain <0-65535> [assocName {id <0-65535>|string <string>|vlan <0-4096>|vpnid <0-65535>}]

This is entered in the OAM Configuration Mode. This command is used to delete a maintenance association from a maintenance domain.

Note: You cannot delete a MA if its associated with a MEP. First delete the MEP to delete the MA.

NO FAULT-ALARM LOWEST-PRIORITY-DEFECTno fault-alarm lowest-priority-defect [<1-6>]

This is entered in the OAM Domain Association MEP Configuration Mode. This command is used to delete the configured lowest priority fault alarm value and reset it to the default. The default lowest priority defect value is 2.

350

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

no fault-alarm reset-time

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NO FAULT-ALARM RESET-TIMEno fault-alarm reset-time [<250-1000>]

This is entered in the OAM Domain Association MEP Configuration Mode. This command is used to delete the configured fault alarm reset time and set it to default value. The default reset-time is 1000 milliseconds.

FAULT-ALARM SET-TIMEno fault-alarm set-time [<250-1000>]

This is entered in the OAM Domain Association MEP Configuration Mode. This command is used to delete the interval timer settings configured for fault alarm and reset it to default value. The default time interval is 250 milliseconds.

NO MACADDRESSno macaddress [<mac-address>]

This is entered in the OAM Domain Association MEP Configuration Mode. This command is used to remove the MAC address configuration from a MEP. This command sets the MAC address to the default, that is MEP takes the interface MAC address as the default address.

NO MEPno mep <1-8191> [direction {Down|Up} interface <name> [vlan <1-4094>]]

This is entered in the OAM Domain Association Configuration Mode. This command is used to disassociate the MEP from a MA.

NO PRIORITYno priority [<0-7>]

This is entered in the OAM Domain Association MEP Configuration Mode. This command is used to delete the configured priority value and reset it to the default. The default priority is 7.

NO REMOTE-MEPno remote-mep <1-8191>

This is entered in the OAM Domain Association Configuration Mode. This command is used to delete a remote MEP.

NO SHUTDOWNno shutdown

This is entered in the OAM Domain Association MEP Configuration Mode. This command is used to administratively bring up the MEP.

351Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Ethernet OAM (Operations, Administration, and Maintenance)

Left running head: Chapter name (automatic)

OAMoam

DESCRIPTION

This is entered in the Configuration Mode. This command enters the OAM configuration mode.

PARAMETERS

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# oamALU(config-oam)#

RELEASE HISTORY

Release 3.0: command was introduced.

352

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

remote-mep

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

REMOTE-MEPremote-mep <1-8191>

DESCRIPTION

This is entered in the OAM Domain Association Configuration Mode. This command is used to configure a remote MEP.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-oam-domain-assoc)# remote-mep 10

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

1-8191 An integer, unique over a given MA, identifying a specific MEP.

353Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Ethernet OAM (Operations, Administration, and Maintenance)

Left running head: Chapter name (automatic)

SHOW ETH-CFM ASSOCIATIONshow eth-cfm association <0-65535> detail

DESCRIPTION

This is entered in the Super User Mode or Configuration Mode. This command displays OAM association information.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show eth-cfm association 100 detail

--------------------------------------------------------------- Association 100 Information---------------------------------------------------------------mdIndex: 100maIndex: 100 maNameFormat: string maName: asc100 ccmInterval: 1 Remote Mep IDs RMep Id: 100 RMep Id: 20 RMep Id: 200

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

0-65535 Displays the information for the specified maintenance association.

354

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show eth-cfm cfm-stack-table

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW ETH-CFM CFM-STACK-TABLEshow eth-cfm stack-table [interface <name> level <0-7> direction {Down|Up}]

DESCRIPTION

This is entered in the Super User Mode or Configuration Mode. This command displays stack-table information.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show eth-cfm cfm-stack-table

---------------------------------------------------------Dot1ag Stack Table Information---------------------------------------------------------Interface VLAN-id level Dir MdIndex MaIndex MepIndex MacAddressFastEthernet0 0 7 Down 100 100 10 00e0.b1c6.df2aFastEthernet0:10 10 0 Down 1 1 1 00e0.b1c6.df2a

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

name Name of the interface.

0-7 Domain level of the maintenance domain.

Down|Up Specify the direction of the MEP.

355Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Ethernet OAM (Operations, Administration, and Maintenance)

Left running head: Chapter name (automatic)

SHOW ETH-CFM DOMAINshow eth-cfm domain [<0-65535>] [association <0-65535>|all] [detail]

DESCRIPTION

This is entered in the Super User Mode or Configuration Mode. This command displays domain information.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show eth-cfm domain 100 association 100 detail -------------------------------------------------------Domain: 100mdNameFormat: string mdName: dom100mdLevel: 7-------------------------------------------------------Domain 100 Associations-------------------------------------------------------Association index: 100 Name Fromat: string Name=asc100 CCM interval:1

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

0-65535 Displays the information for the specified maintenance domain.

0-65535 An unique integer identifying a specific maintenance association.

all All the maintenance associations configured in the system.

detail Displays the detailed information for the specified maintenance domain.

356

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show eth-cfm mep

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW ETH-CFM MEPshow eth-cfm mep <1-8191> domain <0-65535> association <0-65535>

DESCRIPTION

This is entered in the Super User Mode or Configuration Mode. This command displays MEP information.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show eth-cfm mep 10 domain 100 association 100

2010 Mar 10 15:07:47: %CLI-3-ETH-OAM-CMI: oam_fs_close: fd : 12 reason : 0---------------------------------------------------------MEP Information--------------------------------------------------------- md_Index: 100 ma_Index: 100 mep_Index: 10 Interface Name: FastEthernet0 AdminState: Up Direction: Down MacAddress: 00e0.b1c6.df2a CCM Enable: Enabled CCM/LTM Priority: 0 CcmTx: 72850 CcmSequenceErr: 30 AlarmSet Time: 250 AlarmReset Time: 250 LowestPrior Defect: DefMACstatus DefRemoteCCM DefErrorCCM DefXconCCM HighestDefect: DefNone Defect Flags: DefNone AIS-Enable: Disabled AIS Priority: 1 AIS Interval: 1 AIS Level: 0

Parameter Description

1-8191 An integer, unique over a given MA, identifying a specific MEP.

domain <0-65535> An unique integer identifying a specific maintenance domain.

association <0-65535> An unique integer identifying a specific maintenance association.

357Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Ethernet OAM (Operations, Administration, and Maintenance)

Left running head: Chapter name (automatic)

SHOW ETH-CFM MEP - LOOPBACK AND LINKTRACEshow eth-cfm mep <1-8191> domain <0-65535> association <0-65535> {loopback|linktrace}

DESCRIPTION

This is entered in the Super User Mode or Configuration Mode. This command displays the MEP, MA's, MD's, stored link trace and loopback information.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show eth-cfm mep 10 domain 100 association 100 linktrace

---------------------------------------------------------MEP Information--------------------------------------------------------- md_Index: 100 ma_Index: 100 mep_Index: 10 Interface Name: FastEthernet0 AdminState: Up Direction: Down MacAddress: 00e0.b1c6.df2a CCM Enable: Enabled CCM/LTM Priority: 0 CcmTx: 79559 CcmSequenceErr: 32 AlarmSet Time: 250 AlarmReset Time: 250 LowestPrior Defect: DefMACstatus DefRemoteCCM DefErrorCCM DefXconCCM HighestDefect: DefNone Defect Flags: DefNone AIS-Enable: Disabled AIS Priority: 1 AIS Interval: 1 AIS Level: 0---------------------------------------------------------MEP Linktrace Message Information---------------------------------------------------------LtRxUnexplained: 0 LtNextSequence: 2LtStatus: False LtResult: FalseTargIsMepId: False TargMepId: 10EgressId: 0000:00e0:b1c6:df2aTargMac: 0000:0000:0000TTL: 64 SequenceNum: 1LtFlags: UseFDBonly

Parameter Description

1-8191 An integer, unique over a given MA, identifying a specific MEP.

domain <0-65535> An unique integer identifying a specific maintenance domain.

association <0-65535> An unique integer identifying a specific maintenance association.

358

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show eth-cfm mep - loopback and linktrace

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

---------------------------------------------------------MEP Linktrace Replies---------------------------------------------------------SequenceNumber: 1 ReceivedOrder: 1Ttl: 63 Forwarded: TrueLastEgressId: 0000:00e0:b1c6:df2a TerminalMep: FalseNextEgressId: 0000:4692:0101:0001 Relay: rlyFdbChassisId: NoneManAddressDomain: NoneManAddress: NoneIngressMac: 0000:0000:0000 IngressPortIdSubType: NoneIngressPortId: NoneEgressMac: 4692:0101:0001 EgressAction: EgrOkEgressPortIdSubType: NoneegressPortId: NoneOrgSpecificTlv: None

ALU(config)# show eth-cfm mep 10 domain 100 association 100 loopback

---------------------------------------------------------MEP Information--------------------------------------------------------- md_Index: 100 ma_Index: 100 mep_Index: 10 Interface Name: FastEthernet0 AdminState: Up Direction: Down MacAddress: 00e0.b1c6.df2a CCM Enable: Enabled CCM/LTM Priority: 0 CcmTx: 79641 CcmSequenceErr: 32 AlarmSet Time: 250 AlarmReset Time: 250 LowestPrior Defect: DefMACstatus DefRemoteCCM DefErrorCCM DefXconCCM HighestDefect: DefNone Defect Flags: DefNone AIS-Enable: Disabled AIS Priority: 1 AIS Interval: 1 AIS Level: 0---------------------------------------------------------MEP LoopBack Information---------------------------------------------------------LbRxReply: 1 LbRxBadOrder: 0LbRxBadMsdu: 0 LbTxReply: 0LbStatus: False LbResult: TrueDestIsMepId: False DestMepId: 10SendCount: 0 VlanDropEnable: 0SequenceNum: 2 NextSequenceId: 2DestMac: 0000:0000:0000 VlanPriority: 0DataTLV: None---------------------------------------------------------

RELEASE HISTORY

Release 3.0: command was introduced.

359Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Ethernet OAM (Operations, Administration, and Maintenance)

Left running head: Chapter name (automatic)

SHOW ETH-CFM MEP - 1DM-TEST-RESULTS show eth-cfm mep <1-8191> domain <0-65535> association <0-65535> 1DM-test-results remote-peer-mac <mac-address>

DESCRIPTION

This is entered in the Super User Mode or Configuration Mode. This command displays the MEP, MA's, MD's, result of the one-way delay test.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show eth-cfm mep 100 domain 100 association 100 1DM-test-results remote-peer-mac 00e0.b1c6.df2a

------------------------------------------------------------------------ 1DM Test Result------------------------------------------------------------------------ PEER MAC Delay(microseconds) Variation(microseconds) 00:e0:b1:c6:df:2a 4060307296 234660000------------------------------------------------------------------------

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

1-8191 An integer, unique over a given MA, identifying a specific MEP.

domain <0-65535> An unique integer identifying a specific maintenance domain.

association <0-65535> An unique integer identifying a specific maintenance association.

mac-address MAC address for a MEP on the remote peer.

360

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show eth-cfm mep - 2dm-test-results

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW ETH-CFM MEP - 2DM-TEST-RESULTS show eth-cfm mep <1-8191> domain <0-65535> association <0-65535> 2DM-test-results remote-peer-mac <mac-address>

DESCRIPTION

This is entered in the Super User Mode or Configuration Mode. This command displays the MEP, MA's, MD's, result of the two-way delay test.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show eth-cfm mep 10 domain 100 association 100 2DM-test-results remote-peer-mac 00e0.b1b2.539c

------------------------------------------------------------------------ 2DM Test Result------------------------------------------------------------------------ PEER MAC Delay(microseconds) Variation(microseconds) 00:e0:b1:b2:53:9c 10000 10000------------------------------------------------------------------------

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

1-8191 An integer, unique over a given MA, identifying a specific MEP.

domain <0-65535> An unique integer identifying a specific maintenance domain.

association <0-65535> An unique integer identifying a specific maintenance association.

mac-address MAC address for a MEP on the remote peer.

361Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Ethernet OAM (Operations, Administration, and Maintenance)

Left running head: Chapter name (automatic)

SHOW ETH-CFM MEP - ETH-TEST-RESULTS show eth-cfm mep <1-8191> domain <0-65535> association <0-65535> eth-test-results remote-peer-mac <mac-address>

DESCRIPTION

This is entered in the Super User Mode or Configuration Mode.This command displays the MEP, MA's, MD's, Ethernet test results.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show eth-cfm mep 100 domain 100 association 100 eth-test-results remote-peer-mac 00e0.b1c6.df2a --------------------------------------------------------- MEP eth-test Results Information--------------------------------------------------------- mepIndex : 100 mdIndex : 100 maIndex : 100 peerMacAddr : 0:e0:b1:c6:df:2a frameCount : 1 byteCount : 64 bitErrs : 0 crcErrs : 0 AccBitErrs : 0 AccCrcErrs : 0---------------------------------------------------------

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

1-8191 An integer, unique over a given MA, identifying a specific MEP.

domain <0-65535> An unique integer identifying a specific maintenance domain.

association <0-65535> An unique integer identifying a specific maintenance association.

mac-address MAC address for a MEP on the remote peer.

362

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show eth-cfm mep - remote-mepid

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW ETH-CFM MEP - REMOTE-MEPID show eth-cfm mep <1-8191> domain <0-65535> association <0-65535> {remote-mepid <1-8191>|all-remote-mepids}

DESCRIPTION

This is entered in the Super User Mode or Configuration Mode. This command displays the MEP, MA's, MD's, remote MEP IDs.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show eth-cfm mep 10 domain 100 association 100 all-remote-meps

---------------------------------------------------------------Eth-CFM Remote-Mep Table---------------------------------------------------------------R-mepId Rx-CC Rx-Rdi Port-Tlv If-Tlv Peer Mac Addr CCM status since--------------------------------------------------------------- 100 False True Absent Absent 0E0.B1B2.539C Fri Jan 2 02:31:49 1970 20 False True Absent Absent 0E0.B1C6.3CBC Fri Jan 2 02:31:49 1970 200 False True Absent Absent 011.8B 2.7911 Fri Jan 2 02:31:49 1970---------------------------------------------------------------

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

1-8191 An integer, unique over a given MA, identifying a specific MEP.

domain <0-65535> An unique integer identifying a specific maintenance domain.

association <0-65535> An unique integer identifying a specific maintenance association.

remote-mepid <1-8191> An integer, unique over a given MA, identifying a remote MEP. Displays information on the specific remote MEP.

all-remote-mepids Displays information on all the remote MEPs.

363Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Ethernet OAM (Operations, Administration, and Maintenance)

Left running head: Chapter name (automatic)

SHUTDOWNshutdown

DESCRIPTION

This is entered in the OAM Domain Association MEP Configuration Mode. This command is used to administratively bring down the MEP.

PARAMETERS

None.

DEFAULT VALUE

By default, MEP will be in shutdown state.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-oam-domain-assoc-mep)# shutdown

RELEASE HISTORY

Release 3.0: command was introduced.

364

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Bridging Configuration

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 19 BRIDGING CONFIGURATION

This chapter documents the Command Line Interface (CLI) commands for bridging on OmniAccess 5510 USG.

This chapter includes tables of parameters, default values, and configuration examples for configuring bridging on OmniAccess 5510 USG as quick-start and reference information. In this chapter, all commands are described in alphabetical order. For more detailed information on using and configuring bridging, refer to the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

365Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Bridging Configuration

Left running head: Chapter name (automatic)

BRIDGING CONFIGURATION COMMANDSThis section deals with the commands related to configuring bridging on OmniAccess 5510 USG:

CLEAR BRIDGE STATISTICSclear bridge statistics

DESCRIPTION

This is entered in the Super User Mode or Configuration Mode. This command is used to clear the bridge node statistics.

PARAMETERS

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# clear bridge statistics

RELEASE HISTORY

Release 3.0: command was introduced.

NO VLANno vlan {<2-4094>... |native|range <2-4094> <2-4094>}

This is entered in the Interface Configuration Mode. This command is used to disable BCP if all VLANs are removed from the interface configuration.

Use ‘Native’ keyword to disable bridging of untagged packets. Native VLAN is no more native though VLAN is still configured on the interface. BCP will be disabled if the last VLAN configuration is removed. This command is also used to delete range of VLANs configured on the interface.

366

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show bridge statistics

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW BRIDGE STATISTICSshow bridge statistics

DESCRIPTION

This is entered in the Super User Mode or Configuration Mode. This command displays the bridging statistics on the system.

PARAMETERS

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show bridge statistics

************BRIDGE STATISTICS************ Bridge Packets input 4244 Bridge Packets output 0 Bridge Packets to IRB 0 Bridge Packets from IRB 0 Bridge Packets stp 4244 Bridge Packets drop 0 Bridge Packets stp blocked 0 Bridge Packets pvstp blocked 0

RELEASE HISTORY

Release 3.0: command was introduced.

367Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Bridging Configuration

Left running head: Chapter name (automatic)

SHOW FRAME-RELAY PVC show frame-relay pvc [{<16-1022>|interface Serial <port>}]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Interface Configuration Mode. This command displays the status of the Frame Relay Permanent Virtual Circuit (PVC).

PARAMETERS

EXAMPLEALU(config-if Serial0)# show frame-relay pvc 20

PVC Statistics for interface Serial0 (Frame Relay DTE)

DLCI = 20, DLCI USAGE = LOCAL, PVC STATUS = STATIC, INTERFACE = Serial0 input pkts 195 output pkts 100 in bytes 16156 out bytes 10222 in pkts dropped 6 out pkts dropped 0 in FECN pkts 0 out FECN pkts 0 in BECN pkts 0 out BECN pkts 0 in DE pkts 0 out DE pkts 0

out bcast pkts 0 out bcast bytes 0

End-to-End Fragmentation Statistics Packets Fragmented 0 Fragments created 0 Fragments failed 0

End-to-End Reassembly Statistics Fragments Received 0 Fragments Reassembled 0 Fragments Dropped 0 Fragments Timeout 0 Fragments Rordered 0

Parameter Description

16-1007 DLCI value.

port Port number of the interface.

368

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show hdlc statistics

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW HDLC STATISTICSshow hdlc statistics

DESCRIPTION

This is entered in the Interface Configuration Mode. This command displays the BCP statistics on the HDLC interface.

PARAMETERS

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-if Serial0)# show hdlc statistics

Keepalive received : 3Keepalive sent : 3Giant packets received : 0Bridge packets received : 62Bridge packets dropped : 0Non IP packets dropped : 0Packet errors : 0

RELEASE HISTORY

Release 3.0: command was introduced.

369Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Bridging Configuration

Left running head: Chapter name (automatic)

SHOW INTERFACES MLPPPshow interfaces mlppp <1-256>

DESCRIPTION

This is entered in the Super User Mode or Configuration Mode or Interface Configuration Mode. This command displays bridging statistics on the MLPPP interface.

PARAMETERS

EXAMPLEALU(config)# show interfaces mlppp 1

mlppp1 is up, line protocol is up Internet address not set MTU 1494 bytes, BW 1984 Kbit, DLY 0 usec, reliability 255/255, txload 0/255, rxload 0/255 Encapsulation mlppp, loopback not set BCP: Open IPCP: Stopped Last input never, output never, output hang never Last clearing of "show interface" counters never 5 minutes input rate 160 bits/sec, 0 packets/sec 5 minutes output rate 160 bits/sec, 0 packets/sec 16 packets input (2 Control packets, 14 Data packets), 1198 bytes 8 packets output (2 Control packets, 6 Data packets), 678 bytes 0 Small packets dropped, 0 giants received 0 protocol packets dropped, 0 non ppp packets dropped 14 packets bridged, 2 bridge packets dropped Fragmentation: Fragment Delay 0 ms 0 fragmented, 0 couldn't fragment 0 fragments created, 0x18 sent sequence Reassembly: Slippage MRU 32 0 fragments in reassembly list 0 lost fragments, 0 reordered 0 discarded fragments, 0 reassembled 0 lost received, 0 couldn't reassemble 0 fragments received, 0x16 received sequence

Parameter Description

1-256 MLPPP bundle identification. The range of the bundle ID is between 1 and 256.

370

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ppp bcp statistics Serial

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW PPP BCP STATISTICS SERIALshow ppp bcp statistics Serial <port>

DESCRIPTION

This is entered in the Super User Mode or Configuration Mode or Interface Configuration Mode. This command displays the BCP statistics on the PPP interface.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show ppp bcp statistics Serial 0

IN OUT

BCP Configure Requests: 1 1BCP Configure Acks: 1 1BCP Configure Naks: 0 0BCP Configure Rejects: 0 0BCP Terminate Requests: 0 0BCP Terminate Acks: 0 0BCP Code Rejects: 0 0BCP Invalid Packets: 0 0

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

port Serial interface port number.

371Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Bridging Configuration

Left running head: Chapter name (automatic)

SHOW PPP SESSION STATISTICS SERIALshow ppp session statistics Serial <port>

DESCRIPTION

This is entered in the Super User Mode or Configuration Mode or Interface Configuration Mode. This command in addition to PPP session related statistics displays the packets bridged and the bridged packets dropped statistics.

PARAMETERS

EXAMPLEALU(config-if Serial0)# show ppp session statistics Serial 0:0

PPP data packets received: 92PPP control packets received: 10Small Packets dropped: 0Giant Packets dropped: 0Protocol Packets dropped: 0Non PPP Packets dropped: 0Unexpected IP packets dropped: 0Packets Bridged: 0Bridge Packets dropped: 0

PPP sessions initiated: 0PPP sessions received: 0PPP sessions successful: 0PPP sessions terminated: 0

Parameter Description

port Serial interface port number.

372

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show vlan

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW VLANshow vlan {Brief|id <1-4094>}

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. Displays the configuration of the VLANs configured.

PARAMETERS

EXAMPLEALU(config)# show vlan Brief

VLAN_ID Interface name Mode --------- ----------------- -------- 5 switchport3 Access Serial0 Trunk 10 switchport0 Access Serial0 Trunk 1 switchport1 No-Mode switchport2 No-Mode

Parameter Description

Brief Displays all the VLANs that are configured on OmniAccess 5510 USG.

id Displays the configuration for a specific VLAN.

373Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Bridging Configuration

Left running head: Chapter name (automatic)

VLANvlan {<2-4094>... [native]|range <2-4094> <2-4094>}

DESCRIPTION

This command is entered in the Interface Configuration Mode.

This command is used to enable VLAN 802.1Q trunk on the interface. When first VLAN is configured, BCP is automatically enabled. Once BCP is enabled and is in ‘open’ state, the interface can receive/transmit tagged packets.

(The BCP state can be seen in “show interfaces <interface-name>” command).

When ‘native’ is configured, untagged packets are bridged based on the native configuration. This command can also be used to configure multiple VLANs and a range of VLANs on the interface.

When multiple VLANs are configured and ‘native’ keyword is used, the last VLAN is the native VLAN (that is, the last VLAN is considered for bridging the untagged packets.)

Note: Bridging should be enabled per interface/sub-interface (in case of FR interface). The same VLAN cannot be configured on the main or sub-interface or two different sub-interfaces.

Bridging is not allowed on FE sub-interface. It can be configured to receive tagged packets by setting the encapsulation to “dot1q”.

Frame Relay main and sub-interfaces can independently be configured in routing or bridging mode.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLE

The following example configures VLAN 2 on the interface. This interface bridges the tagged packets:

ALU(config)# interface Serial 0ALU(config-if Serial0)# vlan 2

Parameter Description

2-4094 VLAN-ID configured on the interface.

374

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

vlan

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

The following example configures VLAN 2 on the interface, and native. This interface bridges tagged as well as untagged packets:

ALU(config)# interface Serial 0ALU(config-if Serial0)# vlan 2 native

This following example configures multiple VLANs on the interface. ALU(config)# interface Serial 0ALU(config-if Serial0)# vlan 20 30 40

This following example configures range of VLANs on the interfaceALU(config)# interface Serial 0ALU(config-if Serial0)# vlan range 50 100

RELEASE HISTORY

Release 3.0: command was introduced.

375Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Bridging Configuration

Left running head: Chapter name (automatic)

376

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Link Fragmentation and Interleaving (LFI)

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 20 LINK FRAGMENTATION AND INTERLEAVING (LFI)

This chapter documents the Command Line Interface (CLI) commands for the Link Fragmentation and Interleaving (LFI). These commands are used to configure LFI on Multilink Point-to-Point Protocol (MLPPP) or Frame Relay (FR) interface. You are required to refer to “Universal Serial Port (USP)”, “Multilink Point to Point Protocol”, and “Frame Relay” chapters before proceeding to this.

This chapter includes table of parameters, default values, and configuration examples for LFI configurations as quick-start and reference information. In this chapter, all the commands are described in alphabetical order. For more detailed information about using and configuring LFI, refer to the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

Note: LFI is supported on OmniAccess 5510-SR USG and OmniAccess 5510-TE USG. OmniAccess 5510-AA/AB USG do not support LFI.

The LFI-MLPPP/LFI-FR configuration commands are shown for a serial (V.35/X.21/RS-232) interface as an example. The steps are similar for configuration of LFI on a T1 or an E1 interface.

377Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Link Fragmentation and Interleaving (LFI)

Left running head: Chapter name (automatic)

LFI CONFIGURATION ON MLPPP CLI COMMANDSThis section deals with the commands relevant to LFI configuration on MLPPP interface.

FRAGMENT DELAYfragment delay <1-256>

DESCRIPTIONThis command is entered in the Interface Configuration Mode. This command is used to configure the fragment delay on the MLPPP bundle interface.

PARAMETERS

DEFAULT VALUEThe default value of fragment delay is 0, i,e., no fragmentation will be performed.

EXAMPLEALU(config)# interface mlppp 100ALU(config-if mlppp100)# fragment delay 10

Note: The MTU (Maximum Transmission Unit) of the individual links in a MLPPP bundle should be greater than the fragment size.

Parameter Description

1-256 Fragment delay range (in milli seconds). Fragment delay on the MLPPP interface specifies how long it will take for a fragment to exit the interface.

378

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

no fragment delay

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NO FRAGMENT DELAYno fragment delay

This command is entered in the Interface Configuration Mode. The ‘no’ command sets the fragment delay to default value and hence disables the fragmentation on MLPPP.

NO SERVICE-POLICYno service-policy {in|out} <policy-map name>

This command is entered in the Interface Configuration Mode. The ‘no’ command detaches the policy map from the interface.

NO SLIPPAGE MRUno slippage mru

This command is entered in the Interface Configuration Mode. The ‘no’ command sets the slippage MRU to its default, i.e., 32 MRU.

SERVICE-POLICY service-policy {in|out} <policy-map name>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to attach a policy map to the MLPPP interface.

PARAMETERS

EXAMPLEALU(config)# interface mlppp 100ALU(config-if mlppp100)# service-policy out P1

Parameter Description

in|out Ingress or egress direction.

policy-map name Name of the policy map.

379Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Link Fragmentation and Interleaving (LFI)

Left running head: Chapter name (automatic)

SLIPPAGE MRU slippage mru <16-256>

DESCRIPTION

This command is entered in the Interface Configuration Mode.

Slippage on MLPPP interface allows configuration of buffer in terms of MRU, which represent number of fragments to be stored without getting reassembled. Based on the slippage parameter configuration, buffer is allocated on the receiver side.

PARAMETERS

DEFAULT VALUE

The default slippage MRU value is 32 MRU.

EXAMPLEALU(config)# interface mlppp 100ALU(config-if mlppp100)# slippage mru 16

Parameter Description

16-256 Specifies the number of fragments to be stored at a time on the MLPPP bundle.

380

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show interfaces mlppp

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW INTERFACES MLPPPshow interfaces mlppp <1-256>

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Interface Configuration Mode. This command displays the LFI configuration on the MLPPP bundle interface specified.

PARAMETERS

EXAMPLEALU(config)# show interface mlppp 100

mlppp100 is up, line protocol is up Internet address is 20.20.20.20/24 MTU 1494 bytes, BW 512 Kbit, DLY 0 usec, reliability 255/255, txload 10/255, rxload 10/255 Encapsulation mlppp, loopback not set IPCP: Open Last input never, output never, output hang never Last clearing of "show interface" counters never 2 packets input (2 Control packets, 0 Data packets), 28 bytes 2 packets output (2 Control packets, 0 Data packets), 28 bytes 0 packets dropped, 0 giants receivedFragmentation: Fragment Delay 10 ms 5 fragmented, 0 couldn't fragment 10 fragments created, 0x9 sent sequence Reassembly: Slippage MRU 16 0 fragments in reassembly list 0 lost fragments, 0 reordered 11 discarded fragments, 0 reassembled 0 timeouts, 0 couldn't reassemble 0 fragments received, 0xb received sequence

Parameter Description

1-256 Bundle Identification. This varies from 1-256.

381Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Link Fragmentation and Interleaving (LFI)

Left running head: Chapter name (automatic)

LFI CONFIGURATION ON FR CLI COMMANDSThis section deals with the commands relevant to LFI configuration on FR interface.

FRAGMENT-SIZEframe-relay fragment <40-1600> end-to-end

DESCRIPTIONThis command is entered in the Interface Configuration Mode. This command is used to configure the fragment size. Minimum fragment size is 40.

PARAMETERS

DEFAULT VALUEThe default fragment size is 0. In this case, no fragmentation can be performed.

EXAMPLEALU(config-if Serial0)# frame-relay fragment 80 end-to-end

Parameter Description

40-1600 Specifies the fragment size.

382

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

no frame-relay fragment

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NO FRAME-RELAY FRAGMENTno frame-relay fragment

This command is entered in the Interface Configuration Mode. The ‘no’ command sets fragment size to the default value and hence unconfigures the fragment size on the FR interface, i.e., no fragmentation will be applicable.

NO SERVICE-POLICYno service-policy {in|out} <policy-map name>

This command is entered in the Interface Configuration Mode. The ‘no’ command detaches the policy map from the interface.

NO SLIPPAGE MRUno slippage mru

This command is entered in the Interface Configuration Mode. The ‘no’ command sets the slippage MRU to its default, i.e., 32 MRU.

SERVICE-POLICY service-policy {in|out} <policy-map name>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to attach a policy map to the an interface.

PARAMETERS

EXAMPLEALU(config-if Serial0)# service-policy out P1

Parameter Description

in|out Ingress or egress direction.

policy-map name Name of the policy map.

383Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Link Fragmentation and Interleaving (LFI)

Left running head: Chapter name (automatic)

SLIPPAGE MRU slippage mru <16-128>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command specifies the number of fragments that can be buffered per Virtual Circuit (VC).

PARAMETERS

DEFAULT VALUE

The default slippage MRU value is 32 MRU.

EXAMPLEALU(config-if Serial0)# slippage mru 16

Parameter Description

16-128 Specifies the number of fragments that can be buffered per VC.

384

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show frame-relay fragments

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW FRAME-RELAY FRAGMENTSshow frame-relay fragment [<16-1022>|interface Serial <port>]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Interface Configuration Mode. This command displays the fragmentation and reassembly statistic for the main interface or on a specific DLCI.

PARAMETERS

EXAMPLEALU(config)# show frame-relay fragment interface Serial 0

Fragmentation Statistics for interface Serial0

DLCI: 100 Fragment Size: 0 Fragment Type: End-to-EndFrags: 0 fragmented, 0 couldn't fragment, 0 fragments createdReass: 0 reassembled, 0 timeouts, 0 dropped, 0 reordered

Parameter Description

16-1022 DLCI number.

port Port number of the interface.

385Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Link Fragmentation and Interleaving (LFI)

Left running head: Chapter name (automatic)

SHOW FRAME-RELAY PVCshow frame-relay pvc [<16-1022>|interface Serial <port>]

DESCRIPTION

TThis command is entered in the Super User Mode, Configuration Mode or Interface Configuration Mode. his command displays the fragmentation and reassembly statistic per PVC.

PARAMETERS

EXAMPLEALU(config)# show frame-relay pvcDLCI = 100, DLCI USAGE = LOCAL, PVC STATUS = STATIC, INTERFACE = Serial0

………… End-to-End Fragmentation Statistics

Packets fragmented 10 Fragments Created 220fragments failed 0

End-to-End Reassembly Statistics

fragments received 220 fragments reassembled 220 fragments dropped 0fragments timeout 0fragments reordered 0

DLCI = 110, DLCI USAGE = LOCAL, PVC STATUS = STATIC, INTERFACE = Serial0 ………… End-to-End Fragmentation Statistics

Packets fragmented 10 Fragments Created 220fragments failed 0

End-to-End Reassembly Statistics

fragments received 220 fragments reassembled 220 fragments dropped 0fragments timeout 0fragments reordered 0

Parameter Description

16-1022 DLCI number.

port Port number of the interface.

386

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show interface serial

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW INTERFACE SERIALshow interface serial <port>

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Interface Configuration Mode. This command displays the configured value of fragment size and slippage MRU configured on the specified interface.

PARAMETERS

EXAMPLEALU(config)# show interfaces Serial 0

Serial0 is up, line protocol is up X.21 DTE Serial attached Internet address is 15.0.0.1/8 MTU 1500 bytes, BW 2048 Kbit, DLY 0 usec, reliability 255/255, txload 0/255, rxload 0/255 loopback not set Encapsulation frame-relay, Keepalive set (10 sec) Fragment Size 80, Slippage MRU Size 32 LMI enq sent 0, LMI stat recvd 0, LMI upd recvd 0, DTE LMI down LMI enq recvd 0, LMI stat sent 0, LMI upd sent 0 LMI DLCI 0 LMI type is Autosense frame relay DTE Last input never, output never, output hang never Last claring of "show interface" counters never Queueing strategy: fifo Output queue: 0 0 (size/max) 0 drops: Input queue 0/0 (size/max) 0 drops Conversations: 0/0/0 (active/max active/max total) Reserved Conversations: 0/0 (allocated/max allocated) Available Bandwidth 2048 kilobits/sec 5 minute input rate 0 bits/sec, 0 packets/sec 5 minute output rate 0 bits/sec, 0 packets/sec 0 packets input, 0 bytes, 0 no buffer Received 0 broadcasts, 0 runts, 0 giants, 0 throttles 0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort 0 packets output, 0 bytes, 0 no buffer 0 output errors, 0 collisions, 1 interface resets 0 output buffer failures, 0 output buffers swapped out 0 carrier transitions DCD=down DSR=down DTR=down RTS=down CTS=down

Parameter Description

port Port number of the interface.

387Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Link Fragmentation and Interleaving (LFI)

Left running head: Chapter name (automatic)

388

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

For final production, import color definitions from\\daldoc01\docteam\templates\framemaker\book-template\color-defs\ production-colors.fm. Do not import other template elements such as page layout.

To return to the draft version, import color def’ns from draft-colors.fm.To switch to the beta version, import color def’ns from beta-colors.fm

For final production, import color definitions from\\daldoc01\docteam\templates\framemaker\book-template\color-defs\ production-colors.fm. Do not import other template elements such as page layout.

To return to the draft version, import color def’ns from draft-colors.fm.To switch to the beta version, import color def’ns from beta-colors.fm

Optional footer: Manual title (to set, redefine ManualTitlevariable)

agination: umeric & ntinuous

PNco

Part 4 Common Classification

Beta BetaAlcatel-Lucent

389

Beta Betawith preceding section of book

OmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Left running head: Chapter name (automatic)

390

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Common Classifiers

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 21 COMMON CLASSIFIERS

This chapter explains the functionality and syntax of OmniAccess 5510 USG common classifier commands.

All commands are described in alphabetical order. They do not follow the sequence of configuration. For more detailed information on using and configuring the above concepts, refer the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

391Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Common Classifiers

Left running head: Chapter name (automatic)

ETHERNETethernet {any|mac <source-mac-address>} {any|mac <destination-mac-address>} [priority <0-7>|vlan-id <1-4094>}

DESCRIPTION

This command is entered in the Match-list Configuration Mode. This command is used to configure rule based on Ethernet parameters.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-match-list-m1)# ethernet mac 1122.aabb.55ff any

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

source-mac-address

Specify the source MAC address.

destination-mac-address

Specify the destination MAC address.

0-7 Priority value.

1-4094 VLAN ID.

392

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

include

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

INCLUDEinclude <match-list name>

DESCRIPTION

Another key feature of OmniAccess 5510 USG classification is the capability of nesting.

This command is entered in the specific Match-list Configuration Mode. This command is used to include a match-list/s that is already configured inside another match-list.

PARAMETERS

EXAMPLE

Ex 1: In the example below, the match-list m2 contains the rule of match-list m1 in addition to the other rules specific to match-list m2.

ALU(config)# match-list m1 ALU(config-match-list-m1)# ip prefix 192.168.1.0/24 host 192.168.1.72

ALU(config)# match-list m2ALU(config-match-list-m2)# tcp any any service sshALU(config-match-list-m2)# tcp prefix 192.168.2.0/24 any service smtpALU(config-match-list-m2)# include m1

Ex 2:Consider another example to configure match-lists, using appropriate rule sets with the ‘include’ keyword.

ALU(config)# match-list m1ALU(config-match-list-m1)# 1 prefix 10.0.0.0/8 host 21.1.1.1ALU(config-match-list-m1)# 2 list l2 list l3

ALU(config)# match-list m2ALU(config-match-list-m2)# 1 tcp any any service sshALU(config-match-list-m2)# 2 udp prefix 22.1.1.0/8 anyALU(config-match-list-m2)# 3 ip any any

ALU(config-match-list-m2)# 4 include m1

Note: There is no ordering of rules inside a match-list. All the rules are of same priority. The rule numbers are used only for reference.

Parameter Description

match-list name Name of the match-list, which has to be included.

393Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Common Classifiers

Left running head: Chapter name (automatic)

Ex 3:Consider the following example with the necessary modes of configurations included:

ALU(config)# list l1 host 192.168.0.4 prefix 192.168.0.1/24 interface FastEthernet 0

ALU(config)# list l2 host 192.168.0.3 include l1 ALU(config)# match-list m1

ALU(config-match-list-m1)# tcp any list l1 length 23 from ssh service range 23 35 ALU(config-match-list-m1)# exit

ALU(config)# match-list m2 ALU(config-match-list-m2)# include m1

394

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

list

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

LISTlist <name> {host <ip-address>...|include <list-name>...|interface <name>...|prefix <ip-address/prefix-length>...

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure lists, which can be used within match-lists and NAT pools.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLE

Ex 1:Lists may also include other lists by referencing the other list's name, effectively extending the list by combining the elements in the other list as shown below:

ALU(config)# list l2 prefix 10.0.0.0/8 prefix 20.0.0.0/8

ALU(config)# list l1 include l2 interface FastEthernet 0

ALU(config)# list l1 include l2 prefix 20.0.0.0/8

Parameter Description

list <name> Name of the list configured.

host <ip-address>...

Host addresses that are to be grouped.

include <list-name>...

List names to be concatenated with the present list configured.

interface <name>...

Interfaces to be grouped (Only FastEthernet is supported in the current release).

prefix <ip-address/prefix-length>...

Networks to be grouped.

395Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Common Classifiers

Left running head: Chapter name (automatic)

Ex 2:In this example, there are two networks 192.168.1.0/24 and 192.168.2.0/24, which need to communicate with two other networks 192.168.18.0/24 and 192.168.19.0/24. This can be represented by CC as:

ALU(config)# list L3 prefix 192.168.1.0/24 prefix 192.168.2.0/24

ALU(config)# list L4 prefix 192.168.18.0/24 prefix 192.168.19.0/24

ALU(config)# match-list m1 ALU(config-match-list-m1)# 1 tcp list L3 list L4 service telnet ALU(config-match-list-m1)# 2 udp list L3 list L4 service snmp

Ex 3:The example below specifies lists of interfaces and subnets. These lists can be used in the match-lists for specific applications.

ALU(config)# list l1 interface FastEthernet 0 interface Vlan 1ALU(config)# list L2 prefix 192.168.12.0/24 prefix 192.168.13.0/24

ALU(config)# match-list m1ALU(config-match-list-m1)#1 udp list L1 list L2 service snmp

396

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

match-list

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

MATCH-LISTmatch-list <name>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure a match-list. This enters Match-list Configuration Mode.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# match-list testALU(config-match-list-test)#

Parameter Description

name Name of the match-list being configured.

397Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Common Classifiers

Left running head: Chapter name (automatic)

MATCH-LISTS (RULE SETS)This command is entered in the Match-list Configuration Mode. The following command is used to configure rules for IP in a match-list:

[1-1024>] ip {any|host <source ip-address>|interface <name>|list <name>|prefix <source ip-address/prefix length>} {any|host <destination ip-address>|interface <name>|list <name>|prefix <destination ip-address/prefix length>} [dscp {<0-63>|<dscp-mnemonics>}|fragment|ip-precedence {<0-7>|<precedence-mnemonics>}|length {<1-1500> |{eq|ge|gt|le|lt|range <1-1500>}}|tos {<0-15>|<tos-mnemonics>}]

This command is entered in the Match-list Configuration Mode. The following command is used to configure rules for TCP in a match-list:

[<1-1024>] tcp {any|host <source ip-address>|interface <name>|list <name>|prefix <source ip-address/prefix length>} {any|host <destination ip-address>|interface <name>|list <name>|prefix <destination ip-address/prefix length>} [ack|dscp {<0-63>|<dscp-mnemonics>}|established|fin| fragment|from <1-65536>|ip-precedence {<0-7>|<precedence-mnemonics>}|length {<1-1500> |{eq|ge|gt|le|lt|range <1-1500>}} |rst|service {<1-65536>|<protocol>}|syn|urg|tos {<0-15>|<tos-mnemonics>}|type {ftp|normal|rpc|rtcp |rtp|sip|tftp}]

This command is entered in the Match-list Configuration Mode. The following command is used to configure rules for UDP in a match-list:

[<1-1024>] udp {any|host <source ip-address>|interface <name>|list <name>|prefix <source ip-address/prefix length>} {any|host <destination ip-address>|interface <name>|list <name>|prefix <destination ip-address/prefix length>} [dscp {<0-63>|<dscp-mnemonics>}|fragment|from <1-65536>|ip-precedence {<0-7>|<precedence-mnemonics>}|length {<1-1500>|{eq|ge|gt|le|lt|range <1-1500>}}|service {<1-65536> |<protocol>}|tos {<0-15>|<tos-mnemonics>}|type {ftp|normal |rpc|rtcp|rtp|sip|tftp}]

398

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

match-lists (rule sets)

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

This command is entered in the Match-list Configuration Mode. The following command is used to configure rules for ICMP in a match-list:

[<1-1024>] icmp {any|host <source ip-address>|interface <name>|list <name>|prefix <source ip-address/prefix length>} {any|host <destination ip-address>|interface <name>|list <name>|prefix <destination ip-address/prefix length>} [dscp {<0-63>|<dscp-mnemonics>|fragment|icmp-type <0-255> [icmp-subtype <0-255>]|ip-precedence {<0-7>|<precedence-mnemonics>}|length {<1-1500>|{eq|ge|gt|le|lt|range <1-1500>}}|tos {<0-15>|<tos-mnemonics>}]

This command is entered in the Match-list Configuration Mode. The following command is used to configure rules using the protocol numbers:

[<1-1024>] protocol <1-65535> {any|host <source ip-address> |interface <name> |list <name>|prefix <source ip-address/prefix length>} {any|host <destination ip-address>|interface <name>|list <name>|prefix <destination ip-address/prefix length>} [dscp {<0-63>|<dscp-mnemonics>|fragment|ip-precedence {<0-7>|<precedence-mnemonics>} |length {<1-1500> |{eq|ge|gt|le|lt|range <1-1500>}} |tos {<0-15>|<tos-mnemonics>}|type {ftp|normal|rpc|rtcp|rtp|sip |tftp}]

PARAMETERS

Parameter Description

1-1024 Line/Rule numbers to specify the rule priority.

ip|tcp|udp|igmp|icmp|... IP Protocol type, such as UDP, TCP, ICMP, etc.

any Indicates a wildcard match. Source being anything.

host <source ip-address> Source address.

interface <interface-name>

Name of the interface.

list <name> Name of the list.

prefix <source ip-address/prefix length>

Source address with prefix length.

host <destination ip-address>

Destination address.

prefix <destination ip-address/prefix length>

Destination address with prefix length.

dscp <0-63> <dscp-mnemonics>

Denotes the DSCP value.

399Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Common Classifiers

Left running head: Chapter name (automatic)

DEFAULT VALUE• If no protocol is specified then, IP is the default protocol.• Fields that are not referenced in the rule are by default considered a wildcard

match e.g if the protocol portion of the rule is not specified, it is automatically considered as `any' match. The keyword `any' can be used to indicate a wildcard match.

• Rules start with Line number 1 and follow a sequential order.

EXAMPLEALU(config-match-list-test)# 1 ip any any

ALU(config-match-list-test)# 10 tcp host 1.1.1.1 any from 6050

ALU(config-match-list-test)# 1 udp list L3 list L4 service tftp

ALU(config-match-list-test)# 2 icmp any any icmp-type 1

ALU(config-match-list-test)# 10 protocol 1 any any dscp 10

fragment Used to match an IP fragment.

ip-precedence <0-7> <precedence-mnemonics>

Specifies the IP Precedence.

length {<1-1500>|{eq|ge |gt|le|lt|range <1-1500>}

Specifies a packet length. Packet lengths can be expressed as values, a range of values, or other comparatives such as gt (greater than), lt (less than) etc.

tos <0-15> <tos-mnemonics>

Specifies IP Type Of Service.

type {ftp|normal |rpc|rtcp|rtp|sip|tftp}

Service type used by the ALGs.

icmp-type <0-255> [icmp-subtype <0-255>]

When ICMP is specified as the protocol, the ICMP type and subtype can be included in the rule specification. The subtype names available are dependent upon the ICMP type specified.

ack|established|fin|rst|syn|urg

Denotes the session state and TCP flags.

from <1-65536> Source port for a TCP or UDP protocol.

service {<1-65536>|<protocol>}

Destination port for a TCP or UDP protocol.

Parameter Description

400

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

no include

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NO INCLUDE no include <match-list name>

DESCRIPTION

This command is entered in the specific Match-list Configuration Mode. This command is used to delete the match-list, that is included in another match-list.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLE ALU(config)# match-list m2ALU(config-match-list-m2)# 1 tcp any any service sshALU(config-match-list-m2)# 2 udp prefix 22.1.1.0/8 anyALU(config-match-list-m2)# 3 include m1

Now, to delete the included match-list, use the ‘no include’ command: ALU(config-match-list-m2)# no include m1

NO LISTno list <name>

DESCRIPTION

This command is entered in the Configuration Mode. This command deletes the list with reference to its name. If a list is in use, it cannot be deleted. The deletion of lists cannot be globally applied to all the lists that are configured. They can be deleted only one at a time.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLE ALU(config)# no list L1

Parameter Description

match-list name Name of the match-list.

Parameter Description

name Name of the list, which has to be deleted.

401Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Common Classifiers

Left running head: Chapter name (automatic)

NO MATCH-LISTno match-list <name>

DESCRIPTION

This command is entered in the Configuration Mode. This command deletes the match-list with reference to its name. If a match-list is in use, it cannot be deleted. The deletion of match-lists, as in case of lists, cannot be globally applied to all the match-lists that are configured. They can be deleted only one at a time.

PARAMETER

DEFAULT VALUE

None.

EXAMPLE ALU(config)# no match-list M1

NO RULEno rule <1-1024>

DESCRIPTION

This command is entered in the Match-list Configuration Mode. This command deletes a rule from the match-list, with reference to its line / rule number.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLE ALU(config)# match-list m1ALU(config-match-list-m1)# 10 tcp host 1.1.1.1/32 any from 6050 to 80

Now, to delete the rule having rule number 10, use the ‘no rule’ command:ALU(config-match-list-m1)# no rule 10

Parameter Description

name Name of the match-list, which has to be deleted.

Parameter Description

1-1024 Line/Rule number corresponding to the rule that has to be deleted.

402

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show include

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW INCLUDEshow include

DESCRIPTION

This command is entered within the Match-list Configuration Mode to display all the match-lists which are included/nested with the match-list under consideration.

PARAMETERS

None.

EXAMPLE

The following example displays the details of match-list m1:ALU(config-match-list-m2)# show include

match-list m1 1 tcp any any service ssh 2 udp prefix 22.1.1.0/8 any

SHOW LISTshow list [<name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the details of all the lists that are configured. Specify the list name to view the details of a specific list.

PARAMETERS

EXAMPLE The following example displays details of all the lists configured:

ALU(config)# show listlist l1 host 5.5.5.5 host 4.4.4.4 prefix 6.6.6.0/24list l2 host 5.3.4.6 prefix 1.10.10.0/24

The following example displays the details of the list L1 and L2 configured:ALU(config)# show list l1list l1 host 5.5.5.5 host 4.4.4.4 prefix 6.6.6.0/24

ALU(config)# show list l2list l2 host 5.3.4.6 prefix 1.10.10.0/24

Parameter Description

name Name of the list whose details is to be viewed.

403Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Common Classifiers

Left running head: Chapter name (automatic)

SHOW MATCH-LISTshow match-list [<name>]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Match-list Configuration Mode. This command displays the details of all the match-lists that are configured. Specify the match-list name to view the details of a specific match-list.

PARAMETERS

EXAMPLE

The following example displays details of all the match-lists configured:

ALU(config-match-list-m1)# show match-listmatch-list m11 icmp any any2 tcp any any service http3 ip any any

match-list m21 tcp any any service ssh

match-list m31 udp any any

The following example displays the details of match-lists m1and m2:

ALU(config-match-list-m1)# show match-list m1match-list m1 1 icmp any any 2 tcp any any service http 3 ip any any

ALU(config-match-list-m1)# show match-list m2match-list m2 1 tcp any any service ssh 2 udp any any

Parameter Description

name Name of the match-list whose details is to be viewed.

404

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show rule

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW RULEshow rule <1-1024>

DESCRIPTION

This command is entered in the Match-list Configuration Mode to display the details of the rule corresponding to the line/rule number specified.

PARAMETERS

EXAMPLE

The following example displays the details of the rule in line number 2:ALU(config-match-list-m1)# show rule 22 udp prefix 22.1.1.0/8 any

The following example displays the details of the rule in line number 1:ALU(config-match-list-m1)# show rule 11 tcp any any service ssh

Parameter Description

1-1024 Line/Rule number of the rule in the match-list whose details is to be viewed.

405Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Common Classifiers

Left running head: Chapter name (automatic)

406

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

For final production, import color definitions from\\daldoc01\docteam\templates\framemaker\book-template\color-defs\ production-colors.fm. Do not import other template elements such as page layout.

To return to the draft version, import color def’ns from draft-colors.fm.To switch to the beta version, import color def’ns from beta-colors.fm

For final production, import color definitions from\\daldoc01\docteam\templates\framemaker\book-template\color-defs\ production-colors.fm. Do not import other template elements such as page layout.

To return to the draft version, import color def’ns from draft-colors.fm.To switch to the beta version, import color def’ns from beta-colors.fm

Optional footer: Manual title (to set, redefine ManualTitlevariable)

agination: umeric & ntinuous

PNco

Part 5 Routing Protocols

Beta BetaAlcatel-Lucent

407

Beta Betawith preceding section of book

OmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Left running head: Chapter name (automatic)

408

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Protocol Independent Features

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 22 PROTOCOL INDEPENDENT FEATURES

This chapter lists the protocol independent commands that are generic across all routing protocols. You are required to have a thorough knowledge of this chapter before you proceed to configure the RIP, OSPF and BGP.

It includes tables of parameters, default values, and configuration examples. The commands are described in alphabetical order. For more detailed information about the command parameters, refer to the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

409Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Protocol Independent Features

Left running head: Chapter name (automatic)

ACCESS-LIST (EXTENDED)access-list {<100-199>|<2000-2699>} {deny|permit} {<0-255> |gre|icmp|ip|ipinip|pim|rsvp|tcp|udp} {source-ip-address [source-network-number]|source-ip-address/prefix-length |any|host <source-host-ipaddress>} {destination-ip-address [destination-network-number]|destination-ip-address/prefix-length|any|host <destination-host-ipaddress>}[log]

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure a Extended Access-list. Extended Access-list uses both source IP address and destination IP address.

PARAMETERS

Parameter Description

<100-199>|<2000-2699> Access list number.

0-255 IP protocol number. Access list is applied only If packet belongs to the specified protocol number.

deny Denies access for matching conditions.

permit Permits access for matching conditions.

gre|icmp|ipinip|pim|rsvp|tcp|udp

Access list is applied only If packet belongs to the specified protocol.

source-ip-address [source-network-number]

Source IP address network.

source-ip-address/prefix-length

Source IP address network.

any From any network.

host Specify single host IP address.

source-host-ipaddress Source IP address.

destination-ip-address [destination-network-number]

Destination IP address network.

destination ip-address/prefix-length

Destination IP address network.

destination-host-ipaddress

Destination IP address.

log If access list is matched, logs the message.

410

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

access-list (standard)

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

DEFAULT VALUE

By default, no access list is configured.

EXAMPLE

ALU(config)# access-list 101 permit ip 162.168.0.0 255.255.0.0 170.170.0.0 255.255.0.0

ACCESS-LIST (STANDARD)access-list {<1-99>|<1300-1999>} {deny|permit} {source-ip-address <network-number>|ip-address/prefix-length|any|host <host-ipaddress>}[log]

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure a Standard Access-list. Standard Access-list uses only source IP address.

PARAMETERS

DEFAULT VALUE

By default, no access list is configured.

EXAMPLEALU(config)# access-list 1 deny 1.0.0.0/8

ALU(config)# access-list 2 permit 20.0.0.0/8

Parameter Description

{<1-99>|<1300-1999>}

Access list number.

deny Denies access for matching conditions.

permit Permits access for matching conditions.

source-ip-address <network-number>

Source IP address network.

ip-address/prefix-length

Source IP address network.

any Match all source network.

host-ipaddress Match only specified IP address.

log If access list is matched, logs the message.

411Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Protocol Independent Features

Left running head: Chapter name (automatic)

CLEAR IP ROUTEclear ip route {*|vrf <vrf-name>}

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command clears all routes from the IP routing table. This will not clear static routes.

PARAMETERS

EXAMPLEALU# clear ip route *

DEFAULT-METRICdefault-metric <metric-value>

DESCRIPTION

This command is entered in the Route Configuration Mode. This command causes the current routing protocol to use the same metric value for all redistributed routes (BGP, OSPF, RIP).

PARAMETERS

DEFAULT VALUE

This command is disabled by default.

EXAMPLEALU(config-router ospf1)# default-metric 10

Parameter Description

* Clears all the routes from the IP routing table.

vrf-name Name of the VRF. If VRF is specified, it clears the IP routing table for the specified VRF.

Parameter Description

1-4294967295 Default metric value appropriate for the specified routing protocol.

412

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

distance

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

DISTANCEdistance <1-255> [[ip-address subnet-mask|ip-address/prefix-length][<1-99>|<1300-1999>]]

DESCRIPTION

Enter the above command in Router Configuration Mode. This command is used to define an administrative distance for RIP or OSPF or BGP.

PARAMETERS

DEFAULT VALUE

RIP - The default distance is 120.

OSPF - The default distance is 110.

BGP - The default distance is 20 for EBGP and 200 for IBGP.

EXAMPLEALU(config-router rip)# distance 130 10.0.0.0/8 20

ALU(config-router ospf 1)# distance 60 10.0.0.0/8

ALU(config-router bgp AS1)#distance bgp 30 10 5

Parameter Description

1-255 Sets the administrative distance for RIP or OSPF or BGP external routes.

[<ip-address subnet-mask|<ip-address/prefix-length>]

IP address with subnet mask.

1-99 Standard IP access list number.

1300-1999 Standard IP access list number.

413Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Protocol Independent Features

Left running head: Chapter name (automatic)

DISTANCE BGPdistance bgp <1-255> <1-255> <1-255>

DESCRIPTION

This command is entered in the Address Family or Router Configuration Mode. This command is used to configure distance for external, internal, and local routes.

PARAMETERS

DEFAULT VALUE• external-distance: 20• internal-distance: 200• local-distance: 200

EXAMPLE

ALU(config-router bgp AS1)#distance bgp 15 50 10

Parameter Description

1-255 External Distance - Sets the administrative distance for BGP external routes. External routes are those routes that are those learned from a neighbor external to the autonomous system. You can specify a value between 1 - 255. Routes with a distance of 255 are not installed in the routing table.

1-255 Internal Distance - Defines the administrative distance for BGP internal routes. Internal routes are those routes that are learned from another BGP entity within the same autonomous system. You can specify a value between 1 - 255. Routes with a distance of 255 are not installed in the routing table.

1-255 Local Distance - Administrative distance for BGP local routes. Local routes are those networks added using the network command or those that are being redistributed from another routing protocol. You can specify a value between 1 - 255. Routes with a distance of 255 are not installed in the routing table.

414

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

distance ospf

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

DISTANCE OSPFdistance ospf {external|inter-area|intra-area} <1-255>}}

DESCRIPTION

This command is entered in the Router Configuration Mode. This command performs the same function as the distance command used with an access list. However, the distance OSPF command allows you to set a distance for an entire group of routes, rather than a specific route that matches an access-list.

PARAMETERS

DEFAULT VALUE

Default administrative distance for all OSPF routes is 110.

EXAMPLEALU(config-router ospf 1)# distance ospf external 10

Parameter Description

external Distance for external routes.

inter-area Distance for inter-area routes.

intra-area Distance for intra-area routes.

1-255 Administrative distance.

415Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Protocol Independent Features

Left running head: Chapter name (automatic)

DISTRIBUTE-LISTdistribute-list {<1-199>|<1300-2699>|<access-list-name>|prefix <prefix-list>} {in|out}

Enter the above command in BGP Router Configuration Mode. This command permits or denies routes from being advertised in routing updates depending upon the action listed in the access list.

distribute-list {<1-199>|<1300-2699>|gateway <ip-prefix-list name>|prefix <ip-prefix-list name>} {in|out} [<interface-name>]

Enter the above command in RIP Router Configuration Mode. This command suppresses networks from being advertised in routing updates. The distribute-list in command is used to filter networks in received routing updates.

Note: OmniAccess 5510 USG does not support the Distribute-list feature in OSPF.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-router bgp AS1)# distribute-list 1 in

ALU(config-router rip)# distribute-list prefix prefix-example in FastEthernet 0

Parameter Description

1-199 Standard IP access list number. The list defines which networks are to be received and which are to be suppressed in routing updates.

1300-2699 Extended IP access list number. The list defines which networks are to be received and which are to be suppressed in routing updates.

access-list-name IP access list name.

prefix-list Prefix list name.

ip-prefix-list name IP prefix list name.

in Applies the access list to incoming routing updates.

out Applies the access list to outgoing routing updates.

interface-name Name of the interface.

416

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ip access-list extended

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IP ACCESS-LIST EXTENDEDip access-list extended {<100-199>|<2000-2699>|<access-list-name>}

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to define a named access list, and enters Extended Access-list Configuration Mode.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# ip access-list extended test ALU(config-ext-nacl)#

Configure Extended IP Access-list Rule

This command is used to configure a rule for a Extended IP Access-List. You can configure multiple rules for an IP access list.

{permit|deny} {igre|icmp|ip|ipinip|pim| rsvp|tcp|udp|<0-255>} {any|host <host-ip-address>|<source-ip-address/prefix-length>|<source-ip-address subnet-mask>} [operators] {any|host <host-ip-address>|<destination-ip-address/prefix-length>|<destination-ip-address subnet-mask>} [log] [log-input] [enable fragment] [precedence [<0-7>|<keywords>] [tos [<0-15>|<keywords>]]]

Parameter Description

<100-199>|<2000-2699>

IP access list number.

access-list-name Name of the access list.

Parameter Description

permit Result is permit if conditions are matched.

{igre|icmp|ip|ipinip|pim|rsvp| tcp|udp|<0-255>}

Name or number of an Internet protocol. If a protocol is not specified, the access-list entry applies to all protocols.

deny Result is deny if conditions are matched.

any Match any source or destination IP address.

417Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Protocol Independent Features

Left running head: Chapter name (automatic)

Example:ALU(config-ext-nacl)# permit ip 24.0.0.0/8 25.0.0.0/8

ALU(config-ext-nacl)# deny ip any 13.0.0.0/8

host <host-ip-address>

Specify host IP address.

<source-ip-address/prefix-length>|<source-ip-address subnet-mask>

Source IP address network.

operators This is specific to UDP and TCP protocol. Compares TCP/UDP ports of the source/destination ports. When used after the source IP address/source-mask, specifies a source port. When used after the destination IP address/destination mask, specifies a destination port.

<destination-ip-address/prefix-length>|<destination-ip-address subnet-mask>

Destination IP address network.

log By default, log the message.

log-input If access list is matched, log the message.

enable fragment Enable access list matching for fragmented packets.

precedence [<0-7>|<keywords>]

Match access list if specified precedence matches packet.

tos [<0-15> |<keywords>

Match access list if specified ToS matches packet.

Parameter Description

418

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ip access-list standard

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IP ACCESS-LIST STANDARDip access-list standard {<1-99>|<1300-1999>|<access-list-name>}

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to define a named access list, and enters Standard Access-list Configuration Mode.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# ip access-list standard test ALU(config-std-nacl)#

Configure Standard IP Access-list Rule

This command is used to configure a rule for a Standard IP Access-List. You can configure multiple rules for an IP access list.

{permit|deny} {any|host <host-ip-address>|<ip-address/prefix-length>|<ip-address subnet-mask>}[log]

Example:ALU(config-std-nacl)# permit host 10.0.0.1

ALU(config-std-nacl)# permit 11.0.0.0/8

Parameter Description

<1-99>|<1300-1999>

IP access list number.

access-list-name Name of the access list.

Parameter Description

permit Result is permit if conditions are matched.

deny Result is deny if conditions are matched.

host <host-ip-address>

Specify host IP address.

<ip-address/prefix-length>|<ip-address subnet-mask>

Source IP address network.

log If access list is matched, log the message.

419Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Protocol Independent Features

Left running head: Chapter name (automatic)

IP AS-PATH ACCESS-LISTip as-path access-list <1-199> {deny|permit} <regular-expression>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure AS-path Access-list.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLE

In the following example, the ‘ip as-path access-list’ command creates an as-path access list named '1' to deny only those routes that include paths from or through autonomous systems 100:

ALU(config)# ip as-path access-list 1 deny _100_

Parameter Description

1-199 Number that indicates the regular expression access list number.

deny Denies access for matching conditions.

permit Permits access for matching conditions.

regular-expression

Regular expression.

420

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ip community-list (extended)

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IP COMMUNITY-LIST (EXTENDED)ip community-list <100-199> {deny|permit} <regular-expression>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure a Extended Community-list.

PARAMETERS

DEFAULT VALUE

None.

Parameter Description

100-199 Extended community list number.

deny Denies access for matching conditions.

permit Permits access for matching conditions.

regular-expression

Regular expression.

421Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Protocol Independent Features

Left running head: Chapter name (automatic)

IP COMMUNITY-LIST (STANDARD)ip community-list <1-99> {deny|permit} [<1-4294967295>| <AA:NN>|internet|local-AS|no-advertise|no-export]

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure a Standard Community-list. Creates a community-list for BGP, and controls access to it.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# ip community-list 1 permit internet

Parameter Description

1-99 Standard community list number.

deny Denies access for matching conditions.

permit Permits access for matching conditions.

1-4294967295 Community number.

AA:NN Community number in aa:nn format.

internet If this attribute is set, router advertises this route to all the BGP peers.

local-AS If this attribute is set, router advertises this route to all the BGP peers in the same autonomous system.

no-advertise If this attribute is set, router does not advertise this route to any BGP peers.

no-export Specifies that the routes with this community attribute will not be advertised to any EBGP peer.

422

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ip prefix-list

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IP PREFIX-LISTip prefix-list <name> [seq <1-4294967294>] {{deny|permit} <ip-address/prefix-length> {ge|le} <0-32>|description <line>}

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure a Prefix-list.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLE

In the following example, permit updates for any network with a prefix mask length less than or equal to 23. Denies all network updates with a network mask length greater than 23:

ALU(config)# ip prefix-list test permit 0.0.0.0/0 le 23

Parameter Description

name Prefix-list name.

1-4294967294 Specifies the sequence number to prefix the list entry being created or deleted.

deny Denies access for matching conditions.

permit Permits access for matching conditions.

<ip-address/prefix-length>

The IP address and prefix length of the network.

ge Specifies prefix length. The prefix list will be applied if the prefix length is greater than or equal to the ‘ge’ prefix length.

le Specifies prefix length. The prefix list will be applied if the prefix length is less than or equal to the ‘le’ prefix length.

0-32 Prefix length.

line Description of prefix list.

423Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Protocol Independent Features

Left running head: Chapter name (automatic)

IP ROUTEip route {vrf <name>|destination network subnet-mask|destination network/prefix-length} {<gateway-ip-address>|<interface-name> [<gateway-ip-address>]}[<1-255>]

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure a static route.

PARAMETERS

DEFAULT VALUE

By default, no static route is configured.

EXAMPLEALU(config)# ip route 1.1.1.1/24 2.2.2.2

Parameter Description

vrf <name> Name of the VRF.

{destination network subnet-mask|destination network/prefix-length}

The IP address and prefix length of the destination.

gateway-ip-address

IP address of the next hop.

interface name Name of the next hop interface.

1-255 An administrative distance of the route.

424

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ip tcp adjust-mss

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IP TCP ADJUST-MSSip tcp adjust-mss <24-1460>

DESCRIPTION

This command is entered in the Interface Configuration Mode to set the MSS (maximum segment size) value on the packets going out of an interface.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-if FastEthernet0)# ip tcp adjust-mss 500

Parameter Description

24-1460 The maximum segment size in the range 500-1460.

425Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Protocol Independent Features

Left running head: Chapter name (automatic)

IP UNNUMBEREDip unnumbered <interface-name>

DESCRIPTION

This command is entered in the Interface Configuration Mode.

This command is used to configure an interface to be an unnumbered interface and associate a numbered IP interface with it. Use of this command results in the IP address being shared by two interfaces.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLE

Configuring an ATM sub-interface to be an unnumbered interface. The IP address configured on the FastEthernet 0 interface is also assigned to the interface ATM 0.1, and both interfaces involved function normally.

ALU(config)# interface atm 0ALU(config)# interface atm 0.1ALU(config-subif atm0.1)# encapsulation pppoeALU(config-subif atm0.1)# ip unnumbered FastEthernet 0

Configuring Ethernet as an unnumbered interface throws up an error:ALU(config)# interface FastEthernet 0ALU(config-if FastEthernet0)# ip unnumbered Loopback 0Point-to-point interfaces only

Parameter Description

interface-name Name of another interface in the system that has an IP address, not another unnumbered interface.

426

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

match as-path

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

MATCH AS-PATHmatch as-path <1-199>

DESCRIPTION

This command is entered in the Route-map Configuration Mode. This command matches a BGP autonomous system path access list.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLE

ALU(config-route-map)# match as-path 1

MATCH COMMUNITYmatch community [<1-99>] [<100-199>] [exact-match]

DESCRIPTION

This command is entered in the Route-map Configuration Mode. This command matches a BGP community-list.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-route-map)# match community 1

Parameter Description

1-199 Specify the autonomous system path access list number.

Parameter Description

1-99 Standard community list number.

100-199 Extended community list number.

exact-match Indicates that exact match is required.

427Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Protocol Independent Features

Left running head: Chapter name (automatic)

MATCH INTERFACEmatch interface <interface-name>

DESCRIPTION

This command is entered in the Route-Map Configuration Mode. This command matches the specified next hop route out of one of the interfaces specified.

PARAMETERS

DEFAULT VALUE

No match interfaces are defined.

EXAMPLEALU(config-route-map)# match interface FastEthernet 0

MATCH IP ADDRESSmatch ip address {<1-99>|<1300-2699>|<access-list name>|prefix-list <prefix-list name>}

DESCRIPTION

This command is entered in the Route-map Configuration Mode. This command is used to match a destination network number address that is permitted by a standard access list, an extended access list, or a prefix list, or perform policy routing on packets.

PARAMETERS

DEFAULT VALUE No access list numbers or prefix lists are specified.

EXAMPLEALU(config-route-map)# match ip address prefix-list testprefix

Parameter Description

interface-name Name of the interface.

Parameter Description

1-99 Standard IP access list number. The list defines which networks are to be permitted or denied.

1300-2699 Extended IP access list number. The list defines which networks are to be permitted or denied.

access-list name Name of a specific access list.

prefix-list-name Name of a prefix list.

428

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

match ip next-hop

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

MATCH IP NEXT-HOPmatch ip next-hop {<1-99>|<1300-2699>|<access-list name>|prefix-list <prefix-list name>}

DESCRIPTION

This command redistributes any routes that have a next hop router address passed by one of the specified access lists. This command is entered in the Route-Map Configuration Mode.

PARAMETERS

DEFAULT VALUE

Routes are distributed freely without being required to match a next hop address.

EXAMPLEALU(config-route-map)# match ip next-hop 1

Parameter Description

1-99 Standard IP access list number or name. The list defines which networks are to be received and which are to be suppressed in routing updates.

1300-2699 Extended IP access list number or name. The list defines which networks are to be received and which are to be suppressed in routing updates.

prefix-list Distributes routes based on a prefix list.

access-list name Name of a specific access list.

prefix-list-name Name of a specific prefix list.

429Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Protocol Independent Features

Left running head: Chapter name (automatic)

MATCH IP ROUTE-SOURCE match ip route-source {<1-99>|<1300-2699>|<access-list name>|prefix-list <prefix-list name>}

DESCRIPTION

This command is entered in the Route-Map Configuration Mode. This command matches the address specified by the specified advertised access lists/prefix-lists.

PARAMETERS

DEFAULT VALUE None.

EXAMPLEALU(config-route-map)# match ip route-source 5

Parameter Description

1-99 Standard IP access list number or name. The list defines which networks are to be received and which are to be suppressed in routing updates.

1300-2699 Extended IP access list number or name. The list defines which networks are to be received and which are to be suppressed in routing updates.

prefix-list Distributes routes based on a prefix list.

access-list name Name of a specific access list.

prefix-list-name Name of a specific prefix list.

430

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

match metric

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

MATCH METRICmatch metric <0-4294967295>

DESCRIPTION

This command is entered in the Route-Map Configuration Mode. This command matches the specified metric.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-route-map)# match metric 10

MAXIMUM-PATHS maximum-paths <number of paths>

DESCRIPTION

This command is entered in the Router Configuration Mode. This command is used to configure the maximum number of parallel paths to be allowed in a routing table.

PARAMETERS

DEFAULT VALUE

By default, OSPF, BGP and Static routes can install a maximum number of 16 ECMP paths. And, RIP installs maximum 8 ECMP paths.

EXAMPLEALU(config-router ospf 1)# maximum-paths 5

Parameter Description

0-4294967295 Route map result is permit if route metric matches the specified metric.

Parameter Description

number-of-paths Maximum number of parallel routes an IP routing protocol installs in a routing table, in the range from 1 to 6.

431Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Protocol Independent Features

Left running head: Chapter name (automatic)

MATCH ROUTE-TYPE match route-type {external [{type-1|type-2}]|internal|local |nssa-external}

DESCRIPTION

This command is entered in the Route-Map Configuration Mode. This command matches the specified route type.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-route-map)# match route-type external type-2

NO PASSIVE-INTERFACEno passive-interface <interface-name>

DESCRIPTION

This command is entered in the Router Configuration Mode. This command activates only those interfaces that need to have adjacencies set.

PARAMETERS

DEFAULT VALUE None.

EXAMPLEALU(config-router ospf1)# no passive-interface FastEthernet 0

Parameter Description

{external [{type-1|type-2}]

OSPF external routes. The external type-1 keyword matches only Type 1 external routes and the external type-2 keyword matches only Type 2 external routes.

internal OSPF intra-area and inter-area routes internal routes.

local Locally generated BGP routes.

nssa-external NSSA external route (OSPF Type 1 or 2).

Parameter Description

interface-name Name of the interface.

432

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

no ip tcp adjust-mss

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NO IP TCP ADJUST-MSSno ip tcp adjust-mss <24-1460>

This command is entered in the Interface Configuration Mode. This command removes the MSS configuration on the interface.

NO IP UNNUMBEREDno ip unnumbered <interface-name>

This command is entered in the Interface Configuration Mode. This command is used to unconfigure the unnumbered interface.

PASSIVE-INTERFACEpassive-interface <interface-name>

DESCRIPTION

This command is entered in the Router Configuration Mode. This command suppresses sending of routing updates through the specified interface.

PARAMETERS

DEFAULT VALUE Routing updates are sent on the interface.

EXAMPLEALU(config-router ospf1)# passive-interface FastEthernet 0

Parameter Description

interface-name Name of the interface.

433Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Protocol Independent Features

Left running head: Chapter name (automatic)

PASSIVE-INTERFACE DEFAULTpassive-interface default

DESCRIPTION

This command is entered in the Router Configuration Mode. This command sets all interfaces as passive by default.

PARAMETERS

DEFAULT VALUE By default, all interfaces are active.

EXAMPLEALU(config-router ospf1)# passive-interface default

Parameter Description

default All interfaces become passive.

434

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

redistribute

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

REDISTRIBUTEThis command is entered in the OSPF Router Configuration Mode. The following command is used to redistribute routes to OSPF:

redistribute {connected|static|bgp <1-65535>|ospf <1-65535>} [metric <0-16777214>|metric-type <1-2>|route-map <name>|tag <0-4294967295>|subnets]

This command is entered in the RIP Router Configuration Mode. The following command is used to redistribute routes to RIP:

redistribute {bgp <1-65535>|connected| ospf <1-65535> [match {{external|nssa-external}[1|2]|internal}]|static} [metric {<1-16>|transparent}|route-map <name>]

Note: Currently, while redistributing BGP/OSPF routes to RIP, metric parameter has to be configured.

This command is entered in the BGP Router Configuration Mode. The following command is used to redistribute routes to BGP:

redistribute {{connected|static|rip} [metric <0-4294967295>|weight <0-65535>|route-map <name>]|ospf <1-65535> [match [external [type1|type2] |internal|nssa-external [type1|type2]] metric <0-4294967295>|weight [0-65535]|route-map <name>]}

DESCRIPTION

This command is entered in the Router Configuration Mode.

PARAMETERS

Parameter Description

connected Redistribute the connected routes.

static Redistribute the static routes.

bgp <1-65535> If Redistribute is configured for RIP/OSPF, BGP routes are redistributed to RIP/OSPF.

ospf <1-65535> If Redistribute is configured for BGP/RIP/OSPF, OSPF routes are redistributed to BGP/RIP/OSPF.In case of OSPF, source protocol process ID and destination protocol process ID should not be same.

metric-type <1-2>

Redistributed routes metric type.

route-map <name> Use route map for route filtering and modifying attributes of the routes.

435Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Protocol Independent Features

Left running head: Chapter name (automatic)

DEFAULT VALUE

None.

EXAMPLEALU(config-router ospf 1)#redistribute static metric 19 metric-type 1

ALU(config-router rip)#redistribute bgp 1 route-map test

ALU(config-router bgp AS1)#redistribute ospf 1 route-map testospf weight 10

tag <0-4294967295>

Specified tag is assigned to redistributed routes.

subnets Redistribute only subnet routes.

external [1|2] Redistribute route if route is external type 1 or type 2.

nssa-external [1|2]

Redistribute route if route is nssa external type 1 or type 2.

metric Assigns the specified metric to redistributed routes.

transparent If this keyword is specified, uses routing table metric to redistributed routes. This is specific to RIP.

weight <0-65535> Assigns the specified weight to redistributed routes. This is specific to BGP.

Parameter Description

436

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

route-map

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

ROUTE-MAProute-map <name> [permit|deny] [<1-65535>]

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure route maps to control route redistribution. It is also used in BGP to set/match community, as-path list, etc.

PARAMETERS

DEFAULT VALUE

Default route map action is permit.

EXAMPLEALU(config)# route-map ospf-to-eigrp permit 20

Parameter Description

name Name of the route map. All route maps command use this name to reference this route map.

permit If the match criteria are met for this route map, and the permit keyword is specified, the route map result is permit. If the match criteria are not met, and the permit keyword is specified, the next route map with the same map name is tested. If a route passes none of the match criteria for the set of route maps sharing the same name, the result of route map is deny.

deny If the match criteria are met for the route map and the deny keyword is specified, the route map result is deny. And no further route maps sharing the same map name will be examined.

1-65535 Sequence number that indicates the position a new route map will have in the list of route maps already configured with the same name. If given with the no form of this command, the position of the route map should be deleted. This sequence number signifies the priority of a route-map rule.

437Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Protocol Independent Features

Left running head: Chapter name (automatic)

SET AS-PATHset as-path {tag|prepend [<1-65535>]}

DESCRIPTION

This command is entered in the Route-Map Configuration Mode. This command modifies the BGP autonomous system path.

PARAMETERS

DEFAULT VALUE Autonomous system path is not specified.

EXAMPLEALU(config-route-map)# set as-path tag

Parameter Description

tag Converts the tag of a route into an autonomous system path. This is applicable only when routes are redistributed into BGP.

prepend [<1-65535>]

Appends the string following the keyword prepend to the autonomous system path of the route that is matched by the route-map. Applies to inbound and outbound BGP route maps.

438

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

set community

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SET COMMUNITYset community {<1-4294967295>|AA:NN|additive|local-as|no-advertise|no-export|none}

DESCRIPTION

This command is entered in the Route-Map Configuration Mode. This command sets the community attribute.

PARAMETERS

DEFAULT VALUE No BGP communities attributes exist.

EXAMPLEALU(config-route-map)# set community 10

Parameter Description

1-4294967295 Specifies the community number.

AA:NN Community number in aa:nn format.

additive Adds the community to the already existing communities.

local-as Routes with this community attribute is advertised to the Local AS only.

no-advertise Routes with this community attribute is not advertised to any router.

no-export Specifies that the routes with this community attribute will not be advertised to any EBGP peer.

none Removes the community attribute from the prefixes that pass the route map.

439Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Protocol Independent Features

Left running head: Chapter name (automatic)

SET COMM-LISTset comm-list {<1-99>| <100-199>} delete

DESCRIPTION

This command is entered in the Route-Map Configuration Mode. This command removes communities from the community attribute of an inbound or outbound update.

PARAMETERS

DEFAULT VALUE No communities are removed.

EXAMPLEALU(config-route-map)# set comm-list 130 delete

SET DAMPENING set dampening <1-45> <1-20000> <1-20000> <1-255>

DESCRIPTION

This command is entered in the Route-Map Configuration Mode. This command sets BGP route dampening factors.

PARAMETERS

Parameter Description

1-99 Standard community list number.

100-199 Extended community list number.

Parameter Description

1-45 Time (in minutes) after which a penalty is decreased. Once the route has been assigned a penalty, the penalty is decreased by half after the half-life period. The process of reducing the penalty happens every 5 seconds. The range of the half-life period is 1 to 45 minutes. The default is 15 minutes.

1-20000 If the penalty for a flapping route decreases enough to fall below reuse limit, router starts advertising the route. The default is 750 seconds.

440

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

set local-preference number value

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

DEFAULT VALUE By default, set dampening is disabled.

EXAMPLEALU(config-route-map)# set dampening 10 2000 2000 15

SET LOCAL-PREFERENCE NUMBER VALUEset local-preference <0-4294967295>

DESCRIPTION

This command is entered in the Route-Map Configuration Mode. This command assigns a local preference to the BGP path.

PARAMETERS

DEFAULT VALUE

By default, local preference value is 100.

EXAMPLEALU(config-route-map)# set local-preference 100

1-20000 A route becomes invalid when penalty exceeds the configured suppress limit. The default is 2000 seconds.

1-255 Maximum time (in minutes) a route can be suppressed. The default is four times the half-time value.

Parameter Description

0-4294967295 Preference value.

Parameter Description

441Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Protocol Independent Features

Left running head: Chapter name (automatic)

SET METRICset metric <0-4294967295>

DESCRIPTION

This command is entered in the Route-Map Configuration Mode. This sets the metric value to the redistributed routes. This command is normally used in route-maps for redistribution.

PARAMETERS

DEFAULT VALUE None.

EXAMPLEALU(config-route-map)# set metric 10

SET METRIC-TYPEset metric-type {internal|external|type-1|type-2}

DESCRIPTION

This command is entered in the Route-Map Configuration Mode. This command sets the metric type of the redistributed routes.

PARAMETERS

DEFAULT VALUE None.

EXAMPLEALU(config-route-map)# set metric-type type-1

Parameter Description

0-4294967295 Metric value.

Parameter Description

internal Internal metric value.

external External metric value.

type-1 OSPF external type-1 metric.

type-2 OSPF external type-2 metric.

442

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

set origin

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SET ORIGINset origin {igp|egp <1-65535>|incomplete}

DESCRIPTION

This command is entered in the Route-Map Configuration Mode. This command sets the BGP origin code.

PARAMETERS

DEFAULT VALUE For redistributed routes, origin is set to incomplete. For routes learned from IGP protocol, origin is set to IGP. The routes learned from EBGP, route origin is set to EGP.

EXAMPLEALU(config-route-map)# set origin incomplete

SET WEIGHTset weight <0-4294967295>

DESCRIPTION

This command is entered in the Route-Map Configuration Mode. Use this command to weight of route.

BGP has weight attribute. If the same route is received from multiple routers, then weight is used to give preference to some route. Route with highest weight is preferred.

PARAMETERS

DEFAULT VALUE Default weight is 0.

EXAMPLEALU(config-route-map)# set weight 10

Parameter Description

igp Set Interior Gateway Protocol as origin attribute.

egp <1-65535> Set Exterior Gateway Protocol as origin attribute.

incomplete Unknown origin.

Parameter Description

0-4294967295 Weight value.

443Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Protocol Independent Features

Left running head: Chapter name (automatic)

SHOW ACCESS-LISTSshow access-lists [<1-2699>|<access-list name>]

DESCRIPTION

This command displays the access-list configuration.

PARAMETERS

EXAMPLE

ALU# show access-lists

Standard IP access list 1

deny 1.0.0.0 0.255.255.255 (0 packets)

Standard IP access list 2

permit 20.0.0.0 0.255.255.255 (0 packets)

Extended IP access list 101

permit ip 162.168.0.0 0.0.0.0 255.255.252.0 0.0.0.0 (0 packets)

ALU#

Parameter Description

1-2699 Access list number whose configuration details are to be viewed.

access-list name Name of a specific access list whose configuration details are to be viewed.

444

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip access-lists

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW IP ACCESS-LISTSshow ip access-lists [<1-199>|<1300-2699>|<access-list name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the IP access-list configuration.

PARAMETERS

EXAMPLEALU# show ip access-lists

Standard IP access list test permit host 10.0.0.1 (0 packets) permit 11.0.0.0 0.255.255.255 (0 packets) deny 12.0.0.0 0.255.255.255 (0 packets)ALU#

SHOW IP AS-PATH-ACCESS-LISTshow ip as-path-access-list [<1-199>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the AS-path -access-list configuration.

PARAMETERS

EXAMPLEALU# show ip as-path-access-list

AS path access list 1 deny _100_ALU#

Parameter Description

1-199 Specify the standard access list number whose configuration details are to be viewed.

1300-2699 Specify the extended access list number whose configuration details are to be viewed.

access-list name Name of a specific access list whose configuration details are to be viewed.

Parameter Description

1-199 Specify the as-path access list number whose configuration details is to be viewed.

445Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Protocol Independent Features

Left running head: Chapter name (automatic)

SHOW IP COMMUNITY-LISTshow ip community-list [<1-199>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the IP Community-list configuration.

PARAMETERS

EXAMPLE

ALU# show ip community-list

Community standard access list 1 permit internetCommunity standard access list 2 permit no-exportALU#

SHOW IP PREFIX-LISTshow ip prefix-list [<prefix-list name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the IP Prefix-list configuration.

PARAMETERS

EXAMPLEALU# show ip prefix-list

ip prefix-list test seq 5 deny 10.0.0.0/8 ge 23ALU#

Parameter Description

1-199 Specify the community list number whose configuration details are to be viewed.

Parameter Description

prefix-list name Name of a specific prefix list whose configuration details are to be viewed.

446

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip protocols

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW IP PROTOCOLSshow ip protocols [vrf <vrf-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the parameters and current state of the active routing protocol process.

PARAMETERS

EXAMPLEALU# show ip protocols

Routing Protocol is "rip" Sending updates every 30 seconds, next due in 27 seconds Invalid after 180 seconds, hold down 180, flushed after 240 seconds Default redistribution metric is 3 Redistributing External Routes from: connected metric 3 static metric 4 Default version control: send version 2, receive version 2 Automatic network summarization is in effect Outgoing update filter list for all interfaces is not set Incoming update filter list for all interfaces is not set Interface Send Recv Key-chain FastEthernet 0 .... 2 2 loopback1 2 2 Routing for Networks: 1.0.0.0 4.0.0.0 Routing Information Sources: Gateway Interface Distance Last Update 1.1.1.1 FastEthernet0 ..... 115 00:00:00 Distance: (default is 120)

Field Description

vrf-name Name of the VRF.

Field Description

Routing Protocol is ‘RIP’

Specifies the routing protocol used.

Sending updates every 30 seconds

Specifies the time between sending updates.

next due in 2 seconds

Precisely when the next update is due to be sent.

Invalid after 180 seconds

Specifies the value of the invalid parameter.

447Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Protocol Independent Features

Left running head: Chapter name (automatic)

hold down for 180

Specifies the current value of the hold-down parameter.

flushed after 240

Specifies the time after which the individual routing information will be flushed out.

Outgoing update...

Specifies whether the outgoing filtering list has been set.

Incoming update...

Specifies whether the incoming filtering list has been set.

Default version control

Specifies the version of RIP packets that are sent and received.

Redistributing Lists the protocol that is being redistributed.

Routing Specifies the networks for which the routing process is currently injecting routes.

Routing Information Sources

Lists all the routing sources the Alcatel-Lucent software is using to build its routing table. For each source, you will see the following displayed:• IP address• Administrative distance• Time the last update was received from this source.

Field Description

448

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip route

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW IP ROUTEshow ip route [{network-number|ip-address/prefix length} [longer-prefixes]|ospf [<1-65535>]|connected|bgp|rip |summary|supernets-only|vrf <vrf-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the current state of a routing protocol. You can filter show IP route output to view specific protocol routes.

PARAMETERS

EXAMPLE

Example 1ALU# show ip route

Codes: R - RIP, O - OSPF, C - connected S - static, M - mcstatic, B - BGP, A - ASE IA - OSPF inter area route, E1 - OSPF external type 1 route, E2 - OSPF external type 2 route, N1 - OSPF NSSA external type 1 route, N2 - OSPF NSSA external type 2 route * - candidate default route

Gateway of last resort is 135.254.163.1 to network 0.0.0.0

S* 0.0.0.0/0 [1/0] via 135.254.163.1, Vlan2 1.0.0.0/24 is subnetted, 1 subnetO E2 1.1.1.0 [110/20][100] via 2.2.2.2, FastEthernet0C 2.0.0.0/8 [0/0] is directly connected, FastEthernet0O E2 3.0.0.0/8 [110/20][100] via 2.2.2.2, FastEthernet0 4.0.0.0/24 is subnetted, 1 subnetC 4.4.4.0 [0/0] is directly connected, Vlan3 10.0.0.0/24 is subnetted, 1 subnetO E2 10.0.0.0 [110/20][100] via 2.2.2.2, FastEthernet0S 100.0.0.0/8 [1/0] via 135.254.163.1, Vlan2S 120.0.0.0/8 [1/0] via 135.254.163.1, Vlan2 135.254.0.0/24 is subnetted, 1 subnetC 135.254.163.0 [0/0] is directly connected, Vlan2

Field Description

{network-number|ip-address/prefix length}

Displays the routing information for the given network number or IP address and prefix length.

longer-prefixes Specifies that only routes matching the IP address and mask pair should be displayed.

[ospf [<1-65535>] |connected|bgp|rip |summary|supernets-only]

Displays the output for a specific routing protocols.

vrf <vrf-name> Name of the VRF.

449Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Protocol Independent Features

Left running head: Chapter name (automatic)

Example 2

ALU# show ip route static

Codes: R - RIP, O - OSPF, C - connected S - static, M - mcstatic, B - BGP, A - ASE IA - OSPF inter area route, E1 - OSPF external type 1 route, E2 - OSPF external type 2 route, N1 - OSPF NSSA external type 1 route, N2 - OSPF NSSA external type 2 route * - candidate default route

S* 0.0.0.0/0 [1/0] via 135.254.163.1, Vlan2S 100.0.0.0/8 [1/0] via 135.254.163.1, Vlan2S 120.0.0.0/8 [1/0] via 135.254.163.1, Vlan2

Example 3

ALU# show ip route connected Codes: R - RIP, O - OSPF, C - connected S - static, M - mcstatic, B - BGP, A - ASE IA - OSPF inter area route, E1 - OSPF external type 1 route, E2 - OSPF external type 2 route, N1 - OSPF NSSA external type 1 route, N2 - OSPF NSSA external type 2 route * - candidate default route

C 2.0.0.0/8 [0/0] is directly connected, FastEthernet0 4.0.0.0/24 is subnetted, 1 subnetC 4.4.4.0 [0/0] is directly connected, Vlan3 135.254.0.0/24 is subnetted, 1 subnetC 135.254.163.0 [0/0] is directly connected, Vlan2

Example 4

ALU# show ip route summary

Route Source Networks Subnets Overhead Memory (bytes)static 3 0 126 108connected 1 2 126 108ospf 100 1 2 126 108Total 5 4 378 324

Mask distribution: 1 route at length 0 4 routes at length 8 4 routes at length 24

Example 5

ALU# show ip route supernets-only

S* 0.0.0.0/0 [1/0] via 135.254.163.1, Vlan2

450

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show route-map

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW ROUTE-MAPshow route-map [<route-map name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode.This command displays the route-map configuration.

PARAMETERS

EXAMPLEALU# show route-map

route-map test, permit, sequence 1 Description: Exit Policy: Match clauses: community (community-list filter) : 1 ip address (access-lists) : prefix-list testprefix Set clauses:route-map test, deny, sequence 2 Description: Exit Policy: Match clauses: Set clauses:ALU#

ALU# show route-map testset

route-map testset, permit, sequence 5 Description: Exit Policy: Match clauses: ip address (access-lists) : 1 Set clauses: metric 10route-map testset, permit, sequence 10 Description: Exit Policy: Match clauses: Set clauses: metric 20ALU#

Parameter Description

route-map name Name of a specific route map whose configuration details are to be viewed.

451Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Protocol Independent Features

Left running head: Chapter name (automatic)

Parameter Description

route-map Name of the route map.

permit Indicates that if match condition is satisfied, then the route-map result is permit.

sequence Number that indicates the position a new route map is to have in the list of route maps already configured with the same name.

Match clauses tag

Match criteria - conditions which needs to be matched.

Set clauses metric

Set actions - particular actions to perform if the criteria enforced by the match commands are met.

Policy routing matches

Displays the number of packets and bytes that have been filtered by policy routing.

452

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Router Information Protocol

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 23 ROUTER INFORMATION PROTOCOL

This chapter explains the function and syntax of the Router Information Protocol (RIP) commands.

It includes table of parameters, default values, and configuration examples for RIP configurations as quick-start and reference information. The commands are described in alphabetical order. For more detailed information about using and configuring the RIP, refer the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

453Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Router Information Protocol

Left running head: Chapter name (automatic)

AUTO-SUMMARY auto-summary

DESCRIPTION

This command is entered in the Router Configuration Mode. This command restores the default behavior of automatic summarization of the subnet routes into network-level routes.

PARAMETERS

None.

DEFAULT VALUE

By default, auto-summary is enabled.

EXAMPLEALU(config-router rip)# auto-summary

CLEAR IP RIP clear ip rip {database|statistics}

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. This command clears the RIP database or the RIP statistics.

PARAMETERS

EXAMPLEALU# clear ip rip database

Parameter Description

database Clears RIP database.

statistics Clears RIP statistics.

454

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

default information originate (rip)

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

DEFAULT INFORMATION ORIGINATE (RIP)default-information originate

DESCRIPTION

Enter the command in the Router Configuration Mode. This command is used to generate default route into RIP.

PARAMETERSNone.

DEFAULT VALUE

Disabled.

EXAMPLE

ALU(config-router rip)# default-information originate

DEFAULT-METRICdefault-metric <1-16>

DESCRIPTION

A default metric helps to solve the problem of redistributing routes with incompatible metrics. Whenever metrics do not convert, a default metric provides a reasonable substitute and enables the redistribution to proceed.

Enter the command in Router Configuration Mode. This command sets the default metric values of redistributed routes.

PARAMETERS

DEFAULT VALUE The metric of redistributed connected and static routes is set to 0, otherwise default metric is set to 1.

EXAMPLEALU(config-router rip)# default-metric 10

Parameter Description

1-16 Specify the default metric value.

455Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Router Information Protocol

Left running head: Chapter name (automatic)

DISTANCE distance <1-255> [[ip-address subnet-mask|ip-address/prefix-length][<1-99>|<1300-1999>]]

DESCRIPTION

Enter the command in the Router Configuration Mode. This command is used to define an administrative distance.

PARAMETERS

DEFAULT VALUE

The default distance is 120.

EXAMPLEALU(config-router rip)# distance 130 10.0.0.0/8 20

Parameter Description

1-255 Administrative distance.

ip-address subnet-mask|ip-address/prefix-length

IP address with mask or prefix length.

1-99 Access-list to be associated in the range 1-99.

1300-1999 Access-list to be associated in the range 1300-1999.

456

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

distribute-list

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

DISTRIBUTE-LISTdistribute-list {<1- 99>|<1300-2699>|gateway <ip-prefix-list name>|prefix <ip-prefix-list name>} {in|out} [<interface-name>]

DESCRIPTION

Enter the command in the Router Configuration Mode. This command suppresses networks from being advertised in routing updates.• The distribute-list in command is used to filter networks in received routing

updates. • The distribute-list out command suppresses networks from being advertised in

updates.

PARAMETERS

DEFAULT VALUE

Disabled.

EXAMPLEALU(config-router rip)# distribute-list prefix prefix-example in FastEthernet0

Parameter Description

1-99 IP access list number.

1300-2699 IP expanded access list number.

gateway <ip-prefix-list name>

Name of the prefix list to be applied to the gateway of the prefix being updated.

prefix <ip-prefix-list name>

Name of a prefix list. This list defines which networks are to be received and which are to be suppressed in routing updates, based upon matching the network prefix to the prefixes in the list.

in Filter incoming routing updates.

out Filter outgoing routing updates.

interface-name Interface on which the access list should be applied. If no interface is specified, the access list will be applied to all updates.

457Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Router Information Protocol

Left running head: Chapter name (automatic)

IP RIP AUTHENTICATION KEY-CHAIN ip rip authentication key-chain <key-chain name>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to associate a key chain to an interface. This enables RIP authentication.

PARAMETERS

DEFAULT VALUE

No authentication is provided for RIP packets.

EXAMPLEALU(config-if FastEthernet0)# ip rip authentication key-chain allen

IP RIP AUTHENTICATION MODE ip rip authentication mode {md5|text}

DESCRIPTION

Use the following command in the Interface Configuration Mode. This command is used to configure the authentication mode to be used by the interface (or let it default mode). RIP Version 1 does not support authentication.

PARAMETERS

DEFAULT VALUE

The default authentication mode is Plain Text authentication

EXAMPLE

ALU(config-if FastEthernet0)# ip rip authentication mode md5

Parameter Description

key-chain name Name of the key chain being associated to the interface.

Parameter Description

md5 Keyed Message Digest 5 (MD5) authentication.

text Plain Text authentication.

458

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ip rip {send|receive}

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IP RIP {SEND|RECEIVE} ip rip {send|receive} version [1] [2]

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to control the RIP behavior as to what version of RIP packets should be sent or received on an interface.

You can override the RIP behavior configured on a per interface basis.

PARAMETERS

DEFAULT VALUE

Version 1 and Version 2 packets are received by default.

EXAMPLE

ALU(config-if FastEthernet0)#ip rip send version 1 2

IP SPLIT-HORIZONip split-horizon [poison-reverse]

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command enables the split horizon mechanism.

PARAMETERS

.

DEFAULT VALUE By default, split-horizon is enabled.

EXAMPLEALU(config-if FastEthernet0)#ip split-horizon

Parameter Description

1 Accepts/sends RIP Version 1 packets on the interface.

2 Accepts/sends RIP Version 2 packets on the interface.

Parameter Description

poison-reverse Enable poison-reverse on an interface.

459Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Router Information Protocol

Left running head: Chapter name (automatic)

KEYkey <0-2147483647>

DESCRIPTION

This command is entered in the Key-chain mode. This command is used to configure a key.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-keychain allen)# key 100ALU(config-keychain-key 100)#

KEY-CHAINkey-chain <key-chain name>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure a key chain.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# key-chain allenALU(config-keychain allen)#

Parameter Description

0-2147483647 Identity for the key in the range 0-2147483647.

Parameter Description

key-chain name Name of the key chain being configured.

460

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

key-string

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

KEY-STRINGkey-string <key string>

DESCRIPTION

This command is entered in the Key-chain Key mode. This command is used to configure the password for the key.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-keychain-key 100)# key-string ab123

NETWORKnetwork <network-number>

DESCRIPTION

This command is entered in the Router Configuration Mode. This command associates a specific network with a RIP routing process.

PARAMETERS

EXAMPLEALU(config-router rip)# network 10.0.0.0

Parameter Description

key-string The password for the key.

Parameter Description

network-number Network number

461Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Router Information Protocol

Left running head: Chapter name (automatic)

NEIGHBORneighbor <neighbor-address>

DESCRIPTION

This command is entered in the Router Configuration Mode. This command defines a neighboring router to exchange the routing information.

PARAMETERS

DEFAULT VALUE

No neighboring routers are defined.

EXAMPLEALU(config-router rip)# neighbor 172.19.3.1

Parameter Description

neighbor-address IP address of a peer router with which routing information will be exchanged.

462

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

no auto-summary

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NO AUTO-SUMMARYno auto-summary

This command is entered in the Router Configuration Mode. The ‘no’ command disables auto-summary, and sends sub-prefix routing information across classfull network boundaries.

NO DEFAULT-INFORMATION ORIGINATEno default-information originate

This command is entered in the Router Configuration Mode. This command disables the control distribution of default information.

NO DEFAULT-METRICno default-metric <1-16>

This command is entered in the Router Configuration Mode. This command sets the metric of redistributed routes to its default.

NO DISTANCEno distance <1-255>

This command is entered in the Router Configuration Mode. This command sets the administrative distance to default. The default value for RIP is 120.

NO DISTRIBUTE-LISTno distribute-list {<1- 99>|<1300-2699>|gateway <ip-prefix-list name>|prefix <ip-prefix-list name>} {in|out} [<interface-name>]

This command is entered in the Router Configuration Mode. This command disables the functionality to filter networks in routing updates.

NO IP RIP AUTHENTICATION KEY-CHAINno ip rip authentication key-chain <key-chain name>

This command is entered in the Interface Configuration Mode. The ‘no’ command removes the key chain associated to an interface. This disables RIP authentication.

463Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Router Information Protocol

Left running head: Chapter name (automatic)

NO IP RIP AUTHENTICATION MODEno ip rip authentication mode

This command is entered in the Interface Configuration Mode. The ‘no’ command sets the authentication mode to its default, i.e, plain Text authentication.

NO IP SPLIT-HORIZON no ip split-horizon

This command is entered in the Interface Configuration Mode. This command disables the split horizon mechanism.

NO NEIGHBORno neighbor <neighbor-address>

This command is entered in the Router Configuration Mode. This command removes the statically configured neighbors.

NO NETWORK no network <network-number>

This command is entered in the Router Configuration Mode. The above command disables the configured network. RIP stops sending updates through interfaces on this network. Also these interfaces will not be advertised in any RIP updates.

NO OFFSET-LISTno offset-list {{<0-99>|<1300-1999> <access-list name>} {in|out}} {<0-16>} [<interface-name>]

This command is entered in the Router Configuration Mode. The above command disables the configured offset-list.

464

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

no passive-interface

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NO PASSIVE-INTERFACEno passive-interface {<interface-name>|default}

This command is entered in the Router Configuration Mode. The above command disables the configured passive interfaces.

NO REDISTRIBUTE no redistribute {bgp <1-65535>|connected|ospf <1-65535> [match {{external|nssa-external}[1|2]|internal}]|static} [metric {<1-16> |transparent}|route-map <route-map reference>]

This command is entered in the Router Configuration Mode. This command disables the redistribution of routes.

NO TIMERS BASICno timers basic

This command is entered in the Router Configuration Mode. This command removes the configured routing timers.

NO VALIDATE-UPDATE-SOURCE no validate-update-source

This command is entered in the Router Configuration Mode. Disables the validation of the source IP address of the incoming RIP routing updates. By default, RIP validates the source IP address of incoming RIP routing updates

NO VERSIONno version

This command is entered in the Router Configuration Mode. This command resets the configured routing protocol version.

NO IP RIP V2-BROADCASTno ip rip v2-broadcast

This command is entered in the Interface Configuration Mode. The ‘no’ command disables sending of routing updates to broadcast address.

465Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Router Information Protocol

Left running head: Chapter name (automatic)

OFFSET-LISToffset-list {{<0-99>|<1300-1999> <access-list name>} {in|out}} {<0-16>} [<interface-name>]

DESCRIPTION

Enter the offset-list command in the Router Configuration Mode. This command applies an offset to the incoming and outgoing routing metrics.

PARAMETERS

DEFAULT VALUE

Disabled.

EXAMPLEALU(config)#access-list 1 permit 10.33.0.0 0.0.0.0

ALU(config)#router ripALU(config-router)#network 192.168.1.0ALU(config-router)#network 10.0.0.0ALU(config-router rip)# offset-list 1 in 2 atm 0.1

The syntax of the offset-list says, "Examine RIP advertisements incoming from interface atm 0.1. For route entries matching the addresses specified in access-list 1, add 2 hops to the metric."

If no interface is identified, the list will modify either all incoming updates or all outgoing updates specified by the access-list on any interface.

Parameter Description

0-99 Access list number. ‘0’ selects all networks.

1300-1900 Extended Access list number (expanded range).

access-list name Access-list name.

in Applies the access list to incoming metrics.

out Applies the access list to outgoing metrics.

0-16 Positive offset (0-16) to be applied to metrics for networks matching the access list. If the offset is 0, no action is taken.

interface-name Interface to which the offset list is to be applied.

466

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

passive-interface

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

PASSIVE-INTERFACEpassive-interface {<interface-name>|default}

DESCRIPTION

This command is entered in the Router Configuration Mode. This command disables the sending of routing updates on specified interfaces and controls the set of interfaces with which to exchange routing updates.

PARAMETERS

DEFAULT VALUE Routing updates are sent on the RIP enabled interface.

EXAMPLE ALU(config-router rip)# passive-interface FastEthernet 0

Parameter Description

interface-name Suppresses routing updates on the specified interface.

default Suppresses routing updates on all interfaces.

467Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Router Information Protocol

Left running head: Chapter name (automatic)

REDISTRIBUTEredistribute {bgp <1-65535>|connected|ospf <1-65535> [match {{external|nssa-external}[1|2]|internal}]|static} [metric {<1-16> |transparent}|route-map <route-map reference>]

DESCRIPTION

Enter the redistribute command in Router Configuration Mode. This command is used to import routes from other routing protocols.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-router rip)# redistribute bgp 1 metric 10

Parameter Description

bgp <1-65535> Autonomous System number for BGP.

ospf <1-65535> OSPF router instance identifier (process ID).

match {external|nssa-external|internal|static}

Redistribute routes if route type is matched. This is to filter the routes.

1|2 Redistribute OSPF external type 1 or type 2 routes.

1-16 Metric to be applied for redistributed routes.

route-map reference

Route-map to be used to filter routes and set metrics.

468

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

router rip

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

ROUTER RIProuter rip

DESCRIPTION

This command is entered in the Configuration Mode. This command enables the RIP routing process.

PARAMETERS

None.

EXAMPLEALU(config)# router ripALU(config-router rip)#

SHOW IP PROTOCOLSshow ip protocols [vrf <vrf-name>]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. This command displays a detailed routing configuration.

PARAMETERS

EXAMPLEALU# show ip protocols

Routing Protocol is "rip" Sending updates every 30 seconds, next due in 18 seconds Invalid after 180 seconds, hold down 180, flushed after 240 seconds Default redistribution metric is 1 Default version control: send version 1, receive version 1 2 Automatic network summarization is in effect Outgoing update filter list for all interfaces is not set Incoming update filter list for all interfaces is not set Interface Send Recv Key-chain Vlan3 1 1 2 Routing for Networks: 4.0.0.0 Distance: (default is 120)

Field Description

vrf-name Name of the VRF.

469Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Router Information Protocol

Left running head: Chapter name (automatic)

Field Description

Routing Protocol is “rip”

Specifies the routing protocol used.

Sending updates every 30 seconds

Specifies the time between sending updates.

next due in 2 seconds The precise time when the next update is due to be sent.

Invalid after 180 seconds

Specifies the value of the invalid parameter.

holddown for 180 Specifies the current value of the holddown parameter.

flushed after 240 Specifies the time (in seconds) after which the individual routing information will be flushed out.

Outgoing update filter list is not set for all interfaces

Specifies whether the outgoing filtering list has been set.

Incoming update filter list is not set for all interfaces

Specifies whether the incoming filtering list has been set.

Redistributing Lists the protocol that is being redistributed.

Default version control

Specifies the version of RIP packets that are sent and received.

Routing for Networks Specifies the networks for which the routing process is currently injecting routes.

Routing Information Sources

Lists all the routing sources that the software is using to build its routing table. For each source, you will see the following displayed: • IP address • Administrative distance • Time the last update was received from this source

470

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip rip database

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW IP RIP DATABASEshow ip rip database [<ip-prefix>|<ip-address/prefix-length> |vrf <vrf-name>]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. Displays all route entries in the RIP routing database.

PARAMETERS

EXAMPLEALU# show ip rip database

RIP Route Table ---------------

1.0.0.0/8 : auto-summary1.1.1.0/24 : directly connected, FastEthernet0

Parameter Description

ip-prefix>|<ip-address/prefix-length>

Displays the routing information for the specified IP address with mask or prefix length.

vrf-name Name of the VRF.

471Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Router Information Protocol

Left running head: Chapter name (automatic)

SHOW IP RIP INTERFACESshow ip rip interfaces [vrf <vrf-name>]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. Displays summary address entries in the RIP database.

PARAMETERS

EXAMPLE

ALU# show ip rip interfaces

RIP Interface Table -------------------Interface Interface Address Interface Mask Send Ver Recv Ver FlagsFastEthernet0 1.1.1.2 255.255.255.0 2 2 B S

(Flags - U: Unnumbered P:Passive B:V2 Broadcast S:Split horizon disabled)

Parameter Description

vrf-name Name of the VRF.

Interface The interface-type.

Interface Address

IP address of the interface.

Interface Mask

Interface mask in four part dotted decimal format.

Send Ver The Send version.

Recv Ver The Receive version.

Flags Values are:• U: Unnumbered• P: Passive• B: V2 Broadcast• S: Split horizon disabled

472

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip rip peers

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW IP RIP PEERSshow ip rip peers [vrf <vrf-name>]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. This command displays the RIP peer table details.

PARAMETERS

EXAMPLEALU# show ip rip peers

RIP Peer Table --------------

Peer Address Interface LastUpd(sec) Rcv Ver Bad Pkts Bad Routes 4.4.4.1 Vlan3 20 1 0 0

Parameter Description

vrf-name Name of the VRF.

Peer Address IP address of the peer.

Interface The interface-type.

Last Update (secs)

The time of the last update (in secs).

Rcv Ver The Receive Version.

Bad Pkts The number of bad packets received.

Bad Routes The number of bad routes received.

473Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Router Information Protocol

Left running head: Chapter name (automatic)

SHOW IP RIP STATISTICSshow ip rip statistics [vrf <vrf-name>]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. This command displays the RIP statistics including both the global and interface statistics.

PARAMETERS

EXAMPLE ALU# show ip rip statistics

RIP Global Statistics ---------------------

Route Changes Route Queries Rx Bad Msgs Routes Learnt Routes Held down 0 1 0 0 0

RIP Interface Statistics ------------------------

Interface RIPv1 RIPv2 Vlan3 Routes learned 0 Updates sent 130 0 Bad msgs received 0 Trig Updates sent 9 0 Auth failures 0 Responses sent 0 0 *Unicast tx failure 0 Routes advertised 0 0 Bcast tx failures 0 Updates received 8 0 Mcast tx failures 0 Requests received 1 0 Bad Rtes received 0 0

Parameter Description

vrf-name Name of the VRF.

474

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show key-chain

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW KEY-CHAINshow key-chain [<key-chain name>]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. This command displays the key chain configured on the system.

PARAMETERS

EXAMPLEALU(config)# show key-chain

key-chain alu1 key 1 key-string alcatel-lucent Accept lifetime (00:00:00 01 Jan 2000) - (Infinite) [Valid Now] Send lifetime (00:00:00 02 Feb 2001) - (Infinite) [Valid Now] key-chain alu2 key 2 key-string lucent Accept lifetime (Always Valid) - (Always Valid) [Valid Now] Send lifetime (Always Valid) - (Always Valid) [Valid Now]

ALU(config)# show key-chain alu1

key-chain alu1 key 1 key-string alcatel-lucent Accept lifetime (00:00:00 01 Jan 2000) - (Infinite) [Valid Now] Send lifetime (00:00:00 02 Feb 2001) - (Infinite) [Valid Now]

Parameter Description

key-chain name Name of the key chain being associated to the interface.

475Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Router Information Protocol

Left running head: Chapter name (automatic)

TIMERS BASICtimers basic <0-4294967295> <1-4294967295> <0-4294967295> <1-4294967295>[<1-4294967295>]

DESCRIPTION

This command is entered in the Router Configuration Mode. This command is used to adjust routing protocol timers to tune the routing protocol performance to better suit your internetwork needs.

You can make the timer adjustments in the following order: Update, invalid, holddown, flush, sleeptime. All these are mandatory, except sleeptime.

PARAMETERS

Parameter Description

Update <0-4294967295>

Specify the interval (in seconds) between updates. This is the fundamental timing parameter of the routing protocol. The default is 30 seconds.

Invalid <1-4294967295>

Interval of time (in seconds) after which a route is declared invalid. The interval should be at least three times the value of the update argument. A route becomes invalid when there is an absence of updates that refresh the route. The route then enters into a holddown state. The route is marked inaccessible and advertised as unreachable. However, the route is still used for forwarding packets. The default is 180 seconds.

Holddown <0-4294967295>

Interval (in seconds) during which routing information regarding alternate paths is suppressed. It should be at least three times the value of the update argument. A route enters into a holddown state when an update packet is received that indicates the route is unreachable. The route is marked inaccessible and advertised as unreachable. However, the route is still used for forwarding packets. When holddown expires, routes advertised by other sources are accepted and the route will no longer be inaccessible. The default is 180 seconds.

Flush <1-4294967295>

Amount of time (in seconds) that must pass before the route is removed from the routing table. The interval specified should be greater than the value of the invalid argument. If it is less, the proper holddown interval cannot elapse, which results in a new route being accepted before the holddown. The default is 240 seconds.

sleep-time <1-4294967295>

Interval (in milliseconds) for postponing routing updates in the event of a flash update. The sleeptime value should be less than the update time. If the sleeptime is greater than the update time, routing tables will become unsynchronized.

476

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

validate-update-source

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

DEFAULT VALUE • update: 30 seconds• invalid: 180 seconds• holddown: 180 seconds• flush: 240 seconds

EXAMPLEALU(config-router rip)# timers basic 10 30 30 30

VALIDATE-UPDATE-SOURCE validate-update-source

DESCRIPTION

Enter the command in the Router Configuration Mode. This command validates the source IP address of incoming RIP routing updates.

PARAMETERS None.

DEFAULT VALUE

Enabled.

EXAMPLEALU(config-router rip)# validate-update-source

477Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Router Information Protocol

Left running head: Chapter name (automatic)

VERSIONversion {1 | 2}

DESCRIPTION

This command is entered in the Router Configuration Mode. This command is used to configure RIP version - v1/v2 on OmniAccess 5510 USG.

Note: RIPv2 is an enhancement of RIPv1 and not a separate protocol.

By default, the RIP process configured on OmniAccess 5510 USG sends only RIPv1 messages but receives both RIPv1 and RIPv2 messages.

PARAMETERS

DEFAULT VALUE

By default, the software receives both RIP Version 1 and Version 2 packets, but sends only Version 1 packets. You can configure the software to do the following:• Receive and send only Version 1 packets.• Receive and send only Version 2 packets.• Receive and send Version 1 and 2 packets.

EXAMPLEALU(config-router rip)# version 1

Parameter Description

1 Specifies RIP Version 1. Send and receive only RIPv1 messages.

2 Specifies RIP Version 2. Send and receive only RIPv2 messages.

478

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

v2-broadcast (rip)

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

V2-BROADCAST (RIP)ip rip v2-broadcast

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to allow RIP Version 2 update packets to be sent as broadcast packets instead of multicast packets.

PARAMETERS None.

DEFAULT VALUE This command is disabled by default.

EXAMPLEALU(config-if FastEthernet0)# ip rip v2-broadcast

479Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Router Information Protocol

Left running head: Chapter name (automatic)

480

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Border Gateway Protocol

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 24 BORDER GATEWAY PROTOCOL

This chapter explains the syntax of the various commands needed to configure Border Gateway Protocol.

It includes table of parameters, default values, and configuration examples for BGP configuration as quick-start and reference information. The commands are described in alphabetical order. For more detailed information about using and configuring the BGP, refer to the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

481Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Border Gateway Protocol

Left running head: Chapter name (automatic)

ADDRESS-FAMILY IPV4 UNICASTaddress-family ipv4 unicast

DESCRIPTION

This command is entered in the Router Configuration Mode. This command specifies the type of address family to be created and changes the command mode to Address Family mode.

PARAMETERS None.

Note: In OmniAccess 5510 USG, currently only IPv4 address family and unicast services are supported. By default all commands are applied to ipv4 unicast address family.

EXAMPLEALU(config-router bgp AS30)# address-family ipv4 unicastALU(config-router-af-ucast)#

482

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

aggregate-address

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

AGGREGATE-ADDRESSaggregate-address {<ip-address subnetmask>|<ip-address/prefix-length>} [{{suppress-map|advertise-map|attribute-map|route-map} <map-name>}|as-set|summary-only}]

DESCRIPTION

This command is entered in the Address Family or Router Configuration Mode. This command configures BGP aggregate entries.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-router bgp AS30)#aggregate-address 35.0.0.0/8 advertise-map admap1

Parameter Description

address Aggregate IP address.

mask Aggregate IP address mask.

as-set Generates autonomous system set path information.

summary-only Advertises summary addresses only.

suppress-map Route map used to selectively suppress routes in the aggregate range.

advertise-map Name of the route map to create AS-SET origin communities.

attribute-map Name of route map used to set the attribute of the aggregate route.

map-name Name of the route map.

483Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Border Gateway Protocol

Left running head: Chapter name (automatic)

BGP ALWAYS-COMPARE-MEDbgp always-compare-med

DESCRIPTION

This command is entered in the Router Configuration Mode. This command is used to compare the MED (Multi Exit Discriminator) for paths from neighbors in different autonomous systems.

Route selection process compares MED for paths from neighbors belonging to different AS. If this command is enabled, MED is compared among paths regardless of AS from which paths are received.

PARAMETERS

None.

DEFAULT VALUE

MEDs per paths from neighbors in different autonomous systems are compared.

EXAMPLEALU(config-router bgp AS30)# bgp always-compare-med

BGP BESTPATH AS-PATH IGNORE bgp bestpath as-path ignore

DESCRIPTION

This command is entered in the Router Configuration Mode. This command chooses the route ignoring as-path as a factor in the algorithm for choosing the route.

PARAMETERS

None.

DEFAULT VALUE

As-path is considered during BGP best path selection.

EXAMPLEALU(config-router bgp AS30)# bgp bestpath as-path ignore

484

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

bgp bestpath compare-cluster-length

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

BGP BESTPATH COMPARE-CLUSTER-LENGTHbgp bestpath compare-cluster-length

DESCRIPTION

This command is entered in the Router Configuration Mode. This command is used to compare the cluster-length for identical paths.

PARAMETERS

None.

DEFAULT VALUE

Cluster-length is not compared for choosing the best path.

EXAMPLEALU(config-router bgp AS30)#bgp bestpath compare-cluster-length

BGP BESTPATH COMPARE-ROUTERIDbgp bestpath compare-routerid

DESCRIPTION

This command is entered in the Router Configuration Mode. This command can be used to compare similar routes received from BGP peers during the best path selection process and switch the best path to the route with the lowest router ID.

PARAMETERS

None.

DEFAULT VALUE

None.

EXAMPLEALU(config-router bgp AS30)#bgp bestpath compare-routerid

485Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Border Gateway Protocol

Left running head: Chapter name (automatic)

BGP BESTPATH MEDbgp bestpath med {confed|missing-as-worst}

DESCRIPTION

This command is entered in the Router Configuration Mode. This command can be used to enable MED comparison among paths learned from confederation peers.

PARAMETERS

DEFAULT VALUE

MED attribute is not considered when choosing paths learned from confederation peers. Paths with missing MED are cancelled.

EXAMPLE

ALU(config-router bgp AS30)#bgp bestpath med confed

BGP CLIENT-TO-CLIENT REFLECTIONbgp client-to-client reflection

DESCRIPTION

This command is entered in the Address Family or Router Configuration Mode. This command restores route reflection from a BGP route reflector to its clients.

PARAMETERS

None.

DEFAULT VALUE

When you configure a route reflector, it reflects routes from one client to others.

EXAMPLE

ALU(config-router bgp AS30)#bgp client-to-client reflection

Parameter Description

confed Enables MED comparison among paths learned from confederation peers.

missing-as-worst The router assigns infinite MED to the path without the MED value.

486

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

bgp cluster-id

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

BGP CLUSTER-IDbgp cluster-id {<1-4294967295>|<ip-address>}

DESCRIPTION

This command is entered in the Router Configuration Mode. This command can be used to configure the cluster ID if the BGP cluster has more than one route reflector.

PARAMETERS

DEFAULT VALUE

Router ID of the route reflector is used as the Cluster ID.

EXAMPLEALU(config-router bgp AS30)#bgp cluster-id 50

BGP CONFEDERATION IDENTIFIERbgp confederation identifier <1-65535>

DESCRIPTION

This command is entered in the Router Configuration Mode. This command can be used to specify a BGP confederation identifier.

PARAMETERS

DEFAULT VALUE

No confederation identifier is configured.

EXAMPLEALU(config-router bgp AS30)#bgp confederation identifier 56687

Parameter Description

1-4294967295 Cluster-ID of the router acting as a route-reflector.

ip-address Route-reflector cluster ID in IP address format.

Parameter Description

1-65535 Autonomous system number that internally includes multiple autonomous systems.

487Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Border Gateway Protocol

Left running head: Chapter name (automatic)

BGP CONFEDERATION PEERSbgp confederation peers <1-65535>...

DESCRIPTION

This command is entered in the Router Configuration Mode. This command configures the autonomous systems that belong to the confederation.

PARAMETERS

DEFAULT VALUE

No BGP peers are identified as belonging to the confederation.

EXAMPLEALU(config-router bgp AS30)#bgp confederation peers 45

Parameter Description

1-65535 Autonomous system numbers for BGP peers that belongs to the confederation.

488

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

bgp dampening

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

BGP DAMPENINGbgp dampening <1-45> <1-20000> <1-20000> <1-255> [route-map <name>

DESCRIPTION

This command is entered in the Address Family or Router Configuration Mode. This command enables BGP route-flap dampening and changes various BGP route dampening factors.

PARAMETERS

DEFAULT VALUE

Disabled by default.

EXAMPLEALU(config-router bgp AS30)# bgp dampening 2 200 200 20

Parameter Description

1-45 Time (in minutes) after which a penalty is decreased. If a penalty has been assigned to the route, this penalty is decreased by half after the half-life period. The default value is 15 minutes. The process of reducing the penalty happens every 5 seconds.

1-20000 Value (in seconds) to start reusing a route.

1-20000 Value (in seconds) to start suppressing a route.

1-255 Maximum duration (in minutes) to suppress a stable route.

name Name of route map that controls BGP route dampening.

489Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Border Gateway Protocol

Left running head: Chapter name (automatic)

BGP DEFAULT LOCAL-PREFERENCEbgp default local-preference <0-4294967295>

DESCRIPTION

This command is entered in the Router Configuration Mode. This command configures the default local preference value.

In the best path selection process, this attribute is used and route with highest local preference will be selected. Route map has an option of ‘set local-preference’. You can use this to selectively give preference to some routes over the other.

PARAMETERS

DEFAULT VALUE

By default, local preference value is 100.

EXAMPLEALU(config-router bgp AS30)#bgp default local-preference 5000

Parameter Description

0-4294967295 Specify the local preference value. Higher the value the more preference it has.

490

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

bgp enforce-first-as

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

BGP ENFORCE-FIRST-AS bgp enforce-first-as

DESCRIPTION

This command is entered in the Address Family or Router Configuration Mode. If you configure this command, router denies the updates received from EBGP peer that does not add its AS number at the beginning of AS-Path in the incoming update packets.

PARAMETERS None.

DEFAULT VALUE

Disabled.

EXAMPLEALU(config-router bgp AS30)# bgp enforce-first-as

BGP FAST-EXTERNAL-FALLOVERbgp fast-external-fallover

DESCRIPTION

This command is entered in the Address Family or Router Configuration Mode. This command immediately resets the session if the link to a directly connected external peer goes down.

PARAMETERS

None.

DEFAULT VALUE

Enabled.

EXAMPLE

ALU(config-router AS30)# bgp fast-external-fallover

491Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Border Gateway Protocol

Left running head: Chapter name (automatic)

BGP GRACEFUL-RESTART-TIMERS bgp graceful-restart-timers <1-175> <1-100>

DESCRIPTION

This command is entered in the Address Family or Router Configuration Mode. This command enables the graceful restart capability.

PARAMETERS

DEFAULT VALUE

Restart timer - 175 seconds.

State Route Keep timer - 100 seconds.

EXAMPLEALU(config-router bgp AS30)# bgp graceful-restart-timer 100 150

BGP LOG-NEIGHBOR-CHANGESbgp log-neighbor-changes

DESCRIPTION

This command is entered in the Address Family or Router Configuration Mode. This command enables logging of messages when a BGP neighbor goes up or down or resets.

PARAMETERS

None.

DEFAULT VALUE

Logging is disabled.

EXAMPLE

ALU(config-router AS30)# bgp log-neighbor-changes

Parameter Description

1-175 Specifies the restart timer (in seconds).

1-100 Specifies the stale route keep timer (in seconds).

492

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

bgp router-id

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

BGP ROUTER-IDbgp router-id <ip-address>

DESCRIPTION

This command is entered in the Address Family or Router Configuration Mode. This command overrides the configured router identifier.

PARAMETERS

DEFAULT VALUE

Calculates Router ID from interface IP addresses.

EXAMPLEALU(config-router bgp AS30)# bgp router-id 1.1.1.1

BGP WRITE CONFIGbgp write config

DESCRIPTION

This command is entered in the Address Family or Router Configuration Mode. This command shows BGP specific configuration details.

PARAMETERS None.

DEFAULT VALUE

Disabled.

EXAMPLEALU(config-router bgp AS30)# bgp write config

router bgp 30 bgp enforce-first-as!address-family ipv4 unicast aggregate-address 0.0.0.0/0 aggregate-address 35.0.0.0/8 attribute-map m1exit-address-familyALU(config-router bgp AS30)#

Parameter Description

ip-address Router ID in the IP address format.

493Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Border Gateway Protocol

Left running head: Chapter name (automatic)

CLEAR IP BGPclear ip bgp {*|<1-65535>|<ip-address>|vrf <vrf-name>}

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. This command does a hard reset of the BGP connection.

PARAMETERS

DEFAULT VALUE

By default, no reset is initiated.

EXAMPLEALU# clear ip bgp *

CLEAR IP BGP DAMPENINGclear ip bgp dampening {<ip-address/mask>|<network-number>}

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. This command clears Border Gateway Protocol (BGP) route dampening information and activates the suppressed routes.

PARAMETERS

EXAMPLEALU# clear ip bgp dampening

Parameter Description

* Resets all current BGP sessions.

1-65535 Resets the connections with peers in specified.AS.

ip-address Resets the specified BGP neighbor.

vrf-name Name of the VRF.

Parameter Description

ip-address/mask Clears the dampening information for a specified network.

network-number Clears the dampening information for a specified network.

494

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

clear ip bgp external

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CLEAR IP BGP EXTERNALclear ip bgp external [{ipv4 <unicast>|in|out|soft [in|out]}]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. This command clears BGP peer information.

PARAMETERS

DEFAULT VALUE

By default, a reset is not initiated.

EXAMPLEALU# clear ip bgp external

Parameter Description

in|out Triggers inbound or outbound soft update.

soft Triggers soft re-configuration.

ipv4 Triggers reset of IPv4 address family session.

unicast Triggers reset of IPv4 unicast address family session.

495Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Border Gateway Protocol

Left running head: Chapter name (automatic)

CLEAR IP BGP FLAP-STATISTICSclear ip bgp flap-statistics [{<neighbor-address>|<ip-address/mask>|filter-list <1-199>|regexp <regular-expression>}]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. This command clears BGP route flap statistics.

PARAMETERS

DEFAULT VALUE

By default, no statistics are cleared.

EXAMPLEALU# clear ip bgp flap-statistics

Parameter Description

neighbor address Clears the flap statistics for a specific peer.

ip-address/mask Clears the flap statistics for the given network.

1-199 Clears flap statistics for all the paths that pass the access list.

regular-expression

Clears flap statistics for all the BGP AS paths that match the regular expression.

496

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

clear ip bgp peer-group

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CLEAR IP BGP PEER-GROUPclear ip bgp peer-group <peer-group-name> [ipv4 unicast] [{in|out|soft [in|out]}]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. This command clears IP BGP peer-group.

PARAMETERS

DEFAULT VALUE

By default, a reset is not initiated.

EXAMPLEALU# clear ip bgp peer-group p1

Parameter Description

peer-group-name Reset all current BGP sessions in the specified peer group.

ipv4 unicast Reset all current BGP sessions in the specified address family.

in|out Triggers inbound or outbound update.

soft Triggers soft re-configuration.

497Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Border Gateway Protocol

Left running head: Chapter name (automatic)

CLEAR IP BGP NEIGHBORclear ip bgp <neighbor-address> [soft [in|out]]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. This command performs a reset on the connection with specified neighbor.

PARAMETERS

EXAMPLEALU# clear ip bgp 1.1.1.1

DEFAULT-INFORMATION ORIGINATEdefault-information originate

DESCRIPTION

This command is entered in the Address Family or Router Configuration Mode. This command is used to configure BGP router to advertise default route.

‘Redistribute’ command should be configured to complete this configuration.

PARAMETERS None.

DEFAULT

Disabled.

EXAMPLEALU#(config-router bgp AS30)# default-information originate

Parameter Description

neighbor-address Resets only the specified BGP neighbor.

soft Triggers soft re-configuration.

in|out Triggers inbound or outbound update.

498

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ip bgp-community new-format

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IP BGP-COMMUNITY NEW-FORMATip bgp-community new-format

DESCRIPTION

This command is entered in the Configuration Mode. This command displays the BGP communities in the AA:NN format.

PARAMETERS

None.

DEFAULT

BGP communities are displayed in one 32-bit number format.

EXAMPLEALU(config)# ip bgp-community new-format

ALU(config)# show route-map test3route-map test3, permit, sequence 5 Description: Exit Policy: Match clauses: Set clauses: community 0:100ALU(config)#

ALU(config)# no ip bgp-community new-formatALU(config)# show route-map test3route-map test3, permit, sequence 5 Description: Exit Policy: Match clauses: Set clauses: community 100ALU(config)#

499Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Border Gateway Protocol

Left running head: Chapter name (automatic)

NEIGHBOR ACTIVATEneighbor {<ip-address>|<peer-group-name>} activate

DESCRIPTION

This command is entered in the Address Family or Router Configuration Mode.This command enables the exchange of information with specified neighbor.

PARAMETERS

DEFAULT

By default, neighbor is activated when configured.

EXAMPLEALU(config-router bgp AS30)#neighbor 1.1.1.1 activate

NEIGHBOR ADVERTISEMENT-INTERVALneighbor {<ip-address>|<peer-group-name>} advertisement-interval <0-600>

DESCRIPTION

This command is entered in the Address Family or Router Configuration Mode. Sets the minimum interval between the sending of BGP routing updates.

PARAMETERS

DEFAULT

30 seconds for external peers and 5 seconds for internal peers.

EXAMPLEALU(config-router bgp AS30)#neighbor 1.1.1.1 advertisement-interval 77

Parameter Description

ip-address Neighbor’s IP address.

peer-group-name Name of a BGP peer group.

Parameter Description

ip-address Neighbor’s IP address.

peer-group-name Name of a BGP peer group.

0-600 Specify the time in seconds.

500

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

neighbor capability

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NEIGHBOR CAPABILITYneighbor {<ip-address>|<peer-group-name>} capability graceful-restart

DESCRIPTION

This command is entered in the Address Family or Router Configuration Mode. This command advertises graceful-restart capability to a particular neighbor.

PARAMETERS

EXAMPLEALU(config-router bgp AS30)#neighbor 1.1.1.1 capability graceful-restart

NEIGHBOR DEFAULT-ORIGINATEneighbor {<ip-address>|<peer-group-name>} default-originate

DESCRIPTION

This command is entered in the Address Family or Router Configuration Mode. This command allows a BGP speaker (the local router) to originate a default route to a neighbor.

PARAMETERS

DEFAULT

No default route is sent to the neighbor.

EXAMPLEALU(config-router bgp AS30)# neighbor 1.1.1.1 default-originate

Parameter Description

ip-address Neighbor’s IP address.

peer-group-name Name of a BGP peer group.

Parameter Description

ip-address Neighbor’s IP address.

peer-group-name Name of a BGP peer group.

501Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Border Gateway Protocol

Left running head: Chapter name (automatic)

NEIGHBOR DESCRIPTIONneighbor {<ip-address>|<peer-group-name>} description <line>

DESCRIPTION

This command is entered in the Router Configuration Mode. This command can be used to associate a description to a neighbor.

PARAMETERS

DEFAULT

There is no description of the neighbor.

EXAMPLEALU(config-router bgp AS30)#neighbor 1.1.1.1 description linktoisp1

Parameter Description

ip-address Neighbor’s IP address.

peer-group-name Name of a BGP peer group.

line Descriptive text (up to 80 characters) that describes the neighbor.

502

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

neighbor distribute-list

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NEIGHBOR DISTRIBUTE-LISTneighbor {<ip-address>|<peer-group-name>} distribute-list {<1-199>|<1300-2699>|<access-list-name>}{in|out}

DESCRIPTION

This command is entered in the Address Family or Router Configuration Mode. This command distributes BGP neighbor information as specified in an access list.

PARAMETERS

DEFAULT

No BGP neighbor is specified.

EXAMPLE ALU(config-router bgp AS30)#neighbor 1.1.1.1 distribute-list 1 in

Parameter Description

ip-address Neighbor’s IP address.

peer-group-name Name of a BGP peer group.

1-199 Standard IP access list number or name. The list defines which networks are to be received and which are to be suppressed in routing updates.

100-199 Extended IP access list number or name.

access-list-name Name of a IP access list.

in Access list is applied to incoming advertisements from that neighbor.

out Access list is applied to outgoing advertisements to that neighbor.

503Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Border Gateway Protocol

Left running head: Chapter name (automatic)

NEIGHBOR EBGP-MULTIHOPneighbor {<ip-address>|<peer-group-name>} ebgp-multihop [<1-255>]

DESCRIPTION

This command is entered in the Router Configuration Mode. This command can be used to accept and attempt BGP connections to external peers residing on networks that are not directly connected.

PARAMETERS

DEFAULT

Only directly connected external neighbors are allowed.

EXAMPLE

ALU(config-router bgp AS30)#neighbor 1.1.1.1 ebgp-multihop 4

Parameter Description

ip-address IP address of the BGP-speaking neighbor.

peer-group-name Name of a BGP peer group.

1-255 The maximum hop count to reach neighbor.

504

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

neighbor filter-list

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NEIGHBOR FILTER-LISTneighbor {<ip-address>|<peer-group-name>} filter-list <1-199> {in|out}

DESCRIPTION

This command is entered in the Router Configuration Mode. This command uses AS-PATH access list to filter the updates from a specified neighbor.

PARAMETERS

DEFAULT

No filter is used.

EXAMPLEALU(config-router bgp AS30)#neighbor 1.1.1.1 filter-list 1 in

Parameter Description

ip-address Neighbor’s IP address.

peer-group-name Name of a BGP peer group.

1-199 Number of an AS path access list. You can define this access list with the ip as-path access-list command.

in Access list to incoming routes.

out Access list to outgoing routes.

505Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Border Gateway Protocol

Left running head: Chapter name (automatic)

NEIGHBOR LOCAL-ASneighbor {<ip-address>|<peer-group-name>} local-as <1-65535>

DESCRIPTION

This command is entered in the Router Configuration Mode. This command is used to enable local-as feature for specified neighbor. AS number specified in the command is used to form neighborship.

PARAMETERS

DEFAULT

None.

EXAMPLEALU(config-router bgp AS30)#neighbor 1.1.1.1 local-as 10

Parameter Description

ip-address Neighbor’s IP address.

peer-group-name Name of a BGP peer group.

1-65535 Any valid AS number.

Note: Do not specify the AS number to which the neighbor belongs.

506

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

neighbor maximum-prefix

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NEIGHBOR MAXIMUM-PREFIXneighbor {<ip-address>|<peer-group-name>} maximum-prefix <1-4294967295> [<1-100>] [warning-only]

DESCRIPTION

This command is entered in the Router Configuration Mode. This command configures the maximum number of prefixes that can be received from a neighbor.

PARAMETERS

DEFAULT

This command is disabled by default. There is no limit on the number of prefixes.

EXAMPLEALU(config-router bgp AS30)#neighbor 1.1.1.1 maximum-prefix 20000 50

Parameter Description

ip-address Neighbor’s IP address.

peer-group-name Name of a BGP peer group.

1-4294967295 Maximum number of prefixes allowed from this neighbor.

1-100 The threshold value in percentage at which warning messages are generated. The default is 75%.

warning-only Allows the router to generate warning message when the maximum limit is exceeded, instead of terminating the peering.

507Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Border Gateway Protocol

Left running head: Chapter name (automatic)

NEIGHBOR NEXT-HOP-SELFneighbor {<ip-address>|<peer-group-name>} next-hop-self

DESCRIPTION

This command is entered in the Router Configuration Mode. This command disables the next hop calculation for the specified BGP-speaking neighbor or peer group.

PARAMETERS

DEFAULT

Disabled.

EXAMPLEALU(config-router bgp AS30)#neighbor 1.1.1.1 next-hop-self

NEIGHBOR PEER-GROUP (ADDING MEMBERS)neighbor <ip-address> peer-group <peer-group-name>

DESCRIPTION

This command is entered in the Address Family or Router Configuration Mode. This command is used to add BGP neighbors to a peer group.

PARAMETERS

DEFAULT

There are no BGP neighbors in a peer group.

EXAMPLEALU(config-router bgp AS30)#neighbor 1.1.1.1 peer-group P1

Parameter Description

ip-address IP address of the BGP neighbor who belongs to the peer group specified by the tag.

peer-group-name Name of a BGP peer group to which the neighbor belongs.

Parameter Description

ip-address IP address of the BGP neighbor.

peer-group-name Name of a BGP peer group.

508

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

neighbor peer-group (creating)

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NEIGHBOR PEER-GROUP (CREATING)neighbor <peer-group-name> peer-group

DESCRIPTION

This command is entered in the Address Family or Router Configuration Mode. This command is used to create BGP peer group.

PARAMETERS

DEFAULT

By default, there is no BGP peer group.

EXAMPLEALU(config-router bgp AS30)#neighbor testpeergroup peer-group

Parameter Description

peer-group-name Name of the BGP peer group.

509Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Border Gateway Protocol

Left running head: Chapter name (automatic)

NEIGHBOR PREFIX-LISTneighbor {<ip-address>|<peer-group-name>} prefix-list <name> {in|out}

DESCRIPTION

This command is entered in the Address Family or Router Configuration Mode. This command filters the updates to and from the BGP neighbor.

PARAMETERS

DEFAULT

No BGP neighbor is specified.

EXAMPLEALU(config-router bgp AS30)#neighbor 1.1.1.1 prefix-list PL1 in

Parameter Description

ip-address Neighbor’s IP address.

peer-group-name Name of the BGP peer group.

name Name of a prefix list.

in Access list is applied to incoming advertisements from that neighbor.

out Access list is applied to outgoing advertisements to that neighbor.

510

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

neighbor remove-private-as

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NEIGHBOR REMOVE-PRIVATE-ASneighbor {<ip-address>|<peer-group-name>} remove-private-as

DESCRIPTION

This command is entered in the Address Family or Router Configuration Mode. This command removes the private AS numbers from the updates sent to the neighbors. Private AS values are from 64512 to 65535.

PARAMETERS

DEFAULT

None.

EXAMPLEALU(config-router bgp AS30)# neighbor 1.1.1.1 remove-private-as

NEIGHBOR REMOTE-ASneighbor {<ip-address>|<peer-group-name>} remote-as <1-65535>

DESCRIPTION

This command is entered in the Address Family or Router Configuration Mode. Configures a BGP neighbor and the AS to which this neighbor belongs.

PARAMETERS

DEFAULT

No neighbor configured.

EXAMPLEALU(config-router bgp AS30)# neighbor 1.1.1.1 remote-as 5000

Parameter Description

ip-address Neighbor’s IP address.

peer-group-name Name of a BGP peer group.

Parameter Description

ip-address Neighbor’s IP address.

peer-group-name Name of a BGP peer group.

1-65535 Autonomous system to which the neighbor belongs.

511Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Border Gateway Protocol

Left running head: Chapter name (automatic)

NEIGHBOR ROUTE-MAPneighbor {<ip-address>|<peer-group-name>} route-map <name> {in|out}

DESCRIPTION

This command is entered in the Address Family or Router Configuration Mode. This command applies a route map to incoming or outgoing routes.

PARAMETERS

DEFAULT VALUE

No route maps are applied to a peer.

EXAMPLEALU(config-router bgp AS30)#neighbor 35.0.0.0 route-map R1 in

Parameter Description

ip-address Neighbor’s IP address.

peer-group-name Name of a BGP peer group.

name Name of route map.

in|out Apply to incoming/outgoing routes.

512

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

neighbor route-reflector-client

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NEIGHBOR ROUTE-REFLECTOR-CLIENTneighbor {<ip-address>|<peer-group-name>} route-reflector-client

DESCRIPTION

This command is entered in the Address Family or Router Configuration Mode. This command configures the neighbor as a BGP route reflector client.

PARAMETERS

DEFAULT

There is no route reflector in the AS.

EXAMPLEALU(config-router bgp AS30)#neighbor 35.0.0.1 route-reflector-client

NEIGHBOR SEND-COMMUNITYneighbor {<ip-address>|<peer-group-name>} send-community

DESCRIPTION

This command is entered in the Address Family or Router Configuration Mode. This command specifies that community attribute should be sent to a BGP neighbor.

PARAMETERS

DEFAULT

No community attribute is sent to any neighbor.

EXAMPLEALU(config-router bgp AS30)#neighbor 35.0.0.1 send-community

Parameter Description

ip-address IP address of the BGP neighbor being identified as a client.

peer-group-name Name of a BGP peer group.

Parameter Description

ip-address Neighbor’s IP address.

peer-group-name Name of a BGP peer group.

513Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Border Gateway Protocol

Left running head: Chapter name (automatic)

NEIGHBOR SHUTDOWNneighbor {<ip-address>|<peer-group-name>} shutdown

DESCRIPTION

This command is entered in the Address Family or Router Configuration Mode. This command administratively shuts down a neighbor or peer group.

PARAMETERS

DEFAULT

None.

EXAMPLEALU(config-router bgp AS30)#neighbor 35.0.0.0 shutdown

NEIGHBOR SOFT-RECONFIGURATION INBOUNDneighbor {<ip-address>|<peer-group-name>} soft-reconfiguration inbound

DESCRIPTION

This command is entered in the Address Family or Router Configuration Mode. This command configures the software to start storing the updates from the neighbor.

PARAMETERS

DEFAULT

By default, soft re-configuration is disabled.

EXAMPLEALU(config-router bgp AS30)#neighbor 35.0.0.0 soft-reconfiguration inbound

Parameter Description

ip-address Neighbor’s IP address.

peer-group-name Name of a BGP peer group.

Parameter Description

ip-address IP address of the BGP-speaking neighbor.

peer-group-name Name of a BGP peer group.

inbound Store incoming updates.

514

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

neighbor timers

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NEIGHBOR TIMERSneighbor {<ip-address>|<peer-group-name>} timers {<0-65535> <0-65535>}

DESCRIPTION

This command is entered in the Address Family or Router Configuration Mode. This command sets the timers for a specific BGP peer or peer group.

PARAMETERS

DEFAULT VALUE

Keepalive time: 60 seconds.

Holdtime: 180 seconds.

EXAMPLEALU(config-router bgp AS30)# neighbor 35.0.0.0 timers 50 500

Parameter Description

ip-address A BGP peer or peer group IP address.

peer-group-name Name of the BGP peer group.

0-65535 Keepalive message interval for the neighbor.

0-65535 Hioldtime interval for the neighbor.

515Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Border Gateway Protocol

Left running head: Chapter name (automatic)

NEIGHBOR UNSUPRESS-MAPneighbor {<ip-address>|<peer-group-name>} unsupress-map <route-map-name>

DESCRIPTION

This command is entered in the Address Family or Router Configuration Mode. This command enables BGP routers to selectively advertise routes previously suppressed by the ‘aggregate-address’ command.

PARAMETERS

DEFAULT VALUE

If aggregate-address command is configured, only then the aggregate routes are advertised.

EXAMPLEALU(config-router bgp AS30)#neighbor 1.1.1.1 unsupress-map r1

Parameter Description

ip-address IP address of the BGP-speaking neighbor.

peer-group-name Name of a BGP peer group.

route-map-name Name of the route map.

516

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

neighbor update-source

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NEIGHBOR UPDATE-SOURCEneighbor {<ip-address>|<peer-group-name>} update-source <interface-name>

DESCRIPTION

This command is entered in the Router Configuration Mode. This command is used to configure the software to allow BGP sessions to use a particular interface for TCP connections.

PARAMETERS

DEFAULT VALUE

By default, IP address of the interface connected to neighbor is used for TCP connection.

EXAMPLEALU(config-router bgp AS30)#neighbor 1.1.1.1 update-source FastEthernet 0

Parameter Description

ip-address IP address of the BGP-speaking neighbor.

peer-group-name Name of a BGP peer group.

interface-name Name of the interface.

517Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Border Gateway Protocol

Left running head: Chapter name (automatic)

NEIGHBOR VERSIONneighbor {<ip-address>|<peer-group-name>} version <4-4>

DESCRIPTION

This command is entered in the Router Configuration Mode. This command configures neighbor’s BGP version.

PARAMETERS

DEFAULT

BGP Version 4.

EXAMPLEALU(config-router bgp AS30)#neighbor 1.1.1.1 version 4

NEIGHBOR WEIGHTneighbor {<ip-address>|<peer-group-name>} weight <0-65535>

DESCRIPTION

This command is entered in the Address Family or Router Configuration Mode. This command sets the default weight for the routes from a neighbor.

PARAMETERS

EXAMPLEALU(config-router bgp AS30)# neighbor 1.1.1.1 weight 500

Parameter Description

ip-address IP address of the BGP-speaking neighbor.

peer-group-name Name of a BGP peer group.

4-4 BGP version number. This is always set to 4.

Parameter Description

ip-address IP address of the BGP-speaking neighbor.

peer-group-name Name of a BGP peer group.

0-65535 Default weight assigned to the routes from this neighbor.

518

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

network

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NETWORKnetwork {<network-number> mask <subnetmask>|<ip-address/prefix-length>}[{backdoor|route-map <name>|weight <0-65535>}]

DESCRIPTION

This command is entered in the Address Family or Router Configuration Mode. This command specifies the networks to be advertised through BGP.

PARAMETERS

DEFAULT VALUE

No networks are specified.

EXAMPLEALU(config-router bgp AS30)#network 35.0.0.0/8

Parameter Description

network-number Network number.

mask <subnetmask>

Network mask address.

backdoor Specify a BGP backdoor route. This specifies a backdoor route to a BGP border router that will provide better information about the network.

name Name of the route-map.

0-65535 An absolute weight to a BGP network.

519Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Border Gateway Protocol

Left running head: Chapter name (automatic)

ROUTER BGProuter bgp <as-number>

DESCRIPTION

This command is entered in the Configuration Mode. This command enables BGP routing for the local AS and changes to RCM.

PARAMETERS

DEFAULT

No BGP routing process is enabled by default.

EXAMPLEALU(config)# router bgp 30ALU(config-router bgp AS30)#

Parameter Description

as-number Number of an autonomous system that identifies the router to other BGP routers and tags the routing information passed along. The range for the as-number is 1 - 65535.

520

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip bgp

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW IP BGPshow ip bgp [<network-number>|<ip-address/prefix-length>] [longer-prefixes]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. This command displays entries in the BGP routing table.

PARAMETERS

EXAMPLE 1ALU# show ip bgp

BGP local router ID is 111.111.111.111Status codes: s suppressed, d damped, h history, * valid, > best, i - internalOrigin codes: i - IGP, e - EGP, ? - incomplete Prefix/len Next Hop Metric LocPref Weight Path*> 1.0.0.0/8 1.1.1.2 200 100 70 100i*> 4.0.0.0/8 1.1.1.2 200 100 70 100i*> 5.0.0.0/8 1.1.1.2 200 100 70 100i*> 6.0.0.0/8 1.1.1.2 200 100 70 100i* d 7.0.0.0/8 1.1.1.2 200 100 70 100i*> 111.111.111.0/24 111.111.111.112 110 100 50 300?* d 118.0.0.0/24 111.111.111.112 110 100 50 300?ALU#

Parameter Description

network-number Display a particular network in the BGP routing table.

ip-address/prefix-length

Display a particular network in the BGP routing table.

longer-prefixes Displays route for the given network. It also shows all the more specific routes in the given network.

Field Description

ip-address/prefix-length

Network with prefix length in the BGP routing table.

network-number Network in the BGP routing table.

bestpaths BGP bestpaths table.

cidr-only Displays routes with non-natural masks only.

community Displays routes matching with the communities.

community-list Displays routes matching the community-list.

dampened-paths Displays paths that have suppressed due to dampening.

521Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Border Gateway Protocol

Left running head: Chapter name (automatic)

EXAMPLE 2ALU# show ip bgp 111.111.111.0

BGP routing table entry for 111.111.111.0/24 300 111.111.111.112 from 111.111.111.112 (118.0.0.1) Origin INCOMPLETE, metric 110, localpref 100, weight 50, valid, external, uptime 00:15:12 best (One Available Path)Number of paths available: 1Route is advertised to following peers:1.1.1.2ALU#

EXAMPLE 3ALU# show ip bgp 5.0.0.0/8

BGP routing table entry for 5.0.0.0/8 100 1.1.1.2 from 1.1.1.2 (3.3.3.3) Origin IGP, metric 200, localpref 100, weight 70, valid, external, uptime 00:10:24 best (One Available Path) Community Attribute : local-AS 10 Number of paths available: 1Not advertised to any peerALU#

filter-list Displays routes conforming to the filter-list

flap-statistics Displays flap statistics of routes.

inconsistent-as Displays routes with inconsistent origin AS.

ipv4 Address family.

neighbors Detailed information on BGP neighbor connections.

nexthop Resolution status of nexthops for iBGP and multihop eBGP routes.

paths Path information.

peer-group Displays information on peer-groups.

regexp Displays routes matching the AS path regular expression.

summary Summary of BGP neighbor status.

Field Description

522

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip bgp

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

EXAMPLE 4

ALU# show ip bgp bestpaths

BGP local router ID is 111.111.111.111Status codes: s suppressed, d damped, h history, * valid, > best, i - internalOrigin codes: i - IGP, e - EGP, ? - incomplete Prefix/len Next Hop Metric LocPref Weight Path*> 1.0.0.0/8 1.1.1.2 200 100 70 100i*> 4.0.0.0/8 1.1.1.2 200 100 70 100i*> 5.0.0.0/8 1.1.1.2 200 100 70 100i*> 6.0.0.0/8 1.1.1.2 200 100 70 100i*> 111.111.111.0/24 111.111.111.112 110 100 50 300?ALU#

EXAMPLE 5ALU# show ip bgp ipv4 unicast

BGP local router ID is 111.111.111.111Status codes: s suppressed, d damped, h history, * valid, > best, i - internalOrigin codes: i - IGP, e - EGP, ? - incomplete Prefix/len Next Hop Metric LocPref Weight Path*> 1.0.0.0/8 1.1.1.2 200 100 70 100i*> 4.0.0.0/8 1.1.1.2 200 100 70 100i*> 5.0.0.0/8 1.1.1.2 200 100 70 100i*> 6.0.0.0/8 1.1.1.2 200 100 70 100i* d 7.0.0.0/8 1.1.1.2 200 100 70 100i*> 111.111.111.0/24 111.111.111.112 110 100 50 300?* d 118.0.0.0/24 111.111.111.112 110 100 50 300?ALU#

523Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Border Gateway Protocol

Left running head: Chapter name (automatic)

SHOW IP BGP CIDR-ONLYshow ip bgp cidr-only

DESCRIPTION

This command is entered in the User mode. This command displays routes with mask different from their class mask.

PARAMETERS

None.

EXAMPLEALU# show ip bgp cidr-only

BGP local router ID is 111.111.111.111Status codes: s suppressed, d damped, h history, * valid, > best, i - internalOrigin codes: i - IGP, e - EGP, ? - incomplete Prefix/len Next Hop Metric LocPref Weight Path*> 111.111.111.0/24 111.111.111.112 110 100 50 300?* d 118.0.0.0/24 111.111.111.112 110 100 50 300?ALU#

524

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip bgp community

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW IP BGP COMMUNITYshow ip bgp community {<1-4294967295>|local-AS|no-advertise|no-export} [exact-match]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. This command is used to display routes that match the BGP communities.

PARAMETERS

EXAMPLE ALU# show ip bgp community 10

BGP local router ID is 111.111.111.111Status codes: s suppressed, d damped, h history, * valid, > best, i - internalOrigin codes: i - IGP, e - EGP, ? - incomplete Prefix/len Next Hop Metric LocPref Weight Path*> 1.0.0.0/8 1.1.1.2 200 70 100i*> 4.0.0.0/8 1.1.1.2 200 70 100i*> 5.0.0.0/8 1.1.1.2 200 70 100i*> 6.0.0.0/8 1.1.1.2 200 70 100i* d 7.0.0.0/8 1.1.1.2 200 70 100i* d 118.0.0.0/24 111.111.111.112 110 50 300?ALU#

Parameter Description

1-4294967295 Community number.

local-AS Displays routes with local-as community attribute.

no-advertise Displays routes with no-advertise community attribute.

no-export Displays routes with no-export community attribute.

exact-match Displays only routes that have exactly the same specified communities.

525Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Border Gateway Protocol

Left running head: Chapter name (automatic)

SHOW IP BGP COMMUNITY-LISTshow ip bgp community-list <1-199> [exact-match]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. This command is used to display routes matching the BGP community list.

PARAMETERS

EXAMPLEALU# show ip bgp community-list 20

Parameter Description

1-199 Community list number.

exact-match Displays the routes that have an exact match.

526

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip bgp dampened-paths

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW IP BGP DAMPENED-PATHSshow ip bgp dampened-paths

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. This command displays the paths suppressed due to dampening.

PARAMETERS None.

EXAMPLEALU# show ip bgp dampened-paths

BGP local router ID is 111.111.111.111Status codes: s suppressed, d damped, h history, * valid, > best, i - internalOrigin codes: i - IGP, e - EGP, ? - incomplete Prefix/len From Reuse Path*d 7.0.0.0/8 1.1.1.2 00:18:10 100i*d 118.0.0.0/24 111.111.111.11200:22:20 300?ALU#

Field Description

local router IP address of the router where route dampening is enabled.

*d Route to the network indicated is dampened.

From IP address of the peer that advertised this path.

Reuse Time (in hours:minutes:seconds) after which the path will be made available.

Path AS path of the route that is being dampened.

527Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Border Gateway Protocol

Left running head: Chapter name (automatic)

SHOW IP BGP FILTER-LISTshow ip bgp filter-list <access-list-number>

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. This command is used to display routes that conform to a specified filter list.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLE ALU# show ip bgp filter-list 2

Parameter Description

access-list-number Number of an autonomous system path access list. It can be a number from 1 to 199.

528

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip bgp flap-statistics

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW IP BGP FLAP-STATISTICSshow ip bgp flap-statistics [{<ip-address>|<ip-address/mask>| cidr-only|regexp <regexp>|filter-list <1-199>}]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. This command displays the BGP flap statistics of routes.

PARAMETERS

EXAMPLEALU# show ip bgp flap-statistics

BGP local router ID is 111.111.111.111Status codes: s suppressed, d damped, h history, * valid, > best, i - internalOrigin codes: i - IGP, e - EGP, ? - incomplete Prefix/len From Flaps Duration Reuse Path* d 7.0.0.0/8 1.1.1.2 2 00:10:48 00:17:50 100i* d 118.0.0.0/24 111.111.111.112 1 00:06:08 00:22:00 300?ALU#

SHOW IP BGP INCONSISTENT-ASshow ip bgp inconsistent-as

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. This command displays the routes with inconsistent originating autonomous systems.

PARAMETERS None.

EXAMPLE ALU# show ip bgp inconsistent-as

Parameter Description

ip-address Network in the BGP routing table.

ip-address/mask Network mask applied to the address.

cidr-only Displays the routes with non-natural netmasks.

regexp Displays routes for all the AS paths that match the regular expression.

1-199 Displays routes conforming to the filter list.

529Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Border Gateway Protocol

Left running head: Chapter name (automatic)

SHOW IP BGP NEIGHBORSshow ip bgp neighbors {<ip-address> [advertised-routes| dampened-routes|flap-statistics|paths [<regular-expression>] |received-routes|routes]|vrf <vrf-name>}

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. This command displays information about the TCP and BGP neighbor connections.

PARAMETERS

EXAMPLE 1 ALU# show ip bgp neighbors

BGP neighbor is 1.1.1.2, remote AS 100, external link BGP version 4, remote router id 3.3.3.3 BGP state = Established, up for 00:12:08 Last read 00:00:07, Last sent 00:00:07 Hold time is 180, keepalive interval is 60 seconds Neighbor capabilities: Route refresh: advertised and received Address family IPv4 Unicast: advertised and received Received 342 messages, 0 notifications, 0 in queue Sent 333 messages, 7 notifications, 0 in queue Minimum time between advertisement runs is 30 seconds

Field Description

ip-address IP address of the neighbor. If you omit this argument, all neighbors are displayed.

advertised-routes

Displays all the routes the router has advertised to a BGP neighbor.

dampened-routes Displays the dampened routes received from the neighbor.

flap-statistics Displays flap-statistics of the routes learnt from the neighbor.

path <regular-expression>

Regular expression that is used to match the paths received.If regular-expression is not specified, displays all the paths received from the neighbor.

received-routes Displays all received routes (both accepted and rejected) from the specified neighbor.

routes Displays all routes that are received and accepted. This is a subset of the output from the received-routes keyword.

vrf-name Name of the VRF.

530

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip bgp neighbors

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

For Address Family IPv4 Unicast Route refresh request: received 0, sent 0 Number of Unicast prefixes received 5 Prefixes advertised 1, accepted 5, filtered 0, dampened 1 Number of updates pending 0, withdrawals pending 0 Route map for incoming advertisements is metric1 Connections established 9; dropped 8 Last reset 00:12:44, due to Interface Flap Connection state is ESTABLocal host: 1.1.1.1, Local port: 32835Foreign host: 1.1.1.2, Foreign port: 179 iss: 0 snduna: 0 sndnxt: 0 sndwnd: 2irs: 0 rcvnxt: 0 rcvwnd: 0 SRTT: 0 ms, RTTO: 51964 ms, RTV: 34464 ms, minRTT: 0 msBGP neighbor is 111.111.111.112, remote AS 300, external link BGP version 4, remote router id 118.0.0.1 BGP state = Established, up for 00:17:01 Last read 00:01:00, Last sent 00:00:01 Hold time is 180, keepalive interval is 60 seconds Neighbor capabilities: Route refresh: advertised and received Address family IPv4 Unicast: advertised and received Received 322 messages, 1 notifications, 0 in queue Sent 331 messages, 8 notifications, 0 in queue Minimum time between advertisement runs is 30 seconds For Address Family IPv4 Unicast Route refresh request: received 0, sent 0 Number of Unicast prefixes received 2 Prefixes advertised 0, accepted 2, filtered 0, dampened 1 Number of updates pending 0, withdrawals pending 0 Route map for incoming advertisements is metric Connections established 10; dropped 9 Last reset 00:17:05, due to BGP Notification sent, Cease Error Connection state is ESTABLocal host: 111.111.111.111, Local port: 179Foreign host: 111.111.111.112, Foreign port: 32832 iss: 0 snduna: 0 sndnxt: 0 sndwnd: 2irs: 0 rcvnxt: 0 rcvwnd: 0 SRTT: 0 ms, RTTO: 18750 ms, RTV: 7500 ms, minRTT: 0 msALU#

Field Description

BGP neighbor IP address of the BGP neighbor and its autonomous system number. If the neighbor is in the same autonomous system as the router, then the link between them is internal; otherwise, it is considered external.

remote AS Autonomous system of the neighbor.

531Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Border Gateway Protocol

Left running head: Chapter name (automatic)

external link Indicates that this peer is an EBGP peer.

BGP version BGP version being used to communicate with the remote router.

remote router ID IP address of the neighbor.

BGP state Internal state of this BGP connection.

up for Amount of time, in seconds, that the underlying TCP connection has been in existence.

Last read Time that BGP last read a message from this neighbor.

Last sent Time that BGP last sent a message to its neighbor.

hold time Maximum amount of time that can elapse between messages from the peer.

keepalive interval

Time period, in seconds, between sending keepalive packets, which help ensure that the TCP connection is up.

Neighbor capabilities

BGP capabilities advertised and received from this neighbor.

Received Number of total BGP messages received from this peer, including keepalives.

notifications Number of notification messages received/sent from/to the peer.

Sent Total number of BGP messages that have been sent to this peer, including keepalives.

minimum advertisement runs

Value of minimum advertisement interval.

For Address Family IPv4 Unicast

Address family to which the following fields refer.

Route refresh request

Number of route refresh requests sent and received from this neighbor.

Prefix advertised

Number of prefixes advertised.

accepted prefix Number of prefixes accepted from neighbor.

filtered Number of prefixes filtered.

dampened Number of prefixes dampened.

updates pending Number of updates pending.

withdrawal pending

Number of withdrawals pending.

Field Description

532

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip bgp neighbors

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

route-map for incoming advertisements

Route map used to filter incoming updates from neighbor.

withdrawn Number of prefixes withdrawn.

Connections established

Number of times the router has established a TCP connection and the two peers have agreed to speak BGP with each other.

dropped Number of times that a good connection has failed or been taken down.

Last reset Elapsed time since this peering session was last reset.

Connection state State of BGP peer.

Local host, Local port

Peering address of local router, plus port.

Foreign host, Foreign port

Peering address of the neighbor.

iss Initial send sequence number.

snduna Last send sequence number the local host sent but has not received an acknowledgment for.

sndnxt Sequence number the local host will send next.

sndwnd TCP window size of the remote host.

irs Initial receive sequence number.

rcvnxt Last receive sequence number the local host has acknowledged.

rcvwnd TCP window size of the local host.

SRTT A calculated smoothed round-trip timeout.

RTTO Round-trip timeout.

RTV Variance of the round-trip time.

minRTT Smallest recorded round-trip timeout (hard wire value used for calculation).

Field Description

533Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Border Gateway Protocol

Left running head: Chapter name (automatic)

SHOW IP BGP PATHSshow ip bgp paths <regular-expression>

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. This command displays all the BGP paths in the database.

PARAMETERS None.

EXAMPLEALU# show ip bgp paths

Hash Refcount Metric Path376 1 110 300?377 1 110 300?643 5 200 100iALU#

Field Description

Hash Hash bucket where path is stored.

Refcount Number of routes using that path.

Metric The Multi Exit Discriminator (MED) metric for the path.

Path The autonomous system path for that route, followed by the origin code for that route.

534

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip bgp peer-group

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW IP BGP PEER-GROUPshow ip bgp peer-group [{<peer-group-name>|vrf <vrf-name>}] [summary]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. This command displays information about BGP peer groups.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLE ALU# show ip bgp peer-group internal

SHOW IP BGP REGEXPshow ip bgp regexp <regular-expression>

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. This command displays the routes matching with the AS path regular expression.

PARAMETERS

EXAMPLEBGP local router ID is 40.0.0.1

Parameter Description

peer-group-name Displays information about that specific peer group.

vrf-name Name of the VRF.

summary Displays a summary of the status of all the members of a peer group.

Parameter Description

regular-expression

Regular expression to match the BGP autonomous system paths.

535Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Border Gateway Protocol

Left running head: Chapter name (automatic)

SHOW IP BGP SUMMARYshow ip bgp summary

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. This command verifies whether peering is established with the router’s neighbors and displays the basic statistics for messages and prefixes.

PARAMETERS None.

EXAMPLEALU# show ip bgp summaryBGP router identifier 111.111.111.111, local AS number 2007 Prefix entries using 416 bytes of memory7 Path entries for prefixes using 392 bytes of memoryDampening enabled. 0 History paths. 2 Dampened paths3 Path attribute entries using 672 bytes of memory2 Aspath entries using 614 bytes of memory2 Community entries using 44 bytes of memory Neighbor V AS MsgRcvd MsgSent InQ OutQ Up/Down State/PfxRcd1.1.1.2 4 100 342 333 0 0 00:12:46 5111.111.111.112 4 300 323 331 0 0 00:17:39 2ALU#

Field Description

BGP router identifier

In order of precedence and availability, router identifier specified by the BGP router-id command, loopback address, or lowest IP address.

local AS Local AS number.

Neighbor IP address of a neighbor.

V BGP version number spoken to that neighbor.

AS Neighbor AS number.

MsgRcvd BGP messages received from that neighbor.

MsgSent BGP messages sent to that neighbor.

InQ Number of messages from that neighbor waiting to be processed.

OutQ Number of messages waiting to be sent to that neighbor.

536

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

synchronization

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SYNCHRONIZATIONsynchronization

DESCRIPTION

This command is entered in the Address Family or Router Configuration Mode. This command is used to enable the synchronization between the BGP and IGP system.

PARAMETERS None.

DEFAULT

Enabled.

EXAMPLEALU(config-router bgp AS30)# synchronization

Up/Down The length of time that the BGP session has been in the Established state, or the current state if it is not Established.

State/PfxRcd Current state of the BGP session/the number of prefixes the router has received from a neighbor or peer group. When the maximum number (as set by the neighbor_maximum_prefix command) is reached, the string "PfxRcd" appears in the entry, the neighbor is shut down, and the connection is Idle. An (Administrator) entry with Idle status indicates that the connection has been shut down using the neighbor_shutdown command.

Field Description

537Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Border Gateway Protocol

Left running head: Chapter name (automatic)

TIMERS BGPtimers bgp [<0-65535>|<0-65535>]

DESCRIPTION

This command is entered in the Router Configuration Mode. This command is used to configure keepalive and holdtime interval.

These are global timers for BGP router. Keepalive and holdtime configured for a neighbor take precedence.

PARAMETERS

DEFAULT VALUE

The default keepaalive interval is 60 seconds.

The default holdtime interval is 180 seconds.

EXAMPLEALU(config-router bgp AS30)# timer bgp 100 500

Parameter Description

0-65535 Keepalive interval: BGP sends keepalive message to its neighbors after every keepalive seconds.

0-65535 Holdtime interval: If no keepalive message is received in holdtime interval, BGP assumes that neighbor is dead.

538

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Open Shortest Path First

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 25 OPEN SHORTEST PATH FIRST

This chapter lists the commands to monitor and configure the OSPF protocol.

It includes table of parameters, default values, and configuration examples for OSPF configuration as quick-start and reference information. The commands are described in alphabetical order. For more detailed information about using and configuring the OSPF, refer to the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

539Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Open Shortest Path First

Left running head: Chapter name (automatic)

ALT-ABRalt-abr [cisco|ibm]

DESCRIPTION

This command is entered in the Router Configuration Mode. This command enables OSPF router behavior specified in RFC 3509.

PARAMETERS

None.

DEFAULT

By default, OSPF router follows ABR behavior specified in RFC 2328.

EXAMPLEALU(config-router ospf 30)# alt-abr

AREA AUTHENTICATION area {<0-4294967295>|<ip-address>} authentication [message-digest]

DESCRIPTION

This command is entered in the Router Configuration Mode. This command enables authentication for an OSPF area.

Use the ‘message-digest’ keyword to enable MD5 authentication.

The default authentication mode is Plain Text authentication.

PARAMETERS

DEFAULT VALUE

The default authentication is Plain Text authentication.

EXAMPLEALU(config-router ospf 30)# area 1 authentication message-digest

Parameter Description

0-4294967295 Identifier of the area for which authentication is to be enabled. The identifier as a decimal value.

ip-address Identifier of the area for which authentication is to be enabled. The identifier as an IP address.

message-digest Enables Message Digest 5 (MD5) authentication on the area specified by the area-id argument.

540

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

area default-cost

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

AREA DEFAULT-COSTarea {<0-4294967295>|<ip-address>} default-cost <0-16777215>

DESCRIPTION

This command is entered in the Router Configuration Mode. This command specifies the cost for the default summary route sent into a stub or NSSA.

PARAMETERS

DEFAULT VALUE Default cost is 1.

EXAMPLE

ALU(config-router ospf 30)# area 1 default-cost 100

Parameter Description

0-4294967295 OSPF area ID as a decimal value.

ip-address OSPF area ID in IP address format.

0-16777215 Cost for the default summary route used for a stub or NSSA. The acceptable value is a 24-bit number.

541Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Open Shortest Path First

Left running head: Chapter name (automatic)

AREA NSSAarea {<0-4294967295>|<ip-address>} nssa [default-information-originate] [no-summary] [no-redistribution]

DESCRIPTION

This command is entered in the Router Configuration Mode. Defines an area to be NSSA.

PARAMETERS

DEFAULT VALUE

No NSSA area is defined.

EXAMPLE

ALU(config-router ospf 30)# area 1 nssa

Parameter Description

0-4294967295 OSPF area ID as a decimal value.

ip-address OSPF area ID in IP address format.

no redistribution

Used when the router is an NSSA ABR and you want the redistribute command to import routes only into the normal areas, but not into the NSSA area.

default-information-originate

Used to generate a Type 7 default into the NSSA area. This keyword takes effect only on NSSA ABR or NSSA ASBR.

no-summary Allows an area to be a not-so-stubby area but not have summary routes injected into it.

542

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

area range

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

AREA RANGE area {<0-4294967295>|<ip-address>} range {<ip-address subnet-mask|<ip-address/prefix-length>}[not-advertise]

DESCRIPTION

This command is entered in the Router Configuration Mode. This command specifies an address range for which a single route will be advertised.

PARAMETERS

DEFAULT VALUE Disabled.

EXAMPLE

ALU(config-router ospf 30)# area 1 range 10.0.0.0/8 not-advertise

Parameter Description

0-4294967295 Identifier of the area about which the routes are to be summarized. Area ID specified as a decimal value.

ip-address Identifier of the area about which the routes are to be summarized. Area ID specified as an IP address.

range {<ip-address subnet-mask|<ip-address/prefix-length>}

IP address with its mask or prefix length.

not-advertise Sets the address range status to DoNotAdvertise. The Type 3 summary LSA is suppressed and the component networks remain hidden from other networks.

543Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Open Shortest Path First

Left running head: Chapter name (automatic)

AREA STUB area {<0-4294967295>|<ip-address>} stub [no-summary]

DESCRIPTION

This command is entered in the Router Configuration Mode. This command defines an area to be a stub area.

PARAMETERS

DEFAULT VALUE

No stub area is defined.

EXAMPLEALU(config-router ospf 30)# area 1 stub no-summary

Parameter Description

0-4294967295 Identifier for the OSPF stub area as a decimal value.

ip-address Identifier for the OSPF stub area as an IP address.

no-summary Prevents an ABR from sending summary link advertisements into the stub area.

544

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

area virtual-link

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

AREA VIRTUAL-LINKarea {<0-4294967295>|<ip-address>} virtual-link <router-id> [authentication [message-digest|null] [[hello-interval |retransmit-interval retransmit-interval|transmit-delay|dead-interval] <1-8192>] authentication-key <0-0> <key>]|message-digest-key <1-255> md5 <key>]]

DESCRIPTION

This command is entered in the Router Configuration Mode. This command establishes a virtual link with neighbor specified by router ID.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-router ospf 30)# area 1 virtual-link 202.202.202.5

Parameter Description

0-4294967295 Identifier for the OSPF stub area as a decimal value.

ip-address Identifier for the OSPF stub area as an IP address.

router-id Router ID associated with virtual link neighbor. The router ID appears in the ‘show ip ospf’ display. The router ID is internally derived by each router from the interface IP addresses. This value must be entered in the same format as an IP address. There is no default.

authentication [message-digest|null]

Enable authentication over virtual link.

1-8192 The dead interval.

authentication-key <0-0> key

The authentication key.

<1-255> md5 key The message digest authentication key identifier.

545Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Open Shortest Path First

Left running head: Chapter name (automatic)

AUTO-COSTauto-cost [reference-bandwidth <1-4294967>]

DESCRIPTION

This command is entered in the Router Configuration Mode. This command is used to calculate the interface cost based on the reference bandwidth.

The OSPF metric is calculated as the reference bandwidth value divided by the bandwidth, with reference bandwidth equal to 108 by default.

PARAMETERS

DEFAULT VALUE Default value for reference bandwidth is 100.

EXAMPLEALU(config-router ospf 30)# auto-cost referenece-bandwidth 100

CLEAR IP OSPFclear ip ospf [[<1-65535>|process|redistribution|counters [neighbor] [neighbor-id] [interface-name]|interface statistics [hello|ddp|lsupd|lsack|lsreq][<interface-name>]]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. This command restarts OSPF router if only process ID is specified. For other parameters, it restarts the specified counters/feature.

PARAMETERS

EXAMPLE

ALU# clear ip ospf 1 redistribution

Parameter Description

1-4294967 The reference bandwidth in terms of Mbits per second. The default is 100.

Parameter Description

1-65535 OSPF process ID.

neighbor-id Neighbor router ID.

interface-name The interface name for the which counters is to be cleared.

546

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

compatible RFC1583

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

COMPATIBLE RFC1583compatible rfc1583

DESCRIPTION

This command is entered in the Router Configuration Mode.

This command restores the method used to calculate summary route costs per RFC 1583. This command is entered in the Router Configuration Mode. To minimize the chance of routing loops, all OSPF routers in an OSPF routing domain should have RFC compatibility set identically. Because of the introduction of RFC 2328, OSPF Version 2, the method used to calculate summary route costs has changed. Use the no compatible rfc1583 command to enable the calculation method used per RFC 2328.

PARAMETERS None.

DEFAULT VALUE Compatible with RFC 1583.

EXAMPLEALU(config-router ospf 30)# compatible rfc1583

547Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Open Shortest Path First

Left running head: Chapter name (automatic)

DEFAULT-INFORMATION ORIGINATEdefault-information originate [always] [metric <0-16777214>] [metric-type <1-2>] [route-map <route-map name>]

DESCRIPTION

This command is entered in the Router Configuration Mode. This command forces the autonomous system boundary router to distribute a default route into the OSPF routing domain.

PARAMETERS

DEFAULT VALUE Disabled.

EXAMPLEALU(config-router ospf 30)# default-information originate always metric 100

Parameter Description

always Always advertises the default route regardless of whether the software has a default route.

0-16777214 Metric used for generating the default route. If you do not specify a value using the default-metric router configuration command, the default metric value is 10. The value used is specific to the protocol.

1-2 External link type associated with the default route advertised into the OSPF routing domain. It can be one of the following values: 1—Type 1 external route 2—Type 2 external route The default is type 2 external route.

<route-map name> Routing process will generate the default route if the route map is satisfied.

548

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

default-metric

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

DEFAULT-METRICdefault-metric <1-4294967295>

DESCRIPTION

Enter the default-metric command in Router Configuration Mode. This command sets default metric values for the OSPF routing protocol.

PARAMETERS

DEFAULT VALUE

Default metric is 20.

EXAMPLEALU(config-router ospf 30)#default-metric 60000

Parameter Description

<1-4294967295> Default metric value appropriate for the specified routing protocol.

549Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Open Shortest Path First

Left running head: Chapter name (automatic)

DISTANCE distance {<1-255> [<ip-address subnet-mask|<ip-address/prefix-length>][<1-99>] [<1300-1999>]}

DESCRIPTION

This command is entered in the Router Configuration Mode. This command is used to change the administrative distance for a given network.

PARAMETERS

DEFAULT VALUE The default distance is 110.

EXAMPLEALU(config-router ospf 30)# distance 60 10.0.0.0/8

Parameter Description

1-255 Administrative distance.

<ip-address subnet-mask|<ip-address/prefix-length>

IP address with subnet mask or prefix length.

1-99 IP standard access list.

1300-1999 IP standard access list (expanded range).

550

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

distance ospf

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

DISTANCE OSPFdistance ospf {external|inter-area|intra-area} <1-255>}}

DESCRIPTION

This command is entered in the Router Configuration Mode. This command performs the same function as the distance command used with an access list. However, the ‘distance ospf’ command allows you to set a distance for an entire group of routes, rather than a specific route that passes an access list.

PARAMETERS

DEFAULT VALUE The default distance for each type is 110.

EXAMPLEALU(config-router ospf 30)# distance ospf external 10

Parameter Description

external <1-255> Sets the distance for routes from other routing domains, learned by redistribution.

inter-area <1-255>

Sets the distance for all routes from one area to another area.

intra-area <1-255>

Sets the distance for all routes within an area.

551Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Open Shortest Path First

Left running head: Chapter name (automatic)

IP OSPF AUTHENTICATIONip ospf authentication [message-digest|null]

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to enable authentication for OSPF.

PARAMETERS

DEFAULT VALUE

The default authentication mode is Plain Text authentication.

EXAMPLEALU(config-if FastEthernet0)# ip ospf authentication message-digest

IP OSPF AUTHENTICATION-KEYip ospf authentication-key {<0-0>|<password-key>}

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command assigns an authentication password to be used by OSPF routers on a network segment.

PARAMETERS

DEFAULT VALUE

No password is specified.

EXAMPLEALU(config-if FastEthernet0)# ip ospf authentication-key passwordtest

Parameter Description

message-digest Specifies that message-digest authentication will be used.

null No authentication is used. Overrides the authentication configured for an area.

Parameter Description

0-0 password key The OSPF password. Password need not be the same throughout the area but needs to be the same between neighbors.

552

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ip ospf cost

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IP OSPF COSTip ospf cost <1-65535>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command explicitly specifies the cost of sending a packet on an OSPF interface.

Note: The value set by the ‘ip ospf cost’ command overrides the cost resulting from the auto-cost command.

PARAMETERS

DEFAULT VALUE The default cost is calculated based on the interface bandwidth.

EXAMPLEALU(config-if FastEthernet0)# ip ospf cost 100

IP OSPF DATABASE-FILTER ALL OUTip ospf database-filter all out

DESCRIPTION

This command is entered in the Interface Configuration Mode. Enables filtering of outgoing LSAs on OSPF interface.

PARAMETERS None.

DEFAULT VALUE By default, database-filtering is not enabled. All outgoing LSAs are flooded to the interface.

EXAMPLEALU(config-if FastEthernet0)# ip ospf database-filter all out

Parameter Description

1-65535 Unsigned integer value expressed as the link-state metric.

553Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Open Shortest Path First

Left running head: Chapter name (automatic)

IP OSPF DEAD-INTERVALip ospf dead-interval <1-65535>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command sets the number of seconds that a device must wait before it declares a neighbor OSPF router down because it has not received a hello packet.

PARAMETERS

DEFAULT VALUE Four times the hello-interval.

EXAMPLEALU(config-if FastEthernet0)# ip ospf dead-interval 50

IP OSPF FLOOD-REDUCTIONip ospf flood-reduction

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to suppress the unnecessary flooding of LSAs in stable topologies.

PARAMETERS

None.

DEFAULT VALUE

Disabled.

EXAMPLEALU(config-if FastEthernet0)# ip ospf flood-reduction

Parameter Description

1-65535 Interval (in seconds) during which the router must receive at least one hello packet from a neighbor or else that neighbor is removed from the peer list and does not participate in routing. The value must be the same for all nodes on the network.

554

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ip ospf hello-interval

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IP OSPF HELLO-INTERVALip ospf hello-interval <1-65535>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command specifies the length of time (in seconds) between the hello packets that OSPF sends on an interface.

PARAMETERS

DEFAULT VALUE

The default hello-interval is 10 seconds.

EXAMPLEALU(config-if FastEthernet0)# ip ospf hello-interval 20

IP OSPF MESSAGE-DIGEST-KEYip ospf message-digest-key <1-255> md5 <key>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command enables OSPF MD5 authentication.

The values for the key-id and key arguments must match the values specified for other neighbors on a network segment.

PARAMETERS

DEFAULT VALUE OSPF MD5 authentication is disabled.

EXAMPLEALU(config-if FastEthernet0)# ip ospf message-digest-key 100 md5 passwordline

Parameter Description

1-65535 Specifies the interval (in seconds). The value must be the same for all nodes on a specific network.

Parameter Description

<1-255> Key number in the range from 1 to 255.

key The message digest authentication key.

555Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Open Shortest Path First

Left running head: Chapter name (automatic)

IP OSPF MTU-IGNOREip ospf mtu-ignore

DESCRIPTION

This command is entered in the Interface Configuration Mode. Disables detection of OSPF MTU mismatch in Database Description Packets.

PARAMETERS

None.

DEFAULT VALUE

By default, OSPF MTU mismatch detection is enabled.

EXAMPLE

ALU(config-if FastEthernet0)# ip ospf mtu-ignore

IP OSPF NETWORKip ospf network {broadcast|non-broadcast|point-to-multipoint |point-to-point}

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command configures the OSPF network type for a specified interface.

PARAMETERS

DEFAULT VALUE

Depends on the interface type.

EXAMPLEALU(config-if FastEthernet0)# ip ospf network non-broadcast

Parameter Description

broadcast Specifies the OSPF broadcast multi-access network.

non-broadcast Specifies the OSPF NBMA network.

point-to-multipoint

Specifies the OSPF point-to-multipoint network.

point-to-point Specifies the OSPF point-to-point network.

556

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ip ospf priority

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IP OSPF PRIORITYip ospf priority <0-255>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to set the router priority, which helps determine the designated router for this network.

PARAMETERS

DEFAULT VALUE

The default OSPF interface priority is 1.

EXAMPLEALU(config-if FastEthernet0)# ip ospf priority 2

IP OSPF RETRANSMIT-INTERVALip ospf retransmit-interval <1-65535>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command specifies the time (in seconds) between LSA retransmissions for adjacencies belonging to an OSPF interface.

PARAMETERS

DEFAULT VALUE

The default retransmit-interval is 5 seconds.

EXAMPLEALU(config-if FastEthernet0)# ip ospf retransmit-interval 6

Parameter Description

0-255 A number value that specifies the priority of the router.

Parameter Description

1-65535 Time (in seconds) between retransmissions. It must be greater than the expected round-trip delay between any two routers on the attached network.

557Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Open Shortest Path First

Left running head: Chapter name (automatic)

IP OSPF TRANSMIT-DELAYip ospf transmit-delay <1-65535>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command sets the estimated time in seconds required to send a link-state update packet on an OSPF interface.

PARAMETERS

DEFAULT VALUE

The default transmit-delay is 1 second.

EXAMPLEALU(config-if FastEthernet0)# ip ospf transmit-delay 2

LOG-ADJACENCY-CHANGESlog-adjacency-changes [detail]

DESCRIPTION

This command is entered in the Router Configuration Mode. This command is used to enable logging of adjacency changes.

PARAMETERS

DEFAULT VALUE

Enabled.

EXAMPLEALU(config-router ospf 30)# log-adjacency-changes detail

Parameter Description

1-65535 Time (in seconds) required to send a link-state update. The default is 1 seconds.

Parameter Description

detail Logs the messages for all state changes.

558

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

neighbor

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NEIGHBORneighbor <ip-address> [cost <1-65535>|database-filter all out|priority <0-255>|poll-interval <0-4294967295>]

DESCRIPTION

This command is entered in the Router Configuration Mode. This command configures a neighbor router. Use this command only if the network type is ‘non-broadcast’.

PARAMETERS

DEFAULT VALUE None.

EXAMPLEALU(config-router ospf 30)# neighbor 10.0.0.1 priority 1 poll-interval 130

Parameter Description

ip-address Interface IP address of the neighbor.

1-65535 Assigns a cost to the neighbor, in the form of an integer from 1 to 65535. Neighbors with no specific cost configured will assume the cost of the interface, based on the ‘ip ospf cost’ command. For point-to-multipoint interfaces, the cost keyword and the number argument are the only options that are applicable. This keyword does not apply to nonbroadcast multiaccess (NBMA) networks.

all Filters outgoing link-state advertisements (LSAs) to an OSPF neighbor.

0-255 A number that indicates the router priority value of the nonbroadcast neighbor associated with the IP address specified. The default is 0. This keyword does not apply to point-to-multipoint interfaces.

0-4294967295 A number value that represents the poll interval time (in seconds). RFC 1247 recommends that this value be much larger than the hello interval. The default is 120 seconds (2 minutes). This keyword does not apply to point-to-multipoint interfaces.

559Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Open Shortest Path First

Left running head: Chapter name (automatic)

NETWORK AREAnetwork {<ip-address subnet-mask>|<ip-address/prefix-length>} area {<0-4294967295>|<ip-address>}

DESCRIPTION

This command is entered in the Router Configuration Mode. Enables routing on an IP network and the area ID for that interface.

Note: Area ‘0’ is called the backbone area.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-router ospf 30)# network 10.0.0.0/8 area 1

NO PASSIVE-INTERFACEno passive-interface {<interface-name>|default}

This command is entered in the Router Configuration Mode. The “no” command enables sending of hello packets and routing updates on a specified interface.

Parameter Description

<ip-address subnet-mask|<ip-address/prefix-length>

IP address with subnet mask or prefix length.

area <0-4294967295>

Area ID that is to be associated with the OSPF address range. It can be specified as either a decimal value or as an IP address. If you intend to associate areas with IP subnets, you can specify a subnet address as the value of the area-id argument.

area <ip-address>

OSPF area ID in IP address format.

560

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

no log-adjacency-changes

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NO LOG-ADJACENCY-CHANGESno log-adjacency-changes

This command is entered in the Router Configuration Mode. The “no” command is used to disable logging.

NO AREA AUTHENTICATIONno area {<0-4294967295>|<ip-address>} authentication [message-digest]

This command is entered in the Router Configuration Mode. The “no” command disables authentication for an OSPF area.

NO AREA DEFAULT-COSTno area {<0-4294967295>|<ip-address>} default-cost <0-16777215>

This command is entered in the Router Configuration Mode. The “no” command removes the specific cost assigned to the default summary route used for the stub area/NSSA.

NO AREA NSSAno area {<0-4294967295>|<ip-address>} nssa [default-information-originate] [no-summary] [no-redistribution]

This command is entered in the Router Configuration Mode. The “no” command sets area to default.

NO AREA RANGEno area {<0-4294967295>|<ip-address>} range {<ip-address subnet-mask|<ip-address/prefix-length>}[not-advertise]

This command is entered in the Router Configuration Mode. The “no” command removes the address range for which a single route is to be advertised.

NO AREA STUBno area {<0-4294967295>|<ip-address>} stub [no-summary]

This command is entered in the Router Configuration Mode. The “no” command sets area to default.

NO AREA VIRTUAL-LINKno area {<0-4294967295>|<ip-address>} virtual-link <router-id> [authentication [message-digest|null] [[hello-interval|retransmit-interval retransmit-interval|transmit-delay|dead-interval] <1-8192>] authentication-key <0-0> <key>]| message-digest-key <1-255> md5 <key>]]

This command is entered in the Router Configuration Mode. The “no” command removes the virtual link with neighbor specified by router ID.

561Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Open Shortest Path First

Left running head: Chapter name (automatic)

PASSIVE-INTERFACEpassive-interface {<interface-name>|default}

DESCRIPTION

This command is entered in the Router Configuration Mode. This command suppresses sending of routing update packets and OSPF hello packets through the specified interface.

PARAMETERS

DEFAULT VALUE

Routing updates are sent on enabled interfaces.

EXAMPLEALU(config-router ospf 30)# passive-interface FastEthernet 0

ROUTER-IDrouter-id <ip-address>

DESCRIPTION

This command is entered in the Router Configuration Mode. This command configures OSPF router ID.

PARAMETERS

DEFAULT VALUE Default Router ID is generated using interface IP addresses.

EXAMPLEALU(config-router ospf 30)#router-id 35.0.0.1

Parameter Description

interface-name Name of the interface.

default All interfaces become passive. The default keyword is useful in Internet Service Providers (ISPs) and large enterprise networks where the distribution routers have more than 200 interfaces.

Parameter Description

ip-address Router ID in IP address format.

562

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

router ospf

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

ROUTER OSPFrouter ospf <1-65535>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure an OSPF routing process.

PARAMETERS

DEFAULT VALUE

No OSPF routing process is defined.

EXAMPLEALU(config)# router ospf 30ALU(config-router ospf 30)#

SHOW IP OSPFshow ip ospf [<1-65535>]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. This command displays general information about the OSPF routing processes.

PARAMETERS

EXAMPLEALU# show ip ospf

Routing Process "ospf 1" with ID 1.1.1.2 Supports only single TOS(TOS0) routes Supports opaque LSA It is an area border and autonomous system boundary router

Parameter Description

1-65535 Internally used identification parameter for an OSPF routing process. It is locally assigned and can be any positive integer. A unique value is assigned for each OSPF routing process.

Parameter Description

1-65535 Process ID. If this argument is included, only information for the specified routing process is displayed.

563Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Open Shortest Path First

Left running head: Chapter name (automatic)

Redistributing External Routes from: connected route-map permit SPF schedule delay 5 secs, Hold time between two SPFs 10 secs Minimum LSA interval 5 secs. Minimum LSA arrival 1 secs Number of external LSA 4. Checksum Sum 0x1c8fd Number of opaque AS LSA 0. Checksum Sum 0x0 Number of areas in this router is 2. 2 normal 0 stub 0 nssa Full neighbors 2 External flood list length 0 Area BACKBONE(0) Number of interfaces in this area is 1 Area has message digest authentication SPF algorithm executed 36 times Area ranges are Number of LSA 6. Checksum Sum 0x35E53 Number of opaque link LSA 0. Checksum Sum 0x0 Flood list length 0 Area 1 Number of interfaces in this area is 1 Area has no authentication SPF algorithm executed 8 times Area ranges are Number of LSA 5. Checksum Sum 0x234A3 Number of opaque link LSA 0. Checksum Sum 0x0 Flood list length 0

Field Description

Routing process "ospf 1" with ID 1.1.1.2

Process ID and OSPF router ID.

Supports..ABR and ASBR

Number of ToS supported.

SPF schedule delay

Delay time and hold time of SPF calculations.

Minimum LSA interval

Minimum interval between link-state advertisements.

Number of external LSA

Number of external link-state advertisements.

Number of opaque AS LSA

Number of opaque link-state advertisements.

Number of areas in this router is

Number of areas configured for the router.

External flood list length

External flood list length.

564

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip ospf border-routers

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW IP OSPF BORDER-ROUTERSshow ip ospf [<1-65535>] border-routers

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. This command displays the internal OSPF routing table entries to an ABR and ASBR.

PARAMETERS

EXAMPLE ALU# show ip ospf border-routers

OSPF Process 1 internal Routing Table Codes : i - Intra-area route, I - Inter-area route i 6.6.6.6 [100] via 2.2.2.1, FastEthernet 0, ABR, Area 1, SPF 5

Parameter Description

1-65535 Process ID. This parameter when specified displays the internal OSPF routing table entries to an ABR and ASBR for the specified process ID.

Field Description

6.6.6.6 Router ID of the destination.

[100] Cost of using this route.

via 2.2.2.1 Next hop toward the destination.

FastEthernet 0 Interface type for the outgoing interface.

ABR The router type of the destination; it is either an ABR or ASBR or both.

Area The area ID of the area from which this route is learned.

SPF 5 The internal number of the shortest path first (SPF) calculation that installs this route.

565Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Open Shortest Path First

Left running head: Chapter name (automatic)

SHOW IP OSPF DATABASEThe different formats of this command are listed below:

show ip ospf [<1-65535>] database

show ip ospf [process-id [area-id]] database [adv-router [ip-address]]

show ip ospf [process-id [area-id]] database [asbr-summary] [link-state-id]

show ip ospf [process-id [area-id]] database [asbr-summary] [link-state-id] [adv-router [ip-address]]

show ip ospf [process-id [area-id]] database [asbr-summary] [link-state-id] [self-originate][link-state-id]

show ip ospf [process-id [area-id]] database [database-summary]

show ip ospf [process-id [area-id]] database [external] [link-state-id]

show ip ospf [process-id [area-id]] database [external] [link-state-id] [adv-router [ip-address]]

show ip ospf [process-id [area-id]] database [external] [link-state-id] [self-originate][link-state-id]

show ip ospf [process-id [area-id]] database [network] [link-state-id]

show ip ospf [process-id [area-id]] database [network] [link-state-id] [adv-router [ip-address]]

show ip ospf [process-id [area-id]] database [network] [link-state-id] [self-originate][link-state-id]

show ip ospf [process-id [area-id]] database [nssa-external] [link-state-id]

show ip ospf [process-id [area-id]] database [nssa-external] [link-state-id] [adv-router [ip-address]]

show ip ospf [process-id [area-id]] database [nssa-external] [link-state-id] [self-originate][link-state-id]

show ip ospf [process-id [area-id]] database [opaque-area] [link-state-id]

show ip ospf [process-id [area-id]] database [opaque-area] [link-state-id] [adv-router [ip-address]]

566

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip ospf database

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

show ip ospf [process-id [area-id]] database [opaque-area] [link-state-id] [self-originate][link-state-id]

show ip ospf [process-id [area-id]] database [opaque-as] [link-state-id]

show ip ospf [process-id [area-id]] database [opaque-as] [link-state-id] [adv-router[ip-address]]

show ip ospf [process-id [area-id]] database [opaque-as] [link-state-id] [self-originate][link-state-id]

show ip ospf [process-id [area-id]] database [opaque-link] [link-state-id]

show ip ospf [process-id [area-id]] database [opaque-link] [link-state-id] [adv-router [ip-address]]

show ip ospf [process-id [area-id]] database [opaque-link] [link-state-id] [self-originate] [link-state-id]

show ip ospf [process-id [area-id]] database [router] [link-state-id]

show ip ospf [process-id [area-id]] database [router] [adv-router [ip-address]]

show ip ospf [process-id [area-id]] database [router] [self-originate] [link-state-id]

show ip ospf [process-id [area-id]] database [self-originate] [link-state-id]

show ip ospf [process-id [area-id]] database [summary] [link-state-id]

show ip ospf [process-id [area-id]] database [summary] [link-state-id] [adv-router [ip-address]]

show ip ospf [process-id [area-id]] database [summary] [link-state-id] [self-originate][link-state-id]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. This command displays lists of information related to the OSPF database for a specific router.

567Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Open Shortest Path First

Left running head: Chapter name (automatic)

PARAMETERS OF ‘SHOW IP OSPF DATABASE’

EXAMPLE Example 1To see summary of LSAs in router database, use the following command:

show ip ospf database

OSPF Router with ID (4.4.4.2) (Process ID 100)

Router Link States (Area 0)

Link ID ADV Router Age Seq# Checksum Link count2.2.2.2 2.2.2.2 1018 0x80000025 0x3EC5 14.4.4.2 4.4.4.2 52 0x80000024 0xC1E6 1

Net Link States (Area 0)

Link ID ADV Router Age Seq# Checksum

Field Description

1-65535 OSPF Process-ID.

adv-router [<ip-address>]

(Optional) Displays all the link-state advertisements (LSAs) of the specified router.

asbr-summary (Optional) Displays information only about the Autonomous System Boundary Router (ASBR) summary LSAs.

link-state-id Shows the specified type of LSA with matching link-state ID.

database-summary (Optional) Displays how many of each type of LSA for each area there are in the database, and the total.

external (Optional) Displays information only about the external LSAs.

network (Optional) Displays information only about the network LSAs.

nssa-external (Optional) Displays information only about the not so stubby area (NSSA) external LSAs.

opaque-area (Optional) Displays information about the opaque Type 10 LSAs. Type 10 denotes an area-local scope. Refer to RFC 2370 for more information on the opaque LSA options.

router (Optional) Displays information only about the router LSAs.

self-originate (Optional) Displays only self-originated LSAs (from the local router).

summary (Optional) Displays information only about the summary LSAs.

568

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip ospf database

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

2.2.2.2 2.2.2.2 1018 0x80000022 0x977B

Type-5 AS External Link States

Link ID ADV Router Age Seq# Checksum Tag1.1.1.0 2.2.2.2 1434 0x80000022 0x0989 03.0.0.0 2.2.2.2 1504 0x80000022 0x068C 010.0.0.0 2.2.2.2 625 0x80000022 0xAAE0 0135.254.163.0 2.2.2.2 1383 0x80000022 0x4F1C 0

Example 2To see all the external LSAs in detail, use the following command:

ALU# show ip ospf database external

OSPF Router with ID (1.1.1.2) (Process ID 1) Type-5 AS External Link States LS age: 1715 Options: (No TOS-capability, No DC) LS Type: AS External Link Link State ID: 1.1.1.0 (External Network Number ) Advertising Router: 1.1.1.2 LS Seq Number: 80000003 Checksum: 0x9F10 Length: 36 Network Mask: /24 Metric Type: 2 (Larger than any link state path) TOS: 0 Metric: 20 Forward Address: 1.1.1.2 External Route Tag: 0 LS age: 690 Options: (No TOS-capability, No DC) LS Type: AS External Link Link State ID: 2.2.2.0 (External Network Number ) Advertising Router: 1.1.1.2

Field Description

Link ID Link state ID of LSA.

ADV Router Advertising router ID of LSA.

Age LSA age.

Seq# LSA sequence number.

Checksum LSA checksum.

Link count Number of links in LSA.

569Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Open Shortest Path First

Left running head: Chapter name (automatic)

LS Seq Number: 80000004 Checksum: 0x9D0B Length: 36 Network Mask: /24 Metric Type: 2 (Larger than any link state path) TOS: 0 Metric: 20 Forward Address: 2.2.2.2 External Route Tag: 0 LS age: 182 Options: (No TOS-capability, DC) LS Type: AS External Link Link State ID: 3.3.3.0 (External Network Number ) Advertising Router: 1.1.1.1 LS Seq Number: 80000001 Checksum: 0x5D36 Length: 36 Network Mask: /24 Metric Type: 2 (Larger than any link state path) TOS: 0 Metric: 20 External Route Tag: 0 LS age: 1654 Options: (No TOS-capability, No DC) LS Type: AS External Link Link State ID: 45.5.5.0 (External Network Number ) Advertising Router: 1.1.1.2 LS Seq Number: 80000003 Checksum: 0xC4BB Length: 36 Network Mask: /24 Metric Type: 2 (Larger than any link state path) TOS: 0 Metric: 20 Forward Address: 0.0.0.0 External Route Tag: 0

570

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip ospf database

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

Example 3To see all the network LSAs in detail, use the following command:

ALU# show ip ospf database network

OSPF Router with ID (1.1.1.2) (Process ID 1) Net Link States (Area 0) Routing Bit Set on this LSA LS age: 2459 Options: (No TOS-capability, No DC, Opq Bit) LS Type: Network Links Link State ID: 2.2.2.1 (address of Designated Router) Advertising Router: 6.6.6.6 LS Seq Number: 80000006 Checksum: 0xB91F Length: 32 Network Mask: /32 Attached Router: 6.6.6.6 Attached Router: 1.1.1.2 Routing Bit Set on this LSA LS age: 1150 Options: (No TOS-capability, No DC, Opq Bit) LS Type: Network Links Link State ID: 1.1.1.2 (address of Designated Router) Advertising Router: 1.1.1.2 LS Seq Number: 80000004 Checksum: 0xBD46 Length: 32 Network Mask: /32 Attached Router: 1.1.1.1 Attached Router: 1.1.1.2 Net Link States (Area 1) Routing Bit Set on this LSA LS age: 1776 Options: (No TOS-capability, No DC, Opq Bit) LS Type: Network Links Link State ID: 2.2.2.2 (address of Designated Router) Advertising Router: 1.1.1.2 LS Seq Number: 80000001 Checksum: 0x4AA5 Length: 32 Network Mask: /32 Attached Router: 6.6.6.6 Attached Router: 1.1.1.2

571Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Open Shortest Path First

Left running head: Chapter name (automatic)

Example 4To see external LSAs advertised by router 1.1.1.2, use the following command:

show ip ospf database external adv-router 1.1.1.2 OSPF Router with ID (1.1.1.2) (Process ID 1) Type-5 AS External Link States LS age: 1739 Options: (No TOS-capability, No DC) LS Type: AS External Link Link State ID: 1.1.1.0 (External Network Number ) Advertising Router: 1.1.1.2 LS Seq Number: 80000003 Checksum: 0x9F10 Length: 36 Network Mask: /24 Metric Type: 2 (Larger than any link state path) TOS: 0 Metric: 20 Forward Address: 1.1.1.2 External Route Tag: 0 LS age: 714 Options: (No TOS-capability, No DC) LS Type: AS External Link Link State ID: 2.2.2.0 (External Network Number ) Advertising Router: 1.1.1.2 LS Seq Number: 80000004 Checksum: 0x9D0B Length: 36 Network Mask: /24 Metric Type: 2 (Larger than any link state path) TOS: 0 Metric: 20 Forward Address: 2.2.2.2 External Route Tag: 0 LS age: 1678 Options: (No TOS-capability, No DC) LS Type: AS External Link Link State ID: 45.5.5.0 (External Network Number ) Advertising Router: 1.1.1.2 LS Seq Number: 80000003 Checksum: 0xC4BB Length: 36 Network Mask: /24 Metric Type: 2 (Larger than any link state path) TOS: 0 Metric: 20 Forward Address: 0.0.0.0 External Route Tag: 0

572

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip ospf database

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

Example 5To see all router LSAs, use the following command:

ALU# show ip ospf database router OSPF Router with ID (1.1.1.2) (Process ID 1) Router Link States (Area 0) LS age: 979 Options: (No TOS-capability, DC) LS Type: Router Links Link State ID: 1.1.1.1 Advertising Router: 1.1.1.1 LS Seq Number: 800000FC Checksum: 0xAE6C Length: 36 Number of Links: 1 Link connected to: a Transit Network (Link ID) Designated Router address: 1.1.1.2 (Link Data) Router Interface address: 1.1.1.1 Number of TOS metrics: 0 TOS 0 Metrics: 10 LS age: 118 Options: (No TOS-capability, No DC, Opq Bit) LS Type: Router Links Link State ID: 1.1.1.2 Advertising Router: 1.1.1.2 LS Seq Number: 80000019 Checksum: 0xF2F0 Length: 36 Number of Links: 1 Link connected to: a Transit Network (Link ID) Designated Router address: 1.1.1.2 (Link Data) Router Interface address: 1.1.1.2 Number of TOS metrics: 0 TOS 0 Metrics: 1 LS age: 2452 Options: (No TOS-capability, No DC, Opq Bit) LS Type: Router Links Link State ID: 6.6.6.6 Advertising Router: 6.6.6.6 LS Seq Number: 80000008 Checksum: 0xC20B Length: 36 Number of Links: 1

573Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Open Shortest Path First

Left running head: Chapter name (automatic)

Link connected to: a Transit Network (Link ID) Designated Router address: 2.2.2.1 (Link Data) Router Interface address: 2.2.2.1 Number of TOS metrics: 0 TOS 0 Metrics: 1 Router Link States (Area 1) LS age: 1766 Options: (No TOS-capability, No DC, Opq Bit) LS Type: Router Links Link State ID: 1.1.1.2 Advertising Router: 1.1.1.2 LS Seq Number: 80000005 Checksum: 0x579A Length: 36 Number of Links: 1 Link connected to: a Transit Network (Link ID) Designated Router address: 2.2.2.2 (Link Data) Router Interface address: 2.2.2.2 Number of TOS metrics: 0 TOS 0 Metrics: 1 LS age: 1767 Options: (No TOS-capability, No DC, Opq Bit) LS Type: Router Links Link State ID: 6.6.6.6 Advertising Router: 6.6.6.6 LS Seq Number: 80000002 Checksum: 0xD8F9 Length: 36 Number of Links: 1 Link connected to: a Transit Network (Link ID) Designated Router address: 2.2.2.2 (Link Data) Router Interface address: 2.2.2.1 Number of TOS metrics: 0 TOS 0 Metrics: 1

574

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip ospf database

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

Example 6To see all the self originated LSAs, use the following command:

show ip ospf database self-originate

OSPF Router with ID (1.1.1.2) (Process ID 1) Router Link States (Area 0) Link ID ADV Router Age Seq# Checksum Link count1.1.1.2 1.1.1.2 110 0x80000019 0xF2F0 1 Net Link States (Area 0) Link ID ADV Router Age Seq# Checksum1.1.1.2 1.1.1.2 1135 0x80000004 0xBD46 Summary Net Link States (Area 0) Link ID ADV Router Age Seq# Checksum2.2.2.0 1.1.1.2 110 0x80000002 0x43CC Router Link States (Area 1) Link ID ADV Router Age Seq# Checksum Link count1.1.1.2 1.1.1.2 1758 0x80000005 0x579A 1 Net Link States (Area 1) Link ID ADV Router Age Seq# Checksum2.2.2.2 1.1.1.2 1761 0x80000001 0x4AA5 Summary Net Link States (Area 1) Link ID ADV Router Age Seq# Checksum1.1.1.0 1.1.1.2 110 0x80000003 0x65AC Summary ASBR Link States (Area 1) Link ID ADV Router Age Seq# Checksum1.1.1.1 1.1.1.2 110 0x80000002 0x4FC1 Type-5 AS External Link States Link ID ADV Router Age Seq# Checksum Tag1.1.1.0 1.1.1.2 1678 0x80000003 0x9F10 02.2.2.0 1.1.1.2 653 0x80000004 0x9D0B 045.5.5.0 1.1.1.2 1617 0x80000003 0xC4BB 0

575Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Open Shortest Path First

Left running head: Chapter name (automatic)

Example 7To see all the Summary LSAs, use the following command:

ALU# show ip ospf database summary

OSPF Router with ID (1.1.1.2) (Process ID 1) Summary Net Link States (Area 0) LS age: 133 Options: (No TOS-capability, No DC, Opq Bit) LS Type: Summary Links (Network) Link State ID: 2.2.2.0 (summary Network Number) Advertising Router: 1.1.1.2 LS Seq Number: 80000002 Checksum: 0x43CC Length: 28 Network Mask: /24 TOS: 0 Metric: 1 Summary Net Link States (Area 1) LS age: 133 Options: (No TOS-capability, No DC, Opq Bit) LS Type: Summary Links (Network) Link State ID: 1.1.1.0 (summary Network Number) Advertising Router: 1.1.1.2 LS Seq Number: 80000003 Checksum: 0x65AC Length: 28 Network Mask: /24 TOS: 0 Metric: 1

576

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip ospf flood-list

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW IP OSPF FLOOD-LIST show ip ospf flood-list [<interface-name>]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. This command displays a list of LSAs waiting to be flooded over an interface.

PARAMETERS

EXAMPLEALU# show ip ospf flood-list

OSPF Router with ID (1.1.1.2) (Process ID 1)

Interface FastEthernet 0, Queue length 1 Type LS ID ADV RTR Seq NO Age Checksum 1 1.1.1.2 1.1.1.2 0x8000001D 0 0x04EA

Parameter Description

interface-name Name of the interface.

Parameter Description

Interface FastEthernet Interface for which information is displayed.

Queue length Number of LSAs waiting to be flooded.

Type Type of LSA.

LS ID Link-state ID of the LSA.

ADV RTR Router ID of the advertising router.

Seq NO Sequence number of the LSA.

Age Age of LSA (in seconds).

Checksum Checksum of LSA.

577Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Open Shortest Path First

Left running head: Chapter name (automatic)

SHOW IP OSPF INTERFACEshow ip ospf [<1-65535>] interface [{<interface-name> |statistics [<interface-name>]}]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. This command displays OSPF-related interface information.

PARAMETERS

EXAMPLE

EXAMPLE 1ALU# show ip ospf interface

FastEthernet0 is up, line protocol is up Internet Address 2.20.1.1/8, Area 0 Process ID 100, Router ID 4.4.4.2, Network Type BROADCAST, Cost: 10 Transmit Delay is 1 sec, State BDR, Priority 1 Designated Router (ID) 2.2.2.2, Intf address 2.2.2.2 Backup Designated router (ID) 4.4.4.2, Intf address 2.20.1.1 Timer intervals configured, Hello 10, Dead 40, Wait 40, Retransmit 5 Hello due in 00:00:07 Neighbor Count is 1, Adjacent neighbor count is 1 Adjacent with neighbor 2.2.2.2 (Designated Router) Suppress hello for 0 neighbor(s)

EXAMPLE 2ALU# show ip ospf interface FastEthernet 0

FastEthernet0 is up, line protocol is up Internet Address 2.20.1.1/8, Area 0 Process ID 100, Router ID 4.4.4.2, Network Type BROADCAST, Cost: 10 Transmit Delay is 1 sec, State BDR, Priority 1 Designated Router (ID) 2.2.2.2, Intf address 2.2.2.2 Backup Designated router (ID) 4.4.4.2, Intf address 2.20.1.1 Timer intervals configured, Hello 10, Dead 40, Wait 40, Retransmit 5 Hello due in 00:00:07 Neighbor Count is 1, Adjacent neighbor count is 1 Adjacent with neighbor 2.2.2.2 (Designated Router) Suppress hello for 0 neighbor(s)

Parameter Description

1-65535 Process ID. If this argument is included, only information for the specified routing process is displayed.

interface-name Name of the interface.

statistics Displays the OSPF statistics.

578

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip ospf interface

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

EXAMPLE 3ALU# show ip ospf interface statistics

FastEthernet0 Internet Address 2.20.1.1/8, ProcessID 100, Area 0 Hello Packets Received 6049, Hello Packets Sent 6115 Database Description Packets Received 4, Database Description Packets Sent 3 LS Request Packets Received 1, LS Request Packets Sent 2 LS Update Packets Received 202, LS Update Packets Sent 39 LS Acknowledgment Packets Received 39, LS Acknowledgment Packets Sent 166 Errors 0, Events 0

Parameter Description

FastEthernet Status of physical link and operational status of the protocol.

Internet Address Interface IP address, subnet mask, and area address.

Process ID OSPF Process ID.

Router ID OSPF Router ID.

Network Type The interface network type.

Transmit Delay Interface transmit delay, interface state, and router priority.

Designated Router Designated router ID and respective interface IP address.

Backup Designated Router Backup designated router ID and respective interface IP address.

Timer intervals configured Configuration of timer intervals.

Hello Number of seconds until next hello packet is sent out this interface.

Neighbor Count Count of neighbors and list of adjacent neighbors on an interface.

579Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Open Shortest Path First

Left running head: Chapter name (automatic)

SHOW IP OSPF INTERFACE-PROCESSshow ip ospf interface-process [<interface-name>]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. This command displays the interface-process table.

PARAMETERS

EXAMPLEALU(config)# show ip ospf interface-process Interface-Process Table:

Interface Attached Process Waiting Process

FastEthernet0 100 -

switchport0 - -

switchport1 - -

switchport2 - -

switchport3 - -

atm0 - -

Vlan2 - -

Vlan3 - -

Tunnel5 - -

FastEthernet0:1 - -

Parameter Description

interface-name Name of the interface.

580

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip ospf neighbor

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW IP OSPF NEIGHBORshow ip ospf [<1-65535>] neighbor [neighbor-router-id] [<interface-name>][detail]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. This command displays the OSPF neighbor information on a per-interface basis.

PARAMETERS

EXAMPLE

EXAMPLE 1ALU# show ip ospf neighbor

Process ID 100Neighbor ID Pri State Dead Time Address Interface2.2.2.2 1 FULL/DR 00:00:31 2.2.2.2 FastEthernet0

EXAMPLE 2ALU# show ip ospf neighbor FastEthernet 0

Process ID 100Neighbor ID Pri State Dead Time Address Interface2.2.2.2 1 FULL/DR 00:00:31 2.2.2.2 FastEthernet0

EXAMPLE 3ALU# show ip ospf neighbor detail

Neighbor 2.2.2.2, interface address 2.2.2.2 In the area 0 via interface FastEthernet0 Neighbor priority is 1, State is FULL, 5 state changes DR is 2.2.2.2 BDR is 2.20.1.1 Options is 0x2 Dead timer due in 00:00:32 Neighbor is up for 17:00:16 retransmission queue length 0, number of retransmissions 1

Parameter Description

1-65535 Process ID. If this argument is included, only information for the specified routing process is displayed.

neighbor-router-id (Optional) Neighbor router ID.

interface-name Name of the interface.

detail (Optional) Displays all neighbors given in detail (lists all neighbors).

581Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Open Shortest Path First

Left running head: Chapter name (automatic)

Parameter Description

Neighbor Neighbor router ID.

Interface address IP address of the interface.

In the area Area and interface through which the OSPF neighbor is known.

Neighbor priority Router priority of the neighbor, neighbor state.

State changes Number of state changes since the neighbor was created. This value can be reset using the ‘clear ip ospf counters neighbor’ command.

DR is Router ID of the designated router for the interface.

BDR is Router ID of the backup designated router for the interface.

Options Hello packet options field contents.

Dead timer due in Expected time before the router declares the neighbor dead.

Neighbor is up for Number of hours:minutes:seconds since the neighbor went into two-way state.

retransmission queue length Number of elements in the retransmission queue. Number of times update packets have been resent during flooding.

582

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip ospf process-interface

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW IP OSPF PROCESS-INTERFACEshow ip ospf process-interface

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. This command displays the process interface table.

PARAMETERS None.

EXAMPLEALU(config-router ospf 20)# show ip ospf process-interface

Process-Interface Table:

Process-Id Interfaces

100 FastEthernet0

583Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Open Shortest Path First

Left running head: Chapter name (automatic)

SHOW IP OSPF REQUEST-LISTshow ip ospf [<1-65535>] request-list [neighbor-router-id][<interface-name>]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. This command is used to display a list of all LSAs requested by a router.

PARAMETERS

EXAMPLE ALU# show ip ospf request-list

OSPF Router with ID (1.1.1.2) (Process ID 1)

Neighbor 6.6.6.6, interface FastEthernet0 address 2.2.2.2

Type LS ID ADV RTR Seq NO Age Checksum1280 192.175.142.0 1.1.1.1 0x80000003 774 0x9FFB1280 192.175.206.0 1.1.1.1 0x80000003 774 0xDC7E1280 192.175.15.0 1.1.1.1 0x80000003 774 0x1A01

Parameter Description

1-65535 Process ID. If this argument is included, only information for the specified routing process is displayed.

neighbor-router-id Neighbor router ID.Displays the list of all LSAs requested by the router on this interface from this neighbor.

interface-name Displays the list of all LSAs requested by the router from the specified interface.

584

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip ospf retransmission-list

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW IP OSPF RETRANSMISSION-LISTshow ip ospf [<1-65535>] retransmission-list [neighbor-router-id] [<interface-name>]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. This command displays a list of all LSAs waiting to be re-sent.

PARAMETERS

EXAMPLEALU# show ip ospf retransmission-list

OSPF Router with ID (1.1.1.2) (Process ID 1)

Neighbor 6.6.6.6, interface FastEthernet0 address 2.2.2.2 Link state retransmission due in 0 sec, Queue length 1

Type LS ID ADV RTR Seq NO Age Checksum 3 1.1.1.0 1.1.1.2 0x80000001 2 0x69AA

Parameter Description

1-65535 Process ID. If this argument is included, only information for the specified routing process is displayed.

neighbor-router-id (Optional) Neighbor router ID.Displays the list of all LSAs waiting to be resent for this neighbor.

interface-name Displays the list of all LSAs waiting to be resent on a specified interface.

585Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Open Shortest Path First

Left running head: Chapter name (automatic)

SHOW IP OSPF ROUTEshow ip ospf [<1-65535>] route

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. Displays the OSPF internal routing table.

PARAMETERS

EXAMPLEALU(config-router ospf 20)# show ip ospf route

OSPF Router with ID (1.1.1.2) (Process ID 1) Dest/Mask Type Adv-Rtr Cost Area/tag NextHop2.0.0.0/8 Summ 1.1.1.2 20 0 0.0.0.01.1.1.0/24 Ext-2 0.0.0.0 20 0 1.1.1.22.0.0.0/8 Summ 1.1.1.2 20 0 0.0.0.02.2.2.0/24 Ext-2 0.0.0.0 20 0 2.2.2.245.5.5.0/24 Ext-2 0.0.0.0 20 0 0.0.0.0ALU#

Parameter Description

1-65535 Process ID. If this argument is included, only information for the specified routing process is displayed.

586

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip ospf summary-address

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW IP OSPF SUMMARY-ADDRESSshow ip ospf [<1-65535>] summary-address

DESCRIPTION

This command is entered in the Router Configuration Mode. This command displays a list of all summary address redistribution information configured under an OSPF process.

PARAMETERS

EXAMPLE

The following is sample output from the ‘show ip ospf summary-address’ command: ALU# show ip ospf summary-address

OSPF Process 1, Summary-address

192.175.0.0/255.255.0.0 Metric -1, Type 2, Tag 4 2.0.0.0/255.0.0.0 Metric 20, Type 2, Tag 0

Parameter Description

1-65535 Process ID. If this argument is included, only information for the specified routing process is displayed.

587Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Open Shortest Path First

Left running head: Chapter name (automatic)

SHOW IP OSPF VIRTUAL-LINKSshow ip ospf [<1-65535>] virtual-links

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Router Configuration Mode. This command displays parameters and the current state of OSPF virtual links.

PARAMETERS

EXAMPLE

The following is a sample output from the ‘show ip ospf virtual-links’ command:

ALU# show ip ospf virtual-links

Virtual Link VLINK to router 6.6.6.6 is up Run as demand circuit DoNotAge LSA not allowed Transit area 1, via interface FastEthernet0, Cost of using 1 Transmit Delay is 1 sec, State POINT-TO-POINT Timer intervals configured, Hello 10, Dead 40, Wait 40, Retransmit 5 Hello due in 00:00:04 Adjacency state FULL Retransmission queue length 2, number of retransmission 0

Parameter Description

1-65535 Process ID. If this argument is included, only information for the specified routing process is displayed.

Parameter Description

Virtual Link to router 6.6.6.6 is up

Specifies the OSPF neighbor, and if the link to that neighbor is up or down.

Transit area The transit area through which the virtual link is formed.

via interface FastEthernet0 The interface through which the virtual link is formed.

Cost of using 1 The cost of reaching the OSPF neighbor through the virtual link.

Transmit Delay is 1 sec The transmit delay (in seconds) on the virtual link.

State POINT_TO_POINT The interface state.

Timer intervals... The various timer intervals configured for the link.

588

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

summary-address

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SUMMARY-ADDRESSsummary-address {<ip-address subnet-mask|<ip-address/prefix- length>} [not-advertise|tag <0-4294967295>]

DESCRIPTION

This command is entered in the Router Configuration Mode. This command specifies an address and mask that covers redistributed routes, so only one summary route is advertised.

PARAMETERS

DEFAULT VALUE None.

EXAMPLE

ALU(config-router ospf 30)# summary-address 20.0.0.0/8 tag 20

ALU(config-router ospf 30)# summary-address 10.0.0.0/8 not advertise

Hello due in 00:00:04 When the next hello is expected from the neighbor.

Adjacency State FULL The adjacency state between the neighbors.

Retransmission queue Number of elements in the retransmission queue. Number of times update packets have been resent during flooding.

Parameter Description

ip-address Summary address designated for a range of addresses.

<ip-address subnet-mask|<ip-address/prefix- length>

IP subnet mask or prefix length used for the summary route.

not-advertise Use the optional not-advertise keyword to filter out a set of routes.

0-4294967295 Tag value that can be used as a ‘match’ value for controlling redistribution via route maps. This keyword applies to OSPF only.

Parameter Description

589Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Open Shortest Path First

Left running head: Chapter name (automatic)

TIMERS LSA-GROUP-PACINGtimers lsa-group-pacing <10-1800>

DESCRIPTION

This command is entered in the Router Configuration Mode. This command changes the group pacing of LSAs.

PARAMETERS

DEFAULT VALUE The default lsa-group pacing interval is 60 seconds.

EXAMPLEALU(config-router ospf 30)# timers lsa-group-pacing 100

Parameter Description

10-1800 The interval in seconds at which LSAs are grouped and refreshed, check-summed or aged.

590

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

timers spf

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

TIMERS SPFtimers spf {<0-65535> <0-65535>}

DESCRIPTION

This command is entered in the Router Configuration Mode. This command is used to configure the delay time and hold time for Shortest Path First (SPF) calculation.

PARAMETERS

DEFAULT VALUE

SPF schedule delay is 5 seconds.

Hold time between two SPFs is 10 seconds.

EXAMPLE

ALU(config-router ospf 30)# timers spf 20 10

Parameter Description

0-65535 spf delay: Delay time (in seconds) between when OSPF receives a topology change and when it starts an SPF calculation. The default time is 5 seconds.A value of ‘0; means that there is no delay; that is, the SPF calculation starts immediately.

0-65535 spf hold: Minimum time (in seconds) between two consecutive SPF calculations. The default time is 10 seconds. A value of ‘0’ means two consecutive SPF calculations can be done one immediately after the other.

591Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Open Shortest Path First

Left running head: Chapter name (automatic)

WRITE OSPFwrite ospf

DESCRIPTION

This command is entered in the Router Configuration Mode. This command is used to view the OSPF running configuration.

PARAMETERS

None.

EXAMPLEALU(config-router ospf 30)# write ospf

592

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Multicast Routing

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 26 MULTICAST ROUTING

This chapter lists the commands to monitor and configure the Multicast Routing Protocols.

It includes table of parameters, default values, and configuration examples for Multicast Routing configuration as quick-start and reference information. The commands are described in alphabetical order. For more detailed information about Multicast Routing configuration, refer to the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

593Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Multicast Routing

Left running head: Chapter name (automatic)

PIM CONFIGURATION COMMANDS

CLEAR IP PIM NEIGHBORclear ip pim neighbor {*| <interface-name> {[neighbor-address]|*}}

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command clears the neighbor information on an interface.

PARAMETERS

EXAMPLEALU# clear ip pim neighbor FastEthernet 0 1.1.1.1

CLEAR IP PIM STATE-INFOclear ip pim state-info [<group-address>] [<source-address>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode.This command clears the SG State information.

PARAMETERS

EXAMPLEALU# clear ip pim state-info

Parameter Description

* Clears all neighbor information.

interface-name Clears neighbor information on the specified interface.

neighbor-address Clears the specified neighbor information.

Parameter Description

group-address Address of the multicast group.

source-address Clears the PIM states of the specified source (S) for given group (G) i.e. (S,G) states.

594

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ip multicast-routing

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IP MULTICAST-ROUTINGip multicast-routing

DESCRIPTION

This command is entered in the Router Configuration Mode. This command enables multicast routing and forwarding on OmniAccess 5510 USG.

PARAMETERS

None.

DEFAULT

Disabled by default.

EXAMPLEALU(config)# ip multicast-routing

595Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Multicast Routing

Left running head: Chapter name (automatic)

IP PIM BSR-CANDIDATEip pim bsr-candidate {BSRAdminZone prefix/mask <interface-name>|<interface-name>} [<0-32>] [<0-255>]

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure the PIM router as BSR candidate. BSR uses specified interface address.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# ip pim bsr-candidate FastEthernet 0 1 10

Parameter Description

BSRAdminZone prefix/mask

BSR Admin Zone can take all multicast addresses that is greater than 224.0.0.0. For example, if the Admin Zone is 225.0.0.0/8, all the group addresses starting with 225 will map to same Rendezvous Point (RP). This is used for mapping multiple groups to same RP, when BSR is used for RP election.

interface-name Name of the interface.

0-32 Indicates the hash-mask-length. This value is used to select one RP.

0-255 Indicates the priority of the BSR router.

596

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ip pim dr-priority

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IP PIM DR-PRIORITY ip pim dr-priority <0-4294967294>

DESCRIPTION

This command is entered in the Interface Configuration Mode. Specifies PIM router DR priority on interface. This DR priority is used in the DR election algorithm.

PARAMETERS

DEFAULT VALUE

Default DR-priority is 1.

EXAMPLEALU(config-if FastEthernet0)# ip pim dr-priority 2

IP PIM MESSAGE-INTERVAL ip pim message-interval <1-65535>

DESCRIPTION

This command is entered in the Configuration Mode. PIM router sends periodic join and prune messages on interfaces over which it has at least one neighborship. Use this command to configure this interval (in seconds).

PARAMETERS

DEFAULT VALUE

The default message-interval is 60 seconds.

EXAMPLEALU(config)# ip pim message-interval 30

Parameter Description

0-4294967294 The DR priority range.

Parameter Description

1-65535 Denotes the interval between periodic join and prune messages.

597Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Multicast Routing

Left running head: Chapter name (automatic)

IP PIM NEIGHBOR-FILTER ip pim neighbor-filter {<1-99>|<standard access-list-name>}

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to prevent PIM router from forming neighborship with other router. Using access-list, you can specify permitted neighbors.

PARAMETERS

DEFAULT VALUE

By default, PIM router forms neighborship with all the routers on an interface.

EXAMPLEALU(config-if FastEthernet0)# ip pim neighbor-filter acc-list1

IP PIM RP-ADDRESS ip pim rp-address <ip-address> [override]

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure the RP router address for all multicast groups.

Note: All routers in the PIM domain should have same RP address for a multicast group.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# ip pim rp-address 11.0.0.3

Parameter Description

1-99 Standard access-list number.

standard ip access-list-name

Name of the IP standard access list. Use this to specify permitted neighbors.

Parameter Description

ip-address RP router address.

override This is used to give preference to static RP over dynamic RP.

598

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ip pim rp-candidate

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IP PIM RP-CANDIDATEip pim rp-candidate <interface-name> [group-list {<access-list-name>|<1-99>}]

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure the PIM router as RP candidate. RP uses specified interface address.

BSR selects the RP with the highest priority.

If multiple routers are candidate RP for same group, then BSR calculates the hash value, and with the highest hash value becomes RP.

If more than one RP has the same hash value, the RP with the highest IP address is chosen.

Note: All routers in the PIM domain should have same RP address for a multicast group.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# ip pim rp-candidate FastEthernet 0 group-list 30

Parameter Description

interface-name Name of the interface.

access-list-name Name of a specific access list.

1-99 Standard access-list number.

599Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Multicast Routing

Left running head: Chapter name (automatic)

IP PIM RP-CANDIDATE-PRIORITYip pim rp-candidate-priority <0-255>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure the priority of the RP candidate.

PARAMETERS

DEFAULT VALUE

Default priority is 0.

EXAMPLEALU(config)# ip pim rp-candidate-priority 10

IP PIM SPARSE-MODE ip pim sparse-mode

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to enable PIM on an interface. After enabling this command, PIM starts sending hello packets to form neighborship.

PARAMETERS

None.

DEFAULT VALUE

By default PIM is not enabled on an interface.

EXAMPLEALU(config-if FastEthernet0)# ip pim sparse-mode

Parameter Description

0-255 Indicates the priority of the RP candidate. The RP which has the highest priority becomes the RP for a group specified by the group list.

600

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ip pim spt-threshold

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IP PIM SPT-THRESHOLD ip pim spt-threshold {<0-4294967>|infinity} [group-list {<1-99>|<1300-1999>|<standard access-list-name>}

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure the SPT threshold value.

PARAMETERS

DEFAULT VALUE

Switch to SPT just after receiving first packet. That means ‘0’ Kbps.

EXAMPLEALU(config)# ip pim spt-threshold 100 group-list 10

Parameter Description

0-4294967 Traffic rate in kilobytes per second.

infinity Threshold is configured as infinity, which means never to switch-over from RPT to SPT.

1-99 Standard access-list number.

1300-1999 Standard access-list number (expanded range)

standard access-list-name

Name of a specific access list.

601Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Multicast Routing

Left running head: Chapter name (automatic)

IP PIM QUERY-INTERVALip pim query-interval <0-65535>

DESCRIPTION

This command is entered in the Interface Configuration Mode. PIM router sends periodic hello messages on all PIM enabled interfaces. Use this command to configure this interval (in seconds).

PARAMETERS

DEFAULT VALUE

The default query-interval is 30 seconds.

EXAMPLEALU(config-if FastEthernet0)# ip pim query-interval 50

NO IP PIM SPARSE-MODEno ip pim sparse-mode

This command is entered in the Interface Configuration Mode. This command is used to disable PIM on an interface.

Parameter Description

0-65535 Denotes the interval between periodic hello messages.

602

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip pim rp-hash

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW IP PIM RP-HASH show ip pim rp-hash [<group-address>]

DESCRIPTION

This command is entered in the Super User Mode, Configuration Mode or Interface Configuration Mode.

This command is used to see group to RP mapping. If RP information for the given group does not exist then command gives error else output shows the RP information for the given group.

PARAMETERS

EXAMPLEALU(config)# show ip pim rp-hash 227.0.0.1 RP 1.1.1.1 (?) Priority - 0 Holdtime - 150, v2 Info source: 1.1.1.1 (?), via bootstrap Uptime: 00:00:32, expires 00:01:58

SHOW IP PIM BSR-ROUTERshow ip pim bsr-router

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the BSR information.

PARAMETERS

None.

EXAMPLEALU(config)# show ip pim bsr-router

PIMv2 Bootstrap informationThis system is the Bootstrap Router (BSR) BSR Address: 1.1.1.2 (?) Uptime: 00:04:24, BSR Priority: 0, Hash Mask Length: 30 Next Bootstrap Message in 00:00:46 seconds Candidate RP: 2.2.2.1 (FastEthernet0), Group Acl: test Next Cand_RP_Advertisement in 00:00:35 secondsALU(config)#

Parameter Description

group-address RO address for a given group.

603Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Multicast Routing

Left running head: Chapter name (automatic)

SHOW IP PIM INTERFACEshow ip pim interface [<interface-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command shows the interfaces on which PIM is enabled, and details like interface DR priority and current DR on the interface is displayed.

PARAMETERS

EXAMPLEALU# show ip pim interface

Address Interface Ver/ Nbr Query DR DR Mode Count Intvl Prior2.20.1.1 FastEthernet0 v2/S 1 30 1 2.20.1.1

Parameter Description

interface-name Name of the interface.

604

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip pim neighbor

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW IP PIM NEIGHBORshow ip pim neighbor [<interface-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays PIM neighbors on all interfaces. To see neighbors on a specific interface, use the interface name.

PARAMETERS

EXAMPLEALU#show ip pim neighbor

PIM Neighbor TableNeighbor Interface Uptime/Expires Ver DR Address Prio/Mode2.2.2.3 FastEthernet0 18:28:59/00:01:37 v2 1/ Not DR

Parameter Description

interface-name Name of the interface.

605Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Multicast Routing

Left running head: Chapter name (automatic)

SHOW IP PIM RP MAPPINGshow ip pim rp [mapping][<group-address>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode.This command displays the group-to-RP mapping table of PIM.

PARAMETERS

EXAMPLEALU(config)# show ip pim rp mapping

PIM Group-to-RP MappingsGroup(s) 225.0.0.0/8 RP 1.1.1.1 (?) v2 Info source: 1.1.1.1 (?), via bootstrap, priority 0, holdtime = 53760 Uptime: 00:00:45, expires 14:55:15Group(s) 228.0.0.0/8 RP 2.2.2.1 (?) v2 Info source: 2.2.2.1 (?), via bootstrap, priority 0, holdtime = 38400 Uptime: 00:03:55, expires 10:39:05ALU(config)#

Parameter Description

mapping Displays all group-to-RP mappings.

group-address Displays RO address for a given group.

606

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip pim state-info

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW IP PIM STATE-INFOshow ip pim state-info [<group-address>] [<source-address>] [summary]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the PIM upstream (towards RP/Source) and downstream (towards Receivers) state information.

PARAMETERS

EXAMPLEALU# show ip pim state-info

PIMv2 State informationFlags: M - Nexthop from Mroute, T - Terminating, A - Reported by IGMP K - KeepAlive Timer Running, S - SPT bit set

(8.0.0.1,226.1.1.25), NOT JOINED 00:00:04/00:00:00, flags:TK Register: PRUNE, RP 40.0.0.1, RST 00:01:03 Incoming interface: FastEthernet0, RPF neighbor 0.0.0.0 Downstream interface state: inherited_olist:

Parameter Description

group-address Shows the PIM upstream/downstream states for given group. It includes all (*,G) and (S,G) states.

source-address This options needs to be specified with group address and used to view all the (S,G) PIM states for specified S and G.

summary Gives summary of (*,G) and (S,G) states.

607Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Multicast Routing

Left running head: Chapter name (automatic)

IGMP CONFIGURATION COMMANDS

IP IGMP ACCESS-GROUPip igmp access-group {<1-99>|<access-list-name>}

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to deny groups, which are not permitted by access-lists. This restricts the host on a subnet joining only multicast groups that are permitted by access-lists.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-if FastEthernet0)# ip igmp access-group 10

IP MULTICAST-ROUTINGip multicast-routing

DESCRIPTION

This command is entered in the Router Configuration Mode. This command enables multicast routing and forwarding on OmniAccess 5510 USG.

PARAMETERS

None.

DEFAULT

Disabled by default.

EXAMPLEALU(config)# ip multicast-routing

Parameter Description

1-99 Access list number.

access-list-name Standard access list name.

608

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ip igmp join-group

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IP IGMP JOIN-GROUPip igmp join-group <group-address>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to join specified multicast group.

PARAMETERS

DEFAULT VALUE

No group is joined by default.

EXAMPLEALU(config-if FastEthernet0)# ip igmp join-group 226.2.2.2

IP IGMP LAST-MEMBER-QUERY-COUNTip igmp last-member-query-count <1-7>

DESCRIPTION

This command is entered in the Interface Configuration Mode. Use this command to configure the number of retransmission of group-specific queries.

PARAMETERS

DEFAULT VALUE

The default last-member-query-count is 2.

EXAMPLEALU(config-if FastEthernet0)# ip igmp last-member-query-count 3

Parameter Description

group-address Address of the multicast group.

Parameter Description

1-7 Number of retransmission of group specific query. This is also called as robustness count.

609Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Multicast Routing

Left running head: Chapter name (automatic)

IP IGMP LAST-MEMBER-QUERY-INTERVALip igmp last-member-query-interval <100-65535>

DESCRIPTION

This command is entered in the Interface Configuration Mode. Use this command to configure the last-member query interval (in milliseconds) for the IGMP.

PARAMETERS

DEFAULT VALUE

The default last-member-query-interval is 1000 milliseconds.

EXAMPLEALU(config-if FastEthernet0)# ip igmp last-member-query-interval 2000

IP IGMP QUERY-INTERVALip igmp query-interval <1-65535>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to configure the interval (in seconds) at which the IGMP router sends query messages on an interface.

PARAMETERS

DEFAULT VALUE

The default query-interval is 125 seconds.

EXAMPLEALU(config-if FastEthernet0)# ip igmp query-interval 100

Parameter Description

100-65535 Denotes the time the router waits for the membership report after sending membership query.

Parameter Description

1-65535 Denotes the interval at which the IGMP router sends IGMP general query messages.

610

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ip igmp query-max-response-time

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IP IGMP QUERY-MAX-RESPONSE-TIMEip igmp query-max-response-time <1-25>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command configures the maximum response time (in seconds) advertised in IGMP queries.

PARAMETERS

DEFAULT VALUE

The default query-max-response-time is 10 seconds.

EXAMPLEALU(config-if FastEthernet0)# ip igmp query-max-response-time 20

IP IGMP QUERIER-TIMEOUTip igmp querier-timeout <60-300>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command configures the time-out value (in seconds) after which the router assumes itself to be the querier on the interface.

Note: Ensure that all IGMP routers on LAN have same querier time-out. Else, router with less querier time-out will always become querier.

PARAMETERS

DEFAULT VALUE

Default IGMP querier-timeout is 255 seconds.

EXAMPLEALU(config-if FastEthernet0)# ip igmp querier-timeout 100

Parameter Description

1-25 The maximum response time advertised in IGMP queries.

Parameter Description

60-300 Querier time-out value.

611Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Multicast Routing

Left running head: Chapter name (automatic)

IP PIM SPARSE-MODE ip pim sparse-mode

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to enable IGMP on an interface. After enabling this command, IGMP learns the multicast host information on given interface.

PARAMETERS

None.

DEFAULT VALUE

By default IGMP is not enabled on an interface.

EXAMPLEALU(config-if FastEthernet0)# ip pim sparse-mode

NO IP PIM SPARSE-MODEno ip pim sparse-mode

This command is entered in the Interface Configuration Mode. This command is used to disable IGMP on an interface.

612

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip igmp groups

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW IP IGMP GROUPSshow ip igmp groups [<group-address>] [<interface-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays all the multicast groups joined. You can enter the interface name to see multicast groups on that interface.

PARAMETERS

EXAMPLEALU# show ip igmp groups

Interface Group-Address Last-Reporter Uptime Expires(sec:msec) FastEthernet0 224.1.1.1 3.3.3.4 0:0:51 217:89 VLAN1 224.0.1.40 5.5.5.5 4:12:42 147:509

Parameter Description

group-address Displays only specified group information.

interface-name Displays groups on the specified interface.

613Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Multicast Routing

Left running head: Chapter name (automatic)

SHOW IP IGMP INTERFACEshow ip igmp interface [<interface-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays all interfaces on which the IGMP is enabled, and displays configured/default values of the IGMP interface parameters.

PARAMETERS

EXAMPLEALU# show ip igmp interface

FastEthernet0 Internet address 2.20.1.1 Mask 255.0.0.0Host version 2 Router Version 2Query Interval = 125Querier Timeout = 255Max query response time = 10Last member query count = 2Last member query response time = 1000Access Group set = 0Number of joins on this interface = 0Number of leave message on this interface = 0Number of query messages sent on this interface = 1Querier on this interface = 2.2.2.3Interface DR is 2.20.1.1Total groups on this interface 0

Parameter Description

interface-name Displays IGMP interface parameters for specified interface.

614

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Multicast Global Commands

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

MULTICAST GLOBAL COMMANDS

CLEAR IP MROUTEclear ip mroute

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command clears multicast routing information.

PARAMETERS

None.

EXAMPLEALU# clear ip mroute

CLEAR IP MULTICAST TRAFFICclear ip multicast traffic

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command resets the multicast traffic counters.

PARAMETERS

None.

EXAMPLEALU# clear ip multicast traffic

615Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Multicast Routing

Left running head: Chapter name (automatic)

SHOW IP MROUTEshow ip mroute [<group-address>] [<interface-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the multicast routing table.

PARAMETERS

EXAMPLEALU# show ip mroute

IP Multicast Forwarding Information BaseFlags: R - RP-bit set, T - SPT-bit set F - Register flag, J - Joined (*, 226.0.0.1), uptime 0:13:23, flags: J Incoming Interface: Tunnel23, RPF failures 0 Outgoing Interfaces (1): Vlan131 (10.1.1.245, 226.0.0.1), uptime 0:17:45, flags: RJ Incoming Interface: Null0, RPF failures 0 Outgoing Interfaces (1): Vlan131

Parameter Description

group-address Displays the routing table entry for the given multicast group address.

interface-name Displays the multicast routes for which specified interface is outgoing interface.

616

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip multicast traffic

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW IP MULTICAST TRAFFICshow ip multicast traffic

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the statistics of the multicast packets.

PARAMETERS

None.

EXAMPLEALU# show ip multicast traffic

IP Multicast statistics: Rcvd: 4449 total, 838 link local Sent: 3334 forwarded, 0 send register 0 send assert, 3 first data pkt notice Errors: 1 rpf failure, 1 drop

617Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Multicast Routing

Left running head: Chapter name (automatic)

618

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Policy Based Routing

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 27 POLICY BASED ROUTING

This chapter lists the commands to configure Policy Based Routing (PBR).

It includes table of parameters, default values, and configuration examples for PBR configuration as quick-start and reference information. The commands are described in alphabetical order. For more detailed information about using and configuring PBR, refer to the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

619Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Policy Based Routing

Left running head: Chapter name (automatic)

CLEAR IP-POLICY STATISTICSclear ip-policy statistics [<ip-policy name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command clears the statistics of all the IP policies configured in the system.

PARAMETERS

EXAMPLEALU(config)# clear ip-policy statistics

IP-POLICYip-policy <name>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to create an IP policy.

PARAMETERS

EXAMPLEALU(config)# ip-policy pbr1ALU(config-ip-policy-pbr1)#

Parameter Description

name Clears the statistics for the specified IP policy.

Parameter Description

name Name for the IP policy being configured.

620

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ip-policy

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

To Configure a Rule Inside an IP Policy:

[<1-65535>] match [{all|any}] <match-list name>...[not <match-list name>] {for-us|interface <interface-name> [next-hop <ip-address>]|next-hop <ip-address>}

This command is entered in the PBR Configuration Mode. This command is used to configure rules (set priority for the rule, associate match-lists and action) for an IP policy.

ExampleALU(config-ip-policy-pbr1)# 10 match m1 m2 not m3 interface FastEthernet 0 next hop 1.2.2.1

ALU(config-ip-policy-pbr1)# 20 match m1 m2 next hop 1.2.2.2

Parameter Description

1-65535 Denotes the routing policy rule number. The range for the IP policy rule.

match [{all|any}] <match-list name>...

match all - In this type of match, the relevant action is performed only when all the match-list criteria is satisfied.match any - In this type of match, the relevant action is performed even if any one of the match-list criterion is satisfied.

not <match-list name>] Specifies match-list with not option.

for-us This keyword redirects the packet to the management plane of OmniAccess 5510 USG.

interface <interface-name> [next-hop <ip-address>]

Specifies the egress path of the packet.If the interface and next-hop are specified together, then the packet shall be forwarded to the specified next-hop on the specified interface.

next-hop <ip-address> Specifies the egress path of the packet.

621Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Policy Based Routing

Left running head: Chapter name (automatic)

IP-POLICY <IP-POLICY NAME>ip-policy <ip-policy name>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to attach an IP policy to an interface.

Note: An interface can have only one IP policy applied on it at any time.

PARAMETERS

EXAMPLE

The following example binds the IP policy ‘pbr1’ to interface FastEthernet 0.ALU(config)# interface FastEthernet 0ALU(config-if FastEthernet0)# ip-policy pbr1

NO IP-POLICYno ip-policy <name> [force]

This command is entered in the Configuration Mode. This command is used to delete an IP policy. If the policy is attached to any of the interfaces, it cannot be deleted.

The "force" keyword will automatically detach the specified policy from respective interfaces, and deletes the IP policy. This command when used also deletes all the rules configured under this policy.

NO IP-POLICY <IP-POLICY NAME>no ip-policy <ip-policy name>

This command is entered in the Interface Configuration Mode. This command detaches an IP policy attached to an interface.

NO RULEno rule <1-65535>

This command is issued in the IP Policy Configuration Mode. The command deletes a rule corresponding to the rule number.

Parameter Description

ip-policy name Name of the IP policy.

622

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip-policy

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW IP-POLICYshow ip-policy [<name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to view all the IP policies configured in the system. This command also displays interfaces on which these policies are applied.

PARAMETERS

EXAMPLEALU(config)# show ip-policy!! IP-Policy configuration!ip-policy pbr1 10 match any m1 m2 interface FastEthernet0 next-hop 1.2.2.1exit!interface FastEthernet0 ip-policy pbr1exit

Parameter Description

name Displays the details of a specific IP policy.

623Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Policy Based Routing

Left running head: Chapter name (automatic)

SHOW IP-POLICY STATISTICSshow ip-policy statistics [<ip-policy name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to display the statistics of all the IP policies configured in the system. This displays the number of packets that hit the rules in the IP policy, and number of packets dropped.

PARAMETERS

EXAMPLEALU(config)# show ip-policy statistics

PBR - Policy Based Routed, Drop - Dropped

0 packets forwarded by best effort IP forwarding

ip-policy pbr1 : PBR - 0 Drop - 0 0 hits on : 1 match any m1 next-hop 1.1.1.1

Parameter Description

name Displays the statistics for the specified IP policy.

624

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Virtual Routing and Forwarding

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 28 VIRTUAL ROUTING AND FORWARDING

This chapter documents the Command Line Interface (CLI) commands for Virtual Routing and Forwarding Customer Edge (VRF-CE). These commands are used to configure VRF-CE on an interface.

This chapter includes tables of parameters, default values, and configuration examples for configuring the VRF-CE as quick-start and reference information. In this chapter, all commands are described in alphabetical order. For more detailed information on using and configuring the VRF-CE Protocol, refer to the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide

625Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Virtual Routing and Forwarding

Left running head: Chapter name (automatic)

ADDRESS FAMILYaddress-family ipv4 unicast [vrf <vrf-name>]

DESCRIPTION

This command is entered in the BGP Routing Configuration mode.

This command associates the address family with the VRF and enters the address-family configuration mode. If the VRF name is not specified, then the configurations are associated with the Default VRF.

PARAMETERS

EXAMPLEALU(config)# router bgp 30ALU(config-router bgp AS30)# address-family ipv4 unicast vrf ALU_vrfALU(config-router-af-ucast)#

Parameter Description

ipv4 Address family.

unicast Address family modifier.

vrf-name The name of the VRF to which the address family is to be associated.

626

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

address family

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

ADDRESS FAMILYaddress-family ipv4 unicast vrf <vrf-name>

DESCRIPTION

This command is entered in the RIP Routing Configuration Mode.

This command associates the address family with the VRF and enters the VRF configuration mode.

PARAMETERS

EXAMPLEALU(config)# router ripALU(config-router rip)# address-family ipv4 unicast vrf ALU_vrf

Parameter Description

ipv4 Address family.

unicast Address family modifier.

vrf-name The name of the VRF to which the address family is to be associated.

627Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Virtual Routing and Forwarding

Left running head: Chapter name (automatic)

ARParp [vrf <vrf-name>] <ip-address> <hardware-address>

DESCRIPTION

This command is entered in the Configuration Mode. This command adds a static ARP entry. If the VRF name is specified, then the ARP entry is added to the specified VRF, else it is added to the defualt VRF.

PARAMETERS

EXAMPLEALU(config)# arp vrf ALU-vrf 10.91.0.21 0004.9BE9.C4A8

CLEAR ARP-CACHEclear arp-cache [vrf <vrf-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to clear the ARP cache.

PARAMETERS

EXAMPLEALU(config)# clear arp-cache vrf ALU-vrf

Parameter Description

vrf-name The name of the VRF to which ARP entry is to be added.

ip-address IP address of the host for which user wants to add MAC entry.

hardware-address The MAC address of the specified host.

Parameter Description

vrf-name The name of the VRF for which the ARP cache is to be cleared.

628

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

clear arp traffic

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CLEAR ARP TRAFFICclear arp traffic [vrf <vrf-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to clear the ARP statistics counters.

PARAMETERS

EXAMPLEALU(config)# clear arp traffic ALU-vrf

CLEAR IP BGPclear ip bgp [vrf <vrf-name>] {*|<1-65535>|<ip-address>|dampening|external|flap-statistics|ipv4|peer-group}

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command clears the BGP connections. If AS number is specified, connection to the specified AS is cleared.

PARAMETERS

EXAMPLEALU(config)# clear ip bgp vrf ALU-vrf 10

Parameter Description

vrf-name If the VRF name is specified, it clears the ARP statistics for the specified VRF, else for the default VRF.

Parameter Description

1-65535 Autonomous System number. If AS number is specified, connection to the specified AS is cleared.

vrf-name Name of the VRF for which the BGP connection is to be cleared.

629Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Virtual Routing and Forwarding

Left running head: Chapter name (automatic)

CLEAR IP TRAFFICclear ip traffic [vrf <vrf-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command clears counters of IP traffic statistics.

PARAMETERS

EXAMPLEALU(config)# clear ip traffic vrf ALU-vrf

CLEAR IP ROUTEclear ip route [vrf <vrf-name>] *

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command clears the IP routing table.

PARAMETERS

EXAMPLEALU(config)# clear ip route vrf ALU-vrf *

Parameter Description

vrf-name Clears counters of IP traffic statistics in a specified VRF.

Parameter Description

vrf-name Name of the VRF for which the IP routing table is to be cleared.

630

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

description

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

DESCRIPTIONdescription <description-string>

DESCRIPTION

This command is entered in the VRF Configuration Mode. This command is used to enter the description for a created VRF. This is for user purpose only.

PARAMETERS

EXAMPLEALU(config-vrf)# description alcatel-lucent-routing

IP ROUTEip route [vrf <vrf-name>] {destination network subnet-mask|destination network/prefix-length} {<gateway-ip-address>|<interface-name> [<gateway-ip-address>]}[<1-255>]

DESCRIPTION

This command is entered in the Configuration Mode. This command adds a static routing entry into the specified VRF routing table. If the VRF name is not specified, then the routing entry is added to the corresponding Default VRF’s routing table.

PARAMETERS

EXAMPLEALU(config)# ip route vrf ALU-vrf 1.1.1.0/24 2.2.2.2

Parameter Description

description-string The descriptive text for the VRF.

Parameter Description

vrf-name The name of the VRF for which the routing entry is to be added.

{destination network subnet-mask|destination network/prefix-length}

The IP address and prefix length of the destination.

gateway-ip-address IP address of the next hop.

interface name Name of the next hop interface.

1-255 An administrative distance of the route.

631Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Virtual Routing and Forwarding

Left running head: Chapter name (automatic)

IP VRFip vrf <vrf-name>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure a VRF. This enters the VRF Configuration mode.

PARAMETERS

EXAMPLEALU(config)# ip vrf ALU-vrfALU(config-vrf)#

IP VRF FORWARDINGip vrf forwarding <vrf-name>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to associate a VRF on an interface.

Note: IP address configuration on the interface is removed when this command is executed. Hence, associate a VRF to an interface prior to IP address configuration.

PARAMETERS

EXAMPLEALU(config-if Serial0)# ip vrf forwarding ALU-vrf

Parameter Description

vrf-name The name of the VRF to be created.

Parameter Description

vrf-name The name of the VRF to be associated to an interface.

632

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ping

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

PINGping [vrf <vrf-name>] {<ip-address>|<hostname>}

DESCRIPTION

This command is entered in the Configuration Mode. Ping command is used for testing connectivity.

PARAMETERS

EXAMPLEALU(config)# ping vrf ALU-vrf 1.2.3.1

Parameter Description

vrf-name If the VRF name is specified, the packets will be routed using the routing table of the specified VRF on a interface associated with the VRF.

ip-address IP address of remote host/router.

hostname Host name of the remote host/router.

633Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Virtual Routing and Forwarding

Left running head: Chapter name (automatic)

ROUTER OSPFrouter ospf <process-id> [vrf <vrf-name>]

DESCRIPTION

This command is entered in the Configuration Mode. This command enables OSPF routing, and associates the OSPF instance with the specified VRF. If the VRF name is not specified, then the OSPF instance is associated with the Default VRF.

PARAMETERS

EXAMPLEALU(config)# router ospf 1 vrf ALU-vrfALU(config-router ospf 1)#

SHOW ARPshow arp [vrf <vrf-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the ARP entries in the specified VRF.

PARAMETERS

EXAMPLEALU(config)# show arp vrf ALU-vrf

Protocol Address Age (min) Hardware Addr Type InterfaceInternet 10.91.0.21 - 0004.9BE9.C4A8 ARPA FastEthernet0

Parameter Description

process-id Internally used identification parameter for an OSPF routing process. It is locally assigned and can be any positive integer. A unique value should be assigned for each OSPF routing process.

vrf-name The name of the VRF for which the OSPF instance is to be associated.

Parameter Description

vrf-name Displays the ARP entries in the specified VRF.

634

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show arp traffic

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW ARP TRAFFICshow arp traffic [vrf <vrf-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the ARP traffic statistics.

PARAMETERS

EXAMPLEALU(config)# show arp traffic vrf ALU-vrf

ARP Traffic statistics:Request Recvd :0 Request Sent :6Response Recvd :1 Response Sent :0 Rate limiting:Request Not Answered :0Request Not Sent: 0ADJ count exceeded :0 Errors:Req/Resp recvd without Mac on interface :0Req not sent because of no IP Address :0Req not sent becuase of no MAC :0Resp received without req :0

Parameter Description

vrf-name If the VRF name is specified, it displays the ARP traffic statistics for the specified VRF, else it displays the statistics for the default VRF.

635Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Virtual Routing and Forwarding

Left running head: Chapter name (automatic)

SHOW IP BGPshow ip bgp [vrf <vrf-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the BGP routing table.

PARAMETERS

EXAMPLEALU(config)# show ip bgp

SHOW IP BGP COMMUNITYshow ip bgp community [vrf <vrf-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the routes that belong to specified BGP communities.

PARAMETERS

EXAMPLEALU(config)# show ip bgp community

Parameter Description

vrf-name The name of the VRF for which the BGP routing table information is to be viewed.

Parameter Description

vrf-name If the VRF name is specified, it displays the routes that belong to specified BGP communities for the specified VRF.

636

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip bgp community-list

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW IP BGP COMMUNITY-LISTshow ip bgp community-list [vrf <vrf-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the routes that are permitted by the BGP community list.

PARAMETERS

EXAMPLEALU(config)# show ip bgp community-list

SHOW IP BGP FLAP-STATISTICSshow ip bgp flap-statistics [vrf <vrf-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the flap statistics of BGP routes.

PARAMETERS

EXAMPLEALU(config)# show ip bgp flap-statistics

Parameter Description

vrf-name If the VRF name is specified, it displays the routes that are permitted by the BGP community list for the specified VRF.

Parameter Description

vrf-name If the VRF name is specified, it displays the flap statistics of BGP routes for the specified VRF.

637Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Virtual Routing and Forwarding

Left running head: Chapter name (automatic)

SHOW IP BGP NEIGHBORSshow ip bgp neighbors [vrf <vrf-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to see the neighbors connection state in specified VRF.

PARAMETERS

EXAMPLEALU(config)# show ip bgp neighbors

SHOW IP BGP PEER-GROUPshow ip bgp peer-group [vrf <vrf-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the information about the given peer group.

PARAMETERS

EXAMPLEALU(config)# show ip bgp peer-group

Parameter Description

vrf-name If the VRF name is specified, it displays the neighbors connection state in specified VRF.

Parameter Description

vrf-name If the VRF name is specified, it displays the information about the given peer group for the specified VRF.

638

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip fib

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW IP FIBshow ip fib [vrf <vrf-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the statistics of the FIB entries.

PARAMETERS

EXAMPLEALU(config)# show ip fib vrf ALU-vrf

IP FIB table values:Levels : 4 Load balance span: 16IPC Connect : 0 RIB Connected : 0Total leaves : 12 Level 0 : 1 Level 1 : 4 Level 2 : 4 Level 3 : 3Total branches: 12LB nodes 0For Us adj : 8Connected rtes: 2Memory used : 12760 IP FIB table statistics:Leaf creates : 47Leaf deletes : 35Branch create : 42Branch delete : 30Branch extends: 41Branch coalesc: 30System Adjacency Counters: Adjacencies : 4294967291 Adj reference : 106 Adj unrefer : 53 Adj Memory : 496ALU(config)#

Parameter Description

vrf-name Displays statistics of the FIB entries in a specified VRF.

639Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Virtual Routing and Forwarding

Left running head: Chapter name (automatic)

SHOW IP PROTOCOLSshow ip protocols [vrf <vrf-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the routing protocol information associated with a VRF.

PARAMETERS

EXAMPLEALU(config)# show ip protocols vrf ALU-vrfRouting Protocol is "ospf 1" Invalid after 3600 seconds, hold down 5, flushed after 3600 seconds Router Id 4.4.4.4 Number of Areas in this router 1. 1 normal 0stub 0 nssa Outgoing update filter list for all interfaces is not set Incoming update filter list for all interfaces is not set Routing for Networks: 4.0.0.0/8 Routing Information Sources: Gateway Distance Last Update 4.4.4.1 110 00:05:56 Distance: (default is 110) Routing Protocol is "bgp 100" IGP synchronization is enabled Automatic route summarization is disabled BGP Information for VRF: "ALU-vrf" Incoming update filter list for all interfaces is not configured Outgoing update filter list for all interfaces is not configured Neighbor(s): Address FiltIn FiltOut DistIn DistOut RmapIn RmapOut Weight 4.4.4.1 Routing for Networks: Routing Information Sources: Gateway Distance Last Update 4.4.4.1 20 00:02:12 Distance: external 20 internal 200 local 200

Parameter Description

vrf-name The name of the VRF for which the protocol information is to be viewed.

640

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip route

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW IP ROUTEshow ip route [vrf <vrf-name>] [{network-number|ip-ddress/prefix length} [longer-prefixes]|ospf [<1-65535>] |connected|bgp|rip|summary|supernets-only]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the IP routing table for the default VRF.

PARAMETERS

EXAMPLEALU(config)# show ip route vrf ALU-vrf Codes: R - RIP, O - OSPF, C - connected S - static, M - mcstatic, B - BGP, A - ASE IA - OSPF inter area route, E1 - OSPF external type 1 route, E2 - OSPF external type 2 route, N1 - OSPF NSSA external type 1 route, N2 - OSPF NSSA external type 2 route * - candidate default route

Gateway of last resort is not set

10.0.0.0/24 is subnetted, 1 subnetC 10.91.10.0 [0/0] is directly connected, Vlan2 44.0.0.0 is variably subnetted, 2 subnets, 2 masksC 44.2.2.0/24 [0/0] is directly connected, serial0C 44.2.2.2/32 [0/0] via 44.2.2.2, serial0

Field Description

vrf-name The name of the VRF for which the routing information is to be viewed.

{network-number|ip-ddress/prefix length}

Displays the routing information for the given network number or IP address and prefix length.

longer-prefixes Specifies that only routes matching the IP address and mask pair should be displayed.

ospf [<1-65535>] |connected|bgp|rip|summary|supernets-only]

Displays the output for a specific routing protocols.

641Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Virtual Routing and Forwarding

Left running head: Chapter name (automatic)

SHOW IP TRAFFICshow ip traffic [vrf <vrf-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the IP statistics. It can be used to debug the network problems.

PARAMETERS

EXAMPLEALU(config)# show ip traffic vrf ALU-vrf

IP statistics: Rcvd: 168 total, 168 local destination 0 format errors, 0 checksum errors, 0 bad hop count Frags: 0 reassembled, 0 timeouts, 0 couldn't reassemble 0 fragmented, 0 couldn't fragment, 0 fragments created Sent: 11 generated, 11 forwarded 5 encapsulation failed, 0 no route ICMP statistics: Rcvd: 5 total, 0 errors, 0 dst unreach 0 time exceed, 0 param probs, 0 source quench 0 redirects, 0 echo req, 5 echo rpy 0 timestamp req, 0 timestamp rpy 0 addr mask req, 0 addr mask rpy Sent: 10 total, 0 errors, 0 dst unreach 0 time exceed, 0 param probs, 0 source quench 0 redirects, 10 echo req, 0 echo rpy 0 timestamp req, 0 timestamp rpy 0 addr mask req, 0 addr mask rpy

Parameter Description

vrf-name Displays the IP statistics in a specified VRF.

642

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip vrf

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW IP VRFshow ip vrf [interfaces <vrf-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the information on the defined VRF instances.

PARAMETERS

EXAMPLEALU(config)# show ip vrf interfaces ALU

Interface IP Address VRF ProtocolSerial 1.1.1.1 ALU-vrf up

Parameter Description

vrf-name If the VRF name is specified, then its displays all the interfaces associated with the specified VRF.

interfaces A detailed information of all the VRFs configured on all the interfaces.

643Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Virtual Routing and Forwarding

Left running head: Chapter name (automatic)

SSHssh [vrf <vrf-name>] {<ip-address>|<hostname>} <user-name> [version {1|2}]

DESCRIPTION

This command is entered in the Configuration Mode. SSH command is used for logging into a remote system specified by the address.

PARAMETERS

EXAMPLEALU(config)# ssh vrf ALU-vrf 10.91.0.25

Parameter Description

vrf-name Name of the VRF. If the VRF name is specified, the packets will be routed using the routing table of the specified VRF on a interface associated with the VRF.

ip address IP Address of the remote system.

hostname Host name of the remote system.

user-name The login/user name to be used.

version {1|2} SSH version number - version 1 or version 2.

644

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

telnet

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

TELNETtelnet [vrf <vrf-name>] {<ip-address>|<hostname>}

DESCRIPTION

This command is entered in the Configuration Mode. Telnet command is used for logging into a remote system specified by the addresss.

PARAMETERS

EXAMPLEALU(config)# telnet vrf ALU-vrf 10.91.0.22

TRACEROUTEtraceroute [vrf <vrf-name>] {<ip-address>|<hostname>}

DESCRIPTION

This command is entered in the Configuration Mode. Traceroute command is used for figuring out the path taken by the IP packet.

PARAMETERS

EXAMPLEALU(config)# traceroute vrf ALU-vrf 1.2.3.1

Parameter Description

vrf-name If the VRF name is specified, the packets will be routed using the routing table of the specified VRF on a interface associated with the VRF.

ip-address The IP address associated with the VRF.

hostname Host name of the remote system.

Parameter Description

vrf-name If the VRF name is specified, the packets will be routed using the routing table of the specified VRF on a interface associated with the VRF.

ip-address IP address of the host.

hostname Name of the host.

645Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Virtual Routing and Forwarding

Left running head: Chapter name (automatic)

646

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

For final production, import color definitions from\\daldoc01\docteam\templates\framemaker\book-template\color-defs\ production-colors.fm. Do not import other template elements such as page layout.

To return to the draft version, import color def’ns from draft-colors.fm.To switch to the beta version, import color def’ns from beta-colors.fm

For final production, import color definitions from\\daldoc01\docteam\templates\framemaker\book-template\color-defs\ production-colors.fm. Do not import other template elements such as page layout.

To return to the draft version, import color def’ns from draft-colors.fm.To switch to the beta version, import color def’ns from beta-colors.fm

Optional footer: Manual title (to set, redefine ManualTitlevariable)

agination: umeric & ntinuous

PNco

Part 6 Network Security

Beta BetaAlcatel-Lucent

647

Beta Betawith preceding section of book

OmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Left running head: Chapter name (automatic)

648

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Network Address Translation

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 29 NETWORK ADDRESS TRANSLATION

This chapter provides Network Address Translation (NAT) Command Line Interface (CLI) commands.

The commands referring to the SNAT and DNAT are alphabetically arranged. This chapter provides a terse overview of the CLI syntax needed to configure the Source and Destination NAT. For more detailed information about using and configuring the NAT, refer to the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

649Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Network Address Translation

Left running head: Chapter name (automatic)

SOURCE NAT (SNAT) CONFIGURATION COMMANDS

SOURCE-NAT[<1-65535>] match [{all|any}] <match-list name> source-nat

DESCRIPTION

This command is entered in the NAT configuration Mode. This command is used to configure a SNAT, and configure one or more rule (set priority for the rule, associate match-lists and set action) for the configured SNAT.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-nat-N1)# 10 match m1 source-nat

Parameter Description

1-65535 The range for the NAT policy rule. This rule number signifies the priority of a rule.

match [{all|any}] <match-list name>

match all - In this type of match, the relevant action is performed only when all the match-list criteria is satisfied.match any - In this type of match, the relevant action is performed even if any one of the match-list criterion is satisfied.

source-nat Type of NAT, here it is the SNAT.

650

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

source-nat host

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SOURCE-NAT HOST[<1-65535>] match [{all|any}] <match-list name> source-nat host {<ip-address|host-name>} [port-range {<2048-65535> <2048-65535>}|static]

DESCRIPTION

This command is entered in the NAT configuration Mode. This command is used to configure a SNAT with host IP address.

PARAMETERS

Note: Currently, ‘Hostname’ option is not supported. Only host IP address can be configured.

DEFAULT VALUE

If no address is configured, the IP address of the egress interface on which the NAT policy is applied will be used.

EXAMPLEALU(config-nat-N1)# match m1 source-nat host 192.168.10.91

Parameter Description

1-65535 The range for the NAT policy rule. This rule number signifies the priority of a rule.

match [{all|any}] <match-list name>

match all - In this type of match, the relevant action is performed only when all the match-list criteria is satisfied.match any - In this type of match, the relevant action is performed even if any one of the match-list criterion is satisfied.

source-nat Type of NAT, here it is the SNAT.

ip-address IP address of the host.

host-name The host name.

651Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Network Address Translation

Left running head: Chapter name (automatic)

SOURCE-NAT POOL[<1-65535>] match [{all|any}] <match-list name> source-nat pool <list-name> [port-range {<2048-65535> <2048-65535>}|static]

DESCRIPTION

This command is entered in the NAT configuration Mode. This command is used to configure SNAT with an IP address pool.

Note: If no address is configured, the IP address of the egress interface on which the NAT policy is applied will be used.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-nat-N1)# match m1 source-nat pool l1

Parameter Description

1-65535 The range for the NAT policy rule. This rule number signifies the priority of a rule.

match [{all|any}] <match-list name>

match all - In this type of match, the relevant action is performed only when all the match-list criteria is satisfied.match any - In this type of match, the relevant action is performed even if any one of the match-list criterion is satisfied.

source-nat Type of NAT, here it is the SNAT.

list-name The name of the list.

652

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

source-nat port-range

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SOURCE-NAT PORT-RANGE[<1-65535>] match [{all|any}] <match-list name> source-nat port-range <2048-65535> <2048-65535>

DESCRIPTION

This command is entered in the NAT configuration Mode. This command is used to configure SNAT with a port range.

PARAMETERS

DEFAULT VALUE

If no port range is specified, a default port range of 2048 – 65535 is used.

EXAMPLEALU(config-nat-N1)# match m1 source-nat port-range 2048 6000

Parameter Description

1-65535 The range for the NAT policy rule. This rule number signifies the priority of a rule.

match [{all|any}] <match-list name>

match all - In this type of match, the relevant action is performed only when all the match-list criteria is satisfied.match any - In this type of match, the relevant action is performed even if any one of the match-list criterion is satisfied.

source-nat Type of NAT, here it is the SNAT.

2048-65535 The lower port number.

2048-65535 The upper port number.

653Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Network Address Translation

Left running head: Chapter name (automatic)

SOURCE-NAT STATIC[<1-65535>] match [{all|any}] <match-list name> source-nat static

DESCRIPTION

This command is entered in the NAT configuration Mode. This command is used to configure a static SNAT that uses one-to-one address mapping without port translation.

Note: If no address is configured, the IP address of the egress interface on which the NAT policy is applied will be used.

PARAMETERS

DEFAULT VALUE

By default, NAT enables dynamic mapping.

EXAMPLEALU(config-nat-N1)# match m1 source-nat static

Parameter Description

1-65535 The range for the NAT policy rule. This rule number signifies the priority of a rule.

match [{all|any}] <match-list name>

match all - In this type of match, the relevant action is performed only when all the match-list criteria is satisfied.match any - In this type of match, the relevant action is performed even if any one of the match-list criterion is satisfied.

source-nat Type of NAT, here it is the SNAT.

static Use this keyword to use the static NAT.

654

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Destination NAT (DNAT) Configuration Commands

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

DESTINATION NAT (DNAT) CONFIGURATION COMMANDS

DESTINATION-NAT[<1-65535>] match [{all|any}] <match-list name> destination-nat {host {<ip-address|host-name>} [port <1-65535>]|pool <list-name> [port <1-65535>|static]}

DESCRIPTION

This command is entered in the NAT configuration Mode. This command is used to configure a DNAT with one or more rules (set priority for the rule, associate match-lists and set action) for the configured DNAT.

And, this command is used to configure a DNAT with host IP address or an IP address pool.

PARAMETERS

Note: Presently, ‘Hostname’ option is not supported. Only host IP address can be configured.

DEFAULT VALUE

None.

EXAMPLEALU(config-nat-N2)# match m1 destination-nat host 192.168.10.91

ALU(config-nat-N2)# match m1 destination-nat pool l1

Parameter Description

1-65535 The range for the NAT policy rule. This rule number signifies the priority of a rule.

match [{all|any}] <match-list name>

match all - In this type of match, the relevant action is performed only when all the match-list criteria is satisfied.match any - In this type of match, the relevant action is performed even if any one of the match-list criterion is satisfied.

destination-nat Type of NAT, here it is the DNAT.

ip-address The IP address of the host.

host-name The host name.

list-name The name of the list.

655Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Network Address Translation

Left running head: Chapter name (automatic)

PORT[<1-65535>] match [{all|any}] <match-list name> destination-nat {host {<ip-address|host-name>}|pool <list-name>} port <1-65535>

DESCRIPTION

This command is entered in the NAT Configuration Mode. This command is used to configure port number for a DNAT.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-nat-N2)# match m1 destination-nat host 192.168.10.91 port 100

ALU(config-nat-N2)# match m1 destination-nat pool l1 port 100

Parameter Description

1-65535 The range for the NAT policy rule. This rule number signifies the priority of a rule.

match [{all|any}] <match-list name>

match all - In this type of match, the relevant action is performed only when all the match-list criteria is satisfied.match any - In this type of match, the relevant action is performed even if any one of the match-list criterion is satisfied.

destination-nat Type of NAT, here it is the DNAT.

ip-address The IP address of the host.

host-name The host name.

list-name The name of the list.

1-65535 The port number for DNAT.

656

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

destination-nat static

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

DESTINATION-NAT STATIC[<1-65535>] match [{all|any}] <match-list name> destination-nat pool <list-name> static

DESCRIPTION

This command is entered in the NAT Configuration Mode. This command is used to configure a static DNAT that uses one-to-one address mapping without port translation.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-nat-N2)# match m1 destination-nat pool l1 static

Parameter Description

1-65535 The range for the NAT policy rule. This rule number signifies the priority of a rule.

match [{all|any}] <match-list name>

match all - In this type of match, the relevant action is performed only when all the match-list criteria is satisfied.match any - In this type of match, the relevant action is performed even if any one of the match-list criterion is satisfied.

destination-nat Type of NAT, here it is the DNAT.

list-name The name of the list.

static Use this keyword to configure static DNAT.

657Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Network Address Translation

Left running head: Chapter name (automatic)

COMMON COMMANDS FOR SNAT AND DNAT

BYPASS[<1-65535>] match [{all|any}] <match-list name> bypass

DESCRIPTION

This command is entered in the NAT Configuration Mode. This command is used in conjunction with the SNAT or DNAT commands to bypass the traffic.

PARAMETERS

EXAMPLEALU(config)# ip nat snatALU(config-nat-snat)# match m1 bypass

CLEAR IP NAT STATISTICSclear ip nat statistics <nat policy-name>

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command clears the statistics of a specific NAT policy.

PARAMETERS

EXAMPLE

The following example clears the counters of NAT ‘N1’.ALU# clear ip nat statistics N1

Parameter Description

1-65535 Priority of a rule.

match all In this type of match, traffic is bypassed only when all the match-list criteria is satisfied.

match any In this type of match, traffic is bypassed even if any one of the match-list criterion is satisfied.

match-list-name Name of the match-list.

Parameter Description

nat policy-name Name of the NAT policy.

658

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

clear ip nat statistics

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CLEAR IP NAT STATISTICSclear ip nat statistics <interface-name> {in|out|both}

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to clear the statistics of a NAT Policy on a particular interface.

PARAMETERS

EXAMPLE

The following example clears the statistics of the NAT for interface ‘FastEthernet0’.

ALU# clear ip nat statistics FastEthernet0 in

CHANGE change <1-65535> <1-65535>

DESCRIPTION

This command is entered in the NAT Configuration Mode. Use this command to change the priority/order of a specific SNAT/DNAT rule configured.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLE

ALU(config-nat-N1)# change 10 20

Parameter Description

interface-name The name of the interface.

both Both ingress and egress statistics.

in The “in” keyword implies ingress statistics.

out The “out” keyword implies egress statistics.

Parameter Description

1-65535 Priority of the NAT policy rule.

659Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Network Address Translation

Left running head: Chapter name (automatic)

DEBUG FIREWALL NATdebug firewall {session|filter|nat|attack|alg|intrusion|selector [saddr <ip-address>|daddr <ip-address>|protocol <number>|sport <number> | dport <number>][output|permanent]|all [detail-level]}

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command turns on the debugging functionality for NAT on OmniAccess 5510 USG.

PARAMETERS

EXAMPLEALU# debug firewall nat

IP NATip nat <nat policy-name>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure a NAT policy. This command enters the NAT configuration Mode.

PARAMETERS

EXAMPLEALU(config)# ip nat N1

Parameter Description

saddr <ip-address> Source address.

daddr <ip-address> Destination address.

protocol <number> Protocol.

sport <number> Source port number.

dport <number> Destination port number.

output Specify output.

permanent Allow debug flag(s) to be written with configuration.

Parameter Description

nat policy-name Name of the NAT policy.

660

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ip nat {in | out}

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

ALU(config-nat-N1)#

IP NAT {IN | OUT}ip nat {in|out} <nat policy-name>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to attach a NAT policy to an interface in ‘in’ or ‘out’ direction.

PARAMETERS

Note: Each interface can have only one ingress and one egress NAT policy.

EXAMPLE

In the example below, HTTP requests initiated from internal network will be translated and sent to external network. Returning HTTP responses are automatically allowed and translated even if there is a filter to block:

ALU(config)# match-list m1ALU(config-match-list m1)# tcp any any service httpALU(config)# exit

ALU(config)# ip filter f1ALU(config-filter f1)# match m1 denyALU(config)# exit

ALU(config)# ip nat n1ALU(config-nat n1)# match m1 source-natALU(config)# exit

ALU(config)# interface FastEthernet 0ALU(config-if FastEthernet0)# ip filter in f1ALU(config-if FastEthernet0)# ip nat out n1

Parameter Description

in The keyword "in" signifies that ingress traffic is subjected to the NAT, only if all classifiers in this NAT object are matched.

out The keyword "out" denotes that egress traffic is subjected to the NAT, if all classifiers in this NAT object are matched.

nat policy name Name of the NAT policy.

661Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Network Address Translation

Left running head: Chapter name (automatic)

IP NAT STATISTICS {IN|OUT|BOTH}ip nat statistics {in|out|both}

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command turns on statistics for a given interface.

PARAMETERS

DEFAULT VALUE

By default the NAT statistics on an interface is turned off.

EXAMPLEALU(config)# interface FastEthernet 0ALU(config-if FastEthernet0)# ip nat statistics in

NO DEBUG FIREWALL NATno debug firewall {session|filter|nat|attack|alg|intrusion| selector [saddr <ip-address>|daddr <ip-address>|protocol <number>|sport <number>|dport <number>][output|permanent]| all [detail-level]}

This command is entered in the Super User Mode or Configuration Mode. This command turns off the debugging functionality which is enabled using the above command.

NO IP NAT-FORCEno ip nat <policy-name> force

This command is entered in the Configuration Mode. The "force" keyword will automatically detach the specified NAT policy from respective interfaces, and deletes the policy. This command when used also deletes all the associated NAT policy rules.

Parameter Description

in "in" means ingress traffic.

out "out" denotes that egress traffic.

both Implies both ingress and egress traffic

662

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

no ip nat {in | out}

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NO IP NAT {IN | OUT}no ip nat {in|out} <nat-name>

This command is entered in the Interface Configuration Mode. This command detaches a NAT policy attached to an interface. This command does not delete the NAT policy definition in its entirety. It only detaches it from its interface.

NO IP NAT STATISTICS {IN | OUT | BOTH}no ip nat statistics {in|out|both}

This command is entered in the Interface Configuration Mode to turn off the statistical details enabled on the interface.

NO RULE no rule <1-65535>

This command is entered in the NAT Configuration Mode. This command deletes the component specific to the line number specified. It deletes only that one rule in the NAT and not the whole NAT policy.

RENUMBERrenumber

DESCRIPTION

This command is entered in the NAT Configuration Mode. Use this command to generate a numbering scheme for the SNAT/DNAT rules configured. This command resets the rule priorities in multiples of 10.

PARAMETERS None.

DEFAULT VALUE

None.

EXAMPLEALU(config-nat-N1)# renumber

663Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Network Address Translation

Left running head: Chapter name (automatic)

SHOW IP NATshow ip nat [<name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. Displays details of all the configured NAT policies or a specific NAT.

PARAMETERS

EXAMPLE

1. The following example displays the details of all the NAT policies configured. ip nat n1 10 match all m1 source-natip nat n2 10 match m2 source-nat ip nat n3 1 match all m3 destination-nat host 2.2.2.2

2. The following example shows the configuration details of a specific NAT policy. ALU# show ip nat n1

ip nat n1 10 match all m1 source-nat 10 match m2 source-nat

Parameter Description

name NAT policy name.

664

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip nat statistics

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW IP NAT STATISTICSshow ip nat statistics [<nat policy-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays detailed statistics for the NAT policies configured or for a specific NAT policy.

PARAMETERS

EXAMPLE

The following example shows detailed statistics for the NAT policy ‘n1’ALU# show ip nat statistics n1

ip nat n1 Dropped: 0, Bypassed: 0, Enqueued: 0 10 match any m1 source-nat host 1.1.1.1 Translated: 0, Bypassed: 0, PORTS Allocated: 0, Released: 0 20 match any m2 source-nat host 1.1.1.2 Translated: 0, Bypassed: 0, PORTS Allocated: 0, Released: 0interface FastEthernet0 Out

Parameter Description

name NAT policy name.

665Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Network Address Translation

Left running head: Chapter name (automatic)

SHOW IP NAT STATISTICS <INTERFACE-NAME>show ip nat statistics <interface-name> {in|out|both}

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays NAT statistics for a specific interface.

PARAMETERS

EXAMPLE

The following example shows NAT statistics on a specified interface:ALU# show ip nat statistics FastEthernet0 Out

ip nat n1 Dropped: 0, Bypassed: 0, Enqueued: 0 10 match any m1 source-nat host 1.1.1.1 NATted Packets: 0 20 match any m2 source-nat host 1.1.1.2 NATted Packets: 0 interface FastEthernet0 out

Parameter Description

interface-name Name of the interface.

in "in" means ingress traffic.

out "out" denotes that egress traffic.

both Implies both ingress and egress traffic.

666

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Filter and Firewall

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 30 FILTER AND FIREWALL

This chapter documents the CLI commands for configuring the filters, firewall policies, and DoS attack prevention. Common Classification (CC) commands are used in these CLIs. Refer to the “Common Classifiers” chapter to know more on Alcatel-Lucent’s Common Classifier CLI.

All commands are described in alphabetical order. They do not follow the sequence of configuration. For more detailed information on using and configuring the above concepts, refer the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

667Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Filter and Firewall

Left running head: Chapter name (automatic)

FILTER CLI COMMANDSFollowing are the CLI commands used to configure a filter on OmniAccess 5510 USG:

CHANGEchange {<1-65535> <1-65535>}

DESCRIPTION

This command is entered in the Filter Configuration Mode. This command changes the priority of a configured filter rule.

PARAMETERS

EXAMPLE

Consider the following configuration: ALU(config)# ip filter f1ALU(config-filter-f1)# 10 match m1 deny 20 match m2 deny 30 match m3 deny log 40 match m4 deny reset default permit

In the above example, m4 has a priority 40. Use the “change“ keyword to change the priority of m4.ALU(config)# ip filter f1ALU(config-filter-f1)# change 40 15

Parameter Description

1-65535 Denotes the filter rule number. This rule number signifies the priority of a rule.

668

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

clear ip filter statistics

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CLEAR IP FILTER STATISTICSclear ip filter statistics <interface-name> [{in|out|both}| <filter-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to clear the statistics of a filter on a particular interface or clear statistics for a specific filter.

PARAMETERS

EXAMPLEALU# clear ip filter statistics FastEthernet 0 in

ALU# clear ip filter statistics FastEthernet 0 out

Parameter Description

interface-name The name of the interface.

both Both ingress and egress statistics.

in The “in” keyword implies ingress statistics.

out The “out” keyword implies egress statistics.

669Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Filter and Firewall

Left running head: Chapter name (automatic)

CLEAR L2 FILTER STATISTICSclear l2 filter statistics <name>

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to clear the statistics of a L2 filter.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# clear l2 filter statistics F1

RELEASE HISTORY

Release 3.0: command was introduced.

IP FILTERip filter <name>

DESCRIPTION

Enter the IP Filter command in the Configuration Mode. This command configures a filter and enters the Filter Configuration Mode.

PARAMETERS

EXAMPLE

The Example below configures the IP filter f1ALU(config)# ip filter f1ALU(config-filter-f1)#

Parameter Description

name Name of the L2 filter.

Parameter Description

name Name for the filter being configured.

670

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ip filter

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

To Configure a Rule for a Filter:[<1-65535>] match [any|all] <match-list name>... {permit|deny [reset]}[log] [verbose] [timer <timer-object>]

The above command is used to configure rules (set priority for the rule, associate match-lists and action) for a filter, and also set the action deny or permit for the configured rules.

default {deny|permit}[log] [verbose]

This command sets a default action of either deny or permit on the filter. The default action for a filter is “deny”. The reset keyword can be used in conjunction only with the “deny” keyword.

The example below sets a permit rule so that only traffic defined by m1 is permitted.ALU(config)# ip filter f1ALU(config-filter-f1)# 10 match m1 permit log

The example below configures a deny rule with reset option on traffic as defined in m1.ALU(config-filter-f1)# 10 match m1 deny reset

Parameter Description

1-65535 Denotes the filter rule number. The range for the filter rule.

match [any|all] <match-list name>

match all - In this type of match, the relevant action is performed only when all the match-list criteria is satisfied.match any - In this type of match, the relevant action is performed even if any one of the match-list criterion is satisfied.

deny Prohibits the traffic through it.

permit Allows traffic through it. The filter has to be set to this mode to enable it.

deny[reset] Keyword "deny reset" sends TCP RST to the source, for TCP traffic that matches the classification, and drops packets for other non-TCP traffic.

log Logs the first packet of a session.

verbose Logs all packets of a session.

timer-object The name of the time range.

default {deny|permit} If no match cases are given, this default keyword is used to just configure a permit or deny on all the incoming traffic.

671Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Filter and Firewall

Left running head: Chapter name (automatic)

IP FILTER {IN | OUT}ip filter {in|out} <name>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to attach a filter to an interface in ‘in’ or ‘out’ direction.

Note: Each interface can have one ingress and one egress filter.

PARAMETERS

EXAMPLE

The following example binds the filter f1 to FastEthernet interface:ALU(config)# interface FastEthernet 0ALU(config-if FastEthernet0)# ip filter in f1

Parameter Description

name Name of the filter.

in Filter is applied to the ingress (incoming) traffic if “in” keyword is used.

out Filter is applied to the egress (outgoing) traffic if “out” keyword is used.

672

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

l2 filter

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

L2 FILTERl2 filter <name>

DESCRIPTION

This command is entered in the Configuration Mode. This command configures a L2 filter.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# l2 filter F1ALU(config-filter-F1)#

RELEASE HISTORY

Release 3.0: command was introduced.

To Configure a Rule for a L2 Filter:[<1-65535>] match [any|all] <match-list name>... {permit|deny [reset]}[log] [verbose] [timer <timer-object>]

This command is used to configure rules (set priority for the rule, associate match-lists and action) for a filter, and also set the action deny or permit for the configured rules. By default, ‘any’ keyword is used.

Parameter Description

name Name for the L2 filter being configured.

Parameter Description

1-65535 Denotes the filter rule number. The range for the filter rule.

match [any|all] <match-list name>

match all - In this type of match, the relevant action is performed only when all the match-list criteria is satisfied.match any - In this type of match, the relevant action is performed even if any one of the match-list criterion is satisfied.

deny This command prohibits the traffic through it.

permit This command allows traffic through it. The filter has to be set to this mode to enable it.

673Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Filter and Firewall

Left running head: Chapter name (automatic)

ExampleALU(config)# l2 filter F1ALU(config-filter-F1)# 10 match m3 permit

deny[reset] Keyword "deny reset" sends TCP RST to the source, for TCP traffic that matches the classification, and drops packets for other non-TCP traffic.

log Logs the first packet of a session.

verbose Logs all packets of a session.

timer-object The name of the time range.

default {deny|permit} If no match cases are given, this default keyword is used to just configure a permit or deny on all the incoming traffic.

Parameter Description

674

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

l2 filter {in|out}

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

L2 FILTER {IN|OUT}l2 filter {in|out} <filter-name>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to attach a L2 filter to an interface in ‘in’ or ‘out’ direction.

Note: Each interface can have one ingress and one egress L2 filter.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# interface FastEthernet 0ALU(config-if FastEthernet0)# l2 filter in F1

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

in|out Filter is applied to the ingress (incoming) traffic if “in” keyword is used.Filter is applied to the egress (outgoing) traffic if “out” keyword is used.

filter-name Name for the L2 filter.

675Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Filter and Firewall

Left running head: Chapter name (automatic)

NO IP FILTERno ip filter <name>

This command is entered in the Configuration Mode. This command is used to delete the filter when it is not attached to any interface.

no ip filter <name> force

This command is entered in the Configuration Mode. This command is used to delete the filter when it is attached to an interface.

The filter has to be first detached from its interface and then removed. If the filter is attached to any of the interfaces, it cannot be deleted. In such a case, to force deletion of a filter, use the “force” command from the configuration mode itself. This gives the flexibility in deleting a filter even without detaching it from its interfaces. As a result, it reduces the complexity and time.

Also, when "force" command is used to delete the filter, the filter gets removed from the interface it is attached to.

NO IP FILTER {IN|OUT} no ip filter {in|out} <name>

This command is entered in the Interface Configuration Mode. This command detaches the filter attached to an interface. This does not entirely delete the filter definition. It only detaches it from the interface it is attached to.

If the command "no ip filter <name>" is issued at the top level and if this filter is not bound to any interface, it deletes the filter definition.

NO L2 FILTER no l2 filter <name> [force]

This command is entered in the Interface Configuration Mode. This command is used to delete a L2 filter.

You cannot delete a filter if it is attached to any interface. First detach the filter from the interface to delete the filter. To force deletion of a filter, use the “force” command. When "force" is used, the filter gets removed from the interface it is attached to.

NO L2 FILTER {IN|OUT}no l2 filter {in|out} <filter-name>

This command is entered in the Interface Configuration Mode. This command detaches a L2 filter attached to an interface. This does not delete the filter definition in its entirety. It only detaches it from the interface it is attached to.

NO RULEno rule <line number>

This command is issued in the Filter Configuration Mode. The command deletes a single component in the filter with respect to the corresponding line number.

676

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

no stateless

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NO STATELESSno stateless

This command is entered in the Filter Configuration Mode. It changes the stateless option configured on the firewall, to the default state which is stateful or reflexive.

RENUMBERrenumber

DESCRIPTION

This command is entered in the Filter Configuration Mode. Use this command to generate a numbering scheme for the filter rules configured.

PARAMETERS

None.

EXAMPLEALU(config-filter-f1)# renumber

677Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Filter and Firewall

Left running head: Chapter name (automatic)

SHOW IP FILTERshow ip filter [<name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the details of all the filters configured on the system. If filter name is specified, it displays the details for the specified filter.

PARAMETERS

EXAMPLE

The following syntax displays the all the filters configured in the system:ALU# show ip filter

ip filter f1 10 match any m1 permit default deny interface FastEthernet0 In, Stats Off

ip filter f2 10 match any m2 deny default deny interface FastEthernet0 In, Stats Off

b) The following syntax displays the filter f1’s details:ALU(config-filter-f1)# show ip filter f1

ip filter f1 10 match any m1 permit default deny interface FastEthernet0 In, Stats Off

Parameter Description

name Name of the filter.

678

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip filter statistics

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW IP FILTER STATISTICSshow ip filter statistics [<interface-name> {in|out|both}]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the statistics of a filter on a particular interface. To view the statistics, turn it on by using the command "ip filter statistics both" (for both IN and OUT directions).

PARAMETERS

EXAMPLE

The following command displays the filter statistics:

ALU(config)# show ip filter statistics FastEthernet 0 in

ip filter f1 20 match any m1 permit Hits 0 default deny interface FastEthernet0 In, Stats On

Parameter Description

interface-name The name of the interface.

in The “in” keyword implies ingress statistics.

out The “out” keyword implies egress statistics.

both Both ingress and egress statistics.

679Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Filter and Firewall

Left running head: Chapter name (automatic)

SHOW L2 FILTERshow l2 filter [<name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the details of all the L2 filters configured on the system.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show l2 filter

l2 filter F1 default deny interface FastEthernet0 Intop!

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

name If a L2 filter name is specified, it displays the details for the specified filter.

680

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show l2 filter statistics

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW L2 FILTER STATISTICSshow l2 filter statistics [<name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the statistics of all the L2 filters configured on the system.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show l2 filter statistics

l2 filter F1 default deny Hits 0 interface FastEthernet0 Intop!

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

name If a L2 filter name is specified, it displays the statistics for the specified filter.

681Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Filter and Firewall

Left running head: Chapter name (automatic)

STATELESSstateless

DESCRIPTION

This command is entered in the Filter Configuration Mode. This command sets the filter behavior to stateless.

PARAMETERS

None.

DEFAULT VALUE

The filters on OmniAccess 5510 USG are by default stateful.

EXAMPLEALU(config-filter-f1)# stateless

682

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Network Attack Prevention Configuration Commands

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NETWORK ATTACK PREVENTION CONFIGURATION COMMANDS

ALLall

DESCRIPTION

This command is entered in the Firewall-Attack Sub Configuration Mode. This command is used to configure all the attacks (including all Default and Optional attacks) for an attack object.

PARAMETERS

None.

EXAMPLEALU(config-firewall-attack-A1)# all

The following are the Optional attacks that are not present in the default attack prevention list of OmniAccess 5510 USG:

icmp_router_advertisementicmp_redirectip_spoofingicmp_block_trace_routeip_source_routingudp_snork_attack

ATTACKattack <name>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure an attack object to be attached to a firewall policy.

PARAMETERS

EXAMPLEALU(config-firewall)# attack A1ALU(config-firewall-attack-A1)#

Parameter Description

name Name of the attack.

683Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Filter and Firewall

Left running head: Chapter name (automatic)

CHANGEchange {<1-65535> <1-65535>}

DESCRIPTION

This command is entered in the Firewall Configuration Mode. Use this command to change the priority of a specific configured firewall policy rule.

PARAMETERS

EXAMPLE

Consider the following configuration: ALU(config)# firewallALU(config-firewall)# policy P1ALU(config-firewall-P1)# 10 match m1 attack atk drop 20 match m2 attack atk reset 30 match m3 attack atk reset 40 match m4 attack atk drop

In the above sequence, if m4 has a priority 40. Use the “change “ keyword to change the priority of m4.

ALU(config-firewall)# policy P1ALU(config-firewall-P1)# change 40 15

To view the policy configuration after changing the priority, give the show command. The output appears as shown:

show firewall policy P1ip policy P1

10 match m1 attack atk drop 15 match m4 attack atk drop 20 match m2 attack atk reset 30 match m3 attack atk reset

Parameter Description

1-65535 Denotes the firewall policy rule number. This rule number signifies the priority of a rule.

684

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

clear firewall session session-id

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CLEAR FIREWALL SESSION SESSION-IDclear firewall session session-id <0-128000>

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to clear the firewall sessions for a specific session ID.

PARAMETERS

EXAMPLEALU(config)# clear firewall session session-id 200

Parameter Description

0-128000 Denotes the session ID.

685Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Filter and Firewall

Left running head: Chapter name (automatic)

DEFAULTdefault [stateless]

DESCRIPTION

This command is entered in the Firewall-Attack Sub Configuration Mode. This command is used to configure all the default attacks for an attack object.

PARAMETERS

EXAMPLEALU(config-firewall-attack-A1)# default

ALU(config-firewall-attack-A1)# default stateless

You can create a “default” attack setting to check default attacks on ingress trafficto all interfaces.

In OmniAccess 5510 USG, the default DoS attack is configured for the prevention of all attacks and their default settings except "icmp-block-trace-route", "icmp-router-advertisement", "icmp-redirect" and "ip-rate-threshold". These attacks can be either manually turned on for detection or filters can be applied to block them. The minimum time resolution you can enter is 5 milliseconds.

The following attacks are the Default attacks (Rate Limiting attacks, which includes both Stateful and Stateless attacks):

tcp_header_frag - -udp_header_frag - -tcp_fin_scan - -tcp_syn_flood 100 1000 5icmp_ping_flood 100 1000icmp_dest_unrch_storm 10 1000icmp_ip_address_sweep 100 1000port_scan 5 1000udp_flood 200 1000udp-port-loopback 10 1000ip-tear-drop - - ip-tiny-frag 50 64icmp-ping-of-death 50 65507ip-zero-length - -ip-land-attack - -

Parameter Description

default Default keyword configures all the Default Rate Limiting attacks (i.e, both Stateful and Stateless attacks).

stateless Stateless keyword configures only the Default Non-rate Limiting (i.e., only Stateless attacks.).

686

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

default

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

tcp-xmas-scan - -tcp_-invalid-urgent-offset - -tcp-null-scan - -tcp-syn-fin - -tcp-fin-no-ack - -udp-fraggle-attack - -

You can create a “default” attack setting to check only the stateless attacks by using the keyword “default stateless”.

The following attacks are the Default Stateless (Default Non-Rate Limiting) attacks:

ip-tear-drop - - ip-tiny-frag 50 64icmp-ping-of-death 50 65507ip-zero-length - -icmp-smurf-attack - -ip-land-attack - -tcp-xmas-scan - -tcp_-invalid-urgent-offset - -tcp-null-scan - -tcp-syn-fin - -tcp-fin-no-ack - -udp-fraggle-attack - -

Note: Some of the fragmentation attacks, in particular teardrop attack, tiny fragment attack, and TCP header fragment attacks are detected by the fragment handling code even if the corresponding attacks have not been configured. This will happen for any traffic that is subject to any firewall configuration, i.e., either filter, NAT or DoS configuration. This is why you can see these attacks in the “show” output even when he has not configured them.

687Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Filter and Firewall

Left running head: Chapter name (automatic)

DEFAULT TIMEOUT default timeout {icmp|tcp|udp} <0-2147483648>

DESCRIPTION

This command is entered in the Firewall Session mode. Firewall session table has a periodic timer to age out inactive entries. To change these default values, use this command.

PARAMETERS

DEFAULT VALUE• Default TCP value is 15 minutes• Default UDP value is 5 minutes • Default ICMP value is 30 seconds.

EXAMPLEALU(config-firewall)# sessionALU(config-firewall-session)# default timeout tcp 10

FIREWALLfirewall

DESCRIPTION

This command is entered in the Configuration Mode. This command allows you to enter the firewall sub-configuration mode.

PARAMETERS

None.

EXAMPLEALU(config)# firewallALU(config-firewall)#

Parameter Description

icmp|tcp|udp Type of connection.

0-2147483648 Timing in seconds to time-out a session.

688

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

firewall policy {in|out}

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

FIREWALL POLICY {IN|OUT}firewall policy {in|out} <policy-name>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to attach a firewall policy to an interface in ‘in’ or ‘out’ direction. Firewall policy is applied to the ingress (incoming) traffic if “in” keyword is used. Firewall policy is applied to the egress (outgoing) traffic if “out” keyword is used.

Note: Firewall policy will not take effect until it is bound to an interface.

PARAMETERS

DEFAULT VALUE

No default parameters.

EXAMPLEALU(config)# interface FastEthernet 0 ALU(config-if FastEthernet0)# firewall policy in P1

ICMP-BLOCK-TRACE-ROUTEicmp-block-trace-route

DESCRIPTION

This command is entered in the Firewall-Attack Sub Configuration Mode. This command is not a default attack setting. This is not set for protection by default on OmniAccess 5510 USG, but you can turn it on by explicitly adding the above command in the user-defined attack prevention list.

PARAMETERS

None.

EXAMPLEALU(config-firewall-attack-A1)# icmp-block-trace-route

Parameter Description

in Firewall policy is attached to the ingress traffic.

out Firewall policy is attached to the egress traffic.

policy-name Name of the firewall policy.

689Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Filter and Firewall

Left running head: Chapter name (automatic)

ICMP-DEST-UNRCH-STORMicmp-dest-unrch-storm [threshold <1-4294967295> <1-4294967295>]

DESCRIPTION

This command is entered in the Firewall-Attack Sub Configuration Mode. This attack is implicitly a part of the default attack prevention list. However, if you do not want to use these default lists, he can turn on only a selected number of attacks by using their respective keywords with parameters.

PARAMETERS

DEFAULT VALUE

The default is 10 packets in 1000 milliseconds.

EXAMPLEALU(config-firewall-attack-A1)# icmp-dest-unrch-storm threshold 11 5

Parameter Description

threshold To set a threshold limit.

<1-4294967295> <1-4294967295> Number of packets permissible within a defined interval.

690

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

icmp-ip-address-sweep

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

ICMP-IP-ADDRESS-SWEEPicmp-ip-address-sweep [threshold <1-4294967295> <1-4294967295>]

DESCRIPTION

This command is entered in the Firewall-Attack Sub Configuration Mode. An address sweep attack occurs when a source IP address sends number of ICMP echo requests (or pings) to different hosts within a defined interval. The purpose of this scheme is to ping several hosts in the hope that one will reply, thus uncovering an address to target, resulting in system failure. This command is included in OmniAccess 5510 USG’s default attack prevention list.

PARAMETERS

DEFAULT VALUE

The default is 100 packets in 1000 milliseconds.

EXAMPLEALU(config-firewall-attack-A1)# icmp-ip-address-sweep threshold 18 6

Parameter Description

threshold Threshold limit set.

<1-4294967295> <1-4294967295> Number of packets permissible within a defined interval.

691Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Filter and Firewall

Left running head: Chapter name (automatic)

ICMP-PING-FLOODicmp-ping-flood [threshold <1-4294967295> <1-4294967295>]

DESCRIPTION

This command is entered in the Firewall-Attack Sub Configuration Mode. A perpetrator sends a large amount of ICMP echo (ping) traffic at IP broadcast addresses, all of it having a spoofed source address of a victim. If the routing device delivering traffic to the broadcast addresses, performs the IP broadcast to another broadcast function. Most hosts on that IP network will take the ICMP echo request and reply to it with an echo reply each, and multiply the traffic by the number of hosts responding.To secure system from this kind of ping flooding, this command is included in the default attack prevention list.

PARAMETERS

DEFAULT VALUE

The default is 100 packets in 1000 milliseconds.

EXAMPLEALU(config-firewall-attack-A1)# icmp-ping-flood threshold 20 7

Parameter Description

threshold Threshold limit set.

<1-4294967295> <1-4294967295> Number of packets permissible within a defined interval.

692

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

icmp-ping-of-death

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

ICMP-PING-OF-DEATH icmp-ping-of-death [{max-frag-num|max-total-length} <1-4294967295>]

DESCRIPTION

This command is entered in the Firewall-Attack Sub Configuration Mode. The TCP/IP specification requires a specific packet size for datagram transmission. Many ping implementations allow you to specify a larger packet size if desired. A grossly oversized ICMP packet can trigger a range of adverse system reactions such as denial of service (DoS), crashing, freezing, and rebooting. This command is also placed in the DoS attack prevention list to secure the system from this attack.

PARAMETERS

DEFAULT VALUE• Number of the maximum fragments allowed in one ping packet, default value is 50• Number of maximum length of the whole ping packet total, default value is 65507

EXAMPLEALU(config-firewall-attack-A1)# icmp-ping-of-death max-frag-num 100

ICMP-REDIRECTicmp-redirect

DESCRIPTION

This command is entered in the Firewall-Attack Sub Configuration Mode. This command is not a default DoS setting. The above command can be included in the DoS prevention list to avoid this kind of attacks.

PARAMETERS

None.

EXAMPLEALU(config-firewall-attack-A1)# icmp-redirect

Parameter Description

max-frag-num <1-4294967295> Number of the maximum fragments allowed in one ping packet.

max-total-length <1-4294967295>

Number of maximum length of the whole ping packet total.

693Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Filter and Firewall

Left running head: Chapter name (automatic)

ICMP-ROUTER-ADVERTISEMENTicmp-router-advertisement

DESCRIPTION

This command is entered in the Firewall-Attack Sub Configuration Mode. Remote attackers can spoof these ICMP packets and remotely add bad default-route entries into a victims routing table. Since the victims’ systems would be forwarding the frames to the wrong address, it would be unable to reach other networks.

PARAMETERS

None.

EXAMPLEALU(config-firewall-attack-A1)# icmp-router-advertisement

ICMP-SMURF-ATTACKicmp-smurf-attack

DESCRIPTION

This command is entered in the Firewall-Attack Sub Configuration Mode. An assault on a network that floods it with excessive messages in order to impede normal traffic. It is accomplished by sending ping requests (ICMP echo requests) to a broadcast address on the target network or an intermediate network. The return address is spoofed to the victim's address. Since a broadcast address is picked up by all nodes on the subnet, it functions like an amplifier, generating hundreds of responses from one request and eventually causing a traffic overload.

PARAMETERS

None.

EXAMPLEALU(config-firewall-attack-A1)# icmp-smurf-attack

694

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ip-land-attack

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IP-LAND-ATTACK ip-land-attack

DESCRIPTION

This command is entered in the Firewall-Attack Sub Configuration Mode. A LAND attack consists of a stream of TCP SYN packets that have the source IP address and TCP port number set to the same value as the destination address and port number (i.e., that of the attacked host). This command included in the default list provides protection to the system from these kind of attacks.

PARAMETERS

None.

EXAMPLE ALU(config-firewall-attack-A1)# ip-land-attack

IP-SOURCE-ROUTING ip-source-routing

DESCRIPTION

This command is entered in the Firewall-Attack Sub Configuration Mode.

Source routing is a technique whereby the sender of a packet can specify the route that a packet should take through the network. Attackers can use source routing to probe the network by forcing packets into specific parts of the network. Using source routing, an attacker can collect information about the networks topology, or other information that could be useful in performing an attack. During an attack, an attacker could use source routing to direct packets to bypass existing security restrictions. If the “default” keyword is not used, this attack can be prevented by including this in the user-defined attack protection list.

PARAMETERS

None.

EXAMPLE ALU(config-firewall-attack-A1)# ip-source-routing

695Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Filter and Firewall

Left running head: Chapter name (automatic)

IP-SPOOFINGip-spoofing

DESCRIPTION

This command is entered in the Firewall-Attack Sub Configuration Mode.

To gain access, intruders create packets with spoofed source IP addresses. This exploits applications that use authentication based on IP addresses and leads to unauthorized user and possibly root access on the targeted system.

Current intruder activity in spoofing source IP addresses can lead to unauthorized remote root access to the systems behind a filtering-router firewall. After gaining root access and taking over existing terminal and login connections, intruders can gain access to remote hosts. This command is not included in the default attack prevention list, you can explicitly include it to secure the system from this attack.

PARAMETERS

None.

EXAMPLE ALU(config-firewall-attack-A1)# ip-spoofing

IP-TEAR-DROPip-tear-drop

DESCRIPTION

This command is entered in the Firewall-Attack Sub Configuration Mode.

Teardrop attack tool attacks the vulnerability of the TCP/IP IP fragmentation re-assembly codes which do not properly handle the overlapping IP fragments.

PARAMETERS

None.

DEFAULT VALUE

By default, this attack is turned on.

EXAMPLE ALU(config-firewall-attack-A1)# ip-tear-drop

696

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ip-tiny-frag

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IP-TINY-FRAGip-tiny-frag [{max-frag-num|min-frag-size} <1-4294967295>]

DESCRIPTION

This command is entered in the Firewall-Attack Sub Configuration Mode.

If the fragment size is made small enough to force some of a TCP packet's TCP header fields into the second fragment, filter rules that specify patterns for those fields will not match. If the filtering implementation does not enforce a minimum fragment size, a disallowed packet might be passed because it didn't hit a match in the filter. This can be avoided by including the above command with a specified minimum fragment size in the user-defined attack prevention list or by just using the “default” keyword.

PARAMETERS

DEFAULT VALUE• By default, the maximum number of fragments allowed in the IP packet, is 50.• By default, the minimum size allowed in the IP fragment, is 64 bytes.

EXAMPLE ALU(config-firewall-attack-A1)# ip-tiny-frag min-frag-size 10

Parameter Description

max-frag-num <1-4294967295> Denotes the number of the maximum fragments allowed in the IP packet.

min-frag-size <1-4294967295> Denotes the number of minimum size of the IP fragment. When DoS detects a fragment smaller than this size, it will drop the packet.

697Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Filter and Firewall

Left running head: Chapter name (automatic)

IP-ZERO-LENGTH ip-zero-length

DESCRIPTION

This command is entered in the Firewall-Attack Sub Configuration Mode.

This attack is caused when the first fragment in the list is of 0-length. This sends a series of IP fragments such that a 0 length fragment is first in the fragment list. This makes it impossible for the kernel to deallocate the destination entry and remove it from the cache. This leads to a system crash. This attack is prevented by use of the above command.

PARAMETERS

None.

EXAMPLE

ALU(config-firewall-attack-A1)# ip-zero-length

NO ALLno all

This command is entered in the Firewall-Attack Sub Configuration Mode. The ‘no’ command disables all the attacks configured for an attack object.

NO ATTACK no attack <name>

This command is entered in the Firewall Configuration Mode. This deletes the specified DoS attack object and its configuration.You cannot delete an attack object if it is being used by a firewall policy.

NO ATTACK NAME FORCEno attack <name> [force]

This command is entered in the Configuration Mode. This deletes a specified DoS attack object from the global level.

Also, the "force" keyword can be used to delete an attack object. The attack gets removed from any firewall policy it is attached to.

698

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

no debug firewall

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NO DEBUG FIREWALLno debug firewall {session|filter|nat|attack|alg|intrusion| selector [saddr <ip-address>|daddr <ip-address>|protocol <number>|sport <number>|dport <number>][output|permanent]|all [detail-level]}

This command is entered in the Super User Mode or Configuration Mode. This command turns off the debugging functionality which is enabled using the above command. The “selector” keyword allows you to turn off debugging only for selected traffic.

NO DEFAULTno default [stateless]

This command is entered in the Firewall-Attack Sub Configuration Mode. The ‘no’ command disables all the default attacks configured for an attack object. Stateless keyword disables only the stateless default attacks.

NO FIREWALL POLICY {IN|OUT} no firewall policy {in|out} <policy-name>

This command is entered in the Interface Configuration Mode. This command detaches a firewall policy attached to an interface. This command does not delete the firewall policy definition in its entirety. It only detaches it from its interface. If the command "no firewall policy name" is issued at the top level and if this firewall policy is not bound to any interface, it deletes the firewall policy definition.

699Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Filter and Firewall

Left running head: Chapter name (automatic)

NO POLICYno policy <name> [force]

This command is entered in the Firewall Configuration Mode. The "force" keyword will detach the specified policy from respective interfaces, and deletes the policy. This command can also be used to delete all the policy rules.

NO RULEno rule <1-65535>

This command is entered in the Firewall Policy Sub Configuration Mode. This deletes only the rule in the firewall policy corresponding to the line number.

POLICYpolicy <name>

DESCRIPTION

This command is entered in the Firewall Configuration Mode. This command is used to configure a firewall policy. This enters the firewall policy sub-configuration mode

PARAMETERS

EXAMPLE

The following example depicts firewall policy configuration:ALU(config-firewall)# policy P1ALU(config-firewall-P1)#

Parameter Description

name Name of the firewall policy to be configured.

700

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

policy

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

To Create a DoS Rule Inside a Firewall Policy

[<1-65535>] match [any|all] <match-list name>... attack <name> {drop|reset} [time-range <name>]

This command is entered in the Firewall Policy Configuration Mode. This command is used to attach an attack object to a firewall policy, and configure rules (set priority for the rule, associate match-lists and action) for a firewall policy, and also set the action drop or reset for the configured rules.

In the following example, the attack object atk is configured to drop all the attacks:ALU(config-firewall-P1)# match m1 attack atk drop

In the following example, the attack object atk is configured to drop all the attacks and send acknowledgement such as an error report.

ALU(config-firewall-P1)# match m1 attack atk reset

Parameter Description

1-65535 Denotes the firewall policy rule number. The range for the DoS rule.

match [any|all] <match-list name>

match all - In this type of match, the relevant action is performed only when all the match-list criteria is satisfied.match any - In this type of match, the relevant action is performed even if any one of the match-list criterion is satisfied.

attack <name> Name of the attack.

drop The keyword “drop” drops the packets.

reset The keyword "reset" drops the packets and sends a reset message to the sender.

time-range <name> The name of the time range.

701Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Filter and Firewall

Left running head: Chapter name (automatic)

PORT-SCANport-scan [threshold <1-4294967295> <1-4294967295>]

DESCRIPTION

This command is entered in the Firewall-Attack Sub Configuration Mode. This command is used to configure port-scan attack for an attack object.

PARAMETERS

DEFAULT

The deafult is 5 packets in 1000 milliseconds.

EXAMPLEALU(config-firewall-attack-A1)# port-scan

RENUMBERrenumber

DESCRIPTION

This command is entered in the Firewall Configuration Mode. Use this command to generate a numbering scheme for the firewall policy rules configured.

PARAMETERS

None

EXAMPLEALU(config-firewall-P1)# renumber

Parameter Description

threshold Threshold limit set.

<1-4294967295> <1-4294967295> Number of packets permissible within a defined interval.

702

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show firewall attack

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW FIREWALL ATTACKshow firewall attack [<name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to view details of all configured attack objects. This command can also be used to view the details of a specific attack object.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLE

The following syntax is used to view the details of attack A1ALU# show firewall attack A1

attack A1 udp-port-loopback 10 1000 udp-flood 200 1000 tcp-fin-scan - - icmp-ip-address-sweep 2 10 icmp-dest-unrch-storm 2 10 icmp-ping-flood 2 10 tcp-syn-flood 100 1000 5 udp-fraggle-attack - - udp-snork-attack - - tcp-fin-no-ack - - tcp-syn-fin - - tcp-null-scan - - tcp-invalid-urgent-offset - - tcp-xmas-scan - - ip-land-attack - - ip-source-routing - - icmp-block-trace-route - - ip-spoofing - - icmp-redirect - - icmp-router-advertisement - - tcp-header-frag - - ip-zero-length - - ip-tiny-frag 50 64 icmp-ping-of-death 50 65507 ip-tear-drop - -

Parameter Description

name Name of the attack.

703Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Filter and Firewall

Left running head: Chapter name (automatic)

SHOW FIREWALL ATTACK SYSTEM-DEFAULTshow firewall attack system-default

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to view the attacks configured for the system default attack object.

PARAMETERS

None.

EXAMPLEALU# show firewall attack system-default

attack system-default udp-port-loopback 10 1000 udp-flood 200 1000 port-scan 5 1000 tcp-fin-scan - - icmp-ip-address-sweep 100 1000 icmp-dest-unrch-storm 10 1000 icmp-ping-flood 100 1000 tcp-syn-flood 100 1000 5 udp-fraggle-attack - - tcp-fin-no-ack - - tcp-syn-fin - - tcp-null-scan - - tcp-invalid-urgent-offset - - tcp-xmas-scan - - ip-land-attack - - icmp-echo-storm-attack - - udp-short-header - - tcp-header-frag - - ip-zero-length - - ip-tiny-frag 50 64 icmp-ping-of-death 50 65506 ip-tear-drop - -

704

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show firewall policy

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW FIREWALL POLICYshow firewall policy [<name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to view all the firewall policy details configured. This command is also used to view the details of a specific firewall policy.

PARAMETERS

EXAMPLE

To view the firewall policy details, use the following syntax:ALU# show firewall policy P1policy P1 10 match any dos attack P1 dropinterface FastEthernet0 In

SHOW FIREWALL POLICY SYSTEM-DEFAULTshow firewall policy system-default

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to view the system default policy configuration.

PARAMETERS

None.

EXAMPLEALU# show firewall policy system-default

policy system-default 10 match all attack system-default drop

system-traffic firewall policy system-default

Parameter Description

name Name of the policy.

705Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Filter and Firewall

Left running head: Chapter name (automatic)

SHOW FIREWALL SESSIONshow firewall session

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to view all the firewall sessions used by the system.

PARAMETERS

None.

EXAMPLE

The following syntax is used to view the details of firewall sessionALU# show firewall session

TCP Sessions : 0UDP Sessions : 0ICMP Sessions : 0GRE Sessions : 0Total Sessions : 0Free Sessions : 16000session_invalid_pak : 4

706

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show firewall session detail

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW FIREWALL SESSION DETAILshow firewall session detail [proto {gre|icmp|tcp|udp}|vrf <vrf-name> [destination|proto|source]]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to view all the firewall sessions in a detailed format.

PARAMETERS

EXAMPLE

The following syntax is used to view the details of firewall sessionALU(config)# show firewall session detail

ID 70 ICMP timeout 28 secs, used by NATInitiator: (10.91.1.108:13)=>(10.91.0.1:13)Responder: (10.91.0.1:34416)=>(10.91.1.108:34416)

Parameter Description

proto {gre|icmp|tcp|udp} Shows the session details for the specified protocol.

vrf-name Name of the VRF. When this is used, the command displays the sessions for the specified VRF.

707Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Filter and Firewall

Left running head: Chapter name (automatic)

SHOW FIREWALL SESSION PROTOshow firewall session [proto {gre|tcp|udp|icmp}]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the firewall sessions with respect to the protocol type.

PARAMETERS

EXAMPLE

The following syntax is used to view the details of firewall session with respect to ICMP protocol:ALU(config)# show firewall session proto icmp

ID 70 ICMP timeout 19 secs, used by NAT Initiator: (10.91.1.108:13)=>(10.91.0.1:13) Responder: (10.91.0.1:34416)=>(10.91.1.108:34416)

Parameter Description

proto Protocol type.

gre Shows the session details for GRE protocol only.

tcp Shows the session details for TCP protocol only.

udp Shows the session details for UDP protocol only.

icmp Shows the session details for ICMP protocol only.

708

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show firewall session destination

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW FIREWALL SESSION DESTINATIONshow firewall session [destination {ip <ip-address>|net <ip-address/prefix-length>} [{<1-65535>|proto {gre|icmp|tcp|udp} |source}]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to view the firewall session details given the source address.

PARAMETERS

EXAMPLEALU(config-if FastEthernet0)# show firewall session destination ip 10.91.0.1

ID 70 ICMP timeout 25 secs, used by NAT Initiator: (10.91.1.108:13)=>(10.91.0.1:13) Responder: (10.91.0.1:34416)=>(10.91.1.108:34416)

Parameter Description

ip-address Destination IP address.

ip-address/prefix-length Destination IP address with prefix length.

1-65535 Denotes the port number.

gre|icmp|tcp|udp Protocol type.

709Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Filter and Firewall

Left running head: Chapter name (automatic)

SHOW FIREWALL SESSION SOURCEshow firewall session [source {ip <ip-address>|net <ip-address/prefix-length>} [{<1-65535>|proto {gre|icmp|tcp|udp} |destination}]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode or Interface Configuration Mode. This command is used to view the firewall session details given the source address.

PARAMETERS

EXAMPLEALU(config-if FastEthernet0)# show firewall session source ip 10.91.1.108

ID 70 ICMP timeout 25 secs, used by NAT Initiator: (10.91.1.108:13)=>(10.91.0.1:13) Responder: (10.91.0.1:34416)=>(10.91.1.108:34416)

TCP-FIN-NO-ACK tcp-fin-no-ack

DESCRIPTION

This command is entered in the Firewall-Attack Sub Configuration Mode. TCP packets without ACK are set for FIN.This leads to system crashing at times. To avoid this mishap, include the above command in the user-defined attack prevention list or just use the “default” keyword.

PARAMETERS

None.

EXAMPLE ALU(config-firewall-attack-A1)# tcp-fin-no-ack

Parameter Description

ip-address Source IP address.

ip-address/prefix-length Source IP address with prefix length.

1-65535 Denotes the port number.

gre|icmp|tcp|udp Protocol type.

710

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

tcp-fin-scan

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

TCP-FIN-SCANtcp-fin-scan

DESCRIPTION

This command is entered in the Firewall-Attack Sub Configuration Mode. TCP FIN flooding. To secure system from this kind of flooding, this command is placed in the default attack prevention list.

PARAMETERS

None.

EXAMPLEALU(config-firewall-attack-A1)# tcp-fin-scan

TCP-HEADER-FRAG tcp-header-frag

DESCRIPTION

This command is entered in the Firewall-Attack Sub Configuration Mode. In this attack, a TCP header is split into multiple frames in an attempt to bypass firewalls or intrusion detection systems. This could lead to secure information also being passed through the filter. To retain security, this command also forms a part of the default attack prevention list.

PARAMETERS

None.

EXAMPLE ALU(config-firewall-attack-A1)# tcp-header-frag

711Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Filter and Firewall

Left running head: Chapter name (automatic)

TCP-INVALID-URGENT-OFFSET tcp-invalid-urgent-offset

DESCRIPTION

This command is entered in the Firewall-Attack Sub Configuration Mode. The intruder sends a TCP frame with an Urgent pointer which points past the end of the data. This may cause some TCP/IP implementations to become unstable or crash. Some TCP/IP implementations will hang when receiving many such frames.

PARAMETERS

None.

EXAMPLEALU(config-firewall-attack-A1)# tcp-invalid-urgent-offset

TCP-NULL-SCAN tcp-null-scan

DESCRIPTION

This command is entered in the Firewall-Attack Sub Configuration Mode. TCP packets without any flag set. Leads to inability to scan such packets. This attack can also be avoided by including this command in the user-defined prevention list or by the “default” keyword.

PARAMETERS

None.

EXAMPLE ALU(config-firewall-attack-A1)# tcp-null-scan

712

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

tcp-syn-fin

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

TCP-SYN-FINtcp-syn-fin

DESCRIPTION

This command is entered in the Firewall-Attack Sub Configuration Mode.

It has TCP packets with both SYN and FIN flag set, causing a denial of service. The above keyword is also turned on by default. If you wish to disable this, you can override this keyword and then turn it on when necessary by including this command in the user-defined attack prevention list.

PARAMETERS

None.

EXAMPLE ALU(config-firewall-attack-A1)# tcp-syn-fin

713Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Filter and Firewall

Left running head: Chapter name (automatic)

TCP-SYN-FLOODtcp-syn-flood [{threshold <1-4294967295> <1-4294967295> |timeout <1-4294967295>}]

DESCRIPTION

This command is entered in the Firewall-Attack Sub Configuration Mode.

The server builds in its system memory a data structure describing all pending connections. This data structure is of finite size, and it can be made to overflow by intentionally creating too many partially-open connections. Systems providing TCP-based services to the Internet community may be unable to provide services while under this attack and for some time after this attack ceases. To protect the system from this attack, use this command.

PARAMETERS

DEFAULT VALUE

The default is 100 packets in 1000 milliseconds.

EXAMPLE

Consider the following example, here if you do not explicitly provide the threshold value for the attack, the default value is taken:ALU(config-attack A4)# tcp-syn-flood

Parameter Description

threshold Threshold limit set.

<1-4294967295> <1-4294967295>

Number of packets permissible within a defined interval.

timeout <1-4294967295> TCP Proxy timeout in seconds

714

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

tcp-xmas-scan

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

TCP-XMAS-SCAN tcp-xmas-scan

DESCRIPTION

This command is entered in the Firewall-Attack Sub Configuration Mode.

This frame should never be seen in normal TCP operation. Sometimes this is done in preparation for a future attack, or sometimes it is done to see if the system has a service which is susceptible to attack. A TCP frame has been seen with a sequence number of zero and the FIN, URG and PUSH bits all set. To avoid this attack include the above command.

PARAMETERS

None.

EXAMPLEALU(config-firewall-attack-A1)# tcp-xmas-scan

UDP-FLOODudp-flood [threshold <1-4294967295> <1-4294967295>]

DESCRIPTION

This command is entered in the Firewall-Attack Sub Configuration Mode. This command is used to configure udp-flood attack for an attack object.

PARAMETERS

DEFAULT The default is 4 packets per 20 milliseconds.

EXAMPLEALU(config-firewall-attack-A1)# udp-flood

Parameter Description

threshold Threshold limit set.

<1-4294967295> <1-4294967295> Number of packets permissible within a defined interval.

715Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Filter and Firewall

Left running head: Chapter name (automatic)

UDP-FRAGGLE-ATTACKudp-fraggle-attack

DESCRIPTION

This command is entered in the Firewall-Attack Sub Configuration Mode.

When a perpetrator sends a large number of UDP echo (ping) traffic at IP broadcast addresses, all of it having a fake source address, it causes system crash or denial of service. The above command is included in the default attack prevention list to secure the system from this attack.

PARAMETERS

None.

EXAMPLEALU(config-firewall-attack-A1)# udp-fraggle-attack

UDP-PORT-LOOPBACKudp-port-loopback [threshold <1-4294967295> <1-4294967295>]

DESCRIPTION

This command is entered in the Firewall-Attack Sub Configuration Mode.

A UDP packet travels between two "echoing" ports. Such packets can bounce infinite number of times, using up network bandwidth and CPU. An intruder can cause problems by spoofing a packet from one machine and send it to another.The malicious intruder could generate lots of these packets in order to totally overwhelm the systems and network. This keyword is included with appropriate parameters in the default list.

PARAMETERS

DEFAULT VALUE

The default is 10 packets in 1000ms.

EXAMPLEALU(config)# attack A4ALU(config-attack A4)# udp-port-loopback threshold 30 13

Parameter Description

threshold Threshold limit set.

<1-4294967295> <1-4294967295> Number of packets permissible within a defined interval.

716

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

udp-snork-attack

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

UDP-SNORK-ATTACK udp-snork-attack

DESCRIPTION

This command is entered in the Firewall-Attack Sub Configuration Mode.

This is an attempt to connect two services which, if enabled, will engage in an indefinite communication with each other. This will cause many frames to be unnecessarily transmitted, and dramatically reduce the performance of the network and the systems involved. To avoid this Denial of Service overload attempt, this command is placed in the default prevention list.

PARAMETERS

None.

EXAMPLEALU(config-firewall-attack-A1)# udp-snork-attack

717Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Filter and Firewall

Left running head: Chapter name (automatic)

TIME-RANGE CLI COMMANDS

ABSOLUTE|PERIODICabsolute <hh:mm:ss> <mm/dd/yyyy> [to <hh:mm:ss> <mm/dd/yyyy>] |periodic {daily|weekly {sunday|monday|....}|weekend|} <hh:mm:ss> to <hh:mm:ss>}]

DESCRIPTION

This command is entered in the Time-range mode. This command is used to configure an absolute or periodic time-range object.

PARAMETERS

EXAMPLEALU(config-time-range-t1)# absolute 10:20:00 12/20/2003 to 13:15:00 4/15/2004

ALU(config-time-range t2)# periodic daily 08:00:00 to 19:00:00

ALU(config-time-range t3)# periodic weekly wednesday 10:00:00 to 13:30:00

Parameter Description

absolute <hh:mm:ss> <mm/dd/yyyy>

Absolute time range. This denotes the “From” date.Time in hours:minutes:secondsDate in month/day/year.

to <hh:mm:ss> <mm/dd/yyyy> Denotes the “to” date. Time in hours:minutes:secondsDate in month/day/year.

periodic Choice to select a varied time range.

daily|weekly {sunday|monday|...

Mandatory if the keyword periodic is used. It gives the option to select any variant with respect to the user’s choice.If weekly keyword is selected, then this option is mandatory to select any one day in the week.

<hh:mm:ss> to <mm/dd/yyyy> This gives the time range in hours:minutes:secondsDate in month/day/year.

718

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

no time-range

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NO TIME-RANGEno time-range <name>

This command is entered in the Configuration Mode. This command is used to delete a specific time-range.

SHOW TIME-RANGEshow time-range [<name>]

DESCRIPTIONThis command is entered in the Super User Mode or Configuration Mode. This command is used to view information of all the time-range configured on the system or a specific time-range.

PARAMETERS

EXAMPLE

If “t1” is a schedule, then to view the particulars in it, use the following command: ALU# show time-rangetime-range t1 absolute 10:10:10 5/6/2006

TIME-RANGE time-range <name>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure a time-range object that can be used across applications.

PARAMETERS

EXAMPLEALU(config)# time-range t1ALU(config-time-range-t1)#

Parameter Description

name Time-range name.

Parameter Description

name Name of the time-range.

719Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Filter and Firewall

Left running head: Chapter name (automatic)

ALG CLI COMMANDS

CLEAR FIREWALL ALG SIP STATISTICSclear firewall alg sip statistics

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to clear the the ALG SIP statistics.

PARAMETERS

None.

EXAMPLEALU(config)# clear firewall alg sip statistics

SHOW FIREWALL ALG DNS DEBUG-COUNTERSshow firewall alg dns debug-counters

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to view the DNS ALG debug counters.

PARAMETERS

None.

EXAMPLEALU(config)# show firewall alg dns debug-counters

Total malloc operations : 0Total failed malloc operations : 0Total memory release operations : 0

720

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show firewall alg dns statistics

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW FIREWALL ALG DNS STATISTICSshow firewall alg dns statistics

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to view the DNS ALG statistics.

PARAMETERS

None.

EXAMPLEALU(config)# show firewall alg dns statistics

Total DNAT Ordinary Queries : 0Total DNAT Inverse Queries : 0Total DNAT Ordinary Query Responses : 0Total DNAT Inverse Query Responses : 0Total non-translated Packets : 0

SHOW FIREWALL ALG FTP DEBUG-COUNTERSshow firewall alg ftp debug-counters

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This show command is entered in the Configuration Mode. This command is used to view the FTP ALG debug counters.

PARAMETERS

None.

EXAMPLEALU(config)# show firewall alg ftp debug-counters

Total malloc operations : 0Total failed malloc operations : 0Total memory release operations : 0

721Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Filter and Firewall

Left running head: Chapter name (automatic)

SHOW FIREWALL ALG FTP STATISTICSshow firewall alg ftp statistics

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to view the FTP ALG statistics.

PARAMETERS

None.

EXAMPLEALU(config)# show firewall alg ftp statistics

Total SNAT Port commands : 0Total DNAT Port commands : 0Total Filter Port commands : 0Total SNAT Pasv Response commands : 0Total DNAT Pasv Response commands : 0Total Filter Pasv Response commands : 0Total Pinholes created : 0Total Pinholes matched : 0Total Pinholes timed out : 0Total Pinholes failed : 0

SHOW FIREWALL ALG RPC DEBUG-COUNTERSshow firewall alg rpc debug-counters

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to view the RPC ALG debug counters.

PARAMETERS

None.

EXAMPLEALU(config)# show firewall alg rpc debug-counters

Total malloc passed : 0Total malloc failed : 0Total memory free count : 0

722

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show firewall alg rpc statistics

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW FIREWALL ALG RPC STATISTICSshow firewall alg rpc statistics

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to view the RPC ALG statistics.

PARAMETERS

None.

EXAMPLEALU(config)# show firewall alg rpc statistics

Total SNAT RPC CALL Packets : 0Total DNAT RPC REPLY Packets : 0Total DNAT DUMP REPLY Packets : 0Total Pinholes created : 0Total Pinholes matched : 0Total Pinholes failed : 0Total Pinholes removed : 0

SHOW FIREWALL ALG RTSP DEBUG-COUNTERSshow firewall alg rtsp debug-counters

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to view the RTSP ALG debug counters.

PARAMETERS

None.

EXAMPLEALU(config)# show firewall alg rtsp debug-counters

Currently registered RTSP families : 0

723Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Filter and Firewall

Left running head: Chapter name (automatic)

SHOW FIREWALL ALG RTSP STATISTICSshow firewall alg rtsp statistics

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to view the RTSP ALG statistics.

PARAMETERS

None.

EXAMPLEALU(config)# show firewall alg rtsp statistics

Total RTSP sessions : 0Total RTP sessions : 0Total RTCP sessions : 0Total RTP Pinholes created : 0Total RTP Pinholes matched : 0Total RTP Pinholes timed-out : 0Total RTCP Pinholes created : 0Total RTCP Pinholes matched : 0Total RTCP Pinholes timed-out : 0

SHOW FIREWALL ALG SIP DEBUG-COUNTERSshow firewall alg sip debug-counters

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to view the SIP ALG debug counters.

PARAMETERS

None.

EXAMPLEALU(config)# show firewall alg sip debug-countersTotal malloc passed, sip sessions and calls : 0Total malloc failed : 0Total memory free count, sip sessions and calls : 0Total sip packets translated : 0Total sdp packets translated : 0Total sip packets retransmitted : 0

724

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show firewall alg sip statistics

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW FIREWALL ALG SIP STATISTICSshow firewall alg sip statistics

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to view the SIP ALG statistics.

PARAMETERS

None.

EXAMPLEALU(config)# show firewall alg sip statisticsTotal SIP Connections : 1Total allocated SIP Call Sessions : 1Total SIP Call Sessions freed : 0Total RTP Sessions : 0Total RTCP Sessions : 0Total RTP Pinholes created : 2Total RTP Pinholes freed : 1Total RTP Pinholes matched : 1Total RTP Pinholes timeout : 0Total RTCP Pinholes created : 2Total RTCP Pinholes freed : 0Total RTCP Pinholes matched : 0Total RTCP Pinholes timeout : 0Total SIP Packets with Non-SDP message body : 0Total SIP Packets with invalidate payload : 0Total SIP Packets with invalidate SDP payload : 0Total SIP Packets out of order : 0

SHOW FIREWALL ALG TFTP DEBUG-COUNTERSshow firewall alg tftp debug-counters

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to view the TFTP ALG debug counters.

PARAMETERS

None.

EXAMPLEALU(config)# show firewall alg tftp debug-counters

Total malloc operations : 0Total failed malloc operations : 0Total memory release operations : 0

725Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Filter and Firewall

Left running head: Chapter name (automatic)

SHOW FIREWALL ALG TFTP STATISTICSshow firewall alg tftp statistics

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to view the TFTP ALG statistics.

PARAMETERS

None.

EXAMPLEALU(config)# show firewall alg tftp statistics

Total SNAT Write commands : 0Total DNAT Write commands : 0Total Filter Write Commands : 0Total SNAT Read Commands : 0Total DNAT Read Commands : 0Total Filter Read commands : 0Total Pinholes created : 0Total Pinholes matched : 0Total Pinholes timed out : 0Total Pinholes failed : 0

TCP ANY ANY SERVICEtcp any any service {dns|ftp|nfs|rpc-portmap|rtsp|sip}

DESCRIPTION

This command is entered in the Match-list mode. This command is used to enable DNS, FTP, NFS, RPC-Portmap, RTSP or SIP ALG.

PARAMETERS

EXAMPLEALU(config)# match-list m1ALU(config-match-list-m1)# tcp any any service dns

Parameter Description

dns|ftp|nfs|sip|rtsp Type of ALG service.

726

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

udp any any service

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

UDP ANY ANY SERVICEudp any any service {dns|nfs|rpc-portmap|sip|tftp}

DESCRIPTION

This command is entered in the Match-list mode. This command is used to enable DNS, NFS, RPC-Portmap, TFTP, or SIP ALG.

PARAMETERS

EXAMPLEALU(config)# match-list m1ALU(config-match-list-m1)# udp any any service sip

Parameter Description

dns|nfs|sip|tftp Type of ALG service.

727Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Filter and Firewall

Left running head: Chapter name (automatic)

CUSTOMIZED-SERVICE RULE BASED ALG CONFIGURATION COMMANDS

CHANGEchange {<1-65535> <1-65535>}

DESCRIPTION

This command is entered in the Customized Service mode. Use this command to change the priority of a specific ALG rule configured.

PARAMETERS

EXAMPLE

The following example shows how to change the priority of an ALG rule;ALU(config-customized-service)# change 10 1

CUSTOMIZED-SERVICEcustomized-service

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure ALG. This also enters into customized service configuration mode.

PARAMETERS

None.

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# customized-service

Parameter Description

1-65535 Denotes the ALG rule number. This rule number signifies the priority of a rule.

728

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

customized-service

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

To Create a ALG Rule:

[<1-65535>] match [any|all] <match-list name>... service {service-name|alcatel-tftp|dns|ftp|none|rpc|rtsp|sip [pinhole] |tftp}

This command creates a rule for mapping ALG action for a well known service to a non-standard port or disable a well known service on its well known port.

The range for the rule number is 1-65535.

The following example shows that if the packet is intended for the server with address 20.1.1.1 comes to port 100, then the service is recognized as FTP and the ALG is invoked accordingly. The standard port invocation of ALG is also active here.

ALU(config)# match-list m1ALU(config-match-list-m1)# tcp any host 20.1.1.1 service 100ALU(config-customized-service)# match all m1 service ftp

RELEASE HISTORY

Release 3.0: parameter [pinhole] was introduced.

Parameter Description

1-65535 Denotes the customized ALG rule number. This rule number signifies the priority of a rule.

match-list name Name of the match-list.

service-name Type of service.

729Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Filter and Firewall

Left running head: Chapter name (automatic)

NO RULE no rule <1-65535>

This command is entered in the Customized Service mode. This command deletes an existing ALG rule.

SHOW CUSTOMIZED-SERVICE show customized-service

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command shows the ALG rule based service details.

PARAMETERS

None.

EXAMPLEALU(config)# show customized-service20 match any m2 service none

730

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

IP Security - Virtual Private Network

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 31 IP SECURITY - VIRTUAL PRIVATE NETWORK

This chapter provides the CLI syntax of the various commands needed to configure IPsec.

This chapter includes table of parameters, default values, and configuration examples for IPsec configurations as quick-start and reference information. All the commands are described in alphabetical order. For more detailed information on configuring IPsec, refer OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

Common Classification (CC) commands are used in these CLIs. Refer to the “Common Classifiers” chapter in this guide to know more.

731Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

AUTHENTICATIONauthentication {pre-shared|rsa-sig}

DESCRIPTION

This command is entered in the IKE Policy Configuration Mode. This command configures the authentication type to be used during IKE negotiation.

PARAMETERS

None.

DEFAULT VALUE

If the authentication type is not explicitly configured, by default ‘pre-shared’ is used.

EXAMPLEALU(config-crypto-ike-policy-P1)# authentication pre-shared

CLEAR CRYPTO IPSEC COUNTERSclear crypto ipsec counters

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to reset the IPsec SA related counters for Encapsulation, Encryption, Authentication, and Error.

PARAMETERS

None.

EXAMPLEALU# clear crypto ipsec counters

732

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

clear crypto ipsec sa

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CLEAR CRYPTO IPSEC SA clear crypto ipsec sa {all|<1-65535>}

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to clear all the IPsec SAs or IPsec SAs corresponding to a specific SA index.

PARAMETERS

EXAMPLEALU# clear crypto ipsec sa all

ALU# clear crypto ipsec sa 16

Note: The sa-index must be a valid sa-index of an outbound SA.

CRYPTO CA CERT crypto ca-cert <name> delete

DESCRIPTION

This command is entered in the Configuration Mode. This command deletes the specified CA certificate.

PARAMETERS

EXAMPLEALU(config)# crypto ca-cert ALUca delete

Parameter Description

all Clears all IPSec SAs.

1-65535 ID on the outbound SA to be cleared.

Parameter Description

name The CA certificate name.

733Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

CRYPTO CA IDENTITY crypto ca identity <name>

DESCRIPTION

This command is entered in the Configuration Mode. This command configures a CA identity with the name specified.

PARAMETERS

EXAMPLEALU(config)# crypto ca identity ALUCA

CRYPTO CERTIFICATE-DATABASE REFRESH crypto certificate-database refresh

DESCRIPTION

This command is entered in the Configuration Mode. This command adds the imported certificate or key to the IPsec database. This operation need not be performed after every certificate/key import, but once all the certificates/keys are imported.

Note: The crypto certificates will take into effect only after issuing the ‘refresh’ command.

PARAMETERS

None.

EXAMPLEALU(config)# crypto certificate-database refresh

Parameter Description

name The name given to the Certificate Authority.

734

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

crypto certificate-request export

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CRYPTO CERTIFICATE-REQUEST EXPORTcrypto certificate-request <name> export [fpkey <file-path> |ftp:|tftp:|scp:]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command exports the CSR from OmniAccess 5510 USG to a remote location. Currently, SCP option is not supported.

PARAMETERS

EXAMPLEALU(config)# crypto certificate-request req_Simpsom export ftp:

CRYPTO CERTIFICATE-REQUEST GENERATE KEY-NAMEcrypto certificate-request <name> generate key-name <name> ca <name>

DESCRIPTION

This command is entered in the Configuration Mode. This command generates a CSR for the specified CA.

PARAMETERS

EXAMPLEALU(config)# crypto certificate-request req_Simpson generate key-name exampleKey ca ALUCA

Parameter Description

name Name is used to identify the certificate.

fpkey <file-path> FPkey file path. To copy the certificate into the front panel USB memory.

Parameter Description

name Name used to identify the certificate

key-name <name> Name of the RSA key previously generated.

ca <name> Name of the CA identity previously configured.

735Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

CRYPTO CRL-CHECK STRICTcrypto crl-check strict

DESCRIPTION

This command is entered in the Configuration Mode. This command makes the CRL policy strict. It ensures that if no CRL is present or if the CRL is already expired, then no negotiation takes place until a new CRL is imported.

PARAMETERS

None.

EXAMPLEALU(config)# crypto crl-check strict

CRYPTO IKE DPD INTERVAL crypto ike dpd interval <5-3600> [timeout <5-72000>]

DESCRIPTION

This command is entered in the Configuration Mode. This command configures the DPD globally with the interval in seconds for which the keep-alive messages will be sent, and the timeout in seconds after which the peer will be declared to be dead.

PARAMETERS

DEFAULT VALUE

The default value for DPD timeout is three times that of the DPD interval specified.

EXAMPLEALU(config)# crypto ike dpd interval 10 timeout 35

Parameter Description

5-3600 Configures the keep-alive interval in seconds for which the keep-alive messages will be sent.

5-72000 Specify the timeout interval (in seconds) after which the peer will be declared to be dead.

736

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

crypto ike identity

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CRYPTO IKE IDENTITY crypto ike identity <name> [force]

DESCRIPTION

This command is entered in the Configuration Mode. This command configures an IKE identity. Entering this command changes the mode to IKE identity mode.

PARAMETERS

EXAMPLEALU(config)# crypto ike identity exampleidentityALU(config-ike-identity-exampleidentity)#

Parameter Description

name Identifies the IKE identity.

737Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

CRYPTO IKE KEYcrypto ike key <key-string> [vrf <name>] peer {<peer-address>|<FQDN>}[force]

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure a pre-shared key. The key is same on both the IPsec gateways. It is denoted in the form of a key-string. The peer can either be an IP address or fully qualified domain name (FQDN) of the peer at the remote end.

DNS client configuration is prerequisite for configuring peer as FQDN. For FQDN resolution, “ip domain-lookup” and “ip name-server” commands should be configured. This name server should be reachable by the system.

PARAMETERS

DEFAULT VALUE

There is no default pre-shared authentication key.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# crypto ike key top_secret1612 peer 10.10.1.2ALU(config)# crypto ike key "!netsecret!" peer 202.54.30.100ALU(config)# crypto ike key secret1234 peer mysmb.dyndns.org

RELEASE HISTORY

Release 3.0: Parameter “FQDN” was introduced.

Parameter Description

key-string Denotes an alphanumeric unique key string. The IKE key is given by means of a key-string and supports both string and hex values. The IKE key is given by means of a key-string. Currently, the preshared-key length is restricted to 128 characters, and the minimum length is 8 characters.

vrf <name> Name of the VRF.

peer-address Peer address/ host name for identification.

FQDN Fully qualified domain name (FQDN) of the peer at the remote end.

force Edits or modifies the IKE keys, which are already configured.

738

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

crypto ike policy

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CRYPTO IKE POLICYcrypto ike policy <name> [force]

DESCRIPTION

This command is entered in the Configuration Mode. This command configures an IKE policy.

PARAMETERS

EXAMPLEALU(config)# crypto ike policy P1ALU(config-crypto-ike-policy-P1)#

Parameter Description

name IKE policy name.

739Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

CRYPTO IPSEC TRANSFORM-SETcrypto ipsec transform-set <name> {<algo>[<algo>][<algo>] [<algo>]} [force]

DESCRIPTION

This command is entered in the Configuration Mode. This command creates a transform-set.

Options for Proposal Under Transform-set • esp-md5-3des encapsulation with MD5 and three key Triple DES• esp-md5-aes128 encapsulation with MD5 and 128 bit AES encryption• esp-md5-aes192 encapsulation with MD5 and 192 bit AES encryption• esp-md5-aes256 encapsulation with MD5 and 256 bit AES encryption• esp-md5-des encapsulation with MD5 and 56 bit DES encryption• esp-sha1-3des encapsulation with SHA1 and three key Triple DES• esp-sha1-aes128 encapsulation with SHA1 and 128 bit AES encryption• esp-sha1-aes192 encapsulation with SHA1 and 192 bit AES encryption• esp-sha1-aes256 encapsulation with SHA1 and 256 bit AES encryption• esp-sha1-des encapsulation with SHA1 and 56 bit DES encryption

PARAMETERS

DEFAULT VALUE

OmniAccess 5510 USG will have a default transform-set configuration with parameters esp-md5-des and esp-sha1-des

EXAMPLEALU(config)# crypto ipsec transform-set netset esp-sha1-aes256

Parameter Description

name Name of the transform-set used.

algo Authentication or encryption algorithm.

740

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

crypto key export rsa <name>

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CRYPTO KEY EXPORT RSA <NAME>crypto key export rsa <name> [fpkey <file-path>|ftp:|tftp: scp:]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command exports the RSA keys from OmniAccess 5510 USG. If none of the optional arguments are used, it works like a show command.

Note: Currently, SCP option is not supported.

PARAMETERS

EXAMPLEALU(config)# crypto key export rsa examplekey tftp:

Parameter Description

name Name of the RSA key pair.

fpkey <file-path> FPkey file path. To copy the certificate into the front panel USB memory.

741Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

CRYPTO KEY GENERATE RSAcrypto key generate rsa <512-4096> <name> [bg]

DESCRIPTION

This command is entered in the Configuration Mode. This command generates an RSA key pair.

PARAMETERS

EXAMPLEALU(config)#crypto key generate rsa 1024 exampleKey% The generated keys will be named examplekey... starting key generation.Please wait...% Keys successfully generated

Parameter Description

512-4096 Modulus length of the key generated.

name Name that will be used to identify the key.

bg This is used to generate keys in the background when modulus is greater than 2000.

742

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

crypto key import rsa name

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CRYPTO KEY IMPORT RSA NAMEcrypto key import rsa <name> {<RSA-keypair>|fpkey <file-path>|ftp:|tftp:|http:|https:|scp:}

DESCRIPTION

This command is entered in the Configuration Mode. This command imports an RSA key pair from a remote location.

You also have an option to directly enter or paste the keys after the command. Enter upto 80 characters on a line. Enter a blank line to exit. Currently, SCP option is not supported.

PARAMETERS

EXAMPLEALU(config)# crypto key import rsa testKey ftp:

CRYPTO NAT-TRAVERSALcrypto nat-traversal {enable|disable}

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to enable or disable NAT traversal for IPsec on the OmniAccess 5510 USG.

PARAMETERS

None.

DEFAULT VALUE

By default, NAT Traversal is enabled.

EXAMPLEALU(config)# crypto nat-traversal disable

Parameter Description

name Name of the RSA key pair.

RSA-keypair Directly enter or paste the keys after the command.

fpkey <file-path> FPkey file path. To copy the certificate into the front panel USB memory.

743Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

CRYPTO MAP crypto map <name> ipsec-ike <ike-policy name>} [force]

DESCRIPTION

This command is entered in the Configuration Mode. This command creates a crypto map, and attaches an IKE policy to it.• Which traffic should be protected by IPsec. (as defined by match-list earlier).• Where the IPsec-protected traffic should be sent (remote ipsec peer).• What kind of IPsec security to be applied to this traffic (as configured by the

transform-set).• Security associations are established via IKE.• The crypto map name can have a maximum of 32 characters.

PARAMETERS

EXAMPLEALU(config)# crypto map exampleMap ipsec-ike examplePolicy

CRYPTO MAP <MAP-NAME>crypto map <map-name>

DESCRIPTION

Crypto map needs to be applied to an interface through which the IPsec traffic flows. Binding a crypto map to an interface instructs the system to evaluate all the interface traffic against the crypto map, and to use the specified policy during connection or security association negotiation.

This command is entered in the Interface Configuration Mode. This command is used to attach a crypto map to an interface.

PARAMETERS

EXAMPLEALU(config)# interface FastEthernet 0ALU(config-if FastEthernet0)# crypto map exampleMap

Parameter Description

name Name of the crypto map.

ike-policy name Name of the IKE policy.

Parameter Description

map-name Name of the crypto map.

744

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

crypto peer-certificate import

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CRYPTO PEER-CERTIFICATE IMPORT crypto peer-certificate <name> import {<certificate-content> |fpkey <file-path>|ftp:|tftp:|http:|https:|scp:]

DESCRIPTION

This command is entered in the Configuration Mode. This command imports trusted peer certificates into OmniAccess 5510 USG.

You also have an option to directly enter or paste the certificate after the command. Enter upto 80 characters on a line. Enter a blank line to exit. Currently, SCP option is not supported.

PARAMETERS

EXAMPLEALU(config)# crypto peer-certificate cert_Bouvier import ftp:

Parameter Description

name Name of the peer certificate.

certificate-content Directly enter or paste the certificate after entering the command.

fpkey <file-path> FPkey file path. To copy the certificate into the front panel USB memory.

745Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

CRYPTO PEER-CERTIFICATE DELETE crypto peer-certificate <name> delete

DESCRIPTION

This command is entered in the Configuration Mode. This command deletes the specified peer certificate.

PARAMETERS

EXAMPLEALU(config)# crypto peer-certificate cert_Bouvier delete

CRYPTO RSA-KEY DELETE crypto rsa-key <name> delete

DESCRIPTION

This command is entered in the Configuration Mode. This command deletes the specified RSA key pair.

PARAMETERS

EXAMPLEALU(config)# crypto rsa-key examplekey delete

Parameter Description

name The peer certificate name.

Parameter Description

name The RSA key name.

746

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

crypto signed-cert

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CRYPTO SIGNED-CERTcrypto signed-cert <name> delete

DESCRIPTION

This command is entered in the Configuration Mode. This command deletes the specified signed certificate.

PARAMETERS

EXAMPLEALU(config)# crypto signed-cert cert_Simpson delete

DPD INTERVALdpd {interval <5-3600> [timeout <5-72000>]|none}

DESCRIPTION

This command configures a DPD at the Crypto Map Configuration Mode. This command allows all connections associated with a crypto map to use a DPD policy that is different from the global policy.

PARAMETERS

DEFAULT VALUE

The default value for DPD timeout is three times that of the DPD interval specified.

EXAMPLEALU(config-crypto-map-exampleMap)# dpd delay 15 timeout 60

ALU(config-crypto-map-exampleMap)# dpd NONE

Parameter Description

name Name of the specified signed certificate.

Parameter Description

5-3600 Time in seconds for which the keep-alive messages will be sent.

5-72000 Time in seconds after which the peer will be declared to be dead.

none This keyword disables DPD for all the connections associated with a crypto map. These connections will not detect Dead Peer.

747Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

IKE-IDENTITY ike-identity <name>

DESCRIPTION

This command is entered in the Crypto Map Configuration Mode. This command attaches an IKE identity to a crypto map.

PARAMETERS

EXAMPLEALU(config-crypto-map-exampleMap)# ike-identity exampleIdentity

IMPORT CA-CERT import ca-cert {<certificate-content>|fpkey <file-path> |ftp:|tftp:|http:|https:|scp:}

DESCRIPTION

This command is entered in the ca-identity mode. This command imports a CA certificate.

You also have an option to directly enter or paste the certificate content after the command. Enter upto 80 characters on a line. Enter a blank line to exit.

Note: Currently, SCP option is not supported.

PARAMETERS

EXAMPLEALU(config-ca-ALUCA)# import ca-cert ftp:

Parameter Description

name Name of the IKE identity configured.

Parameter Description

certificate-content Directly enter or paste the certificate content after the command.

fpkey <file-path> FPkey file path. To copy the certificate into the front panel USB memory.

748

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

import crl

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IMPORT CRL import crl {<CRL>|fpkey <file-path>|ftp:|tftp:|http:|https: |scp:}

DESCRIPTION

This command is entered in the ca-identity mode. This command is used to import a CRL from a remote location.

You also have an option to directly enter or paste the CRL after the command. Enter upto 80 characters on a line. Enter a blank line to exit.

Note: Currently, SCP option is not supported.

PARAMETERS

EXAMPLEALU(config-ca-ALUCA)# import crl ftp:

Parameter Description

certificate-content Directly enter or paste the CRL after the command.

fpkey <file-path> FPkey file path. To copy the certificate into the front panel USB memory.

749Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

IMPORT SIGNED-CERT import signed-cert <name> {<certificate-content>|fpkey <file-path>|ftp:|tftp:|http:|https:|scp:}

DESCRIPTION

This command is entered in the ca-identity mode. This command imports X.509 certificate signed by the CA from a remote location.

You also have an option to directly enter or paste the certificate after the command. Enter upto 80 characters on a line. Enter a blank line to exit.

Note: Currently, SCP option is not supported.

PARAMETERS

EXAMPLEALU(config-ca-ALUCA)# import signed-cert cert_Simpson ftp:

Parameter Description

name Name that is used to identify the certificate.

certificate-content Directly enter or paste the certificate conetent after the command.

fpkey <file-path> FPkey file path. To copy the certificate into the front panel USB memory.

750

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ipsec security-association lifetime

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IPSEC SECURITY-ASSOCIATION LIFETIMEipsec security-association lifetime {kilobytes <512-2147483647>|seconds <540-86400>}

DESCRIPTION

This command is entered in the IKE Policy Configuration Mode. This command is used to configure IPsec SA lifetime in kilobytes/seconds.

PARAMETERS

DEFAULT VALUE

IPsec SA lifetime has a default value of 28800 seconds. There is no default value for IPsec SA lifetime in Kilobytes.

EXAMPLEALU(config-crypto-ike-policy-P1)# ipsec security-association lifetime kilobytes 5400

ALU(config-crypto-ike-policy-P1)# ipsec security-association lifetime seconds 5400

LIFETIME SECONDSlifetime seconds <540-86400>

DESCRIPTION

This command is entered in the IKE Policy Mode. This configures IKE lifetime value.

PARAMETERS

DEFAULT VALUE

Default IKE lifetime is 86400 seconds.

EXAMPLEALU(config-crypto-ike-policy-P1)# lifetime seconds 1000

Parameter Description

512-2147483647 Specify the time in kilobytes.

540-86400 Specify the time in seconds.

Parameter Description

540-86400 Specify the IKE lifetime in seconds.

751Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

LIFETIMElifetime {kilobytes <512-2147483647>|seconds <540-28800>}

DESCRIPTION

This command is entered in the Crypto Map Configuration Mode. This command configures lifetime in seconds/kilobytes for a crypto map. This is IPsec security association lifetime.

PARAMETERS

DEFAULT VALUE

Lifetime has a default value of 28800 seconds. There is no default value for lifetime in Kilobytes.

EXAMPLEALU(config-crypto-map-exampleMap)# lifetime kilobytes 1005236

ALU(config-crypto-map-exampleMap)# lifetime seconds 1000

MATCHmatch <matchlist-name>

DESCRIPTION

This command is entered in the Crypto Map Configuration Mode. This command attaches a match-list to a crypto map.

PARAMETERS

EXAMPLEALU(config-crypto-map-exampleMap)# match matchlist1

Parameter Description

512-2147483647 Specify the time in kilobytes.

540-28800 Specify the time in seconds.

Parameter Description

name Name of the match-list.

752

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

my-ca

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

MY-CAmy-ca <name>

DESCRIPTION

This command is entered in the IKE-identity Mode. This command specifies the issuer (CA) of the user's certificate.

PARAMETERS

EXAMPLEALU(config-ike-identity-exampleidentity)# my-ca CN=ALU, OU=Certificate Authority, C=US

MY-CERTmy-cert <name>

DESCRIPTION

This command is entered in the IKE-identity mode. This command specifies the imported signed certificate to be used during IKE negotiation.

PARAMETERS

EXAMPLEALU(config-ike-identity-exampleidentity)# my-cert cert_Simpson

Parameter Description

name Name of the issuer of the user certificate.

Parameter Description

name Name of imported signed certificate used during IKE negotiation.

753Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

MY-IDmy-id {dn|fqdn|user-fqdn} <name>)|address <ip-address>

DESCRIPTION

This command is entered in the IKE-identity mode. This command configures self identity.

PARAMETERS

EXAMPLEALU(config-ike-identity-exampleidentity)# my-id dn /CN=Bart Simpson/O=ALU/C=US

NO CRYPTO CRL-CHECK STRICTno crypto crl-check strict

This command is entered in the Configuration Mode. This command makes the CRL policy lenient.

NO CRYPTO IKE DPDno crypto ike dpd

This command is entered in the Configuration Mode. This command disables DPD for IKE globally.

NO CRYPTO IKE KEYno crypto ike key <key-string> [vrf <name>] peer {<peer-address>|<FQDN>}

This command is entered in the Configuration Mode. This command removes the configured pre-shared key.

Parameter Description

name Name of imported signed certificate used during IKE negotiation.

ip-address IP address.

754

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

no crypto ike policy

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NO CRYPTO IKE POLICY no crypto ike policy <name>

This command is entered in the Configuration Mode. This command deletes the IKE policy.

NO CRYPTO MAPno crypto map <map-name>

This command is entered in the Interface Configuration Mode. This command is used to detach the crypto map attached to an interface.

NO DPDno dpd

This command is entered in the Crypto Map Configuration Mode. This command removes the local DPD and switches to the global policy.

NO IKE-IDENTITY no ike-identity

This command is entered in the Crypto Map Configuration Mode. This command detaches the specified IKE identity attached to a crypto map.

NO IPSEC SECURITY-ASSOCIATION LIFETIME no ipsec security-association lifetime {kilobytes|seconds}

This command is entered in the IKE Policy Configuration Mode. The ‘no’ command resets the IPsec SA lifetime in seconds value to its default. The ‘no’ command removes the IPsec security-association lifetime in kilobytes value.

NO LIFETIME no lifetime {kilobytes|seconds}

This command is entered in the Crypto Map Configuration Mode. The ‘no’ command resets the seconds lifetime to default. If set in kilobytes, the ‘no’ command removes the kilobytes lifetime value.

NO LIFETIME SECONDS no lifetime seconds

This command is entered in the IKE Policy Configuration Mode. The ‘no’ command resets the IKE lifetime to its default.

755Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

NO MATCH no match <match-list name>

This command is entered in the Crypto Map Configuration Mode. The ‘no’ command detaches the specified match-list attached to a crypto map.

NO PEER no peer {<ip-address>|<FQDN>}

This command is entered in the Crypto Map Configuration Mode. This command detaches the specified peer attached to a crypto map.

Note: You cannot delete a peer from the crypto map if the crypto map is attached to an interface.

NO PFS no pfs

If this command is entered in the IKE Policy Configuration Mode, this command resets the PFS Group to its default.

If this command is entered in the Crypto Map Configuration Mode, this command disables PFS completely.

NO PROPOSAL no proposal

This command is entered in the IKE Policy Configuration Mode. This command deletes the proposal configured for the IKE policy, and resets the IKE policy to its default.

NO TRANSFORM-SETno transform-set

This command is entered in the Crypto Map Configuration Mode. This command detaches the specified transform-set attached to a crypto map, and applies the 'default' transform set.

Note: A transform-set must be first detached from the crypto map to delete it globally.

756

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

no crypto ipsec transform-set

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NO CRYPTO IPSEC TRANSFORM-SETno crypto ipsec transform-set <name>

This command is entered in the Configuration Mode. This command deletes a transform-set.

Note: If a transform-set is being used by any crypto map, it is prohibited from deletion. Hence, the transform-set must be first disabled from the crypto map and then delete.

PEERpeer {<ip-address>|<FQDN>}

DESCRIPTION

This command is entered in the Crypto Map Configuration Mode. This command attaches a peer to a crypto map. You can attach a maximum of four peers to a crypto map.

PARAMETER

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-crypto-map-exampleMap)# peer 100.10.61.20

ALU(config-crypto-map-exampleMap)# peer mysmb.dyndns.org

RELEASE HISTORY

Release 3.0: Parameter “FQDN” was introduced.

parameter Description

ip-address IP address of the peer.

FQDN Fully qualified domain name (FQDN) of the peer at the remote end.

757Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

PEER-CApeer-ca <name>

DESCRIPTION

This command is entered in the ike-identity mode. This command specifies the issuer (CA) of the peer's certificate.

PARAMETER

EXAMPLEALU(config-ike-identity-exampleidentity)# peer-ca CN=ALU, OU=Certificate Authority, C=US

PEER-CERT peer-cert <name>

DESCRIPTION

This command is entered in the ike-identity mode. This command specifies the self signed peer’s certificate. This can be used if a trusted peer is not enrolled to any of the CAs.

PARAMETER

EXAMPLEALU(config-ike-identity-exampleidentity)# peer-cert cert_robert

parameter Description

name Name of the peer certificate imported previously.

parameter Description

name Name of the self signed peer certificate.

758

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

peer-id

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

PEER-IDpeer-id {dn|fqdn|user-fqdn} <name>|address <ip-address>

DESCRIPTION

This command is entered in the ike-identity mode. This command configures an ID for the peer.

PARAMETER

EXAMPLEALU(config-ike-identity-exampleidentity)# peer-id user-fqdn [email protected]

PFSpfs [group1|group2|group5]

DESCRIPTION

This command when entered in the IKE Policy Configuration Mode configures a PFS group.

This command when entered in the Crypto Map Configuration Mode attaches a PFS group to a crypto map.

PARAMETER

DEFAULT VALUE

If the PFS group is not explicitly configured, the default group2 is used.

EXAMPLEALU(config-crypto-ike-policy-P1)# pfs group1

parameter Description

name Name of the peer certificate imported previously.

ip-address IP address of the peer.

Parameter Description

group1|group2|group5 Name of the PFS group.

759Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

PROPOSALproposal {<algo>[<algo>][<algo>][<algo>]}

DESCRIPTION

This command is entered in the IKE Policy Configuration Mode. This command is used to configure a IKE proposal.

Options for algo are --md5-aes128|md5-aes192 |md5-aes256|md5-des| md5-3des|sha1-aes128 | sha1-aes192|sha1-aes256 | sha1-des|sha1-3des

PARAMETERS

DEFAULT VALUE

Default proposal is md5-des

EXAMPLEALU(config-crypto-ike-policy-P1)# proposal md5-aes-128

SHOW CRYPTO show crypto

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays all the configuration details related to IPsec including the default configurations.

PARAMETER

None.

EXAMPLEALU(config)# show crypto

crypto ike identity exampleIdentity peer-id user-fqdn [email protected] my-id fqdn @flintstones.com my-cert cert_flintstonescrypto ike key topSecret peer 100.1.200.4crypto ike key anotherTopSecret peer 126.2.34.68

Parameter Description

algo Authentication algorithm - encryption algorithm.

760

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show crypto

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

crypto ike dpd interval 15 timeout 60!crypto ike policy default! proposal md5-des! ipsec security-association lifetime seconds 28800! lifetime seconds 86400! pfs group2crypto ike policy examplePolicy proposal sha1-aes256 ipsec security-association lifetime seconds 28800 lifetime seconds 7200 pfs group5 authentication pre-shared! Policy in Use (by 1 cryptomap/s)!crypto ipsec transform-set default! esp-md5-des esp-sha1-descrypto ipsec transform-set exampleT-set esp-sha1-aes192 esp-md5-aes192 ! Transform-Set in Use (by 1 cryptomap/s) crypto map exampleMap ipsec-ike examplePolicy peer 100.1.200.4 match exampleMatchList transform-set exampleT-set pfs group5 lifetime seconds 3600 lifetime kilobytes 4096! Applied to : FastEthernet0interface FastEthernet0 crypto map exampleMap!crypto ipsec profile default! ike-policy default! transform-set default! pfs group2! lifetime seconds 28800! Not Applied to Any Interface

761Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

SHOW CRYPTO CA-CERT show crypto ca-cert [<name>[pem]]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. 1. Displays the details of the specified CA certificate in a readable format.2. Displays the details of the specified CA certificate in the base64 pem format.

PARAMETER

EXAMPLEALU(config)# show crypto ca-cert ALUCACertificate: Data: Version: 3 (0x2) Serial Number: 0 (0x0) Signature Algorithm: md5WithRSAEncryption Issuer: CN=CA_0x01, O=ALU Validity Not Before: Dec 28 12:30:49 2005 GMT Not After : Jan 27 12:30:49 2006 GMT Subject: CN=CA_0x01, O=ALU Subject Public Key Info: Public Key Algorithm: rsaEncryption RSA Public Key: (1024 bit) Modulus (1024 bit): 00:b2:bf:d4:a9:46:f0:d3:38:3c:46:e1:52:0e:e4: 31:1c:0c:81:70:90:1a:95:dd:79:44:c6:e3:1b:c6: a3:ec:d7:d5:18:9e:c2:d0:14:a3:8c:35:c0:34:e1: 9f:ff:2c:ae:fd:0e:b2:6f:5a:59:3e:c8:67:e8:f8: a7:a2:ba:84:d9:e5:0a:cc:af:e0:cf:67:36:a4:e6: f5:22:d5:88:72:3c:aa:85:be:92:06:87:78:6a:6e: 69:3b:ab:73:bd:c0:5c:eb:85:1d:18:76:c4:f8:aa: a9:c1:bb:14:1f:15:38:cc:8f:8c:e6:5c:3c:a1:b8: 10:4b:1a:98:c2:7d:b4:d0:cd Exponent: 65537 (0x10001) X509v3 extensions: X509v3 Subject Key Identifier: 05:98:D2:25:D3:18:12:A1:C7:4B:7A:98:D2:D8:25:73:2B:6B:AE:B1 X509v3 Authority Key Identifier: keyid:05:98:D2:25:D3:18:12:A1:C7:4B:7A:98:D2:D8:25:73:2B:6B:AE:B1 DirName:/CN=CA_0x01/O=ALU serial:00

X509v3 Basic Constraints: CA:TRUE Signature Algorithm: md5WithRSAEncryption 0c:0b:92:9c:1d:60:ac:62:e0:7f:f3:1d:9c:7b:e8:de:67:09: 43:a1:2e:47:d1:78:c1:17:f6:0c:aa:ef:51:55:e2:9b:5f:8a: 0e:9f:ba:51:55:57:48:2b:4c:8f:f7:6b:7c:65:4b:cf:99:b2:

Parameter Description

name Name of the CA certificate.

762

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show crypto ca identity

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

dc:83:2d:da:99:63:0c:ad:6b:33:66:19:91:ef:35:cb:dd:d8: 74:48:34:a6:40:c2:f0:8d:b6:8a:32:63:8c:f0:82:14:14:5a: a3:56:de:b1:50:42:6f:b3:0f:ea:f1:26:be:2e:ce:9e:61:f5: 24:c3:88:ab:13:42:70:82:80:f9:f1:d2:8f:02:d5:5b:62:ff: 3e:cc

ALU(config)# show crypto ca-cert ALUCA pem-----BEGIN CERTIFICATE-----MIICMjCCAZugAwIBAgIBADANBgkqhkiG9w0BAQQFADAhMRAwDgYDVQQDFAdDQV8weDAxMQ0wCwYDVQQKEwROZXRkMB4XDTA1MTIyODEyMzA0OVoXDTA2MDEyNzEyMzA0OVowITEQMA4GA1UEAxQHQ0FfMHgwMTENMAsGA1UEChMETmV0ZDCBnzANBgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEAsr/UqUbw0zg8RuFSDuQxHAyBcJAald15RMbjG8aj7NfVGJ7C0BSjjDXANOGf/yyu/Q6yb1pZPshn6PinorqE2eUKzK/gz2c2pOb1ItWIcjyqhb6SBod4am5pO6tzvcBc64UdGHbE+KqpwbsUHxU4zI+M5lw8obgQSxqYwn200M0CAwEAAaN6MHgwHQYDVR0OBBYEFAWY0iXTGBKhx0t6mNLYJXMra66xMEkGA1UdIwRCMECAFAWY0iXTGBKhx0t6mNLYJXMra66xoSWkIzAhMRAwDgYDVQQDFAdDQV8weDAxMQ0wCwYDVQQKEwROZXRkggEAMAwGA1UdEwQFMAMBAf8wDQYJKoZIhvcNAQEEBQADgYEADAuSnB1grGLgf/MdnHvo3mcJQ6EuR9F4wRf2DKrvUVXim1+KDp+6UVVXSCtMj/drfGVLz5my3IMt2pljDK1rM2YZke81y93YdEg0pkDC8I22ijJjjPCCFBRao1besVBCb7MP6vEmvi7OnmH1JMOIqxNCcIKA+fHSjwLVW2L/Psw=-----END CERTIFICATE-----

SHOW CRYPTO CA IDENTITYshow crypto ca identity <name>

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode.1. This command displays all the configured CA identities. 2. If the CA identity name is specified, it displays the details of only that CA identity.

PARAMETER

EXAMPLEALU(config)# show crypto ca identitycrypto ca identity SomeOtherCA subject-name /O=ALU/C=IN/CN=CM Burnscrypto ca identity ALUCA subject-name /CN=Bart Simpson/O=ALU/C=US

ALU(config)# show crypto ca identity ALUCAcrypto ca identity ALUCA subject-name /CN=Bart Simpson/O=ALU/C=US

Parameter Description

name Name of the CA identity.

763Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

SHOW CRYPTO CERTIFICATE-REQUESTshow crypto certificate-request [<name> [pem]]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. 1. Displays the names of all the CSR.2. Displays the details of the specified CSR in a readable format.3. Displays the details of the specified CSR in the base64 pem format.

PARAMETER

EXAMPLEALU(config)# show crypto certificate-requestreq_Simpsonreq_Burns

ALU(config)# show crypto certificate-request req_SimpsonCertificate Request: Data: Version: 0 (0x0) Subject: CN=Bart Simpson, O=ALU, C=US Subject Public Key Info: Public Key Algorithm: rsaEncryption RSA Public Key: (512 bit) Modulus (512 bit): 00:ba:f3:af:cf:09:49:f4:ef:13:df:a7:e3:ee:28: 32:b5:ef:06:e2:f8:c9:31:6d:44:44:81:d2:3f:49: 82:c9:6b:5a:d1:73:d0:7b:af:3f:5e:82:34:15:54: 49:a7:d3:5e:69:29:c4:72:57:25:6a:ee:02:f8:2c: dd:59:2f:03:ad Exponent: 65537 (0x10001) Attributes: a0:00 Signature Algorithm: md5WithRSAEncryption 57:7b:73:45:07:37:a3:c6:a3:fc:46:5d:a6:c7:00:b1:2c:c8: 15:00:8f:ef:47:c5:0d:fa:81:a3:82:90:15:76:ad:10:42:ef: 68:a5:58:5a:e8:7b:17:85:d3:2b:f5:c5:ca:ca:db:c1:f0:d5: a6:87:b6:0b:13:a2:35:2f:91:cb

ALU(config)# show crypto certificate-request req_Simpson pem-----BEGIN CERTIFICATE REQUEST-----MIHtMIGYAgEAMDMxFTATBgNVBAMTDEJhcnQgU2ltcHNvbjENMAsGA1UEChMETmV0RDELMAkGA1UEBhMCVVMwXDANBgkqhkiG9w0BAQEFAANLADBIAkEAuvOvzwlJ9O8T36fj7igyte8G4vjJMW1ERIHSP0mCyWta0XPQe68/XoI0FVRJp9NeaSnEclclau4C+CzdWS8DrQIDAQABoAAwDQYJKoZIhvcNAQEEBQADQQBXe3NFBzejxqP8Rl2mxwCxLMgVAI/vR8UN+oGjgpAVdq0QQu9opVha6HsXhdMr9cXKytvB8NWmh7YLE6I1L5HL-----END CERTIFICATE REQUEST-----

Parameter Description

name Name of the CA identity.

764

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show crypto crl ca

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW CRYPTO CRL CA show crypto crl ca [<name> [pem]]

DESCRIPTION This command is entered in the Super User Mode or Configuration Mode. 1. Displays the details of the specified CRL in a readable format.2. Displays the details of the specified CRL in the base64 pem format.

PARAMETER

EXAMPLE

Ex 1:ALU(config)# show crypto crl ca ALUCA

Certificate Revocation List (CRL): Version 1 (0x0) Signature Algorithm: md5WithRSAEncryption Issuer: /CN=CA_0x01/O=ALU Last Update: Jan 9 11:46:37 2006 GMT Next Update: Feb 8 11:46:37 2006 GMTRevoked Certificates: Serial Number: 01 Revocation Date: Jan 9 11:46:12 2006 GMT Serial Number: 02 Revocation Date: Jan 9 11:46:16 2006 GMT Signature Algorithm: md5WithRSAEncryption 45:6b:da:5f:10:09:77:7c:16:1e:a4:c2:aa:b6:3c:04:d1:ca: 4c:bc:9c:74:07:a7:a4:8a:09:cc:ad:e0:8b:9c:34:9d:05:c0: 63:3b:d7:01:9c:e0:29:44:38:e4:f8:e9:81:69:13:92:f4:14: f2:a6:7a:75:35:96:f5:12:3f:77:32:ef:c2:a7:28:4b:81:69: 10:a5:05:0d:dd:2f:73:20:70:58:b5:d9:2f:d9:13:c8:c1:20: c6:f7:34:c9:c0:23:06:b4:32:6c:65:48:06:78:18:48:fe:78: ab:ba:5c:a3:f5:0b:c8:64:95:5b:a6:27:c1:43:ca:d9:f5:d0: bd:5c

EX:2ALU(config)# show crypto crl ca ALUCA pem

-----BEGIN X509 CRL-----MIIBDzB6MA0GCSqGSIb3DQEBBAUAMCExEDAOBgNVBAMUB0NBXzB4MDExDTALBgNVBAoTBE5ldGQXDTA2MDEwOTExNDYzN1oXDTA2MDIwODExNDYzN1owKDASAgEBFw0wNjAxMDkxMTQ2MTJaMBICAQIXDTA2MDEwOTExNDYxNlowDQYJKoZIhvcNAQEEBQADgYEARWvaXxAJd3wWHqTCqrY8BNHKTLycdAenpIoJzK3gi5w0nQXAYzvXAZzgKUQ45PjpgWkTkvQU8qZ6dTWW9RI/dzLvwqcoS4FpEKUFDd0vcyBwWLXZL9kTyMEgxvc0ycAjBrQybGVIBngYSP54q7pco/ULyGSVW6YnwUPK2fXQvVw=-----END X509 CRL-----

Parameter Description

name Name of the CRL.

765Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

SHOW CRYPTO IKE IDENTITY show crypto ike identity <name>

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays all the IKE identities configured. If the IKE identity name is specified, it displays the details of only that IKE identity.

PARAMETER

EXAMPLEALU(config)# show crypto ike identity

crypto ike identity someOtherIdentity peer-id fqdn @www.simpsons.com my-id DN /CN=CM Burns/O=ALU/C=IN my-cert cert_Burnscrypto ike identity exampleIdentity peer-id user-fqdn [email protected] peer-ca CN=ALU, OU=Certificate Authority, C=US my-id DN /CN=Bart Simpson/O=ALU/C=US my-cert cert_Simpson

ALU(config)# show crypto ike identity exampleIdentity

crypto ike identity exampleIdentity peer-id user-fqdn [email protected] peer-ca CN=ALU, OU=Certificate Authority, C=US my-id DN /CN=Bart Simpson/O=ALU/C=US

Parameter Description

name Name of the IKE identity.

766

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show crypto ike key

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW CRYPTO IKE KEY show crypto ike key [<peer-address>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the details of the all the IKE keys configured or details of a specific IKE key.

PARAMETER

EXAMPLEALU(config)# show crypto ike key

crypto ike key top_secret1612 peer 10.10.1.2

ALU(config)# show crypto ike key 3.3.3.3

crypto ike key linux123 peer 3.3.3.3

Parameter Description

peer-address The peer address.

767Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

SHOW CRYPTO IKE POLICYshow crypto ike policy [<name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays all the IKE policies configured, if the policy name is not specified. If the IKE policy name is specified, it displays the details of only that IKE policy.

PARAMETER

EXAMPLEALU(config)# show crypto ike policy

!crypto ike policy default! proposal md5-des! ipsec security-association lifetime seconds 28800! lifetime seconds 86400! pfs group2crypto ike policy ike1 proposal sha1-aes128 ipsec security-association lifetime seconds 28800 lifetime seconds 86400 pfs group2 authentication pre-shared! Policy in Use (by 1 cryptomaps/ipsec-profiles)crypto ike policy P1 proposal sha1-aes128 ipsec security-association lifetime seconds 28800 lifetime seconds 86400 pfs group2 authentication pre-shared! Policy in Use (by 1 cryptomaps/ipsec-profiles)

The following example displays the details for a specified IKE policy:

ALU(config)# show crypto ike policy ike1

crypto ike policy ike1 proposal sha1-aes128 ipsec security-association lifetime seconds 28800 lifetime seconds 86400 pfs group2 authentication pre-shared! Policy in Use (by 1 cryptomaps/ipsec-profiles)

Parameter Description

name Name of the IKE policy used.

768

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show crypto ipsec sa

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW CRYPTO IPSEC SA show crypto ipsec sa [interface <name>|map <name>|peer <ip-address>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays IPsec SA details, the encryption and authentication algorithms used in negotiating SAs.

PARAMETER

None.

EXAMPLEALU# show crypto ipsec sa

Interface FastEthernet0 Crypto Map: ALU Match m1 Peer 60.60.60.2 ********INBOUND******** ESP Algo:crypt:DES-CBC len:64 auth:SHA1-HMAC len:160 TUNNEL MODE Replay Detection Enabled: Yes ESP spi:0xc3fb59c time-left:28793secs/0kb esp-sa-id:12 Decaps:7 Decrypt:7 Auth:7 Errors:0 ********OUTBOUND******** ESP Algo:crypt:DES-CBC len:64 auth:SHA1-HMAC len:160 TUNNEL MODE Replay Detection Enabled: Yes ESP spi:0x541a7498 time-left:28793secs/0kb esp-sa-id:16 Encaps:7 Encrypt:7 Auth:7 Errors:0

769Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

SHOW CRYPTO IPSEC TRANSFORM-SET show crypto ipsec transform-set [<name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode.

This command displays all the Transform-sets configured if the transform-set name is not specified. If the Transform-set name is specified, it displays the details of the specified transform-set.

PARAMETER

EXAMPLEALU(config)# show crypto ipsec transform-set

!crypto ipsec transform-set default! esp-md5-des esp-sha1-descrypto ipsec transform-set ts1 esp-md5-des

ALU(config)# show crypto ipsec transform-set ts1

crypto ipsec transform-set ts1 esp-md5-des

Parameter Description

name Name of the transform-set.

770

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show crypto map

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW CRYPTO MAP show crypto [map <name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode.

This command displays all the crypto maps configured, if the crypto map name is not specified. If the crypto map name is specified, it displays the details of the specfied crypto map.

PARAMETER

EXAMPLE

In case no map-name is specified, all the crypto maps will be displayed.

ALU(config)# show crypto map

crypto map examplemap ipsec-ike P1 peer 10.10.10.1 match m1 transform-set default pfs group2! Applied to : FastEthernet0interface FastEthernet0 crypto map examplemaptopcrypto map test ipsec-ike ike1! No Peer Defined! No Match-List defined transform-set default pfs group2! Not Applied to Any Interface

The following example displays the details for a specified crypto map:ALU(config)# show crypto map examplemap

crypto map examplemap ipsec-ike P1 peer 10.10.10.1 match m1 transform-set default pfs group2! Applied to : FastEthernet0interface FastEthernet0 crypto map examplemap

Parameter Description

name Name of the crypto map.

771Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

SHOW CRYPTO PEER-CERTIFICATE show crypto peer-certificate [<name> [pem]]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays all the peer certificates generated or imported, if the name is not specified.

If the peer-certificate name is specified, it displays the details of only that peer certificate.

If the "pem" option is used, then the certificate/CRL will be displayed in base64 PEM format

PARAMETER

EXAMPLEALU(config)# show crypto peer-certificate

cert_fredcert_barneycert_wilma

ALU(config)# show crypto peer-certificate cert_fred

Certificate: Data: Version: 3 (0x2) Serial Number: 0 (0x0) Signature Algorithm: md5WithRSAEncryption Issuer: C=US, ST=Bedrock, CN=Fred Flintstone/[email protected] Validity Not Before: Jun 22 06:56:13 2006 GMT Not After : Jul 22 06:56:13 2006 GMT Subject: C=US, ST=Bedrock, CN=Fred Flintstone/[email protected] Subject Public Key Info: Public Key Algorithm: rsaEncryption RSA Public Key: (1024 bit) Modulus (1024 bit): 00:cc:77:33:35:10:2c:90:6a:7d:ba:08:5b:97:68: eb:ea:91:bb:e2:b7:ac:9d:42:95:36:3a:db:ab:d3: 38:04:38:9b:34:18:31:22:69:78:de:11:37:7f:1e: 7f:10:9b:ba:96:60:e3:dd:bd:74:93:cf:dc:ad:c5: a7:ca:69:7f:d1:77:33:38:6a:66:89:07:66:d2:08: d4:b8:98:3f:e0:99:11:f8:3f:78:9b:27:51:8d:ee: 5e:e7:2a:5a:3a:d2:dc:dc:f7:45:b9:1e:8e:c2:ed: 2a:5e:a5:29:03:3d:ab:6e:2d:fd:6c:eb:c5:72:a8: 54:44:a6:03:70:4e:d0:38:33

Parameter Description

name Name of the peer certificate.

772

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show crypto peer-certificate

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

Exponent: 65537 (0x10001) X509v3 extensions: X509v3 Subject Key Identifier: A8:80:7E:54:63:61:76:66:DE:E0:98:6C:10:31:6D:EB:1E:9D:4C:46 X509v3 Authority Key Identifier: keyid:A8:80:7E:54:63:61:76:66:DE:E0:98:6C:10:31:6D:EB:1E:9D:4C:46 DirName:/C=US/ST=Bedrock/CN=Fred Flintstone/[email protected] serial:00

X509v3 Basic Constraints: CA:TRUE Signature Algorithm: md5WithRSAEncryption 2d:b4:af:ef:cb:25:79:fe:11:9a:85:2e:a5:ef:27:9c:87:21: 00:c8:19:89:19:05:ae:6a:2f:d0:02:df:ba:70:e9:ac:81:29: f2:ff:dc:da:35:e4:d0:43:ec:ec:7c:73:24:c9:52:d8:c9:0a: 90:40:6f:64:df:0d:65:16:bf:96:22:fb:06:fb:6b:0b:17:24: c2:2e:33:0b:2d:f6:76:ec:8e:e7:9e:cc:4e:c6:fa:25:a2:7f: 4a:79:c9:ba:55:67:a9:74:4e:5e:30:ff:37:13:94:cd:db:47: 26:30:c6:19:38:31:62:12:70:5f:00:e7:80:01:2c:8a:da:d5: e0:e5

ALU(config)# show crypto peer-certificate cert_fred pem

-----BEGIN CERTIFICATE----- MIIC7DCCAlWgAwIBAgIBADANBgkqhkiG9w0BAQQFADBeMQswCQYDVQQGEwJVUzEQMA4GA1UECBMHQmVkcm9jazEYMBYGA1UEAxMPRnJlZCBGbGludHN0b25lMSMwIQYJKoZIhvcNAQkBFhRmcmVkQGZsaW50c3RvbmVzLmNvbTAeFw0wNjA2MjIwNjU2MTNaFw0wNjA3MjIwNjU2MTNaMF4xCzAJBgNVBAYTAlVTMRAwDgYDVQQIEwdCZWRyb2NrMRgwFgYDVQQDEw9GcmVkIEZsaW50c3RvbmUxIzAhBgkqhkiG9w0BCQEWFGZyZWRAZmxpbnRzdG9uZXMuY29tMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDMdzM1ECyQan26CFuXaOvqkbvit6ydQpU2Otur0zgEOJs0GDEiaXjeETd/Hn8Qm7qWYOPdvXSTz9ytxafKaX/RdzM4amaJB2bSCNS4mD/gmRH4P3ibJ1GN7l7nKlo60tzc90W5Ho7C7SpepSkDPatuLf1s68VyqFREpgNwTtA4MwIDAQABo4G5MIG2MB0GA1UdDgQWBBSogH5UY2F2Zt7gmGwQMW3rHp1MRjCBhgYDVR0jBH8wfYAUqIB+VGNhdmbe4JhsEDFt6x6dTEahYqRgMF4xCzAJBgNVBAYTAlVTMRAwDgYDVQQIEwdCZWRyb2NrMRgwFgYDVQQDEw9GcmVkIEZsaW50c3RvbmUxIzAhBgkqhkiG9w0BCQEWFGZyZWRAZmxpbnRzdG9uZXMuY29tggEAMAwGA1UdEwQFMAMBAf8wDQYJKoZIhvcNAQEEBQADgYEALbSv78slef4RmoUupe8nnIchAMgZiRkFrmov0ALfunDprIEp8v/c2jXk0EPs7HxzJMlS2MkKkEBvZN8NZRa/liL7BvtrCxckwi4zCy32duyO557MTsb6JaJ/SnnJulVnqXROXjD/NxOUzdtHJjDGGTgxYhJwXwDngAEsitrV4OU=-----END CERTIFICATE-----

773Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

SHOW CRYPTO RSA-KEY show crypto rsa-key [<name> [<public-key>]]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. 1. This command displays all the RSA-keys generated or imported if the RSA-key

name is not specified. 2. If the RSA-key name is specified, it displays the details of only that RSA-key.3. If public-key option is specified, then only the public-key is displayed.

PARAMETER

EXAMPLEALU(config)# show crypto rsa-key

KEY NAME LENGTH-------- ------exampleKey 512key_Bruns 1024

ALU(config)# show crypto rsa-key exampleKey

# LENGTH = 512-----BEGIN RSA PRIVATE KEY-----MIIBOwIBAAJBALrzr88JSfTvE9+n4+4oMrXvBuL4yTFtRESB0j9JgslrWtFz0HuvP16CNBVUSafTXmkpxHJXJWruAvgs3VkvA60CAwEAAQJATCC1Q6p1qj68qgOU5kMKO1mlRUGns+/Zr8fplInbrybL7aUyw0ZbOxwR47nhv2cPJmBEVYBgD3MJBpmoCoQ3JQIhAPQF4cc793YnqQjDmMZlrU5EgW0+iTv7tZhBfu9Be6hzAiEAxCC2wzozczYbVu34ghDwp8Bcr5dyRH1qqKXAWfhjO18CIHy5WOo1a0lYAhy5pKebJpZ/i0ukEA65m9qjd1aguKyjAiEAsZOVJsppjyUsN9cbLFi+LITE5s9OzKhpi+0Xbd6xqi0CIQCRp2uSbE2LoC4r3XovZoVF1mLzZLrC3WZcMKRk0qeO0Q==-----END RSA PRIVATE KEY-----

ALU(config)# show crypto rsa-key exampleKey public-key

-----BEGIN PUBLIC KEY-----MFwwDQYJKoZIhvcNAQEBBQADSwAwSAJBALrzr88JSfTvE9+n4+4oMrXvBuL4yTFtRESB0j9JgslrWtFz0HuvP16CNBVUSafTXmkpxHJXJWruAvgs3VkvA60CAwEAAQ==-----END PUBLIC KEY-----

Parameter Description

name Name of the RSA-key.

774

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show crypto signed-cert

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW CRYPTO SIGNED-CERTshow crypto signed-cert [<name> [pem]]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays all the signed certificates generated or imported if the name is not specified.

If the signed-cert name is specified, it displays the details of only that signed certificate.

If the "pem" option is used, then the certificate/CRL will be displayed in base64 PEM format.

PARAMETER

EXAMPLEALU(config)# show crypto signed-cert

cert_Simpsoncert_Burn

ALU(config)# show crypto signed-cert cert_Simpson

Certificate: Data: Version: 3 (0x2) Serial Number: 8 (0x8) Signature Algorithm: md5WithRSAEncryption Issuer: CN=CA_0x01, O=ALU Validity Not Before: Jan 27 09:22:03 2006 GMT Not After : Jan 27 09:22:03 2007 GMT Subject: C=US, O=ALU, CN=Bart Simpson Subject Public Key Info: Public Key Algorithm: rsaEncryption RSA Public Key: (512 bit) Modulus (512 bit): 00:ba:f3:af:cf:09:49:f4:ef:13:df:a7:e3:ee:28: 32:b5:ef:06:e2:f8:c9:31:6d:44:44:81:d2:3f:49: 82:c9:6b:5a:d1:73:d0:7b:af:3f:5e:82:34:15:54: 49:a7:d3:5e:69:29:c4:72:57:25:6a:ee:02:f8:2c: dd:59:2f:03:ad Exponent: 65537 (0x10001) X509v3 extensions: X509v3 Basic Constraints: CA:FALSE Netscape Comment: OpenSSL Generated Certificate X509v3 Subject Key Identifier: 88:75:2D:47:AC:E8:AB:C3:5F:9F:E1:93:6B:7E:07:9C:A3:B0:24:CB

Parameter Description

name Name of the signed certificate

775Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

X509v3 Authority Key Identifier: keyid:05:98:D2:25:D3:18:12:A1:C7:4B:7A:98:D2:D8:25:73:2B:6B:AE:B1 DirName:/CN=CA_0x01/O=ALU serial:00

Signature Algorithm: md5WithRSAEncryption 0c:30:3a:96:bb:2a:be:6c:53:47:b9:5d:b4:40:1d:0e:4a:85: f3:99:57:82:07:58:a1:bf:f6:36:3a:03:9b:81:7a:3d:6c:fa: b7:24:70:78:c4:15:75:4a:58:69:ad:aa:3d:82:f1:ae:1a:76: 82:79:b9:43:05:26:b8:34:cc:59:ee:b6:0b:82:4b:a2:70:2a: 2a:72:4c:1a:c7:a8:74:30:fb:24:52:21:b9:2f:ef:b9:56:ae: f1:45:75:0b:46:2f:e4:94:ec:8c:b6:99:47:a8:68:c3:a8:0c: e3:56:f0:bc:54:53:02:ed:c0:17:1e:72:be:7b:fd:11:76:91: 05:db

ALU(config)# show crypto signed-cert cert_Simpson pem

-----BEGIN CERTIFICATE-----MIICLTCCAZagAwIBAgIBCDANBgkqhkiG9w0BAQQFADAhMRAwDgYDVQQDFAdDQV8weDAxMQ0wCwYDVQQKEwROZXRkMB4XDTA2MDEyNzA5MjIwM1oXDTA3MDEyNzA5MjIwM1owMzELMAkGA1UEBhMCVVMxDTALBgNVBAoTBE5ldEQxFTATBgNVBAMTDEJhcnQgU2ltcHNvbjBcMA0GCSqGSIb3DQEBAQUAA0sAMEgCQQC686/PCUn07xPfp+PuKDK17wbi+MkxbUREgdI/SYLJa1rRc9B7rz9egjQVVEmn015pKcRyVyVq7gL4LN1ZLwOtAgMBAAGjgaYwgaMwCQYDVR0TBAIwADAsBglghkgBhvhCAQ0EHxYdT3BlblNTTCBHZW5lcmF0ZWQgQ2VydGlmaWNhdGUwHQYDVR0OBBYEFIh1LUes6KvDX5/hk2t+B5yjsCTLMEkGA1UdIwRCMECAFAWY0iXTGBKhx0t6mNLYJXMra66xoSWkIzAhMRAwDgYDVQQDFAdDQV8weDAxMQ0wCwYDVQQKEwROZXRkggEAMA0GCSqGSIb3DQEBBAUAA4GBAAwwOpa7Kr5sU0e5XbRAHQ5KhfOZV4IHWKG/9jY6A5uBej1s+rckcHjEFXVKWGmtqj2C8a4adoJ5uUMFJrg0zFnutguCS6JwKipyTBrHqHQw+yRSIbkv77lWrvFFdQtGL+SU7Iy2mUeoaMOoDONW8LxUUwLtwBcecr57/RF2kQXb-----END CERTIFICATE-----

776

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show running-config

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW RUNNING-CONFIGshow running-config

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the running configuration. The output of this command does not show the default configurations.

PARAMETER

None.

EXAMPLE

The following example displays the output of the running configuration:ALU# show running-config

Current Configuration:!! NVRAM config last updated at 05:26:39 GMT Tue Jan 18 2005 from line 0 ! Statlog Configuration !logging onlogging console debugginglogging os messages informationallogging buffered priority 7logging buffered size 131072service timestamps log!interface FastEthernet0 ip address 2.2.2.2/8 mac-addr 0000.4567.6789 no shutdown!ip route 3.0.0.0/8 2.2.2.1!match-list m11 ip prefix 1.0.0.0/8 prefix 3.0.0.0/8!! ipsec Policy configuration!

crypto ike identity exampleidentity

crypto ike key secret112 peer 10.10.10.1crypto ike key secret111 peer 10.10.1.2crypto ike policy ike1 proposal sha1-aes128 ipsec security-association lifetime seconds 28800 lifetime seconds 86400 pfs group2! Policy in Use (by 1 cryptomaps/ipsec-profiles)crypto ike policy test proposal sha1-aes128 ipsec security-association lifetime seconds 28800 lifetime seconds 86400 pfs group2crypto ike policy P1

777Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

proposal sha1-aes128 ipsec security-association lifetime seconds 28800 lifetime seconds 86400 pfs group2! Policy in Use (by 1 cryptomaps/ipsec-profiles)crypto ipsec transform-set ts1 esp-md5-descrypto map examplemap ipsec-ike P1 peer 10.10.10.1 match m1 transform-set default pfs group2! Applied to : FastEthernet0interface FastEthernet0 crypto map examplemaptopcrypto map test ipsec-ike ike1! No Peer Defined! No Match-List defined transform-set default pfs group2! Not Applied to Any Interface

crypto ipsec profile pf1! Not Applied to Any Interface

!!QoS Configuration--More--

778

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

subject-name

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SUBJECT-NAME subject-name <subject-name>

DESCRIPTION

This command is entered in the ca-identity mode. This command specifies the subject distinguished name that would appear in the certificate request for this CSR, if generated on OmniAccess 5510 USG.

PARAMETER

EXAMPLEALU(config-ca-ALUCA)#subject-name /CN=Bart Simpson/O=ALU/C=US

TRANSFORM SET transform-set <name>

DESCRIPTION

This command is entered in the Crypto Map Configuration Mode. This command attaches a transform-set to a crypto map.

PARAMETER

DEFAULT VALUE

If no transform-set is attached to a crypto map, by default, ‘Default’ transform-set is used.

EXAMPLEALU(config-crypto-map-exampleMap)# transform-set netset

Parameter Description

subject-name The name for a Certificate Signing Request.

Parameter Description

name Name of the transform set.

779Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

IPSEC TUNNEL INTERFACE CLI COMMANDSThis section deals with the commands relevant to IPsec tunnel interface configuration.

CRYPTO IPSEC PROFILEcrypto ipsec profile <name> [force]

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure an IPsec Profile.

PARAMETERS

EXAMPLEALU(config)# crypto ipsec profile PF1ALU(ipsec-profile-PF1)#

IKE-IDENTITYike-identity <name>

DESCRIPTION

This command is entered in the IPsec Profile Configuration Mode. This command attaches an IKE identity to an IPsec profile.

PARAMETERS

DEFAULT VALUE

IKE identity should only be attached to an IPsec profile if the Authentication type is ‘rsa-sig’

EXAMPLEALU(ipsec-profile-PF1)# ike-identity ID01

Parameter Description

name Name of the IPsec Profile.

force This option is used to modify a ipsec profile when it is applied to an interface.

Parameter Description

name Name of the IKE identity.

780

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ike-policy

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IKE-POLICYike-policy <name>

DESCRIPTION

This command is entered in the IPsec Profile Configuration Mode. This command is used to attach an already configured IKE policy to an IPsec profile.

PARAMETERS

DEFAULT VALUE

If no IKE policy is attached to an IPsec profile, ‘default’ IKE policy is used.

EXAMPLEALU(ipsec-profile-PF1)# ike-policy IKE1

INTERFACE TUNNEL interface Tunnel <0-4095>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure a tunnel interface.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# interface Tunnel 1ALU(config-if Tunnel1)#

Parameter Description

name Name of the IKE policy.

Parameter Description

0-4095 The number specified for the tunnel.

781Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

IP ADDRESS ip address {<ip-address subnet-mask>|<ip-address/prefix-length>}

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to assign an IP address and subnet mask to the tunnel interface.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-if Tunnel1)# ip address 20.20.20.20/24

IPSEC-PROFILE ipsec-profile <profile-name>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to attach the configured IPsec profile to the tunnel interface.

PARAMETERS

DEFAULT VALUE

Default IKE policy: ‘default’ ike policy, Default transform set: ‘default’ transform set. Default PFS group: pfs group2. Default lifetime in seconds: 28800

EXAMPLEALU(config-if Tunnel1)# ipsec-profile PF1

Parameter Description

{<ip-address subnet-mask>|<ip-address/prefix-length>}

IP address with subnet mask or prefix length.

Parameter Description

profile-name Name of the IPsec profile.

782

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

lifetime

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

LIFETIMElifetime {kilobytes <512-2147483647>|seconds <540-86400>}

DESCRIPTION

This command is entered in the IPsec Profile Configuration Mode. This command configures lifetime for an IPsec profile. Use Kilobytes keyword to configure lifetime in kilobytes, and use Seconds keyword to configure lifetime in seconds for a profile.

PARAMETERS

DEFAULT VALUE

Lifetime has a default value of 28800 seconds. There is no default value for lifetime in Kilobytes.

EXAMPLEALU(ipsec-profile-PF1)# lifetime seconds 1000

ALU(ipsec-profile-PF1)# lifetime kilobytes 1005236

Parameter Description

512-2147483647 Specify the time in kilobytes.

540-86400 Specify the time in seconds.

783Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

MODEmode {gre|ipsec|multipoint-gre}

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to set the mode on tunnel interface.

PARAMETERS

DEFAULT VALUE

By default, tunnel is configured in GRE mode.

EXAMPLEALU(config-if Tunnel1)# mode ipsec

NO IKE-IDENTITYno ike-identity

This command is entered in the IPsec Profile Configuration Mode. The ‘no’ command detaches the specified IKE identity attached to a profile.

NO IKE-POLICYno ike-policy

This command is entered in the IPsec Profile Configuration Mode. The ‘no’ command detaches the specified IKE policy attached to the profile. An IKE policy must be first detached from the profile to delete it globally.

Parameter Description

gre Use this keyword to configure the tunnel in GRE mode.

ipsec Use this keyword to configure the tunnel in IPsec mode.

multipoint-gre Use this keyword to configure the tunnel in Multipoint GRE mode.

784

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

no ipsec-profile

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NO IPSEC-PROFILEno ipsec-profile <profile-name>

This command is entered in the Interface Configuration Mode. This command is used to detach the IPsec profile attached to the interface.

You cannot delete an IPsec profile that is applied to the interface. To delete, first detach the IPsec profile from the tunnel interface.

NO LIFETIME no lifetime {kilobytes|seconds}

This command is entered in the IPsec Profile Configuration Mode. The ‘no’ command resets the seconds lifetime to default. If set in kilobytes, the ‘no’ command removes the kilobytes lifetime value.

NO PFSno pfs

This command is entered in the IPsec Profile Configuration Mode. The ‘no’ command disables PFS completely, when entered in the IPsec Profile Configuration Mode.

NO SHUTDOWNno shutdown

This command is entered in the Interface Configuration Mode. This command is used to administratively bring up the tunnel interface.

NO TRANSFORM-SETno transform-set

This command is entered in the IPsec Profile Configuration Mode.

The ‘no’ command detaches the specified transform-set attached to the profile, and applies the 'default' transform set. A transform-set must be first detached from the profile to delete it globally.

NO TUNNEL DESTINATIONno tunnel destination <ip-address>

This command is entered in the Interface Configuration Mode. The “no” command removes the configured destination IP address configured for the tunnel.

NO TUNNEL SOURCEno tunnel source {<ip-address>|<interface-name>}

This command is entered in the Interface Configuration Mode. The “no” command removes the configured source IP address of the tunnel.

785Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

PFSpfs {group1|group2|group5}

DESCRIPTION

This command is entered in the IPsec Profile Configuration Mode. This command is used to attach a PFS group to an IPsec profile.

PARAMETERS

DEFAULT VALUE

If no PFS group is attached to an IPsec profile, group2 PFS is used.

EXAMPLEALU(ipsec-profile-PF1)# pfs group2

Parameter Description

group1|group2|group5 Name of the PFS group.

786

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show crypto ipsec profile

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW CRYPTO IPSEC PROFILEshow crypto ipsec profile [<profile-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the IPsec profile details.

PARAMETERS

EXAMPLEALU(config)# show crypto ipsec profile

!crypto ipsec profile default! ike-policy default! transform-set default! pfs group2! lifetime seconds 28800! Not Applied to Any Interface

crypto ipsec profile PF1 ike-policy secret transform-set transet1 ike-identity ID01 pfs group2! lifetime seconds 28800! Applied to:interface Tunnel1 ipsec-profile PF1ALU(config)#

Parameter Description

profile-name Displays the configuration details for the specified IPsec profile.

787Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

SHUTDOWNshutdown

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to administratively bring down the tunnel interface.

PARAMETERS

None.

EXAMPLEALU(config-if Tunnel1)# shutdown

TRANSFORM-SETtransform-set <name>

DESCRIPTION

This command is entered in the IPsec Profile Configuration Mode. This command is used to attach an already configured transform-set to an IPsec profile.

PARAMETERS

DEFAULT VALUE

If no transform set is attached to an IPsec profile, ‘default’ transform set is used.

EXAMPLEALU(ipsec-profile-PF1)# transform-set TS1

Parameter Description

name Name of the transform-set.

788

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

tunnel destination

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

TUNNEL DESTINATIONtunnel destination <ip-address>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command sets the destination IP address of the tunnel at the remote end.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-if Tunnel1)# tunnel destination 2.2.2.3

TUNNEL SOURCEtunnel source {<ip-address>|<interface-name>}

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command sets the source IP address of the tunnel.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-if Tunnel1)# tunnel source 2.2.2.1

orALU(config-if Tunnel1)# tunnel source FastEthernet 0

Parameter Description

ip-address Destination IP address of the tunnel.

Parameter Description

ip-address Source IP address of the tunnel.

interface-name Name of the interface.

789Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

DYNAMIC MULTIPOINT VIRTUAL PRIVATE NETWORK (DMVPN) CLI COMMANDS

This section deals with the commands relevant to DMVPN configuration on OmniAccess 5510 USG.

AUTHENTICATIONauthentication <string>

DESCRIPTION

This command is entered in the Client Object Configuration Mode. This command is used to configure authentication string for NHRP.

All devices configured with NHRP within one logical NBMA network must share the same authentication string.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-nhrp-alu-dmvpn)# authentication alu123

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

string Specify the authentication string for NHRP.

790

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

clear ip nhrp

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CLEAR IP NHRPclear ip nhrp

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command clears the dynamically learned NHRP entries from the NHRP cache. It does not delete the static mappings.

PARAMETERS

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# clear ip nhrp

RELEASE HISTORY

Release 3.0: command was introduced.

791Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

HOLDTIMEholdtime <60-65535>

DESCRIPTION

This command is entered in the Client Object Configuration Mode. This command is used to configure holdtime (in seconds) for NHRP cache.

PARAMETERS

DEFAULT VALUE

The default holdtime for NHRP cache is 7200 seconds.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-nhrp-alu-dmvpn)# holdtime 300

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

60-65535 Specify the holdtime (in seconds).

792

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ip nhrp

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IP NHRPip nhrp <object-name>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure a NHRP (Next Hop Routing Protocol) object.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# ip nhrp alu-dmvpnALU(config-nhrp-alu-dmvpn)#

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

object-name Name of the NHRP object.

793Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

MAPmap {<nhs-ip-address> <nbma-address>|multicast dynamic}

DESCRIPTION

This command is entered in the Client Object Configuration Mode. This command is used to map the static (destination) IP address to NBMA address of the NHS.

This command can also be used in spoke to spoke scenario, where in the static (tunnel) IP address as well as the NBMA address of the spoke to be reached is known. In such a scenario, enter the static IP address and the NBMA address of the spoke in the map command.

Note: Currently ‘multicast dynamic’ parameter is not supported.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-nhrp-alu-dmvpn)# map 192.168.1.1 1.1.1.1

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

nhs-ip-address IP address of the NHS.

nbma-address NBMA address of the NHS.

794

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

network-id

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NETWORK-IDnetwork-id <1-65535>

DESCRIPTION

This command is entered in the Client Object Configuration Mode. This command is used to configure NHRP network identifier.

Note: All NHRP domains/stations within a logical NBMA network should be configured with the same network identifier.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-nhrp-alu-dmvpn)# network-id 100

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

1-65535 Specify the NHRP network identifier.

795Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

NHRPnhrp <object-name>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to attach a configured NHRP object to the interface.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-if Tunnel1)# nhrp alu-dmvpn

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

object-name Name of the NHRP object.

796

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

nhs

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NHSnhs <ip-address>

DESCRIPTION

This command is entered in the Client Object Configuration Mode. This command is used to configure the IP address of the NHS. This is the tunnel IP address of the NHS.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-nhrp-alu-dmvpn)# nhs 192.168.1.1

RELEASE HISTORY

Release 3.0: command was introduced.

NO AUTHENTICATIONno authentication

This command is entered in the Configuration Mode. The “no” command removes the authentication string.

NO HOLDTIMEno holdtime

This command is entered in the Client Object Configuration Mode. The “no” command resets the holdtime to its default. The default holdtime for NHRP cache is 7200 seconds.

Parameter Description

ip-address IP address of the NHS.

797Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

NO NHRPno nhrp <object-name>

This command is entered in the Interface Configuration Mode. This command is used to detach a NHRP object attached to the interface.

Note: You cannot delete a NHRP object that is applied to the interface. To delete, first detach a NHRP object from the interface.

NO IP NHRPno ip nhrp <object-name>

This command is entered in the Configuration Mode. This command is used to delete a NHRP object.

Note: You cannot delete a NHRP object if it is attached to any interface. First detach it from the interface and then delete it.

NO MAPno map {<nhs-ip-address> <nbma-address>|multicast dynamic}

This command is entered in the Client Object Configuration Mode. This command is used to delete the static map entry.

NO NETWORK-IDno network-id

This command is entered in the Client Object Configuration Mode. This command is used to delete the configured network identifier.

NO NHSno nhs <ip-address>

This command is entered in the Client Object Configuration Mode. This command is used to delete the IP address of the NHS from a NHRP object.

NO REGISTRATION TIMEOUTno registration timeout

This command is entered in the Client Object Configuration Mode. The “no” command resets the registration timeout to its default, i.e., every two-third of the NHRP holdtime.

798

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

registration timeout

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

REGISTRATION TIMEOUTregistration timeout <60-65535>

DESCRIPTION

This command is entered in the Client Object Configuration Mode. This command is used to configure the interval (in seconds) at which the NHRP registration requests are to be sent to the NHS.

PARAMETERS

DEFAULT VALUE

The default registration timeout is every two-third of the NHRP holdtime.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-nhrp-alu-dmvpn)# registration timeout 600

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

60-65535 Specify interval (in seconds) at which the NHRP registration requests are to be sent to the NHS.

799Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

SHOW IP NHRPshow ip nhrp

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays all the static and dynamic mappings of the NHRP cache.

PARAMETERS

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show ip nhrp

172.23.1.5/32 via 172.23.1.5 Tunnel0 created, expire: 00:00:34 Type: cached, Flags: up NBMA address: 10.1.5.2172.23.1.1/32 via 172.23.1.1 Tunnel0 created, never expire Type: static, Flags: up NBMA address: 10.0.1.1

RELEASE HISTORY

Release 3.0: command was introduced.

800

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip nhrp configuration

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW IP NHRP CONFIGURATIONshow ip nhrp configuration

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the NHRP configuration details.

PARAMETERS

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show ip nhrp configuration

ip nhrp alu-dmvpn authentication test holdtime 14400 map 172.23.1.1 10.0.1.1 network-id 1234 nhs 172.23.1.1 registration timeout 180!interface Tunnel0 nhrp alu-dmvpn!

RELEASE HISTORY

Release 3.0: command was introduced.

801Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

SHOW IP NHRP OBJECTshow ip nhrp object [<object-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the NHRP object details.

PARAMETERS

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show ip nhrp object alu-dmvpn

ip nhrp alu-dmvpn authentication test holdtime 14400 map 172.23.1.1 10.0.1.1 network-id 1234 nhs 172.23.1.1 registration timeout 180!interface Tunnel0 nhrp alu-dmvpn

RELEASE HISTORY

Release 3.0: command was introduced.

802

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip nhrp interface Tunnel

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW IP NHRP INTERFACE TUNNELshow ip nhrp interface Tunnel <interface-number>

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the NHRP configuration on an interface.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show ip nhrp interface Tunnel 0

172.23.1.1/32 via 172.23.1.1 Tunnel0 created, never expire Type: static, Flags: up NBMA address: 10.0.1.1

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

interface-number Tunnel interface number.

803Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

IPSEC VPN SERVER CLI COMMANDSThis section deals with the commands relevant to IPsec VPN Server support on OmniAccess 5510 USG.

CLIENT FIREWALLclient firewall {Disable|Drop|No-Firewall|Pass|PassLocal}

DESCRIPTION

This command is entered in the Client Object Configuration Mode. This command is used to configure client firewall option.

When client is not connected to gateway, it will only allow client initiated traffic, rest will be dropped. Pass will pass all the traffic. Drop option will drop all the traffic if no tunnel is formed.

PARAMETERS

DEFAULT VALUE

By default, client firewall is disabled.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-client-obj-myclientobject)# client firewall pass

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

Disable|Drop|No-Firewall|Pass |PassLocal

Specify client firewall option.

804

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

client-ip-list

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CLIENT-IP-LISTClient-IP-list <list-name>

DESCRIPTION

This command is entered in the Client Object Configuration Mode. This command is used to attach a pre-configured list that contains a list of IP addresses to be assigned to the IPsec clients.

Note: The list should have contain host or only prefix or a combination of both.For more information on configuring list and its rule, refer to the “Common Classifiers” chapter in this guide.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLE

The following example shows a list with only host attached a crypto client object.ALU(config)# list L1 host 192.168.1.0ALU(config)# endALU(config)# crypto client object myclientobjectALU(config-client-obj-myclientobject)# Client-IP-list L1

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

list-name Name of the list that has a list of addresses to be assigned to IPsec clients.

805Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

CLIENT-OBJECTclient-object <name>

DESCRIPTION

This command is entered in the Client Profile Configuration Mode. This command is used to attach an already configured client object to a client profile.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-client-prof-myclientprofile)# client-object myclientobject

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

name Name of the client object.

806

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

crypto client object

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CRYPTO CLIENT OBJECTcrypto client object <name>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure a new crypto client object.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# crypto client object myclientobjectALU(config-client-obj-myclientobject)#

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

name Name of the client object.

807Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

CRYPTO CLIENT PROFILEcrypto client profile <name>

DESCRIPTION

This command when entered in the Configuration Mode is used to configure a new crypto client profile. Following are the default values for a newly configured crypto client profile: • Default IKE policy in a client profile: ‘default’ IKE policy• Default transform set: ‘default’ transform set• Default PFS group: pfs group2.• Default IPsec security-association lifetime in seconds: 28800

This command when entered in the Interface Configuration Mode is used to attach a configured client profile to an interface. You can attach only one client profile on an interface and vice versa.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# crypto client profile myclientprofileALU(config-client-prof-myclientprofile)#

ALU(config-if FastEthernet0)# crypto client profile myclientprofile

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

name Name of the IPsec client profile.

808

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ike-policy

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IKE-POLICYike-policy <name>

DESCRIPTION

This command is entered in the Client Profile Configuration Mode. This command is used to attach an already configured IKE policy to an IPsec client profile.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-client-prof-myclientprofile)# ike-policy IKE1

RELEASE HISTORY

Release 3.0: command was introduced in the Client Profile Configuraiton Mode.

Parameter Description

name Name of the IKE policy.

809Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

IPSEC SECURITY-ASSOCIATION LIFETIME SECONDSipsec security-association lifetime seconds <540-86400>

DESCRIPTION

This command is entered in the Client Profile Configuration Mode. This command is used to configure the IPsec SA lifetime in seconds for a client profile.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-client-prof-myclientprofile)# ipsec security-association lifetime seconds 5400

RELEASE HISTORY

Release 3.0: command was introduced in the Client Profile Configuraiton Mode.

Parameter Description

540-86400 Specify the time in seconds.

810

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

keep-alive

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

KEEP-ALIVEkeep-alive <1-60>

DESCRIPTION

This command is entered in the Client Object Configuration Mode. This command is used to configure time interval at which both client and the server sends a keep alive message. If a keep alive message is not received by either the client/server within the configured keep alive interval, client/server waits for three times the keep-alive period, after which the IPsec client connection is brought down.

PARAMETERS

DEFAULT VALUE

The default keep-alive value is 60 seconds.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-client-obj-myclientobject)# keep-alive 30

RELEASE HISTORY

Release 3.0: command was introduced.

NO CLIENT-OBJECTno client-object <name>

This command when entered in the Client Profile Configuration Mode. The ‘no’ command detaches the specified client object attached to the profile.

NO CRYPTO CLIENT OBJECTno crypto client object <name>

This command when entered in the Configuration Mode. This command is used to delete a crypto client object.

Note: You cannot delete a client object that is attached to a client profile. First detach it from the client profile and then delete it.

Parameter Description

1-60 Specify the interval in seconds for keep alive messages.

811Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

NO CRYPTO CLIENT PROFILEno crypto client profile <name>

This command when entered in the Configuration Mode is used to delete a client profile.

This command when entered in the Interface Configuration Mode is used to detach a client profile attached to an interface.

Note: You cannot delete a client profile that is applied to the interface. To delete, first detach the client profile from the interface.

NO PRIMARY_DNS_IPno primary_dns_ip <ip-address>

This command is entered in the Client Object Configuration Mode. This command is used to remove the IP address of the primary DNS in a crypto client object.

NO PRIMARY_WINS_IPno primary_wins_ip <ip-address>

This command is entered in the Client Object Configuration Mode. This command is used to remove the IP address of the primary WINS Server in a crypto client object.

NO SECONDARY_DNS_IPno secondary_dns_ip <ip-address>

This command is entered in the Client Object Configuration Mode. This command is used to remove the IP address of the secondary DNS in a crypto client object.

NO SECONDARY_WINS_IPno secondary_wins_ip <ip-address>

This command is entered in the Client Object Configuration Mode. This command is used to remove the IP address of the secondary WINS Server in a crypto client object.

812

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

pfs

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

PFSpfs {group1|group2|group5}

DESCRIPTION

This command is entered in the Client Profile Configuration Mode. This command is used to attach a PFS group to an IPsec client profile.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-client-prof-myclientprofile)# pfs group2

RELEASE HISTORY

Release 3.0: command was introduced in the Client Profile Configuraiton Mode.

Parameter Description

group1|group2|group5 PFS group.

813Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

PRIMARY_DNS_IPprimary_dns_ip <ip-address> secondary_dns_ip <ip-address>

DESCRIPTION

This command is entered in the Client Object Configuration Mode. This command is used to configure the IP address of the primary and secondary DNS in a crypto client object. This is the primary and secondary DNS to be sent to IPSec client.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-client-obj-myclientobject)# primary_dns_ip 1.1.1.1 secondary_dns_ip 1.1.1.2

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

primary_dns_ip <ip-address> IP address of the primary DNS.

secondary_dns_ip <ip-address> IP address of the secondary DNS.

814

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

primary_wins_ip

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

PRIMARY_WINS_IPprimary_wins_ip <ip-address> secondary_wins_ip <ip-address>

DESCRIPTION

This command is entered in the Client Object Configuration Mode. This command is used to configure the IP address of the primary and secondary WINS server in a crypto client object. This is the primary and secondary WINS server to be sent to IPSec client.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-client-obj-myclientobject)# primary_wins_ip 1.1.1.5 secondary_wins_ip 1.1.1.6

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

primary_wins_ip <ip-address> IP address of the primary WINS server.

secondary_wins_ip <ip-address> IP address of the secondary WINS server.

815Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

SAVE-PASSWORDsave-password {No|Yes}

DESCRIPTION

This command is entered in the Client Object Configuration Mode. This command is used to enable or disable the client to save password.

PARAMETERS

DEFAULT VALUE

By default, save password is set to No.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-client-obj-myclientobject)# save-password yes

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

No This option allows the client to save password. When this option is configured, the “Save password” field on the client is enabled and client can save the password, and does not have to enter the password for every login.

Yes This option does not allow the client to save password. When this option is configured, the “Save password” field on the client will be grayed out and client has to enter the password every time.

816

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show crypto client object

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW CRYPTO CLIENT OBJECTshow crypto client object [<object-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the IPsec client object details.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show crypto client object myclientObj

Idle Timeout:300 secPrimary DNS Server:A.B.C.DSecondary DNS Server:A.B.C.DPrimary WINS Server: A.B.C.DSecondary WINS Server:A.B.C.DClient Firewall:PassSave Password:YesLocal Client Address List:ClListLocal Server Address List:SerListAuthentication Method List:rad

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

object-name Name of the client object.

817Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

SHOW CRYPTO CLIENT PROFILEshow crypto client profile [<profile-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the IPsec client profile details.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show crypto client profile myclientprofile

Crypto Client Profile:myClientProfileIKE Policy:myikePolicy Transform Set :myxformDPD Interval:60 secDPD Timeout:300 secIPSec SA Lifetime:28800 secFS Group:Group 2IPSec Client object :myclientObj;

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

profile-name Name of the client profile.

818

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

transform-set

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

TRANSFORM-SETtransform-set <name>

DESCRIPTION

This command is entered in the IPsec Client Profile Configuration Mode. This command is used to attach an already configured transform-set to an IPsec client profile.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-client-prof-myclientprofile)# transform-set TS1

RELEASE HISTORY

Release 3.0: command was introduced in the Client Profile Configuraiton Mode.

Parameter Description

name Name of the transform set.

819Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

HARDWARE CRYPTO ENGINE CLI COMMANDSThis section deals with the commands relevant to Hardware Crypto Engine Support on OmniAccess 5510 USG.

CLEAR CRYPTO ENGINE STATISTICSclear crypto engine statistics

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to clear the crypto engine statistics.

PARAMETERS

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# clear crypto engine statistics

RELEASE HISTORY

Release 3.0: command was introduced.

820

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

crypto engine accelerator

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CRYPTO ENGINE ACCELERATORcrypto engine accelerator

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to enable the cyrpto engine.

PARAMETERS

None.

DEFAULT VALUE

By default, crypto engine is disabled.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# crypto engine accelerator

RELEASE HISTORY

Release 3.0: command was introduced.

NO CRYPTO ENGINE ACCELERATOR no crypto engine accelerator

This command is entered in the Configuration Mode. This command is used to disable the cyrpto engine.

821Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

SHOW CRYPTO ENGINE CONFIGURATIONshow crypto engine configuration

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the crypto engine configuration.

PARAMETERS

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show crypto engine configuration

Crypto engine configuration

crypto engine accelerator enabled

RELEASE HISTORY

Release 3.0: command was introduced.

822

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show crypto engine statistics

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW CRYPTO ENGINE STATISTICSshow crypto engine statistics

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the crypto engine statistics. These statistics indicate frames processed by each cryptographic execution unit for each crypto channel as well as the errors encountered on each.

PARAMETERS

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show crypto engine statistics

Crypto Engine Statistics:

Crypto Channel Frames In Frames out Frames err 1 3 3 0 2 0 0 0 3 0 0 0 4 0 0 0

Encryption Unit Frames In Frames out Frames err Arc4 0 0 0 DES/3DES 3 3 0 MD5/SHA1 3 3 0 RNG 0 0 0 PK 0 0 0 AES 0 0 0

RELEASE HISTORY

Release 3.0: command was introduced.

823Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

IP Security - Virtual Private Network

Left running head: Chapter name (automatic)

824

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Intrusion Detection/Intrusion Prevention System

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 32 INTRUSION DETECTION/INTRUSION PREVENTION SYSTEM

This chapter documents the Command Line Interface (CLI) commands for Intrusion Detection/Intrusion Prevention System (IDS/IPS) on an interface.

This chapter includes table of parameters, default values, and configuration examples for configuring the IDS/IPS as quick-start and reference information. In this chapter, all commands are described in alphabetical order. For more detailed information on using and configuring IDS/IPS, refer to the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

825Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Intrusion Detection/Intrusion Prevention System

Left running head: Chapter name (automatic)

CLEAR FIREWALL INTRUSION SNORT STATISTICSclear firewall intrusion snort statistics [<interface-name>]

DESCRIPTION

This command is entered in the Super User Mode or the Configuration Mode. Use this command to clear Snort statistics.

PARAMETER

EXAMPLEALU#clear firewall intrusion snort statistics

CLEAR FIREWALL INTRUSION SNORT STATISTICS PREPROCESSORclear firewall intrusion snort statistics preprocessor [{back-orifice|http-inspect|rpc|stream4}]

DESCRIPTION

This command is entered in the Super User Mode or the Configuration Mode. Use this command to clear the Snort preprocessor statistics.

PARAMETER

EXAMPLEALU#clear firewall intrusion snort statistics preprocessor http-inspect

Note: Currently, preprocessor attacks of type rpc and stream4 is not supported.

Parameter Description

interface-name Name of the interface.

Parameter Description

http-inspect The preprocessor that acts as generic HTTP decoder.

back-orifice The preprocessor that is used to prevent buffer over flow attack.

rpc The preprocessor that normalizes RPC fragmented records.

stream4 The preprocessor that is used for reassembly.

826

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

clear firewall intrusion snort statistics rule

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CLEAR FIREWALL INTRUSION SNORT STATISTICS RULEclear firewall intrusion snort statistics rule {<1-4294967295..>|all|category <name>|classtype <name>| priority {high|low|medium}

DESCRIPTION

This command is entered in the Super User Mode or the Configuration Mode. Use this command to clear group level Snort statistics.

PARAMETER

EXAMPLEALU#clear firewall intrusion snort statistics rule all

Parameter Description

<1-4294967295...> Clears the snort rule statistics of a specified rule ID.

all Clears the snort rule statistics of all the rules.

category <name> Clears the statistics of the snort rules belonging to a specified category.

class-type <name> Clears the statistics of the snort rules belonging to a specified class type.

priority {high|low|medium} Clears the snort rule statistics of a specific priority.

827Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Intrusion Detection/Intrusion Prevention System

Left running head: Chapter name (automatic)

DEBUG TRACE FIREWALL INTRUSION SELECTORdebug firewall {session|filter|nat|attack|alg|intrusion |selector [saddr <ip-address>|daddr <ip- address>|protocol <number>|sport <number>|dport <number>][output|permanent]|all [detail-level]}

DESCRIPTION

This command is entered in the Super User Mode or the Configuration Mode. This command turns on the debugging functionality for IDS/IPS on OmniAccess 5510 USG.

PARAMETER

EXAMPLEALU# debug firewall intrusion

Parameter Description

saddr Source address.

daddr Destination address.

protocol Protocol number.

sport Source port.

dport Destination port.

828

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

firewall policy {in | out}

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

FIREWALL POLICY {IN | OUT}firewall policy {in|out} <policy-name>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to attach a firewall policy (to which an intrusion sensor is attached) to an interface in ‘in’ or ‘out’ direction.

PARAMETERS

Note: Firewall policy will take effect once it is attached to an interface.

EXAMPLEALU(config)# interface FastEthernet 0 ALU(config-if FastEthernet0)# firewall policy in P1

Parameter Description

in Firewall policy is applied to the ingress (incoming) traffic if “in” keyword is used.

out Firewall policy is applied to the egress (outgoing) traffic if “out” keyword is used.

policy name Name of the firewall policy.

829Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Intrusion Detection/Intrusion Prevention System

Left running head: Chapter name (automatic)

INTRUSION SENSORintrusion sensor <name> snort [no threshold|threshold <1-4294967295> <1-4294967295>]

DESCRIPTION

This command is entered in the Firewall configuration mode. This command is used to create an IDS/IPS sensor based on Snort.

Use ‘threshold’ keyword to configure the threshold for the sensor.

Use ‘no threshold’ keyword to remove threshold configured for the sensor.

PARAMETER

EXAMPLEALU(config)#firewallALU(config-firewall)#intrusion sensor sensor1 snort threshold 10 1000

ALU(config-firewall-intrusion-sensor-sensor1)#

INTRUSION SNORTintrusion snort

DESCRIPTION

This command is entered in the Firewall configuration mode. This command enters the snort configuration mode.

PARAMETER

None.

EXAMPLEALU(config)# firewallALU(config-firewall)# intrusion snortALU(config-firewall-intrusion-snort)#

Parameter Description

name Name of the sensor.

1-4294967295 Threshold number. This denotes the number of packets per second.

1-4294967295 This denotes the threshold time in milliseconds inside which if the specified threshold number of packets are received, those packets are treated as attacks.

no threshold Remove threshold from sensor.

830

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

match intrusion {detection | prevention}

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

MATCH INTRUSION {DETECTION | PREVENTION}[<1-65535>] match [all|any] <match-list name> intrusion <sensor name> {detection|prevention [reset]}

DESCRIPTION

This command is entered in the Firewall Policy Configuration Mode.

This command is used to attach an intrusion sensor to a firewall policy, and create rules (associate match-list and set priority for the rule) for a firewall policy. This command also sets the action detection or prevention for the configured rule.

This rule number signifies the priority of a rule.

PARAMETER

EXAMPLEALU(config-firewall)#policy policy1ALU(config-firewall-policy1)#1 match m1 intrusion sensor1 detection

NO DEBUG TRACE FIREWALL INTRUSION SELECTORno debug firewall {session|filter|nat|attack|alg|intrusion |selector [saddr <ip-address>|daddr <ip- address>|protocol <number>|sport <number>|dport <number>][output|permanent]|all [detail-level]}

This command is entered in the Super User Mode or the Configuration Mode. Use this command to turn off the debugging functionality for IDS/IPS.

Parameter Description

1-65535 The range for the intrusion rule. This rule number signifies the priority of a rule.

match [all|any] <match-list name>

match all - In this type of match, the relevant action is performed only when all the match-list criteria is satisfied.match any - In this type of match, the relevant action is performed even if any one of the match-list criterion is satisfied.

sensor name Name of the sensor.

detection Detects the intrusion.

prevention Detects and also prevents the intrusion.

reset Resets the connection on detection of intrusion attacks.

831Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Intrusion Detection/Intrusion Prevention System

Left running head: Chapter name (automatic)

NO INTRUSION SENSORno intrusion sensor <name> snort

This command is entered in the Firewall Configuration Mode. Use this command to delete an intrusion sensor.

Note: You cannot delete the intrusion sensor if it is attached to a firewall policy. Detach the sensor from the firewall policy before deleting it.

NO UPDATEno update [{passive|rebuild}]

This command is entered in the Intrusion Snort Configuration Mode. Use this command to remove the scheduled Snort rule database update.

REBUILDrebuild <version-number>

DESCRIPTION

This command is entered in the Intrusion Snort Configuration Mode. Use this command to manually rebuild the signature database.

PARAMETER

EXAMPLEALU(config-firewall-intrusion-snort)#rebuild 2.3.0

Parameter Description

version-number Version of the signature database.

832

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

rollback

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

ROLLBACKrollback <version-number>

DESCRIPTION

This command is entered in the Intrusion Snort Configuration Mode. Use this command to rollback to the different versions of Snort rule database.

PARAMETER

EXAMPLEALU(config-firewall-intrusion-snort)#rollback 2.3.1

RULE DETECTIONrule detection {{category <name>..|classtype <name>..|priority {high|low|medium}}

DESCRIPTION

This command is entered in the Intrusion Snort Configuration Mode. This command enables you to modify the group level detection.

PARAMETER

EXAMPLEALU(config-firewall-intrusion-snort)#rule detection category attack-responses

Parameter Description

version-number Version of the Snort rule database.

Parameter Description

category <name> Name of the Snort rule category.

class-type <name> Name of the Snort rule class type.

priority {high|low|medium} Snort rule priority: low, high or medium.

833Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Intrusion Detection/Intrusion Prevention System

Left running head: Chapter name (automatic)

RULE DISABLErule disable {{category <name>...|classtype <name>...| priority {high|low|medium}|sid <1-4294967295...>}

DESCRIPTION

This command is used in Intrusion Snort Configuration Mode. Use this command to disable Snort rules by Snort rule ID (SID), class type, priority, or category.

PARAMETER

EXAMPLEALU(config-firewall-intrusion-snort)#rule disable classtype attempted-dos

RULE ENABLErule enable {{category <name>...|classtype <name>...| priority {high|low|medium}|sid <1-4294967295...>}

DESCRIPTION

This command is used in Intrusion Snort Configuration Mode. Use this command to enable Snort rules by Snort Rule ID (SID), class type, priority, or category.

PARAMETER

EXAMPLEALU(config-firewall-intrusion-snort)# rule enable classtype attempted-dos

Parameter Description

category <name> Name of the Snort rule category.

class-type <name> Name of the Snort rule class type.

priority {high|low|medium} Snort rule priority: low, high or medium.

sid <1-4294967295...> Snort rule ID.

Parameter Description

category <name> Name of the Snort rule category.

class-type <name> Name of the Snort rule class type.

priority {high|low|medium} Snort rule priority: low, high or medium.

sid <1-4294967295...> Snort rule ID.

834

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

rule modify

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

RULE MODIFYrule modify <1-4294967295> content <rule-content>

DESCRIPTION

This command is entered in the Intrusion Snort Configuration Mode. Use this command to modify Snort rule.

Note: Rule modify functionality is not supported in this release.

PARAMETER

EXAMPLE

To modify the rule given below, use the rule modify command: Original rule: alert tcp $HOME_NET any -> $EXTERNAL_NET any (msg:"ATTACK-RESPONSES directory listing"; flow:from_server,established; content:"Volume Serial Number"; classtype:bad-unknown; sid:1292; rev:8;)

Modification of rule to $EXTERNAL_NET is shown below:ALU(config-firewall-intrusion-snort)#rule modify 1292 content alert tcp $EXTERNAL_NET any -> $EXTERNAL_NET any (msg:"ATTACK-RESPONSES directory listing"; flow:from_server,established; content:"Volume Serial Number"; classtype:bad-unknown; sid:1292; rev:8;)

Parameter Description

1-4294967295 Snort rule ID.

rule-content The modified rule content.

835Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Intrusion Detection/Intrusion Prevention System

Left running head: Chapter name (automatic)

RULE PREVENTIONrule prevention {{{category <name>|classtype <name>| priority {high|low|medium}|reset {category <name>|classtype <name>| priority {high|low|medium}}}

DESCRIPTION

This command is entered in the Intrusion Snort Configuration Mode. This command enables you to modify the group level prevention.

PARAMETER

EXAMPLEALU(config-firewall-intrusion-snort)#rule prevention category attack-responses

SHOW FIREWALL INTRUSION SENSORshow firewall intrusion sensor [<name>]

DESCRIPTION

This command is entered in the Super User Mode or the Configuration Mode. Use this command to view instruction sensor configuration details.

PARAMETER

EXAMPLEALU# show firewall intrusion sensorfirewall intrusion sensor sensor1 snort intrusion sensor sensor4 snort intrusion sensor s1 snortexit

Parameter Description

category <name> Name of the Snort rule category.

class-type <name> Name of the Snort rule class type.

priority {high|low|medium} Snort rule priority: low, high or medium.

Parameter Description

name Name of the sensor.

836

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show firewall intrusion snort archives

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW FIREWALL INTRUSION SNORT ARCHIVESshow firewall intrusion snort archives

DESCRIPTION

This command is entered in the Super User Mode or the Configuration Mode. Use this command to display snort signature archives.

PARAMETER

None.

EXAMPLEALU#show firewall intrusion snort archives

Version no | Details | Date of Download |Time of Downl-2.3.0 Current initial

837Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Intrusion Detection/Intrusion Prevention System

Left running head: Chapter name (automatic)

SHOW FIREWALL INTRUSION SNORT FILE LIST show firewall intrusion snort file {<filename>|list>}

DESCRIPTION

This command is entered in the Super User Mode or the Configuration Mode. Use this command to display the contents of a specific snort rule file or list all the rule files.

PARAMETER

EXAMPLEALU# show firewall intrusion snort file icmp.rules

C) Copyright 2001-2004, Martin Roesch, Brian Caswell, et al.All rights reserved.$Id: icmp.rules,v 1.1 2005/03/18 11:27:51 ppote Exp $-----------ICMP RULES-----------

Description:These rules are potentially bad ICMP traffic. They include most of theICMP scanning tools and other "BAD" ICMP traffic (Such as redirect host)

Other ICMP rules are included in icmp-info.rules

alert icmp $EXTERNAL_NET any -> $HOME_NET any (msg:"ICMP ISS Pinger"; itype:8; content:"ISSPNGRQ"; depth:32; reference:arachnids,158; classtype:attempted-recon;sid:465; rev:3;)alert icmp $EXTERNAL_NET any -> $HOME_NET any (msg:"ICMP L3retriever Ping"; icode:0; itype:8; content:"ABCDEFGHIJKLMNOPQRSTUVWABCDEFGHI"; depth:32; reference:arachnids,311; classtype:attempted-recon; sid:466; rev:4;)alert icmp $EXTERNAL_NET any -> $HOME_NET any (msg:"ICMP Nemesis v1.1 Echo"; dsize:20; icmp_id:0; icmp_seq:0; itype:8; content:"|00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00|"; reference:arachnids,449; classtype:attempted-recon; sid:467; rev:3;)--More--

Parameter Description

filename Name of the rule file.

list List of all the rule files.

838

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show firewall intrusion snort rule

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW FIREWALL INTRUSION SNORT RULEshow firewall intrusion snort rule {category <name>|classtype <name>|disable {category|classtype|priority|sid}|priority {high|low|medium}|sid <1-4294967295...>}

DESCRIPTION

This command is entered in the Super User Mode or the Configuration Mode. Use this command to display the contents of a specific snort rule.

PARAMETER

EXAMPLEALU#show firewall intrusion snort rule category dosalert ip $EXTERNAL_NET any -> $HOME_NET any (msg:"DOS Jolt attack"; dsize:408; fragbits:M; reference:cve,1999-0345; classtype:attempted-dos; sid:268; rev:4;)

alert udp $EXTERNAL_NET any -> $HOME_NET any (msg:"DOS Teardrop attack"; fragbits:M; id:242; reference:bugtraq,124; reference:cve,1999-0015; reference:nessu)

alert udp any 19 <> any 7 (msg:"DOS UDP echo+chargen bomb"; reference:cve,1999-0103; reference:cve,1999-0635; classtype:attempted-dos; sid:271; rev:4;)

Parameter Description

category <name> Details of the snort rules belonging to a specified category.

class-type <name> Details of the snort rules belonging to a specified class type.

disable{category|classtype| priority|sid}

Details of the snort rules belonging to a disabled category, class type, priority and rule ID.

priority {high|low|medium} Details of the snort rules of a specific priority.

<1-4294967295...> Details of the snort rules of a specific rule ID.

839Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Intrusion Detection/Intrusion Prevention System

Left running head: Chapter name (automatic)

SHOW FIREWALL INTRUSION SNORT RULE DISABLEshow firewall intrusion snort rule disable {category|classtype |priority|sid}

DESCRIPTION

This command is entered in the Super User Mode or the Configuration Mode. Use this command to display the information of group of rules that are disabled.

PARAMETER

EXAMPLEALU# show firewall intrusion snort rule disable sidDisable sid:

Parameter Description

category <name> Details of the snort rules belonging to a disabled category.

class-type <name> Details of the snort rules belonging to a disabled class type.

priority {high|low|medium} Details of the snort rules of a specific disabled priority.

sid Details of the snort rules specific disabled rule ID.

840

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show firewall intrusion snort statistics

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW FIREWALL INTRUSION SNORT STATISTICSshow firewall intrusion snort statistics [<interface-name>]

DESCRIPTION

This command is entered in the Super User Mode or the Configuration Mode. Use this command to display Snort statistics on a specified interface.

PARAMETER

EXAMPLEALU#show firewall intrusion snort statistics

Pkt Received : 20Pkt Passed : 16Pkt Dropped : 4Pkt Queued : 0Pkt Detected : 0

Parameter Description

interface-name Interface for which Snort statistics is being viewed.

841Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Intrusion Detection/Intrusion Prevention System

Left running head: Chapter name (automatic)

SHOW FIREWALL INTRUSION SNORT STATISTICS PREPROCESSORshow firewall intrusion snort statistics preprocessor [{back-orifice|http-inspect|rpc|stream4}]

DESCRIPTION

This command is entered in the Super User Mode or the Configuration Mode. Use this command to display statistics for a specific snort pre-processor.

Note: Currently, preprocessor attacks of type rpc and stream4 is not supported.

PARAMETER

EXAMPLEALU#show firewall intrusion snort statistics preprocessor http-inspect

Parameter Description

back-orifice The preprocessor that is used to prevent buffer over flow attack.

http-inspect The preprocessor that acts as generic HTTP decoder.

rpc The preprocessor that normalizes RPC fragmented records.

stream4 The preprocessor that is used for reassembly.

842

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show firewall intrusion snort statistics rule

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW FIREWALL INTRUSION SNORT STATISTICS RULEshow firewall intrusion snort statistics rule {<1-4294967295..>|all|category <name>|classtype <name>|priority {high|low|medium}

DESCRIPTION

This command is entered in the Super User Mode or the Configuration Mode. This command is used to display Snort rule statistics.

PARAMETER

EXAMPLEALU#show firewall intrusion snort statistics rule all

Parameter Description

<1-4294967295...> Snort rule statistics for a specific rule ID.

all Snort rule statistics for all the rules.

category <name> Snort rule statistics belonging to a specific category.

class-type <name> Snort rule statistics belonging to a specific class type.

priority {high|low|medium} Snort rule statistics for a specific priority.

843Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Intrusion Detection/Intrusion Prevention System

Left running head: Chapter name (automatic)

SHOW FIREWALL INTRUSION SNORT UPDATEshow firewall intrusion snort update [(report|status)]

DESCRIPTION

This command is entered in the Super User Mode or the Configuration Mode. Use this command to display the status of the snort signature database update.

PARAMETER

EXAMPLEALU#show firewall intrusion snort update report

SHOW FIREWALL POLICYshow firewall policy name

DESCRIPTION

This command is entered in the Super User Mode or the Configuration Mode. This command is used to view firewall policy configuration details.

PARAMETER

EXAMPLEALU#show firewall policy policy1

Parameter Description

report View the report of the snort signature database update.

status View the status of the snort signature database update.

Parameter Description

name Name of the firewall policy.

844

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

update

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

UPDATEupdate {instant|scheduled {daily <hh:mm:ss>|monthly <1-31> <hh:mm:ss>|weekly {Sunday|Monday|..}<hh:mm:ss>} delta <1-300>} {http|https} <url> {passive|rebuild}}

DESCRIPTION

This command is entered in the Intrusion Snort Configuration Mode.

This command is used to update Snort rule database through the HTTP/HTTPS server. This command gives option to update the Snort rule immediately or regularly on scheduled date and time.

Note: The URL for HTTP or HTTPS should be provided in the following way: For e.g., ‘update instant https https://<username:password@<server-name/ip>/signature.tar.gz passive/rebuild’.

It is preferable to upgrade the signatures from Alcatel-Lucent HTTPS server: ‘idsdl.esd.alcatel-lucent.com’. It will internally verify the signature versions and download the latest signatures.

However if you want to use an in-house HTTP server, you need to copy the signature files and corresponding digital signatures (provided by Alcatel-Lucent) into your private server. For e.g., use the below command to install the latest signatures from the local server once it is downloaded from the ALU server ‘update instant http http://<private-server>/<path-to-the-directory>/signature-2-3-49.tar.gz passive’. This will update to signature-2-3-49 without checking whether it is latest or not.

PARAMETER

Parameter Description

instant Downloads the latest signature database and updates instantly.

daily Update the snort rule database every day.

weekly {Sunday|Monday|...} Update the snort rule database a specific day of the week.

monthly <1-31> Update the snort rule database on a specific day of the month.

hh:mm:ss Update the snort rule database at the specified time of the day.

delta <1-300> Delta value in the range 1 to 300.

{http|https} <url> Update snort rule database through the HTTP/HTTPS server.

845Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Intrusion Detection/Intrusion Prevention System

Left running head: Chapter name (automatic)

EXAMPLEALU(config-firewall-intrusion-snort)# update instant https https://idsdl.esd.alcatel-lucent.com/signature.tar.gz rebuild

passive Downloads the latest signature database. Changes will not come into effect even on next reboot, until you manually rebuild by issuing 'Rebuild' command.

rebuild Downloads the latest signature database. The signature database will come into effect immediately after download.

Parameter Description

846

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Generic Routing Encapsulation

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 33 GENERIC ROUTING ENCAPSULATION

This chapter documents the Command Line Interface (CLI) commands for Generic Routing Encapsulation. These commands are used to configure GRE on an interface.

This chapter includes table of parameters, default values, and configuration examples for configuring the GRE as quick-start and reference information. In this chapter, all commands are described in alphabetical order. For a more detailed information on using and configuring GRE, refer to the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

847Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Generic Routing Encapsulation

Left running head: Chapter name (automatic)

GRE-KEEP-ALIVE-INTERVALgre-keep-alive-interval <1-3600>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure the GRE keepalive interval (in seconds).

PARAMETERS

DEFAULT VALUE

The default keepalive interval is 10 seconds.

EXAMPLEALU(config)# gre-keep-alive-interval 100

GRE-KEEP-ALIVE-MAX-TRIESgre-keep-alive-max-tries <1-100>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure the maximum number of keep alive messages to be sent.

PARAMETERS

DEFAULT VALUE

The default keepalive max-tries is 3.

EXAMPLEALU(config)# gre-keep-alive-max-tries 10

Parameter Description

1-3600 Specifies the interval (in seconds) at which the GRE keep alive messages is to be sent.

Parameter Description

1-100 Specifies the maximum number of GRE keep alive messages to be sent.

848

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

interface tunnel

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

INTERFACE TUNNEL interface Tunnel <0-4095>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to create a tunnel interface.

PARAMETERS

DEFAULT VALUE

By default, tunnel is configured in GRE mode.

EXAMPLEALU(config)# interface Tunnel 7ALU(config-if Tunnel7)#

IP ADDRESS ip address {<ip-address subnet-mask>|<ip-address/prefix-length>}

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to assigns an IP address and subnet mask to the tunnel interface.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-if Tunnel7)# ip address 20.20.20.20/24

Parameter Description

0-4095 The number specified for the tunnel.

Parameter Description

{<ip-address subnet-mask>|<ip-address/prefix-length>}

IP address with subnet mask or prefix length.

849Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Generic Routing Encapsulation

Left running head: Chapter name (automatic)

MODE mode {gre|ipsec|multipoint-gre}

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to set the mode on tunnel interface.

PARAMETERS

DEFAULT VALUE

By default, tunnel is configured in the GRE mode.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-if Tunnel7)# mode gre

RELEASE HISTORY

Release 3.0: Parameter “multipoint-gre” was introduced.

Parameter Description

gre Sets the tunnel in GRE mode.

ipsec Sets the tunnel in IPsec mode.

multipoint-gre Sets the tunnel in Multipoint GRE mode.

850

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

no gre-keep-alive-interval

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NO GRE-KEEP-ALIVE-INTERVALno gre-keep-alive-interval <1-3600>

This command is entered in the Configuration Mode. This command resets the keepalive interval to its default. The default keepalive interval is 10 seconds.

NO GRE-KEEP-ALIVE-MAX-TRIESno gre-keep-alive-max-tries <1-100>

This command is entered in the Configuration Mode. This command resets the keepalive max tries value to its default. The default keepalive max-tries is 3.

NO SHUTDOWNno shutdown

This command is entered in the Interface Configuration Mode. This command is used to administratively bring up the tunnel interface.

NO TUNNEL DESTINATIONno tunnel destination {<ip-address>|<fqdn>}

This command is entered in the Interface Configuration Mode. The “no” command removes the configured destination IP address or FQDN of the tunnel.

NO TUNNEL SOURCEno tunnel source {<ip-address>|<interface-name>}

This command is entered in the Interface Configuration Mode. The “no” command removes the configured source IP address of the tunnel.

SHUTDOWNshutdown

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to administratively bring down the tunnel interface.

PARAMETERS

None.

EXAMPLEALU(config-if Tunnel7)# shutdown

851Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Generic Routing Encapsulation

Left running head: Chapter name (automatic)

TUNNEL DESTINATIONtunnel destination {<ip-address>|<FQDN>}

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command sets the destination IP address or fully qualified domain name (FQDN) of the tunnel at the remote end.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-if Tunnel7)# tunnel destination 10.1.0.5

ALU(config-if Tunnel7)# tunnel destination mysmb.dyndns.org

RELEASE HISTORY

Release 3.0: Parameter “FQDN” was introduced.

Parameter Description

ip-address Destination IP address of the tunnel at the remote end.

FQDN Fully qualified domain name of the tunnel at the remote end.

852

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

tunnel df-bit

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

TUNNEL DF-BITtunnel df-bit {clear|set|copy-from-inner-ip}

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command sets the value of the DF-bit for the Outer-IP header.

PARAMETERS

DEFAULT VALUE

The default DF-BIT value is ‘clear’.

EXAMPLEALU(config-if Tunnel7)# tunnel df-bit clear

TUNNEL SOURCEtunnel source {<ip-address>|<interface-name>}

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command sets the source IP address of the tunnel.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-if Tunnel7)# tunnel source 10.91.0.7

orALU(config-if Tunnel7)# tunnel source FastEthernet 0

Parameter Description

clear Clears the DF-bit.

set Sets the DF-bit value.

copy-from-inner-ip Copies from the original IP header.

Parameter Description

ip-address Source IP address of the tunnel.

853Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Generic Routing Encapsulation

Left running head: Chapter name (automatic)

TUNNEL VRFtunnel vrf {<vrf-name>|default}

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command allows to resolve the tunnel source and tunnel destination from the specified VRF instead of the VRF associated with the tunnel interface.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-if Tunnel7)# tunnel vrf ALU-vrf1

Parameter Description

vrf-name Name of the VRF different from the VRF associated with the tunnel interface.

default Default VRF.

854

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

For final production, import color definitions from\\daldoc01\docteam\templates\framemaker\book-template\color-defs\ production-colors.fm. Do not import other template elements such as page layout.

To return to the draft version, import color def’ns from draft-colors.fm.To switch to the beta version, import color def’ns from beta-colors.fm

For final production, import color definitions from\\daldoc01\docteam\templates\framemaker\book-template\color-defs\ production-colors.fm. Do not import other template elements such as page layout.

To return to the draft version, import color def’ns from draft-colors.fm.To switch to the beta version, import color def’ns from beta-colors.fm

Optional footer: Manual title (to set, redefine ManualTitlevariable)

agination: umeric & ntinuous

PNco

Part 7 Quality of Service

Beta BetaAlcatel-Lucent

855

Beta Betawith preceding section of book

OmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Left running head: Chapter name (automatic)

856

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Quality of Service

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 34 QUALITY OF SERVICE

This chapter documents the Command Line Interface (CLI) commands for Quality of Service (QoS).

This chapter includes table of parameters, default values, and configuration examples for QoS configurations as quick-start and reference information. In this chapter, all the commands are described in alphabetical order. For more detailed information about using and configuring the QoS, refer to the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

857Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Quality of Service

Left running head: Chapter name (automatic)

AUTO QOS DIFF-SERVauto qos diff-serv

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command enables Auto QoS Diff-Serv on an interface (assured forwarding and expedited forwarding).

PARAMETERS

None.

DEFAULT VALUE

None.

EXAMPLEALU(config-subif atm0.1)# auto qos diff-serv

AUTO QOS TEMPLATEauto qos template {diff-serv|voip} <policy-map name>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command creates an Auto QoS VoIP/Diff-serv template policy.

This policy is to be attached to an interface using the ‘service policy command’.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# auto qos template voip p1

Parameter Description

policy-map name Name of the policy map.

858

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

auto qos voip

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

AUTO QOS VOIPauto qos voip

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command enables Auto QoS VoIP on an interface.

PARAMETERS

None.

DEFAULT VALUE

None.

EXAMPLEALU(config-subif atm0.1)# auto qos voip

BANDWIDTHbandwidth {<101-70000000>|percent <1-100>}

DESCRIPTION

This command is entered in the class mode. This command is used to configure the bandwidth for a traffic class.

Note: You cannot mix the absolute bandwidth command with percentage bandwidth command across sibling classes.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-pmap-P1-C1)# bandwidth 101

Parameter Description

101-70000000 The absolute bandwidth (bps) value.

1-100 The bandwidth in percentage.

859Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Quality of Service

Left running head: Chapter name (automatic)

CLASSclass {<class-map name>|<class-default>}

DESCRIPTION

This command is used to configure a traffic class, i.e., associate a class map. Use keyword class-default to configure the default traffic class to the policy map.

This command enters the Class sub-configuration mode inside the Policy-map mode.

Note: If no rule is associated with a class-map and if you try to configure a class on that class-map, a warning is displayed. Example:ALU (config-qos-P1)# class C1No rule in class-map C1. It will not match any traffic.

PARAMETERS

DEFAULT VALUE

‘class-default’ is the default traffic class.

EXAMPLEALU(config-qos-P1)# class C1ALU(config-qos-P1-C1)#

ALU(config-qos-P1-C1)# class class-defaultALU(config-qos-P1-class-default)#

Parameter Description

class-map name Name of the class map.

class-default Default traffic class.

860

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

class-map

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CLASS-MAPclass-map <class-map name> [{match-all|match-any}]

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure a class map, and define the relationship between all the match-lists configured within the class map.

This command enters the class-map sub-configuration mode.

PARAMETERS

DEFAULT VALUE

Default match-list relationship of a class-map is ‘match-any’.

EXAMPLEALU(config)# class-map C1 match-all ALU(config-qos-C1)#

To Configure a Rule for the Class-map:

[<1-65535>] match [all|any] <match-list name>...

This command is used to configure rules (associate match-lists and set priority for the rule) for a class map. The range for the rule is 1-65535. This rule number signifies the priority of a rule.

ALU(config-qos-C1)# match all m1 m3

ALU(config-qos-C1)# match any m2 m4 m5

Parameter Description

class-map name Name of the class-map.

{match-all|match-any} match-all specifies that all match criteria must be met for traffic entering the traffic class to be classified as part of the traffic class. match-any specifies that one of the match criteria must be met for traffic entering the traffic class to be classified as part of the traffic class.

861Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Quality of Service

Left running head: Chapter name (automatic)

CLEAR QUEUING STATISTICSclear queuing statistics [{<interface-name> {in|out}|in|out}]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command clears the QoS statistics on that particular interface.

PARAMETERS

EXAMPLEALU# clear queuing statistics

DESCRIPTIONdescription <line>

DESCRIPTION

This command is entered in the Policy-map Mode. The description for the policy map configured.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-qos-P1)# description P1 is the name of the policy-map.

ALU(config-qos-P1)# show policy-map P1policy-map P1 description P1 is the name of the Policy Map

Parameter Description

interface name Name of the interface.

Parameter Description

line Description for policy map.

862

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

fair-queue

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

FAIR-QUEUEfair-queue

DESCRIPTION

This command is entered in the Class Mode. This command is used to enable fair queue on the Default Class.

Note: You can enable or disable fair queue only on the Class Default.

Fair queuing is not applicable on hierarchical queuing.

PARAMETERS

None.

DEFAULT VALUE

None.

EXAMPLEALU(config-qos-P1-C1)# class class-defaultALU(config-qos-P1-class-default)# fair-queue

863Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Quality of Service

Left running head: Chapter name (automatic)

L2-SERVICE-POLICYl2-service-policy {in|out} <policy-map name>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is entered in the Interface Configuration mode. This command is used to attach a policy map to an interface either in ingress or egress direction.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-if Serial0)# l2-service-policy in P1

RELEASE HISTORY

Release 3.0: command was added.

Parameter Description

in Ingress direction.

out Egress direction.

policy-map name Name of the policy map.

864

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

network-control

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NETWORK-CONTROLnetwork-control

DESCRIPTION

This command is entered in the Class Mode. Configures the traffic class a network control class.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-qos-P1-C1)# network-control

NO AUTO QOS DIFF-SERVno auto qos diff-serv

This command is entered in the Interface Configuration Mode. This command disables Auto QoS Diff-Serv on an interface.

NO AUTO QOS TEMPLATEno auto qos template {diff-serv|voip} <policy-map name>

This command is entered in the Configuration Mode. This command removes the specified Auto QoS template.

NO AUTO QOS VOIPno auto qos voip

This command is entered in the Interface Configuration Mode. This command disables Auto QoS VoIP on an interface.

NO BANDWIDTHno bandwidth

This command is entered in the Class Mode. This command removes the bandwidth configuration.

Parameter Description

network-control The highest priority among all the traffic classes.

865Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Quality of Service

Left running head: Chapter name (automatic)

NO CLASSno class <class-map name>

This command is entered in the Policy-map Mode. This command removes a traffic-class associated with the policy map.

NO CLASS-MAPno class-map <class-map name>

This command is entered in the Configuration Mode. Deletes a configured class-map.

NO FAIR-QUEUEno fair-queue

This command is entered in the Class Mode. This command disables fair queue on the Default Class.

NO L2-SERVICE-POLICYno l2-service-policy {in|out} <policy-map name>

This command is entered in the Interface Configuration Mode. This command detaches the L2 policy map from the interface.

NO NETWORK-CONTROLno network-control

This command is entered in the Class Mode. This command removes the network-control attribute of the traffic-class.

NO POLICEno police

This command is entered in the Class Mode. This command removes the configured police on the traffic class of the policy map.

NO POLICY-MAPno policy-map <policy-map name>

This command is entered in the Configuration Mode. This removes the configured policy-map.

Note: You cannot remove a policy map if it is attached to an interface either in ingress or egress direction.

866

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

no priority

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NO PRIORITYno priority

This command is entered in the Class Mode. This command removes the priority attribute of the traffic-class, and configured bandwidth, if any.

NO QOS-PRECLASSIFYno qos-preclassify

This command is entered in the Interface Configuration Mode. This command disables the pre-classification.

NO RANDOM-DETECTno random-detect [ip-dscp|ip-dscp-values|ip-precedence|ip-precedence-values|values]

This command is entered in the Class Mode. This command disables the random-detect on ip-dscp and ip-precedence. The command also deletes all ip-dscp, ip-precedence configuration, or all random-detect configuration.

NO RULEno rule <1-65535>

This command is entered in the Class-map mode. This command is used to delete a specific rule from the class map, with reference to its line/rule number.

NO SETno set {ecn-ce|fr-becn|fr-de|fr-fecn|ip-dscp|ip-precedence|tos |vlan 1p}

This command is entered in the Class Mode. This command removes the packet marking configuration.

NO SERVICE-POLICYno service-policy {in|out} <policy-map name>

This command is entered in the Interface Configuration Mode. This command detaches the policy-map from the interface it has been bound.

867Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Quality of Service

Left running head: Chapter name (automatic)

NO SERVICE-POLICY <CHILD POLICY-MAP NAME> no service-policy <child policy-map name>

This command is entered in the Class Mode. This command deletes a policy-map as the child policy.

NO SHAPEno shape

This command is entered in the Class Mode. This command removes the configured shaping parameters.

NO TUNNEL TUNNEL BANDWIDTHno tunnel Tunnel <0-4095> bandwidth

This command is entered in the Policy-map Mode. This command removes the bandwidth configured for the tunnel interface.

NO QUEUE-LIMITno queue-limit

This command is entered in the Class Mode. This command deletes the configured queue-limit.

868

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

police

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

POLICEpolice {committed-rate <8000-10000000>} [commit-action {drop|set {ecn-ce|fr-becn|fr-de|fr-fecn|ip-dscp {<0-63>|<dscp-mnemonics>}|ip-precedence {<0-7>|<precedence-mnemonics>}|tos {<0-15>|<tos-mnemonics>}|transmit}] [committed-burst {<40-400000> exceed-action {drop|set {ecn-ce|fr-becn|fr-de|fr-fecn|ip-dscp {<0-63>|<dscp-mnemonics>}|ip-precedence {<0-7>| <precedence-mnemonics>}|tos {<0-15>|<tos-mnemonics>}|transmit}] [excess-burst {<40-400000> violate-action {drop|set {ecn-ce|fr-becn|fr-de|fr-fecn|ip-dscp {<0-63>| <dscp-mnemonics>}|ip-precedence {<0-7>|<precedence-mnemonics>}|tos {<0-15>|<tos-mnemonics>}|transmit}][peak-rate <8000-10000000>]

DESCRIPTION

This command is entered in the Class Mode. This command sets the QoS traffic policing parameters on the traffic class.

This command is entered in the Class mode. This command is used to apply policing on the traffic class. The committed-rate keyword is compulsory. The excess-burst keyword must be given if exceed-action parameter is set.

Action could be any one of the following: Drop, Transmit, Set (marks the packet either in IP-precedence or IP-DSCP fields)

PARAMETERS

DEFAULT VALUE

The default value for Commit Action is Transmit. The default value for Exceed Action is Drop. The default value for Violate Action is Drop.

PLATFORMS SUPPORTED

OmniAccess 5510-SR USG

OmniAccess 5510-TE USG

EXAMPLEALU(config-qos-P1-C1)# police committed-rate 500000 commit-action transmit committed-burst 15625 exceed-action drop

RELEASE HISTORY

Release 3.0: Parameter {fr-becn|fr-de|fr-fecn} was added.

Parameter Description

8000-10000000 Police Committed Rate.

40-400000 Police Committed Burst.

40-400000 Police Excess Burst.

8000-10000000 Police Peak rate.

869Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Quality of Service

Left running head: Chapter name (automatic)

POLICY-MAPpolicy-map <policy-map name>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure a policy map.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# policy-map P1 ALU(config-qos-P1)#

PRIORITY priority

DESCRIPTION

This command is entered in the Class Mode. Configures the traffic class as a priority class.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-qos-P1-C1)# priority

Parameter Description

policy-map name Name of the policy map.

Parameter Description

priority The second highest priority class.

870

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

priority bandwidth

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

PRIORITY BANDWIDTHpriority bandwidth {<101-70000000>|percent <1-100>}

DESCRIPTION

This command is entered in the Class Mode. This command is used to set the traffic class as a priority class and configure bandwidth for the same.

Note: You cannot mix the absolute bandwidth command with percentage bandwidth command across sibling classes.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-pmap-P1-C1)# priority bandwidth 101

Parameter Description

101-70000000 The absolute bandwidth (bps) value.

1-100 The bandwidth in percentage.

871Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Quality of Service

Left running head: Chapter name (automatic)

QOS CREDITS DEBUGqos credits debug

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to get the credits used for all the interfaces.

PARAMETERS

None.

DEFAULT VALUE

None.

EXAMPLEALU(config)# qos credits debug

QOS-PRECLASSIFYqos-preclassify

DESCRIPTION

This command is entered in the Tunnel Interface Mode. This command is used to enable pre-classification on the tunnel interface.

PARAMETERS

None.

DEFAULT VALUE

None.

EXAMPLEALU(config)# interface tunnel 1ALU(config-tunnel1)# qos-preclassify

872

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

random-detect

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

RANDOM-DETECT

Command (in Class Mode) Description

random-detect This command enables RED.

random-detect ip-dscp This command enables ip-dscp based WRED, with the default values.

random-detect ip-precedence This command enables ip-precedence based WRED, with the default values.

random-detect ip-dscp <0-63> min-thresh <50-750> max-thresh <150-950>

Use this command to change the default ip-dscp based WRED values. This command populates the WRED values but does not enable the features. To enable this, use the ‘random-detect ip-dscp’ command.

Note: The queue limit of the traffic class should be greater than the max thresh value.

random-detect ip-precedence <0-7> min-thresh <50-750> max-thresh <150-950>

Use this command to change the default ip-precedence based WRED values. This command populates the WRED values but does not enable the feature. To enable this, use the ‘random-detect ip-precedence’ command.

Note: The queue limit of the traffic class should be greater than the max thresh value.

873Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Quality of Service

Left running head: Chapter name (automatic)

PARAMETERS

DEFAULT VALUE

Note: If ip-precedence/ip-dscp based WRED is enabled and the values are not configured manually, then default values of ip-precedence and ip-dscp will be used.

DEFAULT VALUES FOR RANDOM-DETECT IP-PRECEDENCE

DEFAULT VALUES FOR RANDOM-DETECT IP-DSCP

Parameter Description

ip-dscp <0-63> min-thresh <50-150> max-thresh <150-750>

This command configures the WRED parameters; minimum threshold and maximum threshold for a particular ip-dscp.

ip-precedence <0-7> min-thresh <50-150> max-thresh <150-750>

This command configures the WRED parameters; minimum threshold, and maximum threshold particular ip-precedence.

ip-precedence Min-Threshold Max-Threshold Drop-Probability

0 50 150 10

1 60 160 10

2 70 170 10

3 80 180 10

4 90 190 10

5 100 200 10

6 110 210 10

7 120 220 10

ip-dscp Min-Threshold Max-Threshold Drop-Probability

0 50 150 10

1 30 90 10

2 30 90 10

3 30 90 10

874

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

random-detect

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

4 30 90 10

5 30 90 10

6 30 90 10

7 30 90 10

8 30 90 10

9 30 90 10

10 100 150 10

11 30 90 10

12 75 150 10

13 30 90 10

14 50 150 10

15 30 90 10

16 30 90 10

17 30 90 10

18 100 150 10

19 30 90 10

20 75 150 10

21 30 90 10

22 50 150 10

23 30 90 10

24 30 90 10

25 30 90 10

26 100 150 10

27 30 90 10

28 75 150 10

29 30 90 10

30 50 150 10

31 30 90 10

32 30 90 10

33 30 90 10

34 100 150 10

ip-dscp Min-Threshold Max-Threshold Drop-Probability

875Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Quality of Service

Left running head: Chapter name (automatic)

35 30 90 10

36 75 150 10

37 30 90 10

38 50 150 10

39 30 90 10

40 30 90 10

41 30 90 10

42 30 90 10

43 30 90 10

44 30 90 10

45 30 90 10

46 125 150 10

47 30 90 10

48 30 90 10

49 30 90 10

50 30 90 10

51 30 90 10

52 30 90 10

53 30 90 10

54 30 90 10

55 30 90 10

56 30 90 10

57 30 90 10

58 30 90 10

59 30 90 10

60 30 90 10

61 30 90 10

62 30 90 10

63 30 90 10

ip-dscp Min-Threshold Max-Threshold Drop-Probability

876

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

service-policy

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

EXAMPLEALU(config-qos-P1-C1)#random-detect ip-precedenceALU(config-qos-P1-C1)# random-detect ip-dscp 5 min-thresh 60 max-thresh max-thresh 600

SERVICE-POLICYservice-policy {in|out} <policy-map name>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to attach a policy map to an interface either in ingress or egress direction.

Note: An empty policy can be attached to the interface as a policy-map will have a default traffic class associated with it, by default.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# interface FastEthernet 0ALU(config-if FastEthernet0)# service-policy in P1Attached QoS policy P1 to the interface.

Parameter Description

in Ingress direction.

out Egress direction.

policy-map name Name of the policy map.

877Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Quality of Service

Left running head: Chapter name (automatic)

SERVICE-POLICY <CHILD POLICY-MAP NAME>service-policy <child policy-map name>

DESCRIPTION

This command is entered in the Class Mode. This command sets a policy-map as a child policy.

Note: Direction parameter is not required here.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLE

Create policies p1 and p2 and configure traffic class c1 and c2 in each of the policy.

ALU(config)# policy-map p1ALU(config-qos-p1)# class c1ALU(config-qos-p1-c1)#

ALU(config)# policy-map p2ALU(config-qos-p1)# class c2ALU(config-qos-p1-c2)#

Now, policy p2 can be included in the policy p1 using the ‘service-policy command.

ALU(config)# policy-map p1ALU(config-qos-p1)# class c1ALU(config-qos-p1-c1)# service-policy p2

Parameter Description

child policy-map name Use this to set a policy-map as a child policy.

878

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

set

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SETset {ecn-ce|fr-becn|fr-de|fr-fecn|ip-dscp {<0-63>|<dscp-mnemonics>}|ip-precedence {<0-7>|<precedence-mnemonics>}|tos {<0-15>|<tos-mnemonics>}|vlan 1p}

DESCRIPTION

This command is entered in the Class Mode. This command is used to set the

- IP Precedence/IP DSCP/ToS flags on the matched packet

- FECN, BECN, DE bits marking on the FR interface and

- 802.1p marking on the VLAN interface.

PARAMETERS

DSCP MNEMONICS

Parameter Description

0-63 DSCP value in the range 0 - 63.

dscp-mnemonics IP-DSCP mnemonics. See table below.

0-7 DSCP value in the range 0 - 63.

precedence-mnemonics IP-precedence mnemonics. See table below.

0-15 DSCP value in the range 0 - 63.

tos-mnemonics ToS mnemonics. See table below.

DSCP Mnemonics Values

default 0

cs1 8

cs2 16

cs3 24

cs4 32

cs5 40

cs6 48

cs7 56

ef 46

af11 10

af12 12

879Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Quality of Service

Left running head: Chapter name (automatic)

IP-PRECEDENCE MNEMONICS

TOS MNEMONICS

DEFAULT VALUE

None.

af13 14

af21 18

af22 20

af23 22

af31 26

af32 28

af33 30

af41 34

af42 36

af43 38

IP Precedence Mnemonics Values

routine 0

priority 1

immediate 2

flash 3

flash-override 4

critical 5

internet 6

network 7

TOS Mnemonics Values

min-delay 8

max-tput 4

max-reli 2

flash 1

normal 0

DSCP Mnemonics Values

880

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

shape

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

PLATFORMS SUPPORTED

OmniAccess 5510-SR USG

OmniAccess 5510-TE USG

EXAMPLEALU(config-qos-P1-C1)# set ip dscp af11

RELEASE HISTORY

Release 3.0: Parameter {fr-becn|fr-de|fr-fecn|vlan 1p} was added.

SHAPEshape committed-rate <8000-10000000> committed-burst <40-200000> peak-rate <8000-10000000> excess-burst <40-200000>

DESCRIPTION

This command is entered in the Class Mode. This command sets QoS shaping parameters on the policy map’s traffic class.

Note: If shape is configured on a priority class, the system gives a warning message.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-qos-P1-C1)# shape committed-rate 500000 committed-burst 7812

Parameter Description

8000-10000000 Shape Committed Rate

40-200000 Shape Committed Burst

8000-10000000 Shape Peak Rate

40-200000 Shape Excess Burst

881Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Quality of Service

Left running head: Chapter name (automatic)

SHOW AUTO QOSshow auto qos {<interface-name> [diff-serv|voip]|diff-serv|statistics [<interface-name>]|voip}

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays all/any Auto QoS configuration.

PARAMETERS

EXAMPLEALU(config)# show auto qos diff-serv

auto qos diff-serv class autoqos-class-af1 match ip any any dscp af11 match ip any any dscp af12 match ip any any dscp af13 bandwidth percent 20 queue-limit 350 random detect ip-dscp af11 min-threshold 200 max-threshold 300 random detect ip-dscp af12 min-threshold 150 max-threshold 300 random detect ip-dscp af13 min-threshold 100 max-threshold 300 random-detect ip-dscp class autoqos-class-af2 match ip any any dscp af21 match ip any any dscp af22 match ip any any dscp af23 bandwidth percent 20 queue-limit 350 random detect ip-dscp af21 min-threshold 200 max-threshold 300 random detect ip-dscp af22 min-threshold 150 max-threshold 300 random detect ip-dscp af23 min-threshold 100 max-threshold 300 random-detect ip-dscp class autoqos-class-af3 match ip any any dscp af31 match ip any any dscp af32 match ip any any dscp af33 bandwidth percent 20 queue-limit 350 random detect ip-dscp af31 min-threshold 200 max-threshold 300 random detect ip-dscp af32 min-threshold 150 max-threshold 300 random detect ip-dscp af33 min-threshold 100 max-threshold 300

Parameter Description

interface-name Displays the auto QoS configuration for a specific interface.

diff-serv Displays the Auto QoS diff-serv configuration.

voip Displays the Auto QoS VoIP configuration.

882

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show auto qos

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

random-detect ip-dscp class autoqos-class-af4 match ip any any dscp af41 match ip any any dscp af42 match ip any any dscp af43 bandwidth percent 20 queue-limit 350 random detect ip-dscp af41 min-threshold 200 max-threshold 300 random detect ip-dscp af42 min-threshold 150 max-threshold 300 random detect ip-dscp af43 min-threshold 100 max-threshold 300 random-detect ip-dscp class autoqos-class-ef match ip any any dscp ef priority police committed-rate 350000 committed-burst 30000exceed-action drop violate-action drop class class-default fair-queue

ALU(config)# show auto qos voip

auto qos voip class autoqos-voip-control-class match any tcp any any service range 1719 1720 udp any any service range 1719 1720 udp any any service range 2427 2428 tcp any any service rtsp tcp any any service range 2000 2002 udp any any service 5060 udp any any service tftp udp any any type tftp udp any any type noe network-control set ip-dscp af31 class autoqos-voip-data-class match any udp any any type rtp udp any any type rtcp priority bandwidth percent 70 set ip-dscp ef class-default fair-queue set ip-dscp default

883Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Quality of Service

Left running head: Chapter name (automatic)

SHOW CLASS-MAPshow class-map [<name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command shows all or specified class map along with its match-lists.

PARAMETERS

EXAMPLEALU# show class-map cmap1

class-map c1 match-any1 match any m1 m22 match any m2 m4 m5

Parameter Description

name Name of the class-map to be viewed.

884

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show policy-map

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW POLICY-MAPshow policy-map [<name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command shows the details of all or specified policy map configured in the system.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU# show policy-map P1

policy-map p1interface atm0.1 EGRESS 10 class cm_ef random-detect ip-dscp 20 class cm_af11 65535 class class-default

Parameter Description

name Name of the policy map whose information is to be viewed.

885Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Quality of Service

Left running head: Chapter name (automatic)

SHOW RANDOM-DETECT-DEFAULTSshow random-detect-defaults {ip-dscp|ip-precedence}

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays Random Detect default parameters.

PARAMETERS

.

EXAMPLE

ALU(config)# show random-detect-defaults ip-dscp

ip-dscp Min-Thresh Max-Thresh Drop-Probability be 50 150 10 af11 100 150 10 af12 75 150 10 af13 50 150 10 af21 100 150 10 af22 75 150 10 af23 50 150 10 af31 100 150 10 af32 75 150 10 af33 50 150 10 af41 100 150 10 af42 75 150 10 af43 50 150 10 ef 125 150 10

ALU(config)# show random-detect-defaults ip-precedence

ip-precedence Min-Thresh Max-Thresh Drop-Probability 0 50 150 10 1 60 160 10 2 70 170 10 3 80 180 10 4 90 190 10 5 100 200 10 6 110 210 10 7 120 220 10

Parameter Description

ip-dscp Shows default values for ip-dscp.

ip-precedence Shows default values for ip-precedence.

886

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show service-policy

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW SERVICE-POLICYshow service-policy [{<policy-map name>|in|out}]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the statistics for Policing/Shaping, being used in a policy.

PARAMETERS

EXAMPLEALU(config)# show service-policy p2 out

interface atm0.1service-policy out p2 Class class-default 0 packets total, 0 bytes total, 0 packets transmitted, 0 bytes transmitted, 0 packets dropped, 0 bytes dropped, Class cm_ef match-any match any ml_ef 0 packets total, 0 bytes total, 0 packets transmitted, 0 bytes transmitted, 0 packets dropped, 0 bytes dropped, RED: Class Random drops Tail drops Min.Th. Max.Th. Mark Prob. be 0 0 50 150 1/10 af11 0 0 100 150 1/10 af12 0 0 75 150 1/10 af13 0 0 50 150 1/10 af21 0 0 100 150 1/10 af22 0 0 75 150 1/10 af23 0 0 50 150 1/10 af31 0 0 100 150 1/10 af32 0 0 75 150 1/10 af33 0 0 50 150 1/10 af41 0 0 100 150 1/10 af42 0 0 75 150 1/10 af43 0 0 50 150 1/10 ef 0 0 125 150 1/10Class cm_af11 match-any match any m1_af11 0 packets total, 0 bytes total, 0 packets transmitted, 0 bytes transmitted, 0 packets dropped, 0 bytes dropped,Class L2-network-control

Parameter Description

policy-map name Name of the policy-map whose statistics details is to be viewed.

in Ingress statistics.

out Egress statistics.

887Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Quality of Service

Left running head: Chapter name (automatic)

0 packets total, 0 bytes total, 0 packets transmitted, 0 bytes transmitted, 0 packets dropped, 0 bytes dropped,

SHOW QOS CONFIGshow qos config

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command shows the configurations related to QoS.

PARAMETERS

None.

DEFAULT VALUE

None.

EXAMPLEALU# show qos config

class-map c1 match-any1 match any m1 m2class-map c2 match-any1 match any m1class-map 3 match-anyclass-map c5 match-any3 match any m1

policy-map p1 description p1 is the name of the policy map class c1 priority shape committed-rate 90000 committed-burst 6000 police committed-rate 9600 commit-action drop committed-burst 1500 exceed-action drop excess-burst 2000 violate-action transmit queue-limit 155 random-detect ip-dscp 0 min-thresh 50 max-thresh 150policy-map p2 class c2 police committed-rate 1000000 commit-action transmit committed-burst 1600 exceed-action drop excess-burst 2600 violate-action dropinterface FasttEthernet0 service-policy in p1interface atm0.1 service-policy out p1

888

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show qos running-config

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW QOS RUNNING-CONFIGshow qos running-config

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command shows the configurations related to QoS if only attached to interface(s). In particular, this command shows the following:• Policy-maps attached to interface(s).• Class-maps attached to the above list of policy-maps.• Match-lists attached to the above list of class-maps.• All the interfaces where the QoS policy is attached.

The order of display of running-config is as follows:• Match-lists• Class-maps• Policy-maps• Interfaces where the QoS policy is attached.

PARAMETERS

None.

DEFAULT VALUE

None.

EXAMPLEALU# show qos running-config

!Qos Configurations!! Use "show match-list [NAME]" to expand the match-listsmatch-list m1match-list m2

class-map c1 match-any1 match any m1 m2

policy-map p1 description p1 is the name of the policy map class c1 priority shape committed-rate 90000 committed-burst 6000 police committed-rate 9600 commit-action drop committed-burst 1500 exceed-action drop excess-burst 2000 violate-action transmit queue-limit 155 random-detect ip-dscp 0 min-thresh 50 max-thresh 150interface FastEthernet0 service-policy in p1interface atm0.1 service-policy out p1!

889Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Quality of Service

Left running head: Chapter name (automatic)

SHOW QUEUING INTERFACEshow queuing interface [<interface-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command shows all the interfaces to which the QoS service policy is attached and the name/direction of the policy.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# show queuing interface atm 0.1

interface atm0.1 service-policy in p1 description p1 is the name of the policy map class c1 priority shape committed-rate 90000 committed-burst 6000 police committed-rate 9600 commit-action drop committed-burst 1500 exceed-a queue-limit 155 random-detect ip-dscp 0 min-thresh 50 max-thresh 150

Parameter Description

interface name Name of the interface.

890

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show queuing statistics

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW QUEUING STATISTICSshow queuing statistics [{in|out}|<interface-name> {in|out}]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command shows the statistics of all or specified interfaces and traffic classes in both in and out, or for the specified direction.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# show queuing statistics

interface FastEthernet0 service-policy in t class class-default Packets dropped 0 Packets dequeued 364 Bytes dequeued 48626 class c14 Packets dropped 0 Packets dequeued 0 Bytes dequeued 0 class c15 Packets dropped 0 Packets dequeued 0 Bytes dequeued 0interface atm0.1 service-policy out t class class-default Packets dropped 0 Packets dequeued 0 Bytes dequeued 0 Queue length (Packets) 0 class c14 Packets dropped 0 Packets dequeued 0 Bytes dequeued 0 Queue length (Packets) 0 class c15

Parameter Description

interface-name Name of the interface.

in Ingress statistics.

out Egress statistics.

891Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Quality of Service

Left running head: Chapter name (automatic)

Packets dropped 0 Packets dequeued 0 Bytes dequeued 0 Queue length (Packets) 0 class L2-network-control Packets dropped 0 Packets dequeued 0 Bytes dequeued 0 Queue length (Packets) 0

TUNNELtunnel Tunnel <0-4095>

DESCRIPTION

This command is entered in the Policy-map Mode. This command is used to configure QoS over a tunnel interface.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-qos-P1)# tunnel Tunnel 1

Parameter Description

0-4095 Tunnel interface number.

892

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

tunnel bandwidth

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

TUNNEL BANDWIDTHtunnel Tunnel <0-4095> bandwidth {<101-70000000>|percent <1-100>}

DESCRIPTION

This command is entered in the Policy-map Mode. This command is used to configure bandwidth for the tunnel interface.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-pmap)# tunnel tunnel1 bandwidth percent 10

Parameter Description

0-4095 Tunnel interface number.

101-70000000 The absolute bandwidth (bps) value.

1-100 The bandwidth in percentage.

893Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Quality of Service

Left running head: Chapter name (automatic)

QUEUE-LIMITqueue-limit <10-1500>

DESCRIPTION

This command is entered in the Class Mode. This command sets a queue-limit for the scheduler for the traffic class.

Note: If the aggregate queue limit of all the traffic classes is more than 2000, in the time of congestion, input drops could be seen.

PARAMETERS

DEFAULT VALUE

By default, a traffic class will have a queue limit of 150.

EXAMPLEALU(config-qos-P1-C1)# queue-limit 155

Parameter Description

10-1500 The range of queue-limit.

894

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

QoS on FR Configuration Commands

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

QOS ON FR CONFIGURATION COMMANDS

Note: QoS on Frame Relay is supported on OmniAccess 5510-SR USG and OmniAccess 5510-TE USG. OmniAccess 5510-AA/AB USG do not support QoS on Frame Relay.

The following QoS on FR configuration commands are shown for serial (V.35/X.21/RS-232) interface as an example. The steps are similar for configuration of QoS on FR on a T1 or an E1 interface.

FRAME-RELAY QOS-BANDWIDTH PERCENTframe-relay qos-bandwidth percent <1-100>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to configure bandwidth on an interface (PVC). This configuration overrides the default bandwidth sharing.

Note: The total sum of all the bandwidth percentage on all the interface/sub-interfaces should be maximum 100 (in percent). At any point of time, the total bandwidth configuration should not exceed 100.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-if Serial0)# frame-relay qos-bandwidth percent 30

NO FRAME-RELAY QOS-BANDWIDTH PERCENTno frame-relay qos-bandwidth percent

This command is entered in the Interface Configuration Mode. This command removes the configured bandwidth on the interface.

Parameter Description

1-100 The bandwidth in percentage.

895Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Quality of Service

Left running head: Chapter name (automatic)

NO SERVICE-POLICYno service-policy {in|out} <policy-map name>

This command is entered in the Interface Configuration Mode. This command detaches the policy map from the interface.

SERVICE-POLICYservice-policy {in|out} <policy-map name>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to attach a policy map to an interface either in ingress or egress direction.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLE

In the following example, P1 is the QoS policy map.ALU(config-if Serial0)# service-policy in P1

Parameter Description

in Ingress direction.

out Egress direction.

policy-map name Name of the policy map.

896

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show qos frame-relay bandwidth-config

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW QOS FRAME-RELAY BANDWIDTH-CONFIGshow qos frame-relay bandwidth-config

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command displays the bandwidth configuration details on the FR interfaces.

PARAMETERS

None.

DEFAULT VALUE

None.

EXAMPLEALU(config)# show qos frame-relay bandwidth-config

interface Serial0 frame-relay qos-bandwidth percent 10

897Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Quality of Service

Left running head: Chapter name (automatic)

898

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

For final production, import color definitions from\\daldoc01\docteam\templates\framemaker\book-template\color-defs\ production-colors.fm. Do not import other template elements such as page layout.

To return to the draft version, import color def’ns from draft-colors.fm.To switch to the beta version, import color def’ns from beta-colors.fm

For final production, import color definitions from\\daldoc01\docteam\templates\framemaker\book-template\color-defs\ production-colors.fm. Do not import other template elements such as page layout.

To return to the draft version, import color def’ns from draft-colors.fm.To switch to the beta version, import color def’ns from beta-colors.fm

Optional footer: Manual title (to set, redefine ManualTitlevariable)

agination: umeric & ntinuous

PNco

Part 8 TCP/IP Services

Beta BetaAlcatel-Lucent

899

Beta Betawith preceding section of book

OmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Left running head: Chapter name (automatic)

900

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

DHCP (Dynamic Host Configuration Protocol) Server

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 35 DHCP (DYNAMIC HOST CONFIGURATION PROTOCOL) SERVER

This chapter documents the Command Line Interface (CLI) commands for DHCP Server.

This chapter includes table of parameters, default values, and configuration examples for DHCP Server configurations as quick-start and reference information. In this chapter, all the commands are described in alphabetical order. For more detailed information about using and configuring the DHCP Server, refer to the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

901Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

DHCP (Dynamic Host Configuration Protocol) Server

Left running head: Chapter name (automatic)

EXCLUDE IPexclude ip <ip-address>

DESCRIPTION

This command is entered in the DHCP Pool Configuration Mode. This command is used to exclude an IP address from the pool. The excluded address should exist within the configured range.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-dhcp-pool-p1)# exclude ip 1.2.3.65

Parameter Description

ip-address IP address with in the network range to be excluded.

902

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

host

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

HOST host <ip-address> <mac-address>

DESCRIPTION

This command is entered in the DHCP Pool Configuration Mode. This command is used to statically bind an IP address with a hardware (MAC) address.

Note: The IP address should exist within any of the configured network pools and should be configured in a different pool that does not contain any network.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-dhcp-pool-p2)# host 1.2.3.66 1122.aabb.55ff

Parameter Description

ip-address IP address within any of the configured network pools.

mac-address Hardware address of the host.

903Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

DHCP (Dynamic Host Configuration Protocol) Server

Left running head: Chapter name (automatic)

IP DHCP OPTION BOOTFILE-NAMEip dhcp option bootfile-name <file-name> [vrf <vrf-name>]

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure the boot file for a host.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# ip dhcp option bootfile-name boot_image

Parameter Description

file-name Name of the Boot file for a host.

vrf-name If the VRF name is specified in the commands, it configures the DHCP option for the specified VRF. If the VRF is not specified, the option is configured for the Default VRF.

904

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ip dhcp option dns-server

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IP DHCP OPTION DNS-SERVERip dhcp option dns-server <ip-address> {primary|secondary |tertiary} [vrf <vrf-name>]

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure the DNS IP address to be used by the clients.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# ip dhcp option dns-server 1.2.2.2

RELEASE HISTORY

Release 3.0: Keywords {primary|secondary|tertiary}was added.

Parameter Description

ip-address IP address of the DNS.

primary|secondary|tertiary Specify the priority for the DNS.

vrf-name If the VRF name is specified in the commands, it configures the DHCP option for the specified VRF. If the VRF is not specified, the option is configured for the Default VRF.

905Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

DHCP (Dynamic Host Configuration Protocol) Server

Left running head: Chapter name (automatic)

IP DHCP OPTION DOMAIN-NAMEip dhcp option domain-name <name> [vrf <vrf-name>]

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure the domain name to be used by the clients.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# ip dhcp option domain-name alu

Parameter Description

name Domain name to be used by the clients.

vrf-name If the VRF name is specified in the commands, it configures the DHCP option for the specified VRF. If the VRF is not specified, the option is configured for the Default VRF.

906

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ip dhcp option lease-time

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IP DHCP OPTION LEASE-TIMEip dhcp option lease-time <1-315360000> [vrf <vrf-name>]

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure the time (in seconds) for which the clients can use the IP address assigned to them.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# ip dhcp option lease-time 1000250

Parameter Description

1-315360000 Specify the time for which the clients can use the IP address assigned to them.

vrf-name If the VRF name is specified in the commands, it configures the DHCP option for the specified VRF. If the VRF is not specified, the option is configured for the Default VRF.

907Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

DHCP (Dynamic Host Configuration Protocol) Server

Left running head: Chapter name (automatic)

IP DHCP OPTION LOG SERVERip dhcp option log-server <ip-address> [vrf <vrf-name>]

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure the MIT-LCS UDP log server IP address to be used by the clients.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# ip dhcp option log-server 1.1.1.1

Parameter Description

ip-address IP address of the log server.

vrf-name If the VRF name is specified in the commands, it configures the DHCP option for the specified VRF. If the VRF is not specified, the option is configured for the Default VRF.

908

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ip dhcp option next-server

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IP DHCP OPTION NEXT-SERVERip dhcp option next-server <ip-address> [vrf <vrf-name>]

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure the IP address of the Network Time Protocol server to be used by the clients.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# ip dhcp option next-server 1.1.1.2

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

ip-address IP address of the next server.

vrf-name If the VRF name is specified in the commands, it configures the DHCP option for the specified VRF. If the VRF is not specified, the option is configured for the Default VRF.

909Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

DHCP (Dynamic Host Configuration Protocol) Server

Left running head: Chapter name (automatic)

IP DHCP OPTION NTP SERVERip dhcp option ntp-server <ip-address> [vrf <vrf-name>]

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure the IP address of the Network Time Protocol server to be used by the clients.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# ip dhcp option ntp-server 1.1.1.1

Parameter Description

ip-address IP address of the Network Time Protocol server.

vrf-name If the VRF name is specified in the commands, it configures the DHCP option for the specified VRF. If the VRF is not specified, the option is configured for the Default VRF.

910

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ip dhcp option routers

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IP DHCP OPTION ROUTERSip dhcp option routers <ip-address> [vrf <vrf-name>]

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure the router in the subnet for which the DHCP is configured.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# ip dhcp option routers 1.1.1.1

Parameter Description

ip-address IP address of the router.

vrf-name If the VRF name is specified in the commands, it configures the DHCP option for the specified VRF. If the VRF is not specified, the option is configured for the Default VRF.

911Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

DHCP (Dynamic Host Configuration Protocol) Server

Left running head: Chapter name (automatic)

IP DHCP OPTION SUBNET-MASKip dhcp option subnet-mask <subnet-mask> [vrf <vrf-name>]

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure the client's subnet mask.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# ip dhcp option subnet-mask 255.255.255.0

Parameter Description

subnet-mask Subnet mask for the pool.

vrf-name If the VRF name is specified in the commands, it configures the DHCP option for the specified VRF. If the VRF is not specified, the option is configured for the Default VRF.

912

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ip dhcp option tftp-server

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IP DHCP OPTION TFTP-SERVERip dhcp option tftp-server <string> [vrf <vrf-name>]

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure the IP address/domain name of the TFTP server.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# ip dhcp option tftp-server 3.2.2.1

Parameter Description

string IP address/domain name of the TFTP server.

vrf-name If the VRF name is specified in the commands, it configures the DHCP option for the specified VRF. If the VRF is not specified, the option is configured for the Default VRF.

913Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

DHCP (Dynamic Host Configuration Protocol) Server

Left running head: Chapter name (automatic)

IP DHCP OPTION TIME-OFFSETip dhcp option time-offset <1-315360000> [vrf <vrf-name>]

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to determine the time variation from GMT (in seconds).

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# ip dhcp option time-offset 100

OPTION BOOTFILE-NAMEoption bootfile-name <file-name>

DESCRIPTION

This command is entered in the DHCP Pool Configuration Mode. This command is used to configure the boot file for a host.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-dhcp-pool-p1)# option bootfile-name boot_image

Parameter Description

1-315360000 Time variation in seconds.

vrf-name If the VRF name is specified in the commands, it configures the DHCP option for the specified VRF. If the VRF is not specified, the option is configured for the Default VRF.

Parameter Description

file-name Name of the Boot file for a host.

914

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

option dns-server

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

OPTION DNS-SERVERoption dns-server <ip-address> {primary|secondary|tertiary}

DESCRIPTION

This command is entered in the DHCP Pool Configuration Mode. This command is used to configure the Domain Name Server IP address to be used by the clients.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-dhcp-pool-p1)# option dns-server 1.2.2.2 primary

OPTION DOMAIN-NAMEoption domain-name <name>

DESCRIPTION

This command is entered in the DHCP Pool Configuration Mode. This command is used to configure the domain name to be used by the clients.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-dhcp-pool-p1)# option domain-name alu

Parameter Description

ip-address IP address of the DNS.

primary|secondary|tertiary Specify the priority for the DNS.

Parameter Description

name Domain name to be used by the clients.

915Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

DHCP (Dynamic Host Configuration Protocol) Server

Left running head: Chapter name (automatic)

OPTION LEASE-TIMEoption lease-time <1-315360000>

DESCRIPTION

This command is entered in the DHCP Pool Configuration Mode. This command is used to configure the time (in seconds) for which a client can use the IP address assigned to it.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-dhcp-pool-p1)# option lease-time 106400

OPTION LOG SERVERoption log-server <ip-address>

DESCRIPTION

This command is entered in the DHCP Pool Configuration Mode. This command is used to configure the MIT-LCS UDP log server IP address to be used by the clients.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-dhcp-pool-p1)# option log-server 1.1.1.1

Parameter Description

1-315360000 Specify the time for which a client can use the IP address assigned to it.

Parameter Description

ip-address IP address of the log server.

916

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

option next-server

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

OPTION NEXT-SERVERoption next-server <ip-address>

DESCRIPTION

This command is entered in the DHCP Pool Configuration Mode. This command is used to configure the next server in the bootstrap process to be used by the clients.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-dhcp-pool-p1)# option next-server 1.1.1.2

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

ip-address IP address of the next server.

917Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

DHCP (Dynamic Host Configuration Protocol) Server

Left running head: Chapter name (automatic)

OPTION NTP SERVERoption ntp-server <ip-address>

DESCRIPTION

This command is entered in the DHCP Pool Configuration Mode. This command is used to configure the IP address of the Network Time Protocol server to be used by the clients.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-dhcp-pool-p1)# option ntp-server 1.1.1.1

OPTION ROUTERSoption routers <ip-address>

DESCRIPTION

This command is entered in the DHCP Pool Configuration Mode. This command is used to configure the router in the subnet for which the DHCP is configured.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-dhcp-pool-p1)# option routers 1.1.1.1

Parameter Description

ip-address IP address of the Network Time Protocol server.

Parameter Description

ip-address IP address of the router.

918

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

option subnet-mask

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

OPTION SUBNET-MASKoption subnet-mask <subnet-mask>

DESCRIPTION

This command is entered in the DHCP Pool Configuration Mode. This command is used to configure the client's subnet mask.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-dhcp-pool-p1)# option subnet-mask 255.255.255.0

OPTION TFTP-SERVERoption tftp-server <string>

DESCRIPTION

This command is entered in the DHCP Pool Configuration Mode. This command is used to configure the IP address/domain name of the TFTP server.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-dhcp-pool-p1)# option tftp-server 3.2.2.1

Parameter Description

subnet-mask Subnet mask for the pool.

Parameter Description

string IP address/domain name of the TFTP server.

919Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

DHCP (Dynamic Host Configuration Protocol) Server

Left running head: Chapter name (automatic)

OPTION TIME-OFFSEToption time-offset <1-315360000>

DESCRIPTION

This command is entered in the DHCP Pool Configuration Mode. This command is used to determine the time variation from GMT (in seconds).

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-dhcp-pool-p1)# option time-offset 100

Parameter Description

1-315360000 Time variation in seconds.

920

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ip dhcp pool

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IP DHCP POOLip dhcp pool <pool-name> [vrf <vrf-name>]

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure a DHCP pool. This command enters the DHCP pool sub-configuration mode.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# ip dhcp pool p1 vrf alu-vrfALU(config-dhcp-pool-p1)#

Parameter Description

pool-name Name of the pool. The pool name should be unique across the system.

vrf-name If the VRF name is specified, it configures the DHCP pool in the specified VRF. If the VRF is not specified, the pool is configured for the Default VRF.

921Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

DHCP (Dynamic Host Configuration Protocol) Server

Left running head: Chapter name (automatic)

NETWORKnetwork {<ip-address subnet-mask>|<ip-address/prefix-length>}

DESCRIPTION

This command is entered in the DHCP Pool Configuration Mode. This command is used to specify the network to which the pool belongs to.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-dhcp-pool-p1)# network 1.2.3.0/24

NO HOSTno host <ip-address> <mac-address>

This command is entered in the DHCP Pool Configuration Mode. Deletes the manual binding between the host and IP address specified for it.

NO IP DHCP OPTION BOOTFILE-NAMEno ip dhcp option bootfile-name <file-name> [vrf <vrf-name>]

This command is entered in the Configuration Mode. Deletes the configured the boot file for a host.

NO IP DHCP OPTION DNS-SERVERno ip dhcp option dns-server <ip-address> {primary|secondary|tertiary} [vrf <vrf-name>]

This command is entered in the Configuration Mode. Deletes the configured DNS IP address.

NO IP DHCP OPTION DOMAIN-NAMEno ip dhcp option domain-name <name> [vrf <vrf-name>]

This command is entered in the Configuration Mode. Deletes the configured domain name.

Parameter Description

{<ip-address subnet-mask>|<ip-address/prefix-length>}

IP address with subnet mask or prefix length.

922

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

no ip dhcp option lease-time

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NO IP DHCP OPTION LEASE-TIMEno ip dhcp option lease-time <1-315360000> [vrf <vrf-name>]

This command is entered in the Configuration Mode. Deletes the configured lease time.

NO IP DHCP OPTION LOG-SERVERno ip dhcp option log-server <ip-address> [vrf <vrf-name>]

This command is entered in the Configuration Mode. Deletes the configured log server IP address.

NO IP DHCP OPTION NEXT-SERVERno ip dhcp option next-server <ip-address> [vrf <vrf-name>]

This command is entered in the Configuration Mode. Deletes the configured next server IP address.

NO IP DHCP OPTION NTP-SERVERno ip dhcp option ntp-server <ip-address> [vrf <vrf-name>]

This command is entered in the Configuration Mode. Deletes the configured IP address of the Network Time Protocol server.

NO IP DHCP OPTION ROUTERSno ip dhcp option routers <ip-address> [vrf <vrf-name>]

This command is entered in the Configuration Mode. Deletes the configured router in the subnet for which the DHCP has been configured.

NO IP DHCP OPTION SUBNET-MASKno ip dhcp option subnet-mask <subnet-mask> [vrf <vrf-name>]

This command is entered in the Configuration Mode. Deletes the configured subnet mask for the pool.

NO IP DHCP OPTION TFTP-SERVERno ip dhcp option tftp-server <string> [vrf <vrf-name>]

This command is entered in the Configuration Mode. Deletes the configured IP address/domain name of the TFTP server.

NO IP DHCP OPTION TIME-OFFSETno ip dhcp option time-offset <1-315360000> [vrf <vrf-name>]

This command is entered in the Configuration Mode. Deletes the configured time offset.

923Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

DHCP (Dynamic Host Configuration Protocol) Server

Left running head: Chapter name (automatic)

NO OPTION BOOTFILE-NAMEno option bootfile-name <file-name>

This command is entered in the DHCP Pool Configuration Mode. Deletes the configured the boot file for a host.

NO OPTION DNS-SERVERno option dns-server <ip-address> {primary|secondary|tertiary}

This command is entered in the DHCP Pool Configuration Mode. Deletes the configured DNS IP address.

NO OPTION DOMAIN-NAMEno option domain-name <name>

This command is entered in the DHCP Pool Configuration Mode. Deletes the configured domain name.

NO OPTION LEASE-TIMEno option lease-time <1-315360000>

This command is entered in the DHCP Pool Configuration Mode. Deletes the configured lease time.

NO OPTION LOG-SERVERno option log-server <ip-address>

This command is entered in the DHCP Pool Configuration Mode. Deletes the configured log server IP address.

NO OPTION NEXT-SERVERno option next-server <ip-address> [vrf <vrf-name>]

This command is entered in the DHCP Pool Configuration Mode. Deletes the configured next server IP address.

NO OPTION NTP-SERVERno option ntp-server <ip-address>

This command is entered in the DHCP Pool Configuration Mode. Deletes the configured IP address of the Network Time Protocol server.

NO OPTION ROUTERSno option routers <ip-address>

This command is entered in the DHCP Pool Configuration Mode. Deletes the configured router in the subnet for which the DHCP has been configured.

924

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

no option subnet-mask

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NO OPTION SUBNET-MASKno option subnet-mask <subnet-mask>

This command is entered in the DHCP Pool Configuration Mode. Deletes the configured subnet mask for the pool.

NO OPTION TFTP-SERVERno option tftp-server <string>

This command is entered in the DHCP Pool Configuration Mode. Deletes the configured IP address/domain name of the TFTP server.

NO OPTION TIME-OFFSETno option time-offset <1-315360000>

This command is entered in the DHCP Pool Configuration Mode. Deletes the configured time offset.

NO IP DHCP POOLno ip dhcp pool <pool-name>

This command is entered in the Configuration Mode. Deletes a configured DHCP pool.

NO NETWORKno network {<ip-address subnet-mask>|<ip-address/prefix-length>}

This command is entered in the DHCP Pool Configuration Mode. Deletes a configured network pool.

NO RANGEno range {<lower ip-address> <higher ip-address>|<automatic>}

This command is entered in the DHCP Pool Configuration Mode. Deletes a configured network range.

925Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

DHCP (Dynamic Host Configuration Protocol) Server

Left running head: Chapter name (automatic)

RANGErange {<lower ip-address> <higher ip-address>|<automatic>}

DESCRIPTION

This command is entered in the DHCP Pool Configuration Mode.

This command is used to configure the range of IP addresses within the network of the pool, which are used to service DHCP requests from the clients.

Specification of range is mandatory for a network pool. The range cannot include the network address and the broadcast address of the network.

Note: The network configuration for a pool must exist before a range can be specified.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-dhcp-pool-p1)# range 1.2.3.50 1.2.3.100

ALU(config-dhcp-pool-p1)# range automatic

Parameter Description

<lower ip-address> <higher ip-address>

Lower and the upper addresses of the network range.

automatic Specify entire network addresses to be available to the client.

926

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

service dhcp enable

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SERVICE DHCP ENABLEservice dhcp enable

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to enable the DHCP service on OmniAccess 5510 USG.

Note: Enabling DHCP service disables DHCP relay.

PARAMETERS

DEFAULT VALUE

By default, DHCP service is disabled.

EXAMPLEALU(config)# service dhcp enableService DHCP enabled successfully

SERVICE DHCP DISABLEservice dhcp disable

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to disable the DHCP service on OmniAccess 5510 USG.

PARAMETERS

DEFAULT VALUE

By default, DHCP service is disabled.

EXAMPLEALU(config)# service dhcp disableService DHCP disabled successfully

Parameter Description

enable Enable the DHCP service.

Parameter Description

disable Disable the DHCP service.

927Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

DHCP (Dynamic Host Configuration Protocol) Server

Left running head: Chapter name (automatic)

SHOW IP DHCP BINDINGSshow ip dhcp bindings [{dynamic|manual|pool <name>}] [vrf <vrf-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command shows all the assigned leases (the IP addresses allocated to the hosts.)

PARAMETERS

EXAMPLEALU(config)# show ip dhcp bindings

IP Address Hardware Address Lease Expiration Type Pool========== ================ ================ ===== ====10.91.2.87 00:0f:fe:3a:63:da Wed Jan 17 23:38:11 2007 DYNAMIC p1203.196.196.74 00:0f:ef:3b:63:de INFINITE MANUAL p2

ALU(config)# show ip dhcp bindings dynamic

IP Address Hardware Address Lease Expiration Type Pool========== ================= ======================== ======= =====10.91.2.87 00:0f:fe:3a:63:da Wed Jan 17 23:38:11 2007 DYNAMIC p1

Parameter Description

dynamic Shows all the dynamically assigned leases of all the pools.

manual Shows all the manually linked leases.

pool <name> Shows all the assigned leases for a specific pool (dynamic/manual).

vrf-name If the VRF name is specified, it displays the bindings for the specified VRF. If the VRF is not specified, the bindings are displayed for the Default VRF.

928

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip dhcp options

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW IP DHCP OPTIONSshow ip dhcp options [vrf <vrf-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command shows all the DHCP global options configured.

PARAMETERS

EXAMPLEALU(config)# show ip dhcp options

Routers : 1.1.1.1Domain Name Server : 1.2.2.2Log Server : 1.1.1.1NTP Server : 1.1.1.1ALU(config)#

Parameter Description

vrf-name If the VRF name is specified, it displays the DHCP global options for the specified VRF. If no VRF is specified, the options are displayed for the Default VRF.

929Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

DHCP (Dynamic Host Configuration Protocol) Server

Left running head: Chapter name (automatic)

SHOW IP DHCP POOLSshow ip dhcp pools [<pool-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command shows all the pools and their configured options.

PARAMETERS

EXAMPLEALU(config)# show ip dhcp pools

Pool Name : p2Pool Host Address : 1.2.3.66Pool Host Mac Address : 11:22:aa:bb:55:ff

Pool Name : p1Pool Network Number : 1.2.3.0Pool Network Mask : 255.255.255.0Number of leases : 50Pool Range : 1.2.3.50 / 1.2.3.100Boot-File Name : boot_image

ALU(config)# show ip dhcp pools p2

Pool Name : p2Pool Host Address : 1.2.3.66Pool Host Mac Address : 11:22:aa:bb:55:ff

Parameter Description

pool-name Shows the details of only the specified pool name.

vrf-name If the VRF name is specified, it displays all the pools and their options configured for the specified VRF. If the VRF is not specified, it displays all the pools and their options configured for the Default VRF.

930

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip dhcp server statistics

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW IP DHCP SERVER STATISTICSshow ip dhcp server statistics

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command shows the DHCP server statistics.

PARAMETERS

None.

EXAMPLEALU(config)# show ip dhcp server statistics

Message ReceivedDHCPDISCOVER 0DHCPREQUEST 14DHCPDECLINE 0DHCPRELEASE 0DHCPINFORM 8

Message SentDHCPOFFER 0DHCPACK 0DHCPNAK 0

931Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

DHCP (Dynamic Host Configuration Protocol) Server

Left running head: Chapter name (automatic)

932

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

DHCP (Dynamic Host Configuration Protocol) Client

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 36 DHCP (DYNAMIC HOST CONFIGURATION PROTOCOL) CLIENT

This chapter documents the Command Line Interface (CLI) commands for DHCP (Dynamic Host Configuration Protocol) Client configuration.

This chapter includes table of parameters, default values, and configuration examples for DHCP Client as quick-start and reference information. In this chapter, all the commands are described in alphabetical order. For more detailed information about using and configuring the DHCP Client, refer to the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

933Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

DHCP (Dynamic Host Configuration Protocol) Client

Left running head: Chapter name (automatic)

CLIENT-IDclient-id <identifier>

DESCRIPTION

This command is entered in the DHCP Client Configuration Object Mode. This command is used to configure the client identifier option for a client object.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config–dhcp-client-client1)# client-id client123

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

identifier Specify the client identifier option for a client object.

934

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

dhcp client

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

DHCP CLIENTdhcp client <client-name>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to attach a DHCP client object on an interface.

Note: At any given point of time, if a DHCP client object attached to an interface is modified, the changes will not take effect automatically. For this, you need to reattach the DHCP client object on the interface.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-if FastEthernet0)# dhcp client client1

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

client-name DHCP client object name.

935Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

DHCP (Dynamic Host Configuration Protocol) Client

Left running head: Chapter name (automatic)

IP DHCP CLIENTip dhcp client <client-name>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to create a DHCP client object. This enters the DHCP client object configuration mode.

This object is associated with an interface to apply the defined configuration (in the object) to the interface and start DHCP negotiation.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# ip dhcp client client1ALU(config-dhcp-client-client1)#

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

client-name DHCP client object name.

936

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ip dhcp client option hostname

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IP DHCP CLIENT OPTION HOSTNAMEip dhcp client option hostname <host-name>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure the host name option to be used in the DHCP client requests.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# ip dhcp client option hostname myhost

RELEASE HISTORY

Release 3.0: command was introduced.

NO CLIENT-IDno client-id <identifier>

This command is entered in the DHCP Client Configuration Object Mode. This command is used to remove the client identifier option configured for a client object.

NO DHCP CLIENTno dhcp client <client-name>

This command is entered in the Interface Configuration Mode. This command is used to detach the client object from an interface.

NO IP DHCP CLIENTno ip dhcp client <client-name>

This command is entered in the Configuration Mode. This command is used to delete a DHCP client object. When a client object is deleted, all the attributes configured for a DHCP client object will also be deleted.

Parameter Description

host-name Host name of the DHCP client to be configured on the interface.

937Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

DHCP (Dynamic Host Configuration Protocol) Client

Left running head: Chapter name (automatic)

NO IP DHCP CLIENT OPTION HOSTNAMEno ip dhcp client option hostname <host-name>

This command is entered in the Interface Configuration Mode. This command is used to delete the host name option used by the DHCP client.

NO PARAMETER-REQ-LISTno parameter-req-list {bootfile-name|classless-static-routes |lease-time|ntp-server|rebinding-time|renewal-time| routers|server-identifier|sip-server|subnet-mask|tftp-server-addr|tftp-server-name|vendor-specific}

This command is entered in the DHCP Client Configuration Object Mode. This command is used to delete a DHCP parameter request list option from the client object.

NO REQUESTED-ADDRESSno requested-address <ip-address>

This command is entered in the DHCP Client Configuration Object Mode. This command is used to delete the requested IP address from client object configuration.

NO REQUEST-TYPEno request-type {address|inform}

This command is entered in the DHCP Client Configuration Object Mode. This command is used to delete the configured type of request, and sets it to default. The default request type is 'address'.

NO USER-CLASSno user-class <user-class-suboption>

This command is entered in the DHCP Client Configuration Object Mode. This command is used to delete user class sub-option from the DHCP client object.

NO VENDOR-CLASS-IDENTIFIERno vendor-class-identifier <identifier>

This command is entered in the DHCP Client Configuration Object Mode. This command is used to delete the vendor class identifier option configured for a client object.

938

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

parameter-req-list

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

PARAMETER-REQ-LISTparameter-req-list {bootfile-name|classless-static-routes |lease-time|ntp-server|rebinding-time|renewal-time|routers |server-identifier|sip-server|subnet-mask|tftp-server-addr|tftp-server-name|vendor-specific}

DESCRIPTION

This command is entered in the DHCP Client Configuration Object Mode. This command is used to create a DHCP parameter request list option. You can configure request for multiple DHCP options in the list.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config–dhcp-client-client1)# parameter-req-list bootfile-name

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

bootfile-name|classless-static-routes|lease-time|ntp-server|rebinding-time|renewal-time|routers|server-identifier |sip-server|subnet-mask|tftp-server-addr|tftp-server-name |vendor-specific}

Specify the DHCP option to be obtained from the server in the parameter-req-list.

939Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

DHCP (Dynamic Host Configuration Protocol) Client

Left running head: Chapter name (automatic)

REQUESTED-ADDRESSrequested-address <ip-address>

DESCRIPTION

This command is entered in the DHCP Client Configuration Object Mode. This command is used to configure the DHCP option 'requested-address'. Client sends this option to the server to request a specific IP address from the server.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config–dhcp-client-client1)# requested-address 10.10.10.10

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

ip-address Specify the IP address requested from the server.

940

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

request-type

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

REQUEST-TYPErequest-type {address|inform}

DESCRIPTION

This command is entered in the DHCP Client Configuration Object Mode. This command is used to configure the type of request the client should send to the server.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config–dhcp-client-client1)# request-type address

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

address Specifies that the client should get the IP address and the DHCP options from the DHCP server.

inform Specifies that the client should request the DHCP server to send only the DHCP options and no IP address assignment.

941Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

DHCP (Dynamic Host Configuration Protocol) Client

Left running head: Chapter name (automatic)

SHOW IP DHCP CLIENTshow ip dhcp client [<client-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command shows the entire DHCP client related configuration. This includes DHCP global configurations, all DHCP client objects and their association with interfaces.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show ip dhcp client

Hostname : myhost-------------------------------------------Client_name : testVendor_class_id : test1-------------------------------------------Client_name : client1Vendor_class_id : broadband-forum.orgRequest_type : addressClient_id : client123Requested_address : 10.10.10.1Parameter_request_list : bootfile-nameInterfaces : FastEthernet0-------------------------------------------

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

client-name Specify the client object name to display the DHCP configuration for a specific DHCP client object.

942

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip dhcp client status

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW IP DHCP CLIENT STATUSshow ip dhcp client status [interface <interface-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command shows the configurations learned dynamically from the DHCP server for all the interfaces or a specific interface.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show ip dhcp client status

domain-serveraddress : 4.4.5.5vrfid : 0domain-serveraddress : 4.5.6.7vrfid : 0domain-serveraddress : 5.6.7.8vrfid : 0domain-name : www.alcatel.comntp-server : 4.4.5.5***** FastEthernet0 *****address : 61.0.0.250subnet-mask : 255.255.255.0router : 1.1.1.1lease-time : 60server-identifier : 61.0.0.2dhcp-renewal-time : 30dhcp-rebinding-time : 52tftp-server-name : tftp.alcatel.combootfile-name : blablaAaluA12345message-type : 5

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

interface-name Name of the interface.

943Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

DHCP (Dynamic Host Configuration Protocol) Client

Left running head: Chapter name (automatic)

USER-CLASSuser-class <user-class-suboption>

DESCRIPTION

This command is entered in the DHCP Client Configuration Object Mode. This command is used to configure the user class option of the client. User class sub option can be one word or sequence of words. A sub option identifies the user class of the client to the server.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config–dhcp-client-client1)# user-class userclass1

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

user-class-suboption User class sub option.

944

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

vendor-class-identifier

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

VENDOR-CLASS-IDENTIFIERvendor-class-identifier <identifier>

DESCRIPTION

This command is entered in the DHCP Client Configuration Object Mode. This command is used to configure the vendor class identifier option for a client object. This is used by the client to send its vendor information to the server.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-dhcp-client-client1)# vendor-class-identifier broadband-forum.org

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

identifier Vendor class identifier.

945Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

DHCP (Dynamic Host Configuration Protocol) Client

Left running head: Chapter name (automatic)

946

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

TFTP (Trivial File Transfer Protocol) Server

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 37 TFTP (TRIVIAL FILE TRANSFER PROTOCOL) SERVER

This chapter documents the Command Line Interface (CLI) commands for TFTP Server.

This chapter includes table of parameters, default values, and configuration examples for TFTP Server configurations as quick-start and reference information. In this chapter, all the commands are described in alphabetical order. For more detailed information about using and configuring the TFTP Server, refer to the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

Note: Currently, we do not support uploading of files to the TFTP server running on OmniAccess 5510 USG.

947Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

TFTP (Trivial File Transfer Protocol) Server

Left running head: Chapter name (automatic)

NO TFTP-SERVERno tftp-server {<filename with path>|alias <file-alias>}

This command is entered in the Configuration Mode. This command is used to remove the file from the tftp file-list. If a file is removed from the tftp-file list, then all its aliases are also removed.

SHOW TFTP FILESshow tftp files

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command shows the list of files configured for download through the TFTP server.

PARAMETERS

None.

EXAMPLEALU(config)# show tftp files

TFTP-File Alias----------------------------------------------------/a N.A./tftpd N.A./voip/www/voip/update.php N.A./voip/www/voip/update.php voiptest

948

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

tftp-server disable

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

TFTP-SERVER DISABLEtftp-server disable

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to disable the TFTP service on OmniAccess 5510 USG.

PARAMETERS

DEFAULT VALUE

By default, the TFTP service is disabled.

EXAMPLEALU(config)# tftp-server disable

TFTP-SERVER ENABLEtftp-server enable

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to enable the TFTP service on OmniAccess 5510 USG.

PARAMETERS

DEFAULT VALUE

By default, TFTP service is disabled.

EXAMPLEALU(config)# tftp-server enable

Parameter Description

disable Disable the TFTP service.

Parameter Description

enable Enable the TFTP service.

949Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

TFTP (Trivial File Transfer Protocol) Server

Left running head: Chapter name (automatic)

TFTP-SERVERtftp-server <filename with path> [alias <file-alias>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to specify files allowed for download through the TFTP server.

Using the 'alias' keyword, you can create an alias for the file. You can then download the file through this alias, instead of its actual path. This could be useful if the file's name or path is tedious. A file can have multiple aliases.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# tftp-server voip/www/voip/update.php alias voiptest

Parameter Description

filename with path Specify the path of the files allowed for download through the TFTP server.

file-alias User friendly name given to the file allowed for download.

950

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

DHCP (Dynamic Host Configuration Protocol) Relay

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 38 DHCP (DYNAMIC HOST CONFIGURATION PROTOCOL) RELAY

This chapter documents the Command Line Interface (CLI) commands for DHCP Relay.

This chapter includes table of parameters, default values, and configuration examples for DHCP Relay as quick-start and reference information. In this chapter, all the commands are described in alphabetical order. For more detailed information about using and configuring the DHCP Relay, refer to the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

951Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

DHCP (Dynamic Host Configuration Protocol) Relay

Left running head: Chapter name (automatic)

IP DHCP RELAYip dhcp relay <dhcp server ip-address>

DESCRIPTION

This command is entered in the Interface Configuration Mode.

This command is used to specify the DHCP server to which the DHCP requests are to be forwarded. A maximum of four DHCP relay destinations can be configured per interface.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-if FastEthernet0)# ip dhcp relay 192.168.1.1

IP DHCP RELAY INTERFACEip dhcp relay interface <interface-name>

DESCRIPTION

This command is entered in the Interface Configuration Mode.

This command is used to configure the interface through which the DHCP relay requests have to be rebroadcasted.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config-if FastEthernet0)# ip dhcp relay interface vlan 10

Parameter Description

dhcp server ip-address IP address of the DHCP server.

Parameter Description

interface-name The interface through which the DHCP relay requests have to be rebroadcasted.

952

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

no ip dhcp relay

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NO IP DHCP RELAYno ip dhcp relay [<dhcp server ip-address>]

This command is entered in the Interface Configuration Mode. This command is used to disable all/a specific relay configured on an interface.

NO IP DHCP RELAY INTERFACEno ip dhcp relay interface <interface-name>

This command is entered in the Interface Configuration Mode. This command is used to disable the relay of DHCP requests to the specified interface.

SHOW IP DHCP RELAYshow ip dhcp relay [<interface-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command shows the DHCP Relay configuration of all/an interface.

PARAMETERS

EXAMPLEALU(config)# show ip dhcp relay

Interface Relay destinationFastEthernet0 192.168.1.1FastEthernet0 vlan10

Parameter Description

interface-name Shows the DHCP Relay configuration on the specified interface.

953Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

DHCP (Dynamic Host Configuration Protocol) Relay

Left running head: Chapter name (automatic)

954

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

DNS (Domain Name Service) Client

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 39 DNS (DOMAIN NAME SERVICE) CLIENT

This chapter documents the Command Line Interface (CLI) commands for DNS Client.

This chapter includes table of parameters, default values, and configuration examples for DNS Client as quick-start and reference information. In this chapter, all the commands are described in alphabetical order. For more detailed information about using and configuring the DNS Client, refer to the OmniAccess 5510 ADSL Unified Services Gateway CLI Configuration Guide.

955Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

DNS (Domain Name Service) Client

Left running head: Chapter name (automatic)

CLEAR HOSTclear host {*|<host-name>}

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command clears the dynamically learnt name/address mapping, or all such mappings if "*" is specified.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# clear host *

IP DOMAIN-LISTip domain-list <name>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to add domain names to the domain-list.

These are the domain names, which are to be appended to the host names while lookup. By default, the default domain-name is used. The domain names added in the list are probed in order.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# ip domain-list test

Parameter Description

* All the dynamically learned entries are deleted.

host-name Deletes dynamically learned host-name.

Parameter Description

name Domain name to be added to the domain list.

956

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ip domain-lookup

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IP DOMAIN-LOOKUPip domain-lookup

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to enable the system to query the name server (s) for name/address translation.

PARAMETERS

None.

DEFAULT VALUE

By default, domain lookup is enabled.

EXAMPLEALU(config)# ip domain-lookup

IP DOMAIN-NAMEip domain-name <name>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure the default domain name, which is used in domain lookup.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# ip domain-name abc.com

Parameter Description

name Default domain name.

957Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

DNS (Domain Name Service) Client

Left running head: Chapter name (automatic)

IP HOSTip host <name> <ip-address>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to add a static address mapping for a specific host.

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# ip host google.com 64.233.187.99

IP HOST-MAX-AGEip host-max-age <30-31556952>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure the maximum time (in seconds) for which the dynamic host entries will be stored in DNS client cache.

Host entries will be stored for a time, which is the minimum of the configured host-max-age or the DNS TTL received from the name server. If the DNS TTL is 100 seconds, and the host-max-age is 300 seconds, the entries are stored only for 100 seconds.

PARAMETERS

DEFAULT VALUE

The default host-max-age is 300 seconds.

EXAMPLEALU(config)# ip host-max-age 100

Parameter Description

name Name of the host.

ip-address IP address of the host.

Parameter Description

30-31556952 This indicates the maximum time (in seconds) for which the dynamic host entries will be stored in DNS client cache.

958

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ip name-server

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IP NAME-SERVERip name-server [vrf <vrf-name>] <ip-address...> [{prefer |primary|secondary|tertiary}]

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to specify the address of one or more name servers to be used for name and address resolution. Also, you can add a name server to a specific VRF to which the resolution requests are be sent.

You can add maximum of three name servers, and specify the order of preference to them individually - Primary, Secondary, Tertiary.

Primary is tried first, then the Secondary, and lastly Tertiary. Secondary and tertiary name servers are tried only when the query sent to the primary server is not successful. "Prefer" is the same as "primary".

PARAMETERS

DEFAULT VALUE

None.

EXAMPLEALU(config)# ip name-server 1.1.1.1 1.1.1.2 1.1.1.3

ALU(config)# ip name-server 1.1.1.1 primary

Parameter Description

vrf-name Name of the VRF.

ip-address IP address of the name server.

prefer Set the name server as the preferred server.

primary Set the name server as the primary server.

secondary Set the name server as the secondary server.

tertiary Set the name server as the tertiary server.

959Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

DNS (Domain Name Service) Client

Left running head: Chapter name (automatic)

NO IP DOMAIN-LISTno ip domain-list <name>

This command is entered in the Configuration Mode. This command is used to delete an entire domain list or a specific domain name from the domain list.

NO IP DOMAIN-LOOKUPno ip domain-lookup

This command is entered in the Configuration Mode.This command is used to disable the domain lookup.

NO IP DOMAIN-NAMEno ip domain-name <name>

This command is entered in the Configuration Mode. This command is used to remove the default domain name.

NO IP HOSTno ip host <name> [<ip-address>]

This command is entered in the Configuration Mode. This command is used to remove a static address mapping for a host. If the address is specified, the removal is successful only if the exact mapping exists.

NO IP HOST-MAX-AGEno ip host-max-age <30-31556952>

This command is entered in the Configuration Mode.This command deletes the configured a host-max-age, and resets to its default.

NO IP NAME-SERVERno ip name-server <ip-address...> [{prefer|primary|secondary |tertiary}]

This command is entered in the Configuration Mode. This command is used to remove a name server. If the ordinal is specified, the removal is only successful if the given address is in that ordinal location.

960

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

nslookup

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NSLOOKUPnslookup {<ip-address>|<host-name>}

DESCRIPTION

This command is entered in the Configuration Mode. This command can be used for reverse DNS lookup, i.e., to translate DNS name to an IP address or vice-versa.

PARAMETERS

EXAMPLEALU(config)# nslookup www.google.com

SHOW HOSTSshow hosts

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command shows all the configuration parameters, and all learned name/address mappings.

PARAMETERS

None.

EXAMPLEALU(config)# show hosts

Default domain is abc.comDomain list: test1, testName/address lookup uses domain serviceName server(s): 1.1.1.1, 1.1.1.2, 1.1.1.3Dynamic host maximum age (seconds): 300

Address Type TTL Name--------------- ------- ----- ------------64.233.187.99 static www.google.com216.109.112.135 dynamic 294 yahoo.com

Parameter Description

ip-address IP address of a host on the network.

host-name DNS name of a host on the network.

961Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

DNS (Domain Name Service) Client

Left running head: Chapter name (automatic)

962

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

Dynamic DNS (DDNS) Client

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 40 DYNAMIC DNS (DDNS) CLIENT

This chapter documents the Command Line Interface (CLI) commands for Dynamic DNS Client configuration.

This chapter includes table of parameters, default values, and configuration examples for DDNS Client as quick-start and reference information. In this chapter, all the commands are described in alphabetical order. For more detailed information about using and configuring the DDNS Client, refer to the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

963Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Dynamic DNS (DDNS) Client

Left running head: Chapter name (automatic)

HTTPhttp

DESCRIPTION

This command is entered in the DDNS Method Configuration Mode. This command is used to configure the HTTP as the update method. This enters the DDNS HTTP configuration mode.

PARAMETERS

None.

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config–ddns-myDdnsObj)# http

RELEASE HISTORY

Release 3.0: command was introduced.

964

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

interval

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

INTERVALinterval {maximum|minimum} <0-365> <0-23> <0-59> <0-59>

DESCRIPTION

This command is entered in the DDNS Method Configuration Mode.

DDNS client sends periodic updates to the DDNS server. This command is used to configure the maximum or minimum interval (in days, hours, minutes and seconds) at which the updates is to be sent to the DDNS server.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config–ddns-myDdnsObj)# interval maximum 0 1 1 1

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

<0-365> <0-23> <0-59> <0-59> Specify the interval (days, hours, minutes and seconds) at which the updates is to be sent to the DDNS server.

965Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Dynamic DNS (DDNS) Client

Left running head: Chapter name (automatic)

IP DDNS UPDATE HOSTNAMEip ddns update hostname <host-name>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to configure the host name on an interface. The specified host name will be associated with the IP address of the interface while sending DDNS updates

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# interface FastEthernet 0ALU(config-if FastEthernet0)# ip ddns update hostname mysmb.dyndns.org

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

host-name Host name to be configured on the interface.

Note: Host name configured on the interface should be a fully qualified domain name (FQDN).

966

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

ip ddns update method

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

IP DDNS UPDATE METHODip ddns update method <ddns-method>

DESCRIPTION

This command is entered in the Interface Configuration Mode. This command is used to attach the DDNS method on an interface. The specified DDNS method is used for sending DDNS updates associated with address changes on this interface.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# interface FastEthernet 0ALU(config-if FastEthernet0)# ip ddns update method myDdnsObjDDNS method applied.

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

ddns-name DDNS method to be attached on the interface.

967Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Dynamic DNS (DDNS) Client

Left running head: Chapter name (automatic)

IP DDNS METHODip ddns method <method-name>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure a DDNS method. This enters the DDNS method configuration mode.

A method contains a set of attributes such as protocol, server, URL and interval timer. All these used to update the DDNS server.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# ip ddns method myDdnsObjALU(config-ddns-myDdnsObj)#

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

method-name Name of the DDNS method.

968

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

no interval

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

NO INTERVALno interval {maximum|minimum}

This command is entered in the DDNS Method Configuration Mode. This command is used to delete the interval timer settings configured for DDNS method and resets it to the default.

NO IP DDNS UPDATE METHODno ip ddns update method <ddns-method>

This command is entered in the Interface Configuration Mode. This command is used to detach the DDNS method from an interface.

NO IP DDNS UPDATE HOSTNAMEno ip ddns update hostname <host-name>

This command is entered in the Interface Configuration Mode. This command is used to remove the host name configured on the interface.

NO IP DDNS METHODno ip ddns method <method-name>

This command is entered in the Configuration Mode. This command is used to delete a DDNS method. When a method is deleted, all the attributes configured for a method will also be deleted.

NO SERVERno server {dyndns|easydns|justlinux|zoneedit}

This command is entered in the DDNS HTTP Configuration Mode. This command is used to delete the server attributes of a DDNS method.

NO URLno url

This command is entered in the DDNS HTTP Configuration Mode. This command is used to delete the URL of a DDNS method.

969Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Dynamic DNS (DDNS) Client

Left running head: Chapter name (automatic)

SERVERserver {dyndns|easydns|justlinux|zoneedit} username <username> password <password>

DESCRIPTION

This command is entered in the DDNS HTTP Configuration Mode. This command is used to configure the server settings like the server name, user name and the password for authentication.

If no URL is configured, DDNS client will use this configuration to create a URL and update the DDNS server.

Note: When URL and server configuration both exists, URL configuration is considered to update the DDNS server.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-ddns-HTTP)## server dyndns username myMembername password myMemberPass

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

dyndns|easydns|justlinux|zoneedit

DDNS server name.

user-name User name for a DDNS method.

password Password for a DDNS method.

970

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show ip ddns

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW IP DDNSshow ip ddns

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode.

This command displays the DDNS configuration present on the OmniAccess 5510 USG. It lists all the configured DDNS methods, the interface/s to which the methods are associated, protocol type, the host name/URL of the interface and so on. This command displays the DDNS configuration present on the OmniAccess 5510 USG.

PARAMETERS

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show ip ddns

interface FastEthernet0 ip ddns update hostname mysmb.dyndns.orgtop!ip ddns method myDdnsObj http server dyndns username myMembername password myMembername exit!interface FastEthernet0 ip ddns update method myDdnsObj!

RELEASE HISTORY

Release 3.0: command was introduced.

971Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Dynamic DNS (DDNS) Client

Left running head: Chapter name (automatic)

SHOW IP DDNS UPDATEshow ip ddns update {method <method-name>|status}

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode.

This command displays the details of a specific DDNS method. It displays all the attributes configured for a method and the interface to which it is associated.

Status keyword displays the status (success or failure) of the most recent update sent for each interface to which DDNS method is applied.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show ip ddns update method myDdnsObj

ip ddns method myDdnsObj http server dyndns username myMembername password myMembername exit!interface FastEthernet0 ip ddns update method myDdnsObj!

ALU(config)# show ip ddns update status

interface FastEthernet0 ip ddns update method myDdnsObjUpdate Status: 0Update Status: Success!

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

method-name DDNS method name.

972

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

url

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

URLurl <url>

DESCRIPTION

This command is entered in the DDNS HTTP Configuration Mode. This command is used to configure DDNS URL to be invoked for host name and IP address mapping. The URL is provided by the service provider.

Note: 1. When URL and the server configuration both exists, URL configuration is considered to update the DDNS server.

2. The URL for HTTPS should be provided in the following way: For e.g., ‘https://userid:[email protected]/nic/update?system=dyndns&hostname=<h> &myip=<a>.

‘Userid’ is the user name and ‘password’ is the password at the DynDNS.org web site. The special character strings <h> and <a> will be substituted with the host name to update and the IP address with which that host name should be associated, respectively.

Before entering the question mark (?) character, press ‘Ctrl + v’. This will allow you to enter the ‘?’ without the CLI interpreting the ‘?’ as a help query. And, to enable wildcard press ‘Ctrl + d’.

3. To use HTTPS URL, it is mandatory to download certificates from the Certificate Authority using certificate commands.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config–ddns-HTTP)# url https://test:test@members. dyndns.org/nic/update?system=dyndns&hostname=<h>&myip=<a>

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

url Specifies the DDNS URL.

973Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Dynamic DNS (DDNS) Client

Left running head: Chapter name (automatic)

974

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

TR-069 Client

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 41 TR-069 CLIENT

This chapter documents the Command Line Interface (CLI) commands for TR-069 (Technical Report 069) configuration on OmniAccess 5510 USG.

This chapter includes table of parameters, default values, and configuration examples for TR-069 client configurations as quick-start and reference information. In this chapter, all the commands are described in alphabetical order. For more detailed information about using and configuring the TR-069 client, refer to the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

975Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

TR-069 Client

Left running head: Chapter name (automatic)

CWMP ACS-URL cwmp acs-url <url>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to specify the HTTP/HTTPS URL to reach the ACS. This URL is used by the CPE to establish the TR-069 session with the ACS.

Note: The URL may either contain an IP address or fully qualified domain name (FQDN).

DNS client configuration is prerequisite if the URL is specified as FQDN. For FQDN resolution, “ip domain-lookup” and “ip name-server” commands should be configured. This name server should be reachable by the system.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# cwmp acs-url http://10.10.10.1:7003/cwmpWeb/CPEMgt

ALU(config)# cwmp acs-url http://smb26706-0412.fr.alu.com:7003/cwmpWeb/CPEMgt

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

url HTTP/HTTPS URL to reach the ACS.

976

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

cwmp default

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CWMP DEFAULT cwmp default

DESCRIPTION

This command is entered in the interface or sub-interface configuration mode.

This command is used to specify an interface as the default WAN interface on the CPE device for TR-069 to communicate with ACS.

There can be only one default WAN interface in which TR-069 communication could happen. If this command is configured on multiple interfaces, the latest configuration will be considered as active and the previous default WAN interface will no more be used for TR-069 communication.

PARAMETERS

None.

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-if FastEthernet0)# cwmp default

RELEASE HISTORY

Release 3.0: command was introduced.

977Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

TR-069 Client

Left running head: Chapter name (automatic)

CWMP DISABLE cwmp disable

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to disable the CPE from communicating with the ACS.

PARAMETERS

None.

DEFAULT VALUE

By default, cwmp is disabled.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# cwmp disable

RELEASE HISTORY

Release 3.0: command was introduced.

978

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

cwmp enable

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CWMP ENABLE cwmp enable

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to enable the CPE to communicate with the ACS by initiating TR-069 session.

PARAMETERS

None.

DEFAULT VALUE

By default, cwmp is disabled.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# cwmp enable

RELEASE HISTORY

Release 3.0: command was introduced.

979Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

TR-069 Client

Left running head: Chapter name (automatic)

CWMP PASSWORD cwmp password <password>

DESCRIPTION

This command is entered in the Configuration Mode.

This command is used to configure the CPE password used for authentication. This password will be used by the ACS to authenticate a CPE during the TR-069 session establishment.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# cwmp password pass123

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

password CPE password used for authentication.

980

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

cwmp periodic-inform

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CWMP PERIODIC-INFORM cwmp periodic-inform {disable|enable}

DESCRIPTION

This command is entered in the Configuration Mode.

This command is used to enable or disable periodic INFORM mechanism between CPE and ACS. This command specifies whether the CPE must or not periodically notify the ACS through INFORM method calls.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# cwmp periodic-inform enable

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

disable|enable Enable or disable periodic INFORM mechanism between CPE and ACS.

981Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

TR-069 Client

Left running head: Chapter name (automatic)

CWMP PERIODIC-INFORM-INTERVAL cwmp periodic-inform-interval <1-4294967295>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure the time interval (in seconds) between two successive CPE periodic connection attempts and calls to the INFORM method.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# cwmp periodic-inform-interval 100

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

1-4294967295 Specify the time interval (in seconds) between two successive CPE periodic connection attempts and calls to the INFORM method.

982

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

cwmp periodic-inform-time

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CWMP PERIODIC-INFORM-TIME cwmp periodic-inform-time <mm-dd-yyyy> <hh:mm:ss>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to configure an absolute time (UTC) at which the CPE should start sending INFORM method calls to ACS.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# cwmp periodic-inform-time 04/10/2010 10:10:10

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

<mm-dd-yyyy> <hh:mm:ss> Specify the absolute time (UTC) at which the CPE should start sending INFORM method calls to ACS.

983Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

TR-069 Client

Left running head: Chapter name (automatic)

CWMP USERNAMEcwmp username <user-name>

DESCRIPTION

This command is entered in the Configuration Mode.

This command is used to configure the CPE user name used for authentication. This user name will be used by the ACS to authenticate a CPE during the TR-069 session establishment.

PARAMETERS

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# cwmp username user123

RELEASE HISTORY

Release 3.0: command was introduced.

Parameter Description

user-name CPE user name used for authentication.

984

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

cwmp wan

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CWMP WAN cwmp wan

DESCRIPTION

This command is entered in the interface or sub-interface configuration mode.

This command is used to define an interface as a WAN interface on the CPE.

There can be multiple WAN and LAN interfaces configured on the CPE. Any interface without this command is considered a LAN interface by TR-069 protocol.

In case of OmniAccess 5510-AA/AB USG, by default, an ATM interface is considered a WAN interface by the TR-069 protocol.

PARAMETERS

None.

DEFAULT VALUE

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-if FastEthernet0)# cwmp wan

RELEASE HISTORY

Release 3.0: command was introduced.

985Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

TR-069 Client

Left running head: Chapter name (automatic)

NO CWMP ACS-URLno cwmp acs-url

This command is entered in the Configuration Mode. This command is used to remove the configured ACS URL.

NO CWMP DEFAULTno cwmp default

This command is entered in the interface or sub-interface configuration mode. This command is used to delete the cwmp default entry.

NO CWMP PASSWORDno cwmp password

This command is entered in the Configuration Mode. This command is used to delete the configured password.

NO CWMP PERIODIC-INFORMno cwmp periodic-inform

This command is entered in the Configuration Mode. This command is used to delete the periodic-inform entry.

NO CWMP PERIODIC-INFORM-INTERVALno cwmp periodic-inform-interval

This command is entered in the Configuration Mode. This command is used to delete the configured periodic-inform-interval value.

NO CWMP PERIODIC-INFORM-TIMEno cwmp periodic-inform-time

This command is entered in the Configuration Mode. This command is used to delete the configured periodic-inform-time.

NO CWMP USERNAMEno cwmp username

This command is entered in the Configuration Mode. This command is used to delete the configured user name.

NO CWMP WANno cwmp wan

This command is entered in the interface or sub-interface configuration mode. This command is used to delete the cwmp wan entry.

986

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show cwmp

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW CWMPshow cwmp [details]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command shows the TR-069 client configuration details.

PARAMETERS

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config)# show cwmp

! CWMP Configuration!cwmp username user123cwmp password pass123cwmp acs-url http://10.10.10.1:7003/cwmpWeb/CPEMgtcwmp periodic-inform enablecwmp periodic-inform-interval 100cwmp periodic-inform-time 04/10/2010 10:10:10!! CWMP Configuration (End)!

ALU(config)# show cwmp details!! CWMP Configuration!!!Username for ACS connection : user123!Password for ACS connection : pass123!Url for ACS connection : http://10.10.10.1:7003/cwmpWeb/CPEMgt!Periodic inform status : Enabled!PeriodicInformInterval value : 100!PeriodicInformTime (value) : 1270894210!PeriodicInformTime (string) : 04/10/2010 10:10:10!! CWMP Configuration (End)!

Parameter Description

details Displays the detailed TR-069 client configuration details.

987Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

TR-069 Client

Left running head: Chapter name (automatic)

RELEASE HISTORY

Release 3.0: command was introduced.

SHOW CWMP-INTERFACEshow cwmp-interface

DESCRIPTION

This command is entered in the Interface or sub-interface configuration mode. This command shows TR-069 configuration on an interface.

PARAMETERS

None.

PLATFORMS SUPPORTED

OmniAccess 5510 USG

EXAMPLEALU(config-if FastEthernet0)# show cwmp-interface!! CWMP interface configuration!cwmp wancwmp default!! CWMP interface configuration (End)!

RELEASE HISTORY

Release 3.0: command was introduced.

988

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

For final production, import color definitions from\\daldoc01\docteam\templates\framemaker\book-template\color-defs\ production-colors.fm. Do not import other template elements such as page layout.

To return to the draft version, import color def’ns from draft-colors.fm.To switch to the beta version, import color def’ns from beta-colors.fm

For final production, import color definitions from\\daldoc01\docteam\templates\framemaker\book-template\color-defs\ production-colors.fm. Do not import other template elements such as page layout.

To return to the draft version, import color def’ns from draft-colors.fm.To switch to the beta version, import color def’ns from beta-colors.fm

Optional footer: Manual title (to set, redefine ManualTitlevariable)

agination: umeric & ntinuous

PNco

Part 9 License Manager

Beta BetaAlcatel-Lucent

989

Beta Betawith preceding section of book

OmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Left running head: Chapter name (automatic)

990

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

License Manager

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

CHAPTER 42 LICENSE MANAGER

This chapter documents the Command Line Interface (CLI) commands for License Manager.

This chapter includes tables of parameters, default values, and configuration examples for the license manager component as quick-start and reference information. In this chapter, all commands are described in alphabetical order. For more detailed information these command, refer to the OmniAccess 5510 Unified Services Gateway CLI Configuration Guide.

991Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

License Manager

Left running head: Chapter name (automatic)

DIR LICENSESdir licenses

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to view the list of license files present on the system. This command displays the same information as the ‘list licenses’ command

PARAMETERS

None.

EXAMPLEALU(config)# dir licenses

Permission Size Date modified Name--------- ---- ------------- -------rw- 1795 Jun 8 17:24 ipsec5510.lic

992

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

license backup

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

LICENSE BACKUPlicense backup <license-name> {fpkey:|ftp:|tftp:|user:}

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to take a back-up of the license file from the running system to a given destination.

The backup file can be stored in the user area or fpkey (front panel USB). It can also be sent to a remote location using FTP or TFTP.

PARAMETERS

EXAMPLEALU(config)# license backup ipsec5510.lic user:

Backup license name: ipsec5510.licLicense backed up successfully.

Parameter Description

license-name Name of the license file whose back-up is to be taken.

fpkey: Backup the license file to fpkey (front panel USB).

ftp: Backup the license file to a remote location using FTP.

tftp: Backup the license file to a remote location using TFTP.

user: Backup the license file to the user area.

993Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

License Manager

Left running head: Chapter name (automatic)

LICENSE INSTALLlicense install {fpkey:|ftp:|http:|https:|tftp:|user:|vrf <vrf-name>}

DESCRIPTION

This command is used to install a license file from the given location. The license file can be obtained from the user area or fpkey: (from the front panel USB), or it can be obtained from a remote site using FTP, TFTP, HTTP, HTTPS or through an interface associated with the specified VRF.

After issuing the command, the system displays the messages• if the file was successfully installed• status of individual licenses present in the file: valid, currently invalid (expired or

not effective yet), corrupted, not issued for this chassis or already installed (duplicate).

If the file being installed already exists in the system, then the following message is displayed:

ALU(config)# license install user:License name: serial.xml_orgLicense already exists, for reinstallation remove existing license

PARAMETERS

Parameter Description

fpkey: Install the license from fpkey: (front panel USB).

ftp: Download the license file to be installed through FTP from a remote location.

http: Download the license file to be installed through HTTP from a remote location.

https Download the license file to be installed through HTTPS from a remote location.

tftp Download the license file to be installed through TFTP from a remote location.

user: Install the license file from the user area.

vrf-name Download the license file to be installed through an interface associated with the specified VRF.

994

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

license install

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

EXAMPLE

This is an example of installing a license file named ipsec5510.lic from a remote location through TFTP, and the file is installed successfully. The host (on which license is present) should be reachable.

ALU(config)# license install tftp:Address name of remote host []? 4.4.4.9Remote Port [ Enter for default ] :Source Path/File []? ipsec5510.licLicense file downloaded successfully.1. License for feature IPSEC installed successfully. * Issued on : Aug 13 08:13:01 2009 * Chassis ID: K1582151 * Serial num: 4 * Details : IP Security Encryption * Attributes: Name Value -------- ------- VALIDITY UNLIMITED

995Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

License Manager

Left running head: Chapter name (automatic)

LICENSE REMOVElicense remove <license-name>

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to remove the specified license file. It checks for valid licenses in the file being deleted. The command also asks for confirmation for deletion, and also prompts to take a backup before deleting the license. Once confirmed, this would delete the license file and withdraw the licenses for all related features.

PARAMETERS

EXAMPLEALU(config)# license remove ipsec5510.licWARNING:Removing a license will permanently delete it from the system.You may wish to back it up before removing.Do you want to continue?(y/[n]) : yThe license is valid.Do you still want to proceed? (y/[n]) : yLicense removed successfully.

LIST LICENSESlist licenses

DESCRIPTION

This command is entered in the Configuration Mode. This command is used to view the list of license files present on the system.

PARAMETERS

None.

EXAMPLEALU(config)# list licenses

Permission Size Date modified Name--------- ---- ------------- -------rw- 1795 Jun 8 17:24 ipsec5510.lic

Parameter Description

license-name Name of the license file to be deleted.

996

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent

show licenses feature-list

Except on the first page, right running head: Heading1 or Heading1NewPage text (automatic)

SHOW LICENSES FEATURE-LISTshow licenses feature-list

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to view a list of all licensable features present on the OmniAccess 5510 USG. The features shown require a license for their functioning.

The command also specifies whether a license has been installed for these features, and, if installed, the command gives information about the validity of the license.

PARAMETERS

None.

EXAMPLEALU(config)# show licenses feature-list

Feature Licensed Valid ======= ======== ===== IPSEC YES YES IDS YES YES IDS-UPDATE YES YES

997Alcatel-Lucent

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

License Manager

Left running head: Chapter name (automatic)

SHOW LICENSESshow licenses [<license-name>]

DESCRIPTION

This command is entered in the Super User Mode or Configuration Mode. This command is used to display the list of all the available licenses on the system, the file from which it was installed, license ID, features, attributes, validity and status information.

PARAMETERS

EXAMPLEALU(config)# show licenses

1. License for feature IPSEC is valid. * License : ipsec5510.lic * Issued on : Aug 13 08:13:01 2009 * Chassis ID: K1582151 * Serial num: 3 * Details : IP Security Encryption * Attributes: Name Value -------- ------- VALIDITY UNLIMITED

2. License for feature IDS-UPDATE is valid. * License : testipsec5510.lic * Issued on : Aug 13 08:13:01 2009 * Chassis ID: K1582151 * Serial num: 2 * Details : Intrusion Detection System Update * Attributes: Name Value -------- ------- VALIDITY UNLIMITED

3. License for feature IDS is valid. * License : testipsec5510.lic.txt * Issued on : Aug 13 08:13:01 2009 * Chassis ID: K1582151 * Serial num: 1 * Details : Intrusion Detection System * Attributes: Name Value -------- ------- VALIDITY UNLIMITED

Parameter Description

license-name If a license file name is specified, then the details of only the licenses present in that file is displayed.

998

Beta BetaOmniAccess 5510 Unified Services Gateway CLI Command Reference Guide

Alcatel-Lucent