This document describes how to configure the TCP/IP host services protocol and how to use the TCP/IP host configuration and monitoring commands. It includes the following sections:
Accessing the TCP/IP Host Configuration Environment
Bridge-only Management
Basic Configuration Procedures
TCP/IP Host Commands
Accessing the TCP/IP Host Configuration Environment
To access the TCP/IP host configuration prompt, enter protocol hst at the Config> prompt.
To access the TCP/IP host monitoring prompt, enter protocol hst at theConfig>protocol hst
TCP/IP-Host Services user configuration
TCP/IP-Host config>
Monitor> prompt.Monitor> protocol hst
TCP/IP-Host Services user configuration
TCP/IP-Host>
Management through SNMP
Telnet server functionality
Downloading and uploading of a configuration through the TFTP protocol
TFTP neighbor boot functionality
IP diagnostic tools of ping and traceroute
Control of the device through SNMP sets and the telnet client.
TCP/IP host services is available whenever bridging is an option in the router software load. These services co-exist with the IP routing functionality but do not require that IP routing be present.
Basic Configuration Procedures
The following sections describe the basic configuration procedures for enabling TCP/IP host services.
TCP/IP-Host config>set ip-host address
IP-Host address [0.0.0.0]? 10.1.130.98
Address mask [255.0.0.0]?
IP-Host address set.
TCP/IP-Host config>add default-gateway
Default-Gateway address [0.0.0.0]? 101.25.3.1
TCP/IP-Host config>enable services
[C] means the command is available at the HST config> prompt.
[M] means the command is available at the HST> prompt.
Not all parameters apply to all router platforms. Press Space twice after you type a command to display the available parameters for each command for your router. Enter help for information about using the command line interface.
| Command | Function |
|---|---|
| Add [C] | Adds a default gateway. |
| Delete [C] | Deletes a default gateway. |
| Disable [C] | Disables TCP/IP host services, router discovery processes, and RIP listening. |
| Dump [M] | Displays the current IP routing table. One line is printed for each destination. |
| Enable [C] | Enables TCP/IP host services, router discovery processes, and RIP listening. |
| Exit [C] [M] | Exits the TCP/IP host configuration or monitoring process. |
| Interface [M] | Displays the IP addresses configured for each interface. |
| List [C] | Lists the current TCP/IP Host configuration. |
| Ping [M] | Continuously pings a given destination, printing a line for each response received. |
| Routers [M] | Displays the list of all IP routers known to the bridging router. |
| Set [C] | Sets the router's IP address. |
| Traceroute [M] | Displays the hop-by-hop route to a given destination. |
Add [C]
Adds default gateways (routers) to your configuration. When you designate a router as the default gateway, it exists as the static authoritative router that receives all packets having destinations not found in the routing table.
Default gateways send packets to IP destinations that are off the local connection. The routing table is then built up through redirect processing. An attempt is made to detect routers that disappear. If the router is a CNX 500 and has booted over the the network (via TFTP/BootP), then the default gateway is configured using the information from the booting process.
Obtaining default gateway information via the booting process is applicable to the CNX 500 only. It does not apply to a CNX 500 booted with an IBD.
Syntax: add default-gateway IP-address
Example:add default-gateway
Default-Gateway address [0.0.0.0]?
Syntax: delete default-gateway IP-address
Example:delete default-gateway
Enter address to be deleted [0.0.0.0]?
Example: disable rip-listening
router-discovery
Disables the ability to learn default gateways by receiving ICMP Router discovery messages. By default, router discovery is enabled.
Example: disable router-discovery
services
Disables the TCP/IP host services protocol entirely. By default, TCP/IP host services are enabled.
Dump [M]
Displays the current IP routing table. One line is printed for each destination. Many of the entries are the result of ICM redirects.
dump
Type Dest net Mask Cost Age Next hop(s)
Stat 0.0.0.0 00000000 0 0 128.185.142.47
Dir* 128.185.142.0 FFFFFF00 1 0 BDG/0
Default gateway in use.
Type Cost Age Next hop
Stat 0 0 128.185.142.47
Routing table size: 768 nets (43008 bytes), 2 nets known
Enable [C]
Enables the following TCP/IP functions:
router-discovery
Enables the learning of default gateways through reception of ICMP Router Discovery messages. By default, router discovery is enabled.
Example: enable router-discovery
services
Enables the TCP/IP host services protocol. By default, TCP/IP host services are enabled.
Exit [C] [M]
Returns to the previous prompt level.
exit
Interface [M]
Lists the IP addresses configured for the router. When TCP/IP host services are running over the bridge, a single address displays as BDG/0.
interface
Interface IP Address(es) Mask
BDG/0 128.185.142.16 255.255.255.0
List [C]
Displays information about the current TCP/IP Host configuration.
list all
IP-Host IP address : 128.185.142.1
Address mask : 255.255.255.0
Default Gateway IP-address(es)
128.185.142.47
TCP/IP-Host Services Enabled.
RIP-LISTENING Disabled.
Router Discovery Enabled
Ping [M]
Instructs the router to send ICMP Echo Requests to a destination once a second and watch for a response. Use this command to isolate trouble in an internetwork environment.
This process is done continuously, incrementing the ICMP sequence number with each additional packet. Matching received ICMP Echo responses are reported with their sequence number and the round-trip time. The granularity (time resolution) of the round-trip time calculation is usually (depending on platform) around 20 milliseconds. Pinging stops when you type a character. At that time, a summary of packet loss, round-trip time, and number of ICMP destination unreachables received is displayed.
When you enter a multicast address as destination, there may be multiple responses printed for each packet sent, one for each group member. Each returned response is displayed with the source address of the responder.
The size of the ping (number of data bytes in the ICMP message, excluding the ICMP header) is 56 bytes, and the TTL used is 60.
Syntax: ping interface-address
Example:ping 128.185.142.11
PING 128.185.142.11: 56 data bytes
64 bytes from 128.185.142.11: icmp_seq=0. time=0. ms
64 bytes from 128.185.142.11: icmp_seq=1. time=0. ms
64 bytes from 128.185.142.11: icmp_seq=2. time=0. ms
64 bytes from 128.185.142.11: icmp_seq=3. time=0. ms
64 bytes from 128.185.142.11: icmp_seq=4. time=0. ms
64 bytes from 128.185.142.11: icmp_seq=5. time=0. ms
----128.185.142.11 PING Statistics----
6 packets transmitted, 6 packets received, 0% packet loss
round-trip (ms) min/avg/max = 0/0/0
Static configuration (using the add default-gateway command)
Received ICMP redirects
ICMP Router Discovery messages (if configured)
RIP updates (if configured)
routers
Set [C]
Sets the router's IP address. You must assign an IP address before enabling TCP/IP host services.
If the IP address is not already configured, it is set (by default) using boot information. This process applies only to the CNX 500 and only if it is a network host.
Syntax: set ip-host address IP-host-address
Example:set ip-host address
IP-Host address [0.0.0.0]? 123.45.67.89
Address mask [255.255.0.0]?
The trace route is complete when either the destination is reached, an ICMP Destination Unreachable message is received, or the path length reaches 32 router hops.
Syntax: traceroute interface-address
Example:traceroute 128.185.142.239
TRACEROUTE 128.185.142.239: 56 data bytes
1 128.185.142.7 16 ms 0 ms 0 ms
2 128.185.123.22 16 ms 0 ms 16 ms
3 * * *
4 * * *
5 128.185.124.110 16 ms ! 0 ms ! 0 ms !
When a probe receives an unexpected result (see the above output example), several indicators can be printed. These indicators are explained in the following table.