PortMaster Command Line Reference

[Top] [Table Of Contents] [Prev] [Next] [Index]

This chapter describes how to use the command line interface to configure synchronous ports. Detailed command definitions follow a command summary table.

The command line interface can configure a PortMaster synchronous serial port for use with a leased line, Frame Relay, ISDN or Switched 56Kbps connection.

Examples in this chapter are from a PortMaster 2R, where the synchronous port is labeled W1. In contrast, the synchronous ports on PortMaster IRX Routers are labeled S1 through S4.

Note ¯ After making any configuration changes to a synchronous port, you must use the rest W1 command for the changes to take effect.

Displaying Synchronous Port Information

To display information about your configuration, use the following commands:

show W1
show all-see page 2-21
ifconfig-see page 2-9
show sessions-see page 2-38
show netstat-see page 2-33
show arp-see page 2-23
For general information about command line interface commands, refer to Chapter 1, "Introduction."

Summary of Synchronous Port Commands

The synchronous port commands in Table 6-1 configure synchronous serial ports. Commands marked with a leading bullet (·) can be used only for network hardwired ports.

	Command Syntax
·	add dlci\|ipdlci\|ipxdlci W1 Dlci [Ipaddress\|Ipxnode]	- see page 6-8
·	delete dlci\|ipdlci\|ipxdlci W1 Dlci	- see page 6-8
	reset W1	- see page 2-15
	save ports	- see page 2-18
	save W1	- see page 2-18
·	set W1 address Ipaddress	- see page 6-3
·	set W1 annex-d Seconds	- see page 6-4
	set W1 cd on\|off	- see page 6-5
	set W1 compression on\|off\|stack\|vj	- see page 6-6
·	set W1 destination Ipaddress [Ipmask]	- see page 6-7
·	set W1 dlcilist Dlci_list	- see page 6-8
	set W1 extended on\|off	- see page 6-10
	set W1 group Group	- see page 6-10
	set W1 hangup on\|off	- see page 6-11
	set W1 idletime Number [minutes\|seconds]	- see page 6-12
·	set W1 ifilter [Filtername]	- see page 6-13
·	set W1 ipxnet Ipxnetwork	- see page 6-14
·	set W1 lmi [Seconds]	- see page 6-15
·	set W1 mtu MTU	- see page 6-16
·	set W1 netmask Ipmask	- see page 6-17
	set W1 network dialin\|dialout\|twoway\|hardwired	- see page 6-18
·	set W1 ofilter [Filtername]	- see page 6-19
	set W1 ospf on\|off	- see page 11-9
·	set W1 protocol slip\|ppp\|frame\|x75-sync	- see page 6-20
·	set W1 rip on\|off\|broadcast\|listen	- see page 10-19
	set W1 route-filter incoming\|outgoing Filtername	- see page 10-8
	set W1 speed 9600\|14400\|19200\|38400\|57600\|76800\|115200\| 56000\|64000\|1344k\|1536k\|2048k\|t1\|t1e\|e1	- see page 6-21
	show all	- see page 2-21
	show W1	- see page 6-22

on	Monitors presence of the DCD signal.
off	Does not monitor presence of the DCD. This is the default.

on	Enables compression. The PortMaster tries to negotiate both Van Jacobson and Stac LZS compression on PortMaster 3 and Office Router products, or Van Jacobson compression only on other PortMaster products. This is the default.
off	Disables compression.
stac	Enables Stac LZS data compression only. Stac LZS compression is supported only on PortMaster 3 and Office Router products.
vj	Enables Van Jacobson TCP/IP header compression only.

Ipaddress	IP address or 39-character hostname of the remote router in dotted decimal notation.
Ipmask	IP mask in dotted decimal notation.

Dlci_list	Space-separated list of DLCIs. Up to a maximum of 244 characters.
ipdlci or dlci	Use for IP connections.
ipxdlci	Use for IPX connections.
Dlci	DLCI number, from 1 to 1023. You can add or delete only one DLCI number at a time.
Ipaddress	Optional IP address of the router attached to the permanent virtual circuit (PVC) represented by the DLCI.
Ipxnode	IPX node address of the PortMaster attached to the permanent virtual circuit (PVC) represented by the DLCI. This value is the PortMaster MAC address-a 48-bit number.

on	Turns extended mode on.
off	Turns extended mode off. This is the default.

on	DTR is dropped after the session terminates. This is the default.
off	DTR is not dropped after the session terminates.

Number	Idle time value in minutes or seconds, as specified. Any value from 0 to 240. The default value is 0.
minutes	Sets the idle time in minutes. This is the default.
seconds	Sets the idle time in seconds.

dialin	The port accepts dial-in network connections. The remote system is required to authenticate using PAP or CHAP. Dial-in network connections are controlled by the user table or the RADIUS server. A remote host can connect to the port. This setting is used for ISDN or switched 56Kbps connections.
dialout	The port is available for dialing to remote destinations and initiating network connections to those destinations. Dial-out network connections are controlled by the location table. The port is available for dial-out use by the location table using V.25bis dialing. This setting is used for ISDN or switched 56Kbps connections.
twoway	The port accepts dial-in network connections, as well as being available for dial-out to remote destinations.
hardwired	This setting is for ports being used in a dedicated network connection between two sites. No modem dialing or authentication is required. The port immediately begins running the specified protocol. The port is connected to a synchronous leased line or Frame Relay using a V.35 or suitable RS-232 cable. Refer to the appropriate hardware configuration guide for more information. You must also set the remote destination address with set W1 destination.

slip	SLIP protocol.
ppp	PPP. Used for leased lines, ISDN, and switched 56Kbps connections.
frame	Frame Relay.
x75-sync	X.75 Protocol.

9600\|14400, and so on	Indicates DTE rate in bits per second.
t1, t1e, e1	Reference for T1, extended superframe T1, or E1 line types.

Command> show w1
----------------------- Current Status - Port W1 ----------------------
Status:	ESTABLISHED
Input:	507781	Abort Errors:	56/1
Output:	882686	CRC Errors:	27
Pending:	0	Overrun Errors:	0
TX Errors:	0	Frame Errors:	0
Modem Status:	DCD+ CTS+

Active Configuration		Default Configuration
-----------------------------		-----------------------------
Port Type:	Netwrk	Netwrk (Hardwired)
Line Speed:	Ext 1536K	Ext Clock
Modem Control:	off	off
Remote Host:	172.16.0.37	255.255.255.255
Netmask:	255.255.255.0	255.255.255.0
Interface:	ptpW1 (PPP, Routing)	(PPP, Routing)
Mtu:	1500	0
Dial Group:	0

Status	State of the port. Refer to the information on port status in Table 2-2, on page 2-22.
Input/Output/ Pending	Number of bytes input, output, or pending since last reboot.
TX Errors	Number of transmission errors since last reboot.
Abort Errors	Number of abnormal termination errors occurring since last reboot. A slash (/) in this field indicates two separate error counts-framing errors/device errors: Framing errors-This count increments when the receiver chip reports either a framing error or an abnormal termination. Device errors-This count increments when the frame size is 0 (zero) or greater than the maximum size of a PPP frame, or when frames overlap each other.
CRC Errors	Number of cyclic redundancy check (CRC) errors occurring since last reboot.
Overrun Errors	Number of overrun errors occurring since last reboot.
Frame Errors	Number of frame errors occurring since last reboot. A slash (/) in this field indicates two separate error counts-short frame errors/large frame errors: Short frame errors-This count increments when a short frame is received. Large frame errors-This count increments when a packet is too large and must be dropped.
Modem Status	The plus signs (+) on DCD and CTS indicate that the DCD and CTS signals on the port are asserted (high). For modem status information for ISDN lines, refer to the ISDN connection chapter in the PortMaster Configuration Guide.
Active Configuration	The configuration currently active on the port.
Default Configuration	The configured port parameters, including available alternatives.
Port Type	The port type-login, device, or network. (Security) indicates that security has been set for the port. See page 5-42.
Line Speed	Ext. indicates external line speed in kilobits per second.
Modem Control	Modem carrier detect signal setting.
Remote Host	IP address of remote host. If the destination address is set to 255.255.255.255 for PPP connections, the PortMaster attempts to learn the remote IP address.
Netmask	The netmask of the local network.
Interface	The interface specification used by the port.
Mtu	The maximum transmission unit (MTU) set for the port.
Dial Group	The dial group number allocated to the port.