Você está na página 1de 82

User Manual Command Reference (Volume 1) Versatile Routing Platform

Table of Contents

Table of Contents
Chapter 1 IP Address Configuration Commands................................................................. 1-1 1.1 IP Address Configuration Commands ......................................................................... 1-1 1.1.1 ip address....................................................................................................... 1-1 1.1.2 ip address negotiate........................................................................................ 1-2 1.1.3 hostname ....................................................................................................... 1-3 1.1.4 ip unnumbered................................................................................................ 1-3 1.1.5 show hostname............................................................................................... 1-4 1.1.6 show ip interface............................................................................................. 1-5 1.2 ARP Configuration Commands .................................................................................. 1-5 1.2.1 arp ................................................................................................................. 1-5 1.2.2 clear arp-cache ............................................................................................... 1-6 1.2.3 show arp......................................................................................................... 1-7 1.2.4 debug arp ....................................................................................................... 1-7 1.3 Proxy ARP Configuration Commands ......................................................................... 1-7 1.3.1 ip proxy-arp .................................................................................................... 1-8 1.4 DNS Configuration Commands .................................................................................. 1-8 1.4.1 host................................................................................................................ 1-8 1.4.2 show host....................................................................................................... 1-9 1.5 NAT Configuration Commands .................................................................................. 1-9 1.5.1 nat clear ....................................................................................................... 1-10 1.5.2 nat inside interface........................................................................................ 1-10 1.5.3 nat inside pool............................................................................................... 1-11 1.5.4 nat pool ........................................................................................................ 1-11 1.5.5 nat server ..................................................................................................... 1-12 1.5.6 nat timeout.................................................................................................... 1-13 1.5.7 show nat....................................................................................................... 1-14 1.5.8 debug nat ..................................................................................................... 1-14 1.6 DHCP Configuration Commands.............................................................................. 1-15 1.6.1 ip forward-protocol udp .................................................................................. 1-15 1.6.2 ip helper-address .......................................................................................... 1-16 1.6.3 show ip forward-protocol................................................................................ 1-16 1.6.4 show ip helper-address ................................................................................. 1-16 1.6.5 debug forward-protocol.................................................................................. 1-17 1.7 VLAN configuration commands ................................................................................ 1-17 1.7.1 encapsulation dot1q ...................................................................................... 1-17 1.7.2 interface ethernet .......................................................................................... 1-18 1.7.3 show vlan ..................................................................................................... 1-18

User Manual Command Reference (Volume 1) Versatile Routing Platform

Table of Contents

Chapter 2 IP Performance Configuration Commands.......................................................... 2-1 2.1 clear ip counters ....................................................................................................... 2-1 2.2 ifquelen arp .............................................................................................................. 2-1 2.3 ifquelen interface...................................................................................................... 2-2 2.4 ifquelen ip................................................................................................................. 2-3 2.5 ifquelen ipx ............................................................................................................... 2-3 2.6 ip route-cache........................................................................................................... 2-4 2.7 ip tcp header-compression......................................................................................... 2-4 2.8 mtu.......................................................................................................................... 2-5 2.9 tcp finwait-time.......................................................................................................... 2-6 2.10 tcp synwait-time ...................................................................................................... 2-7 2.11 tcp window-size ...................................................................................................... 2-7 2.12 show ip cache......................................................................................................... 2-8 2.13 show ip interface..................................................................................................... 2-9 2.14 show ip traffic.......................................................................................................... 2-9 2.15 show tcp brief ....................................................................................................... 2-10 Chapter 3 IPX Configuration Commands............................................................................. 3-1 3.1 clear ipx counters...................................................................................................... 3-1 3.2 ipx default-route........................................................................................................ 3-2 3.3 ipx delay................................................................................................................... 3-2 3.4 ipx encapsulation ...................................................................................................... 3-3 3.5 ipx gns-reply-disable ................................................................................................. 3-3 3.6 ipx gns-round-robin................................................................................................... 3-4 3.7 ipx max-paths ........................................................................................................... 3-4 3.8 ipx max-reserve-paths ............................................................................................... 3-5 3.9 ipx max-reserve-servers ............................................................................................ 3-6 3.10 ipx network ............................................................................................................. 3-7 3.11 ipx rip-max-packetsize............................................................................................. 3-8 3.12 ipx rip-multiplier....................................................................................................... 3-8 3.13 ipx rip-update-time .................................................................................................. 3-9 3.14 ipx route............................................................................................................... 3-10 3.15 ipx routing............................................................................................................. 3-11 3.16 ipx sap ................................................................................................................. 3-12 3.17 ipx sap-max-packetsize......................................................................................... 3-13 3.18 ipx sap-multiplier ................................................................................................... 3-14 3.19 ipx sap-update-time............................................................................................... 3-14 3.20 ipx type-20-propagation......................................................................................... 3-15 3.21 ipx split-horizon..................................................................................................... 3-16 3.22 ipx touch-off.......................................................................................................... 3-16 3.23 show ipx interface ................................................................................................. 3-16 3.24 show ipx route....................................................................................................... 3-18 3.25 show ipx servers ................................................................................................... 3-20

ii

User Manual Command Reference (Volume 1) Versatile Routing Platform

Table of Contents

3.26 show ipx traffic...................................................................................................... 3-21 Chapter 4 DLSw Configuration Commands......................................................................... 4-1 4.1 clear dlsw bridge-entry .............................................................................................. 4-1 4.2 clear dlsw circuits...................................................................................................... 4-2 4.3 dlsw bridge-group (Ethernet interface configuration).................................................... 4-2 4.4 dlsw bridge-group (Ethernet interface configuration).................................................... 4-3 4.5 dlsw bridge-group (synchronous interface configuration).............................................. 4-3 4.6 dlsw disable.............................................................................................................. 4-4 4.7 dlsw local-peer tcp.................................................................................................... 4-4 4.8 dlsw remote-peer tcp................................................................................................. 4-5 4.9 dlsw timer................................................................................................................. 4-6 4.10 encapsulation sdlc .................................................................................................. 4-7 4.11 idle-mark ................................................................................................................ 4-8 4.12 llc2 ack-delay-time .................................................................................................. 4-8 4.13 llc2 ack-max ........................................................................................................... 4-9 4.14 llc2 local-window ................................................................................................... 4-10 4.15 llc2 modulus ......................................................................................................... 4-10 4.16 llc2 N2.................................................................................................................. 4-11 4.17 llc2 t1-time............................................................................................................ 4-11 4.18 llc2 tbusy-time....................................................................................................... 4-12 4.19 llc2 tpf-time........................................................................................................... 4-12 4.20 llc2 trej-time .......................................................................................................... 4-13 4.21 llc2 txq-max .......................................................................................................... 4-13 4.22 sdlc address ......................................................................................................... 4-14 4.23 sdlc holdq ............................................................................................................. 4-14 4.24 sdlc k ................................................................................................................... 4-15 4.25 sdlc modulus ........................................................................................................ 4-15 4.26 sdlc n1 ................................................................................................................. 4-16 4.27 sdlc n2 ................................................................................................................. 4-16 4.28 sdlc partner........................................................................................................... 4-17 4.29 sdlc poll-pause-timer ............................................................................................. 4-18 4.30 sdlc saps .............................................................................................................. 4-18 4.31 sdlc simultaneous ................................................................................................. 4-19 4.32 sdlc T1 ................................................................................................................. 4-19 4.33 sdlc T2 ................................................................................................................. 4-20 4.34 sdlc xid................................................................................................................. 4-20 4.35 sdlc role................................................................................................................ 4-21 4.36 sdlc vmac ............................................................................................................. 4-22 4.37 show dlsw bridge-entry .......................................................................................... 4-22 4.38 show dlsw capabilities ........................................................................................... 4-22 4.39 show dlsw circuits ................................................................................................. 4-23 4.40 show dlsw peers ................................................................................................... 4-24

iii

User Manual Command Reference (Volume 1) Versatile Routing Platform

Table of Contents

4.41 show dlsw reachability........................................................................................... 4-24 4.42 debug dlsw........................................................................................................... 4-25 4.43 debug sllc............................................................................................................. 4-25

iv

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 1
IP Address Configuration Commands

Chapter 1 IP Address Configuration Commands


1.1 IP Address Configuration Commands
l l l l l l ip address ip address negotiate hostname ip unnumbered show hostname show ip interface

1.1.1 ip address
To set a primary or secondary IP address for an interface, use the ip address command. To remove an IP address or disable IP processing, use the no form of this command. ip address ip-address mask [ secondary ] no ip address [ ip-address ]

Syntax Description
ip-address IP address. net-mask mask for the associated IP subnet. It is all in decimal format divided by dots. If there is no ip-address in the command no ip address, delete all the ip-address of the interface. secondary specifies that the configured address is a secondary IP address. If this keyword is omitted, the configured address is the primary IP address.

Default
No IP address is defined for the interface

Command Mode
Interface configuration mode

Usage Guideline
An interface can have one primary IP address and multiple secondary IP addresses. Packets generated by the software always use the primary IP address. Therefore, all routers and access servers on a segment should share the same primary network number. Hosts can determine subnet masks using the Internet Control Message Protocol (ICMP) Mask Request message. Routers respond to this request with an ICMP Mask Reply message.

1-1

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 1
IP Address Configuration Commands

You can disable IP processing on a particular interface by removing its IP address with the no ip address command. If the software detects another host using one of its IP addresses, it will print an error message on the console. The optional keyword secondary allows you to specify an unlimited number of secondary addresses. Secondary addresses are treated like primary addresses, except the system never generates datagrams other than routing updates with secondary source addresses. IP broadcasts and ARP requests are handled properly, as are interface routes in the IP routing table. Normally, an interface has an IP address. In order for one interface of the router to interconnect with multiple nets, an interface can have multiple IP addresses. One of them is the main IP address, and the others are secondary IP addresses. Following is the relationship between the main and secondary IP addresses during their configuration: l l l If the interface already has an IP address when the main IP address is configured, then the existing IP address should be deleted. The first IP address automatically becomes the main IP address according to the time sequence If there is no IP address when the secondary IP address is configured, this secondary IP address automatically become the main IP address automatically. If there is an IP address when the address to be deleted is the current IP address, the first IP address automatically becomes the main IP address according to the time sequence.

In addition, all the IP addresses configured at the interfaces in the router can not be located in the same net. If the no ip address command is not followed by ip-address, then all the IP addresses at this interface are all deleted.

Example
! Configure a main IP address 129.102.0.1 for Serial 0, and the secondary IP address is 202.38.160.1. Quidway(config-if-Serial0)# ip address 129.102.0.1 255.255.255.0 Quidway(config-if-Serial0)# ip address 202.38.160.1 255.255.255.0 secondary

Related Command
ip route, show ip interface, show interface

1.1.2 ip address negotiate


To allow IP address negotiated at the interface, use the ip address negotiate command. To disable this function, use the no form of this command. ip address negotiate no ip address negotiate

Default
Disabled

1-2

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 1
IP Address Configuration Commands

Command Mode
Interface configuration mode

Usage Guideline
PPP supports IP address negotiation. IP address negotiation at the interface can be set only when PPP is encapsulated at the interface. Normally, it is necessary to configure ip address negotiate command. Only in some special circumstances such as accessing Internet through the ISP, are the IP addresses of the interface that is connected with the ISP allocated by the ISP through negotiation. When IP address negotiate for the interface is configured, it is not necessary to configure the IP address for this interface.

Example
! Allow IP address to be negotiated at Serial 0. Quidway(config-if-Serial0)# ip address negotiate

1.1.3 hostname
To define host name for the router, use the hostname command. hostname hostname

Syntax Description
hostname in a character, ranging 1 to 20 characters.

Default
The default hostname for the router is Quidway

Command Mode
Global configuration mode

Example
! Set the hostname as huawei Quidway(config)# hostname huawei
Huawei(config)#

1.1.4 ip unnumbered
To enable IP processing on a serial interface without assigning an explicit IP address to the interface, use the ip unnumbered command. To disable the IP processing on the interface, use the no form of this command. ip unnumbered interface-type interface-number

1-3

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 1
IP Address Configuration Commands

no ip unnumbered

Syntax Description
interface-type address. type of another interface on which the router has an assigned IP

interface-number number of another interface on which the router has an assigned IP address.

Default
Disabled

Command Mode
Interface configuration mode

Usage Guideline
Whenever the unnumbered interface generates a packet (for example, for a routing update), it uses the address of the specified interface as the source address of the IP packet. It also uses the address of the specified interface in determining which routing processes are sending updates over the unnumbered interface. Restrictions include the following: 1) Serial interfaces using HDLC, PPP, Balanced (LAPB), and Frame Relay encapsulations, as well as Serial Line Internet Protocol (SLIP) and tunnel interfaces can be unnumbered. It is not possible to use this interface configuration command with X.25 or Switched Multimegabit Data Service (SMDS) interfaces. You cannot use the ping command to determine whether the interface is up, because the interface has no address. Simple Network Management Protocol (SNMP) can be used to remotely monitor interface status. You cannot netboot a runnable image over an unnumbered serial interface. You cannot support IP security options on an unnumbered interface.

2)

3) 4)

The interface you specify by the type and number arguments must be enabled (listed as "up" in the show interfaces command display). The interface-type interface-number cannot be another unnumbered interface.

Example
! Allow IP unnumbered from Ethernet 0 encapsulated with PPP. Quidway(config-if-Serial0)# ip unnumbered ethernet 0

Related Command
ip proxy-arp

1.1.5 show hostname


To display the host name, use the show hostname command. show hostname

1-4

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 1
IP Address Configuration Commands

Command Mode
Privileged user mode

Usage Guideline
This command shows the router s hostnames.

Example
3640# show hostname
3640

1.1.6 show ip interface


To display the operating status of all the interfaces in effect, use the command show ip interface [ type number ]. show ip interface [ type number ]

Syntax Description
type type of the interface number number of the interface

Command Mode
Privileged user mode

Usage Guideline
Using this command, the operating status of all the interfaces in effect will be displayed.

1.2 ARP Configuration Commands


Static ARP configuration commands include: l l l l arp clear arp-cache show arp debug arp packet

1.2.1 arp
To add a permanent entry in the Address Resolution Protocol (ARP) cache, use the arp command. To remove an entry from the ARP cache, use the no form of this command. arp ip-address ethernet-address [ temp ] no arp ip-address

1-5

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 1
IP Address Configuration Commands

Syntax Description
ip-address IP address in four-part dotted-decimal format corresponding to the local data link address. ether-address local data link address (a 48-bit address). Its format is XX-XX-XX-XXXX-XX, where XX is in hex. temp indicates that the map item is temporary, with a valid interval of 20 minutes, otherwise the router is always valid during the working time.

Default
No entries are permanently installed in the ARP cache

Command Mode
Global configuration mode

Usage Guideline
The software uses ARP cache entries to translate 32-bit IP addresses into 48-bit hardware addresses. Because most hosts support dynamic resolution, you generally do not need to specify static ARP cache entries. To remove all nonstatic entries from the ARP cache, use the clear arp-cache command. The static ARP map item is always valid when the router normally works, and the valid interval for the ARP map item is 20 minutes.

Example
! Set the Ethernet MAC address 00-e0-fc-01-00-00 corresponding to the IP address 129.102.0.1 in the LAN, and this cache is temporarily valid. Quidway(config)# arp 129.102.0.1 00-eo-fc-01-00-00 temp

Related Command
clear arp-cache, show arp

1.2.2 clear arp-cache


To delete all dynamic entries from the ARP cache, to clear the fast-switching cache, and to clear the IP route cache, use the clear arp-cache command. clear arp-cache

Command Mode
Privileged user mode

Usage Guideline
In some circumstances, it is necessary to clear and update the ARP cache. You can clear them with the clear arp-cache command.
1-6

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 1
IP Address Configuration Commands

Example
! Clear the ARP cache. Quidway# clear arp-cache

Related Command
arp, show arp

1.2.3 show arp


To display the entries in the ARP table, use the show arp command. show arp [ ip-address ]

Command Mode
Global configuration mode

Example
Quidway# show arp
Protocol Address Inet 129.102.3.55 Inet 129.102.146.20 Inet 129.102.149.23 Hardware Address 00-c0-26-9d-17-dc 00-c0-df-23-20-d9 00-a0-b9-00-4c-b5 Type Dynamic Dynamic Dynamic Interface Ethernet0 Ethernet0 Ethernet0

The above information shows that there are three items in the ARP cache. The first item, for example, indicates that: the protocol stack is IP; the IP address is 129.102.3.55; the MAC address is 00-c0-26-9d-17-dc; this item is automatically derived through ARP from Ethernet0.

Related Command
arp, clear arp-cache

1.2.4 debug arp


To enable the arp packets debugging. debug arp

Command Mode
Privileged user mode

1.3 Proxy ARP Configuration Commands


Proxy ARP configuration commands include: l ip proxy-arp

1-7

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 1
IP Address Configuration Commands

1.3.1 ip proxy-arp
To enable proxy ARP on an interface, use the ip proxy-arp command. To disable proxy arp on the interface, use the no form of this command. ip proxy-arp no ip proxy-arp

Default
Disabled

Command Mode
Ethernet interface configuration mode

Usage Guideline
This command is applied on Ethernet interface. As for the hosts in the same hop but on different physical networks, the proxy ARP function hides the fact that the physical network are separated, and makes the user feel like he is on the same and one physical network.

Example
! Enable proxy ARP at Ethernet 0 Quidway(config-if-Ethernet0)# ip proxy-arp

1.4 DNS Configuration Commands


DNS configuration commands include: l l host show host

1.4.1 host
To define a static host name-to-address mapping in the host cache, use the host command. To remove the name-to-address mapping, use the no form of this command. host host-name ip-address

Syntax Description
host-name name of the host, a 20-byte character string. ip-address associated IP address.

Default
Disabled

1-8

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 1
IP Address Configuration Commands

Command Mode
Global configuration mode

Usage Guideline
There are two types of domain name solutions: dynamic domain name resolution and static domain name resolution. The former means that the user manually configures the map to the IP address. The latter means that the domain is resolved through the DNS server. Now the Quidway series of routers supports static domain name resolution only, and can maintain 50 map items at the most.

Example
! Define mapping from Quidway1 to 129.102.0.1. Quidway(config)# host Quidway1 129.102.0.1

Related Command
show host

1.4.2 show host


To display the default domain name, the style of name lookup service, a list of name server hosts, and the cached list of host names and addresses, use the show host command. show host

Command Mode
Privileged user mode

Usage Guideline
You can make sure if the output to the static domain name table is correct, according to the information output through this command.

Related Command
host

1.5 NAT Configuration Commands


The configuration commands of Network Address Translation (NAT) include: l l l l l l l l nat clear nat inside interface nat inside pool nat pool nat server nat timeout show nat debug nat

1-9

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 1
IP Address Configuration Commands

1.5.1 nat clear


To clear dynamic Network Address Translation (NAT) translations from the translation table, use the nat clear command. nat clear

Command Mode
Interface configuration mode

Usage Guideline
Clear up the mapping tables of address translation in the memory and release all the memory allocated dynamically to the mapping tables.

1.5.2 nat inside interface


To enable Network Address Translation (NAT) translations on the interface, use the nat inside interface command. To disable this function, use the no form of this command. nat inside access-list-number interface no nat inside access-list-number interface

Syntax Description
access-list-number standard IP access control list number. Packets with destination addresses that pass the access control list are translated by the interface.

Command Mode
Interface configuration mode

Usage Guideline
Translate the source address of the data message that conforms to the address access control list, by configuring the correlation between the address control list and the interface. To translate by selecting one address in the address pool or by using directly the IP address of the interface. You can configure different address translation correlation on one interface.

Example
The host computers of the 10.110.10.0/24 network segment are allowed for address translation, selecting the addresses from 202.110.10.10 to 202.110.10.12 as the translated address. Suppose ISP is connected by Serial0 port. Quidway(config)# access-list 1 deny any Quidway(config)# access-list 1 permit 10.110.10.0 0.0.0.255 ! Add correlation between the address list and the address pool. Quidway(config-if-seral0)# nat inside 1 interface

1-10

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 1
IP Address Configuration Commands

1.5.3 nat inside pool


To enable Network Address Translation (NAT) of the inside destination address, use the nat inside pool command. To remove the dynamic association to a pool, use the no form of this command. nat inside access-list-number pool pool-name no nat inside access-list-number pool pool-name

Syntax Description
access-list-number standard IP access control list number. Packets with destination addresses that pass the access control list are translated using global addresses from the named pool. pool-name name of the pool from which global IP addresses are allocated during dynamic translation.

Default
No inside destination addresses are translated

Command Mode
Interface configuration mode

Usage Guideline
This command has two forms: dynamic and static address translation. The form with an access control list establishes dynamic translation. Packets from addresses that match the standard access control list are translated by using global addresses allocated from the pool named with the nat pool command.

Example
The host computers of the 10.110.10.0/24 network segment are allowed for address translation, selecting the addresses from 202.110.10.10 to 202.110.10.12 as the translated address. Suppose Serial0 port is connected to ISP. Quidway(config)# access-list 1 deny any Quidway(config)# access-list 1 permit 10.110.10.0 0.0.0.255 ! Configure the address pool Quidway(config)# nat pool 202.110.10.10 202.110.10.12 pool 1 ! Add correlation between the address list and the address pool. Quidway(config-if-serial0)# nat inside 1 pool 1

1.5.4 nat pool


To define a pool of IP addresses for Network Address Translation (NAT), use the nat pool command. To remove one or more addresses from the pool, use the no form of this command.

1-11

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 1
IP Address Configuration Commands

nat pool start-addr end-addr pool-name no nat pool pool-name

Syntax Description
start-addr starting IP address that defines the range of addresses in the address pool. end-addr ending IP address that defines the range of addresses in the address pool. pool-nam name of the pool.

Default
No pool of addresses is defined

Command Mode
Global configuration mode

Usage Guideline
All the addresses in the address pool should be consecutive. For the most, 64 addresses can be defined in each address pool. An address pool can t be deleted, if it is correlated to one access control list and address translation has started.

Example
! Configure one address pool from 202.110.10.10 to 202.110.10.15, with the name pool1. Quidway(config)# nat pool 202.110.10.10 202.110.10.15 pool 1

1.5.5 nat server


To define a inside server associated with a pool of address, use the nat server command. To remove association to a pool, use the no form of this command. nat server global global-addr [ global-port ] inside inside-addr inside-port protocol no nat server { global | inside } address port protocol

Syntax Description
global-addr an IP address provided by a pool of address which can access the outside. global-port a port number which can access the outside. inside-add IP address of the inside server. inside-port port number provided for the inside server, the port numbers commonly used are stood for with key words. For instance: The WWW service port number is 80, which can also be stood for by WWW; The FTP service port number is 21, which can also be stood for by FTP. inside-port is indispensable, which can be 0 or any of the ports. protocol could be TCP, UDP, IP or ICMP.
1-12

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 1
IP Address Configuration Commands

Command Mode
Interface configuration mode

Usage Guideline
By this command, some of the servers, which the internal network can provide for the usage of the outside, can be configured, such as WWW, FTP, Telnet, pop3 and DNS. By the relevant no command, the corresponding internal server configuration can be deleted. The interface of the command should be interconnected with ISP and is the exit of the internal network.

Example
! The IP address of the internal WWW server of the specified LAN is 10.110.10.10. The IP address of the internal FTP server is 10.110.10.11. It is hoped that the outside can access WEB through http:// 202.110.10.10:8080 and connect FTP wet site through ftp://202.110.10.10. Suppose Serial0 is connected to ISP. Quidway(config-if-serial0)# nat server global 202.110.10.10 8080 inside 10.110.10.10 tcp www Quidway(config-if-Serial0)# nat server global 202.38.160.101 inside 10.110.10.1 ftp tcp ! Specify one internal host computer 10.110.10.12. Hope that the host computer of the external network can find out that it s connected with ping 202.110.10.11 command. Quidway(config)# nat server global 202.110.10.11 inside 10.110.10.12 any

1.5.6 nat timeout


To change the amount of time after which Network Address Translation (NAT) time out, use the nat timeout command. To restore the default value, use the no form of this command. nat timeout { tcp | udp | icmp seconds } nat timeout default

Syntax Description
seconds number of seconds after which the specified port translation times out.

Default
The timeout value for TCP is 240 seconds. The timeout value for UDP is 40 seconds. The timeout value for ICMP is 20 seconds.

Command Mode
Global configuration mode

Usage Guideline
This command sets up the valid time of address translation connection, different time for different type of protocol. The unit of the time is second.
1-13

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 1
IP Address Configuration Commands

Example
! Set up the valid connection time of TCP protocol to 240 seconds. Quidway# nat timeout tcp 240

1.5.7 show nat


To display active Network Address Translation (NAT) translations, use the show nat command. show nat

Command Mode
Privileged user mode

Usage Guideline
This command shows the user s configuration of the address translation. The user can verify if the configuration of the address translation is correct according to the input information of this command.

Example
Quidway# show nat
Nat pool pool1 from 202.110.10.10 to 202.110.10.12 pool2 from 202.110.100.10 to 202.110.100.12 Nat inside (Interface:Serial0): access-list(1) ---- Nat pool (pool1 ) Nat server: Interface global-address global-port host-address host-port protocol Serial0 202.110.10.100 8080 10.110.10.10 80 (www) 6 (tcp) Serial0 202.110.10.100 2121 10.110.10.10 21 (ftp) 6 (tcp) Serial0 202.110.10.100 23(telnet)10.110.10.12 23(telnet) 6(tcp) Nat timeout: tcp timeout value -------------100 udp timeout value -------------60 icmp timeout value --------------20

The information above shows: Two address pools, pool1 and pool2, are configured, with the addresses ranges from 202.110.10.10 to 202.110.10.12 and from 202.110.100.10 to 202.110.100.12 respectively. Seria10 is configured with NAT, enabling the addresses in address list 1 to be translated to the addresses in address pool pool1. Serial0 is configured with 3 internal servers. The internal address of the WW server of http://202.110.10.100:8080 is 10.110.10.10; the internal address of FTP server of ftp://202.110.10.100:2121 is 10.110.10.10; the internal address of telnet://202.110.10.100 is 10.110.10.12. It s the valid time of various connections in the last row.

1.5.8 debug nat


Enable the NAT information debugging. debug nat { event | packet }

1-14

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 1
IP Address Configuration Commands

Syntax Description
event enables the NAT event information debugging. packet enables the NAT data packet information debugging.

Command Mode
Privileged user mode

1.6 DHCP Configuration Commands


The configuration commands of DHCP include: l l l l l ip forward-protocol udp ip helper-address show ip helper-address show ip forward-protocol debug forward-protocol

1.6.1 ip forward-protocol udp


To specify which protocols and ports the router forwards when forwarding broadcast packets, use the ip forward-protocol udp command. To remove a protocol or port, use the no form of this command. ip forward-protocol udp port no ip forward-protocol udp [ port ]

Syntax Description
port destination port that controls which UDP services are forwarded.

Default
If an IP helper address is defined, UDP forwarding is enabled on default ports. If a helper address is specified and UDP forwarding is enabled, broadcast packets destined to the following port numbers are forwarded by default: l l l l Trivial File Transfer Protocol (TFTP) (port 69) Domain Naming System (port 53) Time service (port 37) Boot Protocol (BOOTP) client and server datagrams (ports 67 and 68)

Command Mode
Global configuration mode

Usage Guideline
For DHCP, the helper address defines the DHCP server address. After configuring a helper address, the broadcast packets received from the interface will be transmitted to the server. The interface that can configure helper addresses should support broadcast. Each interface can configure at most 20 helper addresses.

1-15

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 1
IP Address Configuration Commands

1.6.2 ip helper-address
To specify helper address, which forwards User Datagram Protocol (UDP) broadcasts, use the ip helper-address command. To disable the forwarding of broadcast packets to specific addresses, use the no form of this command. ip helper-address ip-address no ip helper-address [ ip-address ]

Syntax Description
ip-address the starting ip-address in the address pool.

Default
Disabled

Command Mode
Global configuration mode

Usage Guideline
For DHCP, the helper address defines the DHCP server address. After configuring a helper address, the broadcast packets received from the interface will be transmitted to the server. The interface that can configure helper addresses should support broadcast. Each interface can configure at most 20 helper addresses.

1.6.3 show ip forward-protocol


To display the status of forwarding User Datagram Protocol (UDP) datagrams, use the show ip forward-protocol command. show ip forward-protocol

Command Mode
Privileged user mode

Usage Guideline
The command will display the status of forwarding UDP datagrams.

1.6.4 show ip helper-address


To display the status of helper address on the interface, use the show ip helperaddress command. show ip helper-address

Command Mode
Privileged user mode

1-16

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 1
IP Address Configuration Commands

Usage Guideline
The command will display the status of helper address on the interface.

1.6.5 debug forward-protocol


To enable the forwarding packets debugging, use the debug forward-protocol command. debug forward-protocol

Command Mode
Privileged user mode

1.7 VLAN configuration commands


VLAN configuration commands include: l l l encapsulation dot1q interface ethernet show vlan

1.7.1 encapsulation dot1q


To specifies the Ethernet sub-interface of VLAN, use the encapsulation dot1q command. To cancel existing designations, use the no form of this command. encapsulation dot1q vlan-id no encap-vlan

Parameter Description
vlan-id Identify the ID number of the VLAN to which Ethernet sub-interfacebelongs. The value range is 1~4094

Command Mode
Ethernet sub-interface configuration mode

Usage Guideline
This command is used on the Ethernet sub-interface. Only after being configured with this command, can the Ethernet sub-interface insert VLAN tag into the Ethernet frame header according to the configured VLAN ID number, and the exchange interface linked with this network interface can properly handle the frame received.

& Note: The Ethernet sub-interface is only applied in IPX and VLAN. So, as to a certain Ethernet sub-interface which has not been configured with VLAN ID, it is not permitted to specify its IP address.

1-17

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 1
IP Address Configuration Commands

Example
! The following example specifies that the Ethernet interface Ethernet 0.1 belongs to VLAN 1. Quidway(config-if-Ethernet0.1)# encapsulation dot1q 1

Related Command
interface ethernet

1.7.2 interface ethernet


To create an Ethernet sub-interface or enter the already existing Ethernet sub-interface configuration mode, use the interface ethernet command. To delete the specified Ethernet sub-interface, use the no form of this command. interface ethernet interface-number.subinterface-number no interface ethernet interface-number.subinterface-number

Parameter Description
interface-number Ethernet interface serial number. subinterface-number Ethernet interface serial number. The value range is 0~4294967295. But when the value is 0, it refers to the main interface to which the sub-interface belongs, so actually the Ethernet sub-interface serial number starts from 1.

Default
By default, the Ethernet sub-interface is not created.

Command Mode
Global configuration mode

Usage Guideline
The VLAN ID information can only be configured after the Ethernet sub-interface has been created.

Example
! The following example establishes the Ethernet sub-interface and enters its configuration mode. Quidway(config)# interface ethernet 0.1 Quidway(config-if-Ethernet0.1)#

1.7.3 show vlan


To display the related information such as the IDs of all the configured VLAN and the Ethernet sub-interface where they are located etc., use the show vlan command.

1-18

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 1
IP Address Configuration Commands

show vlan

Command Mode
Privileged mode

Usage Guideline
This command can be used to get the information of all the VLAN configured on the router and the related Ethernet sub-interface.

Example
! The following example shows the related information of all the configured VLAN. Quidway# show vlan
Ethernet0.1 Ethernet0.2 ------------------------------------VLAN 2 VLAN 1

Table NC-1-1 describes the show vlan command parameters. Table NC-1-1 show vlan command parameter description
Domain Name interface VLAN Description The Ethernet sub-interface where the VLAN is located VLAN ID

Related Command
encapsulation dot1q

1-19

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 2
IP Performance Configuration Commands

Chapter 2 IP Performance Configuration Commands


IP performance configuration commands include: l l l l l l l l l l l l l l l clear ip counters ifquelen arp ifquelen interface ifquelen ip ifquelen ipx ip route-cache ip tcp header-compression mtu tcp finwait-time tcp synwait-time tcp window-size show ip cache show ip interface show ip traffic show tcp brief

2.1 clear ip counters


To clear the information of IP statistics counters, use the clear ip counters command. clear ip counters

Command Mode
Privileged user mode

Usage Guideline
In some special circumstances, it is necessary to clear the existing IP statistics for new statistics.

Related Command
show ip interface, show ip traffic

2.2 ifquelen arp


To define the length of arp packets queue at the interface, use the ifquelen arp command. To restore the default value, use the no form of the command. ifquelen arp queue-length no ifquelen arp

2-1

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 2
IP Performance Configuration Commands

Syntax Description
queue-length Ranging 0 to 1000 bytes.

Default
75 bytes

Command Mode
Global configuration mode

Usage Guideline
Configuring the ARP queue length may affect the running efficiency at the Ethernet interface. So you should configure it under the guidance of the technical support engineer.

Example
! Configure the ARP queue length to be 70. Quidway(config)# ifquelen arp 70

Related Command
show ip interface

2.3 ifquelen interface


To define the length of ARP packets queue, use the command ifquelen interface type number { receive-queue | send-queue } queue-length. To restore its default value, use the no form of the command. ifquelen interface type number { receive-queue | send-queue } queue-length no ifquelen interface

Syntax Description
queue-length ranging 10 to 1000 bytes.

Default
75 bytes

Command Mode
Global configuration mode

Usage Guideline
Configuring the IP queue length may affect the running efficiency at the Ethernet interface. So you should configure it under the guidance of the technical support engineer.

2-2

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 2
IP Performance Configuration Commands

2.4 ifquelen ip
To define the length of IP packets queue, use the ifquelen ip queue-length command. To restore its default value, use the no form of the command. ifquelen ip queue-length no ifquelen ip

Syntax Description
queue-length ranging 10 to 1000 bytes.

Default
75 bytes

Command Mode
Global configuration mode

Usage Guideline
Configuring the IP queue length may affect the running efficiency at the Ethernet interface. So you should configure it under the guidance of the technical support engineer.

Example
! Configure the IP queue length to be 70 Quidway(config)# ifquelen ip 70

Related Command
show ip interface

2.5 ifquelen ipx


To define the length of IP packets queue at the interface, use the ifquelen ipx command. To restore its default value, use the no form of the command. ifquelen ipx queue-length no ifquelen ipx

Syntax Description
queue-length ranging 10 to 1000 bytes.

Default
75 bytes

2-3

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 2
IP Performance Configuration Commands

Command Mode
Global configuration mode

Example
! Configure the IPX queue to 95. Quidway(config)# ifquelen ipx 95

2.6 ip route-cache
To control the use of high-speed switching caches for IP routing, use the ip routecache command. To disable any of these switching modes, use the no form of this command. ip route-cache no ip route-cache

Default
Enabled

Command Mode
Interface configuration mode

Usage Guideline
These two commands are respectively used to enable and disable fast forwarding of packets received at the interface. Fast forwarding is suitable for high-speed link interfaces (like the Ethernet and frame relay). Due to the low speed of the low-speed link, it is meaningless to use fast forwarding. The Quidway series of routers supports fast forwarding at various high-speed links, including the Ethernet, synchronous PPP, frame relay, and HLDC. Also it supports fast downloading of the firewall. By default, the interface can enable fast forwarding.

Example
! Disable ip route-cache. Quidway(config-if-Ethernet0)# no ip route-cache

2.7 ip tcp header-compression


To enable TCP header compression, use the ip tcp header-compression command. To disable compression, use the no form of this command. ip tcp header-compression no ip tcp header-compression

2-4

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 2
IP Performance Configuration Commands

Default
Disabled

Command Mode
Interface configuration mode

Usage Guideline
When running PPP in the lines of low speed WAN, the TCP header accounts for a large proportion in all the transmitting data, so TCP header-compression can be used to improve the efficiency of data transmission. You can compress the headers of your TCP/IP packets in order to reduce the size of your packets. TCP header compression is supported on serial lines using Frame Relay, HDLC or Point-to-Point (PPP) encapsulation. You must enable compression on both ends of a serial connection. RFC 1144 specifies the compression process. Compressing the TCP header can speed up Telnet connections dramatically. In general, TCP header compression is advantageous when your traffic consists of many small packets, not for traffic that consists of large packets. Transaction processing (usually using terminals) tends to use small packets while file transfers use large packets. This feature only compresses the TCP header, so it has no effect on UDP packets or other protocol headers. When compression is enabled, fast switching is disabled. This means that fast interfaces like T1 can overload the router. Consider your network's traffic characteristics before using this command.

Example
! Enable TCP header-compression at the PPP interface Serial0. Quidway(config-if-Serial0)# ip tcp header-compression

Related Command
encapsulation ppp

2.8 mtu
To set the maximum transmission unit (MTU) size of IP packets sent on an interface, use the mtu command. To restore the default MTU size, use the no form of this command. mtu size no mtu

Syntax Description
Size the maximum size of the transmission unit. When the encapsulation format for the Ethernet is EthernetII, the mtu at the interface ranges from 46 to 1500 bytes. When the encapsulation format at the Ethernet interface is SNAP, the mtu at the interface ranges from 46 to 1492 bytes; and that at the serial interface ranging 128 to 1500 bytes; the mtu at the BRI interface ranging 128 to 1500 bytes.

2-5

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 2
IP Performance Configuration Commands

Default
1500 bytes when the encapsulation format is EthernetII. 1492 bytes when the encapsulation format is SNAP. 1500 bytes for the serial interface; 1500 bytes for the BRI interface.

Command Mode
Interface configuration mode

Usage Guideline
If an IP packet exceeds the MTU set for the interface, the software will fragment it. All devices on a physical medium must have the same protocol MTU in order to operate.

2.9 tcp finwait-time


To set the TCP finwait timer, use the tcp finwait-time command. To restore the default value, use the no form of this command. tcp finwait-time seconds no tcp finwait-time

Syntax Description
seconds Value of the TCP finwait timer with the second as the unit, ranging 76 to 3600 seconds.

Default
The default time is 675 seconds

Command Mode
Global configuration mode

Usage Guideline
Start the finwait timer when the connection status changes from FIN_WATI_1 to FIN_WAIT_2. If no FIN message is received before the finwait timer is timeout, the TCP connection will be terminated. This parameter should be configured under the guidance of the technical support engineer.

Example
! Set the value of the TCP finwait timer to be 675 seconds. Quidway(config)# tcp finwait-time 675

2-6

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 2
IP Performance Configuration Commands

Related Command
tcp synwait-time, tcp window-size

2.10 tcp synwait-time


To set a period of time the software waits while attempting to establish a TCP connection before it times out, use the tcp synwait-time command. To restore the default time, use the no form of this command. tcp synwait-time seconds no tcp synwait-time

Syntax Description
seconds synwait-time a time value for the TCP synwait timer with the second as its unit, ranging 2 to 600 seconds.

Default
The default time is 75 seconds

Command Mode
Global configuration mode

Usage Guideline
When the synchronous packet is transmitted, the TCP starts the synwait timer. If no acknowledgment packet is received before the synwait is timeout, then the TCP connection will be terminated. This parameter should be configured under the guidance of the technical support engineer.

Example
! Configure the TCP synwait timer to 75 seconds. Quidway(config)# tcp synwait-time 75

Related Command
tcp finwait-time, tcp window-size

2.11 tcp window-size


To define the tranceiving buffer window size of the connection-oriented socket, use the tcp window-size command. To restore the default value, use the no form of this command. tcp window-size window-size no tcp window-size

2-7

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 2
IP Performance Configuration Commands

Syntax Description
window-size window size of the TCP connection-oriented socket in Kbytes, ranging 1 to 32 Kbytes.

Default
The default size is 4 Kbytes

Command Mode
Global configuration mode

Usage Guideline
This parameter should better be set under the guidance of the technical support engineer.

Example
! Set the window size of the TCP connection-oriented socket to be 4 Kbytes. Quidway(config)# tcp window-size 4

Related Command
tcp finwait-time, tcp synwait-time

2.12 show ip cache


To display the routing table cache used to fast switch IP traffic, use the show ip route-cache command. show ip route-cache

Command Mode
Privileged user mode

Usage Guideline
This command is for showing the used routes and helping the user diagnose for faults.

Example
Quidway# show ip route-cache
Route to destination 129.102.100.141:

Destination NetMask 129.102.100.141 255.255.255.255

Type direct

Interface Ethernet0

GateWay

The above information shows that the route recently used is one reaching 129.102.100.141. This is a direct route, whose output interface is Ethernet0.

Related Command
ip route
2-8

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 2
IP Performance Configuration Commands

2.13 show ip interface


To display the usability status of interfaces configured for IP, use the show ip interface command. show ip interface [ type number ]

Syntax Description
type the interface type. number the interface number.

Command Mode
Privileged user mode

Usage Guideline
This command outputs IP relevant information at the interface, and this is helpful for fault diagnosis

Example
Quidway# show ip interface serial 0
Interface is Serial0, Index is 2 ifFlags=8004 <NBMA,MULTICAST> protocol is x25 dte ietf, MTU is 1500, speed is 64000 bps input queue is 0/75/0 (current/max/drops) output queue is 0/75/0 (current/max/drops) 0 packets input, 0 bytes, 0 multicasts 0 input packets dropped, 0 no protocols, 0 input errors 0 packets output, 0 bytes, 0 multicasts, 0 output errors

The above information shows; Serial0 has an index of 2; the interface type is NBMA, supporting multicast; the protocol encapsulated at this interface is X.25; the mtu is 1500 bytes with a transmission speed of 64kbps. This also reflects the maximum lengths of received and transmitted queues, number of packets in the current queue and number of packets dropped due to a full queue, number of packets received and transmitted, number of multicast packets received and transmitted, number of unidentifiable packets, etc.

Related Command
show interface

2.14 show ip traffic


To display statistics about IP traffic, use the show ip traffic command. show ip traffic

Command Mode
Privileged user mode

2-9

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 2
IP Performance Configuration Commands

Usage Guideline
This command shows the statistics of received and transmitted IP packets, assembled and fragmented packets, which are helpful for fault diagnosis.

Example
Quidway# show ip traffic
IP statistics: Rcvd: 259 total, 250 local destination 0 format errors, 0 checksum errors 0 unknown protocol, 0 bad options Frags: 0 fragment rcvd, 0 fragment dropped 0 reassembled, 0 timeouts 0 fragmented, 0 couldn't fragment, 0 fragment sent Sent: 27 generated, 9 forwarded, 0 raw ip packets 0 dropped, 0 no route, 0 Compress fails ICMP statistics: Rcvd: 0 format errors, 0 checksum errors 0 redirects, 0 unreachable, 14 echo, 0 echo reply 0 mask requests, 0 mask replies, 0 quench 0 parameter, 0 timestamp, 0 info request Sent: 0 redirects, 0 unreachable, 0 echo, 14 echo reply 0 mask requests, 0 mask replies, 0 quench 0 parameter problem, 0 timestamp, 0 info reply

The above information shows: l IP statistics; Received: 259 messages received, 250 of which are transmitted to the upper-layer protocol; no packet format error; no packet check error; no unknown protocol; no packet option error. Fragments: no fragments received or dropped; the number of fragments successfully reassembled is 0, and no fragment re-assembly timeout; the number of packets successfully fragmented is 0, and number of packets that can not be fragmented is 0; the number of fragments generated and forwarded is 0. Sent: 27 packets generated, and 9 packets forwarded; 0 Raw IP packet generated; 0 packet dropped; 0 packet with no route; 0 packet fails to be compressed. l ICMP statistics: Received: 0 packet with format error received, 0 packet with checksum error, 0 redirect packet, 0 unreachable packet, 14 echo request packets, 0 mask request packet, 0 mask reply packet, 0 quench packet, 0 packet with parameter problem, 0 timestamp request packet, and 0 information request packets. Sent: 0 redirect packet forwarded, 0 unreachable packet, 0 echo request packet, 14 packets, 0 mask request packet, 0 mask reply packet, 0 quench packet, 0 packet with parameter problem, 0 timestamp request packet, and 0 information reply packet.

Related Command
show interface, show ip interface, clear ip counters

2.15 show tcp brief


To display TCP connection status, use the show tcp brief command. show tcp brief

2-10

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 2
IP Performance Configuration Commands

Command Mode
Privileged user mode

Usage Guideline
This command shows all the TCP connection states so that the user can monitor the TCP connections at any time.

Example
Quidway# show tcp brief
LocalAddress LocalPort ForeignAddress 129.102.100.142 23 129.102.001.092 000.000.000.000 23 000.000.000.000 ForeignPort State 1038 ESTABLISHED 0 LISTEN

The above information shows: a TCP connection has been set up, and the local UP address of the TCP is 129.102.100.142; the local port number is 23; the foreign IP address is 129.102.1.92; the remote port number is 1038. In addition, there is a server especially responsible for monitoring port 23.

Related Command
show client

2-11

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
IPX Configuration Commands

Chapter 3 IPX Configuration Commands


IPX configuration commands include: l l l l l l l l l l l l l l l l l l l l l l l l l l l clear ipx counters ipx default-route ipx delay ipx down ipx encapsulation ipx gns-reply-disable ipx gns-round-robin ipx max-paths ipx max-reserve-paths ipx max-reserve-servers ipx network ipx rip-max-packetsize ipx rip-multiplier ipx rip-update-time ipx route ipx routing ipx sap ipx sap-max-packetsize ipx sap-multiplier ipx sap-update-time ipx split-horizon ipx type-20-propagation ipx touch-off show ipx interface show ipx route show ipx servers show ipx traffic

3.1 clear ipx counters


To reset all ipx counters, use the clear ipx counters command. clear ipx counters

Command Mode
Privileged user mode

Example
! Clear all the IPX counters. Quidway# clear ipx counters

Related Command
show ipx traffic

3-1

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
IPX Configuration Commands

3.2 ipx default-route


To forward to the default network all packets for which a route to the destination network is unknown, use the ipx default-route command. To disable the use of the default network, use the no form of this command. ipx default-route no ipx default-route

Default
Enabled: All packets for which a route to the destination is unknown are forwarded to the default network, which is 2 (0xFFFFFFFE).

Command Mode
Global configuration mode

Example
! Disable the default route. Quidway(config)# no ipx default-route

3.3 ipx delay


To set the tick count, use the ipx delay command. To reset the default increment in the delay field, use the no form of this command. ipx delay ticks no ipx delay

Syntax Description
ticks number of IBM clock ticks of delay to use. One clock tick is 1/18 of a second (approximately 55 ms).

Default
1 tick for the ipx delay for the Ethernet, 30 ticks for the serial interface, and 6 ticks for the other WAN interfaces.

Command Mode
Interface mode

Usage Guideline
The ipx delay command is used as a basis for judging the best route. In privileged user mode, the show ipx interface command can be used to show the values configured through ipx delay command.

3-2

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
IPX Configuration Commands

Example
! Set the delay at Ethernet0 to be 10 ticks. Quidway(config-if-Ethernet0)# ipx delay 10

Related Command
ipx max-paths

3.4 ipx encapsulation


To define the encapsulation frame type at the Ethernet, use the ipx encapsulation command. To restore the default encapsulation frame type, use the no form of this command. no ipx encapsulation frame_type no ipx encapsulation

Syntax Description
frame_type encapsulation frame type at the Ethernet, which can be any of the Ethernet-II(ARPA), Ethernet-SNAP(SNAP) IEEE8.2.2(sap) and IEEE802.3(novellether).

Default
Novell-ether

Command Mode
Ethernet interface configuration mode

Usage Guideline
The value set through this command is used to process the received packet at the Ethernet interface. If the packet type is different from the set encapsulation frame type, then the packet will be lost. The packet sent from the Ethernet interface is forwarded to the physical layer after it has been encapsulated in the specified frame type. The show ipx route command can be executed to show the encapsulation frame type that has been configured through ipx encapsulation.

Example
! Set the encapsulation frame type at Ethernet0 to be SAP Quidway(config-if-Ethernet0)# ipx encapsulation sap

3.5 ipx gns-reply-disable


To disable the sending of replies to IPX Get Nearest Server (GNS) queries, use the ipx gns-reply-disable command. To disable the function (Replies are sent to IPX GNS queries), use the no form of this command.

3-3

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
IPX Configuration Commands

ipx gns-reply-disable no ipx gns-reply-disable

Default
Replies are sent to IPX GNS queries

Command Mode
Interface configuration mode

Example
! Disable reply to IPX GNS request at Ethernet0. Quidway(config-if-Ethernet0)# ipx gns-reply-disable

3.6 ipx gns-round-robin


To rotate using a round-robin selection method through a set of eligible servers when responding to Get Nearest Server (GNS) requests, use the i px gns-round-robin command. To use the most recently learned server, use the no form of this command. ipx gns-round-robin no ipx gns-round-robin

Default
The most recently learned eligible server is used

Command Mode
Global configuration mode

Usage Guideline
In the normal server selection process, requests for service are responded to with the most recently learned, closest server. If you enable the round-robin method, the software maintains a list of the nearest servers eligible to provide specific services. It uses this list when responding to GNS requests. Responses to requests are distributed in a round-robin fashion across all active IPX interfaces on the router.

Example
! Enable ipx gns-round-robin. Quidway(config)# ipx gns-round-robin

3.7 ipx max-paths


To set the maximum number of equal-cost paths the software uses when forwarding packets, use the ipx maximum-paths command. To restore the default value, use the no form of this command.

3-4

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
IPX Configuration Commands

ipx max-paths paths no ipx max-paths

Syntax Description
paths maximum number of equal-cost paths which the software will use, ranging 1 to 64.

Default
The maximum number of equal-cost paths is 1 path

Command Mode
Global configuration mode

Usage Guideline
The ipx maximum-paths command increases throughput by allowing the software to choose among several equal-cost, parallel paths. (Note that when paths have different costs, the software chooses lower-cost routes in preference to higher-cost routes.) When per-host load sharing is disabled, IPX performs load sharing on a packet-bypacket basis in round-robin fashion, regardless of whether you are using fast switching or process switching. That is, the first packet is sent along the first path, the second packet along the second path, and so on. When the final path is reached, 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
! Set the maximum IPX paths to be 5 paths. Quidway(config)# ipx max-paths 5

Related Command
ipx max-reserve-paths

3.8 ipx max-reserve-paths


To set the length of routing reserve queue, use the no ipx max-reserve-paths command. To restore the default value, use the no form of this command. ipx max-reserve-paths paths no ipx max-reserve-paths

Syntax Description
paths the length of routing reserve queue, ranging 1 to 255.

3-5

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
IPX Configuration Commands

Default
Default length of the routing reserve queue is 4.

Command Mode
Global configuration mode

Usage Guideline
When the length of the max reserve queue is 1, the system reserves one route only for a destination. When this unique route is faulty and the system has deleted it, there no route available to this destination while it is searching for routes, and this will lead to serious loss of packets. When the length of the reserve queue is greater than 1 and the first route is deleted, the system can replace it with the next route so as to avoid serious loss of packets. Increasing the length of the reserve queue will result in more memory of the system being used by the IPX module.

Example
! Set the length of the max routing reserve queue to be 10. Quidway(config)# ipx max-reserve-paths 10

Related Command
ipx max-paths

3.9 ipx max-reserve-servers


To set the length of server information reserve queue, use the no ipx max-reserveservers command. To restore the default value, use the no form of this command. ipx max-reserve-servers length no ipx max-reserve-servers

Syntax Description
length length of the server information reserve queue, ranging 1 to 64.

Default
Default length of the server information reserve queue is 4

Command Mode
Global configuration mode

Usage Guideline
When the length of the max reserve queue is 1, the system reserves one route only for a destination. When this unique route is faulty and the system has deleted it, there no route available to this destination while it is searching for routes, and this will lead to serious loss of packets. When the length of the reserve queue is greater than 1 and the

3-6

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
IPX Configuration Commands

first route is deleted, the system can replace it with the next route so as to avoid serious loss of packets. Increasing the length of the reserve queue will result in more memory of the system being used by the IPX module.

Example
! Set the length of the max server information reserve queue to be 10. Quidway(config)# ipx max-reserve-servers 10

3.10 ipx network


To enable IPX routing on a particular interface, use the ipx network command. To disable IPX routing, use the no form of this command. ipx network network no ipx network

Syntax Description
network IPX network number. This is an eight-digit hexadecimal number that uniquely identifies a network cable segment ranging 1 to FFFFFFFD. You do not need to specify leading zeros in the network number. For example, for the network number 000000AA you can enter AA.

Default
IPX routing is disabled

Command Mode
Interface configuration mode

Usage Guideline
To activate the IPX module on an interface, it is necessary to use the ipx network command. If it is necessary to change the encapsulation type of the IPX frame, you can use the ipx encapsulation command.

Example
! Activate the IPX route at Ethernet0. Quidway(config)# ipx routing Quidway(config-if-Ethernet0)# interface ethernet 0 Quidway(config-if-Ethernet0)# ipx network 2 ! Activate the IPX route at Ethernet0, and set the encapsulation form of IPX frame to Ethernet_SNAP. Quidway(config)# ipx routing Quidway(config-if-Ethernet0)# interface ethernet 0 Quidway(config-if-Ethernet0)# ipx network 2
3-7

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
IPX Configuration Commands

Quidway(config-if-Ethernet0)# ipx encapsulation snap

Related Command
ipx encapsulation, ipx routing

3.11 ipx rip-max-packetsize


To configure the maximum packet size of RIP updates sent out the interface, use the ipx rip-max-packetsize command mode. To restore the default packet size, use the no form of this command. ipx rip-max-packetsize bytes no ipx rip-max-packetsize

Syntax Description
bytes maximum packet size in bytes, ranging 432 to 1500 bytes.

Default
The default packet size is 432 bytes, which allows for 50 routes at 8 bytes each.

Command Mode
Interface configuration mode

Usage Guideline
The maximum size includes the sizes of IPX packet header and RIP packet header.

Example
! Set the maximum RIP packet size at Ethernet0 to be 832 bytes (that is, it can contain 100 routing messages). Quidway(config-if-Ethernet0)# ipx rip-max-packetsize 832

3.12 ipx rip-multiplier


To configure the cycle in which a network's RIP entry ages out, use the ipx ripmultiplier command. To restore the default cycle, use the no form of this command. ipx rip-multiplier multiplier no ipx rip-multiplier

Syntax Description
multiplier multiplier used to calculate the cycle at which to age out RIP routing table entries. The value you specify is multiplied by the RIP update cycle to determine the aging-out cycle. By default, it is three times the RIP update cycle, ranging 1 to 1000.

3-8

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
IPX Configuration Commands

Default
Three times the RIP update cycle

Command Mode
Global configuration mode

Usage Guideline
All routers in the same IPX network should use the same RIP aging cycle.

Related Command
ipx rip-update-time

3.13 ipx rip-update-time


To set intervals for IPX RIP to control how long it will be waiting to receive the next RIP update packets, use the ipx rip-update-time command. To restore the default value, use the no form of this command. ipx rip-update-time seconds no ipx rip-update-time

Syntax Description
seconds RIP update time in seconds, ranging 10 to 60000 seconds.

Default
60 seconds

Command Mode
Global configuration mode

Usage Guideline
When the router is started or shut down, it is necessary to exchange routing information with other routers through propagation. When it is running, it needs to propagate cyclically to exchange routing information with the other routers. The ipx rip-updatetime command is used to set the time interval between two rounds of routing information propagation. This interval is 60 seconds by default. In the same network segment, this interval should be the same.

Example
! Set the IPX RIP update packet interval to be 40 seconds. Quidway(config)# ipx rip-update-time 40

3-9

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
IPX Configuration Commands

Related Command
show ipx interface

3.14 ipx route


1) To add a static route summary to the routing table, use the ipx route static command. To remove a static route from the routing table, use the no form of this command.

ipx route network network .node ticks hops static [ preference value ] no ipx route network [ network .node ] static [ preference value ] 2) To add a default route to the routing table, use the ipx route default command. To remove a default route from the routing table, use the no form of this command.

ipx route default network .node [ preference value ] no ipx route default network .node [ preference value ]

Syntax Description
network IPX network number, which is composed of 8 hex digits. It is a unique id in the hop, ranging 1~FFFFFFFD. While inputting the number, you can omit the leading zeros. As for 000000AA, for example, you only need to input AA. network.node IPX address of the next router to reach a specified hop. Network is a number composed of 8 hex digits. It is unique id for the hop, ranging 1~FFFFFFFD. When it is input, its leading zeros can be omitted. As for 000000AA, for example, you only need to input AA. node is used to identify a node in the network, with a length of 48 bits. When it is input, it is composed of three groups of 4-digit numbers in hex separated by dots (xxxx.xxxx.xxxx). ticks time needed for reaching the destination hop, its unit being the tick (1 tick=1/18'). hops number of routers to go through before reaching the destination hop. default creates a static entry for the "default route . All the packets that cannot find destinations are sent here. static remove information of the "static route . preference routing preference; value preference value, ranging 0 to 255.

Default
No static routes are predefined

Command Mode
Global configuration mode

Usage Guideline
The routing protocol can dynamically update the routing table, but it also can add static routes to the routing table, and expressly give an instruction of how to reach a

3-10

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
IPX Configuration Commands

destination. The preference for the static route is 10, and that for a dynamic route is 60. The smaller the value, the higher the preference. Note that when a static route is set up and once an error occurs to any segment of this route, communication will be interrupted or packets are transmitted to a non-existing destination. A default route can be configured in a router. When its destination network is configured as FFFFFFFE, all the packets that fail to find routes will be forwarded along this route.

Example
! Reach the hop 5a through the router with the address 1000.0.0c91.f61f Quidway(config)# ipx routing Quidway(config)# ipx route 5a 1000.0.0c91.f61f 10 2 ! Set a default routing which next hop address is 3.4a.60.7. Quidway(config)# ipx routing Quidway(config)# ipx route default 3.4a.60.7 10 2 ! Set a default routing which next hop address is 3.4a.60.7, with a preference of 20. Quidway(config)# ipx routing Quidway(config)# ipx route default 3.4a.60.7 10 2 preference 20

Related Command
ipx default-route, show ipx route

3.15 ipx routing


To enable IPX, use the ipx routing command. To disable IPX, use the no form of this command. ipx routing [ node ] no ipx routing

Syntax Description
node node s number of the router. This is a 48-bit value represented by a dotted triplet of four-digit hexadecimal numbers. It is not a broadcasting address. If you omit the node argument, the software will use the hardware MAC address currently assigned to it as its node address.

Default
Disabled

Command Mode
Global configuration mode

3-11

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
IPX Configuration Commands

Usage Guideline
The ipx routing command enables IPX Routing Information Protocol (RIP) and Service Advertising Protocol (SAP) services. If you omit the node value, when MAC addresses change, the node values of routers will automatically change. In this way, during the period when MAC addresses change and clients and servers get new addresses, the communication may break off.

Example
! Enable the IPX routing in the router. Quidway(config)# ipx routing ! Enable the IPX routing in the router, the node s number is 1.1.1. Quidway(config)# ipx routing 1.1.1

Related Command
ipx network

3.16 ipx sap


To add a static Service Advertising Protocol (SAP) entry to the SAP table, use the ipx sap command. To remove static SAP entries, use the no form of this command. ipx sap service-type name network.node socket hopcount preference preference no ipx sap service-type [ name ] [ network.node ]

Syntax Description
service-type SAP service-type number. See the access-list (SAP filtering) command earlier in this chapter for a table of some IPX SAP services. Name name of the server that provides the service. network.node network number and node address of the server. As a unique id for a hop, the network number is composed of 8 hex digits, ranging 1 to FFFFFFFD. While inputting it, the leading zeros can be omitted. As for 000000AA, for example, you only need to input AA. The node value is used to identify a node in the network, with a length of 48 bits. When it is actually input, it is composed of 3 groups of 4-digit number in hex separated by dot (xxxx.xxxx.xxxx). socket socket number for this service. hopcount count of hops to go through before reaching the server. preference the preference of service information. preference the value of the preference of service information, ranging 0 to 255.

Default
Disabled

3-12

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
IPX Configuration Commands

Command Mode
Global configuration mode

Usage Guideline
The ipx sap command allows you to add a static entry into the SAP table. Each entry has a SAP service associated with it. By default the preference of the static SAP entry is 10 and the preference of the dynamic one is 60. The smaller the value, the higher the preference. The router will not announce a static SAP entry unless it has a route to that network.

Example
! Add a piece of service information of type 4 at 1000.0.0c91.f61f. Quidway(config)# ipx sap 4 server1 1000.0.0c91.f61f 451 2 ! Add a piece of service information of type 4 at 1000.0.0c91.f61f and with a preference of 40 Quidway(config)# ipx sap 4 server1 1000.0.0c91.f61f 451 2 preference 40

Related Command
show ipx servers

3.17 ipx sap-max-packetsize


To configure the maximum packet size of Service Advertising Protocol (SAP) updates sent out the interface, use the ipx sap-max-packetsize command. To restore the default packet size, use the no form of this command. ipx sap-max-packetsize bytes no ipx sap-max-packetsize

Syntax Description
bytes Maximum packet size in bytes, ranging 480 to 1500 bytes.

Default
The default is 480 bytes, which allows for 7 servers (64 bytes each).

Command Mode
Interface configuration mode

Usage Guideline
The maximum size includes the sizes of the IPX packet header and SAP header.

3-13

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
IPX Configuration Commands

Example
! Set the maximum SAP packet size to be 672 bytes (which can contain 10 pieces of service information) at Ethernet0 Quidway(config-if-Ethernet0)# ipx sap-max-packetsize 672

3.18 ipx sap-multiplier


To configure the interval at which a network or server's Service Advertising Protocol (SAP) entry ages out, use the ipx sap-multiplier command. To restore the default interval, use the no form of this command. ipx sap-multiplier multiplier no ipx sap-multiplier

Syntax Description
multiplier multiplier used to calculate the cycle at which to age out SAP routing table entries. The value you specify is multiplied by the SAP update cycle to determine the aging-out cycle. By default, it is three times the update cycle.

Default
The default is three times the SAP update cycle.

Command Mode
Global configuration mode

Usage Guideline
All routers in the same network should use the same multiplier value.

Example
!If the SAP update interval is 2 minutes, then the SAP aging multiplier is 10 minutes after the following command is executed. Quidway(config)# ipx sap-multiplier 5

Related Command
ipx sap-update-time

3.19 ipx sap-update-time


To set intervals for IPX SAP to control how long it will be waiting to receive the next SAP update packets, use the ipx sap-update-time command. To restore the default value, use the no form of this command. ipx sap-update-time seconds no ipx sap-update-time

3-14

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
IPX Configuration Commands

Syntax Description
seconds are used to calculate the SAP update time, ranging 60 to 60000 seconds.

Default
60 seconds

Command Mode
Global configuration mode

Usage Guideline
When a router is started or shut down, it needs to exchange information with other routers through propagation. When it is running, it needs to propagate outward cyclically, exchanging information with other servers. The ipx sap-update-time command is used to set the time interval between two rounds of service information propagation. This interval is 60 seconds by default. In the same network segment, this interval should be of the same value.

Example
! Set the SAP update cycle to be 120 seconds. Quidway(config)# ipx sap-update-time 120

Related Command
show ipx interface

3.20 ipx type-20-propagation


To forward IPX type 20 propagation packet broadcasts to other network segments, use the ipx type-20-propagation command. To disable the forwarding of type 20 broadcasts on an interface, use the no form of this command. ipx type-20-propagation no ipx type-20-propagation

Default
Disabled

Command Mode
Interface configuration mode

Usage Guideline
Routers normally block all broadcast requests. To allow input and output of type 20 propagation packets on an interface, use the ipx type-20-propagation command.

3-15

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
IPX Configuration Commands

3.21 ipx split-horizon


To enable split-horizon, use the ipx split-horizon command. To disable the function, use the no form of this command. ipx split-horizon no ipx split-horizon

Default
Enable split-horizon.

Command Mode
Interface configuration mode

Usage Guideline
The split-horizon arithmetic can prevent route loop. Split-horizon means that an interface will not send out routes that it receives. But in some unusual conditions, split-horizon should be disabled, that is, to achieve the correct transmission by sacrificing efficiency. It will be better not to use the configuration of disabling RIP splithorizon without thinking. Disabling split-horizon will have no effect on point-to-point links.

3.22 ipx touch-off


To enable triggered RIP updates sent on an interface, use the ipx rouch-off command. To disable the function, use the no form of this command. ipx touch-off no ipx touch-off

Default
Disabled

Command Mode
Interface configuration mode

Usage Guideline
IPX s RIP and SAP will send update broadcast packets cyclically. If the user does not want the router to keep on sending such packets, he can enable the ipx touch-off function at the interface. In this way, update packets will be sent only in the case of change in the routing or service information.

3.23 show ipx interface


To display the status of the IPX interfaces configured and the parameters configured on each interface, use the show ipx interface command.

3-16

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
IPX Configuration Commands

show ipx interface [ type number ]

Syntax Description
type interface type. number interface number.

Command Mode
Privileged user mode

Usage Guideline
The information output through this command is helpful for the user to determine if the IPX configuration is correct and to perform IPX fault diagnosis.

Example
Quidway# show ipx interface serial 0
Ethernet0 is up, line protocol is up IPX address is 2.00E0.FC01.0000 [up] line-up Delay of this IPX network in ticks is 1 IPX type 20 propagation packet forwarding is enabled SAP GNS processing enabled SAP GNS round robin processing disabled The maximum number of services reserved is 4 IPX RIP update interval is 60 seconds aging multiples is 3 IPX SAP update interval is 60 seconds aging multiples is 3 RIP packet maximum size is 432 bytes SAP packet maximum size is 480 bytes RIP packets received 0 RIP packets sent 1 SAP packets received 0 SAP packets sent 0 0 bytes received, 0 bytes sent

3-17

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
IPX Configuration Commands

Table NC-3-1 show ipx interface command and meanings of its fields
Name of field Ethernet0 is ... protocol is ... IPX protocol processing disabled IPX address is ... [up]line up Delay of this IPX network, in ticks is ... IPX type 20 propagation packet forwarding ... SAP GNS processing ... SAP GNS round robin processing ... The maximum number of services reserved is ... IPX RIP update interval is ... seconds aging multiplies is ... IPX SAP update interval is... seconds, aging multiplies is ... RIP packet maximum size is ... bytes SAP packet maximum size is ... bytes RIP packets received ... RIP packets sent ... SAP packets received ... SAP packets sent ... ... bytes received ... bytes sent Meaning Seen from the physical layer, if the current interface is up, down, or administratively down. If the bottom-layer is up or down. If the IPX module is activated at the current interface The IPX network number and node value for the current interface. For the detail of the network number and node value, please consult the ipx network and ipx routing commands. If the current interface is up, available or not yet activated. Delay of the current interface. Its value is configured through the ipx delay command. Indicating if IPX type 20 propagation packet forwarding is enabled or disabled. The relevant commands include ipx type-20-propagation . SAP GNS request is being processed at the current interface. The relevant commands include ipx gns-reply-disable . If reply to the SAP GNS request is based on round robin or the nearest service information. The relevant commands include ipx gns-round-robin . Maximum number of services of the same type reserved. The relevant commands include ipx max-reserve-servers . RIP update interval and aging multiplier. The commands relevant with it include ipx rip-update-timeipx rip-multiplier. SAP update interval and aging multiplier. The commands relevant with it include ipx sap-update-time and ipx sap-multiplier . RIP packet maximum size at the current interface. The command relevant with it is ipx rip-max-packetsize . SAP packet maximum size at the current interface. The command relevant with it is ipx sap-max-packetsize. RIP packets received at the current interface RIP packets sent at the current interface SAP packets received at the current interface SAP packets sent at the current interface Total bytes received at the current interface Total bytes sent at the current interface

Related Command
ipx routing, ipx network, ipx down, ipx delay, ipx type-20-propagation, ipx gnsreply-disable, ipx gns-round-robin, ipx max-reserve-servers, ipx rip-update-time, ipx rip-multiplier, ipx sap-update-time, ipx sap-multiplier, ipx rip-max-packetsize, ipx sap-max-packetsize

3.24 show ipx route


To display the contents of the IPX routing table, use the show ipx route command. show ipx route [network | static | default ] [ detailed ]

Syntax Description
network Number of the network whose routing table entry you want to display. it is a unique id for a hop, ranging 1 to FFFFFFFD. When inputting this number, the leading number can be omitted. To enter 000000AA, for example, you only need to input AA. static indicating all the static routes.
3-18

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
IPX Configuration Commands

default displays the default route. This is equivalent to specifying a value of FFFFFFFE for the argument network. detailed displays detailed route information.

Command Mode
Privileged user mode

Usage Guideline
The information output through this command is helpful for IPX RIP fault diagnosis.

Example
Quidway# show ipx route
Codes: C - Direct connected network, S - Static, F - Float s - seconds, - uses 5 Total IPX routes. Up to 1 parallel paths, 4 reserved paths and 16 hops allowed. Current default route is: S FFFFFFFE [010/02/010] via 2.0A03.0C50.0003, Ethernet0 C 2 (NOVELL-ETHER), Ethernet0 C 1000 (PPP), Serial0 S 100 [010/02/010] via 1000.0B00.CD00.0000, Serial0 F 10 [060/02/010] via 2.0A03.0C50.0003, 10s, Ethernet0 u

Table NC-3-2 show ipx route command and meanings of its fields
Name of field Codes C S F 5 Total IPX routes. Up to 1 paths 4 reserved paths Current default route is: No default route known. Default route handling is disabled. Net 1 [010/02/010] Meaning Specified sources of routes Directly connected network number Static routes defined through ipx route command Floating (dynamic) routes known through the RIP update packet Total routes in the routing table Maximum paths (routes), which are re-defined through the ipx max-paths command. Length of the max routing information queue; which can be redefined via the ipx max-reserve-paths command. The current default route No default route is known yet Default route handling is not supported. It can be re-defined through ipx default-route. The destination network to which a route points preference/hop/delay. The smaller the preference, the higher the preference of the route. The unit for delay is the tick (1 tick=1/18 second), and a hop indicates the number of routers to go through before reaching the destination. IPX address of the next hop Aging time, with the second as its unit. Times when this route is used. Each time this route is used, 1 is added to the counter.

via network.node 10s u

Related Command
ipx max-paths, ipx max-reserve-paths, ipx route

3-19

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
IPX Configuration Commands

3.25 show ipx servers


To list the IPX servers discovered through Service Advertising Protocol (SAP) advertisements, use the show ipx servers command. show ipx servers [ type service-type | name name | network network | socket socket | sorted { net | type } ] [ detailed ]

Syntax Description
type displays the IPX servers numerically by SAP service type. service-type type of service. name displays the IPX servers alphabetically by server name name name of server. network displays the IPX servers in the specified hop. network the number of the hop where the server to be shown by the user is located. socket service information whose socket is the same as the specified socket. socket sorted displays the IPX service information sorted by type. net classified by the net number. type classified by the service type. detailed details of service information listed.

Command Mode
Privileged user mode

Usage Guideline
This information output through this command is helpful for IPX SAP fault diagnosis by the user.

Example
Quidway# show ipx servers
Codes: S - Static, F - Float, s - seconds 3 Total IPX Servers. 4 reserved servers allowed Table ordering is based on routing and server info Type Name Net Address Port Pre/Route Hops If F 4 SERVER1 3092D3F3.0000.0000.0001:0451 010/2/01 1 Ethernet0 P 26B BJTREE 3092D3F3.0000.0000.0001:0005 060/2/01 1 Ethernet0 P 278 BJTREE 3092D3F3.0000.0000.0001:4006 060/2/01 1 Ethernet0

3-20

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
IPX Configuration Commands

Table NC-3-3 show ipx servers command and meaning of the fields of the command
Name of field Codes S F Type Name Net Address Port Pre Pre/Route Hops If s * conn Full name via Meaning Specified sources of service information Static service information defined through the ipx sap command Dynamic service information known from the SAP update packet Sources and service types of service information Server name Network number of the hop where the server is located Node value for the server Socket Preference: the smaller the value, the higher the preference Delay/hop (from the routing information table) Hop (from SAP) Interfaces to go through before reaching the hop where the router is located Aging multiplier for service information Indicating that the static service information has turned invalid Indicating the delay/hop for static service information Indicating that what are to be shown are full service information names Indicating that what are to be shown are interfaces for receiving such service information

Related Command
ipx max-reserve-servers, ipx sap

3.26 show ipx traffic


To display information about the number and type of IPX packets sent and received, use the show ipx traffic command. show ipx traffic

Command Mode
Privileged user mode

Usage Guideline
The information output through this command is helpful for the user to make IPX traffic statistics and fault diagnosis.

Example
Quidway# show ipx traffic
Recv: 0 total, 0 droped 0 checksum errors, 0 bad hop count 0 discarded(hop=16), 0 encapsulation failed 0 packets pitched, 0 local destination 0 broadcast, 0 forward, 0 echo Sent: 0 total, 0 broadcast 0 forwarded, 0 echo Type 20: 0 received, 0 matched, 0 discarded (tc>=8) 0 sent, 0 successfully sent, 0 encapsulation failed RIP: 0 RIP requests, 0 RIP replies, 1 RIP requests sent 0 RIP advertisements received, 0 sent 1 routes SAP: 0 SAP get nearest requests, 0 SAP get nearest replies

3-21

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 3
IPX Configuration Commands

0 SAP requests, 0 SAP replies, 1 SAP requests sent 0 SAP advertisements received, 0 sent 1 servers Forward: 0 need forwarding, 0 success 0 no route, 0 encapsulation failed Echo: 0 requests received, 0 replies sent 0 requests sent, 0 replies received 0 no route Total: 412 bytes received, 576 bytes sent

Table NC-3-4 Meanings of the fields in show ipx traffic


Name of field Recv: 0 total 0 drop 0 checksum errors 0 bad hop count 0 discarded(hop=16) 0 encapsulation failed 0 packets patched 0 local destination 0 broadcast 0 forward 0 echo Sent: 0 total 0 broadcast 0 forward 0 echo Type 20: 0 received 0 matched 0 discarded (tc>=8) 0 sent 0 successfully sent 0 encapsulation failed RIP: 0 RIP requests 0 RIP replies 1 RIP requests sent 0 RIP advertisements received 0 sent 1 routes SAP: 0 SAP get nearest requests 0 SAP get nearest replies 0 SAP requests 0 SAP replies 1 SAP requests sent 0 SAP advertisements received 0 sent 1 servers Forward: 0 need forwarding 0 success 0 no route 0 encapsulation failed Echo: 0 requests received Meaning Count of received packets Total packets received Total packets dropped when the router is too busy Total packets dropped due to checksum errors Total packets whose hop values are over 16 Total packets whose hop values=16 Total packets where encapsulation failed Number of packets patched Number of packets whose destination is local Number of received broadcast packets Number of packets to be forwarded Number of received echo packets Total packets sent from the router, including those packets that are to be forwarded for have been generated by itself. Total packets sent Total broadcast packets Total forwarded packets Number of echo packet sent Count of IPX packets of type 20 Total received IPX packets of type 20 Number of matched IPX packets of type 20 Number of IPX packets of type 20 whose hop values are over 7 Number of sent IPX packets of type 20 Number of IPX packets of type 20 successfully sent Number of IPX packets of type 20 that have failed to be sent Count of RIP packets Count of received RIP request packets Count of reply RIP packets Number of sent RIP request packets generated by the router Number of received RIP reply packets Number of RIP reply packets generated by the router Number of routing information items in the routing table Count of SAP packets Number of received SAP GNS request packets Count of replies to the SAP GNS request packet Number of received SAP request packets Count of replies to the SAP request packet Count of SAP request packets generated by the router Number of received SAP reply packets Number of SAP reply messages generated by the router Number of service information table items in the service information table Count of forwarded packets Number of packets to be forwarded Number of packets successfully forwarded Number of packet that has not yet found the destination hop Number of packets that fail to be forwarded due to other causes Count of IPX ping packets Number of received IPX ping requests

3-22

User Manual Command Reference (Volume 1) Versatile Routing Platform Name of field 0 replies sent 0 requests sent 0 replies received 0 no route Total: 412 bytes received 576 bytes sent

Chapter 3
IPX Configuration Commands Meaning

Count of replies to IPX ping requests Number of sent IPX ping requests Number of received IPX ping replies Number of IPX ping packets that fail to find routes Total traffic statistics at the interface Total received IPX packets at the interface Total sent IPX packets at the interface

3-23

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 4
DLSw Configuration Commands

Chapter 4 DLSw Configuration Commands


DLSw configuration commands include: l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l clear dlsw bridge-entry clear dlsw circuits dlsw bridge-group (Global configuration) dlsw bridge-group (Ethernet interface configuration) dlsw bridge-group (synchronous interface configuration) dlsw disable dlsw local-peer tcp dlsw remote-peer tcp dlsw timer encapsulation sdlc idle-mark llc2 ack-delay-time llc2 ack-max llc2 local-window llc2 modulus llc2 N2 llc2 t1-time llc2 tbusy-time llc2 tpf-time llc2 trej-time llc2 txq-max sdlc address sdlc holdq sdlc k sdlc modulus sdlc N1 sdlc N2 sdlc partner sdlc poll-pause-timer sdlc saps sdlc simultaneous sdlc T1 sdlc T2 sdlc xid sdlc role sdlc vmac show dlsw bridge-entry show dlsw capabilities show dlsw circuits show dlsw peers show dlsw reachability debug dlsw debug sllc

4.1 clear dlsw bridge-entry


To clear the buffer memory information of DLSw bridge group entry, use the clear dlse bridge-entry command.

4-1

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 4
DLSw Configuration Commands

clear dlsw bridge-entry

Command Mode
Privileged user mode

Usage Guideline
The command will clear the buffer memory information of DLSw bridge group entry.

4.2 clear dlsw circuits


To clear DLSw circuits information, use the clear dlsw circuit command. clear dlsw circuits [ circuit-id ]

Syntax Description
circuit-id Circuit ID for a specific remote circuit, ranging 0 to 4294967295.

Command Mode
Privileged user mode

Usage Guideline
A user can clear all the DLSw circuits information or the DLSw circuit information of a specific IP address.

4.3 dlsw bridge-group (Ethernet interface configuration)


To link DLSw to the bridge group of the Ethernet LANs, use the dlsw bridge-group command. Use the no form of this command to disable the link. dlsw bridge-group bridge-group-number no dlsw bridge-group bridge-group-number

Syntax Description
bridge-group-number Transparent bridge group to which DLSw ranging 1 to 63, which is also valid at local. will be attached,

Default
No default value.

Command Mode
Privileged user mode

4-2

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 4
DLSw Configuration Commands

Usage Guideline
To forward the messages of the specified bridge group to the remote end over TCP connection, you need to use this command to connect a local bridge group to DLSw. In other words, the messages of the local bridge group can be forwarded to the remote end through TCP channel. You can use the command several times to connect several bridge groups to DLSw, so that all of them can be forwarded through TCP channel.

4.4 dlsw bridge-group (Ethernet interface configuration)


To link DLSw to the Ethernet interface, use the dlsw bridge-group bridge-groupnumber command. Use the no form of this command to disable the link. dlsw bridge-group bridge-group-number no dlsw bridge-group bridge-group-number

Syntax Description
bridge-group-number Transparent bridge group to which the Ethernet interface will be linked, ranging 1 to 63.

Default
No Ethernet interface is added to the bridge group.

Usage Guideline
After adding an Ethernet interface to a bridge group, the LLC2 packets of the Ethernet interface can send to the remote peer entity through the corresponding TCP channel.

4.5 dlsw bridge-group (synchronous interface configuration)


To link DLSw to the synchronous interface, which encapsulated SDLC, use the dlsw bridge-group command. Use the no form of this command to disable the link. dlsw bridge-group bridge-group-number no dlsw bridge-group bridge-group-number

Syntax Description
bridge-group-number ranging 1 to 63. Transparent bridge group to which DLSw will be attached,

Default
No synchronous interface is added to the bridge group.

Usage Guideline
To allow the synchronous interface encapsulated with SDLC to participate in DLSw forwarding, you need to use this command to add SDLC interface to a bridge group. The bridge group on Ethernet interface takes part in the local forwarding, but the bridge

4-3

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 4
DLSw Configuration Commands

group configured in the SDLC only takes part in DLSw forwarding, that is, all of the data on it will be forwarded to TCP channels.

4.6 dlsw disable


To disable DLSw without altering the configuration, use the dlsw disable command. Use the no form of this command to enable DLSw again. dlsw disable no dlsw disable

Default
Disable DLSw.

Command Mode
Global configuration mode

Usage Guideline
After using this command, the system will release all the dynamic resources but reserve the existing configuration.

4.7 dlsw local-peer tcp


To create entities of the DLSw local peer, use the dlsw local-peer command. Use the no form of this command to remove the entities. dlsw local-peer tcp ip-address [cost cost ] [init-pacing-window init-window-size ] [ keepalive keepalive-interval] [ lf lf-size ] [ max-pacing-window max- window-size ] [ promiscuous ] no dlsw local-peer tcp ip-address

Syntax Description
ip-address local peer IP address. cost cost peer cost advertised to remote peers in the capability exchange, ranging 1 to 5. init-window-size size of the initial pacing window as defined in RFC 1795, ranging 1 to 2000 bytes. keepalive-interval default remote peer keepalive interval in seconds, ranging 0 to 1200 seconds. lf-size largest frame size for this local peer, which can be: 516, 1470, 1500, 2052, 4472, 8144, 11407, 11454 or 17800 bytes. max - window-size maximum size of the pacing window as defined in RFC 1795, ranging 1 to 2000 bytes. promiscuous indicates that the remote router not configured beforehand is allowed to initiate connection and create dynamically peer entity. The end using the parameter
4-4

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 4
DLSw Configuration Commands

doesn t need to configure the remote peer entity, instead waiting for the remote end to initiate connection.

Default
cost is 3. init-window-size is 40 bytes. keepalive-interval is 30 seconds. lf-size is 1500 bytes. max-window-size is 50 bytes.

Command Mode
Global configuration mode

Usage Guideline
Creating TCP channel is the first step for establishing DLSw connection. To create TCP channel, you have to firstly configure DLSw local peer entity in order to specify the IP address of the local end for establishing TCP connection, then the request sent by the remote end router can be received for establishing TCP connection. One router can only have one local peer entity.

4.8 dlsw remote-peer tcp


To create DLSw remote peers, use the dlsw remote-peer tcp command. To remove the remote peers, use the no form of this command. dlsw remote-peer tcp ip-address [ backup-peer backup-peer-address ] [ cost cost ] [ keepalive keepalive-interval ] [ lf lf-size ] [ tcp-queue-max max-queue-length ] [ timeout seconds ] [ linger minutes ] no dlsw remote-peer tcp ip-address

Syntax Description
ip-address Specify the IP address of the remote peer cost Transmission cost ranging 1 to 5. keepalive keepalive-intervall Interval of transmitting the keepalive packets, ranging 0 to 1200 seconds. lf lf-size Largest frame size, which can be 516, 1470, 1500, 2052, 4472, 8144, 11407, 11454 or 17800 bytes. tcp-queue-max max-queue-length Maximum length of TCP queues transmitted or received, ranging 50 to 2000 bytes. timeout seconds The waiting time before TCP packets are retransmitted ranging 5 to 1200 seconds. linger minutes The duration when the backup remains connected after the disconnection of the master peer, ranging 1 to 300 minutes.

4-5

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 4
DLSw Configuration Commands

Default
cost is 3. keepalive-interval is 30 seconds. lf-size is 1500 bytes. max-queue-length is 200 bytes. seconds is 90 seconds. minutes is 5 minutes.

Command Mode
Global configuration mode

Usage Guideline
You need to configure the remote peer to establish TCP channel after configuring the local peer. The router will continuously attempt to establish TCP connection with the remote end router. One router can configure several remote peers. TCP channels can be connected with several remote routers by configuring several remote peers. When creating a remote backup peer, please note: 1) When a remote backup peer is created, the tcp ip-address should be the IP address of the remote backup peer. The backup-peer backup-peer-address should be the IP address of the remote master peer, which has established TCP connection. That is, the user should make sure that the local peer has established TCP connection with a remote backup peer before creating connection with remote backup peers. If the user creates a remote peer for the first time and meanwhile, he creates a remote backup peer, the system will prompt the following information:
Primary peer ip address does not exist

This prompt indicates that the user should create a remote backup peer before creating a remote backup peer. 2) If the TCP connection of the main link disconnects and the backup link still exists, the TCP link can also keep working (A TCP connection can be found via the show dlsw peer command) until the backup link linger minutes is timeout.

4.9 dlsw timer


To configure the parameters of DLSw timer, use the dlsw timer command. Use the no form of this command to restore the default parameters. dlsw timer [ connected-timeout seconds ] [ explorer-wait-timeout seconds ] [ local-pending-timeout seconds ] [ remote-pending-timeout seconds ] [ snacache-timeout seconds ] [ sna-explorer-timeout seconds ] no dlsw timer

Syntax Description
connected-timeout seconds length of time that the software waits for an explorer response before marking a resource unreachable, ranging 60 to 60000 seconds.

4-6

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 4
DLSw Configuration Commands

explorer-wait-timeout seconds time to wait for all stations to respond to explorers., ranging 1 to 60000 seconds. local-pending-timeout seconds time to wait for local pending, ranging 1 to 60000 seconds. remote-pending-timeout seconds time to wait for the remote peer pending, ranging 1 to 60000 seconds. sna-cache-timeout seconds length of time that a SNA MAC/service access point (SAP) location cache entry exists before it is discarded (for local and remote caches), ranging 1 to 60000 seconds. sna-explorer-timeout seconds length of time that a SNA explorer exists before it is discarded, ranging 1 to 60000 seconds.

Default
connected-timeout seconds is 300 seconds. explorer-wait-timeout seconds is 10 seconds. local-pending-timeout seconds is 10 seconds. remote-pending-timeout seconds is 30 seconds. sna-cache-timeout seconds is 120 seconds. sna-explorer-timeout seconds is 30 seconds.

Command Mode
Global configuration mode

Usage Guideline
The values of various timers used when DLSw established virtual circuits can be modified by configuring DLSw protocol timer. It is recommended that subscribers do not modify or configure the parameters of DLSw timers in the common conditions.

4.10 encapsulation sdlc


To set SDLC as the link layer encapsulation protocol of synchronous interfaces, use the encapsulation sdlc command. encapsulation sdlc

Default
The link layer protocol encapsulated at synchronous interface is PPP

Command Mode
Synchronous interface configuration mode

4-7

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 4
DLSw Configuration Commands

Usage Guideline
SDLC is a link layer protocol relative to SNA. The working principle is very similar to HDLC. To allow DLSw to operate normally, the encapsulation protocol of synchronous interface link layer should be changed to SDLC Notes that SDLC link protocol can not load IP protocol, so you should remove all of the commands related with IP, such as delete interface IP address, before encapsulating SDLC.

4.11 idle-mark
To assign the encoding mode for the idle time of synchronous interface, use the idlemark command. To restore the default encoding mode for the idle time of synchronous interface, use the no form of this command. idle-mark no idle-mark

Default
The synchronous interface adopts 7E encoding mode

Command Mode
Synchronous interface configuration mode

Usage Guideline
The SDLC serial ports encapsulated by Quidway series of routers is identified with 7E during the idle time, but all of the serial ports on some SDLC equipment use high level working status 1 during the idle time. To improve the compatibility with the equipment, you need to change the idle time encoding mode of our routers. You may need to configure this command when connecting AS/400, that is, to change the idle time encoding mode in order to accelerate the polling rate of AS/400.

4.12 llc2 ack-delay-time


To set the amount of time the software waits for an acknowledgment before sending the next set of information frames, use the llc2 ack-delay-time command. To revert to the default setting, use the no form of this command. llc2 ack-delay-time mseconds no llc2 ack-delay-time

Syntax Description
mseconds Number of milliseconds the software allows incoming information frames to stay unacknowledged, ranging 1 to 60000ms.

4-8

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 4
DLSw Configuration Commands

Default
The local acknowledgement delay time of LLC2 is 100ms.

Command Mode
Ethernet interface configuration mode

Usage Guideline
Upon receiving an information frame, each LLC2 station starts a timer. If the timer expires, an acknowledgment will be sent for the frame, even if the llc2 ack-max number of received frames has not been reached. Experiment with the value of the llc2 ackdelay-time command to determine the configuration that balances acknowledgment network overhead and quick response time (by receipt of timely acknowledgments).

4.13 llc2 ack-max


To control the maximum length of information frames the software can receive before it must send an acknowledgment, use the llc2 ack-max command. To revert to the default setting, use the no form of this command. llc2 ack-max length no llc2 ack-max

Syntax Description
length maximum length of packets the software will receive before sending an acknowledgment, ranging 1 to 127 bytes.

Default
The length of the LLC2 premature acknowledgement window is 3 bytes.

Command Mode
Ethernet interface configuration mode

Usage Guideline
An LLC2-speaking station can send only a predetermined number of frames before it must wait for an acknowledgment from the receiver. If the receiver waits until receiving a large number of frames before acknowledging any of them, and then acknowledges them all at once, it reduces overhead on the network. For example, an acknowledgment for five frames can specify that all five have been received, as opposed to sending a separate acknowledgment for each frame. To keep network overhead low, make this parameter as large as possible.

4-9

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 4
DLSw Configuration Commands

4.14 llc2 local-window


To control the maximum length of information frames the software sends before it waits for an acknowledgment, use the llc2 local-window command. To revert to the default setting, use the no form of this command. llc2 local-window length no llc2 local-window

Syntax Description
length maximum length of packets that can be sent before the software must wait for an acknowledgment, ranging 1 to 127 bytes.

Default
The length of the local acknowledgement window of LLC2 is 7 bytes.

Command Mode
Ethernet interface configuration mode

Usage Guideline
An LLC2-speaking station can send only a predetermined number of frames before it must wait for an acknowledgment from the receiver. Set this number to the maximum value that can be supported by the stations with which the router communicates. Setting this value too large can cause frames to be lost, because the receiving station may not be able to receive all of them.

4.15 llc2 modulus


To set the modulus used by LLC2, use the modulus command. To restore the default modulus used by LLC2, use the no form of the command. llc2 modulus n no llc2 modulus

Syntax Description
n the modulo value used by LLC2, which can be 8 or 128.

Default
The modulo value used by LLC2 is 128.

Command Mode
Ethernet interface configuration mode

4-10

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 4
DLSw Configuration Commands

Usage Guideline
LLC2 uses module mode to number the information message like X25 protocol. The modulo value is 8 or 128. Ethernet generally uses module 128.

4.16 llc2 N2
To control the amount of times the software retries sending unacknowledged frames or repolls remote busy stations, use the llc2 n2 command. To revert to the default setting, use the no form of this command. llc2 N2 retries no llc2 N2

Syntax Description
retries number of times the software retries operations, ranging 1 to 255.

Default
The retries time is 20 retries

Command Mode
Ethernet interface configuration mode

Usage Guideline
The number of times that an LLC2 station retries sending indicates the number of times it will redirect information frames when the receiver of that frame has not acknowledged it.

4.17 llc2 t1-time


To control the amount of time the software will wait before redirecting unacknowledged information frames, use the llc2 t1-time command. To revert to the default setting, use the no form of this command. llc2 t1-time mseconds no llc2 t1-time

Syntax Description
mseconds number of ms the software waits before redirecting unacknowledged information frames, ranging 1 to 60000 ms.

Default
The local acknowledgement time of LLC2 is 200ms

Command Mode
Ethernet interface configuration mode
4-11

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 4
DLSw Configuration Commands

Usage Guideline
The local acknowledgement time of LLC2 indicates the maximum waiting time for the receiver s answer after a LLC2 data packet is sent out.

4.18 llc2 tbusy-time


To control the amount of time the software waits until repolling a busy remote station, use the llc2 tbusy-time interface configuration command. To revert to the default setting, use the no form of this command. llc2 tbusy-time mseconds no llc2 tbusy-time

Syntax Description
mseconds Number of ms the software waits before repolling a busy remote station, ranging 1 to 60000 ms.

Default
BUSY status time for LLC2 is 300 ms

Command Mode
Ethernet interface configuration mode

Usage Guideline
BUSY status time for LLC2 indicates the amount of time the software waits until repolling a busy remote station.

4.19 llc2 tpf-time


To set the amount of time the software waits for a final response to a poll frame before redirecting the poll frame, use the llc2 tpf-time command. To revert to the default setting, use the no form of this command. llc2 tpf-time mseconds no llc2 tpf-time

Syntax Description
mseconds number of ms the software waits for a final response to a poll frame before redirecting the poll frame, ranging 1 to 60000ms.

Default
The P/F wait time of LLC2 is 5000 ms

Command Mode
Ethernet interface configuration mode
4-12

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 4
DLSw Configuration Commands

Usage Guideline
The P/F wait time of LLC2 indicates the amount of time the software waits for the correct information frame after sending the P frame.

4.20 llc2 trej-time


To control the amount of time the software waits for a correct frame after sending a reject command to the remote LLC2 station, use the llc2 trej-time command. To revert to the default setting, use the no form of this command. llc2 trej-time mseconds no llc2 trej-time

Syntax Description
mseconds number of ms the software waits for a redirect of a rejected frame before sending a reject command to the remote station, ranging 1 to 60000 ms.

Default
The rejected frame waiting time of LLC2 is 3200 ms

Command Mode
Ethernet interface configuration mode

Usage Guideline
The REJ status time of LLC2 indicates the amount of time the software waits for a correct frame after sending a reject command to the remote LLC2 station.

4.21 llc2 txq-max


To control the queue length of messages sent of LLC2, use the ll2 txq-max command. To revert to the default setting, use the no form of this command. llc2 txq-max length no llc2 txq-max

Syntax Description
length queue length of messages sent of LLC2, ranging 20 to 200 bytes.

Default
The queue length of messages sent of LLC2 is 20 bytes

Command Mode
Ethernet interface configuration mode

4-13

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 4
DLSw Configuration Commands

4.22 sdlc address


To assign a set of secondary stations attached to the serial link, use the sdlc address command. To remove an assigned secondary station, use the no form of this command. sdlc addr sdlc-address no sdlc addr sdlc-address

Syntax Description
sdlc-address hexadecimal number (base 16) indicating the address of the serial link.

Default
No secondary stations are assigned

Command Mode
Synchronous interface configuration mode

Usage Guideline
SDLC protocol permits that several virtual circuits exist in a SDLC physics link. The one end connects to the primary station and the other end connects to the secondary station. You should specify the SDLC address of each virtual circuit so as to differentiate each virtual circuit. SDLC is unbalanced mode through sharer or SDLC switch. One primary equipment can be connected with several secondary equipment and the relationship is unique. However, connection can not be established between secondary equipment. It can ensure that communication normally operates in one group of SDLC equipment only if the addresses of secondary equipment are identified. This command is used to specify SDLC address for virtual circuit. The address is unique in a physical interface. The SDLC address configured on the synchronous interface is de facto the address of SDLC secondary station. SDLC addresses range from 0x01 to 0xFE. The SDLC address on a router is valid for one physical interface. That is, the SDLC addresses configured on the different interfaces can be same.

4.23 sdlc holdq


To control the maximum length of packets that can be held in a buffer before being transmitted to a remote SDLC station, use the sdlc holdq command. To revert to the default setting, use the no form of this command. sdlc holdq length no sdlc holdq

Syntax Description
length queue length of messages sent of SDLC, ranging 20 to 255 bytes.

4-14

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 4
DLSw Configuration Commands

Default
The queue length of messages sent of SDLC is 20 bytes

Command Mode
Synchronous interface configuration mode

Usage Guideline
This command can configure the queue length of the messages sent of SDLC.

4.24 sdlc k
To set the window size in order to control the maximum number of information frames the software transmits before it must stop transmitting and wait for an acknowledgment from the receiving router, use the sdlc k command. To revert to the default setting, use the no form of this command. sdlc k length no sdlc k

Syntax Description
length length of the local acknowledgement window, ranging 1 to 7 bytes.

Default
The length of the local acknowledgement window of SDLC is 7 bytes

Command Mode
Synchronous interface configuration mode

Usage Guideline
The local acknowledgement window of SDLC indicates the maximum number of information frames it will send before it must stop sending and wait for an acknowledgment.

4.25 sdlc modulus


To set the modulus used by SDLC, use the sdlc modulus command. To restore the default modulus used by SDLC, use the no form of the command. sdlc modulus n no sdlc modulus

Syntax Description
n modulo value used by SDLC, which can be 8 or 128.

4-15

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 4
DLSw Configuration Commands

Default
The modulo value used by SDLC is 8

Command Mode
Synchronous interface configuration mode

Usage Guideline
SDLC uses module mode to number the information message like X25 protocol. The modulo value is 8 or 128. SDLC generally uses module 8.

4.26 sdlc n1
To control the maximum size of an incoming frame, use the sdlc n1 command. To revert to the default setting, use the no form of this command. sdlc n1 n no sdlc n1

Syntax Description
n number indicating bit size. Frames that exceed this size are rejected, ranging 1 to 17680 bytes

Default
The maximum frame length receivable of SDLC is 265 bytes

Command Mode
Synchronous interface configuration mode

Usage Guideline
Maximum frame length of SDLC refers to byte number of maximum transmissible and receivable message, not including parity bit and stop bit. Generally, the length is 265 for some PU2.0 equipment and 521 for IBM AS/400.We often need to configure our equipment to be the same values as the connected SDLC equipment.

4.27 sdlc n2
To determine the number of retries that the software resends a frame before terminating the SDLC session, use the sdlc n2 command. To revert to the default setting, use the no form of this command. sdlc n2 retries no sdlc n2

4-16

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 4
DLSw Configuration Commands

Syntax Description
retries number of retry attempts, ranging 1 to 255.

Default
The retransmission number of SDLC is 20 retries

Command Mode
Synchronous interface configuration mode

Usage Guideline
The retransmission number N2 of SDLC refers to the retransmission number before receiving no acknowledgement packet sent by the other part.

4.28 sdlc partner


To specify the peer with which an LLC session is established for the SDLC station, use the sdlc partner command. To cancel the configuration, use the no form of this command. sdlc partner mac-addr sdlc-addr no sdlc partner mac-addr sdlc-addr

Syntax Description
mac-addr the 48-bit Media Access Control (MAC) address. sdlc-address SDLC address of the serial device that will communicate with the host, ranging 1 to FE.

Default
Synchronous interface without SDLC address

Command Mode
Synchronous interface configuration mode

Usage Guideline
This command is used to specify a next-hop MAC address on the other end for a SDLC virtual address so as to provide the destination MAC address when transforming from SDLC to LLC2. When setting up DLSw, one SDLC address should be configured with one corresponding partner. The MAC address of partner shall be the MAC address of the remote end SNA equipment (physical addresses of such equipment as Ethernet and Token-Ring) or next-hop MAC address composed of SDLC.

4-17

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 4
DLSw Configuration Commands

4.29 sdlc poll-pause-timer


To control how long the software pauses between sending each poll frame to secondary stations on a single serial interface, use the sdlc poll-pause-timer command. To retrieve the default value, use the no form of this command. sdlc poll-pause-timer mseconds no sdlc poll-pause-timer

Syntax Description
mseconds number of ms that the software waits before sending the poll frame to a single serial interface, ranging 1 to 10000ms.

Default
The poll time interval of SDLC is 100ms

Command Mode
Synchronous interface configuration mode

Usage Guideline
Poll time interval of SDLC refers to wait time interval between two SDLC nodes polled by SDLC primary station.

4.30 sdlc saps


Configure SDLC to transform the SAP address of LLC2. The no form the command is used to restore the default value of the SAP address of LLC2. sdlc saps sdlc-addr lsap lsap no sdlc saps sdlc-addr

Syntax Description
sdlc-addr SDLC address. lsap Virtual SAP address set up for the connective equipment of the interface. dsap SAP address of the specified DLSw opposite end equipment.

Default
Both lsap and lsap of LLC2 are 04.

Command Mode
Synchronous interface configuration mode

4-18

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 4
DLSw Configuration Commands

Usage Guideline
When transforming SDLC message to LLC2 message, it also need SAP address besides MAC address. This command is used to specify SAP address used when transforming llc2 for a SDLC byte. Generally, the SAP address used by SNA protocol is 0x04, 0x08 or 0x0C.

4.31 sdlc simultaneous


To enable an interface configured as a primary SDLC station to operate in simultaneous mode, use the sdlc simultaneous command. To disable this function, use the no form of this command. sdlc simultaneous no sdlc simultaneous

Default
By default, the SDLC driver supports alternative mode.

Command Mode
Synchronous interface configuration mode

Usage Guideline
Use this command to enable the simultaneous interface encapsulated with SDLC to operate in alternate mode. That is to say, the simultaneous mode enables the interface configured as a primary SDLC station to send data to a secondary station, even when it is receiving data from another secondary station.

4.32 sdlc T1
To control the amount of time the software waits for a primary station acknowledgment frame or sequence of frames, use the sdlc t1 command. To revert to the default value, use the no form of this command. sdlc t1 mseconds no sdlc t1

Syntax Description
mseconds number of ms that the software waits for an acknowledgment packet from primary station, ranging 1 to 60000ms.

Default
Configure the acknowledgement wait time T1 of SDLC Primary Station to be 3000 ms.

Command Mode
Synchronous interface configuration mode

4-19

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 4
DLSw Configuration Commands

Usage Guideline
Acknowledgement wait time T2 of secondary station refers to the duration that the secondary station waits for acknowledgement from secondary station after sending information frame.

4.33 sdlc T2
To control the amount of time the software waits for a secondary station acknowledgment frame or sequence of frames, use the sdlc t2 command. To revert to the default value, use the no form of this command. sdlc t2 mseconds no sdlc t2

Syntax Description
mseconds Number of ms that the software waits for an acknowledgment packet from primary station, ranging 1 to 60000ms.

Default
The acknowledgement wait time of SDLC secondary station T2 is 500ms.

Command Mode
Synchronous interface configuration mode

Usage Guideline
Acknowledgement wait time T3 of secondary station refers to the duration that the primary station waits for acknowledgement from primary station after sending information frame.

4.34 sdlc xid


To specify an exchange ID (XID) value appropriate for the designated SDLC station associated with this serial interface, use the sdlc xid command. To disable XID processing for this address, use the no form of this command. sdlc xid sdlc-address xid-number no sdlc xid sdlc-address

Syntax Description
sdlc-address address of the SDLC station associated with this interface. xid-number XID the software will use to respond to XID requests the router receives, whose first 12bit is network number and last 24bit is node number.

Default
Disabled

4-20

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 4
DLSw Configuration Commands

Command Mode
Synchronous interface configuration mode

Usage Guideline
XID is an identification of the equipment identity in the SNA world. Generally, there are two kinds of equipment - PU2.0 and PU2.1.PU2.1 equipment itself is configured with XID, so it can show the identities of each other by exchanging XID; while PU2.0 equipment doesn t exchange XID, thus there is no XID. Therefore, the equipment of PU2.1 type doesn t need to be configured with this command, while PU2.0 equipment needs it to specify one XID.

4.35 sdlc role


To establish the router to be either a primary or secondary SDLC station, use the sdlc role command. To cancel the designation, use the no form of this command. sdlc role { primary | secondary } no sdlc role

Syntax Description
primary establishes the router as a primary station. secondary establishes the router as a secondary station.

Default
secondary

Command Mode
Synchronous interface configuration mode

Usage Guideline
SDLC is a link layer protocol in the unbalanced mode. In another words, the connected equipment on the both ends does not have unequal priority. One of the parts is the primary station that plays the leading role and controls the whole connection process and its role is primary. The other part is the secondary station that is controlled in a passive mode and its role is secondary. Subscribers need to configure role for the interface encapsulated with SDLC protocol. SDLC role shall be configured according to the role of SDLC equipment connecting with this router. If SDLC equipment connecting with the interface is primary, the interface should be set to secondary. If the connected equipment is secondary, the interface should be set to primary. Generally, the central IBM mainframes are primary, and terminal equipment are secondary, such as Unix host and ATM machine.

4-21

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 4
DLSw Configuration Commands

4.36 sdlc vmac


To configure a MAC address for the serial interface, use the sdlc vmac command. To disable the configuration, use the no form of this command. sdlc vmac mac-address no sdlc vmac

Syntax Description
mac-addres 48-bit MAC address of the host.

Default
Disabled

Command Mode
Synchronous interface configuration mode

Usage Guideline
This command must be configured if you plan to configure DLSw. The last byte of the address must be 00.

4.37 show dlsw bridge-entry


To display the bridge group information, use the show dlsw bridge-entry command. show dlsw bridge-entry

Command Mode
Privileged user mode

Example
Quidway# show dlsw bridge-engry
mac_entry 0000.e81c.b6bf Port Ethernet0 group 1 hashIndex 79

4.38 show dlsw capabilities


To display the performance exchange information of DLSw, use the show dlsw capabilities command. show dlsw capabilities [ local ] [ ip-address ]

Syntax Description
local show local information for performance exchange. ip-address show performance exchange information with specified IP address.

4-22

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 4
DLSw Configuration Commands

Command Mode
Privileged user mode

Usage Guideline
The output information of this command is helpful for the user to conduct IPX flow statistics and fault diagnosis.

Example
Quidway# show dlsw capabilities
DLSw: Capabilities for peer 14.0.0.1 Vendor ID (OUI) : 00000c Version number : 01 Release number : 00 Init Pacing Window : 40 Num of TCP sessions : 01 Mac address exclusive : no NetBIOS Name exclusive : no Mac address List : none NetBIOS Name List : none Configured IP address : 14.0.0.1 Version string : VRP (tm) 3640 series software, Version 1.3.1, RELEASE(1) Copyright (c) 1997-2001 HUAWEI TECH CO., LTD.

Quidway# show dlsw capabilities local


DLSw: Capabilities for peer 12.0.0.1 Vendor ID (OUI): '00e0fc' (HuaWei) Version number: 1 Release number: 0 Init Pacing Window: 40 Num of TCP sessions: 1 Mac address exclusive: no NetBIOS Name exclusive: no Mac address List: none NetBIOS Name List: none Configured IP address: 12.0.0.1 Version string: VRP (tm) 2630 series software, Version 1.3.1, RELEASE(1) Copyright (c) 1997-2001 HUAWEI TECH CO., LTD.

4.39 show dlsw circuits


To display the virtual circuit information of DLSw, use the show dlsw circuits command. show dlsw circuits [ circuit-id ] [ detail ]

Syntax Description
circuit-id displays the virtual circuit number of DLSw, ranging 0 to 4294967295. detail displays the ordinary detailed information of the virtual circuit.

Command Mode
Privileged user mode

4-23

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 4
DLSw Configuration Commands

Usage Guideline
The output information of this command is helpful for the user to conduct IPX flow statistics and fault diagnosis.

Example
Quidway# show dlsw circuits
Correlator 0x00a2000a local addr(lsap) 0000.1738.6dfd(04) remote addr(rsap) 0000.1722.3435(04) state CONNECTED

Quidway# show dlsw circuits detail


Correlator local addr(lsap) remote addr(rsap) state 0x00a2000a 0000.1738.6dfd(04) 0000.1722.3435(04) CONNECTED Port: Ethernet0 Peer: 14.0.0.1 Direction: 1 LifeTime: 14:19:49 FC Tx CW:40, PT:40; Rx CW:40, GT:40; FCI:0; Delay:0; Op:0 Local-Ack Vs:0, Vr:0, VaSend:0, VaRecv:0, CW-Tx:0, CW-Rx:0 DLC_STATE: 3, Vt:0 Wack-len:0, Send-len:0 SSP-tx: 0 SSP-rx: 0 I-frame: tx 0 rx 0 dx 0

4.40 show dlsw peers


To display the remote end peer entity information, use the show dlsw peers command. show dlsw peers [ ip-address ]

Syntax Description
ip-address displays the remote end peer entity information with certain IP address.

Command Mode
Privileged user mode

Usage Guideline
The output information of this command is helpful for the user to conduct IPX flow statistics and fault diagnosis.

Example
Quidway# show dlsw peers
TCP TCP TCP Peers: 11.0.0.1 13.0.0.1 14.0.0.1 State DISCONNECT DISCONNECT CONNECT pkts_rx 0 0 1897 0 0 1899 pkts_tx 0 0 0 drops uptime 14:26:22

4.41 show dlsw reachability


To display the information of MAC buffers, use the show dlsw reachablity command. show dlsw reachability

Command Mode
Privileged user mode

4-24

User Manual Command Reference (Volume 1) Versatile Routing Platform

Chapter 4
DLSw Configuration Commands

Usage Guideline
The output information of this command is helpful for the user to conduct IPX flow statistics and fault diagnosis.

Example
Quidway# show dlsw reachability
DLSw Local MAC address reachability cache list Mac addr status Loc. Port 0000.3817.fd6d FOUND LOCAL Ethernet0 DLSw Remote MAC address reachability cache list Mac addr status Loc. Peer 0000.2217.3534 FOUND REMOTE 14.0.0.1

4.42 debug dlsw


Enable the debugging information of DLSw, use the debug dlsw command. debug dlsw [ circuit | core |event | packet | peers ]

Syntax Description
circuit enables the DLSw circuit, open the debugging. core enables the DLSw status machine debugging . event enables the DLSw abnormal events debugging. packet enables the DLSw messages debugging. peers enables the DLSw peer entity debugging.

Command Mode
Privileged user mode

4.43 debug sllc


Enable the information debugging of SDLC. debug dlsw [ event | event ]

Syntax Description
event enables the SDLC events debugging. event enables the SDLC events debugging .

Command Mode
Privileged user mode

4-25