cc/td/doc/product/software/ios113ed/113ed_cr
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Apollo Domain Commands

Apollo Domain Commands

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.


Note Not all Cisco access servers support the Apollo Domain protocol. For more information, refer to the release notes for the current Cisco IOS release.

apollo access-group

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
no apollo access-group
Syntax Description
access-list-name Name of an access list to apply to the interface.
Default

No access list is applied by default.

Command Mode

Interface configuration

Usage Guidelines

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.

Example

In the following example, the access list named eng is assigned to the first Ethernet interface:

interface ethernet 0  apollo access-group eng
Related Commands

You can use the master indexes or search online for documentation of related commands.

apollo access-list
show apollo interface

apollo access-list

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]
no apollo access-list access-list-name
Syntax Description
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.
Default

No Apollo Domain access lists are defined.

Command Mode

Global configuration

Usage Guidelines

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.

Example

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
Related Commands

You can use the master indexes or search online for documentation of related commands.

apollo access-group
show apollo interface

apollo maximum-paths

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
no apollo maximum-paths
Syntax Description
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.
Default

1 path

Command Mode

Global configuration

Usage Guidelines

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.

Example

The following command sets a maximum of three equal-cost paths:

apollo maximum-paths 3
Related Commands

You can use the master indexes or search online for documentation of related commands.

show apollo route

apollo network

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 number
no apollo network number
Syntax Description

number

Network number. This is an eight-digit hexadecimal number consisting of the network address followed by the host address.
Default

Disabled

Command Mode

Interface configuration

Usage Guidelines

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.

Example

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
Related Commands

You can use the master indexes or search online for documentation of related commands.

apollo routing
show apollo interface

apollo route

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
no apollo route
destination-network network.host
Syntax Description
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.

Default

No routes are predefined in the routing table.

Command Mode

Global configuration

Usage Guidelines

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.

Example

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
Related Commands

You can use the master indexes or search online for documentation of related commands.

show apollo route

apollo routing

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
no apollo routing host
Syntax Description
host Host number of the router. This is a five-digit hexadecimal host address that is unique across the Apollo Domain internetwork.
Default

Disabled

Command Mode

Global configuration

Usage Guidelines

This command first appeared in Cisco IOS Release 10.3.

This command must be used in conjunction with the apollo network command.

Example

In the following example, Apollo Domain routing is enabled on the router whose host address is 23d5a:

apollo routing 23d5a
Related Commands

You can use the master indexes or search online for documentation of related commands.

apollo network
show apollo interface

apollo update-time

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
no apollo update-time
Syntax Description
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.
Default

30 seconds

Command Mode

Interface configuration

Usage Guidelines

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:

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.

Example

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
Related Commands

You can use the master indexes or search online for documentation of related commands.

show apollo interface

show apollo arp

To list the entries in the Apollo Domain Address Resolution Protocol (ARP) table, use the show apollo arp EXEC command.

show apollo arp
Syntax Description

This command has no arguments or keywords.

Command Mode

EXEC

Usage Guidelines

This command first appeared in Cisco IOS Release 10.3.

Sample Display

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.


Table  1: Show Apollo ARP Field Descriptions
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.

show apollo 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]
Syntax Description
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.
Command Mode

EXEC

Usage Guidelines

This command first appeared in Cisco IOS Release 10.3.

Sample Display

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.


Table  2: Show Apollo Interface Field Descriptions
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.
Related Commands

You can use the master indexes or search online for documentation of related commands.

apollo access-group
apollo access-list
apollo update-time

show apollo route

To display the contents of the Apollo Domain routing table, use the show apollo route EXEC command.

show apollo route [network]
Syntax Description
network (Optional) Number of the network that the route is to. This is a 12-bit hexadecimal number.
Command Mode

EXEC

Usage Guidelines

This command first appeared in Cisco IOS Release 10.3.

Sample Display

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.


Table 3: Show Apollo Route Field Descriptions (Continued)
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.
Related Commands

You can use the master indexes or search online for documentation of related commands.

apollo maximum-paths
apollo route

show apollo traffic

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 traffic
Syntax Description

This command has no arguments or keywords.

Command Mode

EXEC

Usage Guidelines

This command first appeared in Cisco IOS Release 10.3.

Sample Display

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.


Table 4: Show Apollo Traffic Field Descriptions (Continued)
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.

hometocprevnextglossaryfeedbacksearchhelp
Copyright 1989-1997 © Cisco Systems Inc.