Vyatta - OSPF

453
Vyatta Suite 200 1301 Shoreway Road Belmont, CA 94002 vyatta.com 650 413 7200 1 888 VYATTA 1 (US and Canada) OSPF REFERENCE GUIDE VYATTA, INC. | Vyatta System Title

Transcript of Vyatta - OSPF

Page 1: Vyatta - OSPF

VyattaSuite 200

1301 Shoreway RoadBelmont, CA 94002

vyatta.com650 413 7200

1 888 VYATTA 1 (US and Canada)

OSPF REFERENCE GUIDE

VYATTA, INC. | Vyatta System

Title

Page 2: Vyatta - OSPF

COPYRIGHT

Copyright © 2005–2009 Vyatta, Inc. All rights reserved.

Vyatta reserves the right to make changes to software, hardware, and documentation without notice. For the most recent version of documentation, visit the Vyatta web site at vyatta.com.

PROPRIETARY NOTICES

Vyatta is a registered trademark of Vyatta, Inc.

VMware, VMware ESX, and VMware server are trademarks of VMware, Inc.

All other trademarks are the property of their respective owners.

ISSUE DATE: February 2009

DOCUMENT REVISION. VC5 v03

RELEASED WITH: VC5.0.2

PART NO. A0-0117-10-0002

Copyright

Page 3: Vyatta - OSPF

iii

Table of Contents

Quick Reference to Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x

Quick List of Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii

Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviii

Organization of This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviii

Document Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xx

Advisory Paragraphs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xx

Typographic Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xx

Vyatta Publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxi

Chapter 1 Router-Level Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

OSPF Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

debug ospf event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

debug ospf ism . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

debug ospf lsa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

debug ospf nsm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

debug ospf nssa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

debug ospf packet all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

debug ospf packet dd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

debug ospf packet hello . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

debug ospf packet ls-ack . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

debug ospf packet ls-request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

debug ospf packet ls-update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

debug ospf zebra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

protocols ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

protocols ospf access-list <list-num> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

protocols ospf auto-cost reference-bandwidth <bandwidth> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

protocols ospf default-information originate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

protocols ospf default-metric <metric> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Page 4: Vyatta - OSPF

OSPF Rel VC5 v. 03 Vyatta

iv

protocols ospf distance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

protocols ospf log-adjacency-changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

protocols ospf max-metric router-lsa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

protocols ospf mpls-te . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

protocols ospf neighbor <ipv4> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

protocols ospf parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

protocols ospf passive-interface <ethx> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

protocols ospf redistribute bgp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

protocols ospf redistribute connected . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

protocols ospf redistribute kernel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

protocols ospf redistribute rip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

protocols ospf redistribute static . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

protocols ospf refresh timers <value> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

protocols ospf timers throttle spf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

show debugging ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

show ip ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

show ip ospf border-routers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

show ip ospf database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

show ip ospf interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

show ip ospf neighbor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

show ip ospf route . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

show ip route ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Chapter 2 OSPF Areas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

OSPF Area Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

protocols ospf area <area-id> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

protocols ospf area <area-id> area-type normal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

protocols ospf area <area-id> area-type nssa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

protocols ospf area <area-id> area-type stub . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

protocols ospf area <area-id> authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

protocols ospf area <area-id> network <ipv4net> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

protocols ospf area <area-id> range <ip4net> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

protocols ospf area <area-id> shortcut <mode> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

protocols ospf area <area-id> virtual-link <ipv4> authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

protocols ospf area <area-id> virtual-link <ipv4> dead-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

protocols ospf area <area-id> virtual-link <ipv4> hello-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

protocols ospf area <area-id> virtual-link <ipv4> retransmit-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

protocols ospf area <area-id> virtual-link <ipv4> transmit-delay <delay> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

show debugging ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

show ip ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

show ip ospf border-routers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

show ip ospf database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

show ip ospf interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

show ip ospf neighbor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

Page 5: Vyatta - OSPF

OSPF Rel VC5 v. 03 Vyatta

v

show ip ospf route . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101

show ip route ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

Chapter 3 Ethernet Interfaces and Vifs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

Ethernet Interface and Vif OSPF Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

interfaces ethernet <ethx> ip ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

interfaces ethernet <ethx> ip ospf authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

interfaces ethernet <ethx> ip ospf bandwidth <bandwidth> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

interfaces ethernet <ethx> ip ospf cost <cost> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

interfaces ethernet <ethx> ip ospf dead-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115

interfaces ethernet <ethx> ip ospf hello-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

interfaces ethernet <ethx> ip ospf mtu-ignore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119

interfaces ethernet <ethx> ip ospf network <type> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

interfaces ethernet <ethx> ip ospf priority <priority> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

interfaces ethernet <ethx> ip ospf retransmit-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125

interfaces ethernet <ethx> ip ospf transmit-delay <delay> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

interfaces ethernet <ethx> vif <vlan-id> ip ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129

interfaces ethernet <ethx> vif <vlan-id> ip ospf authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131

interfaces ethernet <ethx> vif <vlan-id> ip ospf bandwidth <bandwidth> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134

interfaces ethernet <ethx> vif <vlan-id> ip ospf cost <cost> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136

interfaces ethernet <ethx> vif <vlan-id> ip ospf dead-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139

interfaces ethernet <ethx> vif <vlan-id> ip ospf hello-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141

interfaces ethernet <ethx> vif <vlan-id> ip ospf mtu-ignore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143

interfaces ethernet <ethx> vif <vlan-id> ip ospf network <type> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145

interfaces ethernet <ethx> vif <vlan-id> ip ospf priority <priority> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147

interfaces ethernet <ethx> vif <vlan-id> ip ospf retransmit-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . 149

interfaces ethernet <ethx> vif <vlan-id> ip ospf transmit-delay <delay> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151

Chapter 4 Ethernet PPPoE Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153

Ethernet PPPoE Interface OSPF Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154

interfaces ethernet <ethx> pppoe <num> ip ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155

interfaces ethernet <ethx> pppoe <num> ip ospf authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157

interfaces ethernet <ethx> pppoe <num> ip ospf bandwidth <bandwidth> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160

interfaces ethernet <ethx> pppoe <num> ip ospf cost <cost> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162

interfaces ethernet <ethx> pppoe <num> ip ospf dead-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165

interfaces ethernet <ethx> pppoe <num> ip ospf hello-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167

interfaces ethernet <ethx> pppoe <num> ip ospf mtu-ignore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169

interfaces ethernet <ethx> pppoe <num> ip ospf network <type> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

interfaces ethernet <ethx> pppoe <num> ip ospf priority <priority> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173

interfaces ethernet <ethx> pppoe <num> ip ospf retransmit-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . 175

interfaces ethernet <ethx> pppoe <num> ip ospf transmit-delay <delay> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177

Page 6: Vyatta - OSPF

OSPF Rel VC5 v. 03 Vyatta

vi

Chapter 5 Loopback Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179

Loopback Interface OSPF Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180

interfaces loopback lo ip ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181

interfaces loopback lo ip ospf authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182

interfaces loopback lo ip ospf cost <cost> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184

interfaces loopback lo ip ospf dead-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186

interfaces loopback lo ip ospf hello-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188

interfaces loopback lo ip ospf mtu-ignore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190

interfaces loopback lo ip ospf network <type> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192

interfaces loopback lo ip ospf priority <priority> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194

interfaces loopback lo ip ospf retransmit-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196

interfaces loopback lo ip ospf transmit-delay <delay> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198

Chapter 6 Serial PPP Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200

Serial PPP Interface OSPF Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201

interfaces serial <wanx> ppp vif 1 ip ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202

interfaces serial <wanx> ppp vif 1 ip ospf authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204

interfaces serial <wanx> ppp vif 1 ip ospf bandwidth <bandwidth> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207

interfaces serial <wanx> ppp vif 1 ip ospf cost <cost> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209

interfaces serial <wanx> ppp vif 1 ip ospf dead-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212

interfaces serial <wanx> ppp vif 1 ip ospf hello-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214

interfaces serial <wanx> ppp vif 1 ip ospf mtu-ignore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216

interfaces serial <wanx> ppp vif 1 ip ospf network <type> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218

interfaces serial <wanx> ppp vif 1 ip ospf priority <priority> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220

interfaces serial <wanx> ppp vif 1 ip ospf retransmit-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222

interfaces serial <wanx> ppp vif 1 ip ospf transmit-delay <delay> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224

Chapter 7 Serial Cisco HDLC Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226

Serial Cisco HDLC OSPF Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf bandwidth <bandwidth> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf cost <cost> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf dead-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf hello-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf mtu-ignore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf network <type> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf priority <priority> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf retransmit-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . 248

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf transmit-delay <delay> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250

Page 7: Vyatta - OSPF

OSPF Rel VC5 v. 03 Vyatta

vii

Chapter 8 Serial Frame Relay Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252

Frame Relay Interface OSPF Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253

interfaces serial <wanx> frame-relay vif <dlci> ip ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254

interfaces serial <wanx> frame-relay vif <dlci> ip ospf authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256

interfaces serial <wanx> frame-relay vif <dlci> ip ospf bandwidth <bandwidth> . . . . . . . . . . . . . . . . . . . . . . . . . 259

interfaces serial <wanx> frame-relay vif <dlci> ip ospf cost <cost> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261

interfaces serial <wanx> frame-relay vif <dlci> ip ospf dead-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . 264

interfaces serial <wanx> frame-relay vif <dlci> ip ospf hello-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . 266

interfaces serial <wanx> frame-relay vif <dlci> ip ospf mtu-ignore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268

interfaces serial <wanx> frame-relay vif <dlci> ip ospf network <type> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270

interfaces serial <wanx> frame-relay vif <dlci> ip ospf priority <priority> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272

interfaces serial <wanx> frame-relay vif <dlci> ip ospf retransmit-interval <interval> . . . . . . . . . . . . . . . . . . . . . . 274

interfaces serial <wanx> frame-relay vif <dlci> ip ospf transmit-delay <delay> . . . . . . . . . . . . . . . . . . . . . . . . . . . 276

Chapter 9 DSL Classical IPOA Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278

DSL Classical IPOA Interface OSPF Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf bandwidth <bandwidth> . . . . . . . . . . . . . . . . . . . . . . 285

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf cost <cost> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf dead-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . 290

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf hello-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . 292

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf mtu-ignore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf network <type> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf priority <priority> . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf retransmit-interval <interval> . . . . . . . . . . . . . . . . . . . 300

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf transmit-delay <delay> . . . . . . . . . . . . . . . . . . . . . . . . 302

Chapter 10 DSL PPPoE Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304

DSL PPPoE Interface OSPF Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf bandwidth <bandwidth> . . . . . . . . . . . . . . . . . . . . . 311

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf cost <cost> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf dead-interval <interval> . . . . . . . . . . . . . . . . . . . . . . 316

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf hello-interval <interval> . . . . . . . . . . . . . . . . . . . . . . 318

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf mtu-ignore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf network <type> . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf priority <priority> . . . . . . . . . . . . . . . . . . . . . . . . . . . 324

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf retransmit-interval <interval> . . . . . . . . . . . . . . . . . . 326

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf transmit-delay <delay> . . . . . . . . . . . . . . . . . . . . . . . 328

Page 8: Vyatta - OSPF

OSPF Rel VC5 v. 03 Vyatta

viii

Chapter 11 DSL PPPoA Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330

DSL PPPoA Interface OSPF Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf bandwidth <bandwidth> . . . . . . . . . . . . . . . . . . . . . 337

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf cost <cost> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf dead-interval <interval> . . . . . . . . . . . . . . . . . . . . . . 342

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf hello-interval <interval> . . . . . . . . . . . . . . . . . . . . . . 344

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf mtu-ignore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf network <type> . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf priority <priority> . . . . . . . . . . . . . . . . . . . . . . . . . . . 350

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf retransmit-interval <interval> . . . . . . . . . . . . . . . . . . 352

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf transmit-delay <delay> . . . . . . . . . . . . . . . . . . . . . . . 354

Chapter 12 DSL Bridged Ethernet Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356

DSL Bridged Ethernet Interface OSPF Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf bandwidth <bandwidth> . . . . . . . . . . . . . . . . . . . 363

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf cost <cost> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf dead-interval <interval> . . . . . . . . . . . . . . . . . . . . 368

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf hello-interval <interval> . . . . . . . . . . . . . . . . . . . . 370

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf mtu-ignore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf network <type> . . . . . . . . . . . . . . . . . . . . . . . . . . 374

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf priority <priority> . . . . . . . . . . . . . . . . . . . . . . . . . 376

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf retransmit-interval <interval> . . . . . . . . . . . . . . . . 378

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf transmit-delay <delay> . . . . . . . . . . . . . . . . . . . . . 380

Chapter 13 Multilink Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382

Multilink Interface OSPF Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383

interfaces multilink <mlx> ip ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384

interfaces multilink <mlx> ip ospf authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386

interfaces multilink <mlx> ip ospf bandwidth <bandwidth> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388

interfaces multilink <mlx> ip ospf cost <cost> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390

interfaces multilink <mlx> ip ospf dead-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392

interfaces multilink <mlx> ip ospf hello-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394

interfaces multilink <mlx> ip ospf mtu-ignore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396

interfaces multilink <mlx> ip ospf network <type> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398

interfaces multilink <mlx> ip ospf priority <priority> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400

interfaces multilink <mlx> ip ospf retransmit-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402

interfaces multilink <mlx> ip ospf transmit-delay <delay> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404

Page 9: Vyatta - OSPF

OSPF Rel VC5 v. 03 Vyatta

ix

Chapter 14 Tunnel Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406

Tunnel Interface OSPF Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407

interfaces tunnel <tunx> ip ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408

interfaces tunnel <tunx> ip ospf authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409

interfaces tunnel <tunx> ip ospf bandwidth <bandwidth> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411

interfaces tunnel <tunx> ip ospf cost <cost> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413

interfaces tunnel <tunx> ip ospf dead-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415

interfaces tunnel <tunx> ip ospf hello-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417

interfaces tunnel <tunx> ip ospf mtu-ignore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419

interfaces tunnel <tunx> ip ospf network <type> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421

interfaces tunnel <tunx> ip ospf priority <priority> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423

interfaces tunnel <tunx> ip ospf retransmit-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425

interfaces tunnel <tunx> ip ospf transmit-delay <delay> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427

Glossary of Acronyms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429

Page 10: Vyatta - OSPF

x

Quick Reference to Commands

Use this section to help you quickly locate a command.

debug ospf event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

debug ospf ism . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

debug ospf lsa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

debug ospf nsm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

debug ospf nssa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

debug ospf packet all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

debug ospf packet dd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

debug ospf packet hello . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

debug ospf packet ls-ack . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

debug ospf packet ls-request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

debug ospf packet ls-update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

debug ospf zebra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf bandwidth <bandwidth> . . . . . . . . . . . . . . . . . . . . . . . 363

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf cost <cost> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf dead-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . 368

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf hello-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . 370

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf mtu-ignore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf network <type> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf priority <priority> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf retransmit-interval <interval> . . . . . . . . . . . . . . . . . . . . 378

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf transmit-delay <delay> . . . . . . . . . . . . . . . . . . . . . . . . . 380

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf bandwidth <bandwidth> . . . . . . . . . . . . . . . . . . . . . . . . . . 285

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf cost <cost> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf dead-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . 290

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf hello-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . 292

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf mtu-ignore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf network <type> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf priority <priority> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298

Page 11: Vyatta - OSPF

OSPF Rel VC5 v. 03 Vyatta

xi

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf retransmit-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . 300

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf transmit-delay <delay> . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf bandwidth <bandwidth> . . . . . . . . . . . . . . . . . . . . . . . . . 337

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf cost <cost> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf dead-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . 342

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf hello-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . 344

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf mtu-ignore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf network <type> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf priority <priority> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf retransmit-interval <interval> . . . . . . . . . . . . . . . . . . . . . . 352

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf transmit-delay <delay> . . . . . . . . . . . . . . . . . . . . . . . . . . . 354

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf bandwidth <bandwidth> . . . . . . . . . . . . . . . . . . . . . . . . . 311

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf cost <cost> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf dead-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . 316

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf hello-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . 318

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf mtu-ignore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf network <type> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf priority <priority> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf retransmit-interval <interval> . . . . . . . . . . . . . . . . . . . . . . 326

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf transmit-delay <delay> . . . . . . . . . . . . . . . . . . . . . . . . . . . 328

interfaces ethernet <ethx> ip ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

interfaces ethernet <ethx> ip ospf authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

interfaces ethernet <ethx> ip ospf bandwidth <bandwidth> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

interfaces ethernet <ethx> ip ospf cost <cost> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

interfaces ethernet <ethx> ip ospf dead-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115

interfaces ethernet <ethx> ip ospf hello-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

interfaces ethernet <ethx> ip ospf mtu-ignore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119

interfaces ethernet <ethx> ip ospf network <type> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

interfaces ethernet <ethx> ip ospf priority <priority> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

interfaces ethernet <ethx> ip ospf retransmit-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125

interfaces ethernet <ethx> ip ospf transmit-delay <delay> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

interfaces ethernet <ethx> pppoe <num> ip ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155

interfaces ethernet <ethx> pppoe <num> ip ospf authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157

interfaces ethernet <ethx> pppoe <num> ip ospf bandwidth <bandwidth> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160

interfaces ethernet <ethx> pppoe <num> ip ospf cost <cost> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162

interfaces ethernet <ethx> pppoe <num> ip ospf dead-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165

interfaces ethernet <ethx> pppoe <num> ip ospf hello-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167

interfaces ethernet <ethx> pppoe <num> ip ospf mtu-ignore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169

interfaces ethernet <ethx> pppoe <num> ip ospf network <type> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

interfaces ethernet <ethx> pppoe <num> ip ospf priority <priority> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173

Page 12: Vyatta - OSPF

OSPF Rel VC5 v. 03 Vyatta

xii

interfaces ethernet <ethx> pppoe <num> ip ospf retransmit-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175

interfaces ethernet <ethx> pppoe <num> ip ospf transmit-delay <delay> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177

interfaces ethernet <ethx> vif <vlan-id> ip ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129

interfaces ethernet <ethx> vif <vlan-id> ip ospf authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131

interfaces ethernet <ethx> vif <vlan-id> ip ospf bandwidth <bandwidth> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134

interfaces ethernet <ethx> vif <vlan-id> ip ospf cost <cost> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136

interfaces ethernet <ethx> vif <vlan-id> ip ospf dead-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139

interfaces ethernet <ethx> vif <vlan-id> ip ospf hello-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141

interfaces ethernet <ethx> vif <vlan-id> ip ospf mtu-ignore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143

interfaces ethernet <ethx> vif <vlan-id> ip ospf network <type> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145

interfaces ethernet <ethx> vif <vlan-id> ip ospf priority <priority> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147

interfaces ethernet <ethx> vif <vlan-id> ip ospf retransmit-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149

interfaces ethernet <ethx> vif <vlan-id> ip ospf transmit-delay <delay> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151

interfaces loopback lo ip ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181

interfaces loopback lo ip ospf authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182

interfaces loopback lo ip ospf cost <cost> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184

interfaces loopback lo ip ospf dead-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186

interfaces loopback lo ip ospf hello-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188

interfaces loopback lo ip ospf mtu-ignore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190

interfaces loopback lo ip ospf network <type> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192

interfaces loopback lo ip ospf priority <priority> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194

interfaces loopback lo ip ospf retransmit-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196

interfaces loopback lo ip ospf transmit-delay <delay> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198

interfaces multilink <mlx> ip ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384

interfaces multilink <mlx> ip ospf authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386

interfaces multilink <mlx> ip ospf bandwidth <bandwidth> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388

interfaces multilink <mlx> ip ospf cost <cost> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390

interfaces multilink <mlx> ip ospf dead-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392

interfaces multilink <mlx> ip ospf hello-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394

interfaces multilink <mlx> ip ospf mtu-ignore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396

interfaces multilink <mlx> ip ospf network <type> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398

interfaces multilink <mlx> ip ospf priority <priority> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400

interfaces multilink <mlx> ip ospf retransmit-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402

interfaces multilink <mlx> ip ospf transmit-delay <delay> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf bandwidth <bandwidth> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf cost <cost> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf dead-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf hello-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf mtu-ignore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf network <type> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf priority <priority> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf retransmit-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248

Page 13: Vyatta - OSPF

OSPF Rel VC5 v. 03 Vyatta

xiii

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf transmit-delay <delay> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250

interfaces serial <wanx> frame-relay vif <dlci> ip ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254

interfaces serial <wanx> frame-relay vif <dlci> ip ospf authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256

interfaces serial <wanx> frame-relay vif <dlci> ip ospf bandwidth <bandwidth> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259

interfaces serial <wanx> frame-relay vif <dlci> ip ospf cost <cost> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261

interfaces serial <wanx> frame-relay vif <dlci> ip ospf dead-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264

interfaces serial <wanx> frame-relay vif <dlci> ip ospf hello-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266

interfaces serial <wanx> frame-relay vif <dlci> ip ospf mtu-ignore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268

interfaces serial <wanx> frame-relay vif <dlci> ip ospf network <type> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270

interfaces serial <wanx> frame-relay vif <dlci> ip ospf priority <priority> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272

interfaces serial <wanx> frame-relay vif <dlci> ip ospf retransmit-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . 274

interfaces serial <wanx> frame-relay vif <dlci> ip ospf transmit-delay <delay> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276

interfaces serial <wanx> ppp vif 1 ip ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202

interfaces serial <wanx> ppp vif 1 ip ospf authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204

interfaces serial <wanx> ppp vif 1 ip ospf bandwidth <bandwidth> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207

interfaces serial <wanx> ppp vif 1 ip ospf cost <cost> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209

interfaces serial <wanx> ppp vif 1 ip ospf dead-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212

interfaces serial <wanx> ppp vif 1 ip ospf hello-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214

interfaces serial <wanx> ppp vif 1 ip ospf mtu-ignore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216

interfaces serial <wanx> ppp vif 1 ip ospf network <type> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218

interfaces serial <wanx> ppp vif 1 ip ospf priority <priority> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220

interfaces serial <wanx> ppp vif 1 ip ospf retransmit-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222

interfaces serial <wanx> ppp vif 1 ip ospf transmit-delay <delay> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224

interfaces tunnel <tunx> ip ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408

interfaces tunnel <tunx> ip ospf authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409

interfaces tunnel <tunx> ip ospf bandwidth <bandwidth> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411

interfaces tunnel <tunx> ip ospf cost <cost> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413

interfaces tunnel <tunx> ip ospf dead-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415

interfaces tunnel <tunx> ip ospf hello-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417

interfaces tunnel <tunx> ip ospf mtu-ignore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419

interfaces tunnel <tunx> ip ospf network <type> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421

interfaces tunnel <tunx> ip ospf priority <priority> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423

interfaces tunnel <tunx> ip ospf retransmit-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425

interfaces tunnel <tunx> ip ospf transmit-delay <delay> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427

protocols ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

protocols ospf access-list <list-num> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

protocols ospf area <area-id> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

protocols ospf area <area-id> area-type normal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

protocols ospf area <area-id> area-type nssa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

protocols ospf area <area-id> area-type stub . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

protocols ospf area <area-id> authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

protocols ospf area <area-id> network <ipv4net> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

protocols ospf area <area-id> range <ip4net> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

protocols ospf area <area-id> shortcut <mode> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

Page 14: Vyatta - OSPF

OSPF Rel VC5 v. 03 Vyatta

xiv

protocols ospf area <area-id> virtual-link <ipv4> authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

protocols ospf area <area-id> virtual-link <ipv4> dead-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

protocols ospf area <area-id> virtual-link <ipv4> hello-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

protocols ospf area <area-id> virtual-link <ipv4> retransmit-interval <interval> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

protocols ospf area <area-id> virtual-link <ipv4> transmit-delay <delay> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

protocols ospf auto-cost reference-bandwidth <bandwidth> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

protocols ospf default-information originate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

protocols ospf default-metric <metric> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

protocols ospf distance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

protocols ospf log-adjacency-changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

protocols ospf max-metric router-lsa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

protocols ospf mpls-te . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

protocols ospf neighbor <ipv4> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

protocols ospf parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

protocols ospf passive-interface <ethx> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

protocols ospf redistribute bgp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

protocols ospf redistribute connected . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

protocols ospf redistribute kernel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

protocols ospf redistribute rip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

protocols ospf redistribute static . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

protocols ospf refresh timers <value> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

protocols ospf timers throttle spf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

show debugging ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

show debugging ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

show ip ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

show ip ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

show ip ospf border-routers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

show ip ospf border-routers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

show ip ospf database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

show ip ospf database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

show ip ospf interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

show ip ospf interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

show ip ospf neighbor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

show ip ospf neighbor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

show ip ospf route . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101

show ip ospf route . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

show ip route ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

show ip route ospf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Page 15: Vyatta - OSPF

xv

Quick List of Examples

Use this list to help you locate examples you’d like to try or look at.

Example 1-1 “show ip ospf”: Displaying OSPF configuration information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

Example 1-2 “show ip ospf border-router”: Displaying OSPF border router information . . . . . . . . . . . . . . . . . . . . . . . 54

Example 1-3 “show ip ospf database”: Displaying general OSPF database information . . . . . . . . . . . . . . . . . . . . . . . . 56

Example 1-4 “show ip ospf interface”: Displaying OSPF configuration and status information . . . . . . . . . . . . . . . . . . . 57

Example 1-5 “show ip ospf neighbor”: Displaying OSPF neighbor information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Example 1-6 “show ip ospf route”: Displaying OSPF route information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

Example 1-7 “show ip route ospf”: Displaying routes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Example 2-1 “show ip ospf”: Displaying OSPF configuration information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

Example 2-2 “show ip ospf border-router”: Displaying OSPF border router information . . . . . . . . . . . . . . . . . . . . . . . 94

Example 2-3 “show ip ospf database”: Displaying general OSPF database information . . . . . . . . . . . . . . . . . . . . . . . . 96

Example 2-4 “show ip ospf interface”: Displaying OSPF configuration and status information . . . . . . . . . . . . . . . . . . . 97

Example 2-5 “show ip ospf neighbor”: Displaying OSPF neighbor information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

Example 2-6 “show ip ospf route”: Displaying OSPF route information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101

Example 2-7 “show ip route ospf”: Displaying routes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

Page 16: Vyatta - OSPF

OSPF Rel VC5 v. 03 Vyatta

xvi

Page 17: Vyatta - OSPF

xvii

Preface

This guide describes commands for the Open Shortest Path First (OSPF) routing protocol.

This preface provides information about using this guide. The following topics are covered:

• Intended Audience

• Organization of This Guide

• Document Conventions

• Vyatta Publications

Page 18: Vyatta - OSPF

Intended Audience

OSPF Rel VC5 v. 03 Vyatta

xvii

Intended Audience

This guide is intended for experienced system and network administrators. Depending on the functionality to be used, readers should have specific knowledge in the following areas:

• Networking and data communications

• TCP/IP protocols

• General router configuration

• Routing protocols

• Network administration

• Network security

Organization of This GuideThis guide has the following aid to help you find the information you are looking for:

• Quick Reference to Commands

Use this section to help you quickly locate a command.

• Quick List of Examples

Use this list to help you locate examples you’d like to try or look at.

This guide has the following chapters:

Chapter Description Page

Chapter 1: Router-Level Configuration

This chapter describes commands for router-level OSPF configuration.

1

Chapter 2: OSPF Areas This chapter describes commands for configuring OSPF areas.

64

Chapter 3: Ethernet Interfaces and Vifs

This chapter describes commands for configuring OSPF on Ethernet interfaces and Ethernet vifs.

104

Chapter 4: Ethernet PPPoE Interfaces

This chapter describes commands for configuring OSPF on Ethernet interfaces with PPPoE encapsulation.

104

Chapter 5: Loopback Interfaces This chapter describes commands for configuring OSPF on loopback interfaces.

179

Page 19: Vyatta - OSPF

Organization of This Guide

OSPF Rel VC5 v. 03 Vyatta

xix

Chapter 6: Serial PPP Interfaces This chapter describes commands for configuring OSPF on serial interfaces with Point-to-Point Protocol encapsulation.

200

Chapter 7: Serial Cisco HDLC Interfaces

This chapter describes commands for configuring OSPF on serial interfaces with Cisco HDLC encapsulation.

226

Chapter 8: Serial Frame Relay Interfaces

This chapter describes commands for configuring OSPF on serial interfaces with Frame Relay encapsulation.

252

Chapter 9: DSL Classical IPOA Interfaces

This chapter describes commands for configuring OSPF on DSL interfaces with Classical Internet Protocol over Asynchronous Transfer Mode (Classical IPOA) encapsulation.

278

Chapter 10: DSL PPPoE Interfaces This chapter describes commands for configuring OSPF on DSL interfaces with Point-to-Point Protocol over Ethernet (PPPoE) encapsulation.

304

Chapter 11: DSL PPPoA Interfaces This chapter describes commands for configuring OSPF on DSL interfaces with Point-to-Point Protocol over Asynchronous Transfer Mode (PPPoA) encapsulation.

330

Chapter 12: DSL Bridged Ethernet Interfaces

This chapter describes commands for configuring OSPF on DSL interfaces with RFC 2684 bridged Ethernet encapsulation.

356

Chapter 13: Multilink Interfaces This chapter describes commands for configuring OSPF on multilink interfaces.

382

Chapter 14: Tunnel Interfaces This chapter describes commands for configuring OSPF on tunnel interfaces.

406

Glossary of Acronyms 429

Page 20: Vyatta - OSPF

Document Conventions

OSPF Rel VC5 v. 03 Vyatta

xx

Document ConventionsThis guide contains advisory paragraphs and uses typographic conventions.

Advisory ParagraphsThis guide uses the following advisory paragraphs:

Warnings alert you to situations that may pose a threat to personal safety, as in the following example:

Cautions alert you to situations that might cause harm to your system or damage to equipment, or that may affect service, as in the following example:

Notes provide information you might need to avoid problems or configuration errors:

NOTE You must create and configure network interfaces before enabling them for

routing protocols.

Typographic ConventionsThis document uses the following typographic conventions:

WARNING Risk of injury. Switch off power at the main breaker before attempting to connect the remote cable to the service power at the utility box.

CAUTION Risk of loss of service. Restarting a running system will interrupt service.

Courier Examples, command-line output, and representations of configuration nodes.

boldface Courier

In an example, your input: something you type at a command line.

boldface In-line commands, keywords, and file names .

italics Arguments and variables, where you supply a value.

<key> A key on your keyboard. Combinations of keys are joined by plus signs (“+”). An example is <Ctrl>+<Alt>+<Del>.

[ arg1 | arg2] Enumerated options for completing a syntax. An example is [enable | disable].

Page 21: Vyatta - OSPF

Vyatta Publications

OSPF Rel VC5 v. 03 Vyatta

xxi

Vyatta PublicationsMore information about the Vyatta system is available in the Vyatta technical library, and on www.vyatta.com and www.vyatta.org.

Full product documentation is provided in the Vyatta technical library. To see what documentation is available for your release, see the Vyatta Documentation Map. This guide is posted with every release of Vyatta software and provides a great starting point for finding what you need.

num1–numN A inclusive range of numbers. An example is 1–65535, which means 1 through 65535.

arg1..argN A range of enumerated values. An example is eth0..eth3, which means eth0, eth1, eth2, and eth3.

arg [arg ...]arg,[arg,...]

A value that can optionally represent a list of elements (a space-separated list in the first case, and a comma-separated list in the second case).

Page 22: Vyatta - OSPF

1

Chapter 1: Router-Level Configuration

This chapter describes commands for router-level OSPF configuration.

This chapter presents the following topics:

• OSPF Commands

Page 23: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

2

OSPF CommandsThis chapter contains the following commands.

Configuration Commands

protocols ospf Enables the Open Shortest Path First (OSPF) routing protocol on the router.

protocols ospf access-list <list-num> Specifies access list to filter networks in routing updates.

protocols ospf auto-cost reference-bandwidth <bandwidth>

Directs the system to use the reference bandwidth method for calculating administrative cost.

protocols ospf default-information originate Sets the characteristics of an external default route originated into an OSPF routing domain.

protocols ospf default-metric <metric> Sets default metric to be applied to routes being redistributed into OSPF.

protocols ospf distance Sets the OSPF administrative distance by route type.

protocols ospf log-adjacency-changes Enables or disables logging of changes in adjacency state of neighbors.

protocols ospf max-metric router-lsa Enables or disables an OSPF stub router to advertise a maximum metric value when the router is started up or reloaded.

protocols ospf mpls-te Sets Multi-Protocol Label Switching (MPLS) Traffic Engineering (MPLS-TE) parameters.

protocols ospf neighbor <ipv4> Defines an OSPF neighbor.

protocols ospf parameters Sets global OSPF parameters, such as router ID.

protocols ospf passive-interface <ethx> Suppress routing updates on an interface.

protocols ospf refresh timers <value> Sets values for OSPF refresh timers.

protocols ospf timers throttle spf Enables or disables OSPF SPF throttling.

OSPF Route Redistribution Commands

protocols ospf redistribute bgp Sets the parameters for redistribution of BGP routes into OSPF.

protocols ospf redistribute connected Sets the parameters for redistribution of connected routes into OSPF.

protocols ospf redistribute kernel Sets the parameters for redistribution of kernel routes into OSPF.

Page 24: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

3

protocols ospf redistribute rip Sets the parameters for redistribution of RIP routes into OSPF.

protocols ospf redistribute static Sets the parameters for redistribution of static routes into OSPF.

Operational Commands

debug ospf event Enables or disables debug message generation related to OSPF events.

debug ospf ism Enables or disables debug message generation related to the OSPF ISM.

debug ospf lsa Enables or disables debug message generation related to OSPF link-state advertisements (LSAs).

debug ospf nsm Enables or disables debug message generation related to the OSPF NSM.

debug ospf nssa Enables or disables debug message generation related to OSPF not-so-stubby areas (NSSAs).

debug ospf packet all Enables or disables debug message generation related to all OSPF packets.

debug ospf packet dd Enables or disables debug message generation related to OSPF Database Description (DD) packets.

debug ospf packet hello Enables or disables debug message generation related to OSPF hello packets.

debug ospf packet ls-ack Enables or disables debug message generation related to OSPF link-state acknowledgement (LS Ack) packets.

debug ospf packet ls-request Enables or disables debug message generation related to OSPF link-state request (LSR) packets.

debug ospf packet ls-update Enables or disables debug message generation related to OSPF link-state update (LSU) packets.

debug ospf zebra Enables or disables debug message generation for the Zebra OSPF process.

Page 25: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

4

show debugging ospf Displays OSPF protocol debugging flags.

show ip ospf Displays high-level OSPF configuration information.

show ip ospf border-routers Displays OSPF border router information.

show ip ospf database Displays OSPF database information.

show ip ospf interface Displays OSPF configuration and status information for a specified interface.

show ip ospf neighbor Displays OSPF neighbor information for a specified address or interface.

show ip ospf route Displays OSPF route information.

show ip route ospf Displays all IP OSPF routes.

Page 26: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

5

debug ospf event

Enables or disables debug message generation related to OSPF events.

Syntax

debug ospf event

no debug ospf event

Command Mode

Operational mode.

Parameters

None.

Default

None.

Usage Guidelines

Use this command to enable generation of trace-level messages related to OSPF events.

Use the no form of this command to disable debugging for OSPF events.

Page 27: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

6

debug ospf ism

Enables or disables debug message generation related to the OSPF ISM.

Syntax

debug ospf ism [events | status | timers]

no debug ospf ism [events | status | timers]

Command Mode

Operational mode.

Parameters

Default

When used with no option, this command enables or disables all OSPF ISM messages.

Usage Guidelines

Use this command to enable generation of trace-level messages related to the OSPF ISM.

Use the no form of this command to disable debugging for the OSPF ISM.

events Optional. Enables or disables debug message generation related to OSPF ISM events.

status Optional. Enables or disables debug message generation related to OSPF ISM status.

timers Optional. Enables or disables debug message generation related to OSPF ISM timers.

Page 28: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

7

debug ospf lsa

Enables or disables debug message generation related to OSPF link-state advertisements (LSAs).

Syntax

debug ospf lsa [flooding | generate | install | refresh]

no debug ospf lsa [flooding | generate | install | refresh]

Command Mode

Operational mode.

Parameters

Default

When used with no option, this command enables debugging for all OSPF link-state advertisement activity.

Usage Guidelines

Use this command to enable generation of trace-level messages related to OSPF link-state advertisements.

Use the no form of this command to disable debugging for OSPF link-state advertisements.

flooding Optional. Generates messages related to OSPF LSA flood events.

generate Optional. Generates messages relates to OSPF LSA generation.

install Optional. Generates messages relates to OSPF LSA installation.

refresh Optional. Generates messages relates to OSPF LSA refreshes.

Page 29: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

8

debug ospf nsm

Enables or disables debug message generation related to the OSPF NSM.

Syntax

debug ospf nsm [events | status | timers]

no debug ospf nsm [events | status | timers]

Command Mode

Operational mode.

Parameters

Default

When used with no option, this command enables or disables all OSPF NSM messages.

Usage Guidelines

Use this command to enable generation of trace-level messages related to the OSPF NSM.

Use the no form of this command to disable debugging for the OSPF NSM.

events Optional. Enables or disables debug message generation related to OSPF NSM events.

status Optional. Enables or disables debug message generation related to OSPF NSM status.

timers Optional. Enables or disables debug message generation related to OSPF NSM timers.

Page 30: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

9

debug ospf nssa

Enables or disables debug message generation related to OSPF not-so-stubby areas (NSSAs).

Syntax

debug ospf nssa

no debug ospf nssa

Command Mode

Operational mode.

Parameters

None.

Default

None.

Usage Guidelines

Use this command to enable generation of trace-level messages related to OSPF not-so-stubby areas (NSSAs).

Use the no form of this command to disable debugging for OSPF not-so-stubby areas (NSSAs).

Page 31: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

10

debug ospf packet all

Enables or disables debug message generation related to all OSPF packets.

Syntax

debug ospf packet all [detail | recv [detail] | send [detail]]

no debug ospf packet all [detail | recv [detail] | send [detail]]

Command Mode

Operational mode.

Parameters

Default

Debug messages are generated for all OSPF packets at a medium level of detail.

Usage Guidelines

Use this command to enable generation of trace-level messages related to all OSPF packet types arriving and leaving the router.

Use the no form of this command to disable debugging for all OSPF packet types.

detail Optional. Generates detailed debug messages for all OSPF packets, both sent and received.

recv Optional. Generates debug messages for all received OSPF packet types.

detail Optional. Generates detailed debug messages for all received OSPF packets.

send Optional. Generates debug messages for all transmitted OSPF packets.

detail Optional. Generates detailed debug messages for all transmitted OSPF packets.

Page 32: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

11

debug ospf packet dd

Enables or disables debug message generation related to OSPF Database Description (DD) packets.

Syntax

debug ospf packet dd [detail | recv [detail] | send [detail]]

no debug ospf packet dd [detail | recv [detail] | send [detail]]

Command Mode

Operational mode.

Parameters

Default

Debug messages are generated for OSPF DD packets at a medium level of detail.

Usage Guidelines

Use this command to enable generation of trace-level messages related to OSPF Database Description (DD) packets. OSPF DD packets provide a summary (digest) of each link-state advertisement in the link-state databases. OSPF routers exchange these packets to keep data synchronized.

Use the no form of this command to disable debugging for OSPF DD packets.

detail Optional. Generates detailed debug messages for OSPF DD packets, both sent and received.

recv Optional. Generates debug messages for received OSPF DD packets.

detail Optional. Generates detailed debug messages for received OSPF DD packets.

send Optional. Generates debug messages for transmitted OSPF DD packets.

detail Optional. Generates detailed debug messages for transmitted OSPF DD packets.

Page 33: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

12

debug ospf packet hello

Enables or disables debug message generation related to OSPF hello packets.

Syntax

debug ospf packet hello [detail | recv [detail] | send [detail]]

no debug ospf packet hello [detail | recv [detail] | send [detail]]

Command Mode

Operational mode.

Parameters

Default

Debug messages are generated for OSPF hello packets at a medium level of detail.

Usage Guidelines

Use this command to enable generation of trace-level messages related to OSPF hello packets. OSPF hello packets are sent at intervals to discover neighbors and ensure that neighbors are reachable. Hello packets include information about certain OSPF timers, the Designated Router (DR), the Backup Designated Router (BDR), and known neighbors.

Use the no form of this command to disable debugging for OSPF hello packets.

detail Optional. Generates detailed debug messages for OSPF hello packets, both sent and received.

recv Optional. Generates debug messages for received OSPF hello packets.

detail Optional. Generates detailed debug messages for received OSPF hello packets.

send Optional. Generates debug messages for transmitted OSPF hello packets.

detail Optional. Generates detailed debug messages for transmitted OSPF hello packets.

Page 34: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

13

debug ospf packet ls-ack

Enables or disables debug message generation related to OSPF link-state acknowledgement (LS Ack) packets.

Syntax

debug ospf packet ls-ack [detail | recv [detail] | send [detail]]

no debug ospf packet ls-ack [detail | recv [detail] | send [detail]]

Command Mode

Operational mode.

Parameters

Default

Debug messages are generated for OSPF LS Ack packets at a medium level of detail.

Usage Guidelines

Use this command to enable generation of trace-level messages related to OSPF LS Ack packets. LS Ack packets are sent to OSPF neighbors to acknowledge receipt of a neighbor's link-state advertisement update (LSU packet).

Use the no form of this command to disable debugging for OSPF LS Ack packets.

detail Optional. Generates detailed debug messages for OSPF LS Ack packets, both sent and received.

recv Optional. Generates debug messages for received OSPF LS Ack packets.

detail Optional. Generates detailed debug messages for received OSPF LS Ack packets.

send Optional. Generates debug messages for transmitted OSPF LS Ack packets.

detail Optional. Generates detailed debug messages for transmitted OSPF LS Ack packets.

Page 35: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

14

debug ospf packet ls-request

Enables or disables debug message generation related to OSPF link-state request (LSR) packets.

Syntax

debug ospf packet ls-request [detail | recv [detail] | send [detail]]

no debug ospf packet ls-request [detail | recv [detail] | send [detail]]

Command Mode

Operational mode.

Parameters

Default

Debug messages are generated for OSPF LSR packets at a medium level of detail.

Usage Guidelines

Use this command to enable generation of trace-level messages related to OSPF link-state request (LSR) packets. After exchanging Database Description packets, neighboring OSPF routers determine which LSAs are missing from the local link-state database. The local router sends an LSR packet to the neighbor to request the missing LSAs.

Use the no form of this command to disable debugging for OSPF LSR packets.

detail Optional. Generates detailed debug messages for OSPF LSR packets, both sent and received.

recv Optional. Generates debug messages for received OSPF LSR packets.

detail Optional. Generates detailed debug messages for received OSPF LSR packets.

send Optional. Generates debug messages for transmitted OSPF LSR packets.

detail Optional. Generates detailed debug messages for transmitted OSPF LSR packets.

Page 36: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

15

debug ospf packet ls-update

Enables or disables debug message generation related to OSPF link-state update (LSU) packets.

Syntax

debug ospf packet ls-update [detail | recv [detail] | send [detail]]

no debug ospf packet ls-update [detail | recv [detail] | send [detail]]

Command Mode

Operational mode.

Parameters

Default

Debug messages are generated for OSPF LSU packets at a medium level of detail.

Usage Guidelines

Use this command to enable generation of trace-level messages related to OSPF link-state update (LSU) packets. LSU packets send any required LSA updates to an OSPF neighbor.

Use the no form of this command to disable debugging for OSPF LSU packets.

detail Optional. Generates detailed debug messages for OSPF LSU packets, both sent and received.

recv Optional. Generates debug messages for received OSPF LSU packets.

detail Optional. Generates detailed debug messages for received OSPF LSU packets.

send Optional. Generates debug messages for transmitted OSPF LSU packets.

detail Optional. Generates detailed debug messages for transmitted OSPF LSU packets.

Page 37: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

16

debug ospf zebra

Enables or disables debug message generation for the Zebra OSPF process.

Syntax

debug ospf zebra [interface | redistribute]

no debug ospf zebra [interface | redistribute]

Command Mode

Operational mode.

Parameters

Default

Debug messages are generated for actions related to the Zebra OSPF process.

Usage Guidelines

Use this command to enable generation of trace-level messages related to the Zebra OSPF process.

Use the no form of this command to disable debugging for the Zebra OSPF process.

interface Optional. Generates debug messages for interfaces on which Zebra OSPF is enabled.

redistribute Optional. Generates debug messages for routes redistributed into Zebra OSPF.

Page 38: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

17

protocols ospf Enables the Open Shortest Path First (OSPF) routing protocol on the router.

Syntax

set protocols ospf

delete protocols ospf

show protocols ospf

Command Mode

Configuration mode.

Configuration Statement

protocols {ospf

}

Parameters

None

Default

None.

Usage Guidelines

Use this command to enable the Open Shortest Path First (OSPF) routing protocol on the system.

Use the set form of this command to enable the OSPF routing protocol.

Use the delete form of this command to disable OSPF and remove all OSPF configuration.

Use the show form of this command to display OSPF configuration.

Page 39: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

18

protocols ospf access-list <list-num>Specifies access list to filter networks in routing updates.

Syntax

set protocols ospf access-list list-num [export type]

delete protocols ospf access-list list-num [export type]

show protocols ospf access-list list-num

Command Mode

Configuration mode.

Configuration Statement

protocols {ospf {

access-list u32 {export text

}}

}

Parameters

Default

None.

Usage Guidelines

Use this command to specify an access list to filter networks in routing updates.

Use the set form of this command to specify an access list.

Use the delete form of this command to remove an access list.

list-num Mandatory. The access list number used to filter networks in routing updates.

type Optional. The type of routes to filter. Possible values include: bgp, connected, kernel, rip, or static. Multiple types can be specified by creating additional export configuration nodes.

Page 40: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

19

Use the show form of this command to display the configuration.

Page 41: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

20

protocols ospf auto-cost reference-bandwidth <bandwidth>

Directs the system to use the reference bandwidth method for calculating administrative cost.

Syntax

set protocols ospf auto-cost reference-bandwidth bandwidth

delete protocols ospf auto-cost reference-bandwidth

show protocols ospf auto-cost reference-bandwidth

Command Mode

Configuration mode.

Configuration Statement

protocols {ospf {

auto-cost {reference-bandwidth: 1-4294967

}}

}

Parameters

Default

The default reference bandwidth is 108.

bandwidth Mandatory. The reference bandwidth rate in Megabits per second. The range is 1 to 4294967.

Page 42: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

21

Usage Guidelines

Use this command to set a reference bandwidth for calculating OSPF cost. The OSPF metric is calculated as the reference bandwidth divided by actual bandwidth.

An explicitly set cost for an area overrides automatically calculated values.

Use the set form of this command to set the reference bandwidth.

Use the delete form of this command to restore the default reference bandwidth.

Use the show form of this command to display OSPF auto-cost configuration.

Page 43: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

22

protocols ospf default-information originateSets the characteristics of an external default route originated into an OSPF routing domain.

Syntax

set protocols ospf default-information originate [always | metric metric | metric-type type | route-map map-name]

delete protocols ospf default-information originate [always | metric | metric-type | route-map]

show protocols ospf default-information originate [always | metric | metric-type | route-map]

Command Mode

Configuration mode.

Configuration Statement

protocols {ospf {

default-information {originate {

alwaysmetric: 0-16777214metric-type: 1-2route-map: text

}}

}}

Parameters

always Optional. Always advertises the default route.

metric metric Optional. The metric to be applied to the default route. The range is 0 to 16777214. The default is 1.

Page 44: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

23

Default

By default, the system does not generate an external default route into the OSPF routing domain. When enabled to do so, the defaults depend on the type of area into which the default route is being advertised:

• In stub areas, a Type 3 link-state advertisement is generated with a metric of 1 and the metric type is ignored.

• In not-so-stubby areas (NSSAs) configured to import summary advertisements, a Type 7 LSA with a metric of 1 and a metric type of 2 is generated.

• In NSSAs configured not to import summary advertisements, a Type 3 LSA with metric of 1 and the metric type is ignored.

Usage Guidelines

Use this command to redistribute the default route (0.0.0.0) into an OSPF routing domain.

If you redistribute routes in this way, the router automatically becomes an Autonomous System Boundary Router (ASBR). The router must have a default route configured before it can generate one, unless the always keyword is specified.

Use the set form of this command to enable generation of external default route into the OSPF routing domain.

Use the delete form of this command to disable generation of external default route into the OSPF routing domain or to restore default parameter values.

Use the show form of this command to display default route distribution configuration.

metric-type type Optional. The external route metric type to be associated with the Type 5 default link-state advertisement (LSA). Supported values are as follows:

1: Type 1 external route.

2: Type 2 external route

The default is 2.

map-name Optional. The default route is generated if the specified route map is satisfied.

Page 45: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

24

protocols ospf default-metric <metric>Sets default metric to be applied to routes being redistributed into OSPF.

Syntax

set protocols ospf default-metric metric

delete protocols ospf default-metric

show protocols ospf default-metric

Command Mode

Configuration mode.

Configuration Statement

protocols {ospf {

default-metric: 0-16777214}

}

Parameters

Default

None.

Usage Guidelines

Use this command to set the default metric to be applied to routes from other protocols being redistributed into OSPF.

Use the set form of this command to set the default OSPF metric.

Use the delete form of this command to restore the default value for default metric.

Use the show form of this command to display OSPF default metric configuration.

metric Mandatory. The metric to be applied to routes from other protocols being redistributed into OSPF. The range is 0 to 16777214.

Page 46: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

25

protocols ospf distance Sets the OSPF administrative distance by route type.

Syntax

set protocols ospf distance {global global | ospf [external external | inter-area inter | intra-area intra]}

delete protocols ospf distance [global | ospf [external | inter-area | intra-area]]

show protocols ospf distance [global | ospf [external | inter-area | intra-area]]

Command Mode

Configuration mode.

Configuration Statement

protocols {ospf {

distance {global: 1-255ospf {

external: 1-255inter-area: 1-255intra-area: 1-255

}}

}}

Parameters

global Sets the administrative distance for all routes. The range is 1 to 255.

external Sets the OSPF administrative distance for external routes (routes learned from another protocol by redistribution). The range is 1 to 255. The default is 110.

inter Sets the OSPF administrative distance for inter-area routes (routes to another area). The range is 1 to 255. The default is 110.

intra Sets the OSPF administrative distance for intra-area routes (routes within an area). The range is 1 to 255. The default is 110.

Page 47: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

26

Default

The default administrative distance for OSPF routes is 110.

Usage Guidelines

Use this command to set the administrative distance for OSPF routes.

The administrative distance indicates the trustworthiness of a router or group of routers as a source of routing information. In general, the higher the value, the less trusted the entity. An administrative distance of 1 usually represents a directly connected network, and and an administrative distance of 255 the routing source is unreliable or unknown. The administrative distance conventionally applied to OSPF is 110.

Use the set form of this command to set the administrative distance.

Use the delete form of this command to restore the default value for administrative distance.

Use the show form of this command to display administrative distance configuration.

Page 48: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

27

protocols ospf log-adjacency-changesEnables or disables logging of changes in adjacency state of neighbors.

Syntax

set protocols ospf log-adjacency-changes [detail]

delete protocols ospf log-adjacency-changes

show protocols ospf log-adjacency-changes

Command Mode

Configuration mode.

Configuration Statement

protocols {ospf {

log-adjacency-changes {detail

}}

}

Parameters

Default

Logging of adjacency changes is disabled. When used without the detail option, only adjacency state changes are logged.

Usage Guidelines

Use this command to enable logging of adjacency state changes.

Use the set form of this command to enable adjacency state change logging.

Use the delete form of this command to disable adjacency state change logging.

Use the show form of this command to display adjacency state change logging configuration.

detail Optional. Logs all state changes, not just changes in adjacency state.

Page 49: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

28

protocols ospf max-metric router-lsaEnables or disables an OSPF stub router to advertise a maximum metric value when the router is started up or reloaded.

Syntax

set protocols ospf max-metric router-lsa [administrative | on-shutdown shutdown | on-startup startup]

delete protocols ospf max-metric router-lsa [administrative | on-shutdown | on-startup]

show protocols ospf max-metric router-lsa [on-shutdown | on-startup]

Command Mode

Configuration mode.

Configuration Statement

protocols {ospf {

max-metric {router-lsa {

administrativeon-shutdown: 5-86400on-startup: 5-86400

}}

}}

Parameters

administrative Optional. Advertise the maximum metric for an indefinite period.

on-shutdown shutdown Advertise the maximum metric when the OSPF process is shut down. The shutdown argument specifies the interval, in seconds, after which advertisement of maximum metric should be stopped and the normal OSPF metric even if BGP convergence has not completed. The range is 5 to 86400. The default is 600.

Page 50: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

29

Default

None.

Usage Guidelines

Use this command to set the Router-LSA advertising metric.

Using this command allows an OSPF router to advertise a maximum metric to other routers as described in RFC 3137. Advertising a maximum metric effectively makes the router the least-preferred router in the network for forwarding other traffic to another network. During the interval when the router is least-preferred, the BGP routing tables can converge and the router can be gracefully brought into service or taken out of service without interfering with traffic.

The period of maximum metric advertisement comes to an end if either the BGP tables complete convergence or the timers expire. At this point, the maximum advertised metric is replaced with the normal OSPF metric.

Use the the set form of this command to enable maximum metric advertising.

Use the delete form of this command to disable maximum metric advertising.

Use the show form of this command to display maximum metric advertising configuration.

on-startup startup Advertise the maximum metric when the OSPF process is started up or reloaded. The startup argument specifies the interval, in seconds, after which advertisement of maximum metric should be stopped and the normal OSPF metric even if BGP convergence has not completed. The range is 5 to 86400. The default is 600.

Page 51: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

30

protocols ospf mpls-teSets Multi-Protocol Label Switching (MPLS) Traffic Engineering (MPLS-TE) parameters.

Syntax

set protocols ospf mpls-te [enable | router-address ipv4]

delete protocols ospf mpls-te [enable | router-address]

show protocols ospf mpls-te [router-address]

Command Mode

Configuration mode.

Configuration Statement

protocols {ospf {

mpls-te {enablerouter-address: ipv4

}}

}

Parameters

Default

None.

Usage Guidelines

Use this command to enable Multiprotocol Label Switching traffic engineering (MPLS-TE).

Use the set form of this command to enable MPLS-TE.

Use the delete form of this command to remove MPLS-TE configuration.

enable Optional. Enables MPLS-TE functionality.

ipv4 Optional. The stable IP address of the advertising router.

Page 52: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

31

Use the show form of this command to display MPLS-TE configuration.

Page 53: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

32

protocols ospf neighbor <ipv4>Defines an OSPF neighbor.

Syntax

set protocols ospf neighbor ipv4 [poll-interval interval | priority priority]

delete protocols ospf neighbor ipv4 [poll-interval | priority]

show protocols ospf neighbor ipv4 [poll-interval | priority]

Command Mode

Configuration mode.

Configuration Statement

protocols {ospf {

neighbor ipv4 {poll-interval: 1-65535priority: 0-255

}}

}

Parameters

Default

None.

ipv4 Mandatory. The IPv4 address of the OSPF neighbor.

interval Optional. The interval, in seconds, at which this neighbor should be polled to determine whether it is still reachable. The range is 1 to 65535. The default is 120.

priority Optional. The priority of this neighbor. The range is 0 to 255, where the lower the number, the higher the priority. The default is 1.

Page 54: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

33

Usage Guidelines

Use this command to define an OSPF neighbor and set its characteristics.

Use the set form of this command to create an OSPF neighbor or modify its characteristics.

Use the delete form of this command to remove an OSPF neighbor or reset neighbor parameters to default values.

Use the show form of this command to display OSPF neighbor configuration.

Page 55: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

34

protocols ospf parameters Sets global OSPF parameters, such as router ID.

Syntax

set protocols ospf parameters [abr-type type | opaque-lsa | rfc1583-compatibility | router-id ipv4]

delete protocols ospf parameters [abr-type | opaque-lsa | rfc1583-compatibility | router-id]

show protocols ospf parameters

Command Mode

Configuration mode.

Configuration Statement

protocols {ospf {

parameters {abr-type: [cisco|ibm|shortcut|standard]opaque-lsarfc1583-compatibilityrouter-id: ipv4

}}

}

Parameters

type Optional. Supported only for Area Border Routers (ABRs). Set the OSPF ABR type. Supported values are as follows:

cisco: Designates the router as a Cisco ABR

ibm: Designates the router as an IBM ABR

shortcut: Designates the router as an ABR supporting shortcut mode as described in draft-ietf-ospf-shortcut-abr-02.txt.

standard: Designates the router as a standard ABR

The default is standard.

opaque-lsa Optional. Enables support for opaque link-state advertisement as described in RFC 2370.

Page 56: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

35

Default

By default, support for opaque LSAs is disabled. By default, RFC 1583 support is disabled.

If no router ID is explicitly configured, the OSPF process calculates an ID for the router using the following algorithm:

1 Use the IP address of the loopback interface.

2 Use the highest IP address of the address on router interfaces.

3 If no interfaces are defined, use 0.0.0.0.

Usage Guidelines

Use this command to set OSPF-specific parameters.

NOTE Modifying the router ID causes the router to restart.

Use the set form of this command to specify parameter values.

Use the delete form of this command to restore defaults for global OSPF parameters.

Use the show form of this command to display global OSPF parameter configuration.

rfc1583-compatibility Optional. Enables compliance with RFC 1583 for handling AS external routes.

ipv4 Optional. Sets an explicit router ID, overriding the router ID calculated by the OSPF process. The format is an IPv4 address.

Page 57: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

36

protocols ospf passive-interface <ethx>Suppress routing updates on an interface.

Syntax

set protocols ospf passive-interface ethx

delete protocols ospf passive-interface ethx

show protocols ospf passive-interface

Command Mode

Configuration mode.

Configuration Statement

protocols {ospf {

passive-interface eth0..eth23 {}}

}

Parameters

Default

Routing updates are not suppressed.

Usage Guidelines

Use this command to specify suppression for OSPF routing updates on an interface.

Use the set form of this command to suppress routing updates for an interface.

Use the delete form of this command to remove routing update suppression.

Use the show form of this command to display a routing update suppression configuration.

eth0..eth23 Mandatory. Multi-node. The Ethernet interface for which routing updates are to be suppressed.

You can suppress routing updates on multiple interfaces by creating multiple passive-interface configuration nodes.

Page 58: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

37

protocols ospf redistribute bgpSets the parameters for redistribution of BGP routes into OSPF.

Syntax

set protocols ospf redistribute bgp [metric metric | route-map map-name]

delete protocols ospf redistribute bgp [metric | route-map]

show protocols ospf redistribute bgp [metric | route-map]

Command Mode

Configuration mode.

Configuration Statement

protocols {ospf {

redistribute {bgp {

metric: 1-16route-map: text

}}

}}

Parameters

Default

BGP routes being redistributed into OSPF are assigned a routing metric of 1. By default, no route map is applied to redistributed BGP routes.

metric metric Optional. Applies the specified metric to BGP routes being redistributed into OSPF. The range is 1 to 16. The default is 1.

route-map map-name Optional. Redistributes routes satisfying the specified route map.

Page 59: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

38

Usage Guidelines

Use this command to define the routing cost (metric) for BGP routes being redistributed into OSPF.

Use the set form of this command to set BGP route redistribution parameters.

Use the delete form of this command to remove BGP route redistribution parameters.

Use the show form of this command to display BGP route redistribution configuration.

Page 60: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

39

protocols ospf redistribute connectedSets the parameters for redistribution of connected routes into OSPF.

Syntax

set protocols ospf redistribute connected [metric metric | route-map map-name]

delete protocols ospf redistribute connected [metric | route-map]

show protocols ospf redistribute connected [metric | route-map]

Command Mode

Configuration mode.

Configuration Statement

protocols {ospf {

redistribute {connected {

metric: 1-16route-map: text

}}

}}

Parameters

Default

Connected routes being redistributed into OSPF are assigned a routing metric of 1. By default, no route map is applied to redistributed connected routes.

metric metric Optional. Applies the specified metric to connected routes being redistributed into OSPF. The range is 1 to 16. The default is 1.

route-map map-name Optional. Redistributes routes satisfying the specified route map.

Page 61: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

40

Usage Guidelines

Use this command to specify the routing cost (metric) for directly connected routes being redistributed into OSPF.

Use the set form of this command to set the routing metric for redistributed connected routes.

Use the delete form of this command to remove connected route redistribution parameters.

Use the show form of this command to display connected route redistribution configuration.

Page 62: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

41

protocols ospf redistribute kernelSets the parameters for redistribution of kernel routes into OSPF.

Syntax

set protocols ospf redistribute kernel [metric metric | route-map map-name]

delete protocols ospf redistribute kernel [metric | route-map]

show protocols ospf redistribute kernel [metric | route-map]

Command Mode

Configuration mode.

Configuration Statement

protocols {ospf {

redistribute {kernel {

metric: 1-16route-map: text

}}

}}

Parameters

Default

Kernel routes being redistributed into OSPF are assigned a routing metric of 1. By default, no route map is applied to redistributed kernel routes.

metric metric Optional. Applies the specified metric to kernel routes being redistributed into OSPF. The range is 1 to 16. The default is 1.

route-map map-name Optional. Redistributes routes satisfying the specified route map.

Page 63: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

42

Usage Guidelines

Use this command to specify the routing cost (metric) for kernel routes being redistributed into OSPF.

Use the set form of this command to set the routing metric for redistributed kernel routes.

Use the delete form of this command to remove kernel route redistribution parameters.

Use the show form of this command to display kernel route redistribution configuration.

Page 64: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

43

protocols ospf redistribute ripSets the parameters for redistribution of RIP routes into OSPF.

Syntax

set protocols ospf redistribute rip [metric metric | route-map map-name]

delete protocols ospf redistribute rip [metric | route-map]

show protocols ospf redistribute rip [metric | route-map]

Command Mode

Configuration mode.

Configuration Statement

protocols {ospf {

redistribute {rip {

metric: 1-16route-map: text

}}

}}

Parameters

Default

RIP routes being redistributed into OSPF are assigned a routing metric of 1. By default, no route map is applied to redistributed RIP routes.

metric metric Optional. Applies the specified metric to RIP routes being redistributed into OSPF. The range is 1 to 16. The default is 1.

route-map map-name Optional. Redistributes routes satisfying the specified route map.

Page 65: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

44

Usage Guidelines

Use this command to specify the routing cost (metric) for RIP routes being redistributed into OSPF.

Use the set form of this command to set the routing metric for redistributed RIP routes.

Use the delete form of this command to remove RIP route redistribution parameters.

Use the show form of this command to display RIP route redistribution configuration.

Page 66: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

45

protocols ospf redistribute staticSets the parameters for redistribution of static routes into OSPF.

Syntax

set protocols ospf redistribute static [metric metric | route-map map-name]

delete protocols ospf redistribute static [metric | route-map]

show protocols ospf redistribute static [metric | route-map]

Command Mode

Configuration mode.

Configuration Statement

protocols {ospf {

redistribute {static {

metric: 1-16route-map: text

}}

}}

Parameters

Default

Static routes being redistributed into OSPF are assigned a routing metric of 1. By default, no route map is applied to redistributed static routes.

metric metric Optional. Applies the specified metric to static routes being redistributed into OSPF. The range is 1 to 16. The default is 1.

route-map map-name Optional. Redistributes routes satisfying the specified route map.

Page 67: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

46

Usage Guidelines

Use this command to specify the routing cost (metric) for static routes being redistributed into OSPF.

Use the set form of this command to set the routing metric for redistributed static routes.

Use the delete form of this command to remove static route redistribution parameters.

Use the show form of this command to display static route redistribution configuration.

Page 68: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

47

protocols ospf refresh timers <value>Sets values for OSPF refresh timers.

Syntax

set protocols ospf refresh timers value

delete protocols ospf refresh timers

show protocols ospf refresh timers

Command Mode

Configuration mode.

Configuration Statement

protocols {ospf {

refresh {timers: 10-1800

}}

}

Parameters

Default

By default, the refresh timer expires every 30 minutes (1800 seconds).

Usage Guidelines

Use this command to specify the values for the OSPF link-state refresh timer.

A link-state refresh is a mechanism for validating a link-state advertisement (LSA) and resetting its age before it reaches the maximum age. When the link-state refresh timer expires, the router floods a new link-state update to all its neighbors who reset the age of the LSA.

value Mandatory. The timer value, in seconds. The range is 10 to 1800. The default is 1800 (30 minutes).

Page 69: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

48

Use the set form of this command to set the refresh timer value.

Use the delete form of this command to restore the default refresh timer value.

Use the show form of this command to display refresh timer configuration.

Page 70: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

49

protocols ospf timers throttle spf Enables or disables OSPF SPF throttling.

Syntax

set protocols ospf timers throttle spf [delay delay | initial-holdtime initial | max-holdtime max]

delete protocols ospf timers throttle spf [delay | initial-holdtime | max-holdtime]

show protocols ospf timers throttle spf [delay | initial-holdtime | max-holdtime]

Command Mode

Configuration mode.

Configuration Statement

protocols {ospf {

timers {throttle {

spf {delay: 0-600000initial-holdtime: 0-600000max-holdtime: 0-600000

}}

}}

}

Parameters

delay Optional. The delay, in milliseconds, from the first network topology change received until SPF calculation. The range is 0 to 600000.

initial Optional. The initial interval, in milliseconds, between consecutive SPF calculations. The range is 0 to 600000.

max Optional. The maximum interval, in milliseconds, between consecutive SPF calculations. The range is 0 to 600000.

Page 71: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

50

Default

SPF throttling is disabled.

Usage Guidelines

Use this command to set the timer characteristics of SPF throttling.

Shortest Path First (SPF) calculations, which calculate the Shortest Path Tree (SPT), are generally performed whenever there is a change of network topology. In an unstable network this can cause excessive path calculation. SPF throttling allows you delay SPF calculation. You can delay the first calculation and set a minimum and maximum interval between calculations.

Use the set form of this command to enable SPF throttling and set its characteristics.

Use the delete form of this command to disable SPF throttling.

Use the show form of this command to display SPF throttling configuration.

Page 72: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

51

show debugging ospf

Displays OSPF protocol debugging flags.

Syntax

show debugging ospf

Command Mode

Operational mode.

Parameters

None

Default

None.

Usage Guidelines

Use this command to see how debugging is set for OSPF.

Page 73: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

52

show ip ospf

Displays high-level OSPF configuration information.

Syntax

show ip ospf

Command Mode

Operational mode.

Parameters

None.

Default

None.

Usage Guidelines

Use this command to display high-level OSPF information.

Examples

Example 1-7 shows OSPF information.

Example 1-1 “show ip ospf”: Displaying OSPF configuration information

vyatta@vyatta:~$ show ip ospfOSPF Routing Process, Router ID: 10.100.10.1 Supports only single TOS (TOS0) routes This implementation conforms to RFC2328 RFC1583Compatibility flag is disabled OpaqueCapability flag is disabled Initial SPF scheduling delay 200 millisec(s) Minimum hold time between consecutive SPFs 1000 millisec(s) Maximum hold time between consecutive SPFs 10000 millisec(s) Hold time multiplier is currently 1 SPF algorithm last executed 1w2d01h ago SPF timer is inactive Refresh timer 10 secs Number of external LSA 1. Checksum Sum 0x000083e4

Page 74: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

53

Number of opaque AS LSA 0. Checksum Sum 0x00000000 Number of areas attached to this router: 1

Area ID: 10.1.0.0 Shortcutting mode: Default, S-bit consensus: no Number of interfaces in this area: Total: 1, Active: 1 Number of fully adjacent neighbors in this area: 2 Area has no authentication Number of full virtual adjacencies going through this area: 0 SPF algorithm executed 3 times Number of LSA 4 Number of router LSA 3. Checksum Sum 0x0000ccad Number of network LSA 1. Checksum Sum 0x00000df2 Number of summary LSA 0. Checksum Sum 0x00000000 Number of ASBR summary LSA 0. Checksum Sum 0x00000000 Number of NSSA LSA 0. Checksum Sum 0x00000000 Number of opaque link LSA 0. Checksum Sum 0x00000000 Number of opaque area LSA 0. Checksum Sum 0x00000000

vyatta@vyatta:~$

Page 75: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

54

show ip ospf border-routers

Displays OSPF border router information.

Syntax

show ip ospf border-routers

Command Mode

Operational mode.

Parameters

None.

Default

None.

Usage Guidelines

Use this command to display OSPF border router information.

Examples

Example 1-2 shows OSPF border router information.

Example 1-2 “show ip ospf border-router”: Displaying OSPF border router information

vyatta@vyatta:~$ show ip ospf border-routers============ OSPF router routing table =============R 10.1.0.58 [10] area: 10.1.0.0, ASBR via 10.1.0.58, eth2

vyatta@vyatta:~$

Page 76: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

55

show ip ospf database

Displays OSPF database information.

Syntax

show ip ospf database [max-age | self-originate | {asbr-summary | external | network | nssa-external | opaque-area | opaque-as | opaque-link | router | summary} [adv-router <ipv4> |<ipv4> [adv-router <ipv4> | self-originate]]]

Command Mode

Operational mode.

Parameters

max-age Display OSPF max-age database.

self-originate Display OSPF self-originate database.

asbr-summary Display OSPF ASBR (Autonomous System Border Router) summary database.

external Display OSPF external database.

network Display OSPF network database.

nssa-external Display OSPF NSSA external database.

opaque-area Display OSPF opaque-area database.

opaque-as Display OSPF opaque-as database.

opaque-link Display OSPF opaque-link database.

router Display OSPF router database.

summary Display summary of OSPF database.

adv-router ipv4 Optional. Display the OSPF database for a given address of the advertised router specified.

ipv4 Optional. Display the OSPF database for a given address.

self-originate Optional. Display the self-originate OSPF database for a given address.

Page 77: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

56

Default

None.

Usage Guidelines

Use this command to display OSPF database information.

Examples

Example 1-3 shows general OSPF database information.

Example 1-3 “show ip ospf database”: Displaying general OSPF database information

vyatta@vyatta:~$ show ip ospf database

OSPF Router with ID (10.100.10.1)

Router Link States (Area 10.1.0.0)

Link ID ADV Router Age Seq# CkSum Link count10.1.0.33 10.1.0.33 123 0x800003e5 0x791f 110.1.0.58 10.1.0.58 123 0x80000562 0x4e7e 110.100.10.1 10.100.10.1 117 0x800001b6 0xfe13 1

Net Link States (Area 10.1.0.0)

Link ID ADV Router Age Seq# CkSum10.1.0.58 10.1.0.58 123 0x800003df 0x0bf3

AS External Link States

Link ID ADV Router Age Seq# CkSum Route76.0.0.0 10.1.0.58 1850 0x800000b3 0x83e4 E2 76.0.0.0/8 [0x0]

vyatta@vyatta:~$

Page 78: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

57

show ip ospf interface

Displays OSPF configuration and status information for a specified interface.

Syntax

show ip ospf interface [interface]

Command Mode

Operational mode.

Parameters

Default

If no interfaces are specified then information on all interfaces will be displayed.

Usage Guidelines

Use this command to display OSPF configuration information for an interface.

Examples

Example 1-4 shows OSPF information on all interfaces.

Example 1-4 “show ip ospf interface”: Displaying OSPF configuration and status information

vyatta@vyatta:~$ show ip ospf interfaceeth0 is down ifindex 3, MTU 1500 bytes, BW 0 Kbit <UP,BROADCAST,MULTICAST> OSPF not enabled on this interfaceeth1 is down ifindex 4, MTU 1500 bytes, BW 0 Kbit <UP,BROADCAST,MULTICAST> OSPF not enabled on this interfaceeth1_rename is down ifindex 0, MTU 1500 bytes, BW 0 Kbit <BROADCAST,MULTICAST> OSPF not enabled on this interfaceeth2 is up

interface Optional. Interface to view OSPF configuration and status on.

Page 79: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

58

ifindex 5, MTU 1500 bytes, BW 0 Kbit <UP,BROADCAST,RUNNING,MULTICAST> Internet Address 10.1.0.62/24, Broadcast 10.1.0.255, Area 10.1.0.0 MTU mismatch detection:enabled Router ID 10.100.10.1, Network Type BROADCAST, Cost: 10 Transmit Delay is 1 sec, State DROther, Priority 1 Designated Router (ID) 10.1.0.58, Interface Address 10.1.0.58 Backup Designated Router (ID) 10.1.0.33, Interface Address 10.1.0.33 Multicast group memberships: OSPFAllRouters Timer intervals configured, Hello 10s, Dead 40s, Wait 40s, Retransmit 5 Hello due in 0.721s Neighbor Count is 2, Adjacent neighbor count is 2eth2_rename is down ifindex 0, MTU 1500 bytes, BW 0 Kbit <BROADCAST,MULTICAST> OSPF not enabled on this interfaceeth3 is down ifindex 2, MTU 1500 bytes, BW 0 Kbit <BROADCAST,MULTICAST> OSPF not enabled on this interfacelo is up ifindex 1, MTU 16436 bytes, BW 0 Kbit <UP,LOOPBACK,RUNNING> OSPF not enabled on this interfacevyatta@vyatta:~$

Page 80: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

59

show ip ospf neighbor

Displays OSPF neighbor information for a specified address or interface.

Syntax

show ip ospf neighbor [interface | ipv4 | detail | address ipv4]

Command Mode

Operational mode.

Parameters

Default

If no interfaces are specified then information on all neighbors will be displayed.

Usage Guidelines

Use this command to display OSPF neighbor information for a specified address or interface.

Examples

Example 1-5 shows OSPF neighbor information for all neighbors.

Example 1-5 “show ip ospf neighbor”: Displaying OSPF neighbor information

vyatta@vyatta:~$ show ip ospf neighbor

Neighbor ID Pri State Dead Time Address Interface RXmtL RqstL DBsmL10.1.0.33 1 Full/Backup 33.842s 10.1.0.33 eth2:10.1.0.62 0 0 0

interface Optional. Display neighbor information for the specified interface.

ipv4 Optional. Display neighbor information for the specified address.

detail Optional. Display detailed neighbor information for all neighbors.

address ipv4 Optional. Display neighbor information for the specified address.

Page 81: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

60

10.1.0.58 1 Full/DR 38.581s 10.1.0.58 eth2:10.1.0.62 0 0 0vyatta@vyatta:~$

Page 82: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

61

show ip ospf route

Displays OSPF route information.

Syntax

show ip ospf route

Command Mode

Operational mode.

Parameters

None.

Default

None.

Usage Guidelines

Use this command to display OSPF route information.

Examples

Example 1-6 shows OSPF route information.

Example 1-6 “show ip ospf route”: Displaying OSPF route information

vyatta@vyatta:~$ show ip ospf route============ OSPF network routing table ============N 10.1.0.0/24 [10] area: 10.1.0.0 directly attached to eth2

============ OSPF router routing table =============R 10.1.0.58 [10] area: 10.1.0.0, ASBR via 10.1.0.58, eth2

============ OSPF external routing table ===========N E2 76.0.0.0/8 [10/20] tag: 0 via 10.1.0.7, eth2

vyatta@vyatta:~$

Page 83: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

62

Page 84: Vyatta - OSPF

Chapter 1: Router-Level Configuration OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

63

show ip route ospf

Displays all IP OSPF routes.

Syntax

show ip route ospf

Command Mode

Operational mode.

Parameters

None.

Default

None.

Usage Guidelines

Use this command to display all the IP OSPF routes.

Examples

Example 1-7 shows all IP OSPF routes.

Example 1-7 “show ip route ospf”: Displaying routes

vyatta@vyatta:~$ show ip route ospfCodes: K - kernel route, C - connected, S - static, R - RIP, O - OSPF, I - ISIS, B - BGP, > - selected route, * - FIB route

O 10.1.0.0/24 [110/10] is directly connected, eth2, 01w2d21hO>* 76.0.0.0/8 [110/20] via 10.1.0.7, eth2, 4d12h48mvyatta@vyatta:~$

Page 85: Vyatta - OSPF

64

Chapter 2: OSPF Areas

This chapter describes commands for configuring OSPF areas.

This chapter presents the following topics:

• OSPF Area Commands

Page 86: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

65

OSPF Area CommandsThis chapter contains the following commands.

Configuration Commands

protocols ospf area <area-id> Defines an OSPF area.

protocols ospf area <area-id> area-type normal Designates an OSPF area as a normal area.

protocols ospf area <area-id> area-type nssa Designates an OSPF area as a not-so-stubby area (NSSA).

protocols ospf area <area-id> area-type stub Designates an OSPF area as a stub area.

protocols ospf area <area-id> authentication Specifies the authentication type for an OSPF area.

protocols ospf area <area-id> network <ipv4net> Specifies a network address for an OSPF area.

protocols ospf area <area-id> range <ip4net> Allows an ABR to summarize routes matching a prefix range.

protocols ospf area <area-id> shortcut <mode> Sets the OSPF shortcut mode for an Area Border Router (ABR).

protocols ospf area <area-id> virtual-link <ipv4> authentication

Specifies the authentication characteristics for a virtual link.

protocols ospf area <area-id> virtual-link <ipv4> dead-interval <interval>

Specifies the dead interval for a virtual link.

protocols ospf area <area-id> virtual-link <ipv4> hello-interval <interval>

Sets the interval between OSPF hello packets on a virtual link.

protocols ospf area <area-id> virtual-link <ipv4> retransmit-interval <interval>

Specifies the retransmit interval for a virtual link.

protocols ospf area <area-id> virtual-link <ipv4> transmit-delay <delay>

Specifies the transmit delay for a virtual link.

Operational Commands

None.

Page 87: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

66

protocols ospf area <area-id>Defines an OSPF area.

Syntax

set protocols ospf area area-id

delete protocols ospf area area-id

show protocols ospf area area-id

Command Mode

Configuration mode.

Configuration Statement

protocols {ospf {

area text}

}

Parameters

Default

None.

Usage Guidelines

Use this command to define an area within an OSPF Autonomous System (AS)

Use the set form of this command to create an OSPF area or define its characteristics.

Use the delete form of this command to remove an OSPF area.

Use the show form of this command to display OSPF area configuration.

area-id Mandatory. The ID of the OSPF area, expressed either as an IP address or as a decimal value.

Page 88: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

67

protocols ospf area <area-id> area-type normalDesignates an OSPF area as a normal area.

Syntax

set protocols ospf area area-id area-type normal

delete protocols ospf area area-id area-type

show protocols ospf area area-id area-type

Command Mode

Configuration mode.

Configuration Statement

protocols {ospf {

area text {area-type {

normal}

}}

Parameters

Default

None.

Usage Guidelines

Use this command to designate an OSPF area as a normal area.

A normal area is an area that is neither a stub area nor a not-so-stubby area. All external routes are advertised into normal areas.

Use the set form of this command to set the OSPF area type as normal.

Use the delete form of this command to remove area type configuration.

area-id Mandatory. The ID of the OSPF area being configured, expressed as an IP address or a decimal value.

Page 89: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

68

Use the show form of this command to display an area type configuration.

Page 90: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

69

protocols ospf area <area-id> area-type nssa Designates an OSPF area as a not-so-stubby area (NSSA).

Syntax

set protocols ospf area area-id area-type nssa [default-cost cost | no-summary | translate {always | candidate | never}]

delete protocols ospf area area-id area-type nssa [default-cost | no-summary | translate]

show protocols ospf area area-id area-type nssa [default-cost | translate]

Command Mode

Configuration mode.

Configuration Statement

protocols {ospf {

area text {area-type {

nssa {default-cost: 0-16777215no-summarytranslate {

alwayscandidatenever

}}

}}

}}

Parameters

area-id Mandatory. The ID of the OSPF area being configured, expressed as an IP address or a decimal value.

cost Optional. The administrative cost, or metric, that will be applied to the default route in this area. The range is 0 to 6777215.

Page 91: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

70

Default

By default, summary routes are generated into the area, and only Type 7 LSAs from the candidate NSSA Border router are translated.

Usage Guidelines

Use this command to designate this OSPF area as a not-so-stubby area.

Type 5 AS-external LSAs are not allowed in stubby areas, but Type 7 LSAs may be translated into Type 5 LSAs by the NSSA Area Border Router (ABR) and may traverse the NSSA in this manner. Inter-area routes are not allowed.

Use the set form of this command to set the OSPF area type to not-so-stubby.

Use the delete form of this command to remove area type configuration.

Use the show form of this command to display an area type configuration.

no-summary Optional. Prevents route summaries from being generated into the area.

translate Optional. Directs the NSSA ABR when to translate Type 7 LSAs into Type 5 AS-external LSAs.

always Always translates Type 7 LSAs into Type 5 AS-external LSAs.

candidate Translates only Type 7 LSAs from the candidate NSSA border router.

never Never translates Type 7 LSAs into Type 5 AS-external LSAs.

Page 92: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

71

protocols ospf area <area-id> area-type stubDesignates an OSPF area as a stub area.

Syntax

set protocols ospf area area-id area-type stub [default-cost cost | no-summary]

delete protocols ospf area area-id area-type stub [default-cost | no-summary]

show protocols ospf area area-id area-type stub [default-cost]

Command Mode

Configuration mode.

Configuration Statement

protocols {ospf {

area text {area-type {

stub {default-cost: 0-16777215no-summary

}}

}}

}

Parameters

Default

By default, summary routes are generated into the area.

area-id Mandatory. The ID of the OSPF area being configured, expressed as an IP address or a decimal value.

cost Optional. The administrative cost, or metric, that will be applied to the default route in this area. The range is 0 to 6777215.

no-summary Optional. Prevents route summaries from being generated into the area.

Page 93: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

72

Usage Guidelines

Use this command to designate this OSPF area as a stub area. No Type 5 AS-external LSAs are allowed into a stub area.

Use the set form of this command to set the OSPF area type to stub.

Use the delete form of this command to remove area type configuration.

Use the show form of this command to display an area type configuration.

Page 94: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

73

protocols ospf area <area-id> authentication Specifies the authentication type for an OSPF area.

Syntax

set protocols ospf area area-id authentication type

delete protocols ospf area area-id authentication

show protocols ospf area area-id authentication

Command Mode

Configuration mode.

Configuration Statement

protocols {ospf {

area text {authentication txt

}}

}

Parameters

Default

The default is plain-text authentication.

area-id Mandatory. The ID of the OSPF area being configured, expressed as an IP address or a decimal value.

type The type of authentication to be used. Supported values are as follows:

md5: A hash value is sent through the network, computed from the password in the OSPF packet and the password, using the Message Digest algorithm.

plaintext-password: Passwords are sent through the network in plain text.

Page 95: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

74

Usage Guidelines

Use this command to set the authentication type for an OSPF area.

In plain text authentication, passwords are sent through the network in plain text. In MD5 authentication, the system uses the Message Digest 5 (MD5) algorithm to compute a hash value from the contents of the OSPF packet and the password. The hash value and the MD5 key are included in the transmitted packet, and the receiving system (configured with the same password) calculates its own hash function, which must match.

Use the set form of this command to set the the authentication type.

Use the delete form of this command to remove the authentication type.

Use the show form of this command to display the authentication type.

Page 96: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

75

protocols ospf area <area-id> network <ipv4net>Specifies a network address for an OSPF area.

Syntax

set protocols ospf area area-id network ipv4net

delete protocols ospf area area-id network ipv4net

show protocols ospf area area-id network

Command Mode

Configuration mode.

Configuration Statement

protocols {ospf {

area text {network: ipv4net

}}

}

Parameters

Default

None.

Usage Guidelines

Use this command to specify the network to be used for an OSPF area.

Use the set form of this command to specify the area network.

Use the delete form of this command to remove OSPF area network configuration.

area-id Mandatory. The ID of the OSPF area being configured, expressed as an IP address or a decimal value.

ipv4net Mandatory. Multi-node. Specify the network to be used for the OSPF area. The format is ip-address/prefix.

Page 97: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

76

Use the show form of this command to display OSPF area network configuration.

Page 98: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

77

protocols ospf area <area-id> range <ip4net>Allows an ABR to summarize routes matching a prefix range.

Syntax

set protocols ospf area area-id range ipv4net [cost cost | not-advertise | substitute ipv4net]

delete protocols ospf area area-id range [ipv4net [cost | not-advertise | substitute]]

show protocols ospf area area-id range [ipv4net [cost | substitute]]

Command Mode

Configuration mode.

Configuration Statement

protocols {ospf {

area text {area-type {

range {cost: 0-16777215not-advertisesubstitute: ipv4net

}}

}}

}

Parameters

area-id Mandatory. The ID of the OSPF area being configured, expressed as an IP address or a decimal value.

ipv4net Mandatory. The range to be summarized, expressed as an IPv4 network in the format ip-address/prefix.

cost Optional. The administrative cost, or metric, to be applied to routes in this range. The range is 0 to 16777215.

not-advertise Optional. Directs the router not to advertise routes in this range.

Page 99: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

78

Default

By default, routes are advertised and routes are not substituted.

Usage Guidelines

Use this command to direct the router to summarize routes matching a prefix range. This command may only be used with an Area Border Router (ABR).

Use the set form of this command to set the area range.

Use the delete form of this command to remove area range configuration.

Use the show form of this command to display area range configuration.

substitute ipv4net

Optional. Directs the router to announce routes in this range as being in the specified prefix instead. The format is ip-address/prefix.

Page 100: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

79

protocols ospf area <area-id> shortcut <mode>Sets the OSPF shortcut mode for an Area Border Router (ABR).

Syntax

set protocols ospf area area-id shortcut [default | disable | enable]

delete protocols ospf area area-id shortcut

show protocols ospf area area-id shortcut

Command Mode

Configuration mode.

Configuration Statement

protocols {ospf {

area text {shortcut text

}}

}

Parameters

area-id Mandatory. The ID of the OSPF area being configured, expressed as an IP address or a decimal value.

Page 101: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

80

Default

The shortcut mode is default.

Usage Guidelines

Use this command to set the shortcut mode for an OSPF Area Border Router, (ABR) according to the standard described in draft-ietf-ospf-shortcut-abr-02.txt. This command may only be used with an ABR.

Use the set form of this command to set the ABR shortcut mode.

Use the delete form of this command to remove ABR shortcut configuration.

Use the show form of this command to display ABR shortcut configuration.

mode Mandatory. The shortcut mode. Supported values are as follows:

default: If the ABR has an active backbone connection, the area is not used for shortcutting and the ABR does not set the shortcut bit (S-bit) in the router-LSA originated for the area. If the ABR does not have a backbone connection, the area is always used for shortcutting and the ABR sets the S-bit in the router-LSA for that area.

disable: The ABR does not use this area for shortcutting and does not set the S-bit in the router-LSA originated for the area.

enable: If the ABR has an active backbone connection, the ABR sets the S-bit in the router-LSA and the area is used for shortcutting provided that all other ABRs seen through this area also report the S-bit. If the ABR has does not have a backbone connection, the ABR unconditionally uses the area for shortcutting and sets the S-bit in the router-LSA originated for the area.

Page 102: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

81

protocols ospf area <area-id> virtual-link <ipv4> authentication

Specifies the authentication characteristics for a virtual link.

Syntax

set protocols ospf area area-id virtual-link ipv4 authentication [md5 key-id key-id md5-key md5-key | plaintext-password password]

delete protocols ospf area area-id virtual-link ipv4 authentication [md5 key-id key-id md5-key | plaintext-password]

show protocols ospf area area-id virtual-link ipv4 authentication [md5 key-id key-id md5-key | plaintext-password]

Command Mode

Configuration mode.

Configuration Statement

protocols {ospf {

area text {virtual-link ipv4 {

authentication {md5 {

key-id 1-255 {md5-key: text

}}plaintext-password: text

}}

}}

}

Parameters

area-id Mandatory. The ID of the OSPF area being configured, expressed as an IP address or a decimal value.

Page 103: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

82

Default

None.

Usage Guidelines

Use this command to set the authentication for a virtual link.

In plain text authentication, passwords are sent through the network in plain text. In MD5 authentication, the system uses the Message Digest 5 (MD5) algorithm to compute a hash value from the contents of the OSPF packet and the password. The hash value and the MD5 key are included in the transmitted packet, and the receiving system (configured with the same password) calculates its own hash function, which must match.

Use the set form of this command to specify the authentication.

Use the delete form of this command to remove virtual link authentication configuration information.

Use the show form of this command to display virtual link authentication configuration information.

ipv4 Mandatory. The area ID of the virtual link, expressed as an IPv4 address.

key-id Optional. The authentication key id. This must be the same on both the sending and receiving systems. The range is 1 to 255.

md5-key Optional. The MD5 key to be used as input to the MD5 hashing algorithm. This must be the same on both the sending and receiving systems.

password Optional. The password to use in plain-text authentication. This must be eight characters or less and the same on both the sending and receiving systems.

Page 104: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

83

protocols ospf area <area-id> virtual-link <ipv4> dead-interval <interval>

Specifies the dead interval for a virtual link.

Syntax

set protocols ospf area area-id virtual-link ipv4 dead-interval interval

delete protocols ospf area area-id virtual-link ipv4 dead-interval

show protocols ospf area area-id virtual-link ipv4 dead-interval

Command Mode

Configuration mode.

Configuration Statement

protocols {ospf {

area text {virtual-link ipv4 {

dead-interval: 1-65535}

}}

}

Parameters

Default

The dead interval is 4 times the hello interval.

area-id Mandatory. The ID of the OSPF area being configured, expressed as an IP address or a decimal value.

ipv4 Mandatory. The area ID of the virtual link, expressed as an IPv4 address.

interval Specifies the time, in seconds, that the virtual link should wait to detect hello packets from neighboring routers before declaring the neighbor down. The range is 1 to 65535. The default is 4 times the hello interval.

Page 105: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

84

Usage Guidelines

Use this command to specify the interval during which a virtual link should expect a hello packet from its neighbor.

If the dead interval passes without the interface receiving a hello packet from the neighbor, the neighbor’s status is changed to out-of-service, and all associated state is cleared.

The dead interval must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not establish adjacencies and will disregard one another’s communications.

Use the set form of this command to specify the dead interval.

Use the delete form of this command to restore the default dead interval.

Use the show form of this command to display dead interval configuration.

Page 106: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

85

protocols ospf area <area-id> virtual-link <ipv4> hello-interval <interval>

Sets the interval between OSPF hello packets on a virtual link.

Syntax

set protocols ospf area area-id virtual-link ipv4 hello-interval interval

delete protocols ospf area area-id virtual-link ipv4 hello-interval

show protocols ospf area area-id virtual-link ipv4 hello-interval

Command Mode

Configuration mode.

Configuration Statement

protocols {ospf {

area text {virtual-link ipv4 {

hello-interval: 1-65535}

}}

}

Parameters

Default

Hello packets are sent every 10 seconds.

area-id Mandatory. The ID of the OSPF area being configured, expressed as an IP address or a decimal value.

ipv4 Mandatory. The area ID of the virtual link, expressed as an IPv4 address.

interval Mandatory. The interval, in seconds, between hello packets. This value must be the same for all nodes on the network.The range is 1 to 65535. The default is 10.

Page 107: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

86

Usage Guidelines

Use this command to set the interval at which OSPF hello packets are sent for a virtual link.

A hello packet is an OSPF packet used to detect and maintain relationships with neighbors on the same network (directly connected routers). The greater the interval between hello packets, the less router traffic occurs, but the longer it takes for topological changes to be

detected.

The hello interval must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not establish adjacencies and will disregard one another’s communications.

Use the set form of this command to set the hello interval.

Use the delete form of this command to restore the default hello interval.

Use the show form of this command to display hello interval configuration.

Page 108: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

87

protocols ospf area <area-id> virtual-link <ipv4> retransmit-interval <interval>

Specifies the retransmit interval for a virtual link.

Syntax

set protocols ospf area area-id virtual-link ipv4 retransmit-interval interval

delete protocols ospf area area-id virtual-link ipv4 retransmit-interval

show protocols ospf area area-id virtual-link ipv4 retransmit-interval

Command Mode

Configuration mode.

Configuration Statement

protocols {ospf {

area text {virtual-link ipv4 {

retransmit-interval: 1-65535}

}}

}

Parameters

Default

Unacknowledged LSAs are retransmitted at 5-second intervals.

area-id Mandatory. The ID of the OSPF area being configured, expressed as an IP address or a decimal value.

ipv4 Mandatory. The area ID of the virtual link, expressed as an IPv4 address.

interval Mandatory. The interval, in seconds, between retransmitting unacknowledged link-state advertisements (LSAs). This value must be the same for all nodes on the network. The range is 1 to 65535. The default is 5.

Page 109: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

88

Usage Guidelines

Use this command to set the retransmit interval for a virtual link. This is the number of seconds before retransmitting an unacknowledged link-state advertisement.

When an OSPF router sends a link-state advertisement (LSA) to a neighbor, the neighbor acknowledges receipt with a link-state acknowledgement (LS Ack) packet. If the local router fails to receive the expected LS Ack packet, it retransmits the LSA at the interval specified by this command. This value must be the same for all nodes on the network.

Use the set form of this command to set the default retransmit interval.

Use the delete form of this command to restore the default retransmit interval.

Use the show form of this command to display retransmit interval configuration.

Page 110: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

89

protocols ospf area <area-id> virtual-link <ipv4> transmit-delay <delay>

Specifies the transmit delay for a virtual link.

Syntax

set protocols ospf area area-id virtual-link ipv4 transmit-delay delay

delete protocols ospf area area-id virtual-link ipv4 transmit-delay

show protocols ospf area area-id virtual-link ipv4 transmit-delay

Command Mode

Configuration mode.

Configuration Statement

protocols {ospf {

area text {virtual-link ipv4 {

transmit-delay: 1-65535}

}}

}

Parameters

Default

Link-state transmits occur at 1-second intervals.

area-id Mandatory. The ID of the OSPF area being configured, expressed as an IP address or a decimal value.

ipv4 Mandatory. The area ID of the virtual link, expressed as an IPv4 address.

delay Mandatory. The delay, in seconds, between link state transmits. This value must be the same for all nodes on the network. The range is 1 to 65535. The default is 1.

Page 111: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

90

Usage Guidelines

Use this command to set the transmit delay for a virtual link in an area. This is the estimated time required to send a link-state update (LSU) packet.

This timer is used to accommodate transmission and propagation delays on the network, particularly on low-speed networks where delays may be significant. The router increments the age of link-state advertisements in LSU packets to account for these delays.

The value includes both the transmission time and the propagation delay across the network. The transmit delay is added to the age of the LSA packet before the LSA is transmitted The LSA age is used to help the network sequence LSAs, so that it can determine which of competing LSAs is the more recent and trustworthy.

LSAs are numbered in sequence, but the sequence numbers are finite, and so cannot be used as the sole determinant of the most recent LSA. Instead, OSPF also tracks the age of LSAs. Each time the LSA is forwarded to another router, its current age is incremented by the transmit delay. The packet’s age, together with its sequence number, helps the receiving router to determine which version of a received LSA is more recent, and therefore to be used.

Use the set form of this command to set the transmit delay.

Use the delete form of this command to restore the default transmit delay.

Use the show form of this command to display transmit delay configuration.

Page 112: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

91

show debugging ospf

Displays OSPF protocol debugging flags.

Syntax

show debugging ospf

Command Mode

Operational mode.

Parameters

None

Default

None.

Usage Guidelines

Use this command to see how debugging is set for OSPF.

Page 113: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

92

show ip ospf

Displays high-level OSPF configuration information.

Syntax

show ip ospf

Command Mode

Operational mode.

Parameters

None.

Default

None.

Usage Guidelines

Use this command to display high-level OSPF information.

Examples

Example 2-7 shows OSPF information.

Example 2-1 “show ip ospf”: Displaying OSPF configuration information

vyatta@vyatta:~$ show ip ospfOSPF Routing Process, Router ID: 10.100.10.1 Supports only single TOS (TOS0) routes This implementation conforms to RFC2328 RFC1583Compatibility flag is disabled OpaqueCapability flag is disabled Initial SPF scheduling delay 200 millisec(s) Minimum hold time between consecutive SPFs 1000 millisec(s) Maximum hold time between consecutive SPFs 10000 millisec(s) Hold time multiplier is currently 1 SPF algorithm last executed 1w2d01h ago SPF timer is inactive Refresh timer 10 secs Number of external LSA 1. Checksum Sum 0x000083e4

Page 114: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

93

Number of opaque AS LSA 0. Checksum Sum 0x00000000 Number of areas attached to this router: 1

Area ID: 10.1.0.0 Shortcutting mode: Default, S-bit consensus: no Number of interfaces in this area: Total: 1, Active: 1 Number of fully adjacent neighbors in this area: 2 Area has no authentication Number of full virtual adjacencies going through this area: 0 SPF algorithm executed 3 times Number of LSA 4 Number of router LSA 3. Checksum Sum 0x0000ccad Number of network LSA 1. Checksum Sum 0x00000df2 Number of summary LSA 0. Checksum Sum 0x00000000 Number of ASBR summary LSA 0. Checksum Sum 0x00000000 Number of NSSA LSA 0. Checksum Sum 0x00000000 Number of opaque link LSA 0. Checksum Sum 0x00000000 Number of opaque area LSA 0. Checksum Sum 0x00000000

vyatta@vyatta:~$

Page 115: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

94

show ip ospf border-routers

Displays OSPF border router information.

Syntax

show ip ospf border-routers

Command Mode

Operational mode.

Parameters

None.

Default

None.

Usage Guidelines

Use this command to display OSPF border router information.

Examples

Example 2-2 shows OSPF border router information.

Example 2-2 “show ip ospf border-router”: Displaying OSPF border router information

vyatta@vyatta:~$ show ip ospf border-routers============ OSPF router routing table =============R 10.1.0.58 [10] area: 10.1.0.0, ASBR via 10.1.0.58, eth2

vyatta@vyatta:~$

Page 116: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

95

show ip ospf database

Displays OSPF database information.

Syntax

show ip ospf database [max-age | self-originate | {asbr-summary | external | network | nssa-external | opaque-area | opaque-as | opaque-link | router | summary} [adv-router <ipv4> |<ipv4> [adv-router <ipv4> | self-originate]]]

Command Mode

Operational mode.

Parameters

max-age Display OSPF max-age database.

self-originate Display OSPF self-originate database.

asbr-summary Display OSPF ASBR (Autonomous System Border Router) summary database.

external Display OSPF external database.

network Display OSPF network database.

nssa-external Display OSPF NSSA external database.

opaque-area Display OSPF opaque-area database.

opaque-as Display OSPF opaque-as database.

opaque-link Display OSPF opaque-link database.

router Display OSPF router database.

summary Display summary of OSPF database.

adv-router ipv4 Optional. Display the OSPF database for a given address of the advertised router specified.

ipv4 Optional. Display the OSPF database for a given address.

self-originate Optional. Display the self-originate OSPF database for a given address.

Page 117: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

96

Default

None.

Usage Guidelines

Use this command to display OSPF database information.

Examples

Example 2-3 shows general OSPF database information.

Example 2-3 “show ip ospf database”: Displaying general OSPF database information

vyatta@vyatta:~$ show ip ospf database

OSPF Router with ID (10.100.10.1)

Router Link States (Area 10.1.0.0)

Link ID ADV Router Age Seq# CkSum Link count10.1.0.33 10.1.0.33 123 0x800003e5 0x791f 110.1.0.58 10.1.0.58 123 0x80000562 0x4e7e 110.100.10.1 10.100.10.1 117 0x800001b6 0xfe13 1

Net Link States (Area 10.1.0.0)

Link ID ADV Router Age Seq# CkSum10.1.0.58 10.1.0.58 123 0x800003df 0x0bf3

AS External Link States

Link ID ADV Router Age Seq# CkSum Route76.0.0.0 10.1.0.58 1850 0x800000b3 0x83e4 E2 76.0.0.0/8 [0x0]

vyatta@vyatta:~$

Page 118: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

97

show ip ospf interface

Displays OSPF configuration and status information for a specified interface.

Syntax

show ip ospf interface [interface]

Command Mode

Operational mode.

Parameters

Default

If no interfaces are specified then information on all interfaces will be displayed.

Usage Guidelines

Use this command to display OSPF configuration information for an interface.

Examples

Example 2-4 shows OSPF information on all interfaces.

Example 2-4 “show ip ospf interface”: Displaying OSPF configuration and status information

vyatta@vyatta:~$ show ip ospf interfaceeth0 is down ifindex 3, MTU 1500 bytes, BW 0 Kbit <UP,BROADCAST,MULTICAST> OSPF not enabled on this interfaceeth1 is down ifindex 4, MTU 1500 bytes, BW 0 Kbit <UP,BROADCAST,MULTICAST> OSPF not enabled on this interfaceeth1_rename is down ifindex 0, MTU 1500 bytes, BW 0 Kbit <BROADCAST,MULTICAST> OSPF not enabled on this interfaceeth2 is up

interface Optional. Interface to view OSPF configuration and status on.

Page 119: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

98

ifindex 5, MTU 1500 bytes, BW 0 Kbit <UP,BROADCAST,RUNNING,MULTICAST> Internet Address 10.1.0.62/24, Broadcast 10.1.0.255, Area 10.1.0.0 MTU mismatch detection:enabled Router ID 10.100.10.1, Network Type BROADCAST, Cost: 10 Transmit Delay is 1 sec, State DROther, Priority 1 Designated Router (ID) 10.1.0.58, Interface Address 10.1.0.58 Backup Designated Router (ID) 10.1.0.33, Interface Address 10.1.0.33 Multicast group memberships: OSPFAllRouters Timer intervals configured, Hello 10s, Dead 40s, Wait 40s, Retransmit 5 Hello due in 0.721s Neighbor Count is 2, Adjacent neighbor count is 2eth2_rename is down ifindex 0, MTU 1500 bytes, BW 0 Kbit <BROADCAST,MULTICAST> OSPF not enabled on this interfaceeth3 is down ifindex 2, MTU 1500 bytes, BW 0 Kbit <BROADCAST,MULTICAST> OSPF not enabled on this interfacelo is up ifindex 1, MTU 16436 bytes, BW 0 Kbit <UP,LOOPBACK,RUNNING> OSPF not enabled on this interfacevyatta@vyatta:~$

Page 120: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

99

show ip ospf neighbor

Displays OSPF neighbor information for a specified address or interface.

Syntax

show ip ospf neighbor [interface | ipv4 | detail | address ipv4]

Command Mode

Operational mode.

Parameters

Default

If no interfaces are specified then information on all neighbors will be displayed.

Usage Guidelines

Use this command to display OSPF neighbor information for a specified address or interface.

Examples

Example 2-5 shows OSPF neighbor information for all neighbors.

Example 2-5 “show ip ospf neighbor”: Displaying OSPF neighbor information

vyatta@vyatta:~$ show ip ospf neighbor

Neighbor ID Pri State Dead Time Address Interface RXmtL RqstL DBsmL10.1.0.33 1 Full/Backup 33.842s 10.1.0.33 eth2:10.1.0.62 0 0 0

interface Optional. Display neighbor information for the specified interface.

ipv4 Optional. Display neighbor information for the specified address.

detail Optional. Display detailed neighbor information for all neighbors.

address ipv4 Optional. Display neighbor information for the specified address.

Page 121: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

100

10.1.0.58 1 Full/DR 38.581s 10.1.0.58 eth2:10.1.0.62 0 0 0vyatta@vyatta:~$

Page 122: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

101

show ip ospf route

Displays OSPF route information.

Syntax

show ip ospf route

Command Mode

Operational mode.

Parameters

None.

Default

None.

Usage Guidelines

Use this command to display OSPF route information.

Examples

Example 2-6 shows OSPF route information.

Example 2-6 “show ip ospf route”: Displaying OSPF route information

vyatta@vyatta:~$ show ip ospf route============ OSPF network routing table ============N 10.1.0.0/24 [10] area: 10.1.0.0 directly attached to eth2

============ OSPF router routing table =============R 10.1.0.58 [10] area: 10.1.0.0, ASBR via 10.1.0.58, eth2

============ OSPF external routing table ===========N E2 76.0.0.0/8 [10/20] tag: 0 via 10.1.0.7, eth2

vyatta@vyatta:~$

Page 123: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

102

Page 124: Vyatta - OSPF

Chapter 2: OSPF Areas OSPF Area Commands

OSPF Rel VC5 v. 03 Vyatta

103

show ip route ospf

Displays all IP OSPF routes.

Syntax

show ip route ospf

Command Mode

Operational mode.

Parameters

None.

Default

None.

Usage Guidelines

Use this command to display all the IP OSPF routes.

Examples

Example 2-7 shows all IP OSPF routes.

Example 2-7 “show ip route ospf”: Displaying routes

vyatta@vyatta:~$ show ip route ospfCodes: K - kernel route, C - connected, S - static, R - RIP, O - OSPF, I - ISIS, B - BGP, > - selected route, * - FIB route

O 10.1.0.0/24 [110/10] is directly connected, eth2, 01w2d21hO>* 76.0.0.0/8 [110/20] via 10.1.0.7, eth2, 4d12h48mvyatta@vyatta:~$

Page 125: Vyatta - OSPF

104

Chapter 3: Ethernet Interfaces and Vifs

This chapter describes commands for configuring OSPF on Ethernet interfaces and Ethernet vifs.

This chapter presents the following topics:

• Ethernet Interface and Vif OSPF Commands

Page 126: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

105

Ethernet Interface and Vif OSPF CommandsThis chapter contains the following commands.

Configuration Commands

OSPF for Ethernet Interfaces

interfaces ethernet <ethx> ip ospf authentication Specifies the authentication method for OSPF on an Ethernet interface.

interfaces ethernet <ethx> ip ospf bandwidth <bandwidth>

Specifies the bandwidth of an Ethernet interface for calculating OSPF cost.

interfaces ethernet <ethx> ip ospf cost <cost> Sets the routing cost for OSPF on an Ethernet interface.

interfaces ethernet <ethx> ip ospf dead-interval <interval>

Sets the OSPF dead interval for an Ethernet interface.

interfaces ethernet <ethx> ip ospf hello-interval <interval>

Sets the interval between OSPF hello packets on an Ethernet interface.

interfaces ethernet <ethx> ip ospf mtu-ignore Disables MTU mismatch detection for an Ethernet interface.

interfaces ethernet <ethx> ip ospf network <type> Specifies the OSPF network type for an Ethernet interface.

interfaces ethernet <ethx> ip ospf priority <priority> Sets the OSPF priority for an Ethernet interface.

interfaces ethernet <ethx> ip ospf retransmit-interval <interval>

Sets the OSPF retransmit interval for an Ethernet interface.

interfaces ethernet <ethx> ip ospf transmit-delay <delay>

Specifies the OSPF transmit delay for an Ethernet interface.

OSPF for Ethernet Vifs

interfaces ethernet <ethx> vif <vlan-id> ip ospf Enables OSPF on a virtual interface.

interfaces ethernet <ethx> vif <vlan-id> ip ospf authentication

Specifies the authentication method for OSPF on a virtual interface.

interfaces ethernet <ethx> vif <vlan-id> ip ospf bandwidth <bandwidth>

Specifies the bandwidth of a virtual interface for calculating OSPF cost.

interfaces ethernet <ethx> vif <vlan-id> ip ospf cost <cost>

Sets the routing cost for OSPF on a virtual interface.

interfaces ethernet <ethx> vif <vlan-id> ip ospf dead-interval <interval>

Sets the OSPF dead interval for a virtual interface.

Page 127: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

106

interfaces ethernet <ethx> vif <vlan-id> ip ospf hello-interval <interval>

Sets the interval between OSPF hello packets on a virtual interface.

interfaces ethernet <ethx> vif <vlan-id> ip ospf mtu-ignore

Disables MTU mismatch detection for a virtual interface.

interfaces ethernet <ethx> vif <vlan-id> ip ospf network <type>

Specifies the OSPF network type for a virtual interface.

interfaces ethernet <ethx> vif <vlan-id> ip ospf priority <priority>

Sets the OSPF priority for a virtual interface.

interfaces ethernet <ethx> vif <vlan-id> ip ospf retransmit-interval <interval>

Sets the OSPF retransmit interval for a virtual interface.

interfaces ethernet <ethx> vif <vlan-id> ip ospf transmit-delay <delay>

Specifies the OSPF transmit delay for a virtual interface.

Operational Commands

None.

Page 128: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

107

interfaces ethernet <ethx> ip ospfEnables OSPF on an Ethernet interface.

Syntax

set interfaces ethernet ethx ip ospf

delete interfaces ethernet ethx ip ospf

show interfaces ethernet ethx ip ospf

Command Mode

Configuration mode.

Configuration Statement

interfaces {ethernet eth0..eth23 {

ip {ospf

}}

}

Parameters

Default

None.

ethx Mandatory. Multi-node. An identifier for the Ethernet interface you are defining. This may be eth0 to eth23, depending on what Ethernet interfaces that are actually available on the system.

To see the interfaces available to the system kernel, use the system option of the show interfaces command (see page 76).

Page 129: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

108

Usage Guidelines

Use this command to enable the Open Shortest Path First (OSPF) routing protocol on an Ethernet interface.

Use the set form of this command to enable OSPF on an interface.

Use the delete form of this command to remove all OSPF configuration and disable OSPF on an interface.

Use the show form of this command to display OSPF configuration.

Page 130: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

109

interfaces ethernet <ethx> ip ospf authentication

Specifies the authentication method for OSPF on an Ethernet interface.

Syntax

set interfaces ethernet ethx ip ospf authentication [md5 key-id key-id md5-key md5-key | plaintext-password password]

delete interfaces ethernet ethx ip ospf authentication [md5 key-id key-id md5-key | plaintext-password]

show interfaces ethernet ethx ip ospf authentication [md5 key-id key-id md5-key | plaintext-password]

Command Mode

Configuration mode.

Configuration Statement

interfaces {ethernet eth0..eth23 {

ip {ospf {

authentication {md5 {

key-id 1-255 {md5-key: text

}}plaintext-password: text

}}

}}

}

Parameters

ethx Mandatory. Multi-node. An identifier for the Ethernet interface you are defining. This may be eth0 to eth23, depending on what Ethernet interfaces that are actually available on the system.

To see the interfaces available to the system kernel, use the system option of the show interfaces command (see page 76).

Page 131: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

110

Default

None.

Usage Guidelines

Use this command to specify the authentication method to be used for OSPF on an Ethernet interface. This authentication is independent of the authentication configured for the OSPF area.

In plain text authentication, passwords are sent through the network in plain text. In MD5 authentication, the system uses the Message Digest 5 (MD5) algorithm to compute a hash value from the contents of the OSPF packet and the password. The hash value and the MD5 key are included in the transmitted packet, and the receiving system (configured with the same password) calculates its own hash function, which must match.

The authentication parameters must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not consider establish adjacencies, and will disregard one another’s communications.

Use the set form of this command to set the authentication for an Ethernet interface.

Use the delete form of this command to remove Ethernet interface authentication configuration information.

Use the show form of this command to display Ethernet interface authentication configuration information.

key-id Optional. The key used to identify the MD5 key. This must be the same on both the sending and receiving systems. The range is 1 to 255.

md5-key Optional. A password-like MD5 key of up to 16 alphanumeric characters to be used as input to the MD5 hashing algorithm. The longer the key, the stronger the security. This must be the same on both the sending and receiving systems.

password Optional. The password to use in plain-text authentication. This must be eight characters or less and the same on both the sending and receiving systems.

Page 132: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

111

interfaces ethernet <ethx> ip ospf bandwidth <bandwidth>

Specifies the bandwidth of an Ethernet interface for calculating OSPF cost.

Syntax

set interfaces ethernet ethx ip ospf bandwidth bandwidth

delete interfaces ethernet ethx ip ospf bandwidth

show interfaces ethernet ethx ip ospf bandwidth

Command Mode

Configuration mode.

Configuration Statement

interfaces {ethernet eth0..eth23 {

ip {ospf {

bandwidth: u32}

}}

}

Parameters

Default

None.

ethx Mandatory. Multi-node. An identifier for the Ethernet interface you are defining. This may be eth0 to eth23, depending on what Ethernet interfaces that are actually available on the system.

To see the interfaces available to the system kernel, use the system option of the show interfaces command (see page 76).

bandwidth The bandwidth of the Ethernet interface in kilobits/sec. The range is 1 to 10000000.

Page 133: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

112

Usage Guidelines

Use this command to specify the bandwidth of the Ethernet interface for the purpose of computing OSPF cost.

Use the set form of this command to specify the bandwidth of the Ethernet interface.

Use the delete form of this command to remove the bandwidth parameter.

Use the show form of this command to display the bandwidth configuration.

Page 134: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

113

interfaces ethernet <ethx> ip ospf cost <cost>Sets the routing cost for OSPF on an Ethernet interface.

Syntax

set interfaces ethernet ethx ip ospf cost cost

delete interfaces ethernet ethx ip ospf cost

show interfaces ethernet ethx ip ospf cost

Command Mode

Configuration mode.

Configuration Statement

interfaces {ethernet eth0..eth23 {

ip {ospf {

cost: u32}

}}

}

Parameters

Default

For details on the default of OSPF cost, please see the Usage Guidelines.

ethx Mandatory. Multi-node. An identifier for the Ethernet interface you are defining. This may be eth0 to eth23, depending on what Ethernet interfaces that are actually available on the system.

To see the interfaces available to the system kernel, use the system option of the show interfaces command (see page 76).

cost The link-state metric (OSPF cost) to be advertised in the link-state advertisement (LSA) as the cost of sending packets over the ethernet interface. The range is 1 to 65535.

Page 135: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

114

Usage Guidelines

Use this command to manually override the default OSPF cost computed by the system for an Ethernet interface. You can only assign one cost per interface.

By default, the metric associated with a link is computed as follows:

Cost = 108 / bandwidth

The cost of reaching any destination is the sum of the costs of the individual hops. Costs are always rounded to the nearest integer. Costs lower than 1 are rounded up to 1.

Table 3-1 shows the OSPF costs for some common media types.

The values in Table 3-1 show how OSPF fails to distinguish between interfaces faster than 100 Mbps, for example, between Fast Ethernet (100 Mbps) and Gigabit Ethernet (1000 Mbps) interfaces. If you want to distinguish interfaces equal to or greater than 100 Mbps, you must manually configure the cost of the interface using this command.

Use the set form of this command to specify the OSPF cost for the Ethernet interface.

Use the delete form of this command to restore the default cost.

Use the show form of this command to display cost configuration.

Table 3-1 OSPF Costs for Common Media Types

Media Type OSPF Cost

56 Kbps 1785

64 Kbps 1562

128 Kbps 781

256 Kbps 390

512 Kbps 195

768 Kbps 130

T1 (1.544 Mbps) 64

E1 (2.048 Mbps) 48

4 Mbps Token Ring 6

10 Mbps Ethernet 10

16 Mbps Token Ring 6

T3 (44.736 Mbps 2

100+ Mbps 1

Page 136: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

115

interfaces ethernet <ethx> ip ospf dead-interval <interval>

Sets the OSPF dead interval for an Ethernet interface.

Syntax

set interfaces ethernet ethx ip ospf dead-interval interval

delete interfaces ethernet ethx ip ospf dead-interval

show interfaces ethernet ethx ip ospf dead-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {ethernet eth0..eth23 {

ip {ospf {

dead-interval: u32}

}}

}

Parameters

Default

The dead interval is 4 times the hello interval.

ethx Mandatory. Multi-node. An identifier for the Ethernet interface you are defining. This may be eth0 to eth23, depending on what Ethernet interfaces that are actually available on the system.

To see the interfaces available to the system kernel, use the system option of the show interfaces command (see page 76).

interval Specifies the time, in seconds, that this interface should wait to detect hello packets from neighboring routers before declaring the neighbor down. The range is 1 to 65535. The default is 4 times the hello interval.

Page 137: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

116

Usage Guidelines

Use this command to specify the interval during which an Ethernet interface should expect a hello packet from its neighbor.

If the dead interval passes without the interface receiving a hello packet from the neighbor, the neighbor’s status is changed to out-of-service, and all associated state is cleared.

The dead interval must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not establish adjacencies and will disregard one another’s communications.

Use the set form of this command to specify the dead interval.

Use the delete form of this command to restore the default dead interval.

Use the show form of this command to display dead interval configuration.

Page 138: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

117

interfaces ethernet <ethx> ip ospf hello-interval <interval>

Sets the interval between OSPF hello packets on an Ethernet interface.

Syntax

set interfaces ethernet ethx ip ospf hello-interval interval

delete interfaces ethernet ethx ip ospf hello-interval

show interfaces ethernet ethx ip ospf hello-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {ethernet eth0..eth23 {

ip {ospf {

hello-interval: u32}

}}

}

Parameters

Default

Hello packets are sent every 10 seconds.

ethx Mandatory. Multi-node. An identifier for the Ethernet interface you are defining. This may be eth0 to eth23, depending on what Ethernet interfaces that are actually available on the system.

To see the interfaces available to the system kernel, use the system option of the show interfaces command (see page 76).

interval Mandatory. The interval, in seconds, between hello packets. This value must be the same for all nodes on the network.The range is 1 to 65535. The default is 10.

Page 139: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

118

Usage Guidelines

Use this command to set the interval at which OSPF hello packets are sent for an Ethernet interface.

A hello packet is an OSPF packet used to detect and maintain relationships with neighbors on the same network (directly connected routers). The greater the interval between hello packets, the less router traffic occurs, but the longer it takes for topological changes to be

detected.

The hello interval must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not establish adjacencies and will disregard one another’s communications.

Use the set form of this command to set the hello interval.

Use the delete form of this command to restore the default hello interval.

Use the show form of this command to display hello interval configuration.

Page 140: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

119

interfaces ethernet <ethx> ip ospf mtu-ignoreDisables MTU mismatch detection for an Ethernet interface.

Syntax

set interfaces ethernet ethx ip ospf mtu-ignore

delete interfaces ethernet ethx ip ospf mtu-ignore

show interfaces ethernet ethx ip ospf

Command Mode

Configuration mode.

Configuration Statement

interfaces {ethernet eth0..eth23 {

ip {ospf {

mtu-ignore}

}}

}

Parameters

Default

MTU mismatch detection is enabled by default.

ethx Mandatory. Multi-node. An identifier for the Ethernet interface you are defining. This may be eth0 to eth23, depending on what Ethernet interfaces that are actually available on the system.

To see the interfaces available to the system kernel, use the system option of the show interfaces command (see page 76).

Page 141: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

120

Usage Guidelines

Use this command to disable MTU mismatch detection on an OSPF interface.

OSPF sends the MTU of the interface in a database description packet. If the MTUs of OSPF neighbors do not match, they cannot form an OSPF adjacency. MTU mismatch detection detects MTU mismatches and indicates them in the form of a debug message.

MTU mismatch is an important troubleshooting feature. If MTU mismatch is not enabled, MTU mismatches can only be detected by examining configuration for both interfaces.

There are some network setups where MTU mismatches are unavoidable, and even part of the normal set-up. It is for these cases only that MTU mismatch detection should be disabled, so that normal OSPF adjacencies can be formed.

Use the set form of this command to disable MTU mismatch detection.

Use the delete form of this command to re-enable MTU mismatch detection.

Use the show form of this command to display OSPF configuration.

Page 142: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

121

interfaces ethernet <ethx> ip ospf network <type>Specifies the OSPF network type for an Ethernet interface.

Syntax

set interfaces ethernet ethx ip ospf network [broadcast | non-broadcast | point-to-multipoint | point-to-point]

delete interfaces ethernet ethx ip ospf network

show interfaces ethernet ethx ip ospf network

Command Mode

Configuration mode.

Configuration Statement

interfaces {ethernet eth0..eth23 {

ip {ospf {

network: text}

}}

}

Parameters

ethx Mandatory. Multi-node. An identifier for the Ethernet interface you are defining. This may be eth0 to eth23, depending on what Ethernet interfaces that are actually available on the system.

To see the interfaces available to the system kernel, use the system option of the show interfaces command (see page 76).

Page 143: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

122

Default

Broadcast is supported.

Usage Guidelines

Use this command to configure and display the network type for the interface.

Use the set form of this command to specify the network type.

Use the delete form of this command to remove the network type.

Use the show form of this command to display the network type.

type The network type for this interface. Supported values are as follows:

broadcast: The interface supports broadcast mode, such as a LAN link.

non-broadcast: The interface does not support broadcast mode.

point-to-point: This interface supports point-to-point mode, such as an NBMA interface.

point-to-multipoint: This interface supports point-to-multipoint mode, such as a PPP interface or a point-to-point logical interface on Frame Relay.

The default is broadcast.

Page 144: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

123

interfaces ethernet <ethx> ip ospf priority <priority>Sets the OSPF priority for an Ethernet interface.

Syntax

set interfaces ethernet ethx ip ospf priority priority

delete interfaces ethernet ethx ip ospf priority

show interfaces ethernet ethx ip ospf priority

Command Mode

Configuration mode.

Configuration Statement

interfaces {ethernet eth0..eth23 {

ip {ospf {

priority: u32}

}}

}

Parameters

Default

An OSPF interface has a priority of 1.

ethx Mandatory. Multi-node. An identifier for the Ethernet interface you are defining. This may be eth0 to eth23, depending on what Ethernet interfaces that are actually available on the system.

To see the interfaces available to the system kernel, use the system option of the show interfaces command (see page 76).

priority Specifies the OSPF router priority for this interface. The range is 0 to 255, where a router with priority 0 can never become the designated router. The default is 1.

Page 145: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

124

Usage Guidelines

Use this command to set the priority for an Ethernet interface on the broadcast network to which the interface is connected. The priority determines which routers are selected as the area’s Designated Router (DR) and Backup Designated Router (BDR).

The DR and BDR are used to reduce the amount of traffic on OSPF overhead on broadcast networks, by reducing the number of adjacent routers to which a router must flood its topological information. In broadcast networks (such as Ethernet), each router establishes an adjacency with only the DR and the BDR, rather than with every router in its area. The DR and the BDR then flood this information to all other routers on the network segment.

Priority can range from 0 to 255. In general, the router with the highest priority is elected as the DR, and the router with the second-highest priority is elected as the BDR. The higher the number, the higher the priority.

Routers with a priority of 0 are ineligible for election.

Use the set form of this command to specify the OSPF priority.

Use the delete form of this command to restore the default priority.

Use the show form of this command to display priority configuration.

Page 146: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

125

interfaces ethernet <ethx> ip ospf retransmit-interval <interval>

Sets the OSPF retransmit interval for an Ethernet interface.

Syntax

set interfaces ethernet ethx ip ospf retransmit-interval interval

delete interfaces ethernet ethx ip ospf retransmit-interval

show interfaces ethernet ethx ip ospf retransmit-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {ethernet eth0..eth23 {

ip {ospf {

retransmit-interval: u32}

}}

}

Parameters

Default

Unacknowledged LSAs are retransmitted at 5-second intervals.

ethx Mandatory. Multi-node. An identifier for the Ethernet interface you are defining. This may be eth0 to eth23, depending on what Ethernet interfaces that are actually available on the system.

To see the interfaces available to the system kernel, use the system option of the show interfaces command (see page 76).

interval Specifies the time in seconds to wait for an acknowledgement, after which the system retransmits an LSA packet to its neighbors. The range is 3 to 65535. The default is 5.

Page 147: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

126

Usage Guidelines

Use this command to specify how long an Ethernet interface will wait for an acknowledgment of a link-state update before resending the update.

The link-state update packet is part of the exchange of topology databases between routers. When the initial database description (DD) packet is sent, it contains only the headers of the LSAs. If the receiving router determines that it requires that piece of the OSPF topology, it sends a link state request packet to request the complete LSA from the sending router.

After the update packet is sent, the sending router waits for an acknowledgement, either implicit or explicit, from the receiving router. In an explicit acknowledgement, the receiving router sends a link-state acknowledge (LS-Ack) packet to the router that sent the update. In an implicit acknowledgement, the router that sent the update receives an LSA from the receiving router that contains the update information.

If the retransmit interval passes with neither an explicit nor an implicit acknowledgement, the sending router will retransmit the link-state update packet.

Too high an interval slows network convergence. Too small an interval causes unnecessary retransmission.

Use the set form of this command to set the OSPF retransmit interval for an Ethernet interface.

Use the delete form of this command to restore the default retransmit interval.

Use the show form of this command to display retransmit interval configuration.

Page 148: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

127

interfaces ethernet <ethx> ip ospf transmit-delay <delay>

Specifies the OSPF transmit delay for an Ethernet interface.

Syntax

set interfaces ethernet ethx ip ospf transmit-delay delay

delete interfaces ethernet ethx ip ospf transmit-delay

show interfaces ethernet ethx ip ospf transmit-delay

Command Mode

Configuration mode.

Configuration Statement

interfaces {ethernet eth0..eth23 {

ip {ospf {

transmit-delay: u32}

}}

}

Parameters

Default

Link-state transmits occur at 1-second intervals.

ethx Mandatory. Multi-node. An identifier for the Ethernet interface you are defining. This may be eth0 to eth23, depending on what Ethernet interfaces that are actually available on the system.

To see the interfaces available to the system kernel, use the system option of the show interfaces command (see page 76).

delay Mandatory. The delay, in seconds, between link-state transmits. This value must be the same for all nodes on the network. The range is 1 to 65535. The default is 1.

Page 149: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

128

Usage Guidelines

Use this command to set the transmit delay for an Ethernet interface. This is the estimated time required to send a link-state update (LSU) packet.

This timer is used to accommodate transmission and propagation delays on the network, particularly on low-speed networks where delays may be significant. The router increments the age of link-state advertisements in LSU packets to account for these delays.

The value includes both the transmission time and the propagation delay across the network. The transmit delay is added to the age of the LSA packet before the LSA is transmitted The LSA age is used to help the network sequence LSAs, so that it can determine which of competing LSAs is the more recent and trustworthy.

LSAs are numbered in sequence, but the sequence numbers are finite, and so cannot be used as the sole determinant of the most recent LSA. Instead, OSPF also tracks the age of LSAs. Each time the LSA is forwarded to another router, its current age is incremented by the transmit delay. The packet’s age, together with its sequence number, helps the receiving router to determine which version of a received LSA is more recent, and therefore to be used.

Use the set form of this command to set the transmit delay.

Use the delete form of this command to restore the default transmit delay.

Use the show form of this command to display transmit delay configuration.

Page 150: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

129

interfaces ethernet <ethx> vif <vlan-id> ip ospfEnables OSPF on a virtual interface.

Syntax

set interfaces ethernet ethx vif vlan-id ip ospf

delete interfaces ethernet ethx vif vlan-id ip ospf

show interfaces ethernet ethx vif vlan-id ip ospf

Command Mode

Configuration mode.

Configuration Statement

interfaces {ethernet eth0..eth23 {

vif 0-4095 {ip {

ospf }

}}

}

Parameters

ethx Mandatory. Multi-node. An identifier for the Ethernet interface you are defining. This may be eth0 to eth23, depending on what Ethernet interfaces that are actually available on the system.

To see the interfaces available to the system kernel, use the system option of the show interfaces command (see page 76).

vlan-id Mandatory. Multi-node. The VLAN ID for the vif, for use with 802.1q VLAN tagging. Only tagged packets are received on vifs configured on Ethernet interfaces.

The range is 0 to 4095.

You can define more than one vif for a single interface by creating multiple vif configuration nodes.

Page 151: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

130

Default

None.

Usage Guidelines

Use this command to enable the Open Shortest Path First (OSPF) routing protocol on a virtual interface.

Use the set form of this command to enable OSPF on an interface.

Use the delete form of this command to remove all OSPF configuration and disable OSPF on an interface.

Use the show form of this command to display OSPF configuration.

Page 152: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

131

interfaces ethernet <ethx> vif <vlan-id> ip ospf authentication

Specifies the authentication method for OSPF on a virtual interface.

Syntax

set interfaces ethernet ethx vif vlan-id ip ospf authentication [md5 key-id key-id md5-key md5-key | plaintext-password password]

delete interfaces ethernet ethx vif vlan-id ip ospf authentication [md5 key-id key-id md5-key | plaintext-password]

show interfaces ethernet ethx vif vlan-id ip ospf authentication [md5 key-id key-id md5-key | plaintext-password]

Command Mode

Configuration mode.

Configuration Statement

interfaces {ethernet eth0..eth23 {

vif 0-4095 {ip {

ospf {authentication {

md5 {key-id 1-255 {

md5-key: text}

}plaintext-password: text

}}

}}

}}

Page 153: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

132

Parameters

Default

None.

Usage Guidelines

Use this command to specify the authentication method to be used for OSPF on a virtual interface. This authentication is independent of the authentication configured for the OSPF area.

In plain text authentication, passwords are sent through the network in plain text. In MD5 authentication, the system uses the Message Digest 5 (MD5) algorithm to compute a hash value from the contents of the OSPF packet and the password. The hash value and the MD5 key are included in the transmitted packet, and the receiving system (configured with the same password) calculates its own hash function, which must match.

ethx Mandatory. Multi-node. An identifier for the Ethernet interface you are defining. This may be eth0 to eth23, depending on what Ethernet interfaces that are actually available on the system.

To see the interfaces available to the system kernel, use the system option of the show interfaces command (see page 76).

vlan-id Mandatory. Multi-node. The VLAN ID for the vif, for use with 802.1q VLAN tagging. Only tagged packets are received on vifs configured on Ethernet interfaces.

The range is 0 to 4095.

You can define more than one vif for a single interface by creating multiple vif configuration nodes.

key-id Optional. The key used to identify the MD5 key. This must be the same on both the sending and receiving systems. The range is 1 to 255.

md5-key Optional. A password-like MD5 key of up to 16 alphanumeric characters to be used as input to the MD5 hashing algorithm. The longer the key, the stronger the security. This must be the same on both the sending and receiving systems.

password Optional. The password to use in plain-text authentication. This must be eight characters or less and the same on both the sending and receiving systems.

Page 154: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

133

The authentication parameters must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not consider establish adjacencies, and will disregard one another’s communications.

Use the set form of this command to set the authentication for a virtual interface.

Use the delete form of this command to remove virtual interface authentication configuration information.

Use the show form of this command to display virtual interface authentication configuration information.

Page 155: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

134

interfaces ethernet <ethx> vif <vlan-id> ip ospf bandwidth <bandwidth>

Specifies the bandwidth of a virtual interface for calculating OSPF cost.

Syntax

set interfaces ethernet ethx vif vlan-id ip ospf bandwidth bandwidth

delete interfaces ethernet ethx vif vlan-id ip ospf bandwidth

show interfaces ethernet ethx vif vlan-id ip ospf bandwidth

Command Mode

Configuration mode.

Configuration Statement

interfaces {ethernet eth0..eth23 {

vif 0-4095 {ip {

ospf {bandwidth: u32

}}

}}

}

Parameters

ethx Mandatory. Multi-node. An identifier for the Ethernet interface you are defining. This may be eth0 to eth23, depending on what Ethernet interfaces that are actually available on the system.

To see the interfaces available to the system kernel, use the system option of the show interfaces command (see page 76).

Page 156: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

135

Default

None.

Usage Guidelines

Use this command to specify the bandwidth of the virtual interface for the purpose of computing OSPF cost.

Use the set form of this command to specify the bandwidth of the virtual interface.

Use the delete form of this command to remove the bandwidth parameter.

Use the show form of this command to display the bandwidth configuration.

vlan-id Mandatory. Multi-node. The VLAN ID for the vif, for use with 802.1q VLAN tagging. Only tagged packets are received on vifs configured on Ethernet interfaces.

The range is 0 to 4095.

You can define more than one vif for a single interface by creating multiple vif configuration nodes.

bandwidth The bandwidth of the Ethernet interface in kilobits/sec. The range is 1 to 10000000.

Page 157: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

136

interfaces ethernet <ethx> vif <vlan-id> ip ospf cost <cost>

Sets the routing cost for OSPF on a virtual interface.

Syntax

set interfaces ethernet ethx vif vlan-id ip ospf cost cost

delete interfaces ethernet ethx vif vlan-id ip ospf cost

show interfaces ethernet ethx vif vlan-id ip ospf cost

Command Mode

Configuration mode.

Configuration Statement

interfaces {ethernet eth0..eth23 {

vif 0-4095 {ip {

ospf {cost: u32

}}

}}

}

Parameters

ethx Mandatory. Multi-node. An identifier for the Ethernet interface you are defining. This may be eth0 to eth23, depending on what Ethernet interfaces that are actually available on the system.

To see the interfaces available to the system kernel, use the system option of the show interfaces command (see page 76).

Page 158: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

137

Default

For details on the default of OSPF cost, please see the Usage Guidelines.

Usage Guidelines

Use this command to manually override the default OSPF cost computed by the system for a virtual interface. You can only assign one cost per interface.

By default, the metric associated with a link is computed as follows:

Cost = 108 / bandwidth

The cost of reaching any destination is the sum of the costs of the individual hops. Costs are always rounded to the nearest integer. Costs lower than 1 are rounded up to 1.

Table 3-2 shows the OSPF costs for some common media types.

vlan-id Mandatory. Multi-node. The VLAN ID for the vif, for use with 802.1q VLAN tagging. Only tagged packets are received on vifs configured on Ethernet interfaces.

The range is 0 to 4095.

You can define more than one vif for a single interface by creating multiple vif configuration nodes.

cost The link-state metric (OSPF cost) to be advertised in the link-state advertisement (LSA) as the cost of sending packets over the ethernet interface. The range is 1 to 65535.

Table 3-2 OSPF Costs for Common Media Types

Media Type OSPF Cost

56 Kbps 1785

64 Kbps 1562

128 Kbps 781

256 Kbps 390

512 Kbps 195

768 Kbps 130

T1 (1.544 Mbps) 64

E1 (2.048 Mbps) 48

4 Mbps Token Ring 6

Page 159: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

138

The values in Table 3-2 show how OSPF fails to distinguish between interfaces faster than 100 Mbps, for example, between Fast Ethernet (100 Mbps) and Gigabit Ethernet (1000 Mbps) interfaces. If you want to distinguish interfaces equal to or greater than 100 Mbps, you must manually configure the cost of the interface using this command.

Use the set form of this command to specify the OSPF cost for the virtual interface.

Use the delete form of this command to restore the default cost.

Use the show form of this command to display cost configuration.

10 Mbps Ethernet 10

16 Mbps Token Ring 6

T3 (44.736 Mbps 2

100+ Mbps 1

Table 3-2 OSPF Costs for Common Media Types

Page 160: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

139

interfaces ethernet <ethx> vif <vlan-id> ip ospf dead-interval <interval>

Sets the OSPF dead interval for a virtual interface.

Syntax

set interfaces ethernet ethx vif vlan-id ip ospf dead-interval interval

delete interfaces ethernet ethx vif vlan-id ip ospf dead-interval

show interfaces ethernet ethx vif vlan-id ip ospf dead-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {ethernet eth0..eth23 {

vif 0-4095 {ip {

ospf {dead-interval: u32

}}

}}

}

Parameters

ethx Mandatory. Multi-node. An identifier for the Ethernet interface you are defining. This may be eth0 to eth23, depending on what Ethernet interfaces that are actually available on the system.

To see the interfaces available to the system kernel, use the system option of the show interfaces command (see page 76).

Page 161: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

140

Default

The dead interval is 4 times the hello interval.

Usage Guidelines

Use this command to specify the interval during which a virtual interface should expect a hello packet from its neighbor.

If the dead interval passes without the interface receiving a hello packet from the neighbor, the neighbor’s status is changed to out-of-service, and all associated state is cleared.

The dead interval must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not establish adjacencies and will disregard one another’s communications.

Use the set form of this command to specify the dead interval.

Use the delete form of this command to restore the default dead interval.

Use the show form of this command to display dead interval configuration.

vlan-id Mandatory. Multi-node. The VLAN ID for the vif, for use with 802.1q VLAN tagging. Only tagged packets are received on vifs configured on Ethernet interfaces.

The range is 0 to 4095.

You can define more than one vif for a single interface by creating multiple vif configuration nodes.

interval Specifies the time, in seconds, that this interface should wait to detect hello packets from neighboring routers before declaring the neighbor down. The range is 1 to 65535. The default is 4 times the hello interval.

Page 162: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

141

interfaces ethernet <ethx> vif <vlan-id> ip ospf hello-interval <interval>

Sets the interval between OSPF hello packets on a virtual interface.

Syntax

set interfaces ethernet ethx vif vlan-id ip ospf hello-interval interval

delete interfaces ethernet ethx vif vlan-id ip ospf hello-interval

show interfaces ethernet ethx vif vlan-id ip ospf hello-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {ethernet eth0..eth23 {

vif 0-4095 {ip {

ospf {hello-interval: u32

}}

}}

}

Parameters

ethx Mandatory. Multi-node. An identifier for the Ethernet interface you are defining. This may be eth0 to eth23, depending on what Ethernet interfaces that are actually available on the system.

To see the interfaces available to the system kernel, use the system option of the show interfaces command (see page 76).

Page 163: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

142

Default

Hello packets are sent every 10 seconds.

Usage Guidelines

Use this command to set the interval at which OSPF hello packets are sent for a virtual interface.

A hello packet is an OSPF packet used to detect and maintain relationships with neighbors on the same network (directly connected routers). The greater the interval between hello packets, the less router traffic occurs, but the longer it takes for topological changes to be

detected.

The hello interval must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not establish adjacencies and will disregard one another’s communications.

Use the set form of this command to set the hello interval.

Use the delete form of this command to restore the default hello interval.

Use the show form of this command to display hello interval configuration.

vlan-id Mandatory. Multi-node. The VLAN ID for the vif, for use with 802.1q VLAN tagging. Only tagged packets are received on vifs configured on Ethernet interfaces.

The range is 0 to 4095.

You can define more than one vif for a single interface by creating multiple vif configuration nodes.

interval Mandatory. The interval, in seconds, between hello packets. This value must be the same for all nodes on the network.The range is 1 to 65535. The default is 10.

Page 164: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

143

interfaces ethernet <ethx> vif <vlan-id> ip ospf mtu-ignore

Disables MTU mismatch detection for a virtual interface.

Syntax

set interfaces ethernet ethx vif vlan-id ip ospf mtu-ignore

delete interfaces ethernet ethx vif vlan-id ip ospf mtu-ignore

show interfaces ethernet ethx vif vlan-id ip ospf

Command Mode

Configuration mode.

Configuration Statement

interfaces {ethernet eth0..eth23 {

vif 0-4095 {ip {

ospf {mtu-ignore

}}

}}

}

Parameters

ethx Mandatory. Multi-node. An identifier for the Ethernet interface you are defining. This may be eth0 to eth23, depending on what Ethernet interfaces that are actually available on the system.

To see the interfaces available to the system kernel, use the system option of the show interfaces command (see page 76).

Page 165: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

144

Default

MTU mismatch detection is enabled by default.

Usage Guidelines

Use this command to disable MTU mismatch detection on an OSPF interface.

OSPF sends the MTU of the interface in a database description packet. If the MTUs of OSPF neighbors do not match, they cannot form an OSPF adjacency. MTU mismatch detection detects MTU mismatches and indicates them in the form of a debug message.

MTU mismatch is an important troubleshooting feature. If MTU mismatch is not enabled, MTU mismatches can only be detected by examining configuration for both interfaces.

There are some network setups where MTU mismatches are unavoidable, and even part of the normal set-up. It is for these cases only that MTU mismatch detection should be disabled, so that normal OSPF adjacencies can be formed.

Use the set form of this command to disable MTU mismatch detection.

Use the delete form of this command to re-enable MTU mismatch detection.

Use the show form of this command to display OSPF configuration.

vlan-id Mandatory. Multi-node. The VLAN ID for the vif, for use with 802.1q VLAN tagging. Only tagged packets are received on vifs configured on Ethernet interfaces.

The range is 0 to 4095.

You can define more than one vif for a single interface by creating multiple vif configuration nodes.

Page 166: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

145

interfaces ethernet <ethx> vif <vlan-id> ip ospf network <type>

Specifies the OSPF network type for a virtual interface.

Syntax

set interfaces ethernet ethx vif vlan-id ip ospf network [broadcast | non-broadcast | point-to-multipoint | point-to-point]

delete interfaces ethernet ethx vif vlan-id ip ospf network

show interfaces ethernet ethx vif vlan-id ip ospf network

Command Mode

Configuration mode.

Configuration Statement

interfaces {ethernet eth0..eth23 {

vif 0-4095 {ip {

ospf {network: text

}}

}}

}

Parameters

ethx Mandatory. Multi-node. An identifier for the Ethernet interface you are defining. This may be eth0 to eth23, depending on what Ethernet interfaces that are actually available on the system.

To see the interfaces available to the system kernel, use the system option of the show interfaces command (see page 76).

Page 167: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

146

Default

Broadcast is supported.

Usage Guidelines

Use this command to configure and display the network type for the interface.

Use the set form of this command to specify the network type.

Use the delete form of this command to remove the network type.

Use the show form of this command to display the network type.

vlan-id Mandatory. Multi-node. The VLAN ID for the vif, for use with 802.1q VLAN tagging. Only tagged packets are received on vifs configured on Ethernet interfaces.

The range is 0 to 4095.

You can define more than one vif for a single interface by creating multiple vif configuration nodes.

type The network type for this interface. Supported values are as follows:

broadcast: The interface supports broadcast mode, such as a LAN link.

non-broadcast: The interface does not support broadcast mode.

point-to-point: This interface supports point-to-point mode, such as an NBMA interface.

point-to-multipoint: This interface supports point-to-multipoint mode, such as a PPP interface or a point-to-point logical interface on Frame Relay.

The default is broadcast.

Page 168: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

147

interfaces ethernet <ethx> vif <vlan-id> ip ospf priority <priority>

Sets the OSPF priority for a virtual interface.

Syntax

set interfaces ethernet ethx vif vlan-id ip ospf priority priority

delete interfaces ethernet ethx vif vlan-id ip ospf priority

show interfaces ethernet ethx vif vlan-id ip ospf priority

Command Mode

Configuration mode.

Configuration Statement

interfaces {ethernet eth0..eth23 {

vif 0-4095 {ip {

ospf {priority: u32

}}

}}

}

Parameters

ethx Mandatory. Multi-node. An identifier for the Ethernet interface you are defining. This may be eth0 to eth23, depending on what Ethernet interfaces that are actually available on the system.

To see the interfaces available to the system kernel, use the system option of the show interfaces command (see page 76).

Page 169: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

148

Default

An OSPF interface has a priority of 1.

Usage Guidelines

Use this command to set the priority for a virtual interface on the broadcast network to which the interface is connected. The priority determines which routers are selected as the area’s Designated Router (DR) and Backup Designated Router (BDR).

The DR and BDR are used to reduce the amount of traffic on OSPF overhead on broadcast networks, by reducing the number of adjacent routers to which a router must flood its topological information. In broadcast networks (such as Ethernet), each router establishes an adjacency with only the DR and the BDR, rather than with every router in its area. The DR and the BDR then flood this information to all other routers on the network segment.

Priority can range from 0 to 255. In general, the router with the highest priority is elected as the DR, and the router with the second-highest priority is elected as the BDR. The higher the number, the higher the priority.

Routers with a priority of 0 are ineligible for election.

Use the set form of this command to specify the OSPF priority.

Use the delete form of this command to restore the default priority.

Use the show form of this command to display priority configuration.

vlan-id Mandatory. Multi-node. The VLAN ID for the vif, for use with 802.1q VLAN tagging. Only tagged packets are received on vifs configured on Ethernet interfaces.

The range is 0 to 4095.

You can define more than one vif for a single interface by creating multiple vif configuration nodes.

priority Specifies the OSPF router priority for this interface. The range is 0 to 255, where a router with priority 0 can never become the designated router. The default is 1.

Page 170: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

149

interfaces ethernet <ethx> vif <vlan-id> ip ospf retransmit-interval <interval>

Sets the OSPF retransmit interval for a virtual interface.

Syntax

set interfaces ethernet ethx vif vlan-id ip ospf retransmit-interval interval

delete interfaces ethernet ethx vif vlan-id ip ospf retransmit-interval

show interfaces ethernet ethx vif vlan-id ip ospf retransmit-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {ethernet eth0..eth23 {

vif 0-4095 {ip {

ospf {retransmit-interval: u32

}}

}}

}

Parameters

ethx Mandatory. Multi-node. An identifier for the Ethernet interface you are defining. This may be eth0 to eth23, depending on what Ethernet interfaces that are actually available on the system.

To see the interfaces available to the system kernel, use the system option of the show interfaces command (see page 76).

Page 171: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

150

Default

Unacknowledged LSAs are retransmitted at 5-second intervals.

Usage Guidelines

Use this command to specify how long a virtual interface will wait for an acknowledgment of a link-state update before resending the update.

The link-state update packet is part of the exchange of topology databases between routers. When the initial database description (DD) packet is sent, it contains only the headers of the LSAs. If the receiving router determines that it requires that piece of the OSPF topology, it sends a link state request packet to request the complete LSA from the sending router.

After the update packet is sent, the sending router waits for an acknowledgement, either implicit or explicit, from the receiving router. In an explicit acknowledgement, the receiving router sends a link-state acknowledge (LS-Ack) packet to the router that sent the update. In an implicit acknowledgement, the router that sent the update receives an LSA from the receiving router that contains the update information.

If the retransmit interval passes with neither an explicit nor an implicit acknowledgement, the sending router will retransmit the link-state update packet.

Too high an interval slows network convergence. Too small an interval causes unnecessary retransmission.

Use the set form of this command to set the OSPF retransmit interval for a virtual interface.

Use the delete form of this command to restore the default retransmit interval.

Use the show form of this command to display retransmit interval configuration.

vlan-id Mandatory. Multi-node. The VLAN ID for the vif, for use with 802.1q VLAN tagging. Only tagged packets are received on vifs configured on Ethernet interfaces.

The range is 0 to 4095.

You can define more than one vif for a single interface by creating multiple vif configuration nodes.

interval Specifies the time in seconds to wait for an acknowledgement, after which the system retransmits an LSA packet to its neighbors. The range is 3 to 65535. The default is 5.

Page 172: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

151

interfaces ethernet <ethx> vif <vlan-id> ip ospf transmit-delay <delay>

Specifies the OSPF transmit delay for a virtual interface.

Syntax

set interfaces ethernet ethx vif vlan-id ip ospf transmit-delay delay

delete interfaces ethernet ethx vif vlan-id ip ospf transmit-delay

show interfaces ethernet ethx vif vlan-id ip ospf transmit-delay

Command Mode

Configuration mode.

Configuration Statement

interfaces {ethernet eth0..eth23 {

vif 0-4095 {ip {

ospf {transmit-delay: u32

}}

}}

}

Parameters

ethx Mandatory. Multi-node. An identifier for the Ethernet interface you are defining. This may be eth0 to eth23, depending on what Ethernet interfaces that are actually available on the system.

To see the interfaces available to the system kernel, use the system option of the show interfaces command (see page 76).

Page 173: Vyatta - OSPF

Chapter 3: Ethernet Interfaces and Vifs Ethernet Interface and Vif OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

152

Default

Link-state transmits occur at 1-second intervals.

Usage Guidelines

Use this command to set the transmit delay for a virtual interface. This is the estimated time required to send a link-state update (LSU) packet.

This timer is used to accommodate transmission and propagation delays on the network, particularly on low-speed networks where delays may be significant. The router increments the age of link-state advertisements in LSU packets to account for these delays.

The value includes both the transmission time and the propagation delay across the network. The transmit delay is added to the age of the LSA packet before the LSA is transmitted The LSA age is used to help the network sequence LSAs, so that it can determine which of competing LSAs is the more recent and trustworthy.

LSAs are numbered in sequence, but the sequence numbers are finite, and so cannot be used as the sole determinant of the most recent LSA. Instead, OSPF also tracks the age of LSAs. Each time the LSA is forwarded to another router, its current age is incremented by the transmit delay. The packet’s age, together with its sequence number, helps the receiving router to determine which version of a received LSA is more recent, and therefore to be used.

Use the set form of this command to set the transmit delay.

Use the delete form of this command to restore the default transmit delay.

Use the show form of this command to display transmit delay configuration.

vlan-id Mandatory. Multi-node. The VLAN ID for the vif, for use with 802.1q VLAN tagging. Only tagged packets are received on vifs configured on Ethernet interfaces.

The range is 0 to 4095.

You can define more than one vif for a single interface by creating multiple vif configuration nodes.

delay Mandatory. The delay, in seconds, between link-state transmits. This value must be the same for all nodes on the network. The range is 1 to 65535. The default is 1.

Page 174: Vyatta - OSPF

153

Chapter 4: Ethernet PPPoE Interfaces

This chapter describes commands for configuring OSPF on Ethernet interfaces with PPPoE encapsulation.

This chapter presents the following topics:

• Ethernet PPPoE Interface OSPF Commands

Page 175: Vyatta - OSPF

Chapter 4: Ethernet PPPoE Interfaces Ethernet PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

154

Ethernet PPPoE Interface OSPF CommandsThis chapter contains the following commands.

Configuration Commands

interfaces ethernet <ethx> pppoe <num> ip ospf Enables OSPF on a PPPoE interface.

interfaces ethernet <ethx> pppoe <num> ip ospf authentication

Specifies the authentication method for OSPF on a PPPoE interface.

interfaces ethernet <ethx> pppoe <num> ip ospf bandwidth <bandwidth>

Specifies the bandwidth of a PPPoE interface for calculating OSPF cost.

interfaces ethernet <ethx> pppoe <num> ip ospf cost <cost>

Sets the routing cost for OSPF on a PPPoE interface.

interfaces ethernet <ethx> pppoe <num> ip ospf dead-interval <interval>

Sets the dead interval for OSPF on a PPPoE interface.

interfaces ethernet <ethx> pppoe <num> ip ospf hello-interval <interval>

Sets the interval between OSPF hello packets on a PPPoE interface.

interfaces ethernet <ethx> pppoe <num> ip ospf mtu-ignore

Disables MTU mismatch detection for OSPF on a PPPoE interface.

interfaces ethernet <ethx> pppoe <num> ip ospf network <type>

Specifies the network type for OSPF on a PPPoE interface.

interfaces ethernet <ethx> pppoe <num> ip ospf priority <priority>

Sets the priority for OSPF on a PPPoE interface.

interfaces ethernet <ethx> pppoe <num> ip ospf retransmit-interval <interval>

Sets the retransmit interval for OSPF on a PPPoE interface.

interfaces ethernet <ethx> pppoe <num> ip ospf transmit-delay <delay>

Specifies the transmit delay for OSPF on a PPPoE interface.

Operational Commands

None.

Page 176: Vyatta - OSPF

Chapter 4: Ethernet PPPoE Interfaces Ethernet PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

155

interfaces ethernet <ethx> pppoe <num> ip ospfEnables OSPF on a PPPoE interface.

Syntax

set interfaces ethernet ethx pppoe num ip ospf

delete interfaces ethernet ethx pppoe num ip ospf

show interfaces ethernet ethx pppoe num ip ospf

Command Mode

Configuration mode.

Configuration Statement

interfaces {ethernet eth0..eth23 {

pppoe 0-15 {ip {

ospf }

}}

}

Parameters

Default

None.

ethx Mandatory. Multi-node. An identifier for the Ethernet interface you are defining. This may be eth0 to eth23, depending on what Ethernet interfaces that are actually available on the system.

To see the interfaces available to the system kernel, use the system option of the show interfaces command (see page 76).

num Mandatory. The name of a defined PPPoE unit. The range of values is 0 to 15.

Page 177: Vyatta - OSPF

Chapter 4: Ethernet PPPoE Interfaces Ethernet PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

156

Usage Guidelines

Use this command to enable the Open Shortest Path First (OSPF) routing protocol on a Point-to-Point over Ethernet (PPPoE) interface.

Use the set form of this command to enable OSPF on an interface.

Use the delete form of this command to remove all OSPF configuration and disable OSPF on an interface.

Use the show form of this command to display OSPF configuration.

Page 178: Vyatta - OSPF

Chapter 4: Ethernet PPPoE Interfaces Ethernet PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

157

interfaces ethernet <ethx> pppoe <num> ip ospf authentication

Specifies the authentication method for OSPF on a PPPoE interface.

Syntax

set interfaces ethernet ethx pppoe num ip ospf authentication [md5 key-id key-id md5-key md5-key | plaintext-password password]

delete interfaces ethernet ethx pppoe num ip ospf authentication [md5 key-id key-id md5-key | plaintext-password]

show interfaces ethernet ethx pppoe num ip ospf authentication [md5 key-id key-id md5-key | plaintext-password]

Command Mode

Configuration mode.

Configuration Statement

interfaces {ethernet eth0..eth23 {

pppoe 0-15 {ip {

ospf {authentication {

md5 {key-id 1-255 {

md5-key: text}

}plaintext-password: text

}}

}}

}}

Page 179: Vyatta - OSPF

Chapter 4: Ethernet PPPoE Interfaces Ethernet PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

158

Parameters

Default

None.

Usage Guidelines

Use this command to specify the authentication method to be used for OSPF on a Point-to-Point over Ethernet (PPPoE) interface. This authentication is independent of the authentication configured for the OSPF area.

In plain text authentication, passwords are sent through the network in plain text. In MD5 authentication, the system uses the Message Digest 5 (MD5) algorithm to compute a hash value from the contents of the OSPF packet and the password. The hash value and the MD5 key are included in the transmitted packet, and the receiving system (configured with the same password) calculates its own hash function, which must match.

The authentication parameters must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not consider establish adjacencies, and will disregard one another’s communications.

ethx Mandatory. Multi-node. An identifier for the Ethernet interface you are defining. This may be eth0 to eth23, depending on what Ethernet interfaces that are actually available on the system.

To see the interfaces available to the system kernel, use the system option of the show interfaces command (see page 76).

num Mandatory. The name of a defined PPPoE unit. The range of values is 0 to 15.

key-id Optional. The key used to identify the MD5 key. This must be the same on both the sending and receiving systems. The range is 1 to 255.

md5-key Optional. A password-like MD5 key of up to 16 alphanumeric characters to be used as input to the MD5 hashing algorithm. The longer the key, the stronger the security. This must be the same on both the sending and receiving systems.

password Optional. The password to use in plain-text authentication. This must be eight characters or less and the same on both the sending and receiving systems.

Page 180: Vyatta - OSPF

Chapter 4: Ethernet PPPoE Interfaces Ethernet PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

159

Use the set form of this command to set the authentication for a PPPoE interface.

Use the delete form of this command to remove PPPoE interface authentication configuration information.

Use the show form of this command to display PPPoE interface authentication configuration information.

Page 181: Vyatta - OSPF

Chapter 4: Ethernet PPPoE Interfaces Ethernet PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

160

interfaces ethernet <ethx> pppoe <num> ip ospf bandwidth <bandwidth>

Specifies the bandwidth of a PPPoE interface for calculating OSPF cost.

Syntax

set interfaces ethernet ethx pppoe num ip ospf bandwidth bandwidth

delete interfaces ethernet ethx pppoe num ip ospf bandwidth

show interfaces ethernet ethx pppoe num ip ospf bandwidth

Command Mode

Configuration mode.

Configuration Statement

interfaces {ethernet eth0..eth23 {

pppoe 0-15 {ip {

ospf {bandwidth: u32

}}

}}

}

Parameters

ethx Mandatory. Multi-node. An identifier for the Ethernet interface you are defining. This may be eth0 to eth23, depending on what Ethernet interfaces that are actually available on the system.

To see the interfaces available to the system kernel, use the system option of the show interfaces command (see page 76).

num Mandatory. The name of a defined PPPoE unit. The range of values is 0 to 15.

bandwidth The bandwidth of the Ethernet interface in kilobits/sec. The range is 1 to 10000000.

Page 182: Vyatta - OSPF

Chapter 4: Ethernet PPPoE Interfaces Ethernet PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

161

Default

None.

Usage Guidelines

Use this command to specify the bandwidth of the Point-to-Point over Ethernet (PPPoE) interface for the purpose of computing OSPF cost.

Use the set form of this command to specify the bandwidth of the PPPoE interface.

Use the delete form of this command to remove the bandwidth parameter.

Use the show form of this command to display the bandwidth configuration.

Page 183: Vyatta - OSPF

Chapter 4: Ethernet PPPoE Interfaces Ethernet PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

162

interfaces ethernet <ethx> pppoe <num> ip ospf cost <cost>

Sets the routing cost for OSPF on a PPPoE interface.

Syntax

set interfaces ethernet ethx pppoe num ip ospf cost cost

delete interfaces ethernet ethx pppoe num ip ospf cost

show interfaces ethernet ethx pppoe num ip ospf cost

Command Mode

Configuration mode.

Configuration Statement

interfaces {ethernet eth0..eth23 {

pppoe 0-15 {ip {

ospf {cost: u32

}}

}}

}

Parameters

ethx Mandatory. Multi-node. An identifier for the Ethernet interface you are defining. This may be eth0 to eth23, depending on what Ethernet interfaces that are actually available on the system.

To see the interfaces available to the system kernel, use the system option of the show interfaces command (see page 76).

num Mandatory. The name of a defined PPPoE unit. The range of values is 0 to 15.

cost The link-state metric (OSPF cost) to be advertised in the link-state advertisement (LSA) as the cost of sending packets over the ethernet interface. The range is 1 to 65535.

Page 184: Vyatta - OSPF

Chapter 4: Ethernet PPPoE Interfaces Ethernet PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

163

Default

For details on the default of OSPF cost, please see the Usage Guidelines.

Usage Guidelines

Use this command to manually override the default OSPF cost computed by the system for OSPF run on a Point-to-Point over Ethernet (PPPoE) interface. You can only assign one cost per interface.

By default, the metric associated with a link is computed as follows:

Cost = 108 / bandwidth

The cost of reaching any destination is the sum of the costs of the individual hops. Costs are always rounded to the nearest integer. Costs lower than 1 are rounded up to 1.

Table 4-1 shows the OSPF costs for some common media types.

The values in Table 4-1 show how OSPF fails to distinguish between interfaces faster than 100 Mbps, for example, between Fast Ethernet (100 Mbps) and Gigabit Ethernet (1000 Mbps) interfaces. If you want to distinguish interfaces equal to or greater than 100 Mbps, you must manually configure the cost of the interface using this command.

Table 4-1 OSPF Costs for Common Media Types

Media Type OSPF Cost

56 Kbps 1785

64 Kbps 1562

128 Kbps 781

256 Kbps 390

512 Kbps 195

768 Kbps 130

T1 (1.544 Mbps) 64

E1 (2.048 Mbps) 48

4 Mbps Token Ring 6

10 Mbps Ethernet 10

16 Mbps Token Ring 6

T3 (44.736 Mbps 2

100+ Mbps 1

Page 185: Vyatta - OSPF

Chapter 4: Ethernet PPPoE Interfaces Ethernet PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

164

Use the set form of this command to specify the OSPF cost for the PPPoE interface.

Use the delete form of this command to restore the default cost.

Use the show form of this command to display cost configuration.

Page 186: Vyatta - OSPF

Chapter 4: Ethernet PPPoE Interfaces Ethernet PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

165

interfaces ethernet <ethx> pppoe <num> ip ospf dead-interval <interval>

Sets the dead interval for OSPF on a PPPoE interface.

Syntax

set interfaces ethernet ethx pppoe num ip ospf dead-interval interval

delete interfaces ethernet ethx pppoe num ip ospf dead-interval

show interfaces ethernet ethx pppoe num ip ospf dead-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {ethernet eth0..eth23 {

pppoe 0-15 {ip {

ospf {dead-interval: u32

}}

}}

}

Parameters

ethx Mandatory. Multi-node. An identifier for the Ethernet interface you are defining. This may be eth0 to eth23, depending on what Ethernet interfaces that are actually available on the system.

To see the interfaces available to the system kernel, use the system option of the show interfaces command (see page 76).

num Mandatory. The name of a defined PPPoE unit. The range of values is 0 to 15.

interval Specifies the time, in seconds, that this interface should wait to detect hello packets from neighboring routers before declaring the neighbor down. The range is 1 to 65535. The default is 4 times the hello interval.

Page 187: Vyatta - OSPF

Chapter 4: Ethernet PPPoE Interfaces Ethernet PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

166

Default

The dead interval is 4 times the hello interval.

Usage Guidelines

Use this command to specify the interval during which a Point-to-Point over Ethernet (PPPoE) interface should expect an OSPF hello packet from its neighbor.

If the dead interval passes without the interface receiving a hello packet from the neighbor, the neighbor’s status is changed to out-of-service, and all associated state is cleared.

The dead interval must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not establish adjacencies and will disregard one another’s communications.

Use the set form of this command to specify the dead interval.

Use the delete form of this command to restore the default dead interval.

Use the show form of this command to display dead interval configuration.

Page 188: Vyatta - OSPF

Chapter 4: Ethernet PPPoE Interfaces Ethernet PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

167

interfaces ethernet <ethx> pppoe <num> ip ospf hello-interval <interval>

Sets the interval between OSPF hello packets on a PPPoE interface.

Syntax

set interfaces ethernet ethx pppoe num ip ospf hello-interval interval

delete interfaces ethernet ethx pppoe num ip ospf hello-interval

show interfaces ethernet ethx pppoe num ip ospf hello-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {ethernet eth0..eth23 {

pppoe 0-15 {ip {

ospf {hello-interval: u32

}}

}}

}

Parameters

ethx Mandatory. Multi-node. An identifier for the Ethernet interface you are defining. This may be eth0 to eth23, depending on what Ethernet interfaces that are actually available on the system.

To see the interfaces available to the system kernel, use the system option of the show interfaces command (see page 76).

num Mandatory. The name of a defined PPPoE unit. The range of values is 0 to 15.

interval Mandatory. The interval, in seconds, between hello packets. This value must be the same for all nodes on the network.The range is 1 to 65535. The default is 10.

Page 189: Vyatta - OSPF

Chapter 4: Ethernet PPPoE Interfaces Ethernet PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

168

Default

Hello packets are sent every 10 seconds.

Usage Guidelines

Use this command to set the interval at which OSPF hello packets are sent for a Point-to-Point over Ethernet (PPPoE) interface.

A hello packet is an OSPF packet used to detect and maintain relationships with neighbors on the same network (directly connected routers). The greater the interval between hello packets, the less router traffic occurs, but the longer it takes for topological changes to be detected.

The hello interval must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not establish adjacencies and will disregard one another’s communications.

Use the set form of this command to set the hello interval.

Use the delete form of this command to restore the default hello interval.

Use the show form of this command to display hello interval configuration.

Page 190: Vyatta - OSPF

Chapter 4: Ethernet PPPoE Interfaces Ethernet PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

169

interfaces ethernet <ethx> pppoe <num> ip ospf mtu-ignore

Disables MTU mismatch detection for OSPF on a PPPoE interface.

Syntax

set interfaces ethernet ethx pppoe num ip ospf mtu-ignore

delete interfaces ethernet ethx pppoe num ip ospf mtu-ignore

show interfaces ethernet ethx pppoe num ip ospf

Command Mode

Configuration mode.

Configuration Statement

interfaces {ethernet eth0..eth23 {

pppoe 0-15 {ip {

ospf {mtu-ignore

}}

}}

}

Parameters

ethx Mandatory. Multi-node. An identifier for the Ethernet interface you are defining. This may be eth0 to eth23, depending on what Ethernet interfaces that are actually available on the system.

To see the interfaces available to the system kernel, use the system option of the show interfaces command (see page 76).

num Mandatory. The name of a defined PPPoE unit. The range of values is 0 to 15.

Page 191: Vyatta - OSPF

Chapter 4: Ethernet PPPoE Interfaces Ethernet PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

170

Default

MTU mismatch detection is enabled by default.

Usage Guidelines

Use this command to disable MTU mismatch detection on an Point-to-Point over Ethernet (PPPoE) OSPF interface.

OSPF sends the MTU of the interface in a database description packet. If the MTUs of OSPF neighbors do not match, they cannot form an OSPF adjacency. MTU mismatch detection detects MTU mismatches and indicates them in the form of a debug message.

MTU mismatch is an important troubleshooting feature. If MTU mismatch is not enabled, MTU mismatches can only be detected by examining configuration for both interfaces.

There are some network setups where MTU mismatches are unavoidable, and even part of the normal set-up. It is for these cases only that MTU mismatch detection should be disabled, so that normal OSPF adjacencies can be formed.

Use the set form of this command to disable MTU mismatch detection.

Use the delete form of this command to re-enable MTU mismatch detection.

Use the show form of this command to display OSPF configuration.

Page 192: Vyatta - OSPF

Chapter 4: Ethernet PPPoE Interfaces Ethernet PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

171

interfaces ethernet <ethx> pppoe <num> ip ospf network <type>

Specifies the network type for OSPF on a PPPoE interface.

Syntax

set interfaces ethernet ethx pppoe num ip ospf network [broadcast | non-broadcast | point-to-multipoint | point-to-point]

delete interfaces ethernet ethx pppoe num ip ospf network

show interfaces ethernet ethx pppoe num ip ospf network

Command Mode

Configuration mode.

Configuration Statement

interfaces {ethernet eth0..eth23 {

pppoe 0-15 {ip {

ospf {network: text

}}

}}

}

Parameters

ethx Mandatory. Multi-node. An identifier for the Ethernet interface you are defining. This may be eth0 to eth23, depending on what Ethernet interfaces that are actually available on the system.

To see the interfaces available to the system kernel, use the system option of the show interfaces command (see page 76).

num Mandatory. The name of a defined PPPoE unit. The range of values is 0 to 15.

Page 193: Vyatta - OSPF

Chapter 4: Ethernet PPPoE Interfaces Ethernet PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

172

Default

Broadcast is supported.

Usage Guidelines

Use this command to configure and display the OSPF network type for a Point-to-Point over Ethernet (PPPoE) interface.

Use the set form of this command to specify the network type.

Use the delete form of this command to remove the network type.

Use the show form of this command to display the network type.

type The network type for this interface. Supported values are as follows:

broadcast: The interface supports broadcast mode, such as a LAN link.

non-broadcast: The interface does not support broadcast mode.

point-to-point: This interface supports point-to-point mode, such as an NBMA interface.

point-to-multipoint: This interface supports point-to-multipoint mode, such as a PPP interface or a point-to-point logical interface on Frame Relay.

The default is broadcast.

Page 194: Vyatta - OSPF

Chapter 4: Ethernet PPPoE Interfaces Ethernet PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

173

interfaces ethernet <ethx> pppoe <num> ip ospf priority <priority>

Sets the priority for OSPF on a PPPoE interface.

Syntax

set interfaces ethernet ethx pppoe num ip ospf priority priority

delete interfaces ethernet ethx pppoe num ip ospf priority

show interfaces ethernet ethx pppoe num ip ospf priority

Command Mode

Configuration mode.

Configuration Statement

interfaces {ethernet eth0..eth23 {

pppoe 0-15 {ip {

ospf {priority: u32

}}

}}

}

Parameters

ethx Mandatory. Multi-node. An identifier for the Ethernet interface you are defining. This may be eth0 to eth23, depending on what Ethernet interfaces that are actually available on the system.

To see the interfaces available to the system kernel, use the system option of the show interfaces command (see page 76).

num Mandatory. The name of a defined PPPoE unit. The range of values is 0 to 15.

priority Specifies the OSPF router priority for this interface. The range is 0 to 255, where a router with priority 0 can never become the designated router. The default is 1.

Page 195: Vyatta - OSPF

Chapter 4: Ethernet PPPoE Interfaces Ethernet PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

174

Default

An OSPF interface has a priority of 1.

Usage Guidelines

Use this command to set the OSPF priority for a Point-to-Point over Ethernet (PPPoE) interface on the broadcast network to which the interface is connected. The priority determines which routers are selected as the area’s Designated Router (DR) and Backup Designated Router (BDR).

The DR and BDR are used to reduce the amount of traffic on OSPF overhead on broadcast networks, by reducing the number of adjacent routers to which a router must flood its topological information. In broadcast networks (such as Ethernet), each router establishes an adjacency with only the DR and the BDR, rather than with every router in its area. The DR and the BDR then flood this information to all other routers on the network segment.

Priority can range from 0 to 255. In general, the router with the highest priority is elected as the DR, and the router with the second-highest priority is elected as the BDR. The higher the number, the higher the priority.

Routers with a priority of 0 are ineligible for election.

Use the set form of this command to specify the OSPF priority.

Use the delete form of this command to restore the default priority.

Use the show form of this command to display priority configuration.

Page 196: Vyatta - OSPF

Chapter 4: Ethernet PPPoE Interfaces Ethernet PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

175

interfaces ethernet <ethx> pppoe <num> ip ospf retransmit-interval <interval>

Sets the retransmit interval for OSPF on a PPPoE interface.

Syntax

set interfaces ethernet ethx pppoe num ip ospf retransmit-interval interval

delete interfaces ethernet ethx pppoe num ip ospf retransmit-interval

show interfaces ethernet ethx pppoe num ip ospf retransmit-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {ethernet eth0..eth23 {

pppoe 0-15 {ip {

ospf {retransmit-interval: u32

}}

}}

}

Parameters

ethx Mandatory. Multi-node. An identifier for the Ethernet interface you are defining. This may be eth0 to eth23, depending on what Ethernet interfaces that are actually available on the system.

To see the interfaces available to the system kernel, use the system option of the show interfaces command (see page 76).

num Mandatory. The name of a defined PPPoE unit. The range of values is 0 to 15.

interval Specifies the time in seconds to wait for an acknowledgement, after which the system retransmits an LSA packet to its neighbors. The range is 3 to 65535. The default is 5.

Page 197: Vyatta - OSPF

Chapter 4: Ethernet PPPoE Interfaces Ethernet PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

176

Default

Unacknowledged LSAs are retransmitted at 5-second intervals.

Usage Guidelines

Use this command to specify how long a Point-to-Point over Ethernet (PPPoE) interface will wait for an acknowledgment of a link-state update before resending the update.

The link-state update packet is part of the exchange of topology databases between routers. When the initial database description (DD) packet is sent, it contains only the headers of the LSAs. If the receiving router determines that it requires that piece of the OSPF topology, it sends a link state request packet to request the complete LSA from the sending router.

After the update packet is sent, the sending router waits for an acknowledgement, either implicit or explicit, from the receiving router. In an explicit acknowledgement, the receiving router sends a link-state acknowledge (LS-Ack) packet to the router that sent the update. In an implicit acknowledgement, the router that sent the update receives an LSA from the receiving router that contains the update information.

If the retransmit interval passes with neither an explicit nor an implicit acknowledgement, the sending router will retransmit the link-state update packet.

Too high an interval slows network convergence. Too small an interval causes unnecessary retransmission.

Use the set form of this command to set the OSPF retransmit interval for a PPPoE interface.

Use the delete form of this command to restore the default retransmit interval.

Use the show form of this command to display retransmit interval configuration.

Page 198: Vyatta - OSPF

Chapter 4: Ethernet PPPoE Interfaces Ethernet PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

177

interfaces ethernet <ethx> pppoe <num> ip ospf transmit-delay <delay>

Specifies the transmit delay for OSPF on a PPPoE interface.

Syntax

set interfaces ethernet ethx pppoe num ip ospf transmit-delay delay

delete interfaces ethernet ethx pppoe num ip ospf transmit-delay

show interfaces ethernet ethx pppoe num ip ospf transmit-delay

Command Mode

Configuration mode.

Configuration Statement

interfaces {ethernet eth0..eth23 {

pppoe 0-15 {ip {

ospf {transmit-delay: u32

}}

}}

}

Parameters

ethx Mandatory. Multi-node. An identifier for the Ethernet interface you are defining. This may be eth0 to eth23, depending on what Ethernet interfaces that are actually available on the system.

To see the interfaces available to the system kernel, use the system option of the show interfaces command (see page 76).

num Mandatory. The name of a defined PPPoE unit. The range of values is 0 to 15.

delay Mandatory. The delay, in seconds, between link-state transmits. This value must be the same for all nodes on the network. The range is 1 to 65535. The default is 1.

Page 199: Vyatta - OSPF

Chapter 4: Ethernet PPPoE Interfaces Ethernet PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

178

Default

Link-state transmits occur at 1-second intervals.

Usage Guidelines

Use this command to set the transmit delay for a Point-to-Point over Ethernet (PPPoE) interface. This is the estimated time required to send a link-state update (LSU) packet.

This timer is used to accommodate transmission and propagation delays on the network, particularly on low-speed networks where delays may be significant. The router increments the age of link-state advertisements in LSU packets to account for these delays.

The value includes both the transmission time and the propagation delay across the network. The transmit delay is added to the age of the LSA packet before the LSA is transmitted The LSA age is used to help the network sequence LSAs, so that it can determine which of competing LSAs is the more recent and trustworthy.

LSAs are numbered in sequence, but the sequence numbers are finite, and so cannot be used as the sole determinant of the most recent LSA. Instead, OSPF also tracks the age of LSAs. Each time the LSA is forwarded to another router, its current age is incremented by the transmit delay. The packet’s age, together with its sequence number, helps the receiving router to determine which version of a received LSA is more recent, and therefore to be used.

Use the set form of this command to set the transmit delay.

Use the delete form of this command to restore the default transmit delay.

Use the show form of this command to display transmit delay configuration.

Page 200: Vyatta - OSPF

179

Chapter 5: Loopback Interfaces

This chapter describes commands for configuring OSPF on loopback interfaces.

This chapter presents the following topics:

• Loopback Interface OSPF Commands

Page 201: Vyatta - OSPF

Chapter 5: Loopback Interfaces Loopback Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

180

Loopback Interface OSPF CommandsThis chapter contains the following commands.

Configuration Commands

interfaces loopback lo ip ospf Enables OSPF on the loopback interface.

interfaces loopback lo ip ospf authentication Specifies the authentication method for OSPF on the loopback interface.

interfaces loopback lo ip ospf cost <cost> Sets the routing cost for OSPF on the loopback interface.

interfaces loopback lo ip ospf dead-interval <interval> Sets the OSPF dead interval for the loopback interface.

interfaces loopback lo ip ospf hello-interval <interval> Sets the interval between OSPF hello packets on the loopback interface.

interfaces loopback lo ip ospf mtu-ignore Disables MTU mismatch detection for the loopback interface.

interfaces loopback lo ip ospf network <type> Specifies the OSPF network type for the loopback interface.

interfaces loopback lo ip ospf priority <priority> Specifies the Open Shortest Path First (OSPF) priority for the loopback interface.

interfaces loopback lo ip ospf retransmit-interval <interval>

Sets the OSPF retransmit interval for the loopback interface.

interfaces loopback lo ip ospf transmit-delay <delay> Specifies the Open Shortest Path First (OSPF) transmit delay for the loopback interface.

Operational Commands

None.

Page 202: Vyatta - OSPF

Chapter 5: Loopback Interfaces Loopback Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

181

interfaces loopback lo ip ospfEnables OSPF on the loopback interface.

Syntax

set interfaces loopback lo ip ospf

delete interfaces loopback lo ip ospf

show interfaces loopback lo ip ospf

Command Mode

Configuration mode.

Configuration Statement

interfaces {loopback lo {

ip {ospf

}}

}

Parameters

None.

Default

None.

Usage Guidelines

Use this command to enable the Open Shortest Path First (OSPF) routing protocol on the loopback interface.

Use the set form of this command to enable OSPF on the loopback interface.

Use the delete form of this command to remove all OSPF configuration and disable OSPF on the loopback interface.

Use the show form of this command to display OSPF configuration.

Page 203: Vyatta - OSPF

Chapter 5: Loopback Interfaces Loopback Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

182

interfaces loopback lo ip ospf authentication

Specifies the authentication method for OSPF on the loopback interface.

Syntax

set interfaces loopback lo ip ospf authentication [md5 key-id key-id md5-key md5-key | plaintext-password password]

delete interfaces loopback lo ip ospf authentication [md5 key-id key-id md5-key | plaintext-password]

show interfaces loopback lo ip ospf authentication [md5 key-id key-id md5-key | plaintext-password]

Command Mode

Configuration mode.

Configuration Statement

interfaces {loopback lo {

ip {ospf {

authentication {md5 {

key-id 1-255 {md5-key: text

}}plaintext-password: text

}}

}}

}

Parameters

key-id The key used to identify the MD5 key. This must be the same on both the sending and receiving systems. The range is 1 to 255.

Page 204: Vyatta - OSPF

Chapter 5: Loopback Interfaces Loopback Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

183

Default

None.

Usage Guidelines

Use this command to specify the authentication method to be used for OSPF on the loopback interface. This authentication is independent of the authentication configured for the OSPF area.

In plain text authentication, passwords are sent through the network in plain text. In MD5 authentication, the system uses the Message Digest 5 (MD5) algorithm to compute a hash value from the contents of the OSPF packet and the password. The hash value and the MD5 key are included in the transmitted packet, and the receiving system (configured with the same password) calculates its own hash function, which must match.

The authentication parameters must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not consider establish adjacencies, and will disregard one another’s communications.

Use the set form of this command to set the authentication for the loopback interface.

Use the delete form of this command to remove loopback interface authentication configuration information.

Use the show form of this command to display loopback interface authentication configuration information.

md5-key A password-like MD5 key of up to 16 alphanumeric characters to be used as input to the MD5 hashing algorithm. The longer the key, the stronger the security. This must be the same on both the sending and receiving systems.

password Optional. The password to use in plain-text authentication. This must be eight characters or less and the same on both the sending and receiving systems.

Page 205: Vyatta - OSPF

Chapter 5: Loopback Interfaces Loopback Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

184

interfaces loopback lo ip ospf cost <cost>Sets the routing cost for OSPF on the loopback interface.

Syntax

set interfaces loopback lo ip ospf cost cost

delete interfaces loopback lo ip ospf cost

show interfaces loopback lo ip ospf cost

Command Mode

Configuration mode.

Configuration Statement

interfaces {loopback lo {

ip {ospf {

cost: u32}

}}

}

Parameters

Default

For details on the default of OSPF cost, please see the Usage Guidelines.

Usage Guidelines

Use this command to manually override the default OSPF cost computed by the system for the loopback interface you are configuring. You can only assign one cost per interface.

By default, the metric associated with a link is computed as follows:

Cost = 108 / bandwidth

cost The link-state metric (OSPF cost) to be advertised in the link-state advertisement (LSA) as the cost of sending packets over the loopback interface. The range is 1 to 65535.

Page 206: Vyatta - OSPF

Chapter 5: Loopback Interfaces Loopback Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

185

The cost of reaching any destination is the sum of the costs of the individual hops. Costs are always rounded to the nearest integer. Costs lower than 1 are rounded up to 1.

Table 5-1 shows the OSPF costs for some common media types.

The values in Table 5-1show how OSPF fails to distinguish between interfaces faster than 100 Mbps, for example, between Fast Ethernet (100 Mbps) and Gigabit Ethernet (1000 Mbps) interfaces. If you want to distinguish interfaces equal to or greater than 100 Mbps, you must manually configure the cost of the interface using this command.

Use the set form of this command to specify the OSPF cost for the loopback interface.

Use the delete form of this command to restore the default cost.

Use the show form of this command to display cost configuration.

Table 5-1 OSPF Costs for Common Media Types

Media Type OSPF Cost

56 Kbps 1785

64 Kbps 1562

128 Kbps 781

256 Kbps 390

512 Kbps 195

768 Kbps 130

T1 (1.544 Mbps) 64

E1 (2.048 Mbps) 48

4 Mbps Token Ring 6

10 Mbps Ethernet 10

16 Mbps Token Ring 6

T3 (44.736 Mbps 2

100+ Mbps 1

Page 207: Vyatta - OSPF

Chapter 5: Loopback Interfaces Loopback Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

186

interfaces loopback lo ip ospf dead-interval <interval>Sets the OSPF dead interval for the loopback interface.

Syntax

set interfaces loopback lo ip ospf dead-interval interval

delete interfaces loopback lo ip ospf dead-interval

show interfaces loopback lo ip ospf dead-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {loopback lo {

ip {ospf {

dead-interval: u32}

}}

}

Parameters

Default

The dead interval is 4 times the hello interval.

Usage Guidelines

Use this command to specify the interval during which the loopback interface should expect a hello packet from its neighbor.

If the dead interval passes without the interface receiving a hello packet from the neighbor, the neighbor’s status is changed to out-of-service, and all associated state is cleared.

interval Specifies the time, in seconds, that this interface should wait to detect hello packets from neighboring routers before declaring the neighbor down. The range is 1 to 65535. The default is 4 times the hello interval.

Page 208: Vyatta - OSPF

Chapter 5: Loopback Interfaces Loopback Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

187

The dead interval must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not establish adjacencies and will disregard one another’s communications.

Use the set form of this command to specify the dead interval.

Use the delete form of this command to restore the default dead interval.

Use the show form of this command to display dead interval configuration.

Page 209: Vyatta - OSPF

Chapter 5: Loopback Interfaces Loopback Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

188

interfaces loopback lo ip ospf hello-interval <interval>Sets the interval between OSPF hello packets on the loopback interface.

Syntax

set interfaces loopback lo ip ospf hello-interval interval

delete interfaces loopback lo ip ospf hello-interval

show interfaces loopback lo ip ospf hello-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {loopback lo {

ip {ospf {

hello-interval: u32}

}}

}

Parameters

Default

Hello packets are sent every 10 seconds.

interval Mandatory. The interval, in seconds, between hello packets. This value must be the same for all nodes on the network.The range is 1 to 65535. The default is 10.

Page 210: Vyatta - OSPF

Chapter 5: Loopback Interfaces Loopback Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

189

Usage Guidelines

Use this command to set the interval at which OSPF hello packets are sent for the loopback interface.

A hello packet is an OSPF packet used to detect and maintain relationships with neighbors on the same network (directly connected routers). The greater the interval between hello packets, the less router traffic occurs, but the longer it takes for topological changes to be

detected.

The hello interval must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not establish adjacencies and will disregard one another’s communications.

Use the set form of this command to set the hello interval.

Use the delete form of this command to restore the default hello interval.

Use the show form of this command to display hello interval configuration.

Page 211: Vyatta - OSPF

Chapter 5: Loopback Interfaces Loopback Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

190

interfaces loopback lo ip ospf mtu-ignoreDisables MTU mismatch detection for the loopback interface.

Syntax

set interfaces loopback lo ip ospf mtu-ignore

delete interfaces loopback lo ip ospf mtu-ignore

show interfaces loopback lo ip ospf mtu-ignore

Command Mode

Configuration mode.

Configuration Statement

interfaces {loopback lo {

ip {ospf {

mtu-ignore}

}}

}

Parameters

None.

Default

MTU mismatch detection is enabled by default.

Usage Guidelines

Use this command to disable MTU mismatch detection on an OSPF interface.

OSPF sends the MTU of the interface in a database description packet. If the MTUs of OSPF neighbors do not match, they cannot form an OSPF adjacency. MTU mismatch detection detects MTU mismatches and indicates them in the form of a debug message.

MTU mismatch is an important troubleshooting feature. If MTU mismatch is not enabled, MTU mismatches can only be detected by examining configuration for both interfaces.

Page 212: Vyatta - OSPF

Chapter 5: Loopback Interfaces Loopback Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

191

There are some network setups where MTU mismatches are unavoidable, and even part of the normal set-up. It is for these cases only that MTU mismatch detection should be disabled, so that normal OSPF adjacencies can be formed.

Use the set form of this command to disable MTU mismatch detection.

Use the delete form of this command to re-enable MTU mismatch detection.

Use the show form of this command to display OSPF configuration.

Page 213: Vyatta - OSPF

Chapter 5: Loopback Interfaces Loopback Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

192

interfaces loopback lo ip ospf network <type>Specifies the OSPF network type for the loopback interface.

Syntax

set interfaces loopback lo ip ospf network [broadcast | non-broadcast | point-to-multipoint | point-to-point]

delete interfaces loopback lo ip ospf network

show interfaces loopback lo ip ospf network

Command Mode

Configuration mode.

Configuration Statement

interfaces {loopback lo {

ip {ospf {

network: text}

}}

}

Parameters

type Specifies the network type for this interface. The following values are supported:

broadcast: This is an interface that supports broadcast mode (such as a LAN link).

non-broadcast: This is an interface that does not support broadcast mode.

point-to-multipoint: This is an interface that supports point-to-multipoint mode (such as a PPP interface or a point-to-point logical interface on Frame Relay).

point-to-point: This is an interface that supports point-to-point mode (such as an NBMA interface).

The default is broadcast.

Page 214: Vyatta - OSPF

Chapter 5: Loopback Interfaces Loopback Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

193

Default

Broadcast is supported.

Usage Guidelines

Use this command to configure and display the network type for the interface.

Use the set form of this command to specify the network type.

Use the delete form of this command to remove the network type.

Use the show form of this command to display the network type.

Page 215: Vyatta - OSPF

Chapter 5: Loopback Interfaces Loopback Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

194

interfaces loopback lo ip ospf priority <priority>Specifies the Open Shortest Path First (OSPF) priority for the loopback interface.

Syntax

set interfaces loopback lo ip ospf priority priority

delete interfaces loopback lo ip ospf priority

show interfaces loopback lo ip ospf priority

Command Mode

Configuration mode.

Configuration Statement

interfaces {loopback lo {

ip {ospf {

priority: u32}

}}

}

Parameters

Default

The loopback interface has an priority of 1.

Usage Guidelines

Use this command to set the priority for the loopback interface on the broadcast network to which the interface is connected. The priority determines which routers are selected as the area’s Designated Router (DR) and Backup Designated Router (BDR).

priority Specifies the OSPF router priority for this interface. The range is 0 to 255, where a router with priority 0 can never become the designated router. The default is 1.

Page 216: Vyatta - OSPF

Chapter 5: Loopback Interfaces Loopback Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

195

The DR and BDR are used to reduce the amount of traffic on OSPF overhead on broadcast networks, by reducing the number of adjacent routers to which a router must flood its topological information. In broadcast networks (such as Ethernet), each router establishes an adjacency with only the DR and the BDR, rather than with every router in its area. The DR and the BDR then flood this information to all other routers on the network segment.

Priority can range from 0 to 255. In general, the router with the highest priority is elected as the DR, and the router with the second-highest priority is elected as the BDR. The higher the number, the higher the priority.

Routers with a priority of 0 are ineligible for election.

Use the set form of this command to specify the OSPF priority.

Use the delete form of this command to restore the default priority.

Use the show form of this command to display priority configuration.

Page 217: Vyatta - OSPF

Chapter 5: Loopback Interfaces Loopback Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

196

interfaces loopback lo ip ospf retransmit-interval <interval>

Sets the OSPF retransmit interval for the loopback interface.

Syntax

set interfaces loopback lo ip ospf retransmit-interval interval

delete interfaces loopback lo ip ospf retransmit-interval

show interfaces loopback lo ip ospf retransmit-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {loopback lo {

ip {ospf {

retransmit-interval: u32}

}}

}

Parameters

Default

Unacknowledged LSAs are retransmitted at 5-second intervals.

interval Specifies the time in seconds to wait for an acknowledgement, after which the system retransmits an LSA packet to its neighbors. The range is 3 to 65535. The default is 5.

Page 218: Vyatta - OSPF

Chapter 5: Loopback Interfaces Loopback Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

197

Usage Guidelines

Use this command to specify how long an Ethernet interface will wait for an acknowledgment of a link-state update before resending the update.

The link-state update packet is part of the exchange of topology databases between routers. When the initial database description (DD) packet is sent, it contains only the headers of the LSAs. If the receiving router determines that it requires that piece of the OSPF topology, it sends a link state request packet to request the complete LSA from the sending router.

After the update packet is sent, the sending router waits for an acknowledgement, either implicit or explicit, from the receiving router. In an explicit acknowledgement, the receiving router sends a link-state acknowledge (LS-Ack) packet to the router that sent the update. In an implicit acknowledgement, the router that sent the update receives an LSA from the receiving router that contains the update information.

If the retransmit interval passes with neither an explicit nor an implicit acknowledgement, the sending router will retransmit the link-state update packet.

Too high an interval slows network convergence. Too small an interval causes unnecessary retransmission.

Use the set form of this command to set the OSPF retransmit interval for the loopback interface.

Use the delete form of this command to restore the default retransmit interval.

Use the show form of this command to display retransmit interval configuration.

Page 219: Vyatta - OSPF

Chapter 5: Loopback Interfaces Loopback Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

198

interfaces loopback lo ip ospf transmit-delay <delay>Specifies the Open Shortest Path First (OSPF) transmit delay for the loopback interface.

Syntax

set interfaces loopback lo ip ospf transmit-delay delay

delete interfaces loopback lo ip ospf transmit-delay

show interfaces loopback lo ip ospf transmit-delay

Command Mode

Configuration mode.

Configuration Statement

interfaces {loopback lo {

ip {ospf {

transmit-delay: u32}

}}

}

Parameters

Default

Link-state transmits occur at 1-second intervals.

Usage Guidelines

Use this command to set the transmit delay on the loopback interface. This is the estimated time required to send a link-state update (LSU) packet.

delay Mandatory. The delay, in seconds, between link-state transmits. This value must be the same for all nodes on the network. The range is 1 to 65535. The default is 1.

Page 220: Vyatta - OSPF

Chapter 5: Loopback Interfaces Loopback Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

199

This timer is used to accommodate transmission and propagation delays on the network, particularly on low-speed networks where delays may be significant. The router increments the age of link-state advertisements in LSU packets to account for these delays.

The value includes both the transmission time and the propagation delay across the network. The transmit delay is added to the age of the LSA packet before the LSA is transmitted The LSA age is used to help the network sequence LSAs, so that it can determine which of competing LSAs is the more recent and trustworthy.

LSAs are numbered in sequence, but the sequence numbers are finite, and so cannot be used as the sole determinant of the most recent LSA. Instead, OSPF also tracks the age of LSAs. Each time the LSA is forwarded to another router, its current age is incremented by the transmit delay. The packet’s age, together with its sequence number, helps the receiving router to determine which version of a received LSA is more recent, and therefore to be used.

Use the set form of this command to set the transmit delay.

Use the delete form of this command to restore the default transmit delay.

Use the show form of this command to display transmit delay configuration.

Page 221: Vyatta - OSPF

200

Chapter 6: Serial PPP Interfaces

This chapter describes commands for configuring OSPF on serial interfaces with Point-to-Point Protocol encapsulation.

This chapter presents the following topics:

• Serial PPP Interface OSPF Commands

Page 222: Vyatta - OSPF

Chapter 6: Serial PPP Interfaces Serial PPP Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

201

Serial PPP Interface OSPF CommandsThis chapter contains the following commands.

Configuration Commands

interfaces serial <wanx> ppp vif 1 ip ospf Enables OSPF on the virtual interface of a PPP serial interface.

interfaces serial <wanx> ppp vif 1 ip ospf authentication Specifies the authentication method for OSPF on the virtual interface of a PPP serial interface.

interfaces serial <wanx> ppp vif 1 ip ospf bandwidth <bandwidth>

Specifies the bandwidth on the virtual interface of a PPP serial interface for calculating OSPF cost.

interfaces serial <wanx> ppp vif 1 ip ospf cost <cost> Sets the routing cost for OSPF on the virtual interface of a PPP serial interface.

interfaces serial <wanx> ppp vif 1 ip ospf dead-interval <interval>

Sets the OSPF dead interval for the virtual interface of a PPP serial interface.

interfaces serial <wanx> ppp vif 1 ip ospf hello-interval <interval>

Sets the interval between OSPF hello packets on the virtual interface of a PPP serial interface.

interfaces serial <wanx> ppp vif 1 ip ospf mtu-ignore Disables MTU mismatch detection for the virtual interface of a PPP serial interface.

interfaces serial <wanx> ppp vif 1 ip ospf network <type>

Specifies the OSPF network type for the virtual interface of a PPP serial interface.

interfaces serial <wanx> ppp vif 1 ip ospf priority <priority>

Sets the OSPF priority for the virtual interface of a PPP serial interface.

interfaces serial <wanx> ppp vif 1 ip ospf retransmit-interval <interval>

Sets the OSPF retransmit interval for the virtual interface of a PPP serial interface.

interfaces serial <wanx> ppp vif 1 ip ospf transmit-delay <delay>

Specifies the OSPF transmit delay for the virtual interface of a PPP serial interface.

Operational Commands

None.

Page 223: Vyatta - OSPF

Chapter 6: Serial PPP Interfaces Serial PPP Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

202

interfaces serial <wanx> ppp vif 1 ip ospfEnables OSPF on the virtual interface of a PPP serial interface.

Syntax

set interfaces serial wanx ppp vif 1 ip ospf

delete interfaces serial wanx ppp vif 1 ip ospf

show interfaces serial wanx ppp vif 1

Command Mode

Configuration mode.

Configuration Statement

interfaces {serial wan0..wan23 {

ppp {vif 1 {

ip ospf}

}}

}

Parameters

Default

OSPF is not enabled on PPP interfaces.

wanx Mandatory. Multi-node. The identifier for the serial interface you are defining. This may be wan0 to wan23, depending on what serial interfaces that are actually available on the system.

1 The identifier of the virtual interface. Currently, only one vif is supported for PPP interfaces, and the identifier must be 1.

Page 224: Vyatta - OSPF

Chapter 6: Serial PPP Interfaces Serial PPP Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

203

Usage Guidelines

Use this command to enable the Open Shortest Path First (OSPF) routing protocol on the virtual interface of a Point-to-Point Protocol (PPP) serial interface.

Use the set form of this command to enable OSPF on a PPP virtual interface.

Use the delete form of this command to disable OSPF on a PPP virtual interface.

Use the show form of this command to display PPP virtual interface configuration.

Page 225: Vyatta - OSPF

Chapter 6: Serial PPP Interfaces Serial PPP Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

204

interfaces serial <wanx> ppp vif 1 ip ospf authentication

Specifies the authentication method for OSPF on the virtual interface of a PPP serial interface.

Syntax

set interfaces serial wanx ppp vif 1 ip ospf authentication [md5 key-id key-id md5-key md5-key | plaintext-password password]

delete interfaces serial wanx ppp vif 1 ip ospf authentication [md5 key-id key-id md5-key | plaintext-password]

show interfaces serial wanx ppp vif 1 ip ospf authentication [md5 key-id key-id md5-key | plaintext-password]

Command Mode

Configuration mode.

Configuration Statement

interfaces {serial wan0..wan23 {

ppp {vif 1 {

ip {ospf {

authentication {md5 {

key-id 1-255 {md5-key: text

}}plaintext-password: text

}}

}}

}}

}

Page 226: Vyatta - OSPF

Chapter 6: Serial PPP Interfaces Serial PPP Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

205

Parameters

Default

None.

Usage Guidelines

Use this command to specify the authentication method to be used for OSPF on the virtual interface of a PPP serial interface. This authentication is independent of the authentication configured for the OSPF area.

In plain text authentication, passwords are sent through the network in plain text. In MD5 authentication, the system uses the Message Digest 5 (MD5) algorithm to compute a hash value from the contents of the OSPF packet and the password. The hash value and the MD5 key are included in the transmitted packet, and the receiving system (configured with the same password) calculates its own hash function, which must match.

The authentication parameters must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not consider establish adjacencies, and will disregard one another’s communications.

Use the set form of this command to set the authentication for the virtual interface of a PPP serial interface.

Use the delete form of this command to remove interface authentication configuration information.

wanx Mandatory. Multi-node. The identifier for the serial interface you are defining. This may be wan0 to wan23, depending on what serial interfaces that are actually available on the system.

1 The identifier of the virtual interface. Currently, only one vif is supported for PPP interfaces, and the identifier must be 1.

key-id Optional. The key used to identify the MD5 key. This must be the same on both the sending and receiving systems. The range is 1 to 255.

md5-key Optional. A password-like MD5 key of up to 16 alphanumeric characters to be used as input to the MD5 hashing algorithm. The longer the key, the stronger the security. This must be the same on both the sending and receiving systems.

password Optional. The password to use in plain-text authentication. This must be eight characters or less and the same on both the sending and receiving systems.

Page 227: Vyatta - OSPF

Chapter 6: Serial PPP Interfaces Serial PPP Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

206

Use the show form of this command to display interface authentication configuration information.

Page 228: Vyatta - OSPF

Chapter 6: Serial PPP Interfaces Serial PPP Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

207

interfaces serial <wanx> ppp vif 1 ip ospf bandwidth <bandwidth>

Specifies the bandwidth on the virtual interface of a PPP serial interface for calculating OSPF cost.

Syntax

set interfaces serial wanx ppp vif 1 ip ospf bandwidth bandwidth

delete interfaces serial wanx ppp vif 1 ip ospf bandwidth

show interfaces serial wanx ppp vif 1 ip ospf bandwidth

Command Mode

Configuration mode.

Configuration Statement

interfaces {serial wan0..wan23 {

ppp {vif 1 {

ip {ospf {

bandwidth: u32}

}}

}}

}

Parameters

wanx Mandatory. Multi-node. The identifier for the serial interface you are defining. This may be wan0 to wan23, depending on what serial interfaces that are actually available on the system.

1 The identifier of the virtual interface. Currently, only one vif is supported for PPP interfaces, and the identifier must be 1.

bandwidth The bandwidth of the Ethernet interface in kilobits/sec. The range is 1 to 10000000.

Page 229: Vyatta - OSPF

Chapter 6: Serial PPP Interfaces Serial PPP Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

208

Default

None.

Usage Guidelines

Use this command to specify the bandwidth of the virtual interface of a PPP serial interface for the purpose of computing OSPF cost.

Use the set form of this command to specify the bandwidth of the interface.

Use the delete form of this command to remove the bandwidth parameter.

Use the show form of this command to display the bandwidth configuration.

Page 230: Vyatta - OSPF

Chapter 6: Serial PPP Interfaces Serial PPP Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

209

interfaces serial <wanx> ppp vif 1 ip ospf cost <cost>Sets the routing cost for OSPF on the virtual interface of a PPP serial interface.

Syntax

set interfaces serial wanx ppp vif 1 ip ospf cost cost

delete interfaces serial wanx ppp vif 1 ip ospf cost

show interfaces serial wanx ppp vif 1 ip ospf cost

Command Mode

Configuration mode.

Configuration Statement

interfaces {serial wan0..wan23 {

ppp {vif 1 {

ip {ospf {

cost: u32}

}}

}}

}

Parameters

wanx Mandatory. Multi-node. The identifier for the serial interface you are defining. This may be wan0 to wan23, depending on what serial interfaces that are actually available on the system.

1 The identifier of the virtual interface. Currently, only one vif is supported for PPP interfaces, and the identifier must be 1.

cost The link-state metric (OSPF cost) to be advertised in the link-state advertisement (LSA) as the cost of sending packets over the ethernet interface. The range is 1 to 65535.

Page 231: Vyatta - OSPF

Chapter 6: Serial PPP Interfaces Serial PPP Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

210

Default

For details on the default of OSPF cost, please see the Usage Guidelines.

Usage Guidelines

Use this command to manually override the default OSPF cost computed by the system for the virtual interface of a PPP serial interface. You can only assign one cost per interface.

By default, the metric associated with a link is computed as follows:

Cost = 108 / bandwidth

The cost of reaching any destination is the sum of the costs of the individual hops. Costs are always rounded to the nearest integer. Costs lower than 1 are rounded up to 1.

Table 6-1 shows the OSPF costs for some common media types.

The values in Table 6-1 show how OSPF fails to distinguish between interfaces faster than 100 Mbps, for example, between Fast Ethernet (100 Mbps) and Gigabit Ethernet (1000 Mbps) interfaces. If you want to distinguish interfaces equal to or greater than 100 Mbps, you must manually configure the cost of the interface using this command.

Table 6-1 OSPF Costs for Common Media Types

Media Type OSPF Cost

56 Kbps 1785

64 Kbps 1562

128 Kbps 781

256 Kbps 390

512 Kbps 195

768 Kbps 130

T1 (1.544 Mbps) 64

E1 (2.048 Mbps) 48

4 Mbps Token Ring 6

10 Mbps Ethernet 10

16 Mbps Token Ring 6

T3 (44.736 Mbps 2

100+ Mbps 1

Page 232: Vyatta - OSPF

Chapter 6: Serial PPP Interfaces Serial PPP Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

211

Use the set form of this command to specify the OSPF cost for the interface.

Use the delete form of this command to restore the default cost.

Use the show form of this command to display cost configuration.

Page 233: Vyatta - OSPF

Chapter 6: Serial PPP Interfaces Serial PPP Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

212

interfaces serial <wanx> ppp vif 1 ip ospf dead-interval <interval>

Sets the OSPF dead interval for the virtual interface of a PPP serial interface.

Syntax

set interfaces serial wanx ppp vif 1 ip ospf dead-interval interval

delete interfaces serial wanx ppp vif 1 ip ospf dead-interval

show interfaces serial wanx ppp vif 1 ip ospf dead-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {serial wan0..wan23 {

ppp {vif 1 {

ip {ospf {

dead-interval: u32}

}}

}}

}

Parameters

wanx Mandatory. Multi-node. The identifier for the serial interface you are defining. This may be wan0 to wan23, depending on what serial interfaces that are actually available on the system.

1 The identifier of the virtual interface. Currently, only one vif is supported for PPP interfaces, and the identifier must be 1.

interval Specifies the time, in seconds, that this interface should wait to detect hello packets from neighboring routers before declaring the neighbor down. The range is 1 to 65535. The default is 4 times the hello interval.

Page 234: Vyatta - OSPF

Chapter 6: Serial PPP Interfaces Serial PPP Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

213

Default

The dead interval is 4 times the hello interval.

Usage Guidelines

Use this command to specify the interval during which the virtual interface of a PPP serial interface should expect a hello packet from its neighbor.

If the dead interval passes without the interface receiving a hello packet from the neighbor, the neighbor’s status is changed to out-of-service, and all associated state is cleared.

The dead interval must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not establish adjacencies and will disregard one another’s communications.

Use the set form of this command to specify the dead interval.

Use the delete form of this command to restore the default dead interval.

Use the show form of this command to display dead interval configuration.

Page 235: Vyatta - OSPF

Chapter 6: Serial PPP Interfaces Serial PPP Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

214

interfaces serial <wanx> ppp vif 1 ip ospf hello-interval <interval>

Sets the interval between OSPF hello packets on the virtual interface of a PPP serial interface.

Syntax

set interfaces serial wanx ppp vif 1 ip ospf hello-interval interval

delete interfaces serial wanx ppp vif 1 ip ospf hello-interval

show interfaces serial wanx ppp vif 1 ip ospf hello-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {serial wan0..wan23 {

ppp {vif 1 {

ip {ospf {

hello-interval: u32}

}}

}}

}

Parameters

wanx Mandatory. Multi-node. The identifier for the serial interface you are defining. This may be wan0 to wan23, depending on what serial interfaces that are actually available on the system.

1 The identifier of the virtual interface. Currently, only one vif is supported for PPP interfaces, and the identifier must be 1.

Page 236: Vyatta - OSPF

Chapter 6: Serial PPP Interfaces Serial PPP Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

215

Default

Hello packets are sent every 10 seconds.

Usage Guidelines

Use this command to set the interval at which OSPF hello packets are sent for the virtual interface of a PPP serial interface.

A hello packet is an OSPF packet used to detect and maintain relationships with neighbors on the same network (directly connected routers). The greater the interval between hello packets, the less router traffic occurs, but the longer it takes for topological changes to be detected.

The hello interval must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not establish adjacencies and will disregard one another’s communications.

Use the set form of this command to set the hello interval.

Use the delete form of this command to restore the default hello interval.

Use the show form of this command to display hello interval configuration.

interval Mandatory. The interval, in seconds, between hello packets. This value must be the same for all nodes on the network.The range is 1 to 65535. The default is 10.

Page 237: Vyatta - OSPF

Chapter 6: Serial PPP Interfaces Serial PPP Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

216

interfaces serial <wanx> ppp vif 1 ip ospf mtu-ignoreDisables MTU mismatch detection for the virtual interface of a PPP serial interface.

Syntax

set interfaces serial wanx ppp vif 1 ip ospf mtu-ignore

delete interfaces serial wanx ppp vif 1 ip ospf mtu-ignore

show interfaces serial wanx ppp vif 1 ip ospf

Command Mode

Configuration mode.

Configuration Statement

interfaces {serial wan0..wan23 {

ppp {vif 1 {

ip {ospf {

mtu-ignore}

}}

}}

}

Parameters

Default

MTU mismatch detection is enabled by default.

wanx Mandatory. Multi-node. The identifier for the serial interface you are defining. This may be wan0 to wan23, depending on what serial interfaces that are actually available on the system.

1 The identifier of the virtual interface. Currently, only one vif is supported for PPP interfaces, and the identifier must be 1.

Page 238: Vyatta - OSPF

Chapter 6: Serial PPP Interfaces Serial PPP Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

217

Usage Guidelines

Use this command to disable MTU mismatch detection on an OSPF interface.

OSPF sends the MTU of the interface in a database description packet. If the MTUs of OSPF neighbors do not match, they cannot form an OSPF adjacency. MTU mismatch detection detects MTU mismatches and indicates them in the form of a debug message.

MTU mismatch is an important troubleshooting feature. If MTU mismatch is not enabled, MTU mismatches can only be detected by examining configuration for both interfaces.

There are some network setups where MTU mismatches are unavoidable, and even part of the normal set-up. It is for these cases only that MTU mismatch detection should be disabled, so that normal OSPF adjacencies can be formed.

Use the set form of this command to disable MTU mismatch detection.

Use the delete form of this command to re-enable MTU mismatch detection.

Use the show form of this command to display OSPF configuration.

Page 239: Vyatta - OSPF

Chapter 6: Serial PPP Interfaces Serial PPP Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

218

interfaces serial <wanx> ppp vif 1 ip ospf network <type>

Specifies the OSPF network type for the virtual interface of a PPP serial interface.

Syntax

set interfaces serial wanx ppp vif 1 ip ospf network [broadcast | non-broadcast | point-to-multipoint | point-to-point]

delete interfaces serial wanx ppp vif 1 ip ospf network

show interfaces serial wanx ppp vif 1 ip ospf network

Command Mode

Configuration mode.

Configuration Statement

interfaces {serial wan0..wan23 {

ppp {vif 1 {

ip {ospf {

network: text}

}}

}}

}

Parameters

wanx Mandatory. Multi-node. The identifier for the serial interface you are defining. This may be wan0 to wan23, depending on what serial interfaces that are actually available on the system.

1 The identifier of the virtual interface. Currently, only one vif is supported for PPP interfaces, and the identifier must be 1.

Page 240: Vyatta - OSPF

Chapter 6: Serial PPP Interfaces Serial PPP Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

219

Default

Broadcast is supported.

Usage Guidelines

Use this command to configure and display the network type for the interface.

Use the set form of this command to specify the network type.

Use the delete form of this command to remove the network type.

Use the show form of this command to display the network type.

type The network type for this interface. Supported values are as follows:

broadcast: The interface supports broadcast mode, such as a LAN link.

non-broadcast: The interface does not support broadcast mode.

point-to-point: This interface supports point-to-point mode, such as an NBMA interface.

point-to-multipoint: This interface supports point-to-multipoint mode, such as a PPP interface or a point-to-point logical interface on Frame Relay.

The default is broadcast.

Page 241: Vyatta - OSPF

Chapter 6: Serial PPP Interfaces Serial PPP Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

220

interfaces serial <wanx> ppp vif 1 ip ospf priority <priority>

Sets the OSPF priority for the virtual interface of a PPP serial interface.

Syntax

set interfaces serial wanx ppp vif 1 ip ospf priority priority

delete interfaces serial wanx ppp vif 1 ip ospf priority

show interfaces serial wanx ppp vif 1 ip ospf priority

Command Mode

Configuration mode.

Configuration Statement

interfaces {serial wan0..wan23 {

ppp {vif 1 {

ip {ospf {

priority: u32}

}}

}}

}

Parameters

wanx Mandatory. Multi-node. The identifier for the serial interface you are defining. This may be wan0 to wan23, depending on what serial interfaces that are actually available on the system.

1 The identifier of the virtual interface. Currently, only one vif is supported for PPP interfaces, and the identifier must be 1.

priority Specifies the OSPF router priority for this interface. The range is 0 to 255, where a router with priority 0 can never become the designated router. The default is 1.

Page 242: Vyatta - OSPF

Chapter 6: Serial PPP Interfaces Serial PPP Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

221

Default

An OSPF interface has a priority of 1.

Usage Guidelines

Use this command to set the priority for the virtual interface of a PPP serial interface on the broadcast network to which the interface is connected. The priority determines which routers are selected as the area’s Designated Router (DR) and Backup Designated Router (BDR).

The DR and BDR are used to reduce the amount of traffic on OSPF overhead on broadcast networks, by reducing the number of adjacent routers to which a router must flood its topological information. In broadcast networks (such as Ethernet), each router establishes an adjacency with only the DR and the BDR, rather than with every router in its area. The DR and the BDR then flood this information to all other routers on the network segment.

Priority can range from 0 to 255. In general, the router with the highest priority is elected as the DR, and the router with the second-highest priority is elected as the BDR. The higher the number, the higher the priority.

Routers with a priority of 0 are ineligible for election.

Use the set form of this command to specify the OSPF priority.

Use the delete form of this command to restore the default priority.

Use the show form of this command to display priority configuration.

Page 243: Vyatta - OSPF

Chapter 6: Serial PPP Interfaces Serial PPP Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

222

interfaces serial <wanx> ppp vif 1 ip ospf retransmit-interval <interval>

Sets the OSPF retransmit interval for the virtual interface of a PPP serial interface.

Syntax

set interfaces serial wanx ppp vif 1 ip ospf retransmit-interval interval

delete interfaces serial wanx ppp vif 1 ip ospf retransmit-interval

show interfaces serial wanx ppp vif 1 ip ospf retransmit-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {serial wan0..wan23 {

ppp {vif 1 {

ip {ospf {

retransmit-interval: u32}

}}

}}

}

Parameters

wanx Mandatory. Multi-node. The identifier for the serial interface you are defining. This may be wan0 to wan23, depending on what serial interfaces that are actually available on the system.

1 The identifier of the virtual interface. Currently, only one vif is supported for PPP interfaces, and the identifier must be 1.

interval Specifies the time in seconds to wait for an acknowledgement, after which the system retransmits an LSA packet to its neighbors. The range is 3 to 65535. The default is 5.

Page 244: Vyatta - OSPF

Chapter 6: Serial PPP Interfaces Serial PPP Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

223

Default

Unacknowledged LSAs are retransmitted at 5-second intervals.

Usage Guidelines

Use this command to specify how long the virtual interface of a PPP serial interface will wait for an acknowledgment of a link-state update before resending the update.

The link-state update packet is part of the exchange of topology databases between routers. When the initial database description (DD) packet is sent, it contains only the headers of the LSAs. If the receiving router determines that it requires that piece of the OSPF topology, it sends a link state request packet to request the complete LSA from the sending router.

After the update packet is sent, the sending router waits for an acknowledgement, either implicit or explicit, from the receiving router. In an explicit acknowledgement, the receiving router sends a link-state acknowledge (LS-Ack) packet to the router that sent the update. In an implicit acknowledgement, the router that sent the update receives an LSA from the receiving router that contains the update information.

If the retransmit interval passes with neither an explicit nor an implicit acknowledgement, the sending router will retransmit the link-state update packet.

Too high an interval slows network convergence. Too small an interval causes unnecessary retransmission.

Use the set form of this command to set the OSPF retransmit interval for the virtual interface of a PPP serial interface.

Use the delete form of this command to restore the default retransmit interval.

Use the show form of this command to display retransmit interval configuration.

Page 245: Vyatta - OSPF

Chapter 6: Serial PPP Interfaces Serial PPP Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

224

interfaces serial <wanx> ppp vif 1 ip ospf transmit-delay <delay>

Specifies the OSPF transmit delay for the virtual interface of a PPP serial interface.

Syntax

set interfaces serial wanx ppp vif 1 ip ospf transmit-delay delay

delete interfaces serial wanx ppp vif 1 ip ospf transmit-delay

show interfaces serial wanx ppp vif 1 ip ospf transmit-delay

Command Mode

Configuration mode.

Configuration Statement

interfaces {serial wan0..wan23 {

ppp {vif 1 {

ip {ospf {

transmit-delay: u32}

}}

}}

}

Parameters

wanx Mandatory. Multi-node. The identifier for the serial interface you are defining. This may be wan0 to wan23, depending on what serial interfaces that are actually available on the system.

1 The identifier of the virtual interface. Currently, only one vif is supported for PPP interfaces, and the identifier must be 1.

delay Mandatory. The delay, in seconds, between link-state transmits. This value must be the same for all nodes on the network. The range is 1 to 65535. The default is 1.

Page 246: Vyatta - OSPF

Chapter 6: Serial PPP Interfaces Serial PPP Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

225

Default

Link-state transmits occur at 1-second intervals.

Usage Guidelines

Use this command to set the transmit delay for the virtual interface of a PPP serial interface. This is the estimated time required to send a link-state update (LSU) packet.

This timer is used to accommodate transmission and propagation delays on the network, particularly on low-speed networks where delays may be significant. The router increments the age of link-state advertisements in LSU packets to account for these delays.

The value includes both the transmission time and the propagation delay across the network. The transmit delay is added to the age of the LSA packet before the LSA is transmitted The LSA age is used to help the network sequence LSAs, so that it can determine which of competing LSAs is the more recent and trustworthy.

LSAs are numbered in sequence, but the sequence numbers are finite, and so cannot be used as the sole determinant of the most recent LSA. Instead, OSPF also tracks the age of LSAs. Each time the LSA is forwarded to another router, its current age is incremented by the transmit delay. The packet’s age, together with its sequence number, helps the receiving router to determine which version of a received LSA is more recent, and therefore to be used.

Use the set form of this command to set the transmit delay.

Use the delete form of this command to restore the default transmit delay.

Use the show form of this command to display transmit delay configuration.

Page 247: Vyatta - OSPF

226

Chapter 7: Serial Cisco HDLC Interfaces

This chapter describes commands for configuring OSPF on serial interfaces with Cisco HDLC encapsulation.

This chapter presents the following topics:

• Serial Cisco HDLC OSPF Commands

Page 248: Vyatta - OSPF

Chapter 7: Serial Cisco HDLC Interfaces Serial Cisco HDLC OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

227

Serial Cisco HDLC OSPF CommandsThis chapter contains the following commands.

Configuration Commands

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf Enables OSPF on the virtual interface of a Cisco HDLC serial interface.

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf authentication

Specifies the authentication method for OSPF on the virtual interface of a Cisco HDLC serial interface.

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf bandwidth <bandwidth>

Specifies the bandwidth on the virtual interface of a Cisco HDLC serial interface for calculating OSPF cost.

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf cost <cost>

Sets the routing cost for OSPF on the virtual interface of a Cisco HDLC serial interface.

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf dead-interval <interval>

Sets the OSPF dead interval for the virtual interface of a Cisco HDLC serial interface.

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf hello-interval <interval>

Sets the interval between OSPF hello packets on the virtual interface of a Cisco HDLC serial interface.

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf mtu-ignore

Disables MTU mismatch detection for the virtual interface of a Cisco HDLC serial interface.

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf network <type>

Specifies the OSPF network type for the virtual interface of a Cisco HDLC serial interface.

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf priority <priority>

Sets the OSPF priority for the virtual interface of a Cisco HDLC serial interface.

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf retransmit-interval <interval>

Sets the OSPF retransmit interval for the virtual interface of a Cisco HDLC serial interface.

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf transmit-delay <delay>

Specifies the OSPF transmit delay for the virtual interface of a Cisco HDLC serial interface.

Operational Commands

None.

Page 249: Vyatta - OSPF

Chapter 7: Serial Cisco HDLC Interfaces Serial Cisco HDLC OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

228

interfaces serial <wanx> cisco-hdlc vif 1 ip ospfEnables OSPF on the virtual interface of a Cisco HDLC serial interface.

Syntax

set interfaces serial wanx cisco-hdlc vif 1 ip ospf

delete interfaces serial wanx cisco-hdlc vif 1 ip ospf

show interfaces serial wanx cisco-hdlc vif 1

Command Mode

Configuration mode.

Configuration Statement

interfaces {serial wan0..wan23 {

cisco-hdlc {vif 1 {

ip ospf}

}}

}

Parameters

Default

OSPF is not enabled on Cisco HDLC interfaces.

wanx Mandatory. Multi-node. The identifier for the serial interface you are defining. This may be wan0 to wan23, depending on what serial interfaces that are actually available on the system.

1 The identifier of the virtual interface. Currently, only one vif is supported for Cisco HDLC interfaces, and the identifier must be 1.

Page 250: Vyatta - OSPF

Chapter 7: Serial Cisco HDLC Interfaces Serial Cisco HDLC OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

229

Usage Guidelines

Use this command to enable the Open Shortest Path First (OSPF) routing protocol on the virtual interface of a Cisco HDLC serial interface.

Use the set form of this command to enable OSPF on a Cisco HDLC virtual interface.

Use the delete form of this command to disable OSPF on a Cisco HDLC virtual interface.

Use the show form of this command to display Cisco HDLC virtual interface configuration.

Page 251: Vyatta - OSPF

Chapter 7: Serial Cisco HDLC Interfaces Serial Cisco HDLC OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

230

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf authentication

Specifies the authentication method for OSPF on the virtual interface of a Cisco HDLC serial interface.

Syntax

set interfaces serial wanx cisco-hdlc vif 1 ip ospf authentication [md5 key-id key-id md5-key md5-key | plaintext-password password]

delete interfaces serial wanx cisco-hdlc vif 1 ip ospf authentication [md5 key-id key-id md5-key | plaintext-password]

show interfaces serial wanx cisco-hdlc vif 1 ip ospf authentication [md5 key-id key-id md5-key | plaintext-password]

Command Mode

Configuration mode.

Configuration Statement

interfaces {serial wan0..wan23 {

cisco-hdlc {vif 1 {

ip {ospf {

authentication {md5 {

key-id 1-255 {md5-key: text

}}plaintext-password: text

}}

}}

}}

}

Page 252: Vyatta - OSPF

Chapter 7: Serial Cisco HDLC Interfaces Serial Cisco HDLC OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

231

Parameters

Default

None.

Usage Guidelines

Use this command to specify the authentication method to be used for OSPF on the virtual interface of a Cisco HDLC serial interface. This authentication is independent of the authentication configured for the OSPF area.

In plain text authentication, passwords are sent through the network in plain text. In MD5 authentication, the system uses the Message Digest 5 (MD5) algorithm to compute a hash value from the contents of the OSPF packet and the password. The hash value and the MD5 key are included in the transmitted packet, and the receiving system (configured with the same password) calculates its own hash function, which must match.

The authentication parameters must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not consider establish adjacencies, and will disregard one another’s communications.

Use the set form of this command to set the authentication for the virtual interface of a Cisco HDLC serial interface.

Use the delete form of this command to remove interface authentication configuration information.

wanx Mandatory. Multi-node. The identifier for the serial interface you are defining. This may be wan0 to wan23, depending on what serial interfaces that are actually available on the system.

1 The identifier of the virtual interface. Currently, only one vif is supported for Cisco HDLC interfaces, and the identifier must be 1.

key-id Optional. The key used to identify the MD5 key. This must be the same on both the sending and receiving systems. The range is 1 to 255.

md5-key Optional. A password-like MD5 key of up to 16 alphanumeric characters to be used as input to the MD5 hashing algorithm. The longer the key, the stronger the security. This must be the same on both the sending and receiving systems.

password Optional. The password to use in plain-text authentication. This must be eight characters or less and the same on both the sending and receiving systems.

Page 253: Vyatta - OSPF

Chapter 7: Serial Cisco HDLC Interfaces Serial Cisco HDLC OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

232

Use the show form of this command to display interface authentication configuration information.

Page 254: Vyatta - OSPF

Chapter 7: Serial Cisco HDLC Interfaces Serial Cisco HDLC OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

233

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf bandwidth <bandwidth>

Specifies the bandwidth on the virtual interface of a Cisco HDLC serial interface for calculating OSPF cost.

Syntax

set interfaces serial wanx cisco-hdlc vif 1 ip ospf bandwidth bandwidth

delete interfaces serial wanx cisco-hdlc vif 1 ip ospf bandwidth

show interfaces serial wanx cisco-hdlc vif 1 ip ospf bandwidth

Command Mode

Configuration mode.

Configuration Statement

interfaces {serial wan0..wan23 {

cisco-hdlc {vif 1 {

ip {ospf {

bandwidth: u32}

}}

}}

}

Parameters

wanx Mandatory. Multi-node. The identifier for the serial interface you are defining. This may be wan0 to wan23, depending on what serial interfaces that are actually available on the system.

1 The identifier of the virtual interface. Currently, only one vif is supported for Cisco HDLC interfaces, and the identifier must be 1.

bandwidth The bandwidth of the Ethernet interface in kilobits/sec. The range is 1 to 10000000.

Page 255: Vyatta - OSPF

Chapter 7: Serial Cisco HDLC Interfaces Serial Cisco HDLC OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

234

Default

None.

Usage Guidelines

Use this command to specify the bandwidth of the virtual interface of a Cisco HDLC serial interface for the purpose of computing OSPF cost.

Use the set form of this command to specify the bandwidth of the interface.

Use the delete form of this command to remove the bandwidth parameter.

Use the show form of this command to display the bandwidth configuration.

Page 256: Vyatta - OSPF

Chapter 7: Serial Cisco HDLC Interfaces Serial Cisco HDLC OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

235

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf cost <cost>

Sets the routing cost for OSPF on the virtual interface of a Cisco HDLC serial interface.

Syntax

set interfaces serial wanx cisco-hdlc vif 1 ip ospf cost cost

delete interfaces serial wanx cisco-hdlc vif 1 ip ospf cost

show interfaces serial wanx cisco-hdlc vif 1 ip ospf cost

Command Mode

Configuration mode.

Configuration Statement

interfaces {serial wan0..wan23 {

cisco-hdlc {vif 1 {

ip {ospf {

cost: u32}

}}

}}

}

Parameters

wanx Mandatory. Multi-node. The identifier for the serial interface you are defining. This may be wan0 to wan23, depending on what serial interfaces that are actually available on the system.

1 The identifier of the virtual interface. Currently, only one vif is supported for Cisco HDLC interfaces, and the identifier must be 1.

cost The link-state metric (OSPF cost) to be advertised in the link-state advertisement (LSA) as the cost of sending packets over the ethernet interface. The range is 1 to 65535.

Page 257: Vyatta - OSPF

Chapter 7: Serial Cisco HDLC Interfaces Serial Cisco HDLC OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

236

Default

For details on the default of OSPF cost, please see the Usage Guidelines.

Usage Guidelines

Use this command to manually override the default OSPF cost computed by the system for the virtual interface of a Cisco HDLC serial interface. You can only assign one cost per interface.

By default, the metric associated with a link is computed as follows:

Cost = 108 / bandwidth

The cost of reaching any destination is the sum of the costs of the individual hops. Costs are always rounded to the nearest integer. Costs lower than 1 are rounded up to 1.

Table 7-1 shows the OSPF costs for some common media types.

The values in Table 7-1 show how OSPF fails to distinguish between interfaces faster than 100 Mbps, for example, between Fast Ethernet (100 Mbps) and Gigabit Ethernet (1000 Mbps) interfaces. If you want to distinguish interfaces equal to or greater than 100 Mbps, you must manually configure the cost of the interface using this command.

Table 7-1 OSPF Costs for Common Media Types

Media Type OSPF Cost

56 Kbps 1785

64 Kbps 1562

128 Kbps 781

256 Kbps 390

512 Kbps 195

768 Kbps 130

T1 (1.544 Mbps) 64

E1 (2.048 Mbps) 48

4 Mbps Token Ring 6

10 Mbps Ethernet 10

16 Mbps Token Ring 6

T3 (44.736 Mbps 2

100+ Mbps 1

Page 258: Vyatta - OSPF

Chapter 7: Serial Cisco HDLC Interfaces Serial Cisco HDLC OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

237

Use the set form of this command to specify the OSPF cost for the interface.

Use the delete form of this command to restore the default cost.

Use the show form of this command to display cost configuration.

Page 259: Vyatta - OSPF

Chapter 7: Serial Cisco HDLC Interfaces Serial Cisco HDLC OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

238

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf dead-interval <interval>

Sets the OSPF dead interval for the virtual interface of a Cisco HDLC serial interface.

Syntax

set interfaces serial wanx cisco-hdlc vif 1 ip ospf dead-interval interval

delete interfaces serial wanx cisco-hdlc vif 1 ip ospf dead-interval

show interfaces serial wanx cisco-hdlc vif 1 ip ospf dead-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {serial wan0..wan23 {

cisco-hdlc {vif 1 {

ip {ospf {

dead-interval: u32}

}}

}}

}

Parameters

wanx Mandatory. Multi-node. The identifier for the serial interface you are defining. This may be wan0 to wan23, depending on what serial interfaces that are actually available on the system.

1 The identifier of the virtual interface. Currently, only one vif is supported for Cisco HDLC interfaces, and the identifier must be 1.

interval Specifies the time, in seconds, that this interface should wait to detect hello packets from neighboring routers before declaring the neighbor down. The range is 1 to 65535. The default is 4 times the hello interval.

Page 260: Vyatta - OSPF

Chapter 7: Serial Cisco HDLC Interfaces Serial Cisco HDLC OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

239

Default

The dead interval is 4 times the hello interval.

Usage Guidelines

Use this command to specify the interval during which the virtual interface of a Cisco HDLC serial interface should expect a hello packet from its neighbor.

If the dead interval passes without the interface receiving a hello packet from the neighbor, the neighbor’s status is changed to out-of-service, and all associated state is cleared.

The dead interval must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not establish adjacencies and will disregard one another’s communications.

Use the set form of this command to specify the dead interval.

Use the delete form of this command to restore the default dead interval.

Use the show form of this command to display dead interval configuration.

Page 261: Vyatta - OSPF

Chapter 7: Serial Cisco HDLC Interfaces Serial Cisco HDLC OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

240

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf hello-interval <interval>

Sets the interval between OSPF hello packets on the virtual interface of a Cisco HDLC serial interface.

Syntax

set interfaces serial wanx cisco-hdlc vif 1 ip ospf hello-interval interval

delete interfaces serial wanx cisco-hdlc vif 1 ip ospf hello-interval

show interfaces serial wanx cisco-hdlc vif 1 ip ospf hello-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {serial wan0..wan23 {

cisco-hdlc {vif 1 {

ip {ospf {

hello-interval: u32}

}}

}}

}

Parameters

wanx Mandatory. Multi-node. The identifier for the serial interface you are defining. This may be wan0 to wan23, depending on what serial interfaces that are actually available on the system.

1 The identifier of the virtual interface. Currently, only one vif is supported for Cisco HDLC interfaces, and the identifier must be 1.

Page 262: Vyatta - OSPF

Chapter 7: Serial Cisco HDLC Interfaces Serial Cisco HDLC OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

241

Default

Hello packets are sent every 10 seconds.

Usage Guidelines

Use this command to set the interval at which OSPF hello packets are sent for the virtual interface of a Cisco HDLC serial interface.

A hello packet is an OSPF packet used to detect and maintain relationships with neighbors on the same network (directly connected routers). The greater the interval between hello packets, the less router traffic occurs, but the longer it takes for topological changes to be detected.

The hello interval must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not establish adjacencies and will disregard one another’s communications.

Use the set form of this command to set the hello interval.

Use the delete form of this command to restore the default hello interval.

Use the show form of this command to display hello interval configuration.

interval Mandatory. The interval, in seconds, between hello packets. This value must be the same for all nodes on the network.The range is 1 to 65535. The default is 10.

Page 263: Vyatta - OSPF

Chapter 7: Serial Cisco HDLC Interfaces Serial Cisco HDLC OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

242

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf mtu-ignore

Disables MTU mismatch detection for the virtual interface of a Cisco HDLC serial interface.

Syntax

set interfaces serial wanx cisco-hdlc vif 1 ip ospf mtu-ignore

delete interfaces serial wanx cisco-hdlc vif 1 ip ospf mtu-ignore

show interfaces serial wanx cisco-hdlc vif 1 ip ospf

Command Mode

Configuration mode.

Configuration Statement

interfaces {serial wan0..wan23 {

cisco-hdlc {vif 1 {

ip {ospf {

mtu-ignore}

}}

}}

}

Parameters

wanx Mandatory. Multi-node. The identifier for the serial interface you are defining. This may be wan0 to wan23, depending on what serial interfaces that are actually available on the system.

1 The identifier of the virtual interface. Currently, only one vif is supported for Cisco HDLC interfaces, and the identifier must be 1.

Page 264: Vyatta - OSPF

Chapter 7: Serial Cisco HDLC Interfaces Serial Cisco HDLC OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

243

Default

MTU mismatch detection is enabled by default.

Usage Guidelines

Use this command to disable MTU mismatch detection on an OSPF interface.

OSPF sends the MTU of the interface in a database description packet. If the MTUs of OSPF neighbors do not match, they cannot form an OSPF adjacency. MTU mismatch detection detects MTU mismatches and indicates them in the form of a debug message.

MTU mismatch is an important troubleshooting feature. If MTU mismatch is not enabled, MTU mismatches can only be detected by examining configuration for both interfaces.

There are some network setups where MTU mismatches are unavoidable, and even part of the normal set-up. It is for these cases only that MTU mismatch detection should be disabled, so that normal OSPF adjacencies can be formed.

Use the set form of this command to disable MTU mismatch detection.

Use the delete form of this command to re-enable MTU mismatch detection.

Use the show form of this command to display OSPF configuration.

Page 265: Vyatta - OSPF

Chapter 7: Serial Cisco HDLC Interfaces Serial Cisco HDLC OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

244

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf network <type>

Specifies the OSPF network type for the virtual interface of a Cisco HDLC serial interface.

Syntax

set interfaces serial wanx cisco-hdlc vif 1 ip ospf network [broadcast | non-broadcast | point-to-multipoint | point-to-point]

delete interfaces serial wanx cisco-hdlc vif 1 ip ospf network

show interfaces serial wanx cisco-hdlc vif 1 ip ospf network

Command Mode

Configuration mode.

Configuration Statement

interfaces {serial wan0..wan23 {

cisco-hdlc {vif 1 {

ip {ospf {

network: text}

}}

}}

}

Parameters

wanx Mandatory. Multi-node. The identifier for the serial interface you are defining. This may be wan0 to wan23, depending on what serial interfaces that are actually available on the system.

1 The identifier of the virtual interface. Currently, only one vif is supported for Cisco HDLC interfaces, and the identifier must be 1.

Page 266: Vyatta - OSPF

Chapter 7: Serial Cisco HDLC Interfaces Serial Cisco HDLC OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

245

Default

Broadcast is supported.

Usage Guidelines

Use this command to configure and display the network type for the interface.

Use the set form of this command to specify the network type.

Use the delete form of this command to remove the network type.

Use the show form of this command to display the network type.

type The network type for this interface. Supported values are as follows:

broadcast: The interface supports broadcast mode, such as a LAN link.

non-broadcast: The interface does not support broadcast mode.

point-to-point: This interface supports point-to-point mode, such as an NBMA interface.

point-to-multipoint: This interface supports point-to-multipoint mode, such as a PPP interface or a point-to-point logical interface on Frame Relay.

The default is broadcast.

Page 267: Vyatta - OSPF

Chapter 7: Serial Cisco HDLC Interfaces Serial Cisco HDLC OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

246

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf priority <priority>

Sets the OSPF priority for the virtual interface of a Cisco HDLC serial interface.

Syntax

set interfaces serial wanx cisco-hdlc vif 1 ip ospf priority priority

delete interfaces serial wanx cisco-hdlc vif 1 ip ospf priority

show interfaces serial wanx cisco-hdlc vif 1 ip ospf priority

Command Mode

Configuration mode.

Configuration Statement

interfaces {serial wan0..wan23 {

cisco-hdlc {vif 1 {

ip {ospf {

priority: u32}

}}

}}

}

Parameters

wanx Mandatory. Multi-node. The identifier for the serial interface you are defining. This may be wan0 to wan23, depending on what serial interfaces that are actually available on the system.

1 The identifier of the virtual interface. Currently, only one vif is supported for Cisco HDLC interfaces, and the identifier must be 1.

priority Specifies the OSPF router priority for this interface. The range is 0 to 255, where a router with priority 0 can never become the designated router. The default is 1.

Page 268: Vyatta - OSPF

Chapter 7: Serial Cisco HDLC Interfaces Serial Cisco HDLC OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

247

Default

An OSPF interface has a priority of 1.

Usage Guidelines

Use this command to set the priority for the virtual interface of a Cisco HDLC serial interface on the broadcast network to which the interface is connected. The priority determines which routers are selected as the area’s Designated Router (DR) and Backup Designated Router (BDR).

The DR and BDR are used to reduce the amount of traffic on OSPF overhead on broadcast networks, by reducing the number of adjacent routers to which a router must flood its topological information. In broadcast networks (such as Ethernet), each router establishes an adjacency with only the DR and the BDR, rather than with every router in its area. The DR and the BDR then flood this information to all other routers on the network segment.

Priority can range from 0 to 255. In general, the router with the highest priority is elected as the DR, and the router with the second-highest priority is elected as the BDR. The higher the number, the higher the priority.

Routers with a priority of 0 are ineligible for election.

Use the set form of this command to specify the OSPF priority.

Use the delete form of this command to restore the default priority.

Use the show form of this command to display priority configuration.

Page 269: Vyatta - OSPF

Chapter 7: Serial Cisco HDLC Interfaces Serial Cisco HDLC OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

248

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf retransmit-interval <interval>

Sets the OSPF retransmit interval for the virtual interface of a Cisco HDLC serial interface.

Syntax

set interfaces serial wanx cisco-hdlc vif 1 ip ospf retransmit-interval interval

delete interfaces serial wanx cisco-hdlc vif 1 ip ospf retransmit-interval

show interfaces serial wanx cisco-hdlc vif 1 ip ospf retransmit-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {serial wan0..wan23 {

cisco-hdlc {vif 1 {

ip {ospf {

retransmit-interval: u32}

}}

}}

}

Parameters

wanx Mandatory. Multi-node. The identifier for the serial interface you are defining. This may be wan0 to wan23, depending on what serial interfaces that are actually available on the system.

1 The identifier of the virtual interface. Currently, only one vif is supported for Cisco HDLC interfaces, and the identifier must be 1.

interval Specifies the time in seconds to wait for an acknowledgement, after which the system retransmits an LSA packet to its neighbors. The range is 3 to 65535. The default is 5.

Page 270: Vyatta - OSPF

Chapter 7: Serial Cisco HDLC Interfaces Serial Cisco HDLC OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

249

Default

Unacknowledged LSAs are retransmitted at 5-second intervals.

Usage Guidelines

Use this command to specify how long the virtual interface of a Cisco HDLC serial interface will wait for an acknowledgment of a link-state update before resending the update.

The link-state update packet is part of the exchange of topology databases between routers. When the initial database description (DD) packet is sent, it contains only the headers of the LSAs. If the receiving router determines that it requires that piece of the OSPF topology, it sends a link state request packet to request the complete LSA from the sending router.

After the update packet is sent, the sending router waits for an acknowledgement, either implicit or explicit, from the receiving router. In an explicit acknowledgement, the receiving router sends a link-state acknowledge (LS-Ack) packet to the router that sent the update. In an implicit acknowledgement, the router that sent the update receives an LSA from the receiving router that contains the update information.

If the retransmit interval passes with neither an explicit nor an implicit acknowledgement, the sending router will retransmit the link-state update packet.

Too high an interval slows network convergence. Too small an interval causes unnecessary retransmission.

Use the set form of this command to set the OSPF retransmit interval for the virtual interface of a Cisco HDLC serial interface.

Use the delete form of this command to restore the default retransmit interval.

Use the show form of this command to display retransmit interval configuration.

Page 271: Vyatta - OSPF

Chapter 7: Serial Cisco HDLC Interfaces Serial Cisco HDLC OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

250

interfaces serial <wanx> cisco-hdlc vif 1 ip ospf transmit-delay <delay>

Specifies the OSPF transmit delay for the virtual interface of a Cisco HDLC serial interface.

Syntax

set interfaces serial wanx cisco-hdlc vif 1 ip ospf transmit-delay delay

delete interfaces serial wanx cisco-hdlc vif 1 ip ospf transmit-delay

show interfaces serial wanx cisco-hdlc vif 1 ip ospf transmit-delay

Command Mode

Configuration mode.

Configuration Statement

interfaces {serial wan0..wan23 {

cisco-hdlc {vif 1 {

ip {ospf {

transmit-delay: u32}

}}

}}

}

Parameters

wanx Mandatory. Multi-node. The identifier for the serial interface you are defining. This may be wan0 to wan23, depending on what serial interfaces that are actually available on the system.

1 The identifier of the virtual interface. Currently, only one vif is supported for Cisco HDLC interfaces, and the identifier must be 1.

Page 272: Vyatta - OSPF

Chapter 7: Serial Cisco HDLC Interfaces Serial Cisco HDLC OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

251

Default

Link-state transmits occur at 1-second intervals.

Usage Guidelines

Use this command to set the transmit delay for the virtual interface of a Cisco HDLC serial interface. This is the estimated time required to send a link-state update (LSU) packet.

This timer is used to accommodate transmission and propagation delays on the network, particularly on low-speed networks where delays may be significant. The router increments the age of link-state advertisements in LSU packets to account for these delays.

The value includes both the transmission time and the propagation delay across the network. The transmit delay is added to the age of the LSA packet before the LSA is transmitted The LSA age is used to help the network sequence LSAs, so that it can determine which of competing LSAs is the more recent and trustworthy.

LSAs are numbered in sequence, but the sequence numbers are finite, and so cannot be used as the sole determinant of the most recent LSA. Instead, OSPF also tracks the age of LSAs. Each time the LSA is forwarded to another router, its current age is incremented by the transmit delay. The packet’s age, together with its sequence number, helps the receiving router to determine which version of a received LSA is more recent, and therefore to be used.

Use the set form of this command to set the transmit delay.

Use the delete form of this command to restore the default transmit delay.

Use the show form of this command to display transmit delay configuration.

delay Mandatory. The delay, in seconds, between link-state transmits. This value must be the same for all nodes on the network. The range is 1 to 65535. The default is 1.

Page 273: Vyatta - OSPF

252

Chapter 8: Serial Frame Relay Interfaces

This chapter describes commands for configuring OSPF on serial interfaces with Frame Relay encapsulation.

This chapter presents the following topics:

• Frame Relay Interface OSPF Commands

Page 274: Vyatta - OSPF

Chapter 8: Serial Frame Relay Interfaces Frame Relay Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

253

Frame Relay Interface OSPF CommandsThis chapter contains the following commands.

Configuration Commands

interfaces serial <wanx> frame-relay vif <dlci> ip ospf Enables OSPF on the virtual interface of a Frame Relay serial interface.

interfaces serial <wanx> frame-relay vif <dlci> ip ospf authentication

Specifies the authentication method for OSPF on the virtual interface of a Frame Relay serial interface.

interfaces serial <wanx> frame-relay vif <dlci> ip ospf bandwidth <bandwidth>

Specifies the bandwidth on the virtual interface of a Frame Relay serial interface for calculating OSPF cost.

interfaces serial <wanx> frame-relay vif <dlci> ip ospf cost <cost>

Sets the routing cost for OSPF on the virtual interface of a Frame Relay serial interface.

interfaces serial <wanx> frame-relay vif <dlci> ip ospf dead-interval <interval>

Sets the OSPF dead interval for the virtual interface of a Frame Relay serial interface.

interfaces serial <wanx> frame-relay vif <dlci> ip ospf hello-interval <interval>

Sets the interval between OSPF hello packets on the virtual interface of a Frame Relay serial interface.

interfaces serial <wanx> frame-relay vif <dlci> ip ospf mtu-ignore

Disables MTU mismatch detection for the virtual interface of a Frame Relay serial interface.

interfaces serial <wanx> frame-relay vif <dlci> ip ospf network <type>

Specifies the OSPF network type for the virtual interface of a Frame Relay serial interface.

interfaces serial <wanx> frame-relay vif <dlci> ip ospf priority <priority>

Sets the OSPF priority for the virtual interface of a Frame Relay serial interface.

interfaces serial <wanx> frame-relay vif <dlci> ip ospf retransmit-interval <interval>

Sets the OSPF retransmit interval for the virtual interface of a Frame Relay serial interface.

interfaces serial <wanx> frame-relay vif <dlci> ip ospf transmit-delay <delay>

Specifies the OSPF transmit delay for the virtual interface of a Frame Relay serial interface.

Operational Commands

None.

Page 275: Vyatta - OSPF

Chapter 8: Serial Frame Relay Interfaces Frame Relay Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

254

interfaces serial <wanx> frame-relay vif <dlci> ip ospfEnables OSPF on the virtual interface of a Frame Relay serial interface.

Syntax

set interfaces serial wanx frame-relay vif dlci ip ospf

delete interfaces serial wanx frame-relay vif dlci ip ospf

show interfaces serial wanx frame-relay vif dlci

Command Mode

Configuration mode.

Configuration Statement

interfaces {serial wan0..wan23 {

frame-relay {vif 16-991 {

ip ospf}

}}

}

Parameters

Default

OSPF is not enabled on Frame Relay interfaces.

wanx Mandatory. Multi-node. The identifier for the serial interface you are defining. This may be wan0 to wan23, depending on what serial interfaces that are actually available on the system.

dlci The identifier of the virtual interface. For Frame Relay interfaces, this is the DLCI number for the interface. The range is 16 to 991.

Page 276: Vyatta - OSPF

Chapter 8: Serial Frame Relay Interfaces Frame Relay Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

255

Usage Guidelines

Use this command to enable the Open Shortest Path First (OSPF) routing protocol on a virtual interface of a Frame Relay serial interface.

Use the set form of this command to enable OSPF on a Frame Relay virtual interface.

Use the delete form of this command to disable OSPF on a Frame Relay virtual interface.

Use the show form of this command to display Frame Relay virtual interface configuration.

Page 277: Vyatta - OSPF

Chapter 8: Serial Frame Relay Interfaces Frame Relay Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

256

interfaces serial <wanx> frame-relay vif <dlci> ip ospf authentication

Specifies the authentication method for OSPF on the virtual interface of a Frame Relay serial interface.

Syntax

set interfaces serial wanx frame-relay vif dlci ip ospf authentication [md5 key-id key-id md5-key md5-key | plaintext-password password]

delete interfaces serial wanx frame-relay vif dlci ip ospf authentication [md5 key-id key-id md5-key | plaintext-password]

show interfaces serial wanx frame-relay vif dlci ip ospf authentication [md5 key-id key-id md5-key | plaintext-password]

Command Mode

Configuration mode.

Configuration Statement

interfaces {serial wan0..wan23 {

frame-relay {vif 16-991 {

ip {ospf {

authentication {md5 {

key-id 1-255 {md5-key: text

}}plaintext-password: text

}}

}}

}}

}

Page 278: Vyatta - OSPF

Chapter 8: Serial Frame Relay Interfaces Frame Relay Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

257

Parameters

Default

None.

Usage Guidelines

Use this command to specify the authentication method to be used for OSPF on the virtual interface of a Frame Relay serial interface. This authentication is independent of the authentication configured for the OSPF area.

In plain text authentication, passwords are sent through the network in plain text. In MD5 authentication, the system uses the Message Digest 5 (MD5) algorithm to compute a hash value from the contents of the OSPF packet and the password. The hash value and the MD5 key are included in the transmitted packet, and the receiving system (configured with the same password) calculates its own hash function, which must match.

The authentication parameters must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not consider establish adjacencies, and will disregard one another’s communications.

Use the set form of this command to set the authentication for the virtual interface of a Cisco HDLC serial interface.

Use the delete form of this command to remove interface authentication configuration information.

wanx Mandatory. Multi-node. The identifier for the serial interface you are defining. This may be wan0 to wan23, depending on what serial interfaces that are actually available on the system.

dlci The identifier of the virtual interface. For Frame Relay interfaces, this is the DLCI number for the interface. The range is 16 to 991.

key-id Optional. The key used to identify the MD5 key. This must be the same on both the sending and receiving systems. The range is 1 to 255.

md5-key Optional. A password-like MD5 key of up to 16 alphanumeric characters to be used as input to the MD5 hashing algorithm. The longer the key, the stronger the security. This must be the same on both the sending and receiving systems.

password Optional. The password to use in plain-text authentication. This must be eight characters or less and the same on both the sending and receiving systems.

Page 279: Vyatta - OSPF

Chapter 8: Serial Frame Relay Interfaces Frame Relay Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

258

Use the show form of this command to display interface authentication configuration information.

Page 280: Vyatta - OSPF

Chapter 8: Serial Frame Relay Interfaces Frame Relay Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

259

interfaces serial <wanx> frame-relay vif <dlci> ip ospf bandwidth <bandwidth>

Specifies the bandwidth on the virtual interface of a Frame Relay serial interface for calculating OSPF cost.

Syntax

set interfaces serial wanx frame-relay vif dlci ip ospf bandwidth bandwidth

delete interfaces serial wanx frame-relay vif dlci ip ospf bandwidth

show interfaces serial wanx frame-relay vif dlci ip ospf bandwidth

Command Mode

Configuration mode.

Configuration Statement

interfaces {serial wan0..wan23 {

frame-relay {vif 16-991 {

ip {ospf {

bandwidth: u32}

}}

}}

}

Parameters

wanx Mandatory. Multi-node. The identifier for the serial interface you are defining. This may be wan0 to wan23, depending on what serial interfaces that are actually available on the system.

dlci The identifier of the virtual interface. For Frame Relay interfaces, this is the DLCI number for the interface. The range is 16 to 991.

bandwidth The bandwidth of the Ethernet interface in kilobits/sec. The range is 1 to 10000000.

Page 281: Vyatta - OSPF

Chapter 8: Serial Frame Relay Interfaces Frame Relay Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

260

Default

None.

Usage Guidelines

Use this command to specify the bandwidth of the virtual interface of a Frame Relay serial interface for the purpose of computing OSPF cost.

Use the set form of this command to specify the bandwidth of the interface.

Use the delete form of this command to remove the bandwidth parameter.

Use the show form of this command to display the bandwidth configuration.

Page 282: Vyatta - OSPF

Chapter 8: Serial Frame Relay Interfaces Frame Relay Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

261

interfaces serial <wanx> frame-relay vif <dlci> ip ospf cost <cost>

Sets the routing cost for OSPF on the virtual interface of a Frame Relay serial interface.

Syntax

set interfaces serial wanx frame-relay vif dlci ip ospf cost cost

delete interfaces serial wanx frame-relay vif dlci ip ospf cost

show interfaces serial wanx frame-relay vif dlci ip ospf cost

Command Mode

Configuration mode.

Configuration Statement

interfaces {serial wan0..wan23 {

frame-relay {vif 16-991 {

ip {ospf {

cost: u32}

}}

}}

}

Parameters

wanx Mandatory. Multi-node. The identifier for the serial interface you are defining. This may be wan0 to wan23, depending on what serial interfaces that are actually available on the system.

dlci The identifier of the virtual interface. For Frame Relay interfaces, this is the DLCI number for the interface. The range is 16 to 991.

cost The link-state metric (OSPF cost) to be advertised in the link-state advertisement (LSA) as the cost of sending packets over the ethernet interface. The range is 1 to 65535.

Page 283: Vyatta - OSPF

Chapter 8: Serial Frame Relay Interfaces Frame Relay Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

262

Default

For details on the default of OSPF cost, please see the Usage Guidelines.

Usage Guidelines

Use this command to manually override the default OSPF cost computed by the system for the virtual interface of a Frame Relay serial interface. You can only assign one cost per interface.

By default, the metric associated with a link is computed as follows:

Cost = 108 / bandwidth

The cost of reaching any destination is the sum of the costs of the individual hops. Costs are always rounded to the nearest integer. Costs lower than 1 are rounded up to 1.

Table 8-1 shows the OSPF costs for some common media types.

The values in Table 8-1 show how OSPF fails to distinguish between interfaces faster than 100 Mbps, for example, between Fast Ethernet (100 Mbps) and Gigabit Ethernet (1000 Mbps) interfaces. If you want to distinguish interfaces equal to or greater than 100 Mbps, you must manually configure the cost of the interface using this command.

Table 8-1 OSPF Costs for Common Media Types

Media Type OSPF Cost

56 Kbps 1785

64 Kbps 1562

128 Kbps 781

256 Kbps 390

512 Kbps 195

768 Kbps 130

T1 (1.544 Mbps) 64

E1 (2.048 Mbps) 48

4 Mbps Token Ring 6

10 Mbps Ethernet 10

16 Mbps Token Ring 6

T3 (44.736 Mbps 2

100+ Mbps 1

Page 284: Vyatta - OSPF

Chapter 8: Serial Frame Relay Interfaces Frame Relay Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

263

Use the set form of this command to specify the OSPF cost for the interface.

Use the delete form of this command to restore the default cost.

Use the show form of this command to display cost configuration.

Page 285: Vyatta - OSPF

Chapter 8: Serial Frame Relay Interfaces Frame Relay Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

264

interfaces serial <wanx> frame-relay vif <dlci> ip ospf dead-interval <interval>

Sets the OSPF dead interval for the virtual interface of a Frame Relay serial interface.

Syntax

set interfaces serial wanx frame-relay vif dlci ip ospf dead-interval interval

delete interfaces serial wanx frame-relay vif dlci ip ospf dead-interval

show interfaces serial wanx frame-relay vif dlci ip ospf dead-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {serial wan0..wan23 {

frame-relay {vif 16-991 {

ip {ospf {

dead-interval: u32}

}}

}}

}

Parameters

wanx Mandatory. Multi-node. The identifier for the serial interface you are defining. This may be wan0 to wan23, depending on what serial interfaces that are actually available on the system.

dlci The identifier of the virtual interface. For Frame Relay interfaces, this is the DLCI number for the interface. The range is 16 to 991.

interval Specifies the time, in seconds, that this interface should wait to detect hello packets from neighboring routers before declaring the neighbor down. The range is 1 to 65535. The default is 4 times the hello interval.

Page 286: Vyatta - OSPF

Chapter 8: Serial Frame Relay Interfaces Frame Relay Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

265

Default

The dead interval is 4 times the hello interval.

Usage Guidelines

Use this command to specify the interval during which the virtual interface of a Frame Relay serial interface should expect a hello packet from its neighbor.

If the dead interval passes without the interface receiving a hello packet from the neighbor, the neighbor’s status is changed to out-of-service, and all associated state is cleared.

The dead interval must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not establish adjacencies and will disregard one another’s communications.

Use the set form of this command to specify the dead interval.

Use the delete form of this command to restore the default dead interval.

Use the show form of this command to display dead interval configuration.

Page 287: Vyatta - OSPF

Chapter 8: Serial Frame Relay Interfaces Frame Relay Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

266

interfaces serial <wanx> frame-relay vif <dlci> ip ospf hello-interval <interval>

Sets the interval between OSPF hello packets on the virtual interface of a Frame Relay serial interface.

Syntax

set interfaces serial wanx frame-relay vif dlci ip ospf hello-interval interval

delete interfaces serial wanx frame-relay vif dlci ip ospf hello-interval

show interfaces serial wanx frame-relay vif dlci ip ospf hello-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {serial wan0..wan23 {

frame-relay {vif 16-991 {

ip {ospf {

hello-interval: u32}

}}

}}

}

Parameters

wanx Mandatory. Multi-node. The identifier for the serial interface you are defining. This may be wan0 to wan23, depending on what serial interfaces that are actually available on the system.

dlci The identifier of the virtual interface. For Frame Relay interfaces, this is the DLCI number for the interface. The range is 16 to 991.

Page 288: Vyatta - OSPF

Chapter 8: Serial Frame Relay Interfaces Frame Relay Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

267

Default

Hello packets are sent every 10 seconds.

Usage Guidelines

Use this command to set the interval at which OSPF hello packets are sent for the virtual interface of a Frame Relay serial interface.

A hello packet is an OSPF packet used to detect and maintain relationships with neighbors on the same network (directly connected routers). The greater the interval between hello packets, the less router traffic occurs, but the longer it takes for topological changes to be detected.

The hello interval must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not establish adjacencies and will disregard one another’s communications.

Use the set form of this command to set the hello interval.

Use the delete form of this command to restore the default hello interval.

Use the show form of this command to display hello interval configuration.

interval Mandatory. The interval, in seconds, between hello packets. This value must be the same for all nodes on the network.The range is 1 to 65535. The default is 10.

Page 289: Vyatta - OSPF

Chapter 8: Serial Frame Relay Interfaces Frame Relay Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

268

interfaces serial <wanx> frame-relay vif <dlci> ip ospf mtu-ignore

Disables MTU mismatch detection for the virtual interface of a Frame Relay serial interface.

Syntax

set interfaces serial wanx frame-relay vif dlci ip ospf mtu-ignore

delete interfaces serial wanx frame-relay vif dlci ip ospf mtu-ignore

show interfaces serial wanx frame-relay vif dlci ip ospf

Command Mode

Configuration mode.

Configuration Statement

interfaces {serial wan0..wan23 {

frame-relay {vif 16-991 {

ip {ospf {

mtu-ignore}

}}

}}

}

Parameters

wanx Mandatory. Multi-node. The identifier for the serial interface you are defining. This may be wan0 to wan23, depending on what serial interfaces that are actually available on the system.

dlci The identifier of the virtual interface. For Frame Relay interfaces, this is the DLCI number for the interface. The range is 16 to 991.

Page 290: Vyatta - OSPF

Chapter 8: Serial Frame Relay Interfaces Frame Relay Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

269

Default

MTU mismatch detection is enabled by default.

Usage Guidelines

Use this command to disable MTU mismatch detection on an OSPF interface.

OSPF sends the MTU of the interface in a database description packet. If the MTUs of OSPF neighbors do not match, they cannot form an OSPF adjacency. MTU mismatch detection detects MTU mismatches and indicates them in the form of a debug message.

MTU mismatch is an important troubleshooting feature. If MTU mismatch is not enabled, MTU mismatches can only be detected by examining configuration for both interfaces.

There are some network setups where MTU mismatches are unavoidable, and even part of the normal set-up. It is for these cases only that MTU mismatch detection should be disabled, so that normal OSPF adjacencies can be formed.

Use the set form of this command to disable MTU mismatch detection.

Use the delete form of this command to re-enable MTU mismatch detection.

Use the show form of this command to display OSPF configuration.

Page 291: Vyatta - OSPF

Chapter 8: Serial Frame Relay Interfaces Frame Relay Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

270

interfaces serial <wanx> frame-relay vif <dlci> ip ospf network <type>

Specifies the OSPF network type for the virtual interface of a Frame Relay serial interface.

Syntax

set interfaces serial wanx frame-relay vif dlci ip ospf network [broadcast | non-broadcast | point-to-multipoint | point-to-point]

delete interfaces serial wanx frame-relay vif dlci ip ospf network

show interfaces serial wanx frame-relay vif dlci ip ospf network

Command Mode

Configuration mode.

Configuration Statement

interfaces {serial wan0..wan23 {

frame-relay {vif 16-991 {

ip {ospf {

network: text}

}}

}}

}

Parameters

wanx Mandatory. Multi-node. The identifier for the serial interface you are defining. This may be wan0 to wan23, depending on what serial interfaces that are actually available on the system.

dlci The identifier of the virtual interface. For Frame Relay interfaces, this is the DLCI number for the interface. The range is 16 to 991.

Page 292: Vyatta - OSPF

Chapter 8: Serial Frame Relay Interfaces Frame Relay Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

271

Default

Broadcast is supported.

Usage Guidelines

Use this command to configure and display the network type for the interface.

Use the set form of this command to specify the network type.

Use the delete form of this command to remove the network type.

Use the show form of this command to display the network type.

type The network type for this interface. Supported values are as follows:

broadcast: The interface supports broadcast mode, such as a LAN link.

non-broadcast: The interface does not support broadcast mode.

point-to-point: This interface supports point-to-point mode, such as an NBMA interface.

point-to-multipoint: This interface supports point-to-multipoint mode, such as a PPP interface or a point-to-point logical interface on Frame Relay.

The default is broadcast.

Page 293: Vyatta - OSPF

Chapter 8: Serial Frame Relay Interfaces Frame Relay Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

272

interfaces serial <wanx> frame-relay vif <dlci> ip ospf priority <priority>

Sets the OSPF priority for the virtual interface of a Frame Relay serial interface.

Syntax

set interfaces serial wanx frame-relay vif dlci ip ospf priority priority

delete interfaces serial wanx frame-relay vif dlci ip ospf priority

show interfaces serial wanx frame-relay vif dlci ip ospf priority

Command Mode

Configuration mode.

Configuration Statement

interfaces {serial wan0..wan23 {

frame-relay {vif 16-991 {

ip {ospf {

priority: u32}

}}

}}

}

Parameters

wanx Mandatory. Multi-node. The identifier for the serial interface you are defining. This may be wan0 to wan23, depending on what serial interfaces that are actually available on the system.

dlci The identifier of the virtual interface. For Frame Relay interfaces, this is the DLCI number for the interface. The range is 16 to 991.

priority Specifies the OSPF router priority for this interface. The range is 0 to 255, where a router with priority 0 can never become the designated router. The default is 1.

Page 294: Vyatta - OSPF

Chapter 8: Serial Frame Relay Interfaces Frame Relay Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

273

Default

An OSPF interface has a priority of 1.

Usage Guidelines

Use this command to set the priority for the virtual interface of a Frame Relay serial interface on the broadcast network to which the interface is connected. The priority determines which routers are selected as the area’s Designated Router (DR) and Backup Designated Router (BDR).

The DR and BDR are used to reduce the amount of traffic on OSPF overhead on broadcast networks, by reducing the number of adjacent routers to which a router must flood its topological information. In broadcast networks (such as Ethernet), each router establishes an adjacency with only the DR and the BDR, rather than with every router in its area. The DR and the BDR then flood this information to all other routers on the network segment.

Priority can range from 0 to 255. In general, the router with the highest priority is elected as the DR, and the router with the second-highest priority is elected as the BDR. The higher the number, the higher the priority.

Routers with a priority of 0 are ineligible for election.

Use the set form of this command to specify the OSPF priority.

Use the delete form of this command to restore the default priority.

Use the show form of this command to display priority configuration.

Page 295: Vyatta - OSPF

Chapter 8: Serial Frame Relay Interfaces Frame Relay Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

274

interfaces serial <wanx> frame-relay vif <dlci> ip ospf retransmit-interval <interval>

Sets the OSPF retransmit interval for the virtual interface of a Frame Relay serial interface.

Syntax

set interfaces serial wanx frame-relay vif dlci ip ospf retransmit-interval interval

delete interfaces serial wanx frame-relay vif dlci ip ospf retransmit-interval

show interfaces serial wanx frame-relay vif dlci ip ospf retransmit-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {serial wan0..wan23 {

frame-relay {vif 16-991 {

ip {ospf {

retransmit-interval: u32}

}}

}}

}

Parameters

wanx Mandatory. Multi-node. The identifier for the serial interface you are defining. This may be wan0 to wan23, depending on what serial interfaces that are actually available on the system.

dlci The identifier of the virtual interface. For Frame Relay interfaces, this is the DLCI number for the interface. The range is 16 to 991.

interval Specifies the time in seconds to wait for an acknowledgement, after which the system retransmits an LSA packet to its neighbors. The range is 3 to 65535. The default is 5.

Page 296: Vyatta - OSPF

Chapter 8: Serial Frame Relay Interfaces Frame Relay Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

275

Default

Unacknowledged LSAs are retransmitted at 5-second intervals.

Usage Guidelines

Use this command to specify how long the virtual interface of a Frame Relay serial interface will wait for an acknowledgment of a link-state update before resending the update.

The link-state update packet is part of the exchange of topology databases between routers. When the initial database description (DD) packet is sent, it contains only the headers of the LSAs. If the receiving router determines that it requires that piece of the OSPF topology, it sends a link state request packet to request the complete LSA from the sending router.

After the update packet is sent, the sending router waits for an acknowledgement, either implicit or explicit, from the receiving router. In an explicit acknowledgement, the receiving router sends a link-state acknowledge (LS-Ack) packet to the router that sent the update. In an implicit acknowledgement, the router that sent the update receives an LSA from the receiving router that contains the update information.

If the retransmit interval passes with neither an explicit nor an implicit acknowledgement, the sending router will retransmit the link-state update packet.

Too high an interval slows network convergence. Too small an interval causes unnecessary retransmission.

Use the set form of this command to set the OSPF retransmit interval for the virtual interface of a Frame Relay serial interface.

Use the delete form of this command to restore the default retransmit interval.

Use the show form of this command to display retransmit interval configuration.

Page 297: Vyatta - OSPF

Chapter 8: Serial Frame Relay Interfaces Frame Relay Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

276

interfaces serial <wanx> frame-relay vif <dlci> ip ospf transmit-delay <delay>

Specifies the OSPF transmit delay for the virtual interface of a Frame Relay serial interface.

Syntax

set interfaces serial wanx frame-relay vif dlci ip ospf transmit-delay delay

delete interfaces serial wanx frame-relay vif dlci ip ospf transmit-delay

show interfaces serial wanx frame-relay vif dlci ip ospf transmit-delay

Command Mode

Configuration mode.

Configuration Statement

interfaces {serial wan0..wan23 {

frame-relay {vif 16-991 {

ip {ospf {

transmit-delay: u32}

}}

}}

}

Parameters

wanx Mandatory. Multi-node. The identifier for the serial interface you are defining. This may be wan0 to wan23, depending on what serial interfaces that are actually available on the system.

dlci The identifier of the virtual interface. For Frame Relay interfaces, this is the DLCI number for the interface. The range is 16 to 991.

delay Mandatory. The delay, in seconds, between link-state transmits. This value must be the same for all nodes on the network. The range is 1 to 65535. The default is 1.

Page 298: Vyatta - OSPF

Chapter 8: Serial Frame Relay Interfaces Frame Relay Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

277

Default

Link-state transmits occur at 1-second intervals.

Usage Guidelines

Use this command to set the transmit delay for the virtual interface of a Frame Relay serial interface. This is the estimated time required to send a link-state update (LSU) packet.

This timer is used to accommodate transmission and propagation delays on the network, particularly on low-speed networks where delays may be significant. The router increments the age of link-state advertisements in LSU packets to account for these delays.

The value includes both the transmission time and the propagation delay across the network. The transmit delay is added to the age of the LSA packet before the LSA is transmitted The LSA age is used to help the network sequence LSAs, so that it can determine which of competing LSAs is the more recent and trustworthy.

LSAs are numbered in sequence, but the sequence numbers are finite, and so cannot be used as the sole determinant of the most recent LSA. Instead, OSPF also tracks the age of LSAs. Each time the LSA is forwarded to another router, its current age is incremented by the transmit delay. The packet’s age, together with its sequence number, helps the receiving router to determine which version of a received LSA is more recent, and therefore to be used.

Use the set form of this command to set the transmit delay.

Use the delete form of this command to restore the default transmit delay.

Use the show form of this command to display transmit delay configuration.

Page 299: Vyatta - OSPF

278

Chapter 9: DSL Classical IPOA Interfaces

This chapter describes commands for configuring OSPF on DSL interfaces with Classical Internet Protocol over Asynchronous Transfer Mode (Classical IPOA) encapsulation.

This chapter presents the following topics:

• DSL Classical IPOA Interface OSPF Commands

Page 300: Vyatta - OSPF

Chapter 9: DSL Classical IPOA Interfaces DSL Classical IPOA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

279

DSL Classical IPOA Interface OSPF CommandsThis chapter contains the following commands.

Configuration Commands

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf

Enables OSPF on an ADSL PVC with Classical IPOA encapsulation.

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf authentication

Specifies the authentication method for OSPF on an ADSL PVC with Classical IPOA encapsulation.

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf bandwidth <bandwidth>

Specifies the bandwidth of an ADSL PVC with Classical IPOA encapsulation for calculating OSPF cost.

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf cost <cost>

Sets the routing cost for OSPF on an ADSL PVC with Classical IPOA encapsulation.

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf dead-interval <interval>

Sets the OSPF dead interval for an ADSL PVC with Classical IPOA encapsulation.

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf hello-interval <interval>

Sets the interval between OSPF hello packets on an ADSL PVC with Classical IPOA encapsulation.

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf mtu-ignore

Disables MTU mismatch detection for an ADSL PVC with Classical IPOA encapsulation.

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf network <type>

Specifies the OSPF network type for an ADSL PVC with Classical IPOA encapsulation.

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf priority <priority>

Sets the OSPF priority for an ADSL PVC with Classical IPOA encapsulation.

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf retransmit-interval <interval>

Sets the OSPF retransmit interval for an ADSL PVC with Classical IPOA encapsulation.

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf transmit-delay <delay>

Specifies the OSPF transmit delay for an ADSL PVC with Classical IPOA encapsulation.

Operational Commands

None

Page 301: Vyatta - OSPF

Chapter 9: DSL Classical IPOA Interfaces DSL Classical IPOA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

280

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf

Enables OSPF on an ADSL PVC with Classical IPOA encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id classical-ipoa ip ospf

delete interfaces adsl adslx pvc pvc-id classical-ipoa ip ospf

show interfaces adsl adslx pvc pvc-id classical-ipoa ip ospf

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {classical-ipoa {

ip {ospf {}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 302: Vyatta - OSPF

Chapter 9: DSL Classical IPOA Interfaces DSL Classical IPOA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

281

Default

None.

Usage Guidelines

Use this command to enable the Open Shortest Path First (OSPF) routing protocol on a PVC with Classical IP over Asynchronous Transfer ModeClassical IP over Asynchronous Transfer Mode (IPOA) encapsulation on an ADSL interface.

Use the set form of this command to enable OSPF on an interface.

Use the delete form of this command to remove all OSPF configuration and disable OSPF on an interface.

Use the show form of this command to display OSPF configuration.

Page 303: Vyatta - OSPF

Chapter 9: DSL Classical IPOA Interfaces DSL Classical IPOA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

282

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf authentication

Specifies the authentication method for OSPF on an ADSL PVC with Classical IPOA encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id classical-ipoa ip ospf authentication [md5 key-id key-id md5-key md5-key | plaintext-password password]

delete interfaces adsl adslx pvc pvc-id classical-ipoa ip ospf authentication [md5 key-id key-id md5-key | plaintext-password]

show interfaces adsl adslx pvc pvc-id classical-ipoa ip ospf authentication [md5 key-id key-id md5-key | plaintext-password]

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {classical-ipoa {

ip {ospf {

authentication {md5 {

key-id 1-255 {md5-key: text

}}plaintext-password: text

}}

}}

}}

}

Page 304: Vyatta - OSPF

Chapter 9: DSL Classical IPOA Interfaces DSL Classical IPOA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

283

Parameters

Default

None.

Usage Guidelines

Use this command to specify the authentication method to be used for OSPF on a PVC with Classical IP over Asynchronous Transfer Mode (IPOA) encapsulation on an ADSL interface. This authentication is independent of the authentication configured for the OSPF area.

In plain text authentication, passwords are sent through the network in plain text. In MD5 authentication, the system uses the Message Digest 5 (MD5) algorithm to compute a hash value from the contents of the OSPF packet and the password. The hash value and the MD5 key are included in the transmitted packet, and the receiving system (configured with the same password) calculates its own hash function, which must match.

The authentication parameters must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not consider establish adjacencies, and will disregard one another’s communications.

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

key-id Optional. The key used to identify the MD5 key. This must be the same on both the sending and receiving systems. The range is 1 to 255.

md5-key Optional. A password-like MD5 key of up to 16 alphanumeric characters to be used as input to the MD5 hashing algorithm. The longer the key, the stronger the security. This must be the same on both the sending and receiving systems.

password Optional. The password to use in plain-text authentication. This must be eight characters or less and the same on both the sending and receiving systems.

Page 305: Vyatta - OSPF

Chapter 9: DSL Classical IPOA Interfaces DSL Classical IPOA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

284

Use the set form of this command to set the authentication for a PVC with Classical IPOA encapsulation on an ADSL interface.

Use the delete form of this command to remove authentication configuration information.

Use the show form of this command to display authentication configuration information.

Page 306: Vyatta - OSPF

Chapter 9: DSL Classical IPOA Interfaces DSL Classical IPOA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

285

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf bandwidth <bandwidth>

Specifies the bandwidth of an ADSL PVC with Classical IPOA encapsulation for calculating OSPF cost.

Syntax

set interfaces adsl adslx pvc pvc-id classical-ipoa ip ospf bandwidth bandwidth

delete interfaces adsl adslx pvc pvc-id classical-ipoa ip ospf bandwidth

show interfaces adsl adslx pvc pvc-id classical-ipoa ip ospf bandwidth

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {classical-ipoa {

ip {ospf {

bandwidth: u32}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 307: Vyatta - OSPF

Chapter 9: DSL Classical IPOA Interfaces DSL Classical IPOA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

286

Default

None.

Usage Guidelines

Use this command to specify the bandwidth of a PVC with Classical IP over Asynchronous Transfer Mode (IPOA) encapsulation on an ADSL interface for the purpose of computing OSPF cost.

Use the set form of this command to specify the bandwidth of the interface.

Use the delete form of this command to remove the bandwidth parameter.

Use the show form of this command to display the bandwidth configuration.

bandwidth The bandwidth of the Ethernet interface in kilobits/sec. The range is 1 to 10000000.

Page 308: Vyatta - OSPF

Chapter 9: DSL Classical IPOA Interfaces DSL Classical IPOA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

287

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf cost <cost>

Sets the routing cost for OSPF on an ADSL PVC with Classical IPOA encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id classical-ipoa ip ospf cost cost

delete interfaces adsl adslx pvc pvc-id classical-ipoa ip ospf cost

show interfaces adsl adslx pvc pvc-id classical-ipoa ip ospf cost

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {classical-ipoa {

ip {ospf {

cost: u32}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 309: Vyatta - OSPF

Chapter 9: DSL Classical IPOA Interfaces DSL Classical IPOA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

288

Default

For details on the default of OSPF cost, please see the Usage Guidelines.

Usage Guidelines

Use this command to manually override the default OSPF cost computed by the system for a PVC with Classical IP over Asynchronous Transfer Mode (IPOA) encapsulation on an ADSL interface. You can only assign one cost per interface.

By default, the metric associated with a link is computed as follows:

Cost = 108 / bandwidth

The cost of reaching any destination is the sum of the costs of the individual hops. Costs are always rounded to the nearest integer. Costs lower than 1 are rounded up to 1.

Table 9-1 shows the OSPF costs for some common media types.

cost The link-state metric (OSPF cost) to be advertised in the link-state advertisement (LSA) as the cost of sending packets over the ethernet interface. The range is 1 to 65535.

Table 9-1 OSPF Costs for Common Media Types

Media Type OSPF Cost

56 Kbps 1785

64 Kbps 1562

128 Kbps 781

256 Kbps 390

512 Kbps 195

768 Kbps 130

T1 (1.544 Mbps) 64

E1 (2.048 Mbps) 48

4 Mbps Token Ring 6

10 Mbps Ethernet 10

16 Mbps Token Ring 6

T3 (44.736 Mbps 2

100+ Mbps 1

Page 310: Vyatta - OSPF

Chapter 9: DSL Classical IPOA Interfaces DSL Classical IPOA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

289

The values in Table 9-1 show how OSPF fails to distinguish between interfaces faster than 100 Mbps, for example, between Fast Ethernet (100 Mbps) and Gigabit Ethernet (1000 Mbps) interfaces. If you want to distinguish interfaces equal to or greater than 100 Mbps, you must manually configure the cost of the interface using this command.

Use the set form of this command to specify the OSPF cost for the interface.

Use the delete form of this command to restore the default cost.

Use the show form of this command to display cost configuration.

Page 311: Vyatta - OSPF

Chapter 9: DSL Classical IPOA Interfaces DSL Classical IPOA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

290

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf dead-interval <interval>

Sets the OSPF dead interval for an ADSL PVC with Classical IPOA encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id classical-ipoa ip ospf dead-interval interval

delete interfaces adsl adslx pvc pvc-id classical-ipoa ip ospf dead-interval

show interfaces adsl adslx pvc pvc-id classical-ipoa ip ospf dead-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {classical-ipoa {

ip {ospf {

dead-interval: u32}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 312: Vyatta - OSPF

Chapter 9: DSL Classical IPOA Interfaces DSL Classical IPOA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

291

Default

The dead interval is 4 times the hello interval.

Usage Guidelines

Use this command to specify the interval during which a PVC with Classical IP over Asynchronous Transfer Mode (IPOA) encapsulation on an ADSL interface should expect a hello packet from its neighbor.

If the dead interval passes without the interface receiving a hello packet from the neighbor, the neighbor’s status is changed to out-of-service, and all associated state is cleared.

The dead interval must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not establish adjacencies and will disregard one another’s communications.

Use the set form of this command to specify the dead interval.

Use the delete form of this command to restore the default dead interval.

Use the show form of this command to display dead interval configuration.

interval Specifies the time, in seconds, that this interface should wait to detect hello packets from neighboring routers before declaring the neighbor down. The range is 1 to 65535. The default is 4 times the hello interval.

Page 313: Vyatta - OSPF

Chapter 9: DSL Classical IPOA Interfaces DSL Classical IPOA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

292

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf hello-interval <interval>

Sets the interval between OSPF hello packets on an ADSL PVC with Classical IPOA encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id classical-ipoa ip ospf hello-interval interval

delete interfaces adsl adslx pvc pvc-id classical-ipoa ip ospf hello-interval

show interfaces adsl adslx pvc pvc-id classical-ipoa ip ospf hello-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {classical-ipoa {

ip {ospf {

hello-interval: u32}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 314: Vyatta - OSPF

Chapter 9: DSL Classical IPOA Interfaces DSL Classical IPOA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

293

Default

Hello packets are sent every 10 seconds.

Usage Guidelines

Use this command to set the interval at which OSPF hello packets are sent for a PVC with Classical IP over Asynchronous Transfer Mode (IPOA) encapsulation on an ADSL interface.

A hello packet is an OSPF packet used to detect and maintain relationships with neighbors on the same network (directly connected routers). The greater the interval between hello packets, the less router traffic occurs, but the longer it takes for topological changes to be

detected.

The hello interval must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not establish adjacencies and will disregard one another’s communications.

Use the set form of this command to set the hello interval.

Use the delete form of this command to restore the default hello interval.

Use the show form of this command to display hello interval configuration.

interval Mandatory. The interval, in seconds, between hello packets. This value must be the same for all nodes on the network.The range is 1 to 65535. The default is 10.

Page 315: Vyatta - OSPF

Chapter 9: DSL Classical IPOA Interfaces DSL Classical IPOA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

294

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf mtu-ignore

Disables MTU mismatch detection for an ADSL PVC with Classical IPOA encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id classical-ipoa ip ospf mtu-ignore

delete interfaces adsl adslx pvc pvc-id classical-ipoa ip ospf mtu-ignore

show interfaces adsl adslx pvc pvc-id classical-ipoa ip ospf

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {classical-ipoa {

ip {ospf {

mtu-ignore}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 316: Vyatta - OSPF

Chapter 9: DSL Classical IPOA Interfaces DSL Classical IPOA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

295

Default

MTU mismatch detection is enabled by default.

Usage Guidelines

Use this command to disable MTU mismatch detection on an OSPF interface.

OSPF sends the MTU of the interface in a database description packet. If the MTUs of OSPF neighbors do not match, they cannot form an OSPF adjacency. MTU mismatch detection detects MTU mismatches and indicates them in the form of a debug message.

MTU mismatch is an important troubleshooting feature. If MTU mismatch is not enabled, MTU mismatches can only be detected by examining configuration for both interfaces.

There are some network setups where MTU mismatches are unavoidable, and even part of the normal set-up. It is for these cases only that MTU mismatch detection should be disabled, so that normal OSPF adjacencies can be formed.

Use the set form of this command to disable MTU mismatch detection.

Use the delete form of this command to re-enable MTU mismatch detection.

Use the show form of this command to display OSPF configuration.

Page 317: Vyatta - OSPF

Chapter 9: DSL Classical IPOA Interfaces DSL Classical IPOA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

296

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf network <type>

Specifies the OSPF network type for an ADSL PVC with Classical IPOA encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id classical-ipoa ip ospf network [broadcast | non-broadcast | point-to-multipoint | point-to-point]

delete interfaces adsl adslx pvc pvc-id classical-ipoa ip ospf network

show interfaces adsl adslx pvc pvc-id classical-ipoa ip ospf network

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {classical-ipoa {

ip {ospf {

network: text}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 318: Vyatta - OSPF

Chapter 9: DSL Classical IPOA Interfaces DSL Classical IPOA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

297

Default

Broadcast is supported.

Usage Guidelines

Use this command to configure and display the network type for the interface.

Use the set form of this command to specify the network type.

Use the delete form of this command to remove the network type.

Use the show form of this command to display the network type.

type The network type for this interface. Supported values are as follows:

broadcast: The interface supports broadcast mode, such as a LAN link.

non-broadcast: The interface does not support broadcast mode.

point-to-point: This interface supports point-to-point mode, such as an NBMA interface.

point-to-multipoint: This interface supports point-to-multipoint mode, such as a PPP interface or a point-to-point logical interface on Frame Relay.

The default is broadcast.

Page 319: Vyatta - OSPF

Chapter 9: DSL Classical IPOA Interfaces DSL Classical IPOA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

298

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf priority <priority>

Sets the OSPF priority for an ADSL PVC with Classical IPOA encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id classical-ipoa ip ospf priority priority

delete interfaces adsl adslx pvc pvc-id classical-ipoa ip ospf priority

show interfaces adsl adslx pvc pvc-id classical-ipoa ip ospf priority

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {classical-ipoa {

ip {ospf {

priority: u32}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 320: Vyatta - OSPF

Chapter 9: DSL Classical IPOA Interfaces DSL Classical IPOA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

299

Default

An OSPF interface has a priority of 1.

Usage Guidelines

Use this command to set the priority for a PVC with Classical IP over Asynchronous Transfer Mode (IPOA) encapsulation on an ADSL interface on the broadcast network to which the interface is connected. The priority determines which routers are selected as the area’s Designated Router (DR) and Backup Designated Router (BDR).

The DR and BDR are used to reduce the amount of traffic on OSPF overhead on broadcast networks, by reducing the number of adjacent routers to which a router must flood its topological information. In broadcast networks (such as Ethernet), each router establishes an adjacency with only the DR and the BDR, rather than with every router in its area. The DR and the BDR then flood this information to all other routers on the network segment.

Priority can range from 0 to 255. In general, the router with the highest priority is elected as the DR, and the router with the second-highest priority is elected as the BDR. The higher the number, the higher the priority.

Routers with a priority of 0 are ineligible for election.

Use the set form of this command to specify the OSPF priority.

Use the delete form of this command to restore the default priority.

Use the show form of this command to display priority configuration.

priority Specifies the OSPF router priority for this interface. The range is 0 to 255, where a router with priority 0 can never become the designated router. The default is 1.

Page 321: Vyatta - OSPF

Chapter 9: DSL Classical IPOA Interfaces DSL Classical IPOA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

300

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf retransmit-interval <interval>

Sets the OSPF retransmit interval for an ADSL PVC with Classical IPOA encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id classical-ipoa ip ospf retransmit-interval interval

delete interfaces adsl adslx pvc pvc-id classical-ipoa ip ospf retransmit-interval

show interfaces adsl adslx pvc pvc-id classical-ipoa ip ospf retransmit-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {classical-ipoa {

ip {ospf {

retransmit-interval: u32}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 322: Vyatta - OSPF

Chapter 9: DSL Classical IPOA Interfaces DSL Classical IPOA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

301

Default

Unacknowledged LSAs are retransmitted at 5-second intervals.

Usage Guidelines

Use this command to specify how long a PVC with Classical IP over Asynchronous Transfer Mode (IPOA) encapsulation on an ADSL interface will wait for an acknowledgment of a link-state update before resending the update.

The link-state update packet is part of the exchange of topology databases between routers. When the initial database description (DD) packet is sent, it contains only the headers of the LSAs. If the receiving router determines that it requires that piece of the OSPF topology, it sends a link state request packet to request the complete LSA from the sending router.

After the update packet is sent, the sending router waits for an acknowledgement, either implicit or explicit, from the receiving router. In an explicit acknowledgement, the receiving router sends a link-state acknowledge (LS-Ack) packet to the router that sent the update. In an implicit acknowledgement, the router that sent the update receives an LSA from the receiving router that contains the update information.

If the retransmit interval passes with neither an explicit nor an implicit acknowledgement, the sending router will retransmit the link-state update packet.

Too high an interval slows network convergence. Too small an interval causes unnecessary retransmission.

Use the set form of this command to set the OSPF retransmit interval for a PVC with Classical IPOA encapsulation on an ADSL interface.

Use the delete form of this command to restore the default retransmit interval.

Use the show form of this command to display retransmit interval configuration.

interval Specifies the time in seconds to wait for an acknowledgement, after which the system retransmits an LSA packet to its neighbors. The range is 3 to 65535. The default is 5.

Page 323: Vyatta - OSPF

Chapter 9: DSL Classical IPOA Interfaces DSL Classical IPOA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

302

interfaces adsl <adslx> pvc <pvc-id> classical-ipoa ip ospf transmit-delay <delay>

Specifies the OSPF transmit delay for an ADSL PVC with Classical IPOA encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id classical-ipoa ip ospf transmit-delay delay

delete interfaces adsl adslx pvc pvc-id classical-ipoa ip ospf transmit-delay

show interfaces adsl adslx pvc pvc-id classical-ipoa ip ospf transmit-delay

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {classical-ipoa {

ip {ospf {

transmit-delay: u32}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 324: Vyatta - OSPF

Chapter 9: DSL Classical IPOA Interfaces DSL Classical IPOA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

303

Default

Link-state transmits occur at 1-second intervals.

Usage Guidelines

Use this command to set the transmit delay for a PVC with Classical IP over Asynchronous Transfer Mode (IPOA) encapsulation on an ADSL interface. This is the estimated time required to send a link-state update (LSU) packet.

This timer is used to accommodate transmission and propagation delays on the network, particularly on low-speed networks where delays may be significant. The router increments the age of link-state advertisements in LSU packets to account for these delays.

The value includes both the transmission time and the propagation delay across the network. The transmit delay is added to the age of the LSA packet before the LSA is transmitted The LSA age is used to help the network sequence LSAs, so that it can determine which of competing LSAs is the more recent and trustworthy.

LSAs are numbered in sequence, but the sequence numbers are finite, and so cannot be used as the sole determinant of the most recent LSA. Instead, OSPF also tracks the age of LSAs. Each time the LSA is forwarded to another router, its current age is incremented by the transmit delay. The packet’s age, together with its sequence number, helps the receiving router to determine which version of a received LSA is more recent, and therefore to be used.

Use the set form of this command to set the transmit delay.

Use the delete form of this command to restore the default transmit delay.

Use the show form of this command to display transmit delay configuration.

delay Mandatory. The delay, in seconds, between link-state transmits. This value must be the same for all nodes on the network. The range is 1 to 65535. The default is 1.

Page 325: Vyatta - OSPF

304

Chapter 10: DSL PPPoE Interfaces

This chapter describes commands for configuring OSPF on DSL interfaces with Point-to-Point Protocol over Ethernet (PPPoE) encapsulation.

This chapter presents the following topics:

• DSL PPPoE Interface OSPF Commands

Page 326: Vyatta - OSPF

Chapter 10: DSL PPPoE Interfaces DSL PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

305

DSL PPPoE Interface OSPF CommandsThis chapter contains the following commands.

Configuration Commands

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf

Enables OSPF on an ADSL PVC with PPPoE encapsulation.

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf authentication

Specifies the authentication method for OSPF on an ADSL PVC with PPPoE encapsulation.

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf bandwidth <bandwidth>

Specifies the bandwidth of an ADSL PVC with PPPoE encapsulation for calculating OSPF cost.

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf cost <cost>

Sets the routing cost for OSPF on an ADSL PVC with PPPoE encapsulation.

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf dead-interval <interval>

Sets the OSPF dead interval for an ADSL PVC with PPPoE encapsulation.

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf hello-interval <interval>

Sets the interval between OSPF hello packets on an ADSL PVC with PPPoE encapsulation.

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf mtu-ignore

Disables MTU mismatch detection for an ADSL PVC with PPPoE encapsulation.

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf network <type>

Specifies the OSPF network type for an ADSL PVC with PPPoE encapsulation.

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf priority <priority>

Sets the OSPF priority for an ADSL PVC with PPPoE encapsulation.

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf retransmit-interval <interval>

Sets the OSPF retransmit interval for an ADSL PVC with PPPoE encapsulation.

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf transmit-delay <delay>

Specifies the OSPF transmit delay for an ADSL PVC with PPPoE encapsulation.

Operational Commands

None.

Page 327: Vyatta - OSPF

Chapter 10: DSL PPPoE Interfaces DSL PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

306

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf

Enables OSPF on an ADSL PVC with PPPoE encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id pppoe num ip ospf

delete interfaces adsl adslx pvc pvc-id pppoe num ip ospf

show interfaces adsl adslx pvc pvc-id pppoe num ip ospf

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {pppoe 0-15 {

ip {ospf {}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 328: Vyatta - OSPF

Chapter 10: DSL PPPoE Interfaces DSL PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

307

Default

None.

Usage Guidelines

Use this command to enable the Open Shortest Path First (OSPF) routing protocol on a PVC with Point-to-Point Protocol over Ethernet (PPPoE) encapsulation on an ADSL interface.

Use the set form of this command to enable OSPF on an interface.

Use the delete form of this command to remove all OSPF configuration and disable OSPF on an interface.

Use the show form of this command to display OSPF configuration.

num Mandatory. The name of a defined PPPoE unit. The range of values is 0 to 15.

Page 329: Vyatta - OSPF

Chapter 10: DSL PPPoE Interfaces DSL PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

308

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf authentication

Specifies the authentication method for OSPF on an ADSL PVC with PPPoE encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id pppoe num ip ospf authentication [md5 key-id key-id md5-key md5-key | plaintext-password password]

delete interfaces adsl adslx pvc pvc-id pppoe num ip ospf authentication [md5 key-id key-id md5-key | plaintext-password]

show interfaces adsl adslx pvc pvc-id pppoe num ip ospf authentication [md5 key-id key-id md5-key | plaintext-password]

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {pppoe 0-15 {

ip {ospf {

authentication {md5 {

key-id 1-255 {md5-key: text

}}plaintext-password: text

}}

}}

}}

}

Page 330: Vyatta - OSPF

Chapter 10: DSL PPPoE Interfaces DSL PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

309

Parameters

Default

None.

Usage Guidelines

Use this command to specify the authentication method to be used for OSPF on a PVC with Point-to-Point Protocol over Ethernet (PPPoE) encapsulation on an ADSL interface. This authentication is independent of the authentication configured for the OSPF area.

In plain text authentication, passwords are sent through the network in plain text. In MD5 authentication, the system uses the Message Digest 5 (MD5) algorithm to compute a hash value from the contents of the OSPF packet and the password. The hash value and the MD5 key are included in the transmitted packet, and the receiving system (configured with the same password) calculates its own hash function, which must match.

The authentication parameters must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not consider establish adjacencies, and will disregard one another’s communications.

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

num Mandatory. The name of a defined PPPoE unit. The range of values is 0 to 15.

key-id Optional. The key used to identify the MD5 key. This must be the same on both the sending and receiving systems. The range is 1 to 255.

md5-key Optional. A password-like MD5 key of up to 16 alphanumeric characters to be used as input to the MD5 hashing algorithm. The longer the key, the stronger the security. This must be the same on both the sending and receiving systems.

password Optional. The password to use in plain-text authentication. This must be eight characters or less and the same on both the sending and receiving systems.

Page 331: Vyatta - OSPF

Chapter 10: DSL PPPoE Interfaces DSL PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

310

Use the set form of this command to set the authentication for a PVC with PPPoE encapsulation on an ADSL interface.

Use the delete form of this command to remove authentication configuration information.

Use the show form of this command to display authentication configuration information.

Page 332: Vyatta - OSPF

Chapter 10: DSL PPPoE Interfaces DSL PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

311

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf bandwidth <bandwidth>

Specifies the bandwidth of an ADSL PVC with PPPoE encapsulation for calculating OSPF cost.

Syntax

set interfaces adsl adslx pvc pvc-id pppoe num ip ospf bandwidth bandwidth

delete interfaces adsl adslx pvc pvc-id pppoe num ip ospf bandwidth

show interfaces adsl adslx pvc pvc-id pppoe num ip ospf bandwidth

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {pppoe 0-15 {

ip {ospf {

bandwidth: u32}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 333: Vyatta - OSPF

Chapter 10: DSL PPPoE Interfaces DSL PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

312

Default

None.

Usage Guidelines

Use this command to specify the bandwidth of a PVC with Point-to-Point Protocol over Ethernet (PPPoE) encapsulation on an ADSL interface for the purpose of computing OSPF cost.

Use the set form of this command to specify the bandwidth of the interface.

Use the delete form of this command to remove the bandwidth parameter.

Use the show form of this command to display the bandwidth configuration.

num Mandatory. The name of a defined PPPoE unit. The range of values is 0 to 15.

bandwidth The bandwidth of the Ethernet interface in kilobits/sec. The range is 1 to 10000000.

Page 334: Vyatta - OSPF

Chapter 10: DSL PPPoE Interfaces DSL PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

313

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf cost <cost>

Sets the routing cost for OSPF on an ADSL PVC with PPPoE encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id pppoe num ip ospf cost cost

delete interfaces adsl adslx pvc pvc-id pppoe num ip ospf cost

show interfaces adsl adslx pvc pvc-id pppoe num ip ospf cost

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {pppoe 0-15 {

ip {ospf {

cost: u32}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 335: Vyatta - OSPF

Chapter 10: DSL PPPoE Interfaces DSL PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

314

Default

For details on the default of OSPF cost, please see the Usage Guidelines.

Usage Guidelines

Use this command to manually override the default OSPF cost computed by the system for a PVC with Point-to-Point Protocol over Ethernet (PPPoE) encapsulation on an ADSL interface. You can only assign one cost per interface.

By default, the metric associated with a link is computed as follows:

Cost = 108 / bandwidth

The cost of reaching any destination is the sum of the costs of the individual hops. Costs are always rounded to the nearest integer. Costs lower than 1 are rounded up to 1.

Table 10-1 shows the OSPF costs for some common media types.

num Mandatory. The name of a defined PPPoE unit. The range of values is 0 to 15.

cost The link-state metric (OSPF cost) to be advertised in the link-state advertisement (LSA) as the cost of sending packets over the ethernet interface. The range is 1 to 65535.

Table 10-1 OSPF Costs for Common Media Types

Media Type OSPF Cost

56 Kbps 1785

64 Kbps 1562

128 Kbps 781

256 Kbps 390

512 Kbps 195

768 Kbps 130

T1 (1.544 Mbps) 64

E1 (2.048 Mbps) 48

4 Mbps Token Ring 6

10 Mbps Ethernet 10

16 Mbps Token Ring 6

Page 336: Vyatta - OSPF

Chapter 10: DSL PPPoE Interfaces DSL PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

315

The values in Table 10-1 show how OSPF fails to distinguish between interfaces faster than 100 Mbps, for example, between Fast Ethernet (100 Mbps) and Gigabit Ethernet (1000 Mbps) interfaces. If you want to distinguish interfaces equal to or greater than 100 Mbps, you must manually configure the cost of the interface using this command.

Use the set form of this command to specify the OSPF cost for the interface.

Use the delete form of this command to restore the default cost.

Use the show form of this command to display cost configuration.

T3 (44.736 Mbps 2

100+ Mbps 1

Table 10-1 OSPF Costs for Common Media Types

Page 337: Vyatta - OSPF

Chapter 10: DSL PPPoE Interfaces DSL PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

316

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf dead-interval <interval>

Sets the OSPF dead interval for an ADSL PVC with PPPoE encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id pppoe num ip ospf dead-interval interval

delete interfaces adsl adslx pvc pvc-id pppoe num ip ospf dead-interval

show interfaces adsl adslx pvc pvc-id pppoe num ip ospf dead-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {pppoe 0-15 {

ip {ospf {

dead-interval: u32}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 338: Vyatta - OSPF

Chapter 10: DSL PPPoE Interfaces DSL PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

317

Default

The dead interval is 4 times the hello interval.

Usage Guidelines

Use this command to specify the interval during which a PVC with Point-to-Point Protocol over Ethernet (PPPoE) encapsulation on an ADSL interface should expect a hello packet from its neighbor.

If the dead interval passes without the interface receiving a hello packet from the neighbor, the neighbor’s status is changed to out-of-service, and all associated state is cleared.

The dead interval must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not establish adjacencies and will disregard one another’s communications.

Use the set form of this command to specify the dead interval.

Use the delete form of this command to restore the default dead interval.

Use the show form of this command to display dead interval configuration.

num Mandatory. The name of a defined PPPoE unit. The range of values is 0 to 15.

interval Specifies the time, in seconds, that this interface should wait to detect hello packets from neighboring routers before declaring the neighbor down. The range is 1 to 65535. The default is 4 times the hello interval.

Page 339: Vyatta - OSPF

Chapter 10: DSL PPPoE Interfaces DSL PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

318

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf hello-interval <interval>

Sets the interval between OSPF hello packets on an ADSL PVC with PPPoE encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id pppoe num ip ospf hello-interval interval

delete interfaces adsl adslx pvc pvc-id pppoe num ip ospf hello-interval

show interfaces adsl adslx pvc pvc-id pppoe num ip ospf hello-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {pppoe 0-15 {

ip {ospf {

hello-interval: u32}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 340: Vyatta - OSPF

Chapter 10: DSL PPPoE Interfaces DSL PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

319

Default

Hello packets are sent every 10 seconds.

Usage Guidelines

Use this command to set the interval at which OSPF hello packets are sent for a PVC with Point-to-Point Protocol over Ethernet (PPPoE) encapsulation on an ADSL interface.

A hello packet is an OSPF packet used to detect and maintain relationships with neighbors on the same network (directly connected routers). The greater the interval between hello packets, the less router traffic occurs, but the longer it takes for topological changes to be

detected.

The hello interval must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not establish adjacencies and will disregard one another’s communications.

Use the set form of this command to set the hello interval.

Use the delete form of this command to restore the default hello interval.

Use the show form of this command to display hello interval configuration.

num Mandatory. The name of a defined PPPoE unit. The range of values is 0 to 15.

interval Mandatory. The interval, in seconds, between hello packets. This value must be the same for all nodes on the network.The range is 1 to 65535. The default is 10.

Page 341: Vyatta - OSPF

Chapter 10: DSL PPPoE Interfaces DSL PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

320

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf mtu-ignore

Disables MTU mismatch detection for an ADSL PVC with PPPoE encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id pppoe num ip ospf mtu-ignore

delete interfaces adsl adslx pvc pvc-id pppoe num ip ospf mtu-ignore

show interfaces adsl adslx pvc pvc-id pppoe num ip ospf

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {pppoe 0-15 {

ip {ospf {

mtu-ignore}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 342: Vyatta - OSPF

Chapter 10: DSL PPPoE Interfaces DSL PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

321

Default

MTU mismatch detection is enabled by default.

Usage Guidelines

Use this command to disable MTU mismatch detection on an OSPF interface.

OSPF sends the MTU of the interface in a database description packet. If the MTUs of OSPF neighbors do not match, they cannot form an OSPF adjacency. MTU mismatch detection detects MTU mismatches and indicates them in the form of a debug message.

MTU mismatch is an important troubleshooting feature. If MTU mismatch is not enabled, MTU mismatches can only be detected by examining configuration for both interfaces.

There are some network setups where MTU mismatches are unavoidable, and even part of the normal set-up. It is for these cases only that MTU mismatch detection should be disabled, so that normal OSPF adjacencies can be formed.

Use the set form of this command to disable MTU mismatch detection.

Use the delete form of this command to re-enable MTU mismatch detection.

Use the show form of this command to display OSPF configuration.

num Mandatory. The name of a defined PPPoE unit. The range of values is 0 to 15.

Page 343: Vyatta - OSPF

Chapter 10: DSL PPPoE Interfaces DSL PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

322

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf network <type>

Specifies the OSPF network type for an ADSL PVC with PPPoE encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id pppoe num ip ospf network [broadcast | non-broadcast | point-to-multipoint | point-to-point]

delete interfaces adsl adslx pvc pvc-id pppoe num ip ospf network

show interfaces adsl adslx pvc pvc-id pppoe num ip ospf network

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {pppoe 0-15 {

ip {ospf {

network: text}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 344: Vyatta - OSPF

Chapter 10: DSL PPPoE Interfaces DSL PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

323

Default

Broadcast is supported.

Usage Guidelines

Use this command to configure and display the network type for the interface.

Use the set form of this command to specify the network type.

Use the delete form of this command to remove the network type.

Use the show form of this command to display the network type.

num Mandatory. The name of a defined PPPoE unit. The range of values is 0 to 15.

type The network type for this interface. Supported values are as follows:

broadcast: The interface supports broadcast mode, such as a LAN link.

non-broadcast: The interface does not support broadcast mode.

point-to-point: This interface supports point-to-point mode, such as an NBMA interface.

point-to-multipoint: This interface supports point-to-multipoint mode, such as a PPP interface or a point-to-point logical interface on Frame Relay.

The default is broadcast.

Page 345: Vyatta - OSPF

Chapter 10: DSL PPPoE Interfaces DSL PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

324

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf priority <priority>

Sets the OSPF priority for an ADSL PVC with PPPoE encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id pppoe num ip ospf priority priority

delete interfaces adsl adslx pvc pvc-id pppoe num ip ospf priority

show interfaces adsl adslx pvc pvc-id pppoe num ip ospf priority

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {pppoe 0-15 {

ip {ospf {

priority: u32}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 346: Vyatta - OSPF

Chapter 10: DSL PPPoE Interfaces DSL PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

325

Default

An OSPF interface has a priority of 1.

Usage Guidelines

Use this command to set the priority for a PVC with Point-to-Point Protocol over Ethernet (PPPoE) encapsulation on an ADSL interface on the broadcast network to which the interface is connected. The priority determines which routers are selected as the area’s Designated Router (DR) and Backup Designated Router (BDR).

The DR and BDR are used to reduce the amount of traffic on OSPF overhead on broadcast networks, by reducing the number of adjacent routers to which a router must flood its topological information. In broadcast networks (such as Ethernet), each router establishes an adjacency with only the DR and the BDR, rather than with every router in its area. The DR and the BDR then flood this information to all other routers on the network segment.

Priority can range from 0 to 255. In general, the router with the highest priority is elected as the DR, and the router with the second-highest priority is elected as the BDR. The higher the number, the higher the priority.

Routers with a priority of 0 are ineligible for election.

Use the set form of this command to specify the OSPF priority.

Use the delete form of this command to restore the default priority.

Use the show form of this command to display priority configuration.

num Mandatory. The name of a defined PPPoE unit. The range of values is 0 to 15.

priority Specifies the OSPF router priority for this interface. The range is 0 to 255, where a router with priority 0 can never become the designated router. The default is 1.

Page 347: Vyatta - OSPF

Chapter 10: DSL PPPoE Interfaces DSL PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

326

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf retransmit-interval <interval>

Sets the OSPF retransmit interval for an ADSL PVC with PPPoE encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id pppoe num ip ospf retransmit-interval interval

delete interfaces adsl adslx pvc pvc-id pppoe num ip ospf retransmit-interval

show interfaces adsl adslx pvc pvc-id pppoe num ip ospf retransmit-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {pppoe 0-15 {

ip {ospf {

retransmit-interval: u32}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 348: Vyatta - OSPF

Chapter 10: DSL PPPoE Interfaces DSL PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

327

Default

Unacknowledged LSAs are retransmitted at 5-second intervals.

Usage Guidelines

Use this command to specify how long a PVC with Point-to-Point Protocol over Ethernet (PPPoE) encapsulation on an ADSL interface will wait for an acknowledgment of a link-state update before resending the update.

The link-state update packet is part of the exchange of topology databases between routers. When the initial database description (DD) packet is sent, it contains only the headers of the LSAs. If the receiving router determines that it requires that piece of the OSPF topology, it sends a link state request packet to request the complete LSA from the sending router.

After the update packet is sent, the sending router waits for an acknowledgement, either implicit or explicit, from the receiving router. In an explicit acknowledgement, the receiving router sends a link-state acknowledge (LS-Ack) packet to the router that sent the update. In an implicit acknowledgement, the router that sent the update receives an LSA from the receiving router that contains the update information.

If the retransmit interval passes with neither an explicit nor an implicit acknowledgement, the sending router will retransmit the link-state update packet.

Too high an interval slows network convergence. Too small an interval causes unnecessary retransmission.

Use the set form of this command to set the OSPF retransmit interval for a PVC with PPPoE encapsulation on an ADSL interface.

Use the delete form of this command to restore the default retransmit interval.

Use the show form of this command to display retransmit interval configuration.

num Mandatory. The name of a defined PPPoE unit. The range of values is 0 to 15.

interval Specifies the time in seconds to wait for an acknowledgement, after which the system retransmits an LSA packet to its neighbors. The range is 3 to 65535. The default is 5.

Page 349: Vyatta - OSPF

Chapter 10: DSL PPPoE Interfaces DSL PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

328

interfaces adsl <adslx> pvc <pvc-id> pppoe <num> ip ospf transmit-delay <delay>

Specifies the OSPF transmit delay for an ADSL PVC with PPPoE encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id pppoe num ip ospf transmit-delay delay

delete interfaces adsl adslx pvc pvc-id pppoe num ip ospf transmit-delay

show interfaces adsl adslx pvc pvc-id pppoe num ip ospf transmit-delay

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {pppoe 0-15 {

ip {ospf {

transmit-delay: u32}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 350: Vyatta - OSPF

Chapter 10: DSL PPPoE Interfaces DSL PPPoE Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

329

Default

Link-state transmits occur at 1-second intervals.

Usage Guidelines

Use this command to set the transmit delay for a PVC with Point-to-Point Protocol over Ethernet (PPPoE) encapsulation on an ADSL interface. This is the estimated time required to send a link-state update (LSU) packet.

This timer is used to accommodate transmission and propagation delays on the network, particularly on low-speed networks where delays may be significant. The router increments the age of link-state advertisements in LSU packets to account for these delays.

The value includes both the transmission time and the propagation delay across the network. The transmit delay is added to the age of the LSA packet before the LSA is transmitted The LSA age is used to help the network sequence LSAs, so that it can determine which of competing LSAs is the more recent and trustworthy.

LSAs are numbered in sequence, but the sequence numbers are finite, and so cannot be used as the sole determinant of the most recent LSA. Instead, OSPF also tracks the age of LSAs. Each time the LSA is forwarded to another router, its current age is incremented by the transmit delay. The packet’s age, together with its sequence number, helps the receiving router to determine which version of a received LSA is more recent, and therefore to be used.

Use the set form of this command to set the transmit delay.

Use the delete form of this command to restore the default transmit delay.

Use the show form of this command to display transmit delay configuration.

num Mandatory. The name of a defined PPPoE unit. The range of values is 0 to 15.

delay Mandatory. The delay, in seconds, between link-state transmits. This value must be the same for all nodes on the network. The range is 1 to 65535. The default is 1.

Page 351: Vyatta - OSPF

330

Chapter 11: DSL PPPoA Interfaces

This chapter describes commands for configuring OSPF on DSL interfaces with Point-to-Point Protocol over Asynchronous Transfer Mode (PPPoA) encapsulation.

This chapter presents the following topics:

• DSL PPPoA Interface OSPF Commands

Page 352: Vyatta - OSPF

Chapter 11: DSL PPPoA Interfaces DSL PPPoA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

331

DSL PPPoA Interface OSPF CommandsThis chapter contains the following commands.

Configuration Commands

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf

Enables OSPF on an ADSL PVC with PPPoA encapsulation.

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf authentication

Specifies the authentication method for OSPF on an ADSL PVC with PPPoA encapsulation.

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf bandwidth <bandwidth>

Specifies the bandwidth of an ADSL PVC with PPPoA encapsulation for calculating OSPF cost.

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf cost <cost>

Sets the routing cost for OSPF on an ADSL PVC with PPPoA encapsulation.

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf dead-interval <interval>

Sets the OSPF dead interval for an ADSL PVC with PPPoA encapsulation.

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf hello-interval <interval>

Sets the interval between OSPF hello packets on an ADSL PVC with PPPoA encapsulation.

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf mtu-ignore

Disables MTU mismatch detection for an ADSL PVC with PPPoA encapsulation.

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf network <type>

Specifies the OSPF network type for an ADSL PVC with PPPoA encapsulation.

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf priority <priority>

Sets the OSPF priority for an ADSL PVC with PPPoA encapsulation.

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf retransmit-interval <interval>

Sets the OSPF retransmit interval for an ADSL PVC with PPPoA encapsulation.

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf transmit-delay <delay>

Specifies the OSPF transmit delay for an ADSL PVC with PPPoA encapsulation.

Operational Commands

None.

Page 353: Vyatta - OSPF

Chapter 11: DSL PPPoA Interfaces DSL PPPoA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

332

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf

Enables OSPF on an ADSL PVC with PPPoA encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id pppoa num ip ospf

delete interfaces adsl adslx pvc pvc-id pppoa num ip ospf

show interfaces adsl adslx pvc pvc-id pppoa num ip ospf

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {pppoa 0-15 {

ip {ospf {}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 354: Vyatta - OSPF

Chapter 11: DSL PPPoA Interfaces DSL PPPoA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

333

Default

None.

Usage Guidelines

Use this command to enable the Open Shortest Path First (OSPF) routing protocol on a PVC with Point-to-Point Protocol over Asynchronous Transfer Mode (PPPoA) encapsulation on an ADSL interface.

Use the set form of this command to enable OSPF on an interface.

Use the delete form of this command to remove all OSPF configuration and disable OSPF on an interface.

Use the show form of this command to display OSPF configuration.

num Mandatory. The PPPoA unit number. This number must be unique across all PPPoA interfaces. In addition, only one PPPoA instance can be configured on a PVC. PPPoA units range from 0 to 15 and the resulting interfaces are named pppoa0 to pppoa15.

Page 355: Vyatta - OSPF

Chapter 11: DSL PPPoA Interfaces DSL PPPoA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

334

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf authentication

Specifies the authentication method for OSPF on an ADSL PVC with PPPoA encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id pppoa num ip ospf authentication [md5 key-id key-id md5-key md5-key | plaintext-password password]

delete interfaces adsl adslx pvc pvc-id pppoa num ip ospf authentication [md5 key-id key-id md5-key | plaintext-password]

show interfaces adsl adslx pvc pvc-id pppoa num ip ospf authentication [md5 key-id key-id md5-key | plaintext-password]

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {pppoa 0-15 {

ip {ospf {

authentication {md5 {

key-id 1-255 {md5-key: text

}}plaintext-password: text

}}

}}

}}

}

Page 356: Vyatta - OSPF

Chapter 11: DSL PPPoA Interfaces DSL PPPoA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

335

Parameters

Default

None.

Usage Guidelines

Use this command to specify the authentication method to be used for OSPF on a PVC with Point-to-Point Protocol over Asynchronous Transfer Mode (PPPoA) encapsulation on an ADSL interface. This authentication is independent of the authentication configured for the OSPF area.

In plain text authentication, passwords are sent through the network in plain text. In MD5 authentication, the system uses the Message Digest 5 (MD5) algorithm to compute a hash value from the contents of the OSPF packet and the password. The hash value and the MD5 key are included in the transmitted packet, and the receiving system (configured with the same password) calculates its own hash function, which must match.

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

num Mandatory. The PPPoA unit number. This number must be unique across all PPPoA interfaces. In addition, only one PPPoA instance can be configured on a PVC. PPPoA units range from 0 to 15 and the resulting interfaces are named pppoa0 to pppoa15.

key-id Optional. The key used to identify the MD5 key. This must be the same on both the sending and receiving systems. The range is 1 to 255.

md5-key Optional. A password-like MD5 key of up to 16 alphanumeric characters to be used as input to the MD5 hashing algorithm. The longer the key, the stronger the security. This must be the same on both the sending and receiving systems.

password Optional. The password to use in plain-text authentication. This must be eight characters or less and the same on both the sending and receiving systems.

Page 357: Vyatta - OSPF

Chapter 11: DSL PPPoA Interfaces DSL PPPoA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

336

The authentication parameters must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not consider establish adjacencies, and will disregard one another’s communications.

Use the set form of this command to set the authentication for a PVC with PPPoA encapsulation on an ADSL interface.

Use the delete form of this command to remove authentication configuration information.

Use the show form of this command to display authentication configuration information.

Page 358: Vyatta - OSPF

Chapter 11: DSL PPPoA Interfaces DSL PPPoA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

337

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf bandwidth <bandwidth>

Specifies the bandwidth of an ADSL PVC with PPPoA encapsulation for calculating OSPF cost.

Syntax

set interfaces adsl adslx pvc pvc-id pppoa num ip ospf bandwidth bandwidth

delete interfaces adsl adslx pvc pvc-id pppoa num ip ospf bandwidth

show interfaces adsl adslx pvc pvc-id pppoa num ip ospf bandwidth

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {pppoa 0-15 {

ip {ospf {

bandwidth: u32}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 359: Vyatta - OSPF

Chapter 11: DSL PPPoA Interfaces DSL PPPoA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

338

Default

None.

Usage Guidelines

Use this command to specify the bandwidth of a PVC with Point-to-Point Protocol over Asynchronous Transfer Mode (PPPoA) encapsulation on an ADSL interface for the purpose of computing OSPF cost.

Use the set form of this command to specify the bandwidth of the interface.

Use the delete form of this command to remove the bandwidth parameter.

Use the show form of this command to display the bandwidth configuration.

num Mandatory. The PPPoA unit number. This number must be unique across all PPPoA interfaces. In addition, only one PPPoA instance can be configured on a PVC. PPPoA units range from 0 to 15 and the resulting interfaces are named pppoa0 to pppoa15.

bandwidth The bandwidth of the Ethernet interface in kilobits/sec. The range is 1 to 10000000.

Page 360: Vyatta - OSPF

Chapter 11: DSL PPPoA Interfaces DSL PPPoA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

339

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf cost <cost>

Sets the routing cost for OSPF on an ADSL PVC with PPPoA encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id pppoa num ip ospf cost cost

delete interfaces adsl adslx pvc pvc-id pppoa num ip ospf cost

show interfaces adsl adslx pvc pvc-id pppoa num ip ospf cost

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {pppoa 0-15 {

ip {ospf {

cost: u32}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 361: Vyatta - OSPF

Chapter 11: DSL PPPoA Interfaces DSL PPPoA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

340

Default

For details on the default of OSPF cost, please see the Usage Guidelines.

Usage Guidelines

Use this command to manually override the default OSPF cost computed by the system for a PVC with Point-to-Point Protocol over Asynchronous Transfer Mode (PPPoA) encapsulation on an ADSL interface. You can only assign one cost per interface.

By default, the metric associated with a link is computed as follows:

Cost = 108 / bandwidth

The cost of reaching any destination is the sum of the costs of the individual hops. Costs are always rounded to the nearest integer. Costs lower than 1 are rounded up to 1.

Table 11-1 shows the OSPF costs for some common media types.

num Mandatory. The PPPoA unit number. This number must be unique across all PPPoA interfaces. In addition, only one PPPoA instance can be configured on a PVC. PPPoA units range from 0 to 15 and the resulting interfaces are named pppoa0 to pppoa15.

cost The link-state metric (OSPF cost) to be advertised in the link-state advertisement (LSA) as the cost of sending packets over the ethernet interface. The range is 1 to 65535.

Table 11-1 OSPF Costs for Common Media Types

Media Type OSPF Cost

56 Kbps 1785

64 Kbps 1562

128 Kbps 781

256 Kbps 390

512 Kbps 195

768 Kbps 130

T1 (1.544 Mbps) 64

E1 (2.048 Mbps) 48

4 Mbps Token Ring 6

10 Mbps Ethernet 10

Page 362: Vyatta - OSPF

Chapter 11: DSL PPPoA Interfaces DSL PPPoA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

341

The values in Table 11-1 show how OSPF fails to distinguish between interfaces faster than 100 Mbps, for example, between Fast Ethernet (100 Mbps) and Gigabit Ethernet (1000 Mbps) interfaces. If you want to distinguish interfaces equal to or greater than 100 Mbps, you must manually configure the cost of the interface using this command.

Use the set form of this command to specify the OSPF cost for the interface.

Use the delete form of this command to restore the default cost.

Use the show form of this command to display cost configuration.

16 Mbps Token Ring 6

T3 (44.736 Mbps 2

100+ Mbps 1

Table 11-1 OSPF Costs for Common Media Types

Page 363: Vyatta - OSPF

Chapter 11: DSL PPPoA Interfaces DSL PPPoA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

342

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf dead-interval <interval>

Sets the OSPF dead interval for an ADSL PVC with PPPoA encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id pppoa num ip ospf dead-interval interval

delete interfaces adsl adslx pvc pvc-id pppoa num ip ospf dead-interval

show interfaces adsl adslx pvc pvc-id pppoa num ip ospf dead-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {pppoa 0-15 {

ip {ospf {

dead-interval: u32}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 364: Vyatta - OSPF

Chapter 11: DSL PPPoA Interfaces DSL PPPoA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

343

Default

The dead interval is 4 times the hello interval.

Usage Guidelines

Use this command to specify the interval during which a PVC with Point-to-Point Protocol over Asynchronous Transfer Mode (PPPoA) encapsulation on an ADSL interface should expect a hello packet from its neighbor.

If the dead interval passes without the interface receiving a hello packet from the neighbor, the neighbor’s status is changed to out-of-service, and all associated state is cleared.

The dead interval must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not establish adjacencies and will disregard one another’s communications.

Use the set form of this command to specify the dead interval.

Use the delete form of this command to restore the default dead interval.

Use the show form of this command to display dead interval configuration.

num Mandatory. The PPPoA unit number. This number must be unique across all PPPoA interfaces. In addition, only one PPPoA instance can be configured on a PVC. PPPoA units range from 0 to 15 and the resulting interfaces are named pppoa0 to pppoa15.

interval Specifies the time, in seconds, that this interface should wait to detect hello packets from neighboring routers before declaring the neighbor down. The range is 1 to 65535. The default is 4 times the hello interval.

Page 365: Vyatta - OSPF

Chapter 11: DSL PPPoA Interfaces DSL PPPoA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

344

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf hello-interval <interval>

Sets the interval between OSPF hello packets on an ADSL PVC with PPPoA encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id pppoa num ip ospf hello-interval interval

delete interfaces adsl adslx pvc pvc-id pppoa num ip ospf hello-interval

show interfaces adsl adslx pvc pvc-id pppoa num ip ospf hello-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {pppoa 0-15 {

ip {ospf {

hello-interval: u32}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 366: Vyatta - OSPF

Chapter 11: DSL PPPoA Interfaces DSL PPPoA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

345

Default

Hello packets are sent every 10 seconds.

Usage Guidelines

Use this command to set the interval at which OSPF hello packets are sent for a PVC with Point-to-Point Protocol over Asynchronous Transfer Mode (PPPoA) encapsulation on an ADSL interface.

A hello packet is an OSPF packet used to detect and maintain relationships with neighbors on the same network (directly connected routers). The greater the interval between hello packets, the less router traffic occurs, but the longer it takes for topological changes to be

detected.

The hello interval must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not establish adjacencies and will disregard one another’s communications.

Use the set form of this command to set the hello interval.

Use the delete form of this command to restore the default hello interval.

Use the show form of this command to display hello interval configuration.

num Mandatory. The PPPoA unit number. This number must be unique across all PPPoA interfaces. In addition, only one PPPoA instance can be configured on a PVC. PPPoA units range from 0 to 15 and the resulting interfaces are named pppoa0 to pppoa15.

interval Mandatory. The interval, in seconds, between hello packets. This value must be the same for all nodes on the network.The range is 1 to 65535. The default is 10.

Page 367: Vyatta - OSPF

Chapter 11: DSL PPPoA Interfaces DSL PPPoA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

346

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf mtu-ignore

Disables MTU mismatch detection for an ADSL PVC with PPPoA encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id pppoa num ip ospf mtu-ignore

delete interfaces adsl adslx pvc pvc-id pppoa num ip ospf mtu-ignore

show interfaces adsl adslx pvc pvc-id pppoa num ip ospf

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {pppoa 0-15 {

ip {ospf {

mtu-ignore}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 368: Vyatta - OSPF

Chapter 11: DSL PPPoA Interfaces DSL PPPoA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

347

Default

MTU mismatch detection is enabled by default.

Usage Guidelines

Use this command to disable MTU mismatch detection on an ADSL interface with Point-to-Point Protocol over Asynchronous Transfer Mode (PPPoA) encapsulation running OSPF.

OSPF sends the MTU of the interface in a database description packet. If the MTUs of OSPF neighbors do not match, they cannot form an OSPF adjacency. MTU mismatch detection detects MTU mismatches and indicates them in the form of a debug message.

MTU mismatch is an important troubleshooting feature. If MTU mismatch is not enabled, MTU mismatches can only be detected by examining configuration for both interfaces.

There are some network setups where MTU mismatches are unavoidable, and even part of the normal set-up. It is for these cases only that MTU mismatch detection should be disabled, so that normal OSPF adjacencies can be formed.

Use the set form of this command to disable MTU mismatch detection.

Use the delete form of this command to re-enable MTU mismatch detection.

Use the show form of this command to display OSPF configuration.

num Mandatory. The PPPoA unit number. This number must be unique across all PPPoA interfaces. In addition, only one PPPoA instance can be configured on a PVC. PPPoA units range from 0 to 15 and the resulting interfaces are named pppoa0 to pppoa15.

Page 369: Vyatta - OSPF

Chapter 11: DSL PPPoA Interfaces DSL PPPoA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

348

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf network <type>

Specifies the OSPF network type for an ADSL PVC with PPPoA encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id pppoa num ip ospf network [broadcast | non-broadcast | point-to-multipoint | point-to-point]

delete interfaces adsl adslx pvc pvc-id pppoa num ip ospf network

show interfaces adsl adslx pvc pvc-id pppoa num ip ospf network

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {pppoa 0-15 {

ip {ospf {

network: text}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 370: Vyatta - OSPF

Chapter 11: DSL PPPoA Interfaces DSL PPPoA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

349

Default

Broadcast is supported.

Usage Guidelines

Use this command to configure and display the network type for an ADSL interface with Point-to-Point Protocol over Asynchronous Transfer Mode (PPPoA) encapsulation running OSPF.

Use the set form of this command to specify the network type.

Use the delete form of this command to remove the network type.

Use the show form of this command to display the network type.

num Mandatory. The PPPoA unit number. This number must be unique across all PPPoA interfaces. In addition, only one PPPoA instance can be configured on a PVC. PPPoA units range from 0 to 15 and the resulting interfaces are named pppoa0 to pppoa15.

type The network type for this interface. Supported values are as follows:

broadcast: The interface supports broadcast mode, such as a LAN link.

non-broadcast: The interface does not support broadcast mode.

point-to-point: This interface supports point-to-point mode, such as an NBMA interface.

point-to-multipoint: This interface supports point-to-multipoint mode, such as a PPP interface or a point-to-point logical interface on Frame Relay.

The default is broadcast.

Page 371: Vyatta - OSPF

Chapter 11: DSL PPPoA Interfaces DSL PPPoA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

350

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf priority <priority>

Sets the OSPF priority for an ADSL PVC with PPPoA encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id pppoa num ip ospf priority priority

delete interfaces adsl adslx pvc pvc-id pppoa num ip ospf priority

show interfaces adsl adslx pvc pvc-id pppoa num ip ospf priority

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {pppoa 0-15 {

ip {ospf {

priority: u32}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 372: Vyatta - OSPF

Chapter 11: DSL PPPoA Interfaces DSL PPPoA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

351

Default

An OSPF interface has a priority of 1.

Usage Guidelines

Use this command to set the priority for a PVC with PPPoA encapsulation on an ADSL interface on the broadcast network to which the interface is connected. The priority determines which routers are selected as the area’s Designated Router (DR) and Backup Designated Router (BDR).

The DR and BDR are used to reduce the amount of traffic on OSPF overhead on broadcast networks, by reducing the number of adjacent routers to which a router must flood its topological information. In broadcast networks (such as Ethernet), each router establishes an adjacency with only the DR and the BDR, rather than with every router in its area. The DR and the BDR then flood this information to all other routers on the network segment.

Priority can range from 0 to 255. In general, the router with the highest priority is elected as the DR, and the router with the second-highest priority is elected as the BDR. The higher the number, the higher the priority.

Routers with a priority of 0 are ineligible for election.

Use the set form of this command to specify the OSPF priority.

Use the delete form of this command to restore the default priority.

Use the show form of this command to display priority configuration.

num Mandatory. The PPPoA unit number. This number must be unique across all PPPoA interfaces. In addition, only one PPPoA instance can be configured on a PVC. PPPoA units range from 0 to 15 and the resulting interfaces are named pppoa0 to pppoa15.

priority Specifies the OSPF router priority for this interface. The range is 0 to 255, where a router with priority 0 can never become the designated router. The default is 1.

Page 373: Vyatta - OSPF

Chapter 11: DSL PPPoA Interfaces DSL PPPoA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

352

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf retransmit-interval <interval>

Sets the OSPF retransmit interval for an ADSL PVC with PPPoA encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id pppoa num ip ospf retransmit-interval interval

delete interfaces adsl adslx pvc pvc-id pppoa num ip ospf retransmit-interval

show interfaces adsl adslx pvc pvc-id pppoa num ip ospf retransmit-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {pppoa 0-15 {

ip {ospf {

retransmit-interval: u32}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 374: Vyatta - OSPF

Chapter 11: DSL PPPoA Interfaces DSL PPPoA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

353

Default

Unacknowledged LSAs are retransmitted at 5-second intervals.

Usage Guidelines

Use this command to specify how long a PVC with PPPoA encapsulation on an ADSL interface will wait for an acknowledgment of a link-state update before resending the update.

The link-state update packet is part of the exchange of topology databases between routers. When the initial database description (DD) packet is sent, it contains only the headers of the LSAs. If the receiving router determines that it requires that piece of the OSPF topology, it sends a link state request packet to request the complete LSA from the sending router.

After the update packet is sent, the sending router waits for an acknowledgement, either implicit or explicit, from the receiving router. In an explicit acknowledgement, the receiving router sends a link-state acknowledge (LS-Ack) packet to the router that sent the update. In an implicit acknowledgement, the router that sent the update receives an LSA from the receiving router that contains the update information.

If the retransmit interval passes with neither an explicit nor an implicit acknowledgement, the sending router will retransmit the link-state update packet.

Too high an interval slows network convergence. Too small an interval causes unnecessary retransmission.

Use the set form of this command to set the OSPF retransmit interval for a PVC with PPPoA encapsulation on an ADSL interface.

Use the delete form of this command to restore the default retransmit interval.

Use the show form of this command to display retransmit interval configuration.

num Mandatory. The PPPoA unit number. This number must be unique across all PPPoA interfaces. In addition, only one PPPoA instance can be configured on a PVC. PPPoA units range from 0 to 15 and the resulting interfaces are named pppoa0 to pppoa15.

interval Specifies the time in seconds to wait for an acknowledgement, after which the system retransmits an LSA packet to its neighbors. The range is 3 to 65535. The default is 5.

Page 375: Vyatta - OSPF

Chapter 11: DSL PPPoA Interfaces DSL PPPoA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

354

interfaces adsl <adslx> pvc <pvc-id> pppoa <num> ip ospf transmit-delay <delay>

Specifies the OSPF transmit delay for an ADSL PVC with PPPoA encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id pppoa num ip ospf transmit-delay delay

delete interfaces adsl adslx pvc pvc-id pppoa num ip ospf transmit-delay

show interfaces adsl adslx pvc pvc-id pppoa num ip ospf transmit-delay

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {pppoa 0-15 {

ip {ospf {

transmit-delay: u32}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 376: Vyatta - OSPF

Chapter 11: DSL PPPoA Interfaces DSL PPPoA Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

355

Default

Link-state transmits occur at 1-second intervals.

Usage Guidelines

Use this command to set the transmit delay for a PVC with PPPoA encapsulation on an ADSL interface. This is the estimated time required to send a link-state update (LSU) packet.

This timer is used to accommodate transmission and propagation delays on the network, particularly on low-speed networks where delays may be significant. The router increments the age of link-state advertisements in LSU packets to account for these delays.

The value includes both the transmission time and the propagation delay across the network. The transmit delay is added to the age of the LSA packet before the LSA is transmitted The LSA age is used to help the network sequence LSAs, so that it can determine which of competing LSAs is the more recent and trustworthy.

LSAs are numbered in sequence, but the sequence numbers are finite, and so cannot be used as the sole determinant of the most recent LSA. Instead, OSPF also tracks the age of LSAs. Each time the LSA is forwarded to another router, its current age is incremented by the transmit delay. The packet’s age, together with its sequence number, helps the receiving router to determine which version of a received LSA is more recent, and therefore to be used.

Use the set form of this command to set the transmit delay.

Use the delete form of this command to restore the default transmit delay.

Use the show form of this command to display transmit delay configuration.

num Mandatory. The PPPoA unit number. This number must be unique across all PPPoA interfaces. In addition, only one PPPoA instance can be configured on a PVC. PPPoA units range from 0 to 15 and the resulting interfaces are named pppoa0 to pppoa15.

delay Mandatory. The delay, in seconds, between link-state transmits. This value must be the same for all nodes on the network. The range is 1 to 65535. The default is 1.

Page 377: Vyatta - OSPF

356

Chapter 12: DSL Bridged Ethernet Interfaces

This chapter describes commands for configuring OSPF on DSL interfaces with RFC 2684 bridged Ethernet encapsulation.

This chapter presents the following topics:

• DSL Bridged Ethernet Interface OSPF Commands

Page 378: Vyatta - OSPF

Chapter 12: DSL Bridged Ethernet Interfaces DSL Bridged Ethernet Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

357

DSL Bridged Ethernet Interface OSPF Commands

This chapter contains the following commands.

Configuration Commands

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf

Enables OSPF on an ADSL PVC with Bridged Ethernet encapsulation.

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf authentication

Specifies the authentication method for OSPF on an ADSL PVC with bridged-ethernet encapsulation.

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf bandwidth <bandwidth>

Specifies the bandwidth of an ADSL PVC with Bridged Ethernet encapsulation for calculating OSPF cost.

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf cost <cost>

Sets the routing cost for OSPF on an ADSL PVC with Bridged Ethernet encapsulation.

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf dead-interval <interval>

Sets the OSPF dead interval for an ADSL PVC with Bridged Ethernet encapsulation.

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf hello-interval <interval>

Sets the interval between OSPF hello packets on an ADSL PVC with Bridged Ethernet encapsulation.

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf mtu-ignore

Disables MTU mismatch detection for an ADSL PVC with Bridged Ethernet encapsulation.

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf network <type>

Specifies the OSPF network type for an ADSL PVC with Bridged Ethernet encapsulation.

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf priority <priority>

Sets the OSPF priority for an ADSL PVC with Bridged Ethernet encapsulation.

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf retransmit-interval <interval>

Sets the OSPF retransmit interval for an ADSL PVC with Bridged Ethernet encapsulation.

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf transmit-delay <delay>

Specifies the OSPF transmit delay for an ADSL PVC with Bridged Ethernet encapsulation.

Operational Commands

None.

Page 379: Vyatta - OSPF

Chapter 12: DSL Bridged Ethernet Interfaces DSL Bridged Ethernet Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

358

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf

Enables OSPF on an ADSL PVC with Bridged Ethernet encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id bridged-ethernet ip ospf

delete interfaces adsl adslx pvc pvc-id bridged-ethernet ip ospf

show interfaces adsl adslx pvc pvc-id bridged-ethernet ip ospf

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {bridged-ethernet {

ip {ospf {}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 380: Vyatta - OSPF

Chapter 12: DSL Bridged Ethernet Interfaces DSL Bridged Ethernet Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

359

Default

None.

Usage Guidelines

Use this command to enable the Open Shortest Path First (OSPF) routing protocol on a PVC with Bridged Ethernet encapsulation on an ADSL interface.

Use the set form of this command to enable OSPF on an interface.

Use the delete form of this command to remove all OSPF configuration and disable OSPF on an interface.

Use the show form of this command to display OSPF configuration.

Page 381: Vyatta - OSPF

Chapter 12: DSL Bridged Ethernet Interfaces DSL Bridged Ethernet Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

360

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf authentication

Specifies the authentication method for OSPF on an ADSL PVC with bridged-ethernet encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id bridged-ethernet ip ospf authentication [md5 key-id key-id md5-key md5-key | plaintext-password password]

delete interfaces adsl adslx pvc pvc-id bridged-ethernet ip ospf authentication [md5 key-id key-id md5-key | plaintext-password]

show interfaces adsl adslx pvc pvc-id bridged-ethernet ip ospf authentication [md5 key-id key-id md5-key | plaintext-password]

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {bridged-ethernet {

ip {ospf {

authentication {md5 {

key-id 1-255 {md5-key text

}}plaintext-password text

}}

}}

}}

}

Page 382: Vyatta - OSPF

Chapter 12: DSL Bridged Ethernet Interfaces DSL Bridged Ethernet Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

361

Parameters

Default

None.

Usage Guidelines

Use this command to specify the authentication method to be used for OSPF on a PVC with Bridged Ethernet encapsulation on an ADSL interface. This authentication is independent of the authentication configured for the OSPF area.

In plain text authentication, passwords are sent through the network in plain text. In MD5 authentication, the system uses the Message Digest 5 (MD5) algorithm to compute a hash value from the contents of the OSPF packet and the password. The hash value and the MD5 key are included in the transmitted packet, and the receiving system (configured with the same password) calculates its own hash function, which must match.

The authentication parameters must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not consider establish adjacencies, and will disregard one another’s communications.

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

key-id Optional. The key used to identify the MD5 key. This must be the same on both the sending and receiving systems. The range is 1 to 255.

md5-key Optional. A password-like MD5 key of up to 16 alphanumeric characters to be used as input to the MD5 hashing algorithm. The longer the key, the stronger the security. This must be the same on both the sending and receiving systems.

password Optional. The password to use in plain-text authentication. This must be eight characters or less and the same on both the sending and receiving systems.

Page 383: Vyatta - OSPF

Chapter 12: DSL Bridged Ethernet Interfaces DSL Bridged Ethernet Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

362

Use the set form of this command to set the authentication for a PVC with Bridged Ethernet encapsulation on an ADSL interface.

Use the delete form of this command to remove authentication configuration information.

Use the show form of this command to display authentication configuration information.

Page 384: Vyatta - OSPF

Chapter 12: DSL Bridged Ethernet Interfaces DSL Bridged Ethernet Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

363

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf bandwidth <bandwidth>

Specifies the bandwidth of an ADSL PVC with Bridged Ethernet encapsulation for calculating OSPF cost.

Syntax

set interfaces adsl adslx pvc pvc-id bridged-ethernet ip ospf bandwidth bandwidth

delete interfaces adsl adslx pvc pvc-id bridged-ethernet ip ospf bandwidth

show interfaces adsl adslx pvc pvc-id bridged-ethernet ip ospf bandwidth

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {bridged-ethernet {

ip {ospf {

bandwidth u32}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 385: Vyatta - OSPF

Chapter 12: DSL Bridged Ethernet Interfaces DSL Bridged Ethernet Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

364

Default

None.

Usage Guidelines

Use this command to specify the bandwidth of a PVC with Bridged Ethernet encapsulation on an ADSL interface for the purpose of computing OSPF cost.

Use the set form of this command to specify the bandwidth of the interface.

Use the delete form of this command to remove the bandwidth parameter.

Use the show form of this command to display the bandwidth configuration.

bandwidth The bandwidth of the Ethernet interface in kilobits/sec. The range is 1 to 10000000.

Page 386: Vyatta - OSPF

Chapter 12: DSL Bridged Ethernet Interfaces DSL Bridged Ethernet Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

365

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf cost <cost>

Sets the routing cost for OSPF on an ADSL PVC with Bridged Ethernet encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id bridged-ethernet ip ospf cost cost

delete interfaces adsl adslx pvc pvc-id bridged-ethernet ip ospf cost

show interfaces adsl adslx pvc pvc-id bridged-ethernet ip ospf cost

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {bridged-ethernet {

ip {ospf {

cost u32}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 387: Vyatta - OSPF

Chapter 12: DSL Bridged Ethernet Interfaces DSL Bridged Ethernet Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

366

Default

For details on the default of OSPF cost, please see the Usage Guidelines.

Usage Guidelines

Use this command to manually override the default OSPF cost computed by the system for a PVC with Bridged Ethernet encapsulation on an ADSL interface. You can only assign one cost per interface.

By default, the metric associated with a link is computed as follows:

Cost = 108 / bandwidth

The cost of reaching any destination is the sum of the costs of the individual hops. Costs are always rounded to the nearest integer. Costs lower than 1 are rounded up to 1.

Table 12-1 shows the OSPF costs for some common media types.

cost The link-state metric (OSPF cost) to be advertised in the link-state advertisement (LSA) as the cost of sending packets over the interface. The range is 1 to 65535.

Table 12-1 OSPF Costs for Common Media Types

Media Type OSPF Cost

56 Kbps 1785

64 Kbps 1562

128 Kbps 781

256 Kbps 390

512 Kbps 195

768 Kbps 130

T1 (1.544 Mbps) 64

E1 (2.048 Mbps) 48

4 Mbps Token Ring 6

10 Mbps Ethernet 10

16 Mbps Token Ring 6

T3 (44.736 Mbps 2

100+ Mbps 1

Page 388: Vyatta - OSPF

Chapter 12: DSL Bridged Ethernet Interfaces DSL Bridged Ethernet Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

367

The values in Table 12-1 show how OSPF fails to distinguish between interfaces faster than 100 Mbps, for example, between Fast Ethernet (100 Mbps) and Gigabit Ethernet (1000 Mbps) interfaces. If you want to distinguish interfaces equal to or greater than 100 Mbps, you must manually configure the cost of the interface using this command.

Use the set form of this command to specify the OSPF cost for the interface.

Use the delete form of this command to restore the default cost.

Use the show form of this command to display cost configuration.

Page 389: Vyatta - OSPF

Chapter 12: DSL Bridged Ethernet Interfaces DSL Bridged Ethernet Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

368

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf dead-interval <interval>

Sets the OSPF dead interval for an ADSL PVC with Bridged Ethernet encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id bridged-ethernet ip ospf dead-interval interval

delete interfaces adsl adslx pvc pvc-id bridged-ethernet ip ospf dead-interval

show interfaces adsl adslx pvc pvc-id bridged-ethernet ip ospf dead-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {bridged-ethernet {

ip {ospf {

dead-interval u32}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 390: Vyatta - OSPF

Chapter 12: DSL Bridged Ethernet Interfaces DSL Bridged Ethernet Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

369

Default

The dead interval is 4 times the hello interval.

Usage Guidelines

Use this command to specify the interval during which a PVC with Bridged Ethernet encapsulation on an ADSL interface should expect a hello packet from its neighbor.

If the dead interval passes without the interface receiving a hello packet from the neighbor, the neighbor’s status is changed to out-of-service, and all associated state is cleared.

The dead interval must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not establish adjacencies and will disregard one another’s communications.

Use the set form of this command to specify the dead interval.

Use the delete form of this command to restore the default dead interval.

Use the show form of this command to display dead interval configuration.

interval Specifies the time, in seconds, that this interface should wait to detect hello packets from neighboring routers before declaring the neighbor down. The range is 1 to 65535. The default is 4 times the hello interval.

Page 391: Vyatta - OSPF

Chapter 12: DSL Bridged Ethernet Interfaces DSL Bridged Ethernet Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

370

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf hello-interval <interval>

Sets the interval between OSPF hello packets on an ADSL PVC with Bridged Ethernet encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id bridged-ethernet ip ospf hello-interval interval

delete interfaces adsl adslx pvc pvc-id bridged-ethernet ip ospf hello-interval

show interfaces adsl adslx pvc pvc-id bridged-ethernet ip ospf hello-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {bridged-ethernet {

ip {ospf {

hello-interval u32}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 392: Vyatta - OSPF

Chapter 12: DSL Bridged Ethernet Interfaces DSL Bridged Ethernet Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

371

Default

Hello packets are sent every 10 seconds.

Usage Guidelines

Use this command to set the interval at which OSPF hello packets are sent for a PVC with Bridged Ethernet encapsulation on an ADSL interface.

A hello packet is an OSPF packet used to detect and maintain relationships with neighbors on the same network (directly connected routers). The greater the interval between hello packets, the less router traffic occurs, but the longer it takes for topological changes to be

detected.

The hello interval must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not establish adjacencies and will disregard one another’s communications.

Use the set form of this command to set the hello interval.

Use the delete form of this command to restore the default hello interval.

Use the show form of this command to display hello interval configuration.

interval Mandatory. The interval, in seconds, between hello packets. This value must be the same for all nodes on the network.The range is 1 to 65535. The default is 10.

Page 393: Vyatta - OSPF

Chapter 12: DSL Bridged Ethernet Interfaces DSL Bridged Ethernet Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

372

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf mtu-ignore

Disables MTU mismatch detection for an ADSL PVC with Bridged Ethernet encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id bridged-ethernet ip ospf mtu-ignore

delete interfaces adsl adslx pvc pvc-id bridged-ethernet ip ospf mtu-ignore

show interfaces adsl adslx pvc pvc-id bridged-ethernet ip ospf

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {bridged-ethernet {

ip {ospf {

mtu-ignore}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 394: Vyatta - OSPF

Chapter 12: DSL Bridged Ethernet Interfaces DSL Bridged Ethernet Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

373

Default

MTU mismatch detection is enabled by default.

Usage Guidelines

Use this command to disable MTU mismatch detection on an OSPF interface.

OSPF sends the MTU of the interface in a database description packet. If the MTUs of OSPF neighbors do not match, they cannot form an OSPF adjacency. MTU mismatch detection detects MTU mismatches and indicates them in the form of a debug message.

MTU mismatch is an important troubleshooting feature. If MTU mismatch is not enabled, MTU mismatches can only be detected by examining configuration for both interfaces.

There are some network setups where MTU mismatches are unavoidable, and even part of the normal set-up. It is for these cases only that MTU mismatch detection should be disabled, so that normal OSPF adjacencies can be formed.

Use the set form of this command to disable MTU mismatch detection.

Use the delete form of this command to re-enable MTU mismatch detection.

Use the show form of this command to display OSPF configuration.

Page 395: Vyatta - OSPF

Chapter 12: DSL Bridged Ethernet Interfaces DSL Bridged Ethernet Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

374

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf network <type>

Specifies the OSPF network type for an ADSL PVC with Bridged Ethernet encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id bridged-ethernet ip ospf network [broadcast | non-broadcast | point-to-multipoint | point-to-point]

delete interfaces adsl adslx pvc pvc-id bridged-ethernet ip ospf network

show interfaces adsl adslx pvc pvc-id bridged-ethernet ip ospf network

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {bridged-ethernet {

ip {ospf {

network text}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 396: Vyatta - OSPF

Chapter 12: DSL Bridged Ethernet Interfaces DSL Bridged Ethernet Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

375

Default

Broadcast is supported.

Usage Guidelines

Use this command to configure and display the network type for the interface.

Use the set form of this command to specify the network type.

Use the delete form of this command to remove the network type.

Use the show form of this command to display the network type.

type The network type for this interface. Supported values are as follows:

broadcast: The interface supports broadcast mode, such as a LAN link.

non-broadcast: The interface does not support broadcast mode.

point-to-point: This interface supports point-to-point mode, such as an NBMA interface.

point-to-multipoint: This interface supports point-to-multipoint mode, such as a PPP interface or a point-to-point logical interface on Frame Relay.

The default is broadcast.

Page 397: Vyatta - OSPF

Chapter 12: DSL Bridged Ethernet Interfaces DSL Bridged Ethernet Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

376

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf priority <priority>

Sets the OSPF priority for an ADSL PVC with Bridged Ethernet encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id bridged-ethernet ip ospf priority priority

delete interfaces adsl adslx pvc pvc-id bridged-ethernet ip ospf priority

show interfaces adsl adslx pvc pvc-id bridged-ethernet ip ospf priority

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {bridged-ethernet {

ip {ospf {

priority u32}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 398: Vyatta - OSPF

Chapter 12: DSL Bridged Ethernet Interfaces DSL Bridged Ethernet Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

377

Default

An OSPF interface has a priority of 1.

Usage Guidelines

Use this command to set the priority for a PVC with Bridged Ethernet encapsulation on an ADSL interface on the broadcast network to which the interface is connected. The priority determines which routers are selected as the area’s Designated Router (DR) and Backup Designated Router (BDR).

The DR and BDR are used to reduce the amount of traffic on OSPF overhead on broadcast networks, by reducing the number of adjacent routers to which a router must flood its topological information. In broadcast networks (such as Ethernet), each router establishes an adjacency with only the DR and the BDR, rather than with every router in its area. The DR and the BDR then flood this information to all other routers on the network segment.

Priority can range from 0 to 255. In general, the router with the highest priority is elected as the DR, and the router with the second-highest priority is elected as the BDR. The higher the number, the higher the priority.

Routers with a priority of 0 are ineligible for election.

Use the set form of this command to specify the OSPF priority.

Use the delete form of this command to restore the default priority.

Use the show form of this command to display priority configuration.

priority Specifies the OSPF router priority for this interface. The range is 0 to 255, where a router with priority 0 can never become the designated router. The default is 1.

Page 399: Vyatta - OSPF

Chapter 12: DSL Bridged Ethernet Interfaces DSL Bridged Ethernet Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

378

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf retransmit-interval <interval>

Sets the OSPF retransmit interval for an ADSL PVC with Bridged Ethernet encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id bridged-ethernet ip ospf retransmit-interval interval

delete interfaces adsl adslx pvc pvc-id bridged-ethernet ip ospf retransmit-interval

show interfaces adsl adslx pvc pvc-id bridged-ethernet ip ospf retransmit-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {bridged-ethernet {

ip {ospf {

retransmit-interval u32}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 400: Vyatta - OSPF

Chapter 12: DSL Bridged Ethernet Interfaces DSL Bridged Ethernet Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

379

Default

Unacknowledged LSAs are retransmitted at 5-second intervals.

Usage Guidelines

Use this command to specify how long a PVC with Bridged Ethernet encapsulation on an ADSL interface will wait for an acknowledgment of a link-state update before resending the update.

The link-state update packet is part of the exchange of topology databases between routers. When the initial database description (DD) packet is sent, it contains only the headers of the LSAs. If the receiving router determines that it requires that piece of the OSPF topology, it sends a link state request packet to request the complete LSA from the sending router.

After the update packet is sent, the sending router waits for an acknowledgement, either implicit or explicit, from the receiving router. In an explicit acknowledgement, the receiving router sends a link-state acknowledge (LS-Ack) packet to the router that sent the update. In an implicit acknowledgement, the router that sent the update receives an LSA from the receiving router that contains the update information.

If the retransmit interval passes with neither an explicit nor an implicit acknowledgement, the sending router will retransmit the link-state update packet.

Too high an interval slows network convergence. Too small an interval causes unnecessary retransmission.

Use the set form of this command to set the OSPF retransmit interval for a PVC with Bridged Ethernet encapsulation on an ADSL interface.

Use the delete form of this command to restore the default retransmit interval.

Use the show form of this command to display retransmit interval configuration.

interval Specifies the time in seconds to wait for an acknowledgement, after which the system retransmits an LSA packet to its neighbors. The range is 3 to 65535. The default is 5.

Page 401: Vyatta - OSPF

Chapter 12: DSL Bridged Ethernet Interfaces DSL Bridged Ethernet Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

380

interfaces adsl <adslx> pvc <pvc-id> bridged-ethernet ip ospf transmit-delay <delay>

Specifies the OSPF transmit delay for an ADSL PVC with Bridged Ethernet encapsulation.

Syntax

set interfaces adsl adslx pvc pvc-id bridged-ethernet ip ospf transmit-delay delay

delete interfaces adsl adslx pvc pvc-id bridged-ethernet ip ospf transmit-delay

show interfaces adsl adslx pvc pvc-id bridged-ethernet ip ospf transmit-delay

Command Mode

Configuration mode.

Configuration Statement

interfaces {adsl adslx {

pvc [0-255/0-65535|auto] {bridged-ethernet {

ip {ospf {

transmit-delay u32}

}}

}}

}

Parameters

adslx Mandatory. Multi-node. The identifier for the ADSL interface you are defining. This may be adsl0 to adslx, depending on what physical ADSL ports are actually available on the system.

pvc-id Mandatory. The identifier for the PVC. It can either be the vpi/vci pair or the keyword auto, where vpi is a Virtual Path Index from 0 to 255, vci is a Virtual Circuit Index from from 0 to 65535, and auto directs the system to detect the Virtual Path Index and Virtual Circuit Index automatically.

Page 402: Vyatta - OSPF

Chapter 12: DSL Bridged Ethernet Interfaces DSL Bridged Ethernet Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

381

Default

Link-state transmits occur at one-second intervals.

Usage Guidelines

Use this command to set the transmit delay for a PVC with Bridged Ethernet encapsulation on an ADSL interface. This is the estimated time required to send a link-state update (LSU) packet.

This timer is used to accommodate transmission and propagation delays on the network, particularly on low-speed networks where delays may be significant. The router increments the age of link-state advertisements in LSU packets to account for these delays.

The value includes both the transmission time and the propagation delay across the network. The transmit delay is added to the age of the LSA packet before the LSA is transmitted The LSA age is used to help the network sequence LSAs, so that it can determine which of competing LSAs is the more recent and trustworthy.

LSAs are numbered in sequence, but the sequence numbers are finite, and so cannot be used as the sole determinant of the most recent LSA. Instead, OSPF also tracks the age of LSAs. Each time the LSA is forwarded to another router, its current age is incremented by the transmit delay. The packet’s age, together with its sequence number, helps the receiving router to determine which version of a received LSA is more recent, and therefore to be used.

Use the set form of this command to set the transmit delay.

Use the delete form of this command to restore the default transmit delay.

Use the show form of this command to display transmit delay configuration.

delay Mandatory. The delay, in seconds, between link-state transmits. This value must be the same for all nodes on the network. The range is 1 to 65535. The default is 1.

Page 403: Vyatta - OSPF

382

Chapter 13: Multilink Interfaces

This chapter describes commands for configuring OSPF on multilink interfaces.

This chapter presents the following topics:

• Multilink Interface OSPF Commands

Page 404: Vyatta - OSPF

Chapter 13: Multilink Interfaces Multilink Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

383

Multilink Interface OSPF CommandsThis chapter contains the following commands.

Configuration Commands

interfaces multilink <mlx> ip ospf Enables OSPF on a multilink interface.

interfaces multilink <mlx> ip ospf Specifies the authentication method for OSPF on a multilink interface.

interfaces multilink <mlx> ip ospf bandwidth <bandwidth>

Specifies the bandwidth of a multilink interface for calculating OSPF cost.

interfaces multilink <mlx> ip ospf cost <cost> Sets the routing cost for OSPF on a multilink interface.

interfaces multilink <mlx> ip ospf dead-interval <interval>

Sets the dead interval for OSPF on a multilink interface.

interfaces multilink <mlx> ip ospf hello-interval <interval>

Sets the interval between OSPF hello packets on a multilink interface.

interfaces multilink <mlx> ip ospf mtu-ignore Disables MTU mismatch detection for OSPF on a multilink interface.

interfaces multilink <mlx> ip ospf network <type> Specifies the network type for OSPF on a multilink interface.

interfaces multilink <mlx> ip ospf priority <priority> Sets the priority for OSPF on a multilink interface.

interfaces multilink <mlx> ip ospf retransmit-interval <interval>

Sets the retransmit interval for OSPF on a multilink interface.

interfaces multilink <mlx> ip ospf transmit-delay <delay>

Specifies the transmit delay for OSPF on a multilink interface.

Operational Commands

None.

Page 405: Vyatta - OSPF

Chapter 13: Multilink Interfaces Multilink Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

384

interfaces multilink <mlx> ip ospfEnables OSPF on a multilink interface.

Syntax

set interfaces multilink mlx ip ospf

delete interfaces multilink mlx ip ospf

show interfaces multilink mlx ip ospf

Command Mode

Configuration mode.

Configuration Statement

interfaces {multilink ml0..ml23 {

ip {ospf {

}}

}

Parameters

Default

None.

Usage Guidelines

Use this command to enable the Open Shortest Path First (OSPF) routing protocol on a multilink interface.

Use the set form of this command to enable OSPF on a multilink interface.

Use the delete form of this command to remove all OSPF configuration and disable OSPF on a multilink interface.

mlx Mandatory. The identifier of the multilink bundle. You can create up to two multilink bundles. Supported values are ml0 (“em ell zero”) through ml23 (“em ell twenty-three”).

Page 406: Vyatta - OSPF

Chapter 13: Multilink Interfaces Multilink Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

385

Use the show form of this command to display OSPF configuration.

Page 407: Vyatta - OSPF

Chapter 13: Multilink Interfaces Multilink Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

386

interfaces multilink <mlx> ip ospf authentication

Specifies the authentication method for OSPF on a multilink interface.

Syntax

set interfaces multilink mlx ip ospf authentication [md5 key-id key-id md5-key md5-key | plaintext-password password]

delete interfaces multilink mlx ip ospf authentication [md5 key-id key-id md5-key | plaintext-password]

show interfaces multilink mlx ip ospf authentication [md5 key-id key-id md5-key | plaintext-password]

Command Mode

Configuration mode.

Configuration Statement

interfaces {multilink ml0..ml23 {

ip {ospf {

authentication {md5 {

key-id 1-255 {md5-key: text

}}plaintext-password: text

}}

}}

}

Parameters

mlx Mandatory. The identifier of the multilink bundle. You can create up to two multilink bundles. Supported values are ml0 (“em ell zero”) through ml23 (“em ell twenty-three”).

Page 408: Vyatta - OSPF

Chapter 13: Multilink Interfaces Multilink Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

387

Default

None.

Usage Guidelines

Use this command to specify the authentication method to be used for OSPF on a multilink interface. This authentication is independent of the authentication configured for the OSPF area.

In plain text authentication, passwords are sent through the network in plain text. In MD5 authentication, the system uses the Message Digest 5 (MD5) algorithm to compute a hash value from the contents of the OSPF packet and the password. The hash value and the MD5 key are included in the transmitted packet, and the receiving system (configured with the same password) calculates its own hash function, which must match.

The authentication parameters must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not consider establish adjacencies, and will disregard one another’s communications.

Use the set form of this command to set the authentication for a multilink interface.

Use the delete form of this command to remove multilink interface authentication configuration information.

Use the show form of this command to display multilink interface authentication configuration information.

key-id Optional. The key used to identify the MD5 key. This must be the same on both the sending and receiving systems. The range is 1 to 255.

md5-key Optional. A password-like MD5 key of up to 16 alphanumeric characters to be used as input to the MD5 hashing algorithm. The longer the key, the stronger the security. This must be the same on both the sending and receiving systems.

password Optional. The password to use in plain-text authentication. This must be eight characters or less and the same on both the sending and receiving systems.

Page 409: Vyatta - OSPF

Chapter 13: Multilink Interfaces Multilink Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

388

interfaces multilink <mlx> ip ospf bandwidth <bandwidth>

Specifies the bandwidth of a multilink interface for calculating OSPF cost.

Syntax

set interfaces multilink mlx ip ospf bandwidth bandwidth

delete interfaces multilink mlx ip ospf bandwidth

show interfaces multilink mlx ip ospf bandwidth

Command Mode

Configuration mode.

Configuration Statement

interfaces {multilink ml0..ml23 {

ip {ospf {

bandwidth: u32}

}}

}

Parameters

Default

None.

mlx Mandatory. The identifier of the multilink bundle. You can create up to two multilink bundles. Supported values are ml0 (“em ell zero”) through ml23 (“em ell twenty-three”).

bandwidth The bandwidth of the Ethernet interface in kilobits/sec. The range is 1 to 10000000.

Page 410: Vyatta - OSPF

Chapter 13: Multilink Interfaces Multilink Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

389

Usage Guidelines

Use this command to specify the bandwidth of the multiulink interface for the purpose of computing OSPF cost.

Use the set form of this command to specify the bandwidth of the multiulink interface.

Use the delete form of this command to remove the bandwidth parameter.

Use the show form of this command to display the bandwidth configuration.

Page 411: Vyatta - OSPF

Chapter 13: Multilink Interfaces Multilink Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

390

interfaces multilink <mlx> ip ospf cost <cost>Sets the routing cost for OSPF on a multilink interface.

Syntax

set interfaces multilink mlx ip ospf cost cost

delete interfaces multilink mlx ip ospf cost

show interfaces multilink mlx ip ospf cost

Command Mode

Configuration mode.

Configuration Statement

interfaces {multilink ml0..ml23 {

ip {ospf {

cost: u32}

}}

}

Parameters

Default

For details on the default of OSPF cost, please see the Usage Guidelines.

mlx Mandatory. The identifier of the multilink bundle. You can create up to two multilink bundles. Supported values are ml0 (“em ell zero”) through ml23 (“em ell twenty-three”).

cost The link-state metric (OSPF cost) to be advertised in the link-state advertisement (LSA) as the cost of sending packets over the ethernet interface. The range is 1 to 65535.

Page 412: Vyatta - OSPF

Chapter 13: Multilink Interfaces Multilink Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

391

Usage Guidelines

Use this command to manually override the default OSPF cost computed by the system for OSPF run on a multilink interface. You can only assign one cost per interface.

By default, the metric associated with a link is computed as follows:

Cost = 108 / bandwidth

The cost of reaching any destination is the sum of the costs of the individual hops. Costs are always rounded to the nearest integer. Costs lower than 1 are rounded up to 1.

Table 13-1 shows the OSPF costs for some common media types.

The values in Table 13-1 show how OSPF fails to distinguish between interfaces faster than 100 Mbps, for example, between Fast Ethernet (100 Mbps) and Gigabit Ethernet (1000 Mbps) interfaces. If you want to distinguish interfaces equal to or greater than 100 Mbps, you must manually configure the cost of the interface using this command.

Use the set form of this command to specify the OSPF cost for the multilink interface.

Use the delete form of this command to restore the default cost.

Use the show form of this command to display cost configuration.

Table 13-1 OSPF Costs for Common Media Types

Media Type OSPF Cost

56 Kbps 1785

64 Kbps 1562

128 Kbps 781

256 Kbps 390

512 Kbps 195

768 Kbps 130

T1 (1.544 Mbps) 64

E1 (2.048 Mbps) 48

4 Mbps Token Ring 6

10 Mbps Ethernet 10

16 Mbps Token Ring 6

T3 (44.736 Mbps 2

100+ Mbps 1

Page 413: Vyatta - OSPF

Chapter 13: Multilink Interfaces Multilink Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

392

interfaces multilink <mlx> ip ospf dead-interval <interval>

Sets the dead interval for OSPF on a multilink interface.

Syntax

set interfaces multilink mlx ip ospf dead-interval interval

delete interfaces multilink mlx ip ospf dead-interval

show interfaces multilink mlx ip ospf dead-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {multilink ml0..ml23 {

ip {ospf {

dead-interval: u32}

}}

}

Parameters

Default

The dead interval is 4 times the hello interval (40 seconds).

mlx Mandatory. The identifier of the multilink bundle. You can create up to two multilink bundles. Supported values are ml0 (“em ell zero”) through ml23 (“em ell twenty-three”).

interval Specifies the time, in seconds, that this interface should wait to detect hello packets from neighboring routers before declaring the neighbor down. The range is 1 to 65535. The default is 4 times the hello interval.

Page 414: Vyatta - OSPF

Chapter 13: Multilink Interfaces Multilink Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

393

Usage Guidelines

Use this command to specify the interval during which a multilink interface should expect an OSPF hello packet from its neighbor.

If the dead interval passes without the interface receiving a hello packet from the neighbor, the neighbor’s status is changed to out-of-service, and all associated state is cleared.

The dead interval must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not establish adjacencies and will disregard one another’s communications.

Use the set form of this command to specify the dead interval.

Use the delete form of this command to restore the default dead interval.

Use the show form of this command to display dead interval configuration.

Page 415: Vyatta - OSPF

Chapter 13: Multilink Interfaces Multilink Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

394

interfaces multilink <mlx> ip ospf hello-interval <interval>

Sets the interval between OSPF hello packets on a multilink interface.

Syntax

set interfaces multilink mlx ip ospf hello-interval interval

delete interfaces multilink mlx ip ospf hello-interval

show interfaces multilink mlx ip ospf hello-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {multilink ml0..ml23 {

ip {ospf {

hello-interval: u32}

}}

}

Parameters

Default

Hello packets are sent every 10 seconds.

mlx Mandatory. The identifier of the multilink bundle. You can create up to two multilink bundles. Supported values are ml0 (“em ell zero”) through ml23 (“em ell twenty-three”).

interval Mandatory. The interval, in seconds, between hello packets. This value must be the same for all nodes on the network.The range is 1 to 65535. The default is 10.

Page 416: Vyatta - OSPF

Chapter 13: Multilink Interfaces Multilink Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

395

Usage Guidelines

Use this command to set the interval at which OSPF hello packets are sent for a multilink interface.

A hello packet is an OSPF packet used to detect and maintain relationships with neighbors on the same network (directly connected routers). The greater the interval between hello packets, the less router traffic occurs, but the longer it takes for topological changes to be detected.

The hello interval must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not establish adjacencies and will disregard one another’s communications.

Use the set form of this command to set the hello interval.

Use the delete form of this command to restore the default hello interval.

Use the show form of this command to display hello interval configuration.

Page 417: Vyatta - OSPF

Chapter 13: Multilink Interfaces Multilink Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

396

interfaces multilink <mlx> ip ospf mtu-ignoreDisables MTU mismatch detection for OSPF on a multilink interface.

Syntax

set interfaces multilink mlx ip ospf mtu-ignore

delete interfaces multilink mlx ip ospf mtu-ignore

show interfaces multilink mlx ip ospf

Command Mode

Configuration mode.

Configuration Statement

interfaces {multilink ml0..ml23 {

ip {ospf {

mtu-ignore}

}}

}

Parameters

Default

MTU mismatch detection is enabled by default.

Usage Guidelines

Use this command to disable MTU mismatch detection on a multilink OSPF interface.

mlx Mandatory. The identifier of the multilink bundle. You can create up to two multilink bundles. Supported values are ml0 (“em ell zero”) through ml23 (“em ell twenty-three”).

Page 418: Vyatta - OSPF

Chapter 13: Multilink Interfaces Multilink Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

397

OSPF sends the MTU of the interface in a database description packet. If the MTUs of OSPF neighbors do not match, they cannot form an OSPF adjacency. MTU mismatch detection detects MTU mismatches and indicates them in the form of a debug message.

MTU mismatch is an important troubleshooting feature. If MTU mismatch is not enabled, MTU mismatches can only be detected by examining configuration for both interfaces.

There are some network setups where MTU mismatches are unavoidable, and even part of the normal set-up. It is for these cases only that MTU mismatch detection should be disabled, so that normal OSPF adjacencies can be formed.

Use the set form of this command to disable MTU mismatch detection.

Use the delete form of this command to re-enable MTU mismatch detection.

Use the show form of this command to display OSPF configuration.

Page 419: Vyatta - OSPF

Chapter 13: Multilink Interfaces Multilink Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

398

interfaces multilink <mlx> ip ospf network <type>Specifies the network type for OSPF on a multilink interface.

Syntax

set interfaces multilink mlx ip ospf network [broadcast | non-broadcast | point-to-multipoint | point-to-point]

delete interfaces multilink mlx ip ospf network

show interfaces multilink mlx ip ospf network

Command Mode

Configuration mode.

Configuration Statement

interfaces {multilink ml0..ml23 {

ip {ospf {

network: text}

}}

}

Parameters

mlx Mandatory. The identifier of the multilink bundle. You can create up to two multilink bundles. Supported values are ml0 (“em ell zero”) through ml23 (“em ell twenty-three”).

type The network type for this interface. Supported values are as follows:

broadcast: The interface supports broadcast mode, such as a LAN link.

non-broadcast: The interface does not support broadcast mode.

point-to-point: This interface supports point-to-point mode, such as an NBMA interface.

point-to-multipoint: This interface supports point-to-multipoint mode, such as a PPP interface or a point-to-point logical interface on Frame Relay.

Page 420: Vyatta - OSPF

Chapter 13: Multilink Interfaces Multilink Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

399

Default

The default is broadcast.

Usage Guidelines

Use this command to configure and display the OSPF network type for a multipoint interface.

Use the set form of this command to specify the network type.

Use the delete form of this command to remove the network type.

Use the show form of this command to display the network type.

Page 421: Vyatta - OSPF

Chapter 13: Multilink Interfaces Multilink Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

400

interfaces multilink <mlx> ip ospf priority <priority>Sets the priority for OSPF on a multilink interface.

Syntax

set interfaces multilink mlx ip ospf priority priority

delete interfaces multilink mlx ip ospf priority

show interfaces multilink mlx ip ospf priority

Command Mode

Configuration mode.

Configuration Statement

interfaces {multilink ml0..ml23 {

ip {ospf {

priority: u32}

}}

}

Parameters

Default

An OSPF interface has a priority of 1.

mlx Mandatory. The identifier of the multilink bundle. You can create up to two multilink bundles. Supported values are ml0 (“em ell zero”) through ml23 (“em ell twenty-three”).

priority Specifies the OSPF router priority for this interface. The range is 0 to 255, where a router with priority 0 can never become the designated router. The default is 1.

Page 422: Vyatta - OSPF

Chapter 13: Multilink Interfaces Multilink Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

401

Usage Guidelines

Use this command to set the OSPF priority for a multilink interface on the broadcast network to which the interface is connected. The priority determines which routers are selected as the area’s Designated Router (DR) and Backup Designated Router (BDR).

The DR and BDR are used to reduce the amount of traffic on OSPF overhead on broadcast networks, by reducing the number of adjacent routers to which a router must flood its topological information. In broadcast networks (such as Ethernet), each router establishes an adjacency with only the DR and the BDR, rather than with every router in its area. The DR and the BDR then flood this information to all other routers on the network segment.

Priority can range from 0 to 255. In general, the router with the highest priority is elected as the DR, and the router with the second-highest priority is elected as the BDR. The higher the number, the higher the priority.

Routers with a priority of 0 are ineligible for election.

Use the set form of this command to specify the OSPF priority.

Use the delete form of this command to restore the default priority.

Use the show form of this command to display priority configuration.

Page 423: Vyatta - OSPF

Chapter 13: Multilink Interfaces Multilink Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

402

interfaces multilink <mlx> ip ospf retransmit-interval <interval>

Sets the retransmit interval for OSPF on a multilink interface.

Syntax

set interfaces multilink mlx ip ospf retransmit-interval interval

delete interfaces multilink mlx ip ospf retransmit-interval

show interfaces multilink mlx ip ospf retransmit-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {multilink ml0..ml23 {

ip {ospf {

retransmit-interval: u32}

}}

}

Parameters

Default

Unacknowledged LSAs are retransmitted at 5-second intervals.

mlx Mandatory. The identifier of the multilink bundle. You can create up to two multilink bundles. Supported values are ml0 (“em ell zero”) through ml23 (“em ell twenty-three”).

interval Specifies the time in seconds to wait for an acknowledgement, after which the system retransmits an LSA packet to its neighbors. The range is 3 to 65535. The default is 5.

Page 424: Vyatta - OSPF

Chapter 13: Multilink Interfaces Multilink Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

403

Usage Guidelines

Use this command to specify how long a multilink interface will wait for an acknowledgment of a link-state update before resending the update.

The link-state update packet is part of the exchange of topology databases between routers. When the initial database description (DD) packet is sent, it contains only the headers of the LSAs. If the receiving router determines that it requires that piece of the OSPF topology, it sends a link state request packet to request the complete LSA from the sending router.

After the update packet is sent, the sending router waits for an acknowledgement, either implicit or explicit, from the receiving router. In an explicit acknowledgement, the receiving router sends a link-state acknowledge (LS-Ack) packet to the router that sent the update. In an implicit acknowledgement, the router that sent the update receives an LSA from the receiving router that contains the update information.

If the retransmit interval passes with neither an explicit nor an implicit acknowledgement, the sending router will retransmit the link-state update packet.

Too high an interval slows network convergence. Too small an interval causes unnecessary retransmission.

Use the set form of this command to set the OSPF retransmit interval for a multilink interface.

Use the delete form of this command to restore the default retransmit interval.

Use the show form of this command to display retransmit interval configuration.

Page 425: Vyatta - OSPF

Chapter 13: Multilink Interfaces Multilink Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

404

interfaces multilink <mlx> ip ospf transmit-delay <delay>

Specifies the transmit delay for OSPF on a multilink interface.

Syntax

set interfaces multilink mlx ip ospf transmit-delay delay

delete interfaces multilink mlx ip ospf transmit-delay

show interfaces multilink mlx ip ospf transmit-delay

Command Mode

Configuration mode.

Configuration Statement

interfaces {multilink ml0..ml23 {

ip {ospf {

transmit-delay: u32}

}}

}

Parameters

Default

Link-state transmits occur at 1-second intervals.

mlx Mandatory. The identifier of the multilink bundle. You can create up to two multilink bundles. Supported values are ml0 (“em ell zero”) through ml23 (“em ell twenty-three”).

delay Mandatory. The delay, in seconds, between link-state transmits. This value must be the same for all nodes on the network. The range is 1 to 65535. The default is 1.

Page 426: Vyatta - OSPF

Chapter 13: Multilink Interfaces Multilink Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

405

Usage Guidelines

Use this command to set the transmit delay for a multilink interface. This is the estimated time required to send a link-state update (LSU) packet.

This timer is used to accommodate transmission and propagation delays on the network, particularly on low-speed networks where delays may be significant. The router increments the age of link-state advertisements in LSU packets to account for these delays.

The value includes both the transmission time and the propagation delay across the network. The transmit delay is added to the age of the LSA packet before the LSA is transmitted The LSA age is used to help the network sequence LSAs, so that it can determine which of competing LSAs is the more recent and trustworthy.

LSAs are numbered in sequence, but the sequence numbers are finite, and so cannot be used as the sole determinant of the most recent LSA. Instead, OSPF also tracks the age of LSAs. Each time the LSA is forwarded to another router, its current age is incremented by the transmit delay. The packet’s age, together with its sequence number, helps the receiving router to determine which version of a received LSA is more recent, and therefore to be used.

Use the set form of this command to set the transmit delay.

Use the delete form of this command to restore the default transmit delay.

Use the show form of this command to display transmit delay configuration.

Page 427: Vyatta - OSPF

406

Chapter 14: Tunnel Interfaces

This chapter describes commands for configuring OSPF on tunnel interfaces.

This chapter presents the following topics:

• Tunnel Interface OSPF Commands

Page 428: Vyatta - OSPF

Chapter 14: Tunnel Interfaces Tunnel Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

407

Tunnel Interface OSPF CommandsThis chapter contains the following commands.

Configuration Commands

interfaces tunnel <tunx> ip ospf Enables OSPF on a tunnel interface.

interfaces tunnel <tunx> ip ospf authentication Specifies the authentication method for OSPF on an Ethernet interface.

interfaces tunnel <tunx> ip ospf bandwidth <bandwidth>

Specifies the bandwidth of a tunnel interface for calculating OSPF cost.

interfaces tunnel <tunx> ip ospf cost <cost> Sets the routing cost for OSPF on a tunnel interface.

interfaces tunnel <tunx> ip ospf dead-interval <interval> Sets the OSPF dead interval for a tunnel interface.

interfaces tunnel <tunx> ip ospf hello-interval <interval> Sets the interval between OSPF hello packets on a tunnel interface.

interfaces tunnel <tunx> ip ospf mtu-ignore Disables MTU mismatch detection for a tunnel interface.

interfaces tunnel <tunx> ip ospf network <type> Specifies the OSPF network type for a tunnel interface.

interfaces tunnel <tunx> ip ospf priority <priority> Sets the OSPF priority for a tunnel interface.

interfaces tunnel <tunx> ip ospf retransmit-interval <interval>

Sets the OSPF retransmit interval for a tunnel interface.

interfaces tunnel <tunx> ip ospf transmit-delay <delay> Specifies the OSPF transmit delay for a tunnel interface.

Operational Commands

None.

Page 429: Vyatta - OSPF

Chapter 14: Tunnel Interfaces Tunnel Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

408

interfaces tunnel <tunx> ip ospfEnables OSPF on a tunnel interface.

Syntax

set interfaces tunnel tunx ip ospf

delete interfaces tunnel tunx ip ospf

show interfaces tunnel tunx ip ospf

Command Mode

Configuration mode.

Configuration Statement

interfaces {tunnel tun0..tun9 {

ip {ospf

}}

}

Parameters

Default

None.

Usage Guidelines

Use this command to enable the Open Shortest Path First (OSPF) routing protocol on a tunnel interface.

Use the set form of this command to enable OSPF on an interface.

Use the delete form of this command to remove all OSPF configuration and disable OSPF on an interface.

Use the show form of this command to display OSPF configuration.

tunx Mandatory. The name of the tunnel interface you are configuring. The range is tun0 to tun9.

Page 430: Vyatta - OSPF

Chapter 14: Tunnel Interfaces Tunnel Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

409

interfaces tunnel <tunx> ip ospf authentication

Specifies the authentication method for OSPF on an Ethernet interface.

Syntax

set interfaces tunnel tunx ip ospf authentication [md5 key-id key-id md5-key md5-key | plaintext-password password]

delete interfaces tunnel tunx ip ospf authentication [md5 key-id key-id md5-key | plaintext-password]

show interfaces tunnel tunx ip ospf authentication [md5 key-id key-id md5-key | plaintext-password]

Command Mode

Configuration mode.

Configuration Statement

interfaces {tunnel tun0..tun9 {

ip {ospf {

authentication {md5 {

key-id 1-255 {md5-key: text

}}plaintext-password: text

}}

}}

}

Parameters

tunx Mandatory. The name of the tunnel interface you are configuring. The range is tun0 to tun9.

key-id Optional. The key used to identify the MD5 key. This must be the same on both the sending and receiving systems. The range is 1 to 255.

Page 431: Vyatta - OSPF

Chapter 14: Tunnel Interfaces Tunnel Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

410

Default

None.

Usage Guidelines

Use this command to specify the authentication method to be used for OSPF on a tunnel interface. This authentication is independent of the authentication configured for the OSPF area.

In plain text authentication, passwords are sent through the network in plain text. In MD5 authentication, the system uses the Message Digest 5 (MD5) algorithm to compute a hash value from the contents of the OSPF packet and the password. The hash value and the MD5 key are included in the transmitted packet, and the receiving system (configured with the same password) calculates its own hash function, which must match.

The authentication parameters must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not consider establish adjacencies, and will disregard one another’s communications.

Use the set form of this command to set the authentication for a tunnel interface.

Use the delete form of this command to remove interface authentication configuration information.

Use the show form of this command to display interface authentication configuration information.

md5-key Optional. A password-like MD5 key of up to 16 alphanumeric characters to be used as input to the MD5 hashing algorithm. The longer the key, the stronger the security. This must be the same on both the sending and receiving systems.

password Optional. The password to use in plain-text authentication. This must be eight characters or less and the same on both the sending and receiving systems.

Page 432: Vyatta - OSPF

Chapter 14: Tunnel Interfaces Tunnel Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

411

interfaces tunnel <tunx> ip ospf bandwidth <bandwidth>

Specifies the bandwidth of a tunnel interface for calculating OSPF cost.

Syntax

set interfaces tunnel tunx ip ospf bandwidth bandwidth

delete interfaces tunnel tunx ip ospf bandwidth

show interfaces tunnel tunx ip ospf bandwidth

Command Mode

Configuration mode.

Configuration Statement

interfaces {tunnel tun0..tun9 {

ip {ospf {

bandwidth: u32}

}}

}

Parameters

Default

None.

tunx Mandatory. The name of the tunnel interface you are configuring. The range is tun0 to tun9.

bandwidth The bandwidth of the Ethernet interface in kilobits/sec. The range is 1 to 10000000.

Page 433: Vyatta - OSPF

Chapter 14: Tunnel Interfaces Tunnel Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

412

Usage Guidelines

Use this command to specify the bandwidth of the tunnel interface for the purpose of computing OSPF cost.

Use the set form of this command to specify the bandwidth of the interface.

Use the delete form of this command to remove the bandwidth parameter.

Use the show form of this command to display the bandwidth configuration.

Page 434: Vyatta - OSPF

Chapter 14: Tunnel Interfaces Tunnel Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

413

interfaces tunnel <tunx> ip ospf cost <cost>Sets the routing cost for OSPF on a tunnel interface.

Syntax

set interfaces tunnel tunx ip ospf cost cost

delete interfaces tunnel tunx ip ospf cost

show interfaces tunnel tunx ip ospf cost

Command Mode

Configuration mode.

Configuration Statement

interfaces {tunnel tun0..tun9 {

ip {ospf {

cost: u32}

}}

}

Parameters

Default

For details on the default of OSPF cost, please see the Usage Guidelines.

tunx Mandatory. The name of the tunnel interface you are configuring. The range is tun0 to tun9.

cost The link-state metric (OSPF cost) to be advertised in the link-state advertisement (LSA) as the cost of sending packets over the ethernet interface. The range is 1 to 65535.

Page 435: Vyatta - OSPF

Chapter 14: Tunnel Interfaces Tunnel Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

414

Usage Guidelines

Use this command to manually override the default OSPF cost computed by the system for a tunnel interface. You can only assign one cost per interface.

By default, the metric associated with a link is computed as follows:

Cost = 108 / bandwidth

The cost of reaching any destination is the sum of the costs of the individual hops. Costs are always rounded to the nearest integer. Costs lower than 1 are rounded up to 1.

Table 14-1 shows the OSPF costs for some common media types.

The values in Table 14-1 show how OSPF fails to distinguish between interfaces faster than 100 Mbps, for example, between Fast Ethernet (100 Mbps) and Gigabit Ethernet (1000 Mbps) interfaces. If you want to distinguish interfaces equal to or greater than 100 Mbps, you must manually configure the cost of the interface using this command.

Use the set form of this command to specify the OSPF cost for the interface.

Use the delete form of this command to restore the default cost.

Use the show form of this command to display cost configuration.

Table 14-1 OSPF Costs for Common Media Types

Media Type OSPF Cost

56 Kbps 1785

64 Kbps 1562

128 Kbps 781

256 Kbps 390

512 Kbps 195

768 Kbps 130

T1 (1.544 Mbps) 64

E1 (2.048 Mbps) 48

4 Mbps Token Ring 6

10 Mbps Ethernet 10

16 Mbps Token Ring 6

T3 (44.736 Mbps 2

100+ Mbps 1

Page 436: Vyatta - OSPF

Chapter 14: Tunnel Interfaces Tunnel Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

415

interfaces tunnel <tunx> ip ospf dead-interval <interval>

Sets the OSPF dead interval for a tunnel interface.

Syntax

set interfaces tunnel tunx ip ospf dead-interval interval

delete interfaces tunnel tunx ip ospf dead-interval

show interfaces tunnel tunx ip ospf dead-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {tunnel tun0..tun9 {

ip {ospf {

dead-interval: u32}

}}

}

Parameters

Default

The dead interval is 4 times the hello interval.

tunx Mandatory. The name of the tunnel interface you are configuring. The range is tun0 to tun9.

interval Specifies the time, in seconds, that this interface should wait to detect hello packets from neighboring routers before declaring the neighbor down. The range is 1 to 65535. The default is 4 times the hello interval.

Page 437: Vyatta - OSPF

Chapter 14: Tunnel Interfaces Tunnel Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

416

Usage Guidelines

Use this command to specify the interval during which a tunnel interface should expect a hello packet from its neighbor.

If the dead interval passes without the interface receiving a hello packet from the neighbor, the neighbor’s status is changed to out-of-service, and all associated state is cleared.

The dead interval must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not establish adjacencies and will disregard one another’s communications.

Use the set form of this command to specify the dead interval.

Use the delete form of this command to restore the default dead interval.

Use the show form of this command to display dead interval configuration.

Page 438: Vyatta - OSPF

Chapter 14: Tunnel Interfaces Tunnel Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

417

interfaces tunnel <tunx> ip ospf hello-interval <interval>

Sets the interval between OSPF hello packets on a tunnel interface.

Syntax

set interfaces tunnel tunx ip ospf hello-interval interval

delete interfaces tunnel tunx ip ospf hello-interval

show interfaces tunnel tunx ip ospf hello-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {tunnel tun0..tun9 {

ip {ospf {

hello-interval: u32}

}}

}

Parameters

Default

Hello packets are sent every 10 seconds.

tunx Mandatory. The name of the tunnel interface you are configuring. The range is tun0 to tun9.

interval Mandatory. The interval, in seconds, between hello packets. This value must be the same for all nodes on the network.The range is 1 to 65535. The default is 10.

Page 439: Vyatta - OSPF

Chapter 14: Tunnel Interfaces Tunnel Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

418

Usage Guidelines

Use this command to set the interval at which OSPF hello packets are sent for a tunnel interface.

A hello packet is an OSPF packet used to detect and maintain relationships with neighbors on the same network (directly connected routers). The greater the interval between hello packets, the less router traffic occurs, but the longer it takes for topological changes to be

detected.

The hello interval must be the same for all routers that are to establish two-way communication within a network. If two routers do not agree on these parameters, they will not establish adjacencies and will disregard one another’s communications.

Use the set form of this command to set the hello interval.

Use the delete form of this command to restore the default hello interval.

Use the show form of this command to display hello interval configuration.

Page 440: Vyatta - OSPF

Chapter 14: Tunnel Interfaces Tunnel Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

419

interfaces tunnel <tunx> ip ospf mtu-ignoreDisables MTU mismatch detection for a tunnel interface.

Syntax

set interfaces tunnel tunx ip ospf mtu-ignore

delete interfaces tunnel tunx ip ospf mtu-ignore

show interfaces tunnel tunx ip ospf

Command Mode

Configuration mode.

Configuration Statement

interfaces {tunnel tun0..tun9 {

ip {ospf {

mtu-ignore}

}}

}

Parameters

Default

MTU mismatch detection is enabled by default.

Usage Guidelines

Use this command to disable MTU mismatch detection on an OSPF interface.

OSPF sends the MTU of the interface in a database description packet. If the MTUs of OSPF neighbors do not match, they cannot form an OSPF adjacency. MTU mismatch detection detects MTU mismatches and indicates them in the form of a debug message.

tunx Mandatory. The name of the tunnel interface you are configuring. The range is tun0 to tun9.

Page 441: Vyatta - OSPF

Chapter 14: Tunnel Interfaces Tunnel Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

420

MTU mismatch is an important troubleshooting feature. If MTU mismatch is not enabled, MTU mismatches can only be detected by examining configuration for both interfaces.

There are some network setups where MTU mismatches are unavoidable, and even part of the normal set-up. It is for these cases only that MTU mismatch detection should be disabled, so that normal OSPF adjacencies can be formed.

Use the set form of this command to disable MTU mismatch detection.

Use the delete form of this command to re-enable MTU mismatch detection.

Use the show form of this command to display OSPF configuration.

Page 442: Vyatta - OSPF

Chapter 14: Tunnel Interfaces Tunnel Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

421

interfaces tunnel <tunx> ip ospf network <type>Specifies the OSPF network type for a tunnel interface.

Syntax

set interfaces tunnel tunx ip ospf network [broadcast | non-broadcast | point-to-multipoint | point-to-point]

delete interfaces tunnel tunx ip ospf network

show interfaces tunnel tunx ip ospf network

Command Mode

Configuration mode.

Configuration Statement

interfaces {tunnel tun0..tun9 {

ip {ospf {

network: text}

}}

}

Parameters

tunx Mandatory. The name of the tunnel interface you are configuring. The range is tun0 to tun9.

type The network type for this interface. Supported values are as follows:

broadcast: The interface supports broadcast mode, such as a LAN link.

non-broadcast: The interface does not support broadcast mode.

point-to-point: This interface supports point-to-point mode, such as an NBMA interface.

point-to-multipoint: This interface supports point-to-multipoint mode, such as a PPP interface or a point-to-point logical interface on Frame Relay.

The default is broadcast.

Page 443: Vyatta - OSPF

Chapter 14: Tunnel Interfaces Tunnel Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

422

Default

Broadcast is supported.

Usage Guidelines

Use this command to configure and display the network type for the interface.

Use the set form of this command to specify the network type.

Use the delete form of this command to remove the network type.

Use the show form of this command to display the network type.

Page 444: Vyatta - OSPF

Chapter 14: Tunnel Interfaces Tunnel Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

423

interfaces tunnel <tunx> ip ospf priority <priority>Sets the OSPF priority for a tunnel interface.

Syntax

set interfaces tunnel tunx ip ospf priority priority

delete interfaces tunnel tunx ip ospf priority

show interfaces tunnel tunx ip ospf priority

Command Mode

Configuration mode.

Configuration Statement

interfaces {tunnel tun0..tun9 {

ip {ospf {

priority: u32}

}}

}

Parameters

Default

An OSPF interface has a priority of 1.

tunx Mandatory. The name of the tunnel interface you are configuring. The range is tun0 to tun9.

priority Specifies the OSPF router priority for this interface. The range is 0 to 255, where a router with priority 0 can never become the designated router. The default is 1.

Page 445: Vyatta - OSPF

Chapter 14: Tunnel Interfaces Tunnel Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

424

Usage Guidelines

Use this command to set the priority for a tunnel interface on the broadcast network to which the interface is connected. The priority determines which routers are selected as the area’s Designated Router (DR) and Backup Designated Router (BDR).

The DR and BDR are used to reduce the amount of traffic on OSPF overhead on broadcast networks, by reducing the number of adjacent routers to which a router must flood its topological information. In broadcast networks (such as Ethernet), each router establishes an adjacency with only the DR and the BDR, rather than with every router in its area. The DR and the BDR then flood this information to all other routers on the network segment.

Priority can range from 0 to 255. In general, the router with the highest priority is elected as the DR, and the router with the second-highest priority is elected as the BDR. The higher the number, the higher the priority.

Routers with a priority of 0 are ineligible for election.

Use the set form of this command to specify the OSPF priority.

Use the delete form of this command to restore the default priority.

Use the show form of this command to display priority configuration.

Page 446: Vyatta - OSPF

Chapter 14: Tunnel Interfaces Tunnel Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

425

interfaces tunnel <tunx> ip ospf retransmit-interval <interval>

Sets the OSPF retransmit interval for a tunnel interface.

Syntax

set interfaces tunnel tunx ip ospf retransmit-interval interval

delete interfaces tunnel tunx ip ospf retransmit-interval

show interfaces tunnel tunx ip ospf retransmit-interval

Command Mode

Configuration mode.

Configuration Statement

interfaces {tunnel tun0..tun9 {

ip {ospf {

retransmit-interval: u32}

}}

}

Parameters

Default

Unacknowledged LSAs are retransmitted at 5-second intervals.

tunx Mandatory. The name of the tunnel interface you are configuring. The range is tun0 to tun9.

interval Specifies the time in seconds to wait for an acknowledgement, after which the system retransmits an LSA packet to its neighbors. The range is 3 to 65535. The default is 5.

Page 447: Vyatta - OSPF

Chapter 14: Tunnel Interfaces Tunnel Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

426

Usage Guidelines

Use this command to specify how long a tunnel interface will wait for an acknowledgment of a link-state update before resending the update.

The link-state update packet is part of the exchange of topology databases between routers. When the initial database description (DD) packet is sent, it contains only the headers of the LSAs. If the receiving router determines that it requires that piece of the OSPF topology, it sends a link state request packet to request the complete LSA from the sending router.

After the update packet is sent, the sending router waits for an acknowledgement, either implicit or explicit, from the receiving router. In an explicit acknowledgement, the receiving router sends a link-state acknowledge (LS-Ack) packet to the router that sent the update. In an implicit acknowledgement, the router that sent the update receives an LSA from the receiving router that contains the update information.

If the retransmit interval passes with neither an explicit nor an implicit acknowledgement, the sending router will retransmit the link-state update packet.

Too high an interval slows network convergence. Too small an interval causes unnecessary retransmission.

Use the set form of this command to set the OSPF retransmit interval for a tunnel interface.

Use the delete form of this command to restore the default retransmit interval.

Use the show form of this command to display retransmit interval configuration.

Page 448: Vyatta - OSPF

Chapter 14: Tunnel Interfaces Tunnel Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

427

interfaces tunnel <tunx> ip ospf transmit-delay <delay>Specifies the OSPF transmit delay for a tunnel interface.

Syntax

set interfaces tunnel tunx ip ospf transmit-delay delay

delete interfaces tunnel tunx ip ospf transmit-delay

show interfaces tunnel tunx ip ospf transmit-delay

Command Mode

Configuration mode.

Configuration Statement

interfaces {tunnel tun0..tun9 {

ip {ospf {

transmit-delay: u32}

}}

}

Parameters

Default

Link-state transmits occur at 1-second intervals.

tunx Mandatory. The name of the tunnel interface you are configuring. The range is tun0 to tun9.

delay Mandatory. The delay, in seconds, between link-state transmits. This value must be the same for all nodes on the network. The range is 1 to 65535. The default is 1.

Page 449: Vyatta - OSPF

Chapter 14: Tunnel Interfaces Tunnel Interface OSPF Commands

OSPF Rel VC5 v. 03 Vyatta

428

Usage Guidelines

Use this command to set the transmit delay for a tunnel interface. This is the estimated time required to send a link-state update (LSU) packet.

This timer is used to accommodate transmission and propagation delays on the network, particularly on low-speed networks where delays may be significant. The router increments the age of link-state advertisements in LSU packets to account for these delays.

The value includes both the transmission time and the propagation delay across the network. The transmit delay is added to the age of the LSA packet before the LSA is transmitted The LSA age is used to help the network sequence LSAs, so that it can determine which of competing LSAs is the more recent and trustworthy.

LSAs are numbered in sequence, but the sequence numbers are finite, and so cannot be used as the sole determinant of the most recent LSA. Instead, OSPF also tracks the age of LSAs. Each time the LSA is forwarded to another router, its current age is incremented by the transmit delay. The packet’s age, together with its sequence number, helps the receiving router to determine which version of a received LSA is more recent, and therefore to be used.

Use the set form of this command to set the transmit delay.

Use the delete form of this command to restore the default transmit delay.

Use the show form of this command to display transmit delay configuration.

Page 450: Vyatta - OSPF

429

Glossary of Acronyms

ACL access control list

ADSL Asymmetric Digital Subscriber Line

AS autonomous system

ARP Address Resolution Protocol

BGP Border Gateway Protocol

BIOS Basic Input Output System

BPDU Bridge Protocol Data Unit

CA certificate authority

CHAP Challenge Handshake Authentication Protocol

CLI command-line interface

DDNS dynamic DNS

DHCP Dynamic Host Configuration Protocol

DLCI data-link connection identifier

DMI desktop management interface

DMZ demilitarized zone

DNS Domain Name System

DSCP Differentiated Services Code Point

DSL Digital Subscriber Line

eBGP external BGP

EGP Exterior Gateway Protocol

Page 451: Vyatta - OSPF

OSPF Rel VC5 v. 03 Vyatta

430

ECMP equal-cost multipath

ESP Encapsulating Security Payload

FIB Forwarding Information Base

FTP File Transfer Protocol

GRE Generic Routing Encapsulation

HDLC High-Level Data Link Control

I/O Input/Ouput

ICMP Internet Control Message Protocol

IDS Intrusion Detection System

IEEE Institute of Electrical and Electronics Engineers

IGP Interior Gateway Protocol

IPS Intrusion Protection System

IKE Internet Key Exchange

IP Internet Protocol

IPOA IP over ATM

IPsec IP security

IPv4 IP Version 4

IPv6 IP Version 6

ISP Internet Service Provider

L2TP Layer 2 Tunneling Protocol

LACP Link Aggregation Control Protocol

LAN local area network

MAC medium access control

MIB Management Information Base

MLPPP multilink PPP

MRRU maximum received reconstructed unit

MTU maximum transmission unit

Page 452: Vyatta - OSPF

OSPF Rel VC5 v. 03 Vyatta

431

NAT Network Address Translation

ND Neighbor Discovery

NIC network interface card

NTP Network Time Protocol

OSPF Open Shortest Path First

OSPFv2 OSPF Version 2

OSPFv3 OSPF Version 3

PAM Pluggable Authentication Module

PAP Password Authentication Protocol

PCI peripheral component interconnect

PKI Public Key Infrastructure

PPP Point-to-Point Protocol

PPPoA PPP over ATM

PPPoE PPP over Ethernet

PPTP Point-to-Point Tunneling Protocol

PVC permanent virtual circuit

QoS quality of service

RADIUS Remote Authentication Dial-In User Service

RIB Routing Information Base

RIP Routing Information Protocol

RIPng RIP next generation

Rx receive

SNMP Simple Network Management Protocol

SONET Synchronous Optical Network

SSH Secure Shell

STP Spanning Tree Protocol

TACACS+ Terminal Access Controller Access Control System Plus

Page 453: Vyatta - OSPF

OSPF Rel VC5 v. 03 Vyatta

432

TCP Transmission Control Protocol

ToS Type of Service

Tx transmit

UDP User Datagram Protocol

vif virtual interface

VLAN virtual LAN

VPN Virtual Private Network

VRRP Virtual Router Redundancy Protocol

WAN wide area network