![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() |
Cisco's serial tunnel (STUN) feature allows Synchronous Data Link Control (SDLC) or High-Level Data-Link Control (HDLC) devices to connect to one another through a multiprotocol internetwork rather than through a direct serial link. STUN encapsulates SDLC frames in either the Transmission Control Protocol/Internet Protocol (TCP/IP) or the HDLC protocol. STUN provides a straight passthrough of all SDLC traffic (including control frames, such as Receiver Ready) end-to-end between Systems Network Architecture (SNA) devices.
Cisco's SDLC Local Acknowledgment provides local termination of the SDLC session, so that control frames no longer travel the WAN backbone networks. This means end nodes do not time out, and a loss of sessions does not occur. You can configure your network with STUN, or with STUN and SDLC Local Acknowledgment. To enable SDLC Local Acknowledgment, routers must first be enabled for STUN and configured to appear on the network as primary or secondary SDLC nodes. TCP/IP encapsulation must be enabled. Cisco's SDLC Transport feature also provides priority queuing for TCP encapsulated frames.
Cisco's block serial tunnel (BSTUN) implementation enables Cisco series 2500, 4000, and 4500 routers to support devices that use the Binary Synchronous Communication (BSC) data link protocol This enables enterprises to transport BSC traffic and SNA multiprotocol traffic over the same network.
Use the commands in this chapter to configure BSTUN, BSC, STUN, and SDLC Local Acknowledgment networks. For STUN and BSTUN configuration information and examples, refer to the "Configuring STUN and BSTUN" chapter in the Router Products Configuration Guide.
Use the bsc char-set interface configuration command to specify the character set used by the BSC support feature in this serial interface as either EBCDIC or ASCII.
bsc char-set char-set
char-set | The character set. Valid keywords are ebcdic or ascii. |
EBCDIC is the default character set.
Interface configuration
The following command specifies that the ASCII character set will be used:
bsc char-set ascii
Use the bsc contention interface configuration command to specify that the BSC link connected to the serial interface is a point-to-point BSC station. Use the no form of this command to cancel the specification.
bsc contentionThis command has no arguments or keywords.
BSC contention is disabled by default.
Interface configuration
Because there is no address field used in the point-to-point BSC, a dummy address 01H is always used for encapsulation. To remove this address dependency, use the bstun route all command for point-to-point BSC link.
The following command specifies that the BSC link connected to the serial interface is a point-to-point BSC station:
bsc contention
The full-duplex interface configuration command replaces the bsc fdx command. Refer to the description of the full-duplex command in the "Interface Commands" chapter of this document for information on how to specify full-duplex mode.
Use the bsc pause interface configuration command to specify the interval to the tenth of a second, between the start of a polling cycle. Use the no form of this command to cancel the specification.
bsc pause time
time | Interval in tenths of a second. |
The default interval is 1 second.
Interface configuration
The following command sets the interval to 2 seconds:
bsc pause 20
Use the bsc poll-timeout interface configuration command to specify the polling timeout to the tenth of a second. Use the no form of this command to cancel the specification.
bsc poll-timeout time
time | Time in tenths of a second. |
The default poll timeout is 1 second.
Interface configuration
The following command sets the interval to 2 seconds:
bsc poll-timeout 20
Use the bsc primary interface configuration command to specify that the router is acting as the primary end of the BSC link connected to the serial interface, and that the attached remote devices are BSC tributary stations. Use the no form of this command to cancel the specification.
bsc primaryThis command has no arguments or keywords.
No default is specified.
Interface configuration
The BSC support feature in the serial interface uses the address of the incoming encapsulation for reply.
The following example specifies the router as the primary role:
bsc primary
Use the bsc retries interface configuration command to specify the number of retries performed before a device is considered to have failed. Use the no form of this command to cancel the specification.
bsc retries retries
retries | Number of retries before a device fails. |
The default number of retries is 5.
Interface configuration
The following command sets the retry count to 10:
bsc retries 10
Use the bsc secondary interface configuration command to specify that the router is acting as the secondary end of the BSC link connected to the serial interface, and the attached remote device is a BSC control station.
bsc secondaryThis command has no arguments or keywords.
No default is specified.
Interface configuration
The BSC support feature in this serial interface uses the address of the poll or selection block in the framing encapsulation. It also generates an EOT frame preceding each BSC poll and selection.
The following example specifies the router as the secondary role:
bsc secondary
Use the bsc servlim interface configuration command to specify the number of cycles of the active poll list that are performed between polls to control units in the inactive poll list. Use the no form of this command to cancel the specification.
bsc servlim servlim-count
servlim-count | Number of cycles. |
The default number of cycles is 3.
Interface configuration
The following command sets the number of cycles to 2:
bsc servlim 2
Use the bsc spec-poll interface configuration command to specify specific polls, rather than general polls, used on the host-to-router connection. Use the no form of this command to cancel the specification.
bsc spec-pollThis command has no arguments or keywords.
No default is specified.
Interface configuration
Use the bsc spec-poll command when a router is connected to a host, and only when that host issues specific polls rather than general polls. Tandem hosts that poll ATM cash machines are typically configured to use specific polls rather than general polls.
Configuring a downstream (control-unit/device connected) router to support specific polling has no effect.
The following commands configure interface serial 0 to use specific poll:
interface serial 0 description Connection to host. encapsulation bstun bstun group 1 bsc secondary bsc spec-poll bsc char-set ebcdic bstun route all tcp <ip-addr-of-remote-peer>
Use the bstun group interface configuration command to specify the BSTUN group to which the interface belongs. Use the no form of this command to remove the interface from the BSTUN group.
bstun group group-number
group-number | The BSTUN group to which the interface belongs. |
No default is specified.
Interface configuration
Each BSTUN-enabled interface on a router must be placed in a BSTUN group that was previously defined by the bstun protocol-group command. Packets only travel between BSTUN-enabled interfaces that are in the same group.
The following example specifies that serial interface 0 belongs to the previously defined protocol group 1:
bstun group 1
bstun protocol-group
encapsulation bstun
Use the bstun keepalive-count global configuration command to define the number of times to attempt a peer connection before declaring the peer connection to be down. Use the no form of this command to cancel the definition.
bstun keepalive-count count
count | Number of connection attempts. The range is between 2 and 10 retries. |
No default is specified.
Global configuration
The following example sets the number of times to retry a connection to a peer to 4:
bstun keepalive-count 4
ip-address | Address by which this BSTUN peer is known to other BSTUN peers that are using the TCP transport. |
No default is specified.
Global configuration
The bstun peer-name command must be configured even if TCP transport is not used.
The following example enables the block serial tunneling function:
bstun peer-name 150.10.254.201
Use the bstun protocol-group global configuration command to define a BSTUN group, and the protocol it uses. Use the no form of this command to delete the BSTUN group.
bstun protocol-group group-number protocol {bsc | bsc-local-ack}
group-number | The BSTUN group number. Valid numbers are decimal integers in the range 1 to 255. |
protocol | Currently the only supported block serial protocol is bsc. |
bsc | Enables BSC passthrough. |
bsc-local-ack | Enables local acknowledgment of BSC frames. |
No defaults are specified.
Global configuration
The following example assigns defines BSTUN group 1 and specifies that it uses the BSC protocol, and that frames will be locally acknowledged:
bstun protocol-group 1 bsc-local-ack
Use the bstun remote-peer-keepalive global configuration command to enable detection of the loss of a peer. Use the no form of this command to disable detection.
bstun remote-peer-keepalive seconds
seconds | Keepalive interval, in seconds. The range is 1 to 300 seconds. |
The default is 30 seconds
Global configuration
In the following example, the remote-peer-keepalive interval is set to 60 seconds:
bstun remote-peer-keepalive 60
Use the bstun route interface configuration command to define how frames will be forwarded from a BSTUN interface. Use the no form of this command to cancel the definition.
bstun route {all | address address-number} {tcp ip-address | interface serial number} [direct]
all | All BSTUN traffic received on the input interface is propagated, regardless of the address contained in the serial frame. |
address | The serial frame that contains a specific address is propagated. |
address-number | For BSC protocols, address number is the poll address. |
tcp | TCP encapsulation is used to propagate frames that match the entry. |
ip-address | The IP address of the remote BSTUN peer. |
interface serial | HDLC encapsulation is used to propagate the serial frames. |
number | The serial line to an appropriately configured router on the other end. |
direct | (Optional) The specified interface is also a direct BSTUN link, rather than a serial connection to another peer. |
No defaults are specified.
Interface configuration
The following example, all BSTUN traffic received on serial interface 0 is propagated, regardless of the address contained in the serial frame:
bstun route all interface serial 0
Use the encapsulation bstun interface configuration command to configure BSTUN on a particular serial interface. Use the no form of this command to disable the BSTUN function on the interface.
encapsulation bstunThis command has no arguments or keywords.
No default is specified.
Interface configuration
The encapsulation bstun command must be configured on an interface before any further BSTUN or BSC commands are configured for the interface.
You must use this command to enable BSTUN on an interface. Before using this command, complete the following two tasks:
After using the encapsulation bstun command, use the bstun group command to place the interface in the previously defined protocol group.
The following example configures the BSTUN function on serial interface 1:
interface serial0 no ip address encapsulation bstun
bstun group
bstun peer-name
bstun protocol-group
Use the encapsulation stun interface configuration command to enable STUN encapsulation on a specified serial interface.
encapsulation stunThis command has no arguments or keywords.
STUN encapsulation is disabled
Interface configuration
Use this command to enable STUN on an interface. Before using this command, complete the following two tasks:
After using the encapsulation stun command, use the stun group command to place the interface in the previously defined protocol group.
This partial configuration example shows how to enable serial interface 5 for STUN traffic:
! sample stun peer name and stun protocol-group global commands stun peer-name 131.108.254.6 stun protocol-group 2 sdlc ! interface serial 5 ! sample ip address command no ip address ! enable the interface for STUN; must specify encapsulation stun ! command to further configure the interface encapsulation stun ! place interface serial 5 in previously defined STUN group 2 stun group 2 ! enter stun route command stun route 7 tcp 131.108.254.7
stun group
stun peer-name
stun protocol-group
Use the locaddr-priority-list interface configuration command to establish queuing priorities based upon the address of the logical unit (LU). Use the no form of this command to cancel all previous assignments.
locaddr-priority-list list-number address-number queue-keyword
list-number | Arbitrary integer between 1 and 10 that identifies the LU address priority list. |
address-number | Value of the LOCADDR= parameter on the LU macro, which is a 1-byte address of the LU in hexadecimal. |
queue-keyword | Priority queue type: high, medium, normal, or low. |
No queuing priorities are established.
Interface configuration
The following example shows how to establish queuing priorities based on the address of the serial link on a STUN connection. Note that you must use the priority-group interface configuration command to assign a priority group to an input interface:
stun peer-name 131.108.254.6 stun protocol-group 1 sdlc ! interface serial 0 no ip address encapsulation stun stun group 1 stun route address 4 interface serial 0 direct locaddr priority 1 priority-group 1 ! locaddr-priority-list 1 02 high locaddr-priority-list 1 03 high locaddr-priority-list 1 04 medium locaddr-priority-list 1 05 low
Use the priority-group interface configuration command to assign a priority group to an interface. Use the no form of this command to remove assignments.
priority-group list-number
list-number | Priority list number assigned to the interface. |
No priority group is assigned.
Interface configuration
The following example shows how to establish queuing priorities based on the address of the serial link on a STUN connection. Note that you must use the priority-group interface configuration command to assign a priority group to an output interface.
! sample stun peer-name global command stun peer-name 131.108.254.6 ! sample protocol-group command for reference stun protocol-group 1 sdlc ! interface serial 0 ! disable the ip address for interface serial 0 no ip address ! enable the interface for STUN encapsulation stun ! sample stun group command stun group 2 ! sample stun route command stun route address 10 tcp 131.108.254.8 local-ack priority ! ! assign priority group 1 to the input side of interface serial 0 priority-group 1 ! assign a low priority to priority list 1 on serial link identified ! by group 2 and address A7 priority-list 1 stun low address 2 A7
locaddr-priority-list
priority-list protocol ip tcp
priority-list stun address
Use the priority-list protocol bstun global configuration command to establish BSTUN queuing priorities based on the BSTUN header. Use the no form of this command to revert to normal priorities.
priority-list list-number protocol bstun queue [gt packetsize] [lt packetsize]
list-number | Arbitrary integer between 1 and 10 that identifies the priority list selected by the user. |
queue | Priority queue type: high, medium, normal, or low. |
gt | lt packetsize | (Optional) Output interface examines header information and packet size and places packets with the BSTUN header that match criteria gt or lt specified packet size) on specified output. |
address bstun-group bsc-addr | (Optional) Output interface examines header information and BSC address and places packets with the BSTUN header that match BSC address on the specified output queue. |
Prioritize based on BSTUN header.
Global configuration
In the following example, the output interface examines the header information and places packets with the BSTUN header on the output queue specified as medium.
priority-list 1 protocol bstun medium
Use the priority-list protocol ip tcp global configuration command to establish BSTUN or STUN queuing priorities based on the TCP port. Use the no form of this command to revert to normal priorities.
priority-list list-number protocol ip queue tcp tcp-port-number
list-number | Arbitrary integer between 1 and 10 that identifies the priority list selected by the user. |
queue | Priority queue type: high, medium, normal, or low. |
tcp-port-number | BSTUN port and priority settings are as follows: |
The default is normal queue.
Global configuration
Use the priority-list stun address command first. Priority settings created with this command are assigned to SDLC ports.
In the following example, queuing priority for address C1 using priority list 1 is set to high. A priority queue of high is assigned to the SDLC port 1994.
priority-list 1 stun high address 1 C1 priority-list 1 protocol ip high tcp 1994
In the following example, queueing priority for address C1 using priority list 1 is set to high. A priority queue of high is assigned to BSTUN port 1976.
priority-list bstun high address 1 c1 priority-list 1 protocol ip high 1976
bstun protocol-group
priority-group
encapsulation bstun
encapsulation stun
priority-list stun address
Use the priority-list stun address global configuration command to establish STUN queuing priorities based on the address of the serial link. Use the no form of this command to revert to normal priorities.
priority-list list-number stun queue-keyword address group-number address-number
list-number | Arbitrary integer between 1 and 10 that identifies the priority list selected by the user. |
queue-keyword | Priority queue type: high, medium, normal, or low. |
group-number | Group number that is used in the stun group command. |
address-number | Address of the serial link. For an SDLC link, the format is a 1-byte hex value (for example, C1). For a non-SDLC link, the address format can be specified by the stun schema command. |
The default is normal queue.
Global configuration
The priority-list command is described in greater detail in the "System Management Commands" chapter.
In the following example, queuing priority for address C1 using priority list 1 is set to high:
priority-list 1 stun high address 1 C1
priority-list protocol ip tcp
stun group
stun schema offset length format
Use the queue-list protocol bstun global configuration command to customize BSTUN queuing priorities based on the BSTUN header. Use the no form of this command to revert to normal priorities.
queue-list list-number protocol bstun queue [gt packetsize] [lt packetsize]
list-number | Arbitrary integer between 1 and 10 that identifies the priority list selected by the user. |
queue | Priority queue type: high, medium, normal, or low. |
gt | lt packetsize | (Optional) Output interface examines header information and packet size and places packets with the BSTUN header that match criteria gt or lt specified packet size) on specified output. |
address bstun-group bsc-addr | (Optional) Output interface examines header information and BSC address and places packets with the BSTUN header that match BSC address on the specified output queue. |
Prioritize based on BSTUN header.
Global configuration
In the following example, the output interface examines the header information and places packets with the BSTUN header on the output queue specified as medium.
queue-list 1 protocol bstun medium
Use the queue-list protocol ip tcp global configuration command to customize BSTUN or priorities based on the TCP port. Use the no form of this command to revert to normal priorities.
queue-list list-number protocol ip queue tcp tcp-port-number
list-number | Arbitrary integer between 1 and 10 that identifies the priority list selected by the user. |
queue | Priority queue type: high, medium, normal, or low. |
tcp-port-number | BSTUN port and priority settings are as follows: |
The default is normal queue.
Global configuration
In the following example, queueing priority for address C1 using priority list 1 is set to high. A priority queue of high is assigned to BSTUN port 1976.
queue-list bstun high address 1 c1 queue-list 1 protocol ip high 1976
Use the sdlc virtual-multidrop interface configuration command to allow SDLC broadcast address FF to be replicated for each of the STUN peers, so each of the end stations receive the broadcast frame. Use the no form of this command to disable the SDLC broadcast feature.
sdlc virtual-multidropThis command has no arguments or keywords.
Interface configuration
The following example allows each STUN peer to receive a broadcast frame:
sdlc virtual-multidrop
Use the show bsc privileged EXEC command to display statistics about the interfaces on which BSC is configured.
show bscThis command has no arguments or keywords.
Privileged EXEC
The following is sample output from the show bsc command:
Router# show bsc BSC local-ack on Serial2: Poll mode is pollee. BSC State is CU_Idle. Tx Counts: 0 frames(total). 0 frames(data). 0 bytes. Rx Counts: 130218 frames(total). 0 frames(data). 390654 bytes. Control units on this interface: CU poll address: C1. Select address is 61. *CURRENT-CU* CU state is: inactive. Tx Counts: 0 frames(total). 0 frames(data). 0 bytes. Rx Counts: 32504 frames(total). 0 frames(data). 162520 bytes. CU poll address: 40. Select address is 60. CU state is: inactive. Tx Counts: 0 frames(total). 0 frames(data). 0 bytes. Rx Counts: 32504 frames(total). 0 frames(data). 162520 bytes.
Use the show bstun privileged EXEC command to display the current status of STUN connections.
show bstunThis command has no arguments or keywords.
Privileged EXEC
The following is sample output from the show bstun command:
Router# show bstun This peer: 192.195.80.161 Serial1 (group 1 [bsc]) state rx-pkts tx-pkts drops 1 TCP 192.195.80.162 Open 50 0 0
In the display, the first entry reports proxy polling enabled for address 7 and that Serial 0 is running with modulus 8 on the primary side of the link. The link has received 20,334 packets, transmitted 86,440 packets, and dropped 5 packets.
Table 27-1 describes significant fields shown in the output.
Field | Description |
---|---|
This peer | Lists the peer-name or address. The interface name (as defined by the description command), its BSTUN group number, and the protocol associated with the group are shown on the header line. |
BSTUN address | Address or the word all if the default forwarding entry is specified, followed by a repeat of the group number given for the interface. |
Type of link | Description of link, either a serial interface using Serial Transport (IF followed by interface name), or a TCP connection to a remote router (TCP followed by IP address). |
state | State of the link: open is the normal, working state; direct indicates a direct link to another line, as specified with the direct keyword on the bstun route command. |
rx_pkts | Number of received packets. |
tx_pkts | Number of transmitted packets. |
drops | Number of packets that for whatever reason had to be dropped. |
Use the show stun privileged EXEC command to display the current status of STUN connections.
show stunThis command has no arguments or keywords.
Privileged EXEC
The following is sample output from the show stun command:
Router# show stun This peer: 131.108.10.1 Serial0 -- 3174 Controller for test lab (group 1 [sdlc]) state rx-pkts tx-pkts drops poll 7[ 1] IF Serial1 open 20334 86440 5 8P 10[ 1] TCP 131.108.8.1 open 6771 7331 0 all[ 1] TCP 131.108.8.1 open 612301 2338550 1005
In the display, the first entry reports proxy polling enabled for address 7 and that Serial 0 is running with modulus 8 on the primary side of the link. The link has received 20,334 packets, transmitted 86,440 packets, and dropped 5 packets.
Table 27-2 describes significant fields shown in the output.
Field | Description |
---|---|
This peer | Lists the peer-name or address. The interface name (as defined by the description command), its STUN group number, and the protocol associated with the group are shown on the header line. |
STUN address | Address or the word all if the default forwarding entry is specified, followed by a repeat of the group number given for the interface. |
Type of link | Description of link, either a serial interface using Serial Transport (IF followed by interface name), or a TCP connection to a remote router (TCP followed by IP address). |
state | State of the link: open is the normal, working state; direct indicates a direct link to another line, as specified with the direct keyword on the stun route command. |
rx_pkts | Number of received packets. |
tx_pkts | Number of transmitted packets. |
drops | Number of packets that for whatever reason had to be dropped. |
poll | Report of the proxy poll parameters, if any. P indicates a primary and S indicates a secondary node. The number before the letter is the modulus of the link. |
Use the stun group interface configuration command to place each STUN-enabled interface on a router in a previously defined STUN group. Use the no form of this command to remove an interface from a group.
stun group group-number
group-number | Integer in the range 1 through 255. |
Disabled
Interface configuration
Before using this command, complete the following steps: (1) Enable STUN on a global basis with the stun peer-name command (2) Define the protocol group in which you want to place this interface with the stun protocol-group command (3) Enable STUN on the interface using the encapsulation stun command.
Packets only travel between STUN-enabled interfaces that are in the same group. Once a given serial link is configured for the STUN function, it is no longer a shared multiprotocol link. All traffic that arrives on the link is transported to the corresponding peer as determined by the current STUN configuration.
The following example places serial interface 0 in STUN group 2, which is defined to run the SDLC transport:
! sample stun peer-name global command stun peer-name 131.108.254.6 ! sample protocol-group command telling group 2 to use the SDLC protocol stun protocol-group 2 sdlc ! interface serial 0 ! sample ip address subcommand no ip address ! sample encapsulation stun subcommand encapsulation stun ! place interface serial0 in previously defined STUN group 2 stun group 2 ! enter stun route command stun route 7 tcp 131.108.254.7
encapsulation stun
priority-list stun address
stun peer-name
stun protocol-group
Use the stun keepalive-count global configuration command to define the number of times to attempt a peer connection before declaring the peer connection to be down. Use the no form of this command to cancel the definition.
stun keepalive-count count
count | Number of connection attempts. The range is between 2 and 10 retries. |
No default is specified.
Global configuration
The following example sets the number of times to retry a connection to a peer to 4:
stun keepalive-count 4
Use the stun peer-name global configuration command to enable STUN for an IP address. Use the no form of this command to disable STUN for an IP address.
stun peer-name ip-address
ip-address | IP address by which this STUN peer is known to other STUN peers. |
STUN is disabled
Global configuration
Use this command to enable any further STUN features. After using this command, complete the following steps:
Step 1 Define the protocol group in which you want to place this interface with the stun protocol-group command.
Step 2 Enable STUN on the interface using the encapsulation stun command.
Step 3 Place the interface in a STUN group with the stun group command.
The following example assigns IP address 131.108.254.6 as the STUN peer:
stun peer-name 131.108.254.6
encapsulation stun
stun group
stun protocol-group
Use the stun protocol-group global configuration command to create a protocol group. Use the no form of this command to remove an interface from the group.
stun protocol-group group-number {basic | sdlc | schema} [sdlc-tg]
group-number | Integer in the range 1 through 255. |
sdlc | Indicates an SDLC protocol. |
basic | Indicates a non-SDLC protocol. |
schema | Indicates a custom protocol. |
sdlc-tg | (Optional) Identifies the group as part of an SNA transmission group. |
No protocol group established.
Global configuration
Use the sdlc keyword to specify an SDLC protocol. You must specify either the sdlc or the sdlc-tg keyword before you can enable SDLC Local Acknowledgment. SDLC Local Acknowledgment is established with the stun route address tcp command.
Use the basic keyword to specify a non-SDLC protocol, such as HDLC.
Use the schema keyword to specify a custom protocol. (The custom protocol must have been previously created with the stun schema command.
Use the optional sdlc-tg keyword (in conjunction with the sdlc keyword) to establish an SNA transmission group. A transmission group is a set of protocol groups providing parallel links to the same pair of IBM establishment controllers. This provides redundancy of paths. In case one or more links go down, an alternate path will be used. All STUN connections in a transmission group must connect to the same IP address. SDLC Local Acknowledgment must be enabled.
The following example specifies that group 7 will use the SDLC STUN protocol to route frames within that group:
stun protocol-group 7 sdlc
The following example specifies that group 5 use the basic protocol, wherein the serial addressing is unimportant and you have a point-to-point link:
stun protocol-group 5 basic
encapsulation stun
stun route address interface serial
stun route address tcp
stun schema offset length format
Use the stun quick-response global configuration command to enable STUN quick-response, which can be used with local acknowledgment. Use the no form of this command to disable STUN quick-response.
stun quick-responseThis command has no arguments or keywords.
STUN quick-response is disabled.
Global configuration
This command first appeared in Cisco IOS Release 10.3(5).
This command is used with local acknowledgment (local ack).
When STUN quick-response is enabled, the router responds to an exchange identification (XID) or a Set Normal Response Mode (SNRM) request with a Disconnect Mode (DM) response when the device is not in the CONNECT state. The request is then passed to the remote router and, if the device responds, the reply is cached. The next time the device is sent an XID or SNRM, the router replies with the cached DM response.
The following example enables STUN quick-response:
stun quick-response
You can use the master indexes or search online for documentation of related commands.
stun route address interface dlci
stun route address interface serial
stun route address tcp
stun route all interface serial
stun route all tcp
Use the stun remote-peer-keepalive global configuration command to enable detection of the loss of a peer. Use the no form of this command to disable detection.
stun remote-peer-keepalive seconds
seconds | Keepalive interval, in seconds. The range is 1 to 300 seconds. |
The default is 30 seconds
Global configuration
In the following example, the remote-peer-keepalive interval is set to 60 seconds:
stun remote-peer-keepalive 60
Use the stun route address interface dlci interface configuration command to configure direct Frame Relay encapsulation between STUN peers with SDLC local acknowledgment. Use the no form of this command to disable the configuration.
stun route address sdlc-addr interface frame-relay-port dlci number localsap local-ack cls
sdlc-addr | Address of the serial interface. |
interface frame-relay-port | Port number. |
dlci number | DLCI number. |
localsap | Local connecting SAP. |
local-ack | Enable local acknowledgment. |
cls | Use Cisco Link Services (CLS) to access frame relay network. |
The configuration is disabled.
Interface configuration
The following command enables Frame Relay encapsulation between STUN peers with SDLC local acknowledgment:
stun route address C1 interface Serial1 dlci 22 04 local-ack
stun route all interface serial
Use the stun route address interface serial interface configuration command to forward all HDLC traffic on a serial interface. Use the no form of this command to disable this method of HDLC encapsulation.
stun route address address-number interface serial number [direct]
address-number | Address of the serial interface. |
number | Number assigned to the serial interface. |
direct | (Optional) Forwards all HDLC traffic on a direct STUN link. |
The configuration is disabled
Interface configuration
In the following example, serial frames with a stun-route address of 4 are forwarded through serial interface 0 using HDLC encapsulation:
stun route address 4 interface serial 0
In the following example, serial frames with stun-route address 4 are propagated through serial interface 0 using STUN encapsulation:
stun route address 4 interface serial 0 direct
stun route all interface serial
Use the stun route address tcp interface configuration command to specify TCP encapsulation and optionally establish SDLC Local Acknowledgment (SDLC Transport) for STUN. Use the no form of this command to disable this method of TCP encapsulation.
stun route address address-number tcp ip-address [local-ack] [priority] [tcp-queue-max]
address-number | Number that conforms to TCP addressing conventions. |
tcp | Specifies TCP encapsulation. |
ip-address | IP address by which this STUN peer is known to other STUN peers that are using the TCP as the STUN encapsulation. |
local-ack | (Optional) Enables Local Acknowledgment for STUN. |
priority | (Optional) Establishes the four levels used in priority queuing: low, medium, normal, and high. |
tcp-queue-max | (Optional) Sets the maximum size of the outbound TCP queue for the SDLC link. |
TCP encapsulation is not established.
TCP queue size default is 100.
Interface configuration
SDLC Transport participates in SDLC windowing and retransmission through support of Local Acknowledgment. SDLC sessions require that end nodes send acknowledgments for a set amount of data frames received before allowing further data to be transmitted. Local Acknowledgment provides local termination of the SDLC session, so that control frames no longer travel the WAN backbone networks. This means end nodes do not time out, and a loss of sessions does not occur.
In the following example, a frame with a source-route address of 10 is propagated using TCP encapsulation to a device with an IP address of 131.108.8.1:
stun route address 10 tcp 131.108.8.1
A dagger () indicates that the command is documented in another chapter.
sdlc address ff ack-mode
stun route all tcp
Use the stun route all interface serial interface configuration command to encapsulate and forward all STUN traffic using HDLC encapsulation on a serial interface.
stun route all interface serial number [direct]
number | Number assigned to the serial interface. |
direct | (Optional) Indicates that the specified interface is also a direct STUN link, rather than a serial connection to another peer. |
No default is specified.
Interface configuration
An appropriately configured router must exist on the other end of the designated serial line. The outgoing serial link still can be used for other kinds of traffic (the frame is not TCP encapsulated). This mode is used when TCP/IP encapsulation is not needed or when higher performance is required. Enter the serial line number connected to the router for the interface-number argument.
In the following example, all traffic on serial interface 0 is propagated using STUN encapsulation:
! propagate serial frames through serial 0 using STUN encapsulation stun route all interface serial 0
In the following example, serial interface 1 is a direct STUN link, not a serial connection to another peer:
stun route all interface serial 1 direct
stun route address interface serial
Use the stun route all tcp interface configuration command with TCP encapsulation to forward all STUN traffic on an interface regardless of what address is contained in the serial frame.
stun route all tcp ip-address
ip-address | IP address by which this remote STUN peer is known to other STUN peers. Use the address that identifies the remote STUN peer that is connected to the far serial link. |
Disabled
Interface configuration
TCP/IP encapsulation allows movement of serial frames across arbitrary media types and topologies. This is particularly useful for building shared, multiprotocol enterprise network backbones.
In the following example, all STUN traffic received will be propagated through the bridge:
stun route all tcp 131.108.10.1
Use the stun schema offset length format global configuration command to define a protocol other than SDLC for use with STUN. Use the no form of this command to disable the new protocol.
stun schema name offset constant-offset length address-length format format-keyword
name | Name that defines your protocol. It can be up to 20 characters in length. |
constant-offset | Constant offset, in bytes, for the address to be found in the frame. |
address-length | Length in one of the following formats: decimal (4 bytes), hexadecimal (8 bytes) or octal (4 bytes). |
format-keyword | Format to be used to specify and display addresses for routes on interfaces that use this STUN protocol. The allowable format keywords are decimal (0 through 9), hexadecimal (0 through F), and octal (0 through 7). |
No protocol is defined.
Global configuration
Use this command before defining the protocol group (stun protocol-group command). The serial protocol you define must meet the following criteria:
In the following example, a protocol named new-sdlc is created. In the protocol frame structure, the constant offset is 0, the address length is 1 byte, and the address format is hexadecimal:
stun schema new-sdlc offset 0 length 1 format hexadecimal
A dagger () indicates that the command is documented in another chapter.
priority-list stun
stun protocol-group
Use the stun sdlc-role primary interface configuration command to assign the router the role of SDLC primary node. Primary nodes poll secondary nodes in a predetermined order.
stun sdlc-role primaryThis command has no arguments or keywords.
No role is assigned.
Interface configuration
If the router is connected to a cluster controller, for example a 3x74, the router should appear as a front-end processor (FEP) such as a 37x5, and must be assigned the role of a primary node.
The following example assigns the router the role of SDLC primary node:
stun sdlc-role primary
encapsulation stun
stun sdlc-role secondary
Use the stun sdlc-role secondary interface configuration command to assign the router the role of SDLC secondary node. Secondary nodes respond to polls sent by the SDLC primary by transmitting any outgoing data they may have.
stun sdlc-role secondaryThis command has no arguments or keywords.
No secondary role is assigned.
Interface configuration
If the router is connected to a front-end processor (FEP), for example a 37x5, the router should appear as a cluster controller such as a 3x74, and must be assigned the role of a secondary node.
The following example assigns the router the role of SDLC secondary node:
stun sdlc-role secondary
encapsulation stun
stun sdlc-role primary
![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() |