routing information protocol command line interface · pdf filerouting information protocol...

BIG-IP® Advanced Routing™Routing Information Protocol

Command Line Interface Reference Guide

Version 7.8.4

Publication DateThis document was published on June 27, 2013.

Legal Notices

CopyrightCopyright 2001-2013, F5 Networks, Inc. All rights reserved.

F5 Networks, Inc. (F5) believes the information it furnishes to be accurate and reliable. However, F5assumes no responsibility for the use of this information, nor any infringement of patents or other rights ofthird parties which may result from its use. No license is granted by implication or otherwise under anypatent, copyright, or other intellectual property right of F5 except as specifically described by applicableuser licenses. F5 reserves the right to change specifications at any time without notice.

TrademarksAAM, Access Policy Manager, Advanced Client Authentication, Advanced Firewall Manager, AdvancedRouting, AFM, Alive With F5, APM, Application Acceleration Manager, Application Security Manager,ARX, AskF5, ASM, BIG-IP, BIG-IQ, Cloud Extender, CloudFucious, Cloud Manager, ClusteredMultiprocessing, CMP, COHESION, Data Manager, DevCentral, DevCentral [DESIGN], DNS Express,DSC, DSI, Edge Client, Edge Gateway, Edge Portal, ELEVATE, EM, Enterprise Manager, ENGAGE, F5,F5 [DESIGN], F5 Certified [DESIGN], F5 Networks, Fast Application Proxy, Fast Cache, FirePass,Global Traffic Manager, GTM, GUARDIAN, iApps, IBR, Intelligent Browser Referencing, IntelligentCompression, IPv6 Gateway, iControl, iHealth, iQuery, iRules, iRules OnDemand, iSession, L7 RateShaping, LC, Link Controller, Local Traffic Manager, LTM, LineRate, LineRate Systems [DESIGN],LROS, Message Security Manager, MSM, OneConnect, Packet Velocity, PEM, Policy EnforcementManager, Protocol Security Manager, PSM, Real Traffic Policy Builder, ScaleN, Signalling DeliveryController, SDC, SSL Acceleration, StrongBox, SuperVIP, SYN Check, TCP Express, TDR, TMOS,Traffic Management Operating System, Traffix Systems, Traffix Systems (DESIGN), Transparent DataReduction, UNITY, VAULT, VIPRION, vCMP, VE F5 [DESIGN], Virtual Clustered Multiprocessing,WA, WAN Optimization Manager, WebAccelerator, WOM, and ZoneRunner, are trademarks or servicemarks of F5 Networks, Inc., in the U.S. and other countries, and may not be used without F5's expresswritten consent.

All other product and company names herein may be trademarks of their respective owners.

A portion of this reference guide is copyrighted by IP Infusion, Inc.

ZebOS is a registered trademark, and IP Infusion and the ipinfusion logo are trademarks of IP Infusion.All other trademarks are trademarks of their respective companies.

This documentation is subject to change without notice. The software described in this document and thisdocumentation are furnished under a license agreement or nondisclosure agreement. The software anddocumentation may be used or copied only in accordance with the terms of the applicable agreement. Nopart of this publication may be reproduced, stored in a retrieval system, or transmitted in any form or anymeans electronic or mechanical, including photocopying and recording for any purpose other than thepurchaser's internal use without the written permission of IP Infusion Inc.

F5 Networks, Inc. (F5) believes the information it furnishes to be accurate and reliable. However, F5assumes no responsibility for the use of this information, nor any infringement of patents or other rights ofthird parties which may result from its use. No license is granted by implication or otherwise under anypatent, copyright, or other intellectual property right of F5 except as specifically described by applicableuser licenses. F5 reserves the right to change specifications at any time without notice.

All other product and company names herein may be trademarks of their respective owners.

i

Table of Contents

CHAPTER 1 ZebOS Command Line Interface Environment . . . . . . . . . . . . . . . . . . 1Command Line Interface Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1

Command Line Interface Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1Command Completion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3Typographic Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3Format used for Command Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4Command Negation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4Variable Parameter Expansion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4

Show Command Tokens. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5Output Modifiers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5

Command Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6Common Command Mode Tree. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7

Common Executive Mode Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7Common Privileged Executive Mode Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9

Common Configure Mode Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10

CHAPTER 2 Routing Information Protocol Commands . . . . . . . . . . . . . . . . . . . . . 13accept-lifetime. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15cisco-metric-behavior. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16clear ip rip route . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17debug rip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18default-information originate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19default-metric . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20distance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21distribute-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22ip rip authentication key-chain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23ip rip authentication mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24ip rip authentication string . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25ip rip receive-packet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26ip rip receive version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27ip rip send-packet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28ip rip send version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29ip rip send version 1-compatible . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30ip rip split-horizon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32key chain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33key-string . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34maximum-prefix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35neighbor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37offset-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .38

iii

Table of Contents

passive-interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39recv-buffer-size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40redistribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41restart rip graceful. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42rip restart grace-period. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43route . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44router rip. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45send-lifetime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46show debugging rip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47show ip protocols rip. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48show ip rip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49show ip rip database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50show ip rip interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51timers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52undebug rip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

CHAPTER 3 Routing Information Protocol VPN Commands. . . . . . . . . . . . . . . . . 55address-family ipv4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56address-family ipv6 vrf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57exit-address-family . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58show ip rip database vrf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59show ip rip interface vrf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60show ip vrf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

CHAPTER 4 RIPng Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63aggregate-address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64cisco-metric-behavior . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65clear ipv6 rip route . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66debug ipv6 rip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67default-information originate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68default-metric. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69distance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70distribute-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71ipv6 rip rip metric-offset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72ipv6 rip split-horizon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73ipv6 router rip. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74neighbor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75offset-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76passive-interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77recv-buffer-size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78redistribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79route . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80route-map. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81router ipv6 rip. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82show debugging ipv6 rip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83show ipv6 protocols rip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84show ipv6 rip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

iv

Table of Contents

show ipv6 rip database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86show ipv6 rip interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .87timers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .88undebug ipv6 rip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .89

Appendix A Routing Information Protocol Authentication . . . . . . . . . . . . . . . . . . . 91Single key authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .91Multiple keys authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .91

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Index - 1

v

Table of Contents

vi

CHAPTER 1 ZebOS Command Line Interface Environment

Network administrators and application developers who install and configure ZebOS® Routing Information Protocol software should use this Command Line Interface (CLI) reference guide. This guide includes contains the following information:

• An overview of the ZebOS Command Line Interface

• An overview of the Integrated Management Interface (IMI), including a description of both basic access and of the shell commands

• A complete reference of the CLI commands used for Routing Information Protocol (RIP) configurations

Command Line Interface OverviewThe ZebOS® Command Line Interface (CLI) is a text-based facility conforming to industry standards. Many of the commands can be used in scripts to automate configuration tasks. Each CLI command is usually associated with a specific function or a common function performing a specific task.

The Integrated Management Interface (IMI) Shell, or IMISH, gives users and administrators the ability to issue commands to several daemons using a single TELNET session.

Command Line Interface HelpThe ZebOS CLI contains a text-based help facility. Access this help by typing in a full or partial command string then typing a question mark “?”. The ZebOS CLI displays the command keywords or parameters along with a short description.

For example, at the CLI command prompt, type

ZebOS> show ? (CLI does not display the question mark).The CLI displays this keyword list with short descriptions for each keyword:

ZebOS# show debugging Debugging functions (see also 'undebug') history Display the session command history ip IP information memory Memory statistics route-map route-map information running-config running configuration startup-config Contents of startup configuration version Displays ZebOS version

If the ? is typed in the middle of a keyword, the ZebOS CLI displays help for that keyword only.

ZebOS> show de? (CLI does not display the question mark). debugging Debugging functions (see also 'undebug')

If the ? is typed in the middle of a keyword, but the incomplete keyword matches several other keywords, ZebOS displays help for all matching keywords.

ZebOS> show i? (CLI does not display the question mark). interface Interface status and configuration

1

ZebOS Command Line Interface Environment

ip IP information isis ISIS information

Command CompletionThe ZebOS CLI can complete the spelling of a command or a parameter. Begin typing the command or parameter, then press the TAB key. For example, at the CLI command prompt type sh:

ZebOS> shPress TAB. The CLI displays:

ZebOS> showIf the command or parameter partial spelling is ambiguous, the ZebOS CLI displays the choices that match the abbreviation. Type show i and press TAB. The CLI displays:

ZebOS> show iinterface ip isisZebOS> show i

The CLI displays the interface and ip keywords. Type n to select interface and press TAB. The CLI displays:

ZebOS> show inZebOS> show interface

Type ? and the CLI displays the list of parameters for the show interface command.

ZebOS> show interface IFNAME Interface name | Output modifiers > Output redirection <cr>

The CLI displays the only parameter associated with this command, the IFNAME parameter.

Note: For more information about output modifiers and output redirection, see the Show Command Tokens section.

Command AbbreviationsThe ZebOS CLI accepts abbreviations for commands. For example,

sh in eth0is an abbreviation for the show interface command.

Command Line ErrorsAny unknown spelling variation causes the command line parser to display the error Unrecognized command in response to the ?. The parser redisplays the command as last entered. When the user presses the Enter key after typing an invalid command, the parser displays:

ZebOS(config)#router ospf here ^% Invalid input detected at '^' marker.

where the ^ points to the first character in error in the command.

If a command is incomplete, it displays the following message:

ZebOS> show% Incomplete command.

Some commands are too long for the display line and can wrap in mid-parameter or mid-keyword, as shown below:

2


area 10.10.0.18 virtual-link 10.10.0.19 authentication-key 57393

DefinitionsThe following table defines the terms used in this document.

Table 1: Definition of Terms

Typographic ConventionsThe following table describes the typographic conventions that are used in this guide.

Table 2: .Typographic Conventions

Term Description

token A token is a non-character, non-numeric symbol: {}, {}, (), <>, |, ?, >, ., =

parameter A parameter is an UPPERCASE term for which the user substitutes input.

keyword A keyword is a lowercase term that the user types exactly as shown.

line A line is the user input of any text string, including spaces. No other parameters may be entered after input for this token.

word A word is the user input of any contiguous text string (excluding spaces).

Convention Name Description Example

Monospaced font

Command Represents command strings entered on a command line and sample source code.

show ip ospf

UPPERCASE Variable parameter

Indicates user input. Enter values according to the description. Each upper-cased token expands into one or more other tokens.

area AREAID range ADDRESS

lowercase Keyword parameter

Indicates keywords. Enter values exactly as displayed in the command description.

show ip ospf

| Vertical bar Limits the choices. Select one from the list. Do not enter the bar as part of the command.

A.B.C.D|<0-4294967295>

() Parentheses Encloses optional parameters. Select one. Do not enter the parentheses as part of the command.

(A.B.C.D|<0-4294967295>)

{ } Braces Encloses optional parameters. Select none, one or more than one. Do not enter the brace as part of the command.

{priority <0-255>|poll-interval <1-65535>}

[] Square brackets

Encloses optional parameters. Select one. Do not enter the bracket as part of the command.

[parm2|parm2|parm3]

< > Angle brackets Encloses a numeric range, endpoints inclusive. Do not enter the bracket as part of the command.

<0-65535>

= Equal sign Separates the variable from explanatory text. Do not enter the equal sign as part of the command.

PROCESSID = <0-65535>

3


Format used for Command DescriptionThe following describes the format used when describing each command in this document.

Table 3: Command Description Formats

Command NegationMany commands can be negated using the no keyword. Depending on the command or the parameters, some command negation can disable one feature or a feature for a specific ID, interface, address or other identifier.

However, some negation is for the base command only; thus, the negated form does not take a parameter.

Variable Parameter ExpansionFor some commands, an IP address or a number in a given range can replace a parameter. For example:

area AREAADDRESSID virtual-link ROUTERID (AUTHENTICATE|MSGD|INTERVAL)AREAADDRESSID=A.B.C.D|<0-4294967295>

Therefore, the following is the minimum command for the ROUTERID by an IP address:

area 10.10.0.11 virtual-link 10.10.0.12Users can only choose an optional parameter in the string [AUTHENTICATE|MSGD|INTERVAL]. In addition, users can replace a parameter by a keyword or parameter. For example, the following string replaces the MD5 parameter:

MD5= [message-digest-key <1-255> md5 MD5_KEY]

with MD5_KEY replaced by a 1-16 character string.

A.B.C.D IP address An IPv4-style address 10.0.11.123

X:X::X:X IP address An IPv6-style address 3ffe:506::1where the:: is all the zeros for address components not explicitly given.

Format Description

Command Name Describes the command, what the command does and when should it be used.

Command Syntax Displays the syntax of each command.

Parameters Defines parameters and options within each command syntax.

Default Displays the status of the command before it is executed.

Command Mode Displays the name of the command mode in which this command is used. Examples include Exec or Configure modes.

Example Displays an example of the command being executed and the complexities of the command syntax.

Related Commands Lists the commands that are of immediate importance.

Convention Name Description Example

4


Show Command TokensUsers can use two tokens to modify the output of a show command. Enter a question mark to display these tokens:

ZebOS# show users ? | Output modifiers > Output redirection

Output ModifiersUsers can type the | (vertical bar character) to use output modifiers. For example:

ZebOS>show rsvp | ?

begin Begin with the line that matchesexclude Exclude lines that matchinclude Include lines that matchredirect Redirect output

Begin ParameterThe begin parameter displays the output beginning with the first line containing a token matching the input string (everything typed after the begin token). For example:

ZebOS# show run | begin eth1...skippinginterface eth1 ipv6 address fe80::204:75ff:fee6:5393/64!interface eth2 ipv6 address fe80::20d:56ff:fe96:725a/64!line con 0 login!end

Exclude ParameterThe exclude parameter excludes all lines of output that contain the input string. In the following output example, all lines containing the word “include” are excluded:

ZebOS# show interface eth1 | exclude inputInterface eth1 Scope: both Hardware is Ethernet, address is 0004.75e6.5393 index 3 metric 1 mtu 1500 <UP,BROADCAST,RUNNING,MULTICAST> VRF Binding: Not bound Label switching is disabled No Virtual Circuit configured Administrative Group(s): None DSTE Bandwidth Constraint Mode is MAM inet6 fe80::204:75ff:fee6:5393/64 output packets 4438, bytes 394940, dropped 0

5


output errors 0, aborted 0, carrier 0, fifo 0, heartbeat 0, window 0 collisions 0

Include ParameterThe include parameter includes only those lines of output that contain the input string. In the output below, all lines containing the word “input” are included:

ZebOS# show interface eth1 | include input input packets 80434552, bytes 2147483647, dropped 0, multicast packets 0 input errors 0, length 0, overrun 0, CRC 0, frame 0, fifo 1, missed 0

Redirect ParameterThe redirect parameter puts the lines of output into the indicated file.

ZebOS# show history | redirect /var/frame.txt

In addition, the output redirection token (>) allows the user to specify a target file for the lines of output.

ZebOS# show history >/var/frame.txt

Note: To modify the lines displayed for any Show command in this guide, use the | (vertical bar) output modifier token; to save the output to a file, use the > (right arrow) output redirection token.

Command ModesCommands available for each protocol separate into several modes (or nodes) and are arranged in a hierarchy. Each mode has its own special commands.

Table 4: Command Modes

Name Description

Exec Mode Also called the View mode, this mode the first mode to appear after logging in to the CLI. It is a base mode from where users can perform basic commands, such as show, exit, quit, help, list, and enable.

Privileged Exec Mode Also called the Enable mode, it allows users to run additional basic commands, such as debug, write (for saving and viewing the configuration) and show commands.

Configure Mode Also called Configure Terminal mode, it allows users to run configuration commands and to serve as a gateway into the Interface, Router, Line, Route Map, Key Chain and Address Family modes.

Interface Mode Is used to configure protocol-specific settings for a particular interface. Any attribute configured in this mode overrides an attribute configured in the Router mode.

Line Mode Is used to make the access-class commands available.

6


Common Command Mode TreeThe diagram displays the common command mode tree.

Figure 1: Common Command Mode Tree

Common Executive Mode CommandsThe following are the common Executive Mode commands across multiple protocol daemons. Refer to the ZebOS Network Platform NSM Command Reference for information about using these commands.

Table 5: Common Exec Mode commands

Command Name Use this command to

clear resist the functionality of a variety of modules

debug debug a variety of modules

enable enter the Privileged Exec mode

exit leave the current mode, or logout of the session

hardware display the register value from the register

help display online text assistance

logout exit from the ZebOS CLI

7


ping send a ping request

quit leave the current mode

route-map enter the route-map mode and to permit or deny match/set operations

reset reset log-related command

rmon set the remote monitoring debugging feature

show application-priority display Application-Priority interface information

show arp display Internet Protocol (IP)

show cli display the CLI tree of the current mode

show dot1x display IEEE 802.1X Port-Based Access Control

show list display a list of all commands in the current mode

show history display all commands used in a session

show ip protocols display the IP routing protocol process parameters and statistics

show privilege display the current privilege level

show rmon display the Remote Monitoring Protocol (RMON) information

show route-id display the route-ID information

show users display information about terminal lines

show user-priority display the default user priority associated with the layer2 interface

show version display the current ZebOS version

terminal length set the number of lines in a terminal display

terminal monitor display debugging information on a monitor

traceroute enable the traceroute commands

undebug disable the debugging feature


8


Common Privileged Executive Mode CommandsThe following are the common Privileged Executive Mode commands across multiple protocol daemons. Enter this mode by typing enable from the Executive mode. See the ZebOS Network Platform Command Line Interface Reference Guide for information about using these commands.

Table 6: Common Privileged Exec Mode Commands


clear ip prefix-list clear the IP prefix-list

configure terminal enter the Configure Terminal mode. You must me in the Privilege Executive mode to issue this command

copy running-config startup-config copy the current running configuration to the startup configuration file

disable exit Privileged Exec mode

end leave the current mode


hardware display the register value from the register


login Login to a particular virtual router context

logout exit from the ZebOS CLI

mstat show the statistics after multiple multicast traceroutes

mtrace trace a multicast path from source to destination

ping send a ping request

quit leave the current mode

reset reset the log related command

rmon set the remote monitoring debugging feature

show access-list display the list of IP access lists

show application-priority display the Application-Priority interface information

show arp display the Internet Protocol (IP)


show dot1x display the IEEE 802.1X Port-Based Access Control

show faults display the recorded faults

show list display a list of all commands in the current mode

show history display all commands used in a session

show ip prefix-list display the prefix list entries

9


Common Configure Mode CommandsThe following are the common Configure Mode commands across multiple protocol daemons. Enter this mode by typing configuration terminal from the Privileged Executive mode. Refer to the ZebOS Network Platform NSM Command Line Interface Reference Guide for information about using these commands.

Table 7: Common Configure Mode Commands

show ip protocols display the IP routing protocol process parameters and statistics

show privilege display the current privilege level

show rmon display the Remote Monitoring Protocol (RMON) information

show route-id display the route-ID information

show route-map display user readable route-map information

show running-config display the current configuration

show startup-config display the startup configuration (from storage)

show users display information about terminal lines

show user-priority display the default user priority associated with the layer2 interface

show version display the current ZebOS version

telnet open a TELNET connection

terminal length set the number of lines in a terminal display

terminal monitor display debugging on a monitor

trace enable the trace commands

traceroute enable the traceroute commands


write file write the current configuration file

write memory write the current configuration file to non-volatile memory

write terminal display current configurations to the VTY terminal


access-list configure an access-list for filtering packets

arp configure an address resolution protocol

banner toggle the display of the banner text


10


clear ip prefix-list clear the IP prefix-list

do run an exec-level command from the config mode

enable password change the password for the enable command



hostname set or change network server name

ip prefix-list create an entry for a prefix list

ipv6 access-list configure an access-list for filtering frames

ipv6 prefix-list create an entry for an IPv6 prefix list

line vty enter Line mode

list list all commands for a mode

log file specify the file that collects logging information

log record-priority specify the logging of the priority of a message

log stdout begin logging information to the standard output

log syslog begin logging information to the system log

log trap limit logging to a specified level or type

mac configure a MAC access list

mac-access-list configure a MAC access list for QOS (quality of service)

mac-address-table configure spanning tree group commands

max-fib-routes set the maximum number of FIB (forwarding information base) routes

max-static-routes set the maximum number of static routes

maximum-access-list set the maximum number of access-list entries

maximum-paths set the multipath numbers installed to FIB

ospf set the Open Shortest Path First (OSPF) commandoes

radius-server set the RADIUS server configuration commands

rip set the Routing Information Protocol (RIP) commands

rmon set the remote Monitoring Protocol (RMON) commands

route-map enter the route-map mode and to permit or deny match/set operations

router-id set the router identifier for this system

rsvp-bypass set the Bypass Tunnel for the RSVP


11


service advanced-vty set the VTY session to Privileged Exec mode instead of the Exec mode (which is the default)

service password-encryption specify encryption of passwords

service terminal-length set the terminal length for VTY sessions

set port set the port information for a Layer2 interface

show access-list display the list of IP access lists


show list displays a list of all commands in the current mode

show running-config display the current configuration

snmp configure SNMP information


username establish the user name authentication

virtual-router set a virtual-router configuration

vlan configure VLAN parameters


12

CHAPTER 2 Routing Information Protocol Commands

This chapter provides an alphabetized reference for each of the Routing Information Protocol (RIP) Commands. It includes the following commands:

• accept-lifetime on page 15

• cisco-metric-behavior on page 16

• clear ip rip route on page 17

• debug rip on page 18

• default-information originate on page 19

• default-metric on page 20

• distance on page 21

• distribute-list on page 22

• ip rip authentication key-chain on page 23

• ip rip authentication mode on page 24

• ip rip authentication string on page 25

• ip rip receive-packet on page 26

• ip rip receive version on page 27

• ip rip send-packet on page 28

• ip rip send version on page 29

• ip rip send version 1-compatible on page 30

• ip rip split-horizon on page 31

• key on page 32

• key chain on page 33

• key-string on page 34

• maximum-prefix on page 35

• neighbor on page 36

• network on page 37

• offset-list on page 38

• passive-interface on page 39

• recv-buffer-size on page 40

• redistribute on page 41

• restart rip graceful on page 42

• rip restart grace-period on page 43

• route on page 44

• router rip on page 45

13

Routing Information Protocol Commands

• send-lifetime on page 46

• show debugging rip on page 47

• show ip protocols rip on page 48

• show ip rip on page 49

• show ip rip database on page 50

• show ip rip interface on page 51

• timers on page 52

• undebug rip on page 53

• version on page 54

14


accept-lifetimeUse this command to specify the time period during which the authentication key on a key chain is received as valid.

Use the no option with this command to disable it.

Command Syntaxaccept-lifetime (HH:MM:SS|<1-31>|MONTH|<1993-2035>|HH:MM:SS|<1-31>|MONTH|<1993-2035>|duration <1-2147483646>|infinite)

no accept-lifetime

ParametersHH:MM:SS Time of the day when accept-lifetime starts, in hours, minutes and seconds.

<1-31> Specify the day of the month to start.

MONTH Specify the month of the year to start (the first three letters of the month, for example, Jan.).

<1993-2035 Specify the year to start.

HH:MM:SS Time of the day when lifetime expires, in hours, minutes and seconds.

<1-31> Specify the day of the month to expire.

MONTH Specify the month of the year to expire (the first three letters of the month, for example, Feb.).

<1993-2035> Specify the year to expire.

duration Duration of the key in seconds <1-2147483646>.

infinite Authentication ever expires.

Command ModeKeychain-key mode

For More InformationRefer to the Appendix A to see how this command is related to the other authentication commands.

ExamplesThe following example shows the setting of accept-lifetime for key1 on the key chain named mychain.

ZebOS#configure terminalZebOS(config)#key chain mychainZebOS(config-keychain)#key 1ZebOS(config-keychain-key)#accept-lifetime 03:03:01 Dec 3 2004 04:04:02 Oct 6 2006

ZebOS(config)#key chain mychainZebOS(config-keychain)#key 1ZebOS(config-keychain-key)#no accept-lifetime

Related Commandskey, key-string, key chain, send-lifetime

15


cisco-metric-behaviorUse this command to enable the metric update as Cisco.

Use either the no or disable parameter with this command to disable this feature.

Command Syntaxcisco-metric-behavior [enable|disable]

no cisco-metric-behavior

Parametersenable Enable updating the metric consistent with Cisco.

disable Disable updating the metric consistent with Cisco.

DefaultBy default, the Cisco metric-behavior is disabled.

Command ModeRouter mode

ExampleThis example enables the metric update behavior to be consistent with Cisco.

ZebOS#configure terminalZebOS(config)#router ripZebOS (config-router)#cisco-metric-behavior enable

16


clear ip rip routeUse this command to clear specific data from the RIP routing table.

Using this command with the all parameter, clears the RIP table of all the routes. If you do not want that your RIP network to be deleted, use the redistribute connected command and make the RIP network a connected route. To delete the RIP routes learned from neighbor and also keep the RIP network intact, use the rip (clear ip rip route rip) parameter with this command.

Command Syntaxclear ip rip route (A.B.C.D/M|all|bgp|connected|isis|kernel|ospf|rip|static)

ParametersA.B.C.D/M Remove entries which exactly match this destination address from RIP routing table.

all Remove the entire RIP routing table.

bgp Remove only BGP routes from the RIP routing table.

connected Remove entries for connected routes from the RIP routing table.

isis Remove only IS-IS routes from the RIP routing table

kernel Remove kernel entries from the RIP routing table.

ospf Remove only OSPF routes from the RIP routing table.

rip Remove only RIP routes from the RIP routing table.

static Remove static entries from the RIP routing table.

Command ModePrivileged Exec mode

ExamplesZebOS#clear ip rip route 10.0.0.0/8 ZebOS#clear ip rip route ospf

17


debug rip Use this command to specify the options for the displayed debugging information for RIP events, RIP packets and RIP NSM.

Use the no parameter with this command to disable all debugging.

Command Syntaxdebug rip [all|events|nsm|packet (detail|recv|send)]

no debug rip [all|events|nsm|packet (detail|recv|send)]

Parametersall Debug all RIP information.

events Debug RIP events.

nsm Debug RIP and NSM communications.

packet Debug RIP packets, only

detail Display detailed information for the sent or received packet.

recv Debug received packets.

send Debug sent packets.

DefaultDisabled

Command ModePrivileged Exec mode and Configure mode

ExamplesThe following example displays information about the rip packets that are received and sent out from the connected router.

ZebOS#debug rip packet

Related Commandslog file

18


default-information originateUse this command to generate a default route into the Routing Information Protocol (RIP).

Use the no parameter with this command to disable this feature.

Command Syntaxdefault-information originate

no default-information originate

ParametersNone

DefaultDisabled

Command ModeRouter mode and Address Family mode

ExamplesZebOS#configure terminalZebOS(config)#router rip ZebOS(config-router)#default-information originate

19


default-metricUse this command to specify the metrics to be assigned to redistributed routers.

This command redistributes command to make the routing protocol use the specified metric value for all redistributed routes. Default metric is useful in redistributing routes with incompatible metrics. Every protocol has different metrics and can not be compared directly. Default metric provides the standard to compare. All routes that are redistributed will use the default metric


Command Syntaxdefault-metric <1-16>

no default-metric <1-16>

Parameter<1-16> Range of values for default metric.

DefaultBy default, the metric value is set to 1.


ExamplesThis example assigns the cost of 30 to the OSPF routes which are redistributed into RIP.

ZebOS#configure terminalZebOS(config)#router rip ZebOS(config-router)#redistribute ospfZebOS(config-router)#default-metric 10

20


distanceUse this command to set the administrative distance. The administrative distance is a feature used by the routers to select the path when there are two or more different routes to the same destination from two different routing protocols. A smaller administrative distance indicating a more reliable protocol.

Use the no parameter with this command to disable this function.

Command Syntaxdistance [<1-255> (A.B.C.D/M|WORD)]

no distance [<1-255> (A.B.C.D/M|WORD)]

Parameters<1-255> Range of values for administrative distance.

A.B.C.D/M Specify the network prefix and length.

WORD Specify the access-list name.

DefaultBy default, the distance is 120


ExamplesZebOS#configure terminalZebOS(config)#router rip ZebOS(config-router)#distance 8 10.0.0.0/8 mylist

21


distribute-listUse this command to filter incoming or outgoing route updates using the access-list or the prefix-list. You can filter out incoming or outgoing route updates using access-list or prefix-list. If you do not specify the name of the interface, the filter will be applied to all the interfaces.


Command Syntaxdistribute-list (WORD) prefix ((WORD) (in|out) IFNAME

no distribute-list (WORD) prefix (WORD) (in|out) IFNAME

ParametersWORD Specify the IPv4 access-list number or name to use.

prefix Filter prefixes in routing updates.

WORD Specify the name of the IPv4 prefix-list to use.

in Filter incoming routing updates.

out Filter outgoing routing updates.

IFNAME Specify the name of the interface on which distribute-list applies.

DefaultDisabled


ExampleZebOS#configure terminalZebOS(config)#router ripZebOS(config-router)#distribute-list prefix myfilter in eth0

Related Commandsip access-list, ip prefix-list (refer to the ZebOS Network Platform NSM Command Reference)

22


ip rip authentication key-chainUse this command to enable RIPv2 authentication on an interface and specify the name of the key chain to be used. If you do not configure a key chain results in no authentication. Refer to the Appendix A to see how this command is related to the other authentication commands.


Command Syntaxip rip authentication key-chain LINE

no ip rip authentication key-chain

ParametersLINE The name of the key chain.

Command ModeInterface mode

ExamplesIn the following example, interface eth0 is configured key-chain authentication and the name is specified as mykey. This name is used to enter the key-chain mode to specify the password. See the key command.

ZebOS#configure terminalZebOS(config)#interface eth0ZebOS(config-if)#ip rip authentication key-chain mykey

Related Commandskey, key chain

23


ip rip authentication modeUse this command to specify the type of authentication mode used for RIP v2 packets.

Use the no parameter with this command to restore clear text authentication.

Note: Refer to See Appendix A, Routing Information Protocol Authentication to see how this command is related to other authentication commands.

Command Syntaxip rip authentication mode [md5|text]

no ip rip authentication mode

Parametersmd5 Use the keyed MD5 authentication algorithm.

text Specify the clear text or simple password authentication.

DefaultText authentication is enabled


Examples The following example shows md5 authentication configured on the eth1 interface, ensuring authentication of RIP packets received.

ZebOS#configure terminalZebOS(config)#interface eth1ZebOS(config-if)#ip rip authentication mode md5

Related Commandsip rip authentication key-chain

24


ip rip authentication stringUse this command to specify the authentication string or password used by a key.

The ZebOS implementation provides the choice of configuring authentication for single key or multiple keys at different times. Use this command to specify password for a single key on an interface. Refer to the Appendix A to see how this command is related to the other authentication commands.


Command Syntaxip rip authentication string LINE

no ip rip authentication string

ParametersLINE Specify the authentication string or password used by a key.


ExamplesIn the following example, the interface eth1 is configured to have an authentication string as guest, any receiving RIP packet in that interface should have the same string as password.

ZebOS#configure terminalZebOS(config)#interface eth1ZebOS(config-if)#ip rip authentication string guest

Related commandsip rip authentication mode

25


ip rip receive-packetUse this command to configure the interface to enable the reception of RIP packets.


Command Syntaxip rip receive-packet

no ip rip receive-packet

ParametersNone

DefaultReceive-packet is enabled


ExampleThis example shows packet receiving being turned on for interface eth0.

ZebOS#configure terminalZebOS(config)#interface eth0ZebOS(config-if)#ip rip receive-packet

Related Commandsip rip send-packet

26


ip rip receive versionUse this command to receive specified version of RIP packets on an interface basis using version control, and override the setting of the version command.

Use the no form of this command to use the setting established by the version command.

Command Syntaxip rip receive version [1|2|1 2|2 1]

no ip rip receive version

Parameters1 Accept RIP version 1 packets on the interface.

2 Accept RIP version 2 packets on the interface.

1 2 Accept RIP version 1 and version 2 packets on the interface.

2 1 Accept RIP version 2 and version 1 packets on the interface.

DefaultVersion 2


ExamplesIn the following example, interface eth1 in configured to receive both RIP version 1 and 2 packets.

ZebOS#configure terminalZebOS(config)#interface eth1 ZebOS(config-if)#ip rip receive version 1 2

Related Commandsversion

27


ip rip send-packetUse this command to enable sending RIP packets through the current interface.


Command Syntaxip rip send-packet

no ip rip send-packet

ParametersNone

DefaultSend packet is enabled


ExampleThis example shows packet sending being turned on for interface eth0.

ZebOS#configure terminalZebOS(config)#interface eth0ZebOS(config-if)#ip rip send-packet

Related Commandsip rip receive-packet

28


ip rip send versionUse this command to send RIP packets on an interface using version control.

Use the no parameter with this command to use the global RIP version control rules.

Command Syntaxip rip send version [1|2|1 2|2 1]

no ip rip send version

Parameters1 Send RIP version 1 packets out of an interface.

2 Send RIP version 2 packets out of an interface.

1 2 Permits sending both RIP version 1and 2 packets out of an interface.

2 1 Permits sending both RIP version 2 and 1 packets out of an interface.

DefaultVersion 2


UsageThis command applies to a specific interface and overrides any the version specified by the version command.

ExamplesIn the following example, interface eth1 is configured to send both RIP version 1 and 2 packets.

ZebOS#configure terminalZebOS(config)#interface eth1ZebOS(config-if)#ip rip send version 1 2

29


ip rip send version 1-compatibleUse this command to send RIP version 1 compatible packets from a version 2 RIP interface to other RIP interfaces. This mechanism causes version 2 RIP to broadcast the packets instead of multicasting them.

Use the no parameter with this command to use the global RIP version control rules.

Command Syntaxip rip send version 1-compatible

no ip rip send version

ParametersNone

DefaultDisabled


Usage To test this case, the configuration must be:

!interface XXXXip rip send version 1-compatible!router ripversion 2

Note: The default version for ripd is version 2. Use the version command to explicitly specify a different version.

ExamplesIn the following example, interface eth1 is configured to send RIP version 1-compatible packets, so it broadcasts both RIP version 1 and 2 packets.

ZebOS#configure terminalZebOS(config)#interface eth1ZebOS(config-if)#ip rip send version 1-compatible

30


ip rip split-horizonUse this command to perform the split-horizon action on the interface. The default is split-horizon poisoned.

This command helps avoid including routes in updates sent to the same gateway from which they were learned. Using the split horizon command omits routes learned from one neighbor, in updates sent to that neighbor. Using the poisoned parameter with this command includes such routes in updates, but sets their metrics to infinity. Thus, advertising that these routes are not reachable.


Command Syntaxip rip split-horizon (poisoned)

no ip rip split-horizon

Parameterpoisoned Performs split-horizon with poisoned reverse.

DefaultSplit horizon poisoned


ExamplesZebOS#configure terminalZebOS(config)#interface eth0ZebOS(config-if)#ip rip split-horizon poisoned

31


keyUse this command to manage, add and delete authentication keys in a key-chain.

This command allows you to enter the keychain-key mode where a password can be set for the key. Refer to the See Appendix A, Routing Information Protocol Authentication to see how this command is related to the other authentication commands.


Command Syntaxkey <0-2147483647>

no key <0-2147483647>

Parameter<0-2147483647> Range of values for key identifier number.

Command ModeKeychain and Keychain-key mode

ExamplesThe following example configures a key number 1 and shows the change into a keychain-key command mode prompt.

ZebOS#configure terminalZebOS(config)#key chain mychainZebOS(config-keychain)#key 1ZebOS(config-keychain-key)#

Related Commandskey chain, key-string, accept-lifetime, send-lifetime

32


key chainUse this command to enter the key chain management mode and to configure a key chain with a key chain name.

This command allows you to enter the keychain mode where you can specify keys on this key chain. Refer to Appendix A to see how this command is related to the other authentication commands.

Use the no option with this command to disable this feature.

Command Syntaxkey chain WORD

no key chain WORD

ParameterWORD The name of the key chain to manage.

Command ModeConfigure mode and Keychain mode

ExamplesThe following example shows the creation of a key chain named mychain and the change into keychain mode prompt.

ZebOS#configure terminalZebOS(config)#key chain mychainZebOS(config-keychain)#

Related Commandskey, key-string, accept-lifetime, send-lifetime

33


key-stringUse this command to define the password to be used by a key.

Use this command to specify passwords for different keys. Refer to Appendix A to see how this command is related to the other authentication commands.


Command Syntaxkey-string LINE

no key-string

ParameterLINE A string of characters to use as a password by the key.


ExamplesIn the following example, the password for key1 in the key chain named mychain is set to password prime.

ZebOS#configure terminalZebOS(config)#key chain mychainZebOS(config-keychain)#key 1ZebOS(config-keychain-key)#key-string prime

Related Commandskey, key chain, accept-lifetime, send-lifetime

34


maximum-prefixUse this command to configure the maximum prefix.

Use the no parameter with this command to disable the limiting of the number of RIP routes in the routing table.

Command Syntaxmaximum-prefix <1-65535> (<1-100>)

no maximum-prefix

Parameters<1-65535> Range of values for maximum number of RIP routes allowed.

<1-100> Percentage of maximum routes to generate a warning.

DefaultThe default maximum percentage of routes to generate a warning is 75.


ExamplesZebOS#configure terminalZebOS(config)#router rip ZebOS(config-router)#maximum-prefix 150

35


neighborUse this command to specify a neighbor router. It is used for each connected point-to-point link. This command to exchanges non-broadcast routing information. It can be used multiple times for additional neighbors.

Passive-interface command disables sending routing updates on an interface. Use the neighbor command in conjunction with the passive-interface command to send routing updates to specific neighbors.Use the no parameter with this command to disable the specific router.

Command Syntaxneighbor [A.B.C.D]

no neighbor [A.B.C.D]

ParameterA.B.C.D An IP address of a neighboring router with which the routing information will be

exchanged.

DefaultDisabled


ExamplesZebOS#configure terminalZebOS(config)#router rip ZebOS(config-router)#neighbor 1.1.1.1

Related Commandspassive-interface

36


networkUse this command to specify a network as one that runs Routing Information Protocol (RIP). This command specifies the networks to which routing updates will be sent and received. If a network is not specified, the interfaces in that network will not be advertised in any RIP update.

Use the no parameter with this command to remove the specified network as one that runs RIP.

Command Syntaxnetwork [A.B.C.D/M|IFNAME]

no network [A.B.C.D/M|IFNAME]

ParametersA.B.C.D/M The IP address prefix and length of this IP network.

IFNAME Alphanumeric string that defines the interface name.

DefaultDisabled


ExamplesZebOS#configure terminalZebOS(config)#router rip ZebOS(config-router)#network 10.0.0.0/8ZebOS(config-router)#network eth0

Related Commandsshow ip rip, clear ip rip

37


offset-listUse this command to add an offset to in and out metrics to routes learned through RIP. This command specifies the offset value that is added to the routing metric. When the networks match the access list the offset is applied to the metrics. No change occurs if the offset value is zero.

Use the no parameter with this command to remove the offset list.

Command Syntaxoffset-list (WORD) in|out <0-16> (IFNAME)

no offset-list (WORD) in|out <0-16> (IFNAME)

ParametersWORD Specify the access-list number or names to apply.

in Indicates the access list will be used for metrics of incoming advertised routes.

out Indicates the access list will be used for metrics of outgoing advertised routes.

<0-16> Range of values for the offset is used for metrics of networks matching the access list.

IFNAME An alphanumeric string that specifies the interface to match.

DefaultThe default offset value is the interface metric value which is defined by the operating system.


ExamplesIn this example the router examines the RIP updates being sent out from interface eth0 and adds 5 hops to the routes matching the ip addresses specified in the access list 1.

ZebOS#configure terminalZebOS(config)#router rip ZebOS(config-router)#offset-list 1 in 5 eth0

Related Commandsaccess-list

38


passive-interfaceUse this command to block RIP broadcast on the interface.


Command Syntaxpassive-interface IFNAME

no passive-interface IFNAME

ParametersIFNAME Specify the interface name.

DefaultDisabled


ExamplesZebOS#configure terminalZebOS(config)#router rip ZebOS(config-router)#passive-interface eth0

Related Commandsshow ip rip

39


recv-buffer-sizeUse this command to run-time configure the RIP UDP receive-buffer size.

Use the no parameter with this command to unset the configured RIP UDP receive-buffer size and set it back to the system default value.

Command Syntaxrecv-buffer-size <8192-2147483647>

no recv-buffer-size <8192-2147483647>

Parameters<8192-2147483647>

Range of values for the RIP UDP receive buffer size value.


ExamplesZebOS#configure terminalZebOS(config)#router rip ZebOS(config-router)#recv-buffer-size 23456789

40


redistributeUse this command to redistribute information from other routing protocols.


Command Syntaxredistribute [bgp (metric <0-16>|route-map) connected (metric<0-16>|route-map) isis (metric <0-16>|route-map) kernel (metric<0-16>|route-map) ospf (metric <0-16> |route-map)|static (metric <0-16>|route-map)]

no redistribute [bgp (metric <0-16>|route-map) connected (metric<0-16>|route-map) isis (metric <0-16>|route-map) kernel (metric<0-16>|route-map) ospf (metric <0-16>|route-map)|static (metric <0-16>|route-map)]

Parametersbgp Redistribute from BGP routes.

connected Redistribute from connected routes.

isis Redistribute from IS-IS routes.

kernel Redistribute from kernel routes.

ospf Redistribute from OSPF routes.

static Redistribute from static routes.

metric Specify a metric value

<0-16> Range of values for metric,

route-map Specify a Route map reference.


ExamplesZebOS#configure terminalZebOS(config)#router ripZebOS(config-router)#redistribute kernel route-map ipi

41


restart rip gracefulUse this command to force the RIP process to restart.

After this command is executed, router immediately shuts down. It is notified to NSM that RIP has shutdown as Graceful and NSM preserves routes installed by RIP until the grace-period expires.

Command Syntaxrestart rip graceful (grace-period <1-65535>)

Parameters<1-65535> Range of values for grace period, in seconds.

Command ModePrivileged Exec mode and Exec mode

ExampleZebOS#restart rip graceful grace-period 100

42


rip restart grace-periodUse this command to change the grace period of RIP graceful restart.

Use this command to enable the Graceful Restart feature on RIP daemon. If this command is configured, NSM is notified about the Grace Period. In case, RIP daemon unexpectedly shuts down, NSM sends this value to the RIP daemon when it comes up again, and the RIP daemon uses this value to end the Graceful state.


Note: This command is available only when configuration option --enable-restart is enabled when compiling ZebOS.

Command Syntaxrip restart grace-period <1-65535>

no rip restart grace-period <1-65535>

Parameters<1-65535> Range of values for grace period, in seconds.

Command ModeConfigure mode

ExampleZebOS#configure terminalZebOS(config)#rip restart grace-period 200

43


routeUse this command to configure static RIP routes.


Command Syntaxroute [A.B.C.D/M]

no route [A.B.C.D/M]

ParameterA.B.C.D/M Specify the IP address prefix and length.

DefaultNo route is added.


ExamplesUse this command to add a static RIP route. This command is used most often for debugging purposes and does not show up in the kernel routing table. After adding the RIP route, it can be checked in the RIP routing table.

ZebOS#configure terminalZebOS(config)#router ripZebOS(config-router)#version 1ZebOS(config-router)#network 10.10.10.0/24ZebOS(config-router)#network 10.10.11.0/24ZebOS(config-router)#neighbor 10.10.10.10ZebOS(config-router)#route 10.10.10.0/24

ZebOS(config-router)#version 1ZebOS(config-router)#network 10.10.10.0/24ZebOS(config-router)#network 10.10.11.0/24ZebOS(config-router)#route 10.10.10.0/24

Related Commandsshow ip rip, clear ip rip

44


router ripUse this global command to enable a RIP routing process.

Use the no parameter with this command to disable the RIP routing process.

Command Syntaxrouter rip

no router rip

ParameterNone


ExamplesThis command is used to begin the rip routing process

ZebOS#configure terminalZebOS(config)#router ripZebOS(config-router)#version 1ZebOS(config-router)#network 10.10.10.0/24ZebOS(config-router)#network 10.10.11.0/24ZebOS(config-router)#neighbor 10.10.10.10

Related Commandsnetwork, version

45


send-lifetimeUse this command to specify the time period during which the authentication key on a key chain can be sent.

Use the no option with this command to disable this feature.

Command Syntaxsend-lifetime (HH:MM:SS|<1-31>|MONTH|<1993-2035>|HH:MM:SS|<1-31>|MONTH|<1993-2035>|duration <1-2147483646>|infinite)

no send-lifetime

ParametersHH:MM:SS Time of the day when accept-lifetime starts, in hours, minutes and seconds.

<1-31> Specify the day of the month to start.

MONTH Specify the month of the year to start (the first three letters of the month, for example, Jan.).

<1993-2035 Specify the year to start.

HH:MM:SS Time of the day when lifetime expires, in hours, minutes and seconds.

<1-31> Specify the day of the month to expire.

MONTH Specify the month of the year to expire (the first three letters of the month, for example, Feb.).

<1993-2035> Specify the year to expire.

duration Duration of the key.

<1-2147483646> Range of values for key duration, in seconds.

infinite Authentication ever expires.


UsageRefer to the Appendix A to see how this command is related to the other authentication commands.

ExamplesThe following example shows the setting of send-lifetime for key1 on the key chain named mychain.

ZebOS#configure terminalZebOS(config)#key chain mychainZebOS(config-keychain)#key 1ZebOS(config-keychain-key)#send-lifetime 03:03:01 Jan 3 2004 04:04:02 Dec 6 2006

Related Commandskey, key-string, key chain, accept-lifetime

46


show debugging ripUse this command to display the RIP debugging status for these debugging options: nsm debugging, RIP event debugging, RIP packet debugging and RIP nsm debugging.

Command Syntaxshow debugging rip

ParametersNone

Command ModeExec mode and Privileged Exec mode

ExampleZebOS#show debugging ripRIP debugging status:

ZebOS#

47


show ip protocols ripUse this command to display RIP process parameters and statistics.

Command Syntaxshow ip protocols rip

ParametersNone


ExampleThis is an example of the output from the show ip protocols command:

ZebOS#show ip protocols ripRouting Protocol is "rip" Sending updates every 30 seconds with +/-50%, next due in 12 seconds Timeout after 180 seconds, garbage collect after 120 seconds Outgoing update filter list for all interface is not set Incoming update filter list for all interface is not set Default redistribution metric is 1 Redistributing: connected static Default version control: send version 2, receive version 2 Interface Send Recv Key-chain eth0 2 2 Routing for Networks: 10.10.0.0/24 Routing Information Sources: Gateway BadPackets BadRoutes Distance Last Update Distance: (default is 120)ZebOS#

48


show ip ripUse this command to show RIP routes.

Command Syntaxshow ip rip

ParametersNone


ExampleThe following output displays the RIP routing table with the destination network, nexthop and metric to reach it.

ZebOS#show ip ripCodes: R - RIP, K - Kernel, C - Connected, S - Static, O - OSPF, I - IS-IS,B - BGPNetwork Next Hop Metric From If TimeK 0.0.0.0/0 10.0.1.1 16 eth1 01:58C 10.0.1.0/24 1 eth1S 10.10.10.0/24 1 eth0C 10.10.11.0/24 1 eth0S 192.168.101.0/24 1 eth0R 192.192.192.0/24 1 --

Related Commandsroute, network, clear ip rip

Equivalent Commandsshow ip rip database

49


show ip rip databaseUse this command to display information about the RIP database.

Command Syntaxshow ip rip database

ParametersNone


ExampleThe following output displays the RIP database information.

ZebOS#show ip rip databaseCodes: R - RIP, K - Kernel, C - Connected, S - Static, O - OSPF, I - IS-IS,B - BGPNetwork Next Hop Metric From If TimeK 0.0.0.0/0 10.0.1.1 16 eth1 01:58C 10.0.1.0/24 1 eth1S 10.10.10.0/24 1 eth0C 10.10.11.0/24 1 eth0S 192.168.101.0/24 1 eth0R 192.192.192.0/24 1 --ZebOS#

Equivalent Commandsshow ip rip

50


show ip rip interfaceUse this command to display information about RIP interfaces. You can specify an interface name to display information about a specific interface.

Command Syntaxshow ip rip interface (IFNAME|vrf)

ParametersIFNAME Name of the interface for which information is to be displayed.

vrf VPN routing/forwarding instance


ExampleThe following output displays the RIP routing table with the destination network, nexthop and metric to reach it.

ZebOS#show ip rip interfacelo is up, line protocol is upRIP is not enabled on this interfaceeth0 is up, line protocol is upRIP is not enabled on this interfaceeth1 is down, line protocol is downRIP is not enabled on this interfaceeth2 is up, line protocol is upRouting Protocol: RIPReceive RIP packetsSend RIPv1 CompatiblePassive interface: DisabledSplit horizon: Enabled with Poisoned ReversedIP interface address:10.10.1.1/2410.10.2.1/24ZebOS#

51


timersUse this command to adjust routing network timers.

This command adjusts the RIP timing parameters. Every 30 seconds, an update is send out containing the complete routing table to every neighboring router. When the time specified by the timeout parameter expires the route is no longer valid. However, it is retained in the routing table for a short time so that neighbors are notified that the route has been dropped. When the time specified by the garbage parameter expires the route is finally removed from the routing table. Until the garbage time expires, the route is included in all updates sent by the router.

All routers in the network must have the same timers to allow RIP to execute a distributed and asynchronous routing algorithms. The timers should not be synchronized as it might lead to unnecessary collisions on the network.

Use the no parameter with this command to restore the defaults.

Command Syntaxtimers basic [<5-2147483647>|<5-2147483647>|<5-2147483647>]

no timers basic

Parameters<5-2147483647> Range of values for the routing table update timer, in seconds.

<5-2147483647> Range of values for the routing information timeout timer, in seconds. After this interval has elapsed and no updates for a route are received, the route is declared invalid.

<5-2147483647> Range of values for the routing garbage collection timer, in seconds.

DefaultThe default routing table update time is 30 seconds.

The default routing information timeout value is 180 seconds.

The default routing garbage collection timer is 120 seconds.


ExamplesZebOS#configure terminalZebOS(config)#router ripZebOS(config-router)#timers basic 30 180 120

ZebOS(config)#router ripZebOS(config-router)#no timers basic

52


undebug rip Use this command to disable the options set for debugging information of RIP events, packets and communication between RIP and NSM.

Use the no parameter with this command to undo the configuration.

Command Syntaxundebug rip [all|events|nsm|packet] (recv|send)(detail)]

Parametersall Disable all RIP debugging.

events Disable logging of RIP events.

nsm Disable logging of RIP and NSM communication.

packet Disable debugging of RIP packets.

recv Disable logging of received packet information.

send Disable logging of sent packet information.

detail Disable logging of sent or received RIP packets.


ExamplesZebOS#undebug rip packet

53


versionUse this command to specify a RIP version used globally by the router.

Use the no parameter with this command to restore the default version.

Command Syntaxversion <1|2>

no version

Parameters<1|2> Specify the version of RIP processing. Default is RIPv2.

DefaultVersion 2


ExamplesRIP can be run in version 1 as well as version 2 mode. Version 2 has more features than version 1 especially authentication. Once the rip version is set, rip packets of that version will be received and sent on all the rip-enabled interfaces.

The ip rip receive version command and the ip rip send version command override the value set by this command.

ZebOSZebOS#configure terminalZebOS(config)#router ripZebOS(config-router)#version 1ZebOS(config-router)#network 10.10.10.0/24ZebOS(config-router)# network 10.10.11.0/24

ZebOS(config-router)#version 1ZebOS(config-router)#network 10.10.10.0/24ZebOS(config-router)#network 10.10.11.0/24

Related Commandsip rip receive version, ip rip send version

54

CHAPTER 3 Routing Information Protocol VPN Commands

This chapter provides information about RIP VPN commands. These commands are available when RIP PE-CE feature is supported. Using these commands, VPN customers can use RIP to receive information, which the CE-router places into the connected VRF from the receiving interface. The information is then advertised across the MPLS/VPN backbone between PE-routers.

To provide a VPN service, the PE-router needs to be configured so that any routing information learned from a VPN customer interface can be associated with a particular VRF. This is achieved using any standard routing protocol process (RIP, OSPF, BGP or static routes etc).

The RIP VPN commands are available only if the --enable-pece-rip configure option is enabled when compiling ZebOS. For detailed information on all configuration options, refer to the ZebOS Network Platform Installation Guide.

To enable the RIP PE-CE feature, a new address-family sub-mode is added within the main RIP configuration. Most of the RIP commands that are available from Router and Interface mode are also available from the address-family mode. Refer to the “RIP Commands” chapter for details on these commands. Additionally, all RIP debug commands display additional VRF information when RIP PE-CE feature is supported.

This chapter includes the following commands:

• address-family ipv4 on page 56

• address-family ipv6 vrf on page 57

• show ip rip database vrf on page 59

• show ip rip interface vrf on page 60

• show ip vrf on page 61

55

Routing Information Protocol VPN Commands

address-family ipv4Use this command to enable the exchanging of VRF routing information and switches command mode to address-family mode. This command configures the routing exchange between Provider Edge (PE) and Customer Edge (CE) devices. Configure a RIP address family for each VRF configured on the PE router.

To use this command, you must first create a VRF-Name in the NSM using the ip vrf command. Associate the same name with the RIP process using this command.

Use the no parameter with this command to disable it.

Command Syntaxaddress-family ipv4 [vrf NAME]

no address-family ipv4 [vrf NAME]

Parametersvrf Identify a VPN Routing/Forwarding instance.

NAME Name of the VRF instance.

ExamplesThe following example places the router in address family configuration mode and specifies VRF1 as the name of the VRF instance to associate with subsequent IP Version 4 address family configuration mode commands:

ZebOS#configure terminalZebOS(config)#router ripZebOS(config-router)#address-family ipv4 vrf VRF1ZebOS(config-router-af)#

56


address-family ipv6 vrfUse this command to enable the exchanging of VRF routing information and switches command mode to address-family mode. This command configures the routing exchange between Provider Edge (PE) and Customer Edge (CE) devices. Configure a RIP address family for each VRF configured on the PE router.

To use this command, you must first create a VRF-Name in the NSM using the ip vrf command. Associate the same name with the RIP process using this command.

Use the no parameter with this command to disable it.

Command Syntaxaddress-family ipv6 [vrf NAME]

no address-family ipv6 [vrf NAME]

Parametersvrf Identify a VPN Routing/Forwarding instance.

NAME Name of the VRF instance.


ExamplesThe following example places the router in address family configuration mode and specifies VRF1 as the name of the VRF instance to associate with subsequent IP Version 6 address family configuration mode commands:

ZebOS#configure terminal ZebOS(config)#router ipv6 rip ZebOS(config-router)#address-family ipv6 vrf VRF1ZebOS(config-router-af)#

57


exit-address-familyUse this command to exit the address-family mode.

Command Syntaxexit-address-family

ParametersNone

Command ModeAddress Family mode

ExamplesThe following example shows the change in prompt after using the exit-address-family command to exit the address-family mode.

ZebOS(config)#router ripZebOS(config-router)#address-family ipv4 vrf IPIZebOS(config-router-af)#exit-address-familyZebOS(config-router)#

58


show ip rip database vrfUse this command to display VPN Routing/Forwarding (VRF) information.

To modify the lines displayed, use the | (output modifier token). To save the output to a file use the > output redirection token.

Command Syntaxshow ip rip database vrf [WORD]

ParametersWORD Specify name for the VRF.

Command ModePrivileged Exec mode and Exec mode

ExamplesZebOS#show ip rip database vrf IPI

59


show ip rip interface vrfUse this command to display VPN Routing/Forwarding (VRF) information.

To modify the lines displayed, use the | (output modifier token). To save the output to a file, use the > output redirection token.

Command Syntaxshow ip vrf (WORD|IFNAME)


IFNAME Name of the interface for which information is to be displayed.


ExampleZebOS#show ip rip interface vrf IPI

60


show ip vrfUse this command to display VPN Routing/Forwarding (VRF) information.

Command Syntaxshow ip vrf (WORD)



ExampleZebOS#show ip vrf IPI

61


62

CHAPTER 4 RIPng Commands

This chapter provides an alphabetized reference for each of the RIPng Commands. It includes the following commands:

• aggregate-address on page 64

• cisco-metric-behavior on page 65

• clear ipv6 rip route on page 66

• debug ipv6 rip on page 67

• default-information originate on page 68

• default-metric on page 69

• distance on page 70

• distribute-list on page 71

• ipv6 rip rip metric-offset on page 72

• ipv6 rip split-horizon on page 73

• ipv6 router rip on page 74

• neighbor on page 75

• offset-list on page 76

• passive-interface on page 77

• recv-buffer-size on page 78

• redistribute on page 79

• route on page 80

• route-map on page 81

• router ipv6 rip on page 82

• show debugging ipv6 rip on page 83

• show ipv6 protocols rip on page 84

• show ipv6 rip on page 85

• show ipv6 rip database on page 86

• show ipv6 rip interface on page 87

• timers on page 88

• undebug ipv6 rip on page 89

63

RIPng Commands

aggregate-addressUse this command to aggregate RIPng routes.


Command Syntaxaggregate-address [X:X::X:X/P]

no aggregate-address [X:X::X:X/P]

ParameterX:X::X:X/M Specify an aggregate network.


ExamplesZebOS#configure terminal ZebOS(config)#router ipv6 rip ZebOS(config-router)#aggregate-address 3ffe:8088::/32

ZebOS(config)#router ipv6 rip ZebOS(config-router)#no aggregate-address 3ffe:8088::/32

64

RIPng Commands

cisco-metric-behaviorUse this command to enable or disable the metric update as Cisco.


Command Syntaxcisco-metric-behavior [enable|disable]

no cisco-metric-behavior

Parametersenable Enable updating the metric consistent with Cisco.

disable Disable updating the metric consistent with Cisco.

DefaultBy default, the Cisco metric-behavior is disabled.


ExampleThis example enables the metric update behavior to be consistent with Cisco.

ZebOS#configure terminalZebOS(config)#router ipv6 ripZebOS(config-router)#cisco-metric-behavior enable

65

RIPng Commands

clear ipv6 rip routeUse this command to clear specific data from the RIPng routing table.

Command Syntaxclear ipv6 rip route [X:X::X:X/M|kernel|static|connected|rip|ospf|isis|bgp|all]

ParametersX:X::X:X/M Removes entries which exactly match this destination address from the RIPng routing

table.

all Remove the entire RIP routing table.

bgp Remove only BGP routes from the RIP routing table.

connected Remove entries for connected routes from the RIP routing table.

isis Remove only IS-IS routes from the RIP routing table

kernel Remove kernel entries from the RIP routing table.

ospf Remove only OSPF routes from the RIP routing table.

rip Remove only RIP routes from the RIP routing table.

static Remove static entries from the RIP routing table.


ExampleZebOS#clear ipv6 rip route isisZebOS#clear ipv6 rip route 3ffe:ffff::/16

66

RIPng Commands

debug ipv6 rip Use this command to specify debugging options of RIPng events, RIPng packets and RIPng NSM communication.

Use the no option with this command to turn off debugging options for RIPng.

Command Syntaxdebug ipv6rip [all|events|nsm|packet (detail|recv|send)]

no debug ipv6 rip [all|events|nsm|packet (detail|recv|send)]








DefaultDisabled

Command ModePrivileged Exec mode and Configure mode

ExamplesZebOS#debug ipv6 rip eventsZebOS#debug ipv6 rip packet send detailZebOS#debug ipv6 rip nsm

Related Commandslog file

67

RIPng Commands

default-information originateUse this command to add default routes to the RIPng updates.


Command Syntaxdefault-information originate

no default-information originate

ParametersNone

DefaultDisabled


ExamplesZebOS#configure terminal ZebOS(config)#router ipv6 rip ZebOS(config-router)#default-information originate

68

RIPng Commands

default-metricUse this command to specify the metrics to be assigned to redistributed routes.


Command Syntaxdefault-metric <1-16>

no default-metric <1-16>

Parameter<1-16> Range of values for the default metric.


ExamplesZebOS#configure terminal ZebOS(config)#router ipv6 rip ZebOS(config-router)#default-metric 8

69

RIPng Commands

distanceUse this command to set the administrative distance for RIP. The administrative distance feature is used by routes to select the path when there are two or more different routes to the same destination from two different routing protocols. A smaller administrative distance indicates a more reliable protocol.

Use the no option with this command to disable this function.

Command Syntaxdistance <1-255>

no distance <1-255>

Parameter<1-255> Range of values for administrative distance.

DefaultBy default, the administrative distance is 120.

Command ModeVRF mode and Address Family mode

ExampleZebOS#configure terminalZebOS(config)#router ipv6 ripZebOS(config-router)#address-family ipv6 vrf IPIZebOS(config-router-af)#distance 2

70

RIPng Commands

distribute-listUse this command to filter incoming or outgoing route updates using the access-list or the prefix-list. You can filter out incoming or outgoing route updates using access-list or prefix-list. If you do not specify the name of the interface, the filter will be applied to all the interfaces.


Command Syntaxdistribute-list (WORD) prefix (WORD) (in|out) IFNAME

no distribute-list (WORD) prefix (WORD) (in|out) IFNAME

ParametersWORD Specify the IPv4 access-list number or name to use.

prefix Filter prefixes in routing updates.

WORD Specify the name of the IPv4 prefix-list to use.

in Filter incoming routing updates.

out Filter outgoing routing updates.

IFNAME Specify the name of the interface on which distribute-list applies.


ExampleZebOS#configure terminalZebOS(config)#router ipv6 ripZebOS(config-router)#distribute-list prefix myfilter in eth0

Related Commandsipv6 access-list, ipv6 prefix-list

71

RIPng Commands

ipv6 rip rip metric-offsetUse this command to set RIP metric offset.


Command Syntaxipv6 rip split-horizon <1-16>

no ipv6 rip split-horizon <1-16>

Parameter<1-16> Range of values for metric.


ExamplesZebOS#configure terminal ZebOS(config)#interface eth0 ZebOS(config-if)#ipv6 rip metric-offset 1

ZebOS(config)#interface eth0 ZebOS(config-if)#no ipv6 rip metric-offset 1

72

RIPng Commands

ipv6 rip split-horizonUse this command to perform the split-horizon action on the interface.


Command Syntaxipv6 rip split-horizon (poisoned)

no ipv6 rip split-horizon

Parameterpoisoned Performs split-horizon with poisoned reverse.

DefaultSplit-horizon poisoned is the default.


ExamplesZebOS#configure terminal ZebOS(config)#interface eth0 ZebOS(config-if)#ipv6 rip split-horizon poisoned

ZebOS(config)#interface eth0 ZebOS(config-if)#no ipv6 rip split-horizon

73

RIPng Commands

ipv6 router ripUse this command to enable RIPng routing on the interface.

Use the no parameter with this command to disable RIPng routing.

Command Syntaxipv6 router rip

no ipv6 router rip

ParametersNone


ExampleZebOS#configure terminalZebOS(config)#interface eth0ZebOS(config-if)#ipv6 router rip

74

RIPng Commands

neighborUse this command to specify a neighbor router.

Use the no parameter with this command to disable the specific router.

Command Syntaxneighbor [X:X::X:X|IFNAME]

no neighbor [X:X::X:X|IFNAME]

ParametersX:X::X:X Specify a link-local IP address of a neighboring router with which the routing information is

exchanged.

IFNAME Specify the name of the interface.


ExamplesZebOS#configure terminal ZebOS(config)#router ipv6 ripZebOS(config-router)#neighbor 80::1 eth0

75

RIPng Commands

offset-listUse this command to add an offset to in and out metrics to routes learned through RIPng.

Use the no parameter with this command to remove this function.

Command Syntaxoffset-list (WORD) in|out OFFSET (IFNAME)

no offset-list (WORD) in|out OFFSET (IFNAME)

ParametersWORD Specify the access-list number or names to apply.

in Indicates the access list will be used for metrics of incoming advertised routes.

out Indicates the access list will be used for metrics of outgoing advertised routes.

<0-16> Specify that the offset is used for metrics of networks matching the access list.


DefaultThe default offset value is the metric value of the interface which is defined by the operating system.


ExamplesZebOS#configure terminal ZebOS(config)#router ipv6 rip ZebOS(config-router)#offset-list mylist in 8 eth0

76

RIPng Commands

passive-interfaceUse this command to enable suppression of routing updates on an interface.


Command Syntaxpassive-interface IFNAME

no passive-interface IFNAME

ParametersIFNAME Specify the interface name.

DefaultDisabled


ExamplesZebOS#configure terminalZebOS(config)#router ipv6 ripZebOS(config-router)#passive-interface eth0

77

RIPng Commands

recv-buffer-sizeUse this command to run-time configure the RIPng UDP receive-buffer size.

Use the no parameter with this command to unset the configured RIPng UDP receive-buffer size and set it back to the system default value.

Command Syntaxrecv-buffer-size <8192-2147483647>

no recv-buffer-size <8192-2147483647>

Parameters<8192-2147483647>

Range of values for RIP UDP receive buffer size.


ExamplesZebOS#configure terminalZebOS(config)#router ipv6 rip ZebOS(config-router)#recv-buffer-size 23456789

78

RIPng Commands

redistributeUse this command to redistribute information from other routing protocols.


Command Syntaxredistribute [bgp (metric <0-16>|route-map) connected (metric<0-16>|route-map) isis (metric <0-16>|route-map) kernel (metric<0-16>|route-map) ospf6 (metric<0-16>|route-map)|static (metric <0-16>|route-map)]

no redistribute [bgp (metric <0-16>|route-map) connected (metric<0-16>|route-map) isis (metric <0-16>|route-map) kernel (metric<0-16>|route-map) ospf6 (metric<0-16>|route-map)|static (metric <0-16>|route-map)]

Parametersbgp Redistribute from BGP routes.

connected Redistribute from connected routes.

isis Redistribute from IS-IS routes.

kernel Redistribute from kernel routes.

ospf6 Redistribute from OSPF routes version 3.

static Redistribute from static routes.

metric Specify a metric value

<0-16> Range of values for metric.

route-map Specify a Route map reference.

WORD Specify name of the route-map.


ExamplesZebOS#configure terminal ZebOS(config)#router ipv6 rip ZebOS(config-router)#redistribute kernel route-map mymap ZebOS(config-router)#redistribute kernel metric 8

79

RIPng Commands

routeUse this command to configure static RIPng routes.


Command Syntaxroute [X:X::X:X/M]

no route [X:X::X:X/M]

ParameterX:X::X:X/M Specify the IPv6 address prefix and length.


ExamplesZebOS#configure terminal ZebOS(config)#router ipv6 rip ZebOS(config-router)#route 3ffe:1234:5678::1/64

80

RIPng Commands

route-mapUse this command to configure static RIPng routes.


Command Syntaxroute-map WORD (in|out) IFNAME

no route-map WORD (in|out) IFNAME

ParametersWORD Specify a route map name.

in Indicates the route map set for input filtering.

out Indicates the route map set for output filtering.



ExamplesZebOS#configure terminalZebOS(config)#router ipv6 ripZebOS(config-router)#route-map IPI in eth1

81

RIPng Commands

router ipv6 ripUse this global command to enable a RIPng routing process.

Use the no parameter with this command to disable the RIPng routing process.

Command Syntaxrouter ipv6 rip

no router ipv6 rip

ParametersNone


ExamplesZebOS#configure terminalZebOS(config)#router ipv6 ripZebOS(config-router)#

82

RIPng Commands

show debugging ipv6 ripUse this command to display the RIPng debugging status for RIPng NSM, RIPng events and RIPng packets.

Command Syntaxshow debugging ipv6 rip

ParametersNone


ExampleZebOS#show debugging ipv6 rip RIPng packet debugging is on

ZebOS#

83

RIPng Commands

show ipv6 protocols ripUse this command to display RIPng process parameters and statistics.

Command Syntaxshow ipv6 protocols rip

ParametersNone


ExampleThe following is a sample output from the show ipv6 protocols rip command.

ZebOS#show ipv6 protocols ripRouting Protocol is "ripng" Sending updates every 30 seconds with +/-50%, next due in 10 seconds Timeout after 180 seconds, garbage collect after 120 seconds Outgoing update filter list for all interface is not set Incoming update filter list for all interface is not set Default redistribute metric is 1 Redistributing: connected Routing for Networks: 3ffe:1::/64ZebOS#

84

RIPng Commands

show ipv6 ripUse this command to show RIPng routes.

Command Syntaxshow ipv6 rip

ParametersNone


ExampleThe following is a sample output from the show ipv6 rip command.

ZebOS#show ipv6 ripCodes: R - RIP, K - Kernel, C - Connected, S - Static, O - OSPF, I - IS-IS,B - BGP, a - aggregate, s - suppressedNetwork Next Hop If Met Tag TimeR 3ffe:1234:5678::/64 fe80::3 eth1 3 0 02:28C 3ffe:ffff:1::/64 :: eth0 1 0Ra 3ffe:ffff:2::/48 -- 1 0Rs 3ffe:ffff:2::/48 fe80::3 eth1 3 0 02:32Cs 3ffe:ffff:2::/64 :: eth1 1 0R 3ffe:ffff:ffff:ffff::/64 fe80::3 eth1 3 0 02:28

Equivalent Commandsshow ipv6 rip database

85

RIPng Commands

show ipv6 rip databaseUse this command to display information about the RIPng database.

Command Syntaxshow ipv6 rip database

ParametersNone


ExampleThe following is a sample output from the show ipv6 rip database command.

ZebOS#show ipv6 rip databaseCodes: R - RIP, K - Kernel, C - Connected, S - Static, O - OSPF, I - IS-IS,B - BGP, a - aggregate, s - suppressedNetwork Next Hop If Met Tag TimeR 3ffe:1234:5678::/64 fe80::3 eth1 3 0 02:28C 3ffe:ffff:1::/64 :: eth0 1 0Ra 3ffe:ffff:2::/48 -- 1 0Rs 3ffe:ffff:2::/48 fe80::3 eth1 3 0 02:32Cs 3ffe:ffff:2::/64 :: eth1 1 0R 3ffe:ffff:ffff:ffff::/64 fe80::3 eth1 3 0 02:28

Equivalent Commandsshow ipv6 rip

86

RIPng Commands

show ipv6 rip interfaceUse this command to display information about the RIPng interfaces. You can specify an interface name to display information about a specific interface.

Command Syntaxshow ipv6 rip interface (IFNAME)

ParametersIFNAME Name of the interface for which information has to be displayed.


ExampleThe following is a sample output from the show ipv6 rip interface command.

ZebOS#show ipv6 rip interfacelo is up, line protocol is upRIPng is not enabled on this interfaceeth0 is up, line protocol is upRIPng is not enabled on this interfaceeth1 is down, line protocol is downRIPng is not enabled on this interfaceeth2 is up, line protocol is upRouting Protocol: RIPngPassive interface: DisabledSplit horizon: Enabled with Poisoned ReversedIP interface address:3ffe:ffff::1/643ffe:fffe::1/64

87

RIPng Commands

timers Use this command to adjust routing network timers.

Use the no parameter with this command to restore the defaults.

Command Syntaxtimers basic [<5-2147483647>|<5-2147483647>|<5-2147483647>]

no timers basic

Parameters<5-2147483647> Range of values for the routing table update timer, in seconds.

<5-2147483647> Range of values for routing information timeout timer, in seconds. After this interval has elapsed and no updates for a route are received, the route is declared invalid.

<5-2147483647> Range of values for routing garbage collection timer, in seconds.

DefaultsThe default routing table update timer is 30 seconds.

The default routing information update timer is 180 seconds.

The default is routing garbage collection timer is 120 seconds.


ExamplesZebOS#configure terminal ZebOS(config)#router ipv6 rip ZebOS(config-router)#timers basic 30 180 120

ZebOS(config)#router ipv6 rip ZebOS(config-router)#no timers basic

88

RIPng Commands

90

Appendix A Routing Information Protocol Authentication

To support RIPv2 message authentication the ZebOS implementation provides the choice of plain text or MD5 authentication, and the option for single key or multiple keys in different modes and stages.

Single key authentication Use the following steps to configure route to enable RIPv2 authentication using a single key or password:

1. Define the authentication string or password

In the Interface mode, specify the authentication string or password used by the key, using the following command:

ip rip authentication string LINE

where LINE is the authentication string or password

2. Specify mode of authentication for the interface

In the Interface mode, specify if the interface will use text or MD5 authentication, using the following command:

ip rip authentication mode md5|text

ExampleZebOS#configure terminalZebOS(config)#interface eth0ZebOS(config-if)#ip rip authentication string mykeyZebOS(config-if)#ip rip authentication mode md5

Multiple keys authenticationUse the following steps to configure route to enable RIPv2 authentication using multiple keys at different times:

1. Define a key chain

In the Configure mode, identify a key chain with a key chain name using the following command:

key chain KEYNAME

where KEYNAME is the name of the chain to manage.

2. Define the key(s)

In the Keychain mode, specify a key on this key chain using the following command:

key KEYID

where KEYID = <1-2147483647> Key Identifier number

3. Define the authentication string or password

In the Keychain-key mode, define the password used by a key, using the following command:

key-string LINE

where LINE is a string of characters to be used as a password by the key.

4. Set key management options

91

Routing Information Protocol Authentication

This step can be performed at this stage or later when multiple keys are used. The options are configured in the keychain-key command mode.

• Set the time period during which the authentication key on a key chain is received as valid, using the following command:

accept-lifetime START END

where START and END are the beginning and end of the time period.

• Set the time period during which the authentication key on a key chain can be sent, using the following command:

send-lifetime START END

where START and END are the beginning and end of the time period.

5. Enable authentication on an interface

In the Interface mode, enable authentication on an interface and specify the key chain to be used, using the following command:

ip rip authentication key-chain CHAINNAME

where CHAINNAME is a set of valid authentication keys

6. Specify mode of authentication for the interface

In the Interface mode, specify if the interface will use text or MD5 authentication, using the following command:

ip rip authentication mode md5|text

ExampleIn the following example, a password toyota is set for a key 1 in a key chain cars. On Interface eth0 authentication is enabled and the authentication mode is set as MD5.

ZebOS#configure terminalZebOS(config)#key chain carsZebOS(config-keychain)#key 1ZebOS(config-keychain-key)#keystring toyotaZebOS(config-keychain-key)#accept-lifetime 10:00:00 Oct 08 2002 duration 43200ZebOS(config-keychain-key)#send-lifetime 10:00:00 Oct 8 2002 duration 43200ZebOS(config-keychain-key)#exitZebOS(config-keychain)#exitZebOS(config)#interface eth0ZebOS(config-if)#ip rip authentication key-chain carsZebOS(config-if)#ip rip authentication mode md5ZebOS(config-if)#exit

92

Index

Symbols, meaning in command syntax notation 3, meaning in command syntax notation 3(), meaning in command syntax notation 3|, meaning in command syntax notation 3

Aabbreviated commands 2accept-lifetime 15access-list

see ZebOS NSM Command Referenceaddress-family ipv4 vrf command 56address-family ipv6 vrf command 57aggregate-address 64angle brackets, meaning in command syntax notation 3authentication commands

accept-lifetime 15ip rip authentication key-chain 23ip rip authentication mode 24ip rip authentication string 25key 32key chain 33key-string 34send-lifetime 46

Bbanner motd

see ZebOS NSM Command Referencebegin 5braces, meaning in command syntax notation 3

Ccisco-metric-behavior 16, 65clear data from RIPng routing table 66clear ip prefix-list

see ZebOS NSM Command Referenceclear ip rip route 17clear ipv6 rip route 66command abbreviation 2command abbreviations 2command completion 2command description format 4command line errors 2command line help 1command line interface

syntax 2command negation 4command reference primer

typographic conventions 3common commands

see ZebOS NSM Command Referenceaccess-listbanner motdclear ip prefix-listconfigure terminalcopy running-config startup-configdisableenableenable passwordendexithelphostnameip prefix-listipv6 access-listipv6 prefix-listline-vtylistlog filelog record-prioritylog sysoutlog traploginquitroute-mapservice advanced-vtyservice password-encryptionservice terminal-lengthset aggregatorshow access-listshow clishow historyshow ip prefix-listshow listshow route-mapshow running-configshow startup-configshow versionterminal lengthterminal monitorwrite filewrite memorywrite terminal

configure static RIPng routes 81configure terminal

see ZebOS NSM Command ReferenceConfigure, command mode definition 6

Index - 1

Index

copy running-config startup-configsee ZebOS NSM Command Reference

Ddebug ipv6 rip 67default-information originate 19, 68default-metric 20, 69disable

see ZebOS NSM Command Referencedistance 21, 70distribute-list 22, 71

Eenable

see ZebOS NSM Command Referenceenable password

see ZebOS NSM Command Referenceenable RIPng 74enable-pece-rip 55end

see ZebOS NSM Command Referenceequal sign, meaning in command syntax notation 3Exec, command mode definition 6exit

see ZebOS NSM Command Referenceexit-address-family command 58

Ggraceful restart commands

rip restart grace-period 43

Hhelp

see ZebOS NSM Command Referencehostname

see ZebOS NSM Command Reference

IInterface, command mode definition 6ip 24ip prefix-list

see ZebOS NSM Command Referenceip rip authentication key-chain 23ip rip authentication mode 24ip rip authentication string 25ip rip receive version 27ip rip receive-packet 26ip rip send version 29ip rip send version 1-compatible 30ip rip send-packet 28ip rip split-horizon 31ipv6 access-list


ipv6 prefix-listsee ZebOS NSM Command Reference

ipv6 rip split-horizon 72, 73ipv6 router rip 74

Kkey 32key chain 33key-string 34

LLine, command mode definition 6LINE, meaning in command syntax notation 3line-vty

see ZebOS NSM Command Referencelist

see ZebOS NSM Command Referencelog file

see ZebOS NSM Command Referencelog record-priority

see ZebOS NSM Command Referencelog sysout

see ZebOS NSM Command Referencelog trap

see ZebOS NSM Command Referencelogin

see ZebOS NSM Command Referencelowercase, meaning in command syntax notation 3

Mmaximum-prefix 35monospaced font, meaning in command syntax

notation 3

Nneighbor 36neighbor command 75network 37network IF_OR_ADDR 76no parameter, action of 4

Ooffset-list 38, 76other conventions 5

Pparameter expansion 4parenthesis not part of command 3passive-interface 39, 77PE-CE configure option 55PIM-SM Command Modes 7Privileged Exec, command mode definition 6

Index - 2

Index

Qquit


Rrecv-buffer-size 40, 78redistribute 41, 79RIP Commands

accept-lifetime 15cisco-metric-behavior 16clear ip rip route 17debug rip 18default-information originate 19default-metric 20distance 21distribute-list 22ip rip authentication key-chain 23ip rip authentication mode 24ip rip authentication string 25ip rip receive packet 26ip rip receive version 27ip rip send packet 28ip rip send version 29ip rip send version 1-compatible 30ip rip split-horizon 31key 32key chain 33key-string 34maximum-prefix 35neighbor 36network 37offset-list 38passive-interface 39recv-buffer-size 40redistribute 41restart rip graceful 42rip restart grace-period 43route 44router rip 45send-lifetime 46show debugging rip 47show ip protocols rip 48show ip rip 49show ip rip database 50show ip rip interface 51timers 52undebug rip 53version 54

RIP PE-CE Commandsaddress-family ipv4 vrf 56address-family ipv6 vrf 57exit-address-family 58show ip rip database vrf 59

RIP VPN commandsaddress-family ipv4 vrf 56address-family ipv6 vrf 57exit-address-family 58

show ip rip database vrf 59RIPng commands

aggregate-address 64cisco-metric-behavior 65clear ipv6 rip route 66debug ipv6 rip 67default-information-originate 68default-metric 69distance 70distribute-list 71ipv6 rip split-horizon 72, 73ipv6 router rip 74neighbor 75network IF_OR_ADDR 76offset-list 76passive-interface 77recv-buffer-size 78redistribute 79route 80route-map 81router ivp6 rip 82show debugging ipv6 rip 83show ipv6 protocols rip 84show ipv6 rip 85show ipv6 rip database 86show ipv6 rip interface 87timers basic 88undebug ipv6 rip 89

route 44, 80route-map 81

see ZebOS NSM Command Referencerouter ipv6 rip 82router rip 45

Ssend-lifetime 46service advanced-vty

see ZebOS NSM Command Referenceservice password-encryption

see ZebOS NSM Command Referenceservice terminal-length

see ZebOS NSM Command Referenceset administrative distance 70set aggregator

see ZebOS NSM Command Referenceshow access-list

see ZebOS NSM Command Referenceshow cli

see ZebOS NSM Command Referenceshow command options 5

exclude 5include 6redirect 6

show command tokens 5output modifiers 5

show historysee ZebOS NSM Command Reference

show ip prefix-list

Index - 3

Index

see ZebOS NSM Command Referenceshow ip rip command 49show ip rip database command 50show ip rip database vrf 59show ip rip interface command 51show ipv6 rip command 85show ipv6 rip database command 86show ipv6 rip interface command 87show list

see ZebOS NSM Command Referenceshow route-map

see ZebOS NSM Command Referenceshow running-config

see ZebOS NSM Command Referenceshow startup-config

see ZebOS NSM Command Referenceshow version

see ZebOS NSM Command Referencesquare brackets, meaning in command syntax notation 3syntax help

command abbreviations 2command completion 2command line errors 2

Tterminal length


terminal monitorsee ZebOS NSM Command Reference

timers 52timers basic 88typographic conventions 3

Uundebug ipv6 rip 89undebug rip 53UPPERCASE, meaning in command syntax notation 3

Vvariable parameter expansion 4version 54vertical bar 3

WWORD, meaning in command syntax notation 3write file

see ZebOS NSM Command Referencewrite memory

see ZebOS NSM Command Referencewrite terminal


Index - 4

routing information protocol command line interface · pdf filerouting information protocol...

Documents