The term “router”
in this document refers to a router in a generic sense or a Layer 3 switch. To
improve readability, this will not be described in the present manual again.
Syntax
delete static-routes all
View
System view
Parameter
None
Description
Use the delete static-routes all
command to delete all static routes.
When you use this command to delete static
routes, the system will prompt you to confirm the operation before all the
configured static routes.
Related command: ip route-static and display ip routing-table.
Example
# Delete all static routers on the router.
<Sysname> system-view
[Sysname] delete static-routes all
This will erase all ipv4 static
routes and their configurations, you must reconfigure all static
routes
Are you sure?[Y/N]:y
1.1.2 ip
route-static
Syntax
ip route-static
ip-address { mask | mask-length } interface-type interface-number
[ preference preference ] [ tag tag-value ] [ description
description-text ]
undo ip
route-static ip-address { mask | mask-length } interface-type
interface-number [ preference preference ]
View
System view
Parameter
ip-address:
Destination IP address of the static route, in dotted decimal notation.
mask: Mask
of the corresponding IP address, in dotted decimal notation.
mask-length:
Mask length. Because a 32-bit mask must contain contiguous 1’s, a dotted
decimal mask can appear in the form of mask length.
interface-type
interface-number: Specifies the output interface by
its type and number. If the output interface is a broadcast interface, such as a
virtual template or a VLAN interface, the next hop address must be specified.
preference preference:
Specifies the preference of the static route, which is in the range of 1 to 255
and defaults to 60.
description description-text: Sets the description
information of the static route, which consists of 1 to 60 characters,
including special characters like space, but excluding “?”.
tag tag-value:
Sets the tag value of the static route, which is in the range of 1 to
4294967295 . The default tag value of the static route is 0.
Description
Use the ip route-static command to
configure a unicast static route.
Use the undo ip route-static command
to delete a unicast static route.
When configuring a unicast static route,
note that:
1)
If the destination IP address and the mask are
both 0.0.0.0, the configured route is a default route. If routing table
searching fails, the router will use the default route for packet forwarding.
2)
When configuring a static route, you can specify
the output interface or the next hop address based on the actual requirement.
Note that the next hop address must not be the IP address of the local
interface; otherwise, the route configuration will not take effect. When
specifying the output interface, note that:
l
For a NULL0 or loopback interface, if the output
interface has already been configured, there is no need to configure the next
hop address.
l
It is not recommended to specify a broadcast
interface (such as an Ethernet interface, virtual template, or VLAN interface)
as the output interface for a static route, because a broadcast interface may have
multiple next hops. If you have to do so, you must specify the corresponding
next hop of the interface at the same time.
Related command: display ip
routing-table and ip route-static
default-preference.
Example
# Configure the next hop of the default
route as 129.102.0.2.
<Sysname> system-view
[Sysname] ip route-static 0.0.0.0
0.0.0.0 129.102.0.2
# Specify the description of the static
route as "for internet & intranet".
<Sysname> system-view
[Sysname] ip route-static 3.3.3.3 24
4.4.4.4 description for internet & intranet
[Sysname] display
current-configuration
……<omitted>
#
ip route-static 3.3.3.0 255.255.255.0
4.4.4.4 description for internet & intranet
#
return
# Configure the tag value of the static
route as 45 and the description of the static route as "test"
<Sysname> system-view
[Sysname]ip route-static 1.1.1.1 24
2.2.2.2 tag 45 description test
1.1.3 ip route-static default-preference
Syntax
ip route-static default-preference default-preference-value
undo ip route-static default-preference
View
System view
Parameter
default-preference-value: Default preference of the static route, which is in the range of 1
to 255.
Description
Use the ip route-static
default-preference command to configure the default preference for static
routes.
Use the undo ip route-static
default-preference command to restore the default preference to the default
value.
By default, the default preference for
static routes is 60.
Note that:
l
If no preference is specified when configuring a
static route, the default preference is used.
l
When the default preference is re-configured, it
applies to newly added static routes only.
Related command: display ip
routing-table and ip route-static.
Example
# Set the default preference of static
routes to 20.
<Sysname> system-view
[Sysname] ip route-static
default-preference 120
The term router in
this document refers to a router in a generic sense or a Layer 3 switch. To
improve readability, this will not be described in the present manual again.
Syntax
checkzero
undo checkzero
View
RIP view
Parameter
None
Description
Use the checkzero command to enable
the zero zone check on RIP-1 messages.
Use the undo checkzero command to
disable the zero zone check.
The zero zone check is enabled by default.
After the zero field check is enabled, the
router discards RIP-1 messages in which zero fields are non-zero. If all
messages are trusty, you can disable this feature to spare the processing time
of the CPU.
Example
# Disable the zero zone check on RIP-1
message.
<Sysname> system-view
[Sysname] rip 100
[Sysname-rip-100] undo checkzero
2.1.2 default cost
Syntax
default cost value
undo default cost
View
RIP view
Parameter
value:
Specifies the routing cost, in the range 0 to 16, 0 is the default value.
Description
Use the default cost command to configure
the default metric for redistributed routes.
Use the undo default cost command to
restore the default.
By default, the default metric of
redistributed routes is 0.
When you use the import-route
command to redistribute routes from other protocols without specifying a
metric, the metric specified by the default cost command applies.
Related command: import-route.
Example
# Set the cost of the imported route to 3.
<Sysname> system-view
[Sysname] rip 100
[Sysname-rip-100] default cost 3
Syntax
default-route originate cost value
undo default-route originate
View
RIP view
Parameter
value:
Specifies the originate routing cost, in the range 1 to 15.
Description
Use the default-route originate cost
command to advertise a default route with the specified metric to RIP neighbors.
Use the undo default-route originate
command to disable the sending of a default route.
By default, no default route is sent to RIP
neighbors.
The RIP router with this feature configured
will not receive any default routes from RIP neighbors.
Example
# Send a default route with a metric of 2
to RIP neighbors.
<Sysname> system-view
[Sysname] rip 100
[Sysname-rip-100] default-route
originate cost 2
# Remove the originate default route
[Sysname-rip-100] undo default-route
originate
Syntax
display rip
[ process-id ]
View
Any view
Parameter
process-id: RIP
process number, in the range 1 to 65535.
Description
Use the display rip command to display
the current status and configuration information of a RIP process.
Example
# Display the current status and
configuration information of a RIP process.
<Sysname>display rip
RIP process : 1
RIP version : 1
Preference : 100
Checkzero : Enabled
Default-cost : 0
Summary : Enabled
Hostroutes : Enabled
Maximum number of balanced
paths : 1
Update time : 30 sec(s)
Timeout time : 180 sec(s)
Suppress time : 120 sec(s)
Garbage-collect time : 240 sec(s)
Silent interfaces : None
Default routes : Disabled
Verify-source : Enabled
Networks :
10.0.0.0
Configured peers : None
Triggered updates sent : 0
Number of routes changes : 1
Number of replies to queries :
0
Table 2-1 Description
on the fields of the display rip command
|
Field
|
Description
|
|
RIP process
|
RIP process number
|
|
RIP version
|
RIP version 1 or 2
|
|
Preference
|
RIP process priority
|
|
Checkzero
|
Indicates whether the zero field check is
enabled for RIP-1 messages.
|
|
Default-cost
|
Default cost of the redistributed routes
|
|
Summary
|
Indicates whether the routing summarization
is enabled
|
|
Hostroutes
|
Indicates whether to receive host routes
|
|
Maximum number of balanced paths
|
The Maximum number of balanced paths
|
|
Update time
|
RIP updating interval
|
|
Timeout time
|
RIP timeout interval
|
|
Suppress time
|
RIP suppress interval
|
|
Garbage collect time
|
RIP garbage collection interval
|
|
Silent interfaces
|
The number of silent interfaces, which do
not periodically send updating messages.
|
|
Default routes
|
Indicates whether a default route is sent
to RIP neighbors
|
|
Validate-source-address
|
Indicates whether the source IP address
is checked on the received RIP routing updates
|
|
Networks
|
Networks enabled with RIP
|
|
Configured peers
|
Configured neighbors
|
|
Triggered updates sent
|
The number of sent triggered updates
|
|
Number of routes changes
|
The number of changed routes
|
|
Number of replies to queries
|
The number of respond queries of RIP
requests
|
Syntax
display rip process-id
database
View
Any view
Parameter
process-id:
RIP process number, in the range 1 to 65535.
Description
Use the display rip database
command to display the active routes in the RIP announced database, which are
send in regular RIP updating messages.
Example
# Display the active routes in the database
of RIP process 100.
<Sysname> display rip 1
database
10.0.0.0/8, cost 0, ClassfulSumm
10.0.0.0/8, cost 0, nexthop
10.0.0.1, Rip-interface
12.0.0.0/8, cost 1, ClassfulSumm
12.0.0.0/8, cost 1, nexthop
10.0.0.2
Table 2-2 Description on fields of the display
rip database command
|
Field
|
Description
|
|
X.X.X.X/X
|
Destination address and subnet mask
|
|
cost
|
Cost of the route
|
|
classful-summ
|
Indicates the route is a RIP summary
route.
|
|
Nexthop
|
Address of the next hop
|
|
Rip-interface
|
Routes learnt from a RIP–enabled
interface
|
|
imported
|
Routes redistributed from other routing
protocols
|
Syntax
display rip process-id interface [ interface-type interface-number ]
View
Any view
Parameter
process-id:
RIP process number, in the range 1 to 65535.
interface-type interface-number: Specifies an interface with a type and a number.
Description
Use the display rip interface
command to display the RIP interface information.
Example
# Display the interface information of RIP
process 1.
<Sysname> display rip 1
interface
Interface-name: Ethernet0/1/0
Address/Mask:1.1.1.1/24 MetricIn/Out:0/1 Version: RIPv1
Split-horizon/Poison-reverse:on/off
Input/Output:on/on
Table 2-3
Description on the fields of the display rip
interface command
|
Field
|
Description
|
|
Interface-name
|
The name of an interface running RIP. The
IP address and Mask of the interface are the same as displayed in the
Address/Mask field.
|
|
Address/Mask
|
The IP address and Mask of the interface
running RIP (Enabled by the network command in the RIP view).
|
|
MetrIn/Out
|
Additional routing metric added to the
incoming and outgoing routes
|
|
Version
|
RIP version running on an interface
|
|
Split-horizon
|
Indicates if Split-horizon is enabled (on
is enabled, off is disabled).
|
|
Poison-reverse
|
Indicates if Poison-reverse is enabled
(on is enabled, off is disabled).
|
|
Input/Output
|
Indicates if the interface is allowed to
receive (Input) or send (Output) RIP messages (on is allowed, off is not
allowed).
|
Syntax
display rip process-id route [ statistics | ip-address { mask | mask-length
} | peer ip-address ]
View
Any view
Parameter
process-id:
RIP process number, in the range 1 to 65535.
statistics:
Displays route statistics, including the total number of routes and the number
of routes of each neighbor.
ip-address {
mask | mask-length }: Displays route information about a
specified IP address.
peer ip-address: Displays all the routes learned by the neighbor with the specified
IP address.
Description
Use the display rip route command to
display all active or inactive RIP routes and timers associate to each route.
Example
# Display the route information about RIP
process 1.
<Sysname>display rip 1 route
Route Flags: R - RIP, T - TRIP
P - Permanent, A -
Aging, S - Suppressed, G - Garbage-collect
--------------------------------------------------------------------------
Peer 21.0.0.23 on Vlan-interface10
Destination/Mask Nexthop
Cost Tag Flags Sec
56.0.0.0/8 21.0.0.23
1 0 RA 102
34.0.0.0/8 21.0.0.23
1 0 RA 23
Peer 21.0.0.12 on Vlan-interface10
Destination/Mask
Nexthop Cost Tag Flags Sec
56.0.0.0/8 21.0.0.12
1 0 RA 34
12.0.0.0/8 21.0.0.12
1 0 RA 12
# Display the routes whose destination
address is 56.0.0.0 and whose mask is 8 for RIP process 1.
<Sysname>display rip 1 route
Route Flags: R - RIP, T - TRIP
P - Permanent, A -
Aging, S - Suppressed, G - Garbage-collect
--------------------------------------------------------------------------
Peer 21.0.0.23 on Vlan-interface10
Destination/Mask
Nexthop Cost Tag Flags Sec
56.0.0.0/8 21.0.0.23
1 0 RA 102
Peer 21.0.0.12 on Vlan-interface10
Destination/Mask
Nexthop Cost Tag Flags Sec
56.0.0.0/8 21.0.0.12
1 0 RA 34
# Display the routes that RIP process 1
learned from the specified neighbors.
<Sysname>display rip 1 route
Route Flags: R - RIP, T - TRIP
P - Permanent, A -
Aging, S - Suppressed, G - Garbage-collect
--------------------------------------------------------------------------
Peer 21.0.0.23 on Vlan-interface10
Destination/Mask
Nexthop Cost Tag Flags Sec
56.0.0.0/8 21.0.0.23
1 0 RA 102
34.0.0.0/8 21.0.0.23
1 0 RA 23
Table 2-4 Description on the fields of
the display rip route command
|
Field
|
Description
|
|
Route Flags
|
R — RIP
route
T — TRIP route
P — The route never expired
A — The
route is at the aging time
S — The route is at the suppress
time
G — The route is at Garbage-collect
time
|
|
Peer 21.0.0.23 on Ethernet1/0
|
Routing information learned on a RIP
interface from the specified neighbor
|
|
Nexthop
|
The next hop of the route
|
|
Cost
|
The cost of the route
|
|
Flags
|
Indicates the route state
|
|
Tag
|
Indicates that the information about this
route has changed.
|
|
Sec
|
Remaining time of the timer corresponding
to the route state
|
# Display the route statistics of RIP process 1.
<Sysname>display rip 1 route
statistics
Peer Aging
Permanent Garbage
10.0.0.2 1
0 0
Total 1
0 0
Table 2-5 Description
on the fields of the display rip process-id route statistics
command
|
Field
|
Description
|
|
Peer
|
IP address of neighbor
|
|
Aging
|
Total number of aging routes learned from
the specified neighbor
|
|
Permanent
|
Total number of permanent routes learned
from the specified neighbor
|
|
Garbage
|
Total number of routes in the
garbage-collection state learned from the specified neighbor
|
|
Total
|
Total number of routes learned from the
specified neighbor
|
Syntax
filter-policy { acl-number | ip-prefix ip-prefix-name } export
[ protocol [ process-id ] | interface-type interface-number
]
undo filter-policy export [ protocol [ process-id ] | interface-type
interface-number ]
View
RIP view
Parameter
acl-number:
Number of the Access Control List (ACL) used for filtering outbound routes, in
the range of 2000 to 3999.
ip-prefix-name: Name of the IP prefix list used for filtering outbound routes, a
string of 1 to 19 characters.
protocol:
Protocols can be exported, currently including direct, rip and static.
process-id: Process
number of the specified routing protocol, in the range of 1 to 65535. You need
to specify a process ID when the routing protocol is rip.
interface-type: Interface type
interface-number: Interface number
Description
Use the filter-policy export
command to define a RIP outbound route filtering policy. Only routes not
filtered out can be advertised.
Use the undo filter-policy export
command to restore the default.
By default, RIP does not filter outbound
routes.
Note that:
l
If protocol is specified, RIP filters
only the routes redistributed from the specified routing protocol. Otherwise,
RIP filters all routes to be advertised.
l
If interface-type interface-number is
specified, RIP filters only the routes advertised by the specified interface.
Otherwise, RIP filters routes advertised by all RIP interfaces.
Related command: acl, import-route,
and ip ip-prefix.
Example
# Configure ACL 2000 to filter outbound routes.
<Sysname> system-view
[Sysname] rip 1
[Sysname-rip-1] filter-policy 2000
export
# Configure to filter the RIP route update
packets sent through Vlan-interface 100 according to the address prefix list
named abc.
<Sysname>system-view
[Sysname]rip 1
[Sysname-rip-1]filter-policy
ip-prefix abc export Vlan-interface 100
Syntax
filter-policy { acl-number | ip-prefix ip-prefix-name [ gateway
ip-prefix-name ] | gateway ip-prefix-name } import
[ interface-type interface-number ]
undo filter-policy import [ interface-type interface-number ]
View
RIP view
Parameter
acl-number: Number
of access control list of the filtered route, in the range 2000 to 3999.
ip-prefix ip-prefix-name: References an IP prefix
list to filter received routes. The ip-prefix-name is a string of 1 to
19 characters.
gateway: Sets
the filtering policy for routes from the gateway.
interface-type: Interface type
interface-number: Interface number
Description
Use the filter-policy import
command to filter the imported routes so that only the Use the filter-policy
import command to filter the received routes.
Use the undo filter-policy import
command to restore the default.
By default, RIP does not filter received
routes.
Related command: acl and ip ip-prefix.
Example
# Configure ACL 2000 to filter imported
routes.
<Sysname> system-view
[Sysname] rip 1
[Sysname-rip-1] filter-policy 2000
import
# Configure to filter the RIP route update
packets received through Vlan-interface 100 according to the address prefix
list named abc.
<Sysname>system-view
[Sysname]rip 1
[Sysname-rip-1]filter-policy
ip-prefix abc import Vlan-interface 100
Syntax
host-route
undo host-route
View
RIP view
Parameter
None
Description
Use the host-route command to enable
the router to receive host routes.
Use the undo host-route command to disable
host route reception..
By default, receiving host routes is
enabled.
In some cases, a router may receive many host
routes from the same network segment. These routes are not helpful for routing
and occupy a large amount of network resources. You can use the undo
host-route command to refuse receiving those host routes.
Example
# Disable RIP from receiving host routes.
<Sysname> system-view
[Sysname] rip 1
[Sysname-rip-1] undo host-route
2.1.11 import-route
Syntax
import-route protocol [ cost cost-value
| route-policy route-policy-name | tag
tag-value ]*
undo import-route protocol
View
RIP view
Parameter
protocol:
Protocols can be imported, currently including direct and static.
cost-value: Cost
for redistributed routes, in the range of 0 to 16. If cost-value is not
specified, the default cost specified by the default cost command
applies.
tag-value: Tag
value marking redistributed routes, in the range of 0 to 65,535. The default is
0.
route-policy route-policy-name: Specifies a routing policy with 1 to 19
characters.
Description
Use the import-route command to
import routes and set route attributes. You can set the routing policy to
import specified routes.
Use the undo import-route command to
remove the imported routes.
By default, RIP does not redistribute
routes from other routing protocols.
l
You can specify a routing policy using keyword route-policy
to redistribute only the specified routes.
l
You can configure a cost for redistributed routes
using keyword cost.
l
You can configure a tag value for redistributed
routes using keyword tag.
Related command: default cost.
Example
# Import a static route, and set the cost
to 4.
<Sysname> system-view
[Sysname] rip 1
[Sysname-rip-1] import-route static
cost 4
# Import Static route with a specified
default cost.
[Sysname-rip-1] default cost 3
[Sysname-rip-1] import-route static
2.1.12 network
Syntax
network network-address
undo network
network-address
View
RIP view
Parameter
network-address: IP address of a network segment, which can be the IP network
address of any interface.
Description
Use the network command to enable
RIP on a specified network.
Use the undo network command to
disable RIP on a specified network.
Use the network 0.0.0.0 command to
enable RIP on all interfaces.
RIP is disabled by default.
Example
# Enable RIP on network 129.102.0.0.
<Sysname> system-view
[Sysname] rip 100
[Sysname-rip-100] network 129.102.0.0
Syntax
peer
ip-address
undo peer ip-address
View
RIP view
Parameter
ip-address: Peer
IP address, presented in decimal format.
Description
Use the peer command to define IP
addresses of RIP neighboring routers in the NBMA (Non-Broadcast Multi-Access)
network. After configuring this command, updating messages are unicast to the
peer rather than multicast or broadcast.
Use the undo peer command to remove
peer IP addresses.
By default, no neighbor is specified.
In normal condition, it is not recommended
to use this command. The peer might get the same message by multicast
(broadcast) and unicast. You are recommended to set the related interfaces to
silent mode in combination of this command.
Example
# Assign an IP address to a peer.
<Sysname> system-view
[Sysname] rip 1
[Sysname-rip-1] peer 202.38.165.1
Syntax
preference [
route-policy route-policy-name ] value
undo preference [ route-policy ]
View
RIP view
Parameter
route-policy-name: Routing policy name with 1 to 19 characters.
value: Priority
for RIP route, in the range of 1 to 255. The smaller the value, the higher the
priority.
Description
Use the preference command to specify
the RIP route priority.
Use the undo preference route-policy
command to restore the default.
By default, the priority of RIP route is
100.
You can specify a routing policy using
keyword route-policy to set the specified priority to routes matching
the routing policy.
l
If a priority is set for matched routes in the
routing policy, the priority applies to these routes. The priority of other routes
is the one set by the preference command.
l
If no priority is set for matched routes in the
routing policy, the priority of all routes is the one set by the preference
command.
Example
# Define 120 as the RIP priority.
<Sysname> system-view
[Sysname] rip 1
[Sysname-rip-1] preference 120
2.1.15 reset rip statistics
Syntax
reset rip process-id statistics
View
User view
Parameter
process-id: RIP
process number, in the range 1 to 65535.
Description
Use the reset rip statistics command
to clear the statistics information in specified RIP process.
Example
# Clear statistics information in RIP 100.
<Sysname> reset rip 100 statistics
Syntax
rip [ process-id
]
undo rip [ process-id
]
View
System view
Parameter
process-id: RIP
process number, in the range 1 to 65535, 1 by default.
Description
Use the rip command to create a RIP process
and enter RIP view.
Use the undo rip command to remove the
RIP process.
The RIP process is not created by default.
l
After RIP is disabled, interface parameters are
no longer valid.
l
The configured interface parameters become
invalid after you disable the RIP process.
Example
# Enable RIP and enter RIP view.
<Sysname> system-view
[Sysname] rip
[Sysname-rip-1]
Syntax
rip authentication-mode { simple password | md5 { rfc2453 key-string
| rfc2082 key-string key-id } }
undo rip authentication-mode
