|
|
The Apollo Domain routing protocol is the native-mode networking protocol for Apollo workstations. This chapter describes how to configure Apollo Domain routing. It also describes how to control access to the Apollo Domain network, optimize Apollo Domain network performance, and monitor the Apollo Domain network. For a complete description of the commands discussed in this chapter, refer to the "Configuring Apollo Domain" chapter in the Network Protocols Configuration Guide, Part 3.
To apply an access list to an interface, use the apollo access-group interface configuration command. To remove the access list, use the no form of this command.
apollo access-group access-list-name| access-list-name | Name of an access list to apply to the interface. |
No access list is applied by default.
Interface configuration
This command first appeared in Cisco IOS Release 10.3.
The apollo access-group command applies an access list to an interface. You use the apollo access-list command to specify the filtering conditions.
You can apply only one access list to an interface.
In the following example, the access list named eng is assigned to the first Ethernet interface:
interface ethernet 0
apollo access-group eng
You can use the master indexes or search online for documentation of related commands.
apollo access-list
show apollo interface
To define an Apollo Domain access list, use the apollo access-list global configuration command. To remove an access list, use the no form of this command.
apollo access-list access-list-name {deny | permit} [firstnet-]lastnet.host [wildcard-mask]| access-list-name | Name of the access list. |
| deny | Denies access if the conditions are matched. |
| permit | Permits access if the conditions are matched. |
| firstnet | (Optional) Number that specifies the lower limit of a selected Apollo network range. |
| lastnet.host | Number that specifies the upper limit of a selected Apollo network range. This is a 32-bit Apollo address consisting of a network number and a host number separated by a period. To specify all networks, use a value of -1. |
| wildcard-mask | (Optional) A wildcard mask that uses the one bits to ignore the host part of the network address. Host bits corresponding to wildcard mask bits set to zero are used in comparisons. |
No Apollo Domain access lists are defined.
Global configuration
This command first appeared in Cisco IOS Release 10.3.
Use this command in conjunction with the apollo access-group command to restrict access to the Apollo network. Apollo Domain access lists are collections of permit and deny conditions that apply to defined Apollo network and host numbers. The Cisco IOS software sequentially tests the network and host numbers against conditions set in the access lists. The first match determines whether the software accepts or rejects the network and host number. Because the software stops testing conditions after the first match, the order of the conditions is critical. If no conditions match, the software rejects the network and host number.
Apollo Domain access lists are identified by a name, not by a number.
You can define Apollo access lists for a single network or for a range of Apollo networks. An access list can contain an indefinite number of actual and wildcard addresses. A wildcard address has a nonzero mask and thus potentially matches more than one actual address. The software examines the actual addresses, then the wildcard addresses. The order of the wildcard addresses is important because the software stops examining access list entries once it finds a match.
After creating an access list, apply the list restrictions to specific interfaces with the apollo access-group command.
In the following example, the first line denies access to networks 3a to 3f, the second line denies access to a specific host, and the third line permits everyone else:
apollo access-list eng deny 3a-3f.0 fffff
apollo access-list eng deny 5fe.1293c
apollo access-list eng permit -1.0 ffff
You can use the master indexes or search online for documentation of related commands.
apollo access-group
show apollo interface
To set the maximum number of paths the Cisco IOS software uses when sending packets, use the apollo maximum-paths global configuration command. To restore the default value, use the no form of this command.
apollo maximum-paths paths| paths | Maximum number of equal-cost paths from which the software chooses. The argument paths can be a value from 1 to 512. The default is 1. |
1 path
Global configuration
This command first appeared in Cisco IOS Release 10.3.
A router can use multiple paths to reach an Apollo Domain destination in order to increase throughput in the network. By default, the Cisco IOS software picks one best path and sends all traffic on this path. However, you can configure it to remember two or more paths that have equal costs and to balance the traffic load across all the available paths. (Note that when paths have differing costs, the software chooses lower-cost routes in preference to higher-cost routes.) Packets are distributed over the multiple paths in round-robin fashion on a packet-by-packet basis. That is, the first packet is sent along the first path, the second packet along the second path, and so on. If the final path is reached before all packets are sent, the next packet is sent to the first path, the next to the second path, and so on.
Limiting the number of equal-cost paths can save memory on routers with limited memory or with very large configurations. Additionally, in networks with a large number of multiple paths and systems with limited ability to cache out-of-sequence packets, performance might suffer when traffic is split between many paths.
The following command sets a maximum of three equal-cost paths:
apollo maximum-paths 3
You can use the master indexes or search online for documentation of related commands.
To enable Apollo Domain routing on a particular interface, use the apollo network interface configuration command. To disable Apollo Domain routing on an interface, use the no form of this command.
apollo network numbernumber | Network number. This is an eight-digit hexadecimal number consisting of the network address followed by the host address. |
Disabled
Interface configuration
This command first appeared in Cisco IOS Release 10.3.
You must enable Apollo Domain routing on the router with the apollo routing command before issuing the apollo network command.
The following example enables Apollo Domain routing, specifying that Apollo networks 5f and 4e are connected to two of the router's Ethernet interfaces:
apollo routing 23d5a
interface ethernet 0
apollo network 5f
interface ethernet 1
apollo network 4e
You can use the master indexes or search online for documentation of related commands.
apollo routing
show apollo interface
To add a static route to the Apollo Domain routing table, use the apollo route global configuration command. To remove a route from the routing table, use the no form of this command.
apollo route destination-network network.host| destination-network | Network to which you want to establish a static route. This is a 12-bit hexadecimal number. You can omit leading zeros. |
| network.host | Network address of the router to which to forward packets destined for destination-network.
The argument network is a 12-bit hexadecimal number. You can omit leading zeros. The argument host is the host number of the target router. This is a 20-bit hexadecimal value. |
No routes are predefined in the routing table.
Global configuration
This command first appeared in Cisco IOS Release 10.3.
Static routes always override any paths determined by metrics.
Be careful when assigning static routes. When links associated with static routes are lost, traffic may stop being forwarded even though alternative paths might be available.
In the following example, all packets addressed to network 33 are forwarded to a router at the address of 45.91ac6:
apollo route 33 45.91ac6
You can use the master indexes or search online for documentation of related commands.
To enable Apollo Domain routing, use the apollo routing global configuration command. To disable Apollo Domain routing, use the no form of this command.
apollo routing host| host | Host number of the router. This is a five-digit hexadecimal host address that is unique across the Apollo Domain internetwork. |
Disabled
Global configuration
This command first appeared in Cisco IOS Release 10.3.
This command must be used in conjunction with the apollo network command.
In the following example, Apollo Domain routing is enabled on the router whose host address is 23d5a:
apollo routing 23d5a
You can use the master indexes or search online for documentation of related commands.
apollo network
show apollo interface
To set the interval between Apollo Domain routing updates, use the apollo update-time interface configuration command. To restore the default value, use the no form of this command.
apollo update-time interval| interval | Interval, in seconds, at which Apollo Domain routing updates are sent. The minimum interval is 10 seconds, and the maximum is 2493644 seconds. The default is 30 seconds. |
30 seconds
Interface configuration
This command first appeared in Cisco IOS Release 10.3.
The apollo update-time command sets the routing update timer on a per-interface basis. To display the current value, use the show apollo route command.
Routers exchange information about routes by sending broadcast messages when they are brought up and shut down, and periodically while they are running. The apollo update-time command lets you modify the periodic update interval.
You can set Routing Information Protocol (RIP) timers only in a configuration in which all routers are Cisco routers. The timers should be the same for all devices connected to the network.
The update interval you choose affects the internal Apollo Domain timers as follows:
The concept of granularity is best explained by an example. (This is illustrated in the "Example" section below.) If you have two interfaces in the router and you set the update timer on one to 20 seconds and the other to 30 seconds, the Cisco IOS software wakes up every 20 seconds to try to send routing updates. So at time 0:00:20, the software sends an update out the first interface only, and at time 0:00:40 it sends updates out the first and second interfaces. The software does not wake up at 0:00:30 to see if it needs to send an update out the second interface. This means that routing updates are sent out the second interface at N:NN:40 and N:NN:00. That is, the interval alternates between 40 seconds and 20 seconds; it is never 30 seconds. The interval on the first interface is always 20 seconds.
Ensure that all timers are the same for all routers attached to the same network segment.
Do not use the apollo update-time command in a multivendor router environment.
The following example sets the update timers on three interfaces in the router. The update timer granularity would be 20 seconds because this is the lowest value specified.
interface serial 0
apollo update-time 40
interface ethernet 0
apollo update-time 20
interface ethernet 1
apollo update-time 25
You can use the master indexes or search online for documentation of related commands.
To list the entries in the Apollo Domain Address Resolution Protocol (ARP) table, use the show apollo arp EXEC command.
show apollo arpThis command has no arguments or keywords.
EXEC
This command first appeared in Cisco IOS Release 10.3.
The following is sample output from the show apollo arp command:
Router# show apollo arp
Protocol Address Age (min) Hardware Addr Type Interface
Apollo 123A.CAFE - 0000.0c00.62e6 ARPA Ethernet0
Table 1 describes the fields shown in the display.
| Field | Description |
|---|---|
| Protocol | Protocol for which the interface has been configured. This should be Apollo. |
| Address | Apollo address of the interface. |
| Age (min) | Time, in minutes, that this entry has been in the ARP table. A hyphen indicates that this is a new entry. |
| Hardware Addr | MAC address of this interface. |
| Type | Encapsulation type. |
| Interface | Type and number of the interface. |
To display the status of the Apollo Domain interfaces configured in the router and the parameters configured on each interface, use the show apollo interface EXEC command.
show apollo interface [type number]| type | (Optional) Interface type. It can be one of the following types: asynchronous, dialer, Ethernet (IEEE 802.3), loopback, null, serial, or tunnel. |
| number | (Optional) Interface number. |
EXEC
This command first appeared in Cisco IOS Release 10.3.
The following is sample output from the show apollo interface command:
Router# show apollo interface ethernet 0
Ethernet 0 is up, line protocol is up
Apollo address is 123A.CAFE
Update time is 30 seconds
Outgoing access list is not set
Table 2 describes the fields shown in the display.
| Field | Description |
|---|---|
| Ethernet 0 is... | The interface is currently active and inserted into the network (up) or is inactive and not inserted (down). |
| line protocol is... | Indicates whether the software processes that handle the line protocol believe that the interface is usable (that is, whether keepalives are successful). |
| Apollo address is 123A.CAFE | Address of the Apollo Domain interface, followed by its subnet mask, if any. |
| Update time is 30 seconds | How often the Cisco IOS software sends RIP updates, as configured with the apollo update-time command. |
| Outgoing access list is not set | Indicates whether an access list has been enabled with the apollo access-list command. |
You can use the master indexes or search online for documentation of related commands.
apollo access-group
apollo access-list
apollo update-time
To display the contents of the Apollo Domain routing table, use the show apollo route EXEC command.
show apollo route [network]| network | (Optional) Number of the network that the route is to. This is a 12-bit hexadecimal number. |
EXEC
This command first appeared in Cisco IOS Release 10.3.
The following is sample output from the show apollo route command:
Router# show apollo route
Codes: R - RIP derived, C - connected, S - static, 1 learned routes
Maximum allowed path(s) are/is 1
C Net 123A is directly connected, 0 uses, Ethernet0
C Net 123B is directly connected, 0 uses, Ethernet1
R Net 123C [1/0] via 123A.CAFB, 4 sec, 0 uses, Ethernet0
Table 3 describes the fields shown in the display.
| Field | Description |
|---|---|
| Codes: | Codes defining source of route. |
| R | Route learned from a RIP update. |
| C | Directly connected network. |
| S | Statically defined route via the apollo route command. |
| l learned routes | Number of routes learned from RIP updates. |
| Maximum allowed path(s) are/is 1 | Maximum number of paths for which the Cisco IOS software has been configured with the apollo maximum-paths command. |
| Net 123A | Apollo network number. |
| Is directly connected | Indicates that this network is directly connected to the router. |
| Uses | Fair estimate of the number of times a route gets used. It actually indicates the number of times the route has been selected for use prior to operations such as access list filtering. |
| Ethernet 0 | Possible interface through which you can reach the remote network via the specified router. |
| [1/0] | Delay/Metric. The delay is the delay between sending routing updates. The metric is the Apollo Domain metric used in making routing decisions. |
| Via | Address of a router that is the next hop to the remote network. |
| Sec | Number of seconds since information about this network was last heard. |
You can use the master indexes or search online for documentation of related commands.
apollo maximum-paths
apollo route
To display information about the number and type of Apollo Domain packets transmitted and received by the Cisco IOS software, use the show apollo traffic EXEC command.
show apollo trafficThis command has no arguments or keywords.
EXEC
This command first appeared in Cisco IOS Release 10.3.
The following is sample output from the show apollo traffic command:
Router# show apollo traffic
Rcvd: 8 total, 0 format errors, 0 checksum errors, 0 bad hop count,
8 local destination, 0 multicast
Bcast: 8 received, 0 sent
Sent: 16 generated, 0 forwarded
0 encapsulation failed, 0 no route
0 unknown
Table 4 describes the fields shown in the display.
| Field | Description |
|---|---|
| Rcvd: | Description of the Apollo Domain packets received. |
| 8 total | Total number of packets received. |
| 0 format errors | Number of bad packets discarded (for example, packets with a corrupted header). |
| 0 checksum errors | Number of packets discarded because they contained checksum errors. This field should always have a value of 0, because Apollo Domain does not use a checksum. |
| 0 bad hop count | Number of packets discarded because their hop count exceeded 16 (that is, the packets timed out). |
| 8 local destination | Number of packets sent to the local broadcast address or specifically to the router. |
| 0 multicast | Number of packets received that were addressed to multiple destinations. |
| Bcast: | Number of broadcast packets received and sent. |
| Sent: | Description of the Apollo Domain packets sent. |
| 16 generated | Number of packets the router transmitted that it generated itself. |
| 0 forwarded | Number of packets the router transmitted that it forwarded from other sources. |
| 0 encapsulation failed | Number of packets the router was unable to encapsulate. |
| 0 no route | Number of times the router could not locate in the routing table a route to the destination. |
| Unknown: | Number of packets the router was unable to forward, for example, because of a misconfigured helper address or because no route was available. |
|
|