Command Reference Guide

Administering IP Routing

To route packets using the Internet Protocol (IP), you:

Establish an IP routing interface
Decide which IP options and routing protocols you want to use
Enable IP routing

An IP routing interface defines the relationship between an IP virtual LAN (VLAN) and the subnetworks in the IP network. Each routing IP VLAN interface is associated with one VLAN that supports IP. The system has one interface defined for each subnetwork that is directly connected to it. You must first define a VLAN, as described in Chapter 13, before you define an associated IP VLAN interface.

This chapter provides guidelines and other key information about how to configure IP in your system. For information about IP multicast, see Chapter 16. For information about OSPF routing using IP, see Chapter 17.

For more information about IP routing, see the Implementation Guide for your system.

For the CoreBuilder 9000 platform: The commands in this chapter apply to Layer 3 switching modules only.

Menu Structure

The commands that you can use depend on the system that you have, your level of access, and the types of modules and other hardware options that are configured for your system. The following diagram shows the complete list of commands for all systems. See the checklist at the beginning of each command description in this chapter for whether your system supports the command.

ip interface summary

Prompt	Description	Possible Values	[Default]
Interface index	Interface number for which you want to display summary information	One or more selectable interfaces all ? (for a list of selectable interfaces)	-

Fields in the IP Interface Summary Display

Field

Description

Index

Number associated with the interface

IP address

IP address of the interface, chosen from the range of addresses assigned to your organization by the central agency. This address is specific to your network and system.

State

State of the IP interface. It indicates whether the interface is available for communications (up) or unavailable (down).

Subnet mask

32-bit number that uses the same format and representation as an IP address. The subnet mask determines which bits in the IP address are interpreted as the network number, the subnet number, and the host number. Each IP address bit that corresponds to a 1 in the subnet mask is in the network/subnet part of the address. Each IP address bit that corresponds to a 0 is in the host part of the IP address.

Type

Type of interface (for example, VLAN)

VLAN index

Number of the IP VLAN that is associated with the IP interface.

Field	Description
Index	Number associated with the interface
IP address	IP address of the interface, chosen from the range of addresses assigned to your organization by the central agency. This address is specific to your network and system.
State	State of the IP interface. It indicates whether the interface is available for communications (`up`) or unavailable (`down`).
Subnet mask	32-bit number that uses the same format and representation as an IP address. The subnet mask determines which bits in the IP address are interpreted as the network number, the subnet number, and the host number. Each IP address bit that corresponds to a 1 in the subnet mask is in the network/subnet part of the address. Each IP address bit that corresponds to a 0 is in the host part of the IP address.
Type	Type of interface (for example, VLAN)
VLAN index	Number of the IP VLAN that is associated with the IP interface.

ip interface detail

Displays detailed information about the specified interfaces or all interfaces.

Valid Minimum Abbreviation

: ip i det

Important Consideration

When you enter the command, you are prompted for an interface index number even if you have only one interface defined.

Options

Prompt

Description

Possible Values

[Default]

Interface index

Interface number for which you want to display detail information

One or more configured interfaces
all
? (for a list of selectable interfaces)

-

Prompt	Description	Possible Values	[Default]
Interface index	Interface number for which you want to display detail information	One or more configured interfaces all ? (for a list of selectable interfaces)	-

Fields in the IP Interface Detail Display

Field

Description

ARP proxy

Whether ARP proxy is enabled or disabled for the specified interface.

Broadcast address

Broadcast address for the specified interface

Directed broadcast

Whether the forwarding of a directed broadcast (all 1s in the host portion of the address) is enabled or disabled for the specified interface. (A directed broadcast is a packet sent to a specific network or series of networks.)

ICMP redirect

Whether ICMP redirect is enabled or disabled for the specified interface

ICMP router discovery

Whether the ICMP Router Discovery is enabled or disabled for the specified interface

Index

Number associated with the interface

IP address

IP address of the interface, chosen from the range of addresses assigned to your organization by the central agency. This address is specific to your network and system.

Preference

Whether there is a preference being used for the specified interface. If ICMP Router Discovery is enabled, the system uses the routing interface with the highest preference level.

State

State of the IP interface. It indicates whether the interface is available for communications (up) or unavailable (down).

Subnet mask

32-bit number that uses the same format and representation as an IP address. The subnet mask determines which bits in the IP address are interpreted as the network number, the subnet number, and the host number. Each IP address bit that corresponds to a 1 in the subnet mask is in the network/subnet part of the address. Each IP address bit that corresponds to a 0 is in the host part of the IP address.

Type

Type of interface (for example, VLAN)

VLAN index

Number of the IP VLAN that is associated with the IP interface.

Field	Description
ARP proxy	Whether ARP proxy is enabled or disabled for the specified interface.
Broadcast address	Broadcast address for the specified interface
Directed broadcast	Whether the forwarding of a directed broadcast (all 1s in the host portion of the address) is enabled or disabled for the specified interface. (A directed broadcast is a packet sent to a specific network or series of networks.)
ICMP redirect	Whether ICMP redirect is enabled or disabled for the specified interface
ICMP router discovery	Whether the ICMP Router Discovery is enabled or disabled for the specified interface
Index	Number associated with the interface
IP address	IP address of the interface, chosen from the range of addresses assigned to your organization by the central agency. This address is specific to your network and system.
Preference	Whether there is a preference being used for the specified interface. If ICMP Router Discovery is enabled, the system uses the routing interface with the highest preference level.
State	State of the IP interface. It indicates whether the interface is available for communications (`up`) or unavailable (`down`).
Subnet mask	32-bit number that uses the same format and representation as an IP address. The subnet mask determines which bits in the IP address are interpreted as the network number, the subnet number, and the host number. Each IP address bit that corresponds to a 1 in the subnet mask is in the network/subnet part of the address. Each IP address bit that corresponds to a 0 is in the host part of the IP address.
Type	Type of interface (for example, VLAN)
VLAN index	Number of the IP VLAN that is associated with the IP interface.

ip interface define

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

Defines an IP interface.

Valid Minimum Abbreviation

: ip i def

Important Consideration

Before you define the IP (routing) interface, you must define a VLAN and select IP as a protocol supported by the VLAN, as described in Chapter 13.

Options

Prompt

Description

Possible Values

[Default]

IP address

IP address of the interface, chosen from the range of addresses assigned to your organization by the central agency. This address is specific to your network and system.

A valid IP address in the range of addresses assigned to your organization

-

Subnet mask

32-bit number that uses the same format and representation as an IP address. The subnet mask determines which bits in the IP address are interpreted as the network number, the subnet number, and the host number. Each IP address bit that corresponds to a 1 in the subnet mask is in the network/subnet part of the address. Each IP address bit that corresponds to a 0 is in the host part of the IP address.

A valid subnet mask in accordance with the bits used for network number, subnet, and host number

Depends on specified IP address

VLAN interface index

Number of the IP VLAN that is associated with the IP interface.

A selectable VLAN index
? (for a list of selectable VLAN indexes)

Not applicable if you have more than one VLAN

Prompt	Description	Possible Values	[Default]
IP address	IP address of the interface, chosen from the range of addresses assigned to your organization by the central agency. This address is specific to your network and system.	A valid IP address in the range of addresses assigned to your organization	-
Subnet mask	32-bit number that uses the same format and representation as an IP address. The subnet mask determines which bits in the IP address are interpreted as the network number, the subnet number, and the host number. Each IP address bit that corresponds to a 1 in the subnet mask is in the network/subnet part of the address. Each IP address bit that corresponds to a 0 is in the host part of the IP address.	A valid subnet mask in accordance with the bits used for network number, subnet, and host number	Depends on specified IP address
VLAN interface index	Number of the IP VLAN that is associated with the IP interface.	A selectable VLAN index ? (for a list of selectable VLAN indexes)	Not applicable if you have more than one VLAN

IP Interface Define Example

: Enter IP address: 158.101.1.1 Enter subnet mask [255.255.0.0]: 255.255.255.0 Enter VLAN interface index {2|?}[2]:2
ip interface modify

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

Changes the configuration of an interface that you have already defined.

Valid Minimum Abbreviation

: ip i m

Options

Prompt

Description

Possible Values

[Default]

IP interface

Index number associated with the interface that you want to modify. Depends on number of IP interfaces configured.

A selectable IP interface
? (for a list of selectable interfaces)

Not applicable if you have more than one interface

IP address

IP address of the interface that you want to modify

A valid IP address in the range of addresses assigned to your organization

Current IP address

Subnet mask

Subnet mask for the interface that you want to modify

A valid subnet mask in accordance with the bits used for network number, subnet, and host number

Current subnet mask

VLAN interface index

Number of the IP VLAN that is associated with the IP interface. Depends on number of VLANs configured.

A selectable VLAN interface index number
? (for a list of selectable VLANs)

VLAN associated with the current interface

Prompt	Description	Possible Values	[Default]
IP interface	Index number associated with the interface that you want to modify. Depends on number of IP interfaces configured.	A selectable IP interface ? (for a list of selectable interfaces)	Not applicable if you have more than one interface
IP address	IP address of the interface that you want to modify	A valid IP address in the range of addresses assigned to your organization	Current IP address
Subnet mask	Subnet mask for the interface that you want to modify	A valid subnet mask in accordance with the bits used for network number, subnet, and host number	Current subnet mask
VLAN interface index	Number of the IP VLAN that is associated with the IP interface. Depends on number of VLANs configured.	A selectable VLAN interface index number ? (for a list of selectable VLANs)	VLAN associated with the current interface

IP Interface Modify Example

: Select menu option (ip/interface): modify
: Select IP interface {1,2|?} :1
: Enter IP address [158.101.100.10]: 158.101.100.12
: Enter subnet mask [255.255.255.0]:
: Enter VLAN interface index {2|?} [2]:
ip interface remove

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

Removes an interface if you are no longer using it on your system.

Valid Minimum Abbreviation

: ip i re

Important Consideration

Before you remove the interface, remove any static entries in the route table.

Options

Prompt

Description

Possible Values

[Default]

IP interfaces

Number associated with the interfaces that you want to remove

One or more selectable interfaces
all
? (for a list of selectable interfaces)

Not applicable if you have more than one interface

Prompt	Description	Possible Values	[Default]
IP interfaces	Number associated with the interfaces that you want to remove	One or more selectable interfaces all ? (for a list of selectable interfaces)	Not applicable if you have more than one interface

ip interface arpProxy

On a per-interface basis, enables or disables ARP proxy, which helps end stations on a subnetwork reach remote subnets that do not have routing capabilities or a default gateway configured.

Valid Minimum Abbreviation

: ip i a

Important Considerations

When ARP proxy is enabled and an end station sends an ARP request for a remote network, the system determines if it has the best route and then answers the ARP request by sending its own MAC address to the end station. The end station then sends the frames for the remote destination to the system, which uses its own routing table to reach the destination on the other network.
When an interface is defined, the default ARP proxy state is enabled.
The end stations must view the entire network configuration as one network (that is, by using a smaller subnet mask).
Evaluate prolonged use of ARP proxy because it has some drawbacks, including increased ARP traffic and a need for larger ARP tables to handle the mapping of IP addresses to MAC addresses.

Options

Prompt

Description

Possible Values

[Default]

Interface

Interface number for which you want to enable or disable ARP proxy

One or more selectable interfaces
all
? (for a list of selectable interfaces)

Not applicable if you have more than one interface

ARP proxy state

ARP proxy state that you want to assign to an interface. The system prompts you for a state for each interface.

enabled
disabled

Current value

Prompt	Description	Possible Values	[Default]
Interface	Interface number for which you want to enable or disable ARP proxy	One or more selectable interfaces all ? (for a list of selectable interfaces)	Not applicable if you have more than one interface
ARP proxy state	ARP proxy state that you want to assign to an interface. The system prompts you for a state for each interface.	enabled disabled	Current value

IP Interface ARP Proxy Example

: Select menu option (ip/interface): arpproxy
: Select IP interfaces (1,2|?|all):2
: Interface 2 - Enter proxy state (disabled, enabled)
: [enabled]: enabled
ip interface broadcastAddress

On a per-interface basis, assigns the broadcast address that the system uses to forward the received directed broadcasts and advertise RIP packets.

Valid Minimum Abbreviation

: ip i b

Important Considerations

You assign the broadcast address on a per-interface basis.
When an IP interface is configured, its default broadcast address is 255.255.255.255.
The broadcast address that you specify affects the RIP advertisement address that is used for the RIP interface. You see the specified broadcast address as the advertisement address under the RIP menus. See "ip rip display" later in this chapter for information about the RIP interface display.
You cannot change the broadcast address for an interface if you have added any RIP advertisement addresses to that interface. See "ip rip addAdvertisement" later in this chapter for more information.

Options

Prompt

Description

Possible Values

[Default]

IP interfaces

Number of the interfaces to which you want to assign a broadcast address

One or more interfaces
all
? (for a list of selectable interfaces)

Not applicable if you have more than one interface

Broadcast address per interface

Broadcast address that you want to assign to an interface

A valid address

Current address

Prompt	Description	Possible Values	[Default]
IP interfaces	Number of the interfaces to which you want to assign a broadcast address	One or more interfaces all ? (for a list of selectable interfaces)	Not applicable if you have more than one interface
Broadcast address per interface	Broadcast address that you want to assign to an interface	A valid address	Current address

IP Interface Broadcast Address Example

This example shows a directed broadcast address for 158.101.150.0:

: Select menu option (ip/interface): broadcastAddress
: Select IP interfaces (1,2|all|?):1
: Interface 1 - Enter broadcast IP address [255.255.255.255]:
: 158.101.150.255
ip interface directedBroadcast

Specifies whether the forwarding of a directed broadcast (all 1s in the host portion of the address) is enabled or disabled for a specified interface. A directed broadcast is a packet that is sent to a specific network or series of networks.

Valid Minimum Abbreviation

: ip i di

Important Considerations

You define the directed broadcast state on a per-interface basis.
When the state is enabled and the system sees that the destination is different from the interface that is receiving the directed broadcast, the system uses the broadcast address that is defined for this interface to forward the directed broadcast.
You can disable the forwarding of a directed broadcast if security is an issue.
By default, the directed broadcast state is enabled.

Options

Prompt

Description

Possible Values

[Default]

IP interfaces

Numbers of the interfaces to which you want to enable or disable the forwarding of a directed broadcast

One or more selectable interfaces
all
? (for a list of selectable interfaces)

Not applicable if you have more than one interface

Directed broadcast state

State that you want to assign to an interface. The system prompts you for a state for each interface.

enabled
disabled

Current value

Prompt	Description	Possible Values	[Default]
IP interfaces	Numbers of the interfaces to which you want to enable or disable the forwarding of a directed broadcast	One or more selectable interfaces all ? (for a list of selectable interfaces)	Not applicable if you have more than one interface
Directed broadcast state	State that you want to assign to an interface. The system prompts you for a state for each interface.	enabled disabled	Current value

IP Interface Directed Broadcast Example

: Select menu option (ip/interface): directedBroadcast
: Select IP interfaces (1,2|all|?):2
: Interface 2 - Enter directed broadcast state
: (disabled, enabled) [enabled]:
ip interface icmpRedirect

On a per-interface basis, enables or disables the transmission of an ICMP redirect to the sender of a frame to indicate that there is a better gateway available to handle the frame than this routing interface.

Valid Minimum Abbreviation

: ip i icmpre

Important Considerations

The software determines whether there is a better path for the frame by determining if the source interface is the same as the destination interface and seeing if the frame's sender is on a directly connected network. If the software determines that a received frame has a better path available through another gateway:
- It sends an ICMP redirect message back to the originator of the frame indicating the better gateway to use in the future
- It routes the frame to the gateway
By default, ICMP redirects are enabled for each interface.
Disable the ability of the interface to send ICMP redirects for better performance, or if you have applications that ignore ICMP redirects.
If you have two interfaces belonging to VLANs that share a given port and you want to completely disable ICMP redirects for that port, you must disable the redirects for each interface that shares that port. If you disable it for only one interface and enable it for the other, you may not get the performance improvement that you want.

Options

Prompt

Description

Possible Values

[Default]

IP interfaces

Number of the interfaces to which you want to enable or disable the transmission of an ICMP redirect to the sender of a frame

One or more selectable interfaces
all
? (for a list of selectable interfaces)

Not applicable if you have more than one interface

ICMP redirect state

ICMP redirect state that you want to assign to an interface. The system prompts you for a state for each interface.

enabled
disabled

Current value

Prompt	Description	Possible Values	[Default]
IP interfaces	Number of the interfaces to which you want to enable or disable the transmission of an ICMP redirect to the sender of a frame	One or more selectable interfaces all ? (for a list of selectable interfaces)	Not applicable if you have more than one interface
ICMP redirect state	ICMP redirect state that you want to assign to an interface. The system prompts you for a state for each interface.	enabled disabled	Current value

ip interface icmpRouterDiscovery

On a per-interface basis, enables or disables Internet Control Message Protocol (ICMP) Router Discovery, which enables hosts that are attached to multicast or broadcast networks to discover the IP addresses of their neighboring routers and determine which router to use for a default gateway.

Valid Minimum Abbreviation

: ip i icmpro

Important Considerations

When an interface is defined, the ICMP Router Discovery state is disabled by default.
When you enable the state for an interface, the system prompts you for a preference (see RFC 1256). By default, this preference level is 0. Use the preference to control the use of certain routers as the default router. The host uses the router with the highest preference level.
For CoreBuilder 9000 Layer 3 modules, the "ip icmpRouterDiscovery" option sets the ICMP Router Discovery state for the entire system and uses a preference level of 0.

Options

Prompt

Description

Possible Values

[Default]

IP interfaces

Number of the interfaces for which you want to enable or disable ICMP router discovery

One or more selectable interfaces
all
? (for a list of selectable interfaces)

Not applicable if you have more than one interface

Router discovery state

Router discovery state that you want to assign to an interface. The system prompts you for a state for each interface.

enabled
disabled

Current value

Preference

If you select enabled, the host interprets an unsigned integer as a 32-bit signed twos-complement integer that represents the preference level to associate with the interface. Higher values produce higher preference levels. The minimum value is reserved so that the address is not used as a default router address, only for specific IP destinations.

minimum value (hex 80000000)
-2³¹ to 2³¹

0

Prompt	Description	Possible Values	[Default]
IP interfaces	Number of the interfaces for which you want to enable or disable ICMP router discovery	One or more selectable interfaces all ? (for a list of selectable interfaces)	Not applicable if you have more than one interface
Router discovery state	Router discovery state that you want to assign to an interface. The system prompts you for a state for each interface.	enabled disabled	Current value
Preference	If you select `enabled`, the host interprets an unsigned integer as a 32-bit signed twos-complement integer that represents the preference level to associate with the interface. Higher values produce higher preference levels. The minimum value is reserved so that the address is not used as a default router address, only for specific IP destinations.	minimum value (hex 80000000) -2³¹ to 2³¹	0

IP Interface ICMP Router Discovery Example

: Select menu option (ip/interface): icmprouterDiscovery

: Select IP interfaces (1,2|all|?):2
: Interface 2 - Enter router discovery state
: (disabled, enabled) [disabled]: enabled
: Interface 2 - Enter router discovery preference [0]:
ip interface statistics

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

Displays IP interface statistics on a per-interface basis.

Valid Minimum Abbreviation

: ip i st

Important Consideration

The system prompts you for an interface index number even if you have only one interface defined.

Options

Prompt

Description

Possible Values

[Default]

Interface index

Interface number for which you want to display statistics

One or more configured interfaces
all
? (for a list of selectable interfaces)

-

Prompt	Description	Possible Values	[Default]
Interface index	Interface number for which you want to display statistics	One or more configured interfaces all ? (for a list of selectable interfaces)	-

Fields in the IP Interface Statistics Display

Field

Description

inAddrErrors

Number of datagrams that the IP station discarded because of an error in the source or destination IP address

inCsumErrors

Number of datagrams that were dropped because of a checksum error

inDelivers

Number of datagrams that the IP station delivered to local IP client protocols

inDiscards

Number of packet receive discards

inForwards

Total number of packets forwarded (that is, routed through hardware or software or both)

inHdrErrors

Number of datagrams that the IP station discarded because the IP header contained errors

inReceives

Total number of IP datagrams received, including those with errors

inSameSegment

Number of packets that were received on an interface and that need to be forwarded out on the same interface

inTtlExceeds

Number of packets that were received on an interface and that need to be forwarded, but that have an IP header TTL value of less than 2

outDiscards

Number of packet transmit discards

outForwards

Total number of packets that a router has forwarded to an outbound interface (that is, routed through hardware or software or both)

Field	Description
inAddrErrors	Number of datagrams that the IP station discarded because of an error in the source or destination IP address
inCsumErrors	Number of datagrams that were dropped because of a checksum error
inDelivers	Number of datagrams that the IP station delivered to local IP client protocols
inDiscards	Number of packet receive discards
inForwards	Total number of packets forwarded (that is, routed through hardware or software or both)
inHdrErrors	Number of datagrams that the IP station discarded because the IP header contained errors
inReceives	Total number of IP datagrams received, including those with errors
inSameSegment	Number of packets that were received on an interface and that need to be forwarded out on the same interface
inTtlExceeds	Number of packets that were received on an interface and that need to be forwarded, but that have an IP header TTL value of less than 2
outDiscards	Number of packet transmit discards
outForwards	Total number of packets that a router has forwarded to an outbound interface (that is, routed through hardware or software or both)

ip route display

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

Displays the system's routing table to determine which routes to other IP networks are configured and whether the routes are operational.

Valid Minimum Abbreviation

: ip route di

Important Considerations

For the CoreBuilder 3500 only, the system prompts you for an IP address and subnet mask. As a result, you can display only a subset of routes instead of all routes. To see all entries in the table, simply press Return at these prompts.
The first line in the output (the status line) indicates whether IP routing is enabled:
- For the CoreBuilder 9000 Layer 3 module, it also indicates whether ICMP router discovery is enabled on the system.
- For the CoreBuilder 3500, IP interface options (such as ICMP router discovery) appear under "ip interface detail" and are set on a per-interface basis.
If you have a CoreBuilder 3500 system with extended memory, the output of the route table display shows a range for the routing table entries in the format N-M, where N is the current number of entries and M is the maximum number of entries. If no range is displayed, the system does not have the extended memory and, therefore, the number of route table entries is a fixed number.

Options (3500 only)

Prompt

Description

Possible Values

[Default]

IP address (3500 only)

IP address (and its corresponding subnet mask) for which to display only those routes that match the bits set in it

A valid IP address

0.0.0.0 (displays all entries)

Subnet mask (3500 only)

Subnet mask for the specified IP address for which to display only those routes that match the bits set in it

A valid subnet mask of a specified IP address

Most recent IP address

Prompt	Description	Possible Values	[Default]
IP address (3500 only)	IP address (and its corresponding subnet mask) for which to display only those routes that match the bits set in it	A valid IP address	0.0.0.0 (displays all entries)
Subnet mask (3500 only)	Subnet mask for the specified IP address for which to display only those routes that match the bits set in it	A valid subnet mask of a specified IP address	Most recent IP address

Fields in the IP Route Display

Field

Description

Destination

IP address of the destination network, subnetwork, or host. This field can also identify a default route, which the system uses to forward packets that do not match any other routing table entry. You may want to use the default route in place of routes to numerous destinations that all have the same gateway IP address.

Subnet mask

Subnet mask that is associated with the IP address of the destination network, subnetwork, or host.

Metric

Number of networks through which a packet must pass to reach a given destination. The system includes the metric in its RIP updates to allow other routers to compare routing information received from different sources.

Gateway

Address that directs the router how to forward packets whose destination addresses match the route's IP address and subnet mask. The system forwards such packets to the indicated gateway.

Status

Status of the route. See the following status table.

Field	Description
Destination	IP address of the destination network, subnetwork, or host. This field can also identify a default route, which the system uses to forward packets that do not match any other routing table entry. You may want to use the default route in place of routes to numerous destinations that all have the same gateway IP address.
Subnet mask	Subnet mask that is associated with the IP address of the destination network, subnetwork, or host.
Metric	Number of networks through which a packet must pass to reach a given destination. The system includes the metric in its RIP updates to allow other routers to compare routing information received from different sources.
Gateway	Address that directs the router how to forward packets whose destination addresses match the route's IP address and subnet mask. The system forwards such packets to the indicated gateway.
Status	Status of the route. See the following status table.

Status for Routes

Field

Description

Direct

Route is for a directly connected network

Learned

Route was learned using indicated protocol

Learned RIP-Zombie

Route was learned but is partially timed out

Learned RIP2

Route was learned using RIP-2 protocol

Local

Actual interface address

Static

Route was statically configured

Timed out

Route has timed out and is no longer valid

Field	Description
Direct	Route is for a directly connected network
Learned	Route was learned using indicated protocol
Learned RIP-Zombie	Route was learned but is partially timed out
Learned RIP2	Route was learned using RIP-2 protocol
Local	Actual interface address
Static	Route was statically configured
Timed out	Route has timed out and is no longer valid

ip route static

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

Defines a static route.

Valid Minimum Abbreviation

: ip route s

Important Considerations

Before you can define static routes, you must define at least one IP interface. See "ip interface define" in this chapter for more information.
For the CoreBuilder 3500, you can define up to 256 static routes.
For the other platforms, you can define up to 64 static routes.
Static routes remain in the table; you must remove them before you can remove the corresponding interface.
Static routes take precedence over dynamically learned routes to the same destination
Static routes are included in periodic RIP updates that the system sends.

Options

Prompt

Description

Possible Values

[Default]

Destination IP address

IP address of the destination network, subnetwork, or host for this route

A valid IP address

-

Subnet mask

Subnet mask for the specified IP address

A valid subnet mask

Based on specified IP address

Gateway IP address

IP address of the gateway that this route uses

A valid router address

-

Prompt	Description	Possible Values	[Default]
Destination IP address	IP address of the destination network, subnetwork, or host for this route	A valid IP address	-
Subnet mask	Subnet mask for the specified IP address	A valid subnet mask	Based on specified IP address
Gateway IP address	IP address of the gateway that this route uses	A valid router address	-

ip route remove

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

Deletes an existing route.

Valid Minimum Abbreviation

: ip route r

Important Consideration

When you enter the command, the system deletes the route immediately from the routing table without a confirmation prompt.

Options

Prompt

Description

Possible Values

[Default]

Destination IP address

IP address of the route that you want to delete

A valid IP address

-

Subnet mask

Subnet mask for the specified IP address

A valid subnet mask

Based on specified IP address

Prompt	Description	Possible Values	[Default]
Destination IP address	IP address of the route that you want to delete	A valid IP address	-
Subnet mask	Subnet mask for the specified IP address	A valid subnet mask	Based on specified IP address

ip route flush

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

Deletes all learned routes from the routing table.

Valid Minimum Abbreviation

: ip route fl

Important Considerations

The system flushes all learned routes from the routing table immediately without a confirmation prompt.
Flushing the routing table does not cause RIP to update the routing table. You must change the metric to update the routing table.
ip route default

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

Adds a default route to the routing table immediately.

Valid Minimum Abbreviation

: ip route de

Important Considerations

If you define a default route, the system uses it to forward packets that do not match any other routing table entry. The system can learn a route using RIP, or you can statically configure a default route.
The system can learn a default route.
If the routing table does not contain a default route, the system cannot forward a packet that does not match any other routing table entry. When the system drops the packet, it sends an ICMP "destination unreachable" message to the host that sent the packet.

Options

Prompt

Description

Possible Values

[Default]

Gateway IP address

IP address of the route that you want to add as the default

A valid IP address

-

Prompt	Description	Possible Values	[Default]
Gateway IP address	IP address of the route that you want to add as the default	A valid IP address	-

ip route noDefault

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

Deletes the default route.

Valid Minimum Abbreviation

: ip route n

Important Consideration

The system deletes the default route from the routing table without a confirmation prompt immediately after you enter the command.
ip route findRoute

Searches for a route in the routing table.

Valid Minimum Abbreviation

: ip route fi

Important Considerations

This command enables you to find a route using an IP address or a host name, as long as DNS is configured.
When you enter this command with a valid IP address or host name, the system displays the routing table entry.

Options

Prompt

Description

Possible Values

[Default]

IP address (or host name)

IP address of the route that you want to find, or a host name, if DNS is configured

A valid IP address or host name

0.0.0.0

Prompt	Description	Possible Values	[Default]
IP address (or host name)	IP address of the route that you want to find, or a host name, if DNS is configured	A valid IP address or host name	0.0.0.0

ip arp display

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

Displays the contents of the Address Resolution Protocol (ARP) cache for each interface on the system.

Valid Minimum Abbreviation

: ip ar d

Important Considerations

The system uses the ARP cache to find the MAC addresses that correspond to the IP addresses of hosts and other routers on the same subnets. Each device that participates in routing maintains an ARP cache, which is a table of known IP addresses and their corresponding MAC addresses.
The first line in the output (the status line) indicates whether IP routing is enabled:
- For the CoreBuilder 9000 Layer 3 module, it also indicates whether ICMP router discovery is enabled on the system.
- For the CoreBuilder 3500, IP interface options (such as ICMP router discovery) appear under "ip interface detail" and are set on a per-interface basis. The second status line indicates the number of entries in the ARP cache.

Fields in the IP ARP Display

Field

Description

Circuit

The circuit

Hardware address

MAC address that is mapped to the IP address

I/F

Number of the associated interface

IP address

IP address of the interface

Type

Type of entry - static or dynamic

Field	Description
Circuit	The circuit
Hardware address	MAC address that is mapped to the IP address
I/F	Number of the associated interface
IP address	IP address of the interface
Type	Type of entry - static or dynamic

ip arp static

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

Defines a static ARP cache entry on the system.

Valid Minimum Abbreviation

: ip ar s

Important Considerations

For the CoreBuilder 3500, you can define up to 128 static ARP entries.
For the other platforms, you can define up to 64 entries.

Options

Prompt

Description

Possible Values

[Default]

Interface index

Number of the interface for which you want to define a static ARP entry

A selectable interface
? (for a list of selectable interfaces)

-

IP address

IP address to be used in the entry

A valid IP address

-

MAC address

Hardware address to be used in the entry

A valid MAC address in the format xx-xx-xx-xx-xx-xx

-

Prompt	Description	Possible Values	[Default]
Interface index	Number of the interface for which you want to define a static ARP entry	A selectable interface ? (for a list of selectable interfaces)	-
IP address	IP address to be used in the entry	A valid IP address	-
MAC address	Hardware address to be used in the entry	A valid MAC address in the format xx-xx-xx-xx-xx-xx	-

IP ARP Static Example

: Select interface index {1-2|?} 2
: Enter IP address: 158.101.12.12
: Enter MAC address: 00-00-00-00-00-01

ip arp remove

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

Deletes an entry from the ARP cache (for example, if the MAC address has changed).

Valid Minimum Abbreviation

: ip ar rem

Important Considerations

When you enter the command, the system deletes the entry from the cache immediately, without a confirmation prompt.
If necessary, the system subsequently uses ARP to find the new MAC address that corresponds to that IP address.

Options

Prompt

Description

Possible Values

[Default]

IP address

IP address for the entry that you want to delete

A valid IP address

-

Prompt	Description	Possible Values	[Default]
IP address	IP address for the entry that you want to delete	A valid IP address	-

ip arp flush

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

Deletes all entries from the ARP cache.

Valid Minimum Abbreviation

: ip ar f

Important Considerations

This command applies only to the CoreBuilder 9000; all other platforms use the ip arp flushAll or ip arp flushDynamic options.
When you enter the command, the system deletes the entry from the cache immediately, without a confirmation prompt.
ip arp flushAll

Deletes all entries from the ARP cache.

Valid Minimum Abbreviation

: ip ar flushA

Important Considerations

To flush dynamic entries only, see the ip arp flushDynamic option.
When you enter the command, the system deletes all entries from the cache immediately, without a confirmation prompt.
ip arp flushDynamic

Deletes all dynamic (learned) entries from the ARP cache.

Valid Minimum Abbreviation

: ip ar flushD

Important Considerations

To flush all entries, static and dynamic, see the ip arp flushAll option.
When you enter the command, the system deletes all dynamic entries from the cache immediately, without a confirmation prompt.
ip arp age

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

Sets the age time for dynamic ARP cache entries.

Valid Minimum Abbreviation

: ip ar a

Important Considerations

The age time determines how long, in minutes, the dynamic entries remain in the ARP cache before being removed.
By default, the system flushes the entry from the cache when it reaches the age time.
A value of 0 indicates no age time, and the entry remains in the table until you remove it with the ip arp remove option or flush the ARP cache with the appropriate flush option.

The default age time is 15 minutes.

Options

Prompt

Description

Possible Values

[Default]

Age time

Age time, in minutes

0 - 1440
0 (for no aging)

15 (factory default), or current value

Prompt	Description	Possible Values	[Default]
Age time	Age time, in minutes	0 - 1440 0 (for no aging)	15 (factory default), or current value

ip dns display

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

Displays the current domain name and the name servers that are associated with it.

Valid Minimum Abbreviation

: ip d di

Important Considerations

The Domain Name System (DNS) client provides DNS lookup functionality to the CoreBuilder IP ping and traceRoute features. This functionality allows you to specify a hostname rather than an IP address when you perform various operations (for example, when you use ping or traceRoute to contact an IP station).
The DNS commands allow you specify one or more name servers that are associated with a domain name. Each name server maintains a list of IP addresses and their associated host names. When you use ping or traceRoute with a hostname, the DNS client attempts to locate the name on the name servers that you specify. When the DNS client locates the name, it resolves it to the associated IP address.
See UNIX Network File System (NFS) documentation for information about how to create and maintain lists of domain names and IP addresses on the name servers.

Fields in the IP DNS Display

Field

Description

Domain name

Name of the domain name (up to 79 alphanumeric characters)

Name server

Name server that is associated with the domain

ip dns domainName

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

Changes the name of a currently defined domain.

Valid Minimum Abbreviation

: ip d do

Important Considerations

You can specify a domain name with up to 79 alphanumeric characters.
Use quotation marks around any string that has embedded spaces. Use " " to enter an empty string.

Options

Prompt

Description

Possible Values

[Default]

Domain name

Name of the domain. The name can be up to 79 characters long

A valid domain name
? (to get information about specifying a domain name)

Current name (shown in brackets, if one exists)

ip dns define

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

Defines a new name server IP address to associate with the current domain name.

Valid Minimum Abbreviation

: ip d de

Important Considerations

When the system accepts the new IP address, it displays a message like the following:
Server's IP address xxxxx is added to the DNS database
The system assigns an index number to the new IP address. Use this index number to modify or remove this IP address.

Options

Prompt

Description

Possible Values

[Default]

Name server IP address

IP address of the name server that you want to define

A valid IP address

-

ip dns modify

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

Modifies a currently defined name server IP address.

Valid Minimum Abbreviation

: ip d m

Important Considerations

When you enter the command, the system displays the list of name server addresses and the index number that is associated with each.
The system assigns an index number to the new IP address. Use this index number to modify this IP address.

Options

Prompt

Description

Possible Values

[Default]

Index

Index number of the name server IP address that you want to modify

A selectable server index number
? (for a list of selectable server indexes)

-

Name server IP address

New IP address of the name server that you want to use

A valid IP address

-

ip dns remove

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

Deletes a previously defined name server IP address.

Valid Minimum Abbreviation

: ip d r

Important Consideration

When you enter the command, the system displays the list of name server addresses and the index number that is associated with each.

Options

Prompt

Description

Possible Values

[Default]

Index

Index number of the name server IP address that you want to remove

A selectable server index number
? (for a list of selectable server indexes)

-

ip dns nslookup

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

Maps an IP address to a host name or a host name to an IP address on a name server.

Valid Minimum Abbreviation

: ip d n

Important Considerations

Specify a host name or IP address at the prompt.
Enter a string of up to 255 characters.
Use single quotes (` `) around any string with embedded spaces. Use double quotes (" ") to enter an empty string.

Options

Prompt

Description

Possible Values

[Default]

IP address/name

IP address or name that you want to map

up to 255 characters (hostname)
A valid IP address

-

ip udpHelper display

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

Displays the BOOTP (boot protocol) hop count and the threshold configuration. Also lists the ports with their IP forwarding addresses that are defined in your system.

Valid Minimum Abbreviation

: ip u di

Important Considerations

UDP Helper allows you to send User Datagram Protocol (UDP) packets between routed networks. It provides support for UDP services such as BOOTP and DHCP (Dynamic Host Configuration Protocol), which rely on the BOOTP relay agent.
When you configure the logical BOOTP port, you can boot hosts through the router. UDP Helper also provides a relay agent for DHCP broadcasts. UDP packets that rely on the BOOTP relay agent are modified and then forwarded through the router.
BOOTP (including DHCP) uses UDP port 67.
UDP Helper allows you to configure the amount of time that a UDP packet is forwarded between subnetworks. The system discards UDP packets based on the hop count and the seconds value only for BOOTP and DHCP.

Fields in the IP udpHelper Display

Field

Description

UDP port

UDP port number - 67

Forwarding address

Forwarding address used for UDP packets

ip udpHelper define

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

Defines port numbers or IP forwarding addresses for the UDP Helper.

Valid Minimum Abbreviation

: ip u de

Important Considerations

You can have up to 32 combinations of port numbers and IP forwarding addresses per router.
You can have multiple IP address entries for the same ports.

Options

Prompt

Description

Possible Values

[Default]

UDP port number

Port number for UDP

1 - 65535

67 (factory default), or current value

IP forwarding address

Forwarding addresses used for UDP packets

A valid IP address

-

ip udpHelper remove

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

Removes a port number or IP forwarding address that has been defined for UDP Helper.

Valid Minimum Abbreviation

: ip u r

Important Consideration

The system immediately removes, with no confirmation prompt, the port numbers and IP forwarding addresses that you specified.

Options

Prompt

Description

Possible Values

[Default]

UDP port number

UDP port number that you want to remove

1 - 65535

67 (factory default), or current value

IP forwarding address

Forwarding addresses that you want to remove

A valid IP address

-

ip udpHelper hopCountLimit

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

Sets the maximum hop count to specify how many steps the system uses to forward a packet through the router.

Valid Minimum Abbreviation

: ip u h

Options

Prompt

Description

Possible Values

[Default]

BOOTP hop count limit

Maximum number of hops to allow for UDP packet forwarding

0 - 16

4 (factory default), or current value

ip udpHelper threshold

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

Sets the maximum number of times that the system forwards a packet to the network.

Valid Minimum Abbreviation

: ip u t

Important Consideration

By default, there is no threshold (0).

Options

Prompt

Description

Possible Values

[Default]

BOOTP relay threshold

Maximum number of times that the system forwards a packet to the network

0 - 65535

0 (factory default), or current value

ip udpHelper interface first

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

Configures UDP Helper to support overlapped IP interfaces by using the first interface.

Valid Minimum Abbreviation

: ip u i f

Important Considerations

Overlapped IP interfaces are multiple logical interfaces that are defined for a single physical port. You can specify how UDP Helper forwards packets from overlapped IP interfaces with one of three interface options (first, even, or sequential).
The value first directs the system to use the first overlapped IP interface as the source network for forwarded packets.
The system implements your selection immediately. You can view the UDP Helper configuration when you configure the forwarding address.
ip udpHelper interface even

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

Configures UDP Helper to support overlapped IP interfaces by evenly distributing interfaces.

Valid Minimum Abbreviation

: ip u i e

Important Considerations

The value even directs the system to hash the client's MAC address to determine the source network for forwarded packets. This arrangement evenly distributes the interface among those on the network.
The system implements your selection immediately. You can view the UDP Helper configuration when you configure the forwarding address.
ip udpHelper interface sequential

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

Configures UDP Helper to support overlapped IP interfaces by distributing the interfaces sequentially.

Valid Minimum Abbreviation

: ip u i s

Important Considerations

The value sequential directs the system to assign each overlapped IP interface, in turn, as the source network for forwarded packets.
The system implements your selection immediately. You can view the UDP Helper configuration when you configure the forwarding address.

: ip routing

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

Controls whether the system forwards or discards IP packets that are addressed to other hosts.

Valid Minimum Abbreviation

: ip routi

Important Considerations

When you enable IP routing, the system acts as a standard IP router: it forwards IP packets from one subnetwork to another when required.
When you disable IP routing, the system discards any IP packets that are not addressed directly to one of its defined IP interfaces.

By default, IP routing is disabled on the system.

Options

Prompt

Description

Possible Values

[Default]

IP routing state

State of IP routing on the system

enabled
disabled

disabled

ip icmpRouterDiscovery

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

Enables or disables the Internet Control Message Protocol (ICMP) Router Discovery protocol for the entire system.

Valid Minimum Abbreviation

: ip icmprouter

Important Considerations

This feature, initially disabled, allows an appropriately configured end station to locate one or more routers on the LAN to which it is attached. The end station then automatically installs a default route to each of the routers that is running ICMP Router Discovery. You do not need to manually configure a default route. ICMP redirect messages subsequently channel the IP traffic to the correct router.
You can configure only certain end stations to work with the ICMP Router Discovery protocol. See the documentation for your workstation to determine whether you can configure it to work with this protocol.
See RFC 1256 for more information about this feature.
The CoreBuilder 3500 implements this feature on a per-interface basis. See "ip interface icmpRouterDiscovery" earlier in this chapter.
By default, ICMP Router Discovery is disabled on the system.

Options

Prompt

Description

Possible Values

[Default]

ICMP Router Discovery state

State of this feature on the system

enabled
disabled

disabled

ip rip display

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

Displays information about the Routing Information Protocol (RIP) interfaces on the system. RIP is one of the IP Interior Gateway Protocols (IGPs). When enabled, RIP allows the system to dynamically configure its routing tables.

Valid Minimum Abbreviation

: ip ri d

Important Considerations

The output for this display differs according to platform.
The first line in the output (the status line) indicates whether IP routing is enabled:
- For the CoreBuilder 9000 Layer 3 module, it also indicates whether ICMP router discovery is enabled on the system.
- For the CoreBuilder 3500, IP interface options (such as ICMP router discovery) appear under "ip interface detail" earlier in this chapter and are set on a per-interface basis. The rest of the output contains more RIP interface information.
The four available RIP modes are as follows:
An advertising router sends a RIP message every 30 seconds with both the IP address and a metric (the distance to the destination from that router) for each destination. Each router through which a RIP packet must travel to reach a destination equals one hop.

Fields in the IP RIP Display

Field

Description

Advertisement Addresses (3500 and 9000 only)

List of available advertisement addresses. The list is used for RIP-2 updates only if the RIP-1 compatibility mode is enabled. RIP-1 always uses advertisement addresses.

Compatibility Mode (3500 only)

Whether RIP 1 compatibility mode is enabled or disabled (by default, disabled)

Cost (3500 and 9000 only)

RIP cost for the interface (by default, 1)

Index

Index number of the interface

Poison Reverse (3500 and 9000 only)

Whether poison reverse mode is enabled or disabled (by default, enabled)

RIP-1 Mode

Mode for RIP-1. If you disable RIP-1, the output lists the state as off. Other modes are learn (default), advertise, and enabled.

RIP-2 Mode

Mode for RIP-2. If you disable RIP-2, the output lists the state as off. Other modes are learn (default), advertise, and enabled.

Route Aggregate (3500 only)

Whether Route Aggregation mode is enabled or disabled

ip rip mode

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

On a per-interface basis, sets one of four RIP Version 1 (RIP-1) modes on the system. For those platforms except the CoreBuilder 9000, also allows you to set RIP Version 2 (RIP-2) modes.

Valid Minimum Abbreviation

: ip ri m

Important Considerations

Platforms except the CoreBuilder 9000 support RIP Version 1 as well as RIP Version 2. For each interface, you select a RIP Version 1 mode and a RIP Version 2 mode. The default RIP Version 1 mode for all platforms is learn. The default RIP Version 2 mode is learn.
The four available RIP modes are as follows:

Options

Prompt

Description

Possible Values

[Default]

IP interfaces

Index number of the interfaces for which you want to set the RIP mode. Depends on interfaces configured.

One or more selectable interfaces
all
? (for a list of selectable interfaces)

Previous entry, if applicable

RIP mode, Version 1

Selected RIP Version 1 mode that determines how the interface handles RIP 1 packets and updates

disabled
learn
advertise (3500/9000)
enabled (3500/9000)

learn (factory default), or current value

RIP mode, Version 2 (not 9000)

Selected RIP mode that determines how the interface handles RIP 2 packets and updates

disabled
learn
advertise (3500 only)
enabled (3500 only)

learn (factory default), or current value

IP RIP Mode Example

Select IP interfaces (1,2|all|?): 1

Interface 1 - Enter RIP Version 1 mode (disabled,learn,advertise,enabled) [learn]: disabled

Interface 1 - Enter RIP Version 2 mode (disabled,learn,advertise,enabled) [learn]: enabled

ip rip compatibilityMode

On a per-interface basis, sets the RIP Version 1 compatibility mode.

Valid Minimum Abbreviation

: ip ri com

Important Considerations

The RIP-1 compatibility mode determines how the software sends periodic RIP-2 updates. (For RIP-1, the software never uses the multicast address, it uses the advertisement list.)
- When the system is configured to advertise RIP-2 packets and compatibility mode is disabled, the software uses the multicast address of 224.0.0.9 when sending periodic updates. This is the latest industry recommendation and reduces the load on hosts that are not configured to listen to RIP-2 messages.
- When the system is configured to advertise RIP-2 packets and compatibility mode is enabled, the software uses the advertisement list for RIP-2 updates.

Options

Prompt

Description

Possible Values

[Default]

IP interfaces

Index number of the interfaces for which you want to set the RIP compatibility mode. Depends on interfaces configured.

One or more selectable interfaces
all
? (for a list of selectable interfaces)

Previous entry, if applicable

RIP-1 compatibility mode

Selected RIP Version 1 compatibility mode that determines how the system handles RIP-2 updates

disabled
enabled

disabled

IP RIP Compatibility Mode Example

Select IP interfaces (1,2|all|?) [1]: 1

Interface 1 - Enter RIP-1 Compatibility mode

(disabled,enabled) [disabled]: enabled

ip rip cost

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

On a per-interface basis, sets the RIP cost.

Valid Minimum Abbreviation

: ip ri cos

Important Considerations

The default cost value is 1, which is appropriate for most networks.
The system uses the cost number, between 1 and 15, to calculate route metrics. Unless your network has special requirements, assign a cost of 1 to all interfaces.

Options

Prompt

Description

Possible Values

[Default]

IP interfaces

Index number of the interfaces for which you want to set the RIP cost. Depends on interfaces configured.

One or more selectable interfaces
all
? (for a list of selectable interfaces)

Previous entry, if applicable

RIP cost

Selected RIP cost for the interface

1 - 15

1 (factory default), or current value

ip rip poisonReverse

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

Enables or disables RIP Poison Reverse mode on the system.

Valid Minimum Abbreviation

: ip ri poi

Important Considerations

Your system always implements Split Horizon, a scheme that aims to avoid the problems that are associated with reverse-route updates (that is, the updates that are sent to a neighboring router that include the routes that are learned from that router). The scheme omits the routes that are learned from one neighbor in the updates that are sent to that neighbor (the reverse routes). Poison reverse works with Split Horizon as follows:
- When you enable Poison Reverse for use with the Split Horizon scheme (the default), the system advertises reverse routes in updates, but sets the metrics to 16 (infinity). Setting the metric to infinity breaks the loop immediately when two routers have routes that point to each other.
- When you disable Poison Reverse for the Split Horizon scheme, reverse routes are simply not advertised.

Options

Prompt

Description

Possible Values

[Default]

IP interfaces

Index number of the interfaces for which you want to set the poison reverse mode

One or more selectable interfaces
all
? (for a list of selectable interfaces)

Previous entry, if applicable

Poison Reverse mode

Selected poison reverse mode

disabled
enabled

Current value

IP RIP Poison Reverse Example (3500)

: Select IP interfaces (1,2|all|?) [1]: 1
: Interface 1 - Enter RIP poison reverse mode (disabled,enabled) [enabled]:
ip rip routeAggregation Mode

Sets the route aggregation mode.

Valid Minimum Abbreviation

: ip ri ro

Important Considerations

Route aggregation mode determines which route table entries are sent during a RIP Version 2 update.
- If route aggregation mode is enabled, RIP-2 can function like RIP-1 and "collapse" route table entries for all subnets of a directly connected network. For example, if route aggregation is enabled, and the system is advertising subnets 150.100.31.0 and 150.100.32.0, only the entry for network 150.100.0.0 is sent in the update. With RIP Version 2, you must enable route aggregation mode if you want the interface to collapse the route table entries and function like RIP-1.
- If route aggregation mode is disabled (the default), a RIP-2 update sends all routing table entries.

Options

Prompt

Description

Possible Values

[Default]

IP interfaces

Index number of the interfaces for which you want to set the route aggregation mode (depends on interfaces configured)

One or more selectable interfaces
all
? (for a list of selectable interfaces)

Previous entry, if applicable

Route aggregation mode

Selected route aggregation mode

disabled
enabled

Current value

IP RIP Route Aggregation Mode Example

: Select menu option (ip/rip): routeAggregationMode
: Select IP interfaces (1,2|all|?) [1]: 2
: Interface 1 - Enter Route Aggregation Mode (disabled,enabled) [disabled]: enabled
ip rip password

Sets the IP RIP-2 password, which allows you to choose the IP interfaces that can put RIP-2 updates into their routing tables.

Valid Minimum Abbreviation

: ip ri pa

Important Considerations

If the sending interface has an IP RIP-2 password, the receiving interface must have the same IP RIP-2 password. If the receiving interface has a different password or a null password, its routing table is not updated.
If you are using RIP-1, do not use the password option.
You cannot use the ASCII string "none" as the password. This string is reserved to indicate the default password, which is a null value.

Options

Prompt

Description

Possible Values

[Default]

IP interfaces

Number of IP interfaces that you want to allow to receive route updates

1 - nn
all

-

Password

Combination of characters that you set as the RIP-2 password

up to 16 alphanumeric characters
none (null password)

none

IP RIP Password Example

: Select menu option (ip/rip): password
: Select IP interfaces (1,2|all|?): 1
: Interface 1 - Enter password {?} [none]: wings
ip rip addAdvertisement

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

Adds an advertisement address to an IP RIP interface.

Valid Minimum Abbreviation

: ip ri a

Important Considerations

The system uses the advertisement address specified to advertise routes to other stations on the same network. It uses this address for sending updates. (RIP-2 updates depend on the setting of RIP compatibility mode.)
Advertisement addresses are handled differently based on RIP-1 and RIP-2.
- For the CoreBuilder 3500, each interface that you define initially uses the default broadcast address (255.255.255.255) as the advertisement address. With RIP-1 updates, the address that you specify becomes the new RIP-1 advertisement address if you change the broadcast address. If you subsequently use RIP-2 (configure the interface to send RIP-2 advertisements) and have the RIP-1 compatibility mode disabled, the multicast address is used for updates.
- For the CoreBuilder 9000, each interface that you define initially uses the directed broadcast address as the RIP advertisement address (all 1s in the host field).
You can specify up to 64 advertisement addresses in separate iterations.
On the CoreBuilder 3500:
- After you add an advertisement address, you cannot subsequently change the broadcast address.
- If you are using RIP-2 for the interface, you must enable RIP compatibility mode if you want the system to use the advertisement list instead of the multicast address for RIP updates. See "ip rip compatibilityMode" earlier in this chapter for more information.
To add an advertisement address on other platforms, you must remove the directed broadcast address if you only want the address that you added to be used for RIP advertisements.

Options

Prompt

Description

Possible Values

[Default]

IP interfaces

Index number of the interfaces for which you want to add the advertisement address. Depends on interfaces configured

One or more selectable interfaces
? (for a list of selectable interfaces)

Previous entry, if applicable

Advertisement address

Selected IP address to be added to the list of advertisement addresses

A valid IP address

-

IP RIP Add Advertisement Example (3500)

: Select interface index {1-4|?} [1]: 1
: Interface 1 - Enter advertisement address: 158.101.255.1
ip rip remove Advertisement

For CoreBuilder 9000: Applies to Layer 3 switching modules only.

Removes an advertisement address from the list of RIP advertisement addresses for an interface.

Valid Minimum Abbreviation

: ip ri re

Options

Prompt

Description

Possible Values

[Default]

IP interfaces

Index number of the interfaces for which you want to remove the advertisement address; depends on interfaces configured

One or more selectable interfaces
? (for a list of selectable interfaces)

Previous entry, if applicable

Advertisement address

Advertisement address that you want to remove

An address from the advertisement list

-

ip rip policy summary

Displays summary information about RIP routing policies.

Valid Minimum Abbreviation

: ip ri pol s

Important Considerations

Your system has one unified IP routing table. Route policies enable you to control the flow of routing information between the network, the protocols, and the unified routing table on your system.
Route policies are classified as follows:
- Import policies import routing information from what RIP learns from a router/neighbor to the unified routing table. (You can also import routing information from OSPF.)
- Export policies send information from the routing table to RIP and RIP routers, which controls what is going out on the wire to the RIP domain. (You can also export from the routing table to OSPF.)
The system tracks policies that you define in both RIP and OSPF, so the indexes assigned to your policies may have gaps (for example, if you have RIP policies 1 and 2 and OSPF policies 3-6, the next policy is available for RIP or OSPF is 7).

Fields in the IP RIP Policy Summary Display

Field

Description

Action

Action for the route - accept or reject

Index

Index number of the policy

Protocol

Protocol (for example, RIP)

Route

Route that is affected by the policy

Source

Source router (all is from all routers)

Type

Whether the policy is an import or export policy

Weight

Administrative weight - 1 through 16

ip rip policy detail

Displays detailed information about RIP routing policies.

Valid Minimum Abbreviation

: ip ri pol det

Important Considerations

This display contains the summary information and two additional fields: Interface and Metric.
Route policies are classified as follows:
- Import policies import routing information from what RIP learns from a router/neighbor to the unified routing table. (You can also import routing information from OSPF.)
- Export policies send information from the routing table to RIP and RIP routers, which controls what is going out on the wire to the RIP domain. (You can also export from the routing table to OSPF.)

Fields in the IP RIP Policy Detail Display

Field

Description

Action

Action for the route - accept or reject

Index

Index number of the policy

Interface

Interface that is associated with the policy (all applies to all interfaces)

Metric

Assigned metric, a value 0 through 16 for RIP-1 or RIP-2 (metrics can use options +, -, /, *, and %)

Protocol

Protocol (for example, RIP)

Route

Route that is affected by the policy

Source

Source router (all is from all routers)

Type

Whether the policy is an import or export policy

Weight

Administrative weight - 1 through 16

ip rip policy define

Defines an import or export route policy for RIP.

Valid Minimum Abbreviation

: ip ri pol def

Important Considerations

Route policies are classified as follows:
- Import policies import routing information from what RIP learns from a router/neighbor to the unified routing table. (You can also import routing information from OSPF.)
- Export policies send information from the routing table to RIP and RIP routers, which controls what is going out on the wire to the RIP domain. (You can also export from the routing table to OSPF.)
The system assigns an index to each policy and takes into account all route policies set on the system, RIP and OSPF.
There are certain conditions associated with import and export policies. See the import and export policy tables that follow the Options table, next, for lists of the conditions.

Options

Prompt

Description

Possible Values

Field	Description
Domain name	Name of the domain name (up to 79 alphanumeric characters)
Name server	Name server that is associated with the domain

Prompt	Description	Possible Values	[Default]
Index	Index number of the name server IP address that you want to modify	A selectable server index number ? (for a list of selectable server indexes)	-
Name server IP address	New IP address of the name server that you want to use	A valid IP address	-

Field	Description
UDP port	UDP port number - 67
Forwarding address	Forwarding address used for UDP packets

Prompt	Description	Possible Values	[Default]
UDP port number	Port number for UDP	1 - 65535	67 (factory default), or current value
IP forwarding address	Forwarding addresses used for UDP packets	A valid IP address	-

Prompt	Description	Possible Values	[Default]
UDP port number	UDP port number that you want to remove	1 - 65535	67 (factory default), or current value
IP forwarding address	Forwarding addresses that you want to remove	A valid IP address	-

Field	Description
Advertisement Addresses (3500 and 9000 only)	List of available advertisement addresses. The list is used for RIP-2 updates only if the RIP-1 compatibility mode is enabled. RIP-1 always uses advertisement addresses.
Compatibility Mode (3500 only)	Whether RIP 1 compatibility mode is enabled or disabled (by default, `disabled`)
Cost (3500 and 9000 only)	RIP cost for the interface (by default, `1`)
Index	Index number of the interface
Poison Reverse (3500 and 9000 only)	Whether poison reverse mode is enabled or disabled (by default, `enabled`)
RIP-1 Mode	Mode for RIP-1. If you disable RIP-1, the output lists the state as off. Other modes are `learn` (default), `advertise`, and `enabled`.
RIP-2 Mode	Mode for RIP-2. If you disable RIP-2, the output lists the state as `off`. Other modes are `learn` (default), `advertise`, and `enabled`.
Route Aggregate (3500 only)	Whether Route Aggregation mode is enabled or disabled

Prompt	Description	Possible Values	[Default]
IP interfaces	Index number of the interfaces for which you want to set the RIP mode. Depends on interfaces configured.	One or more selectable interfaces all ? (for a list of selectable interfaces)	Previous entry, if applicable
RIP mode, Version 1	Selected RIP Version 1 mode that determines how the interface handles RIP 1 packets and updates	disabled learn advertise (3500/9000) enabled (3500/9000)	learn (factory default), or current value
RIP mode, Version 2 (not 9000)	Selected RIP mode that determines how the interface handles RIP 2 packets and updates	disabled learn advertise (3500 only) enabled (3500 only)	learn (factory default), or current value

Prompt	Description	Possible Values	[Default]
IP interfaces	Number of IP interfaces that you want to allow to receive route updates	1 - nn all	-
Password	Combination of characters that you set as the RIP-2 password	up to 16 alphanumeric characters none (null password)	none

Prompt	Description	Possible Values	[Default]
IP interfaces	Index number of the interfaces for which you want to add the advertisement address. Depends on interfaces configured	One or more selectable interfaces ? (for a list of selectable interfaces)	Previous entry, if applicable
Advertisement address	Selected IP address to be added to the list of advertisement addresses	A valid IP address	-

Field	Description
Action	Action for the route - `accept` or `reject`
Index	Index number of the policy
Protocol	Protocol (for example, `RIP`)
Route	Route that is affected by the policy
Source	Source router (`all` is from all routers)
Type	Whether the policy is an import or export policy
Weight	Administrative weight - `1` through `16`