Lantronix LSB4 User manual

The information in this guide may change without notice. The manufacturer assumes no
responsibility for any errors which may appear in this guide.
DEC, thickwire, thinwire, VMS, VT100, and ULTRIX are trademarks of Digital Equipment
Corporation. UNIX is a registered trademark of AT&T. Ethernet is a trademark of XEROX.
NetWare is a trademark of Novell Corp. AppleTalk, Chooser and Macintosh are trademarks of
Apple Computer Corp.
Copyright 1994, Lantronix. All rights reserved. No part of the contents of this book may be
transmitted or reproduced in any form or by any means without the written permission of
Lantronix. Printed in the United States of America.
The revision date for this manual is August 15, 1994.
Part Number: 900-041
WARNING
This equipment has been tested and found to comply with the limits for a Class A digital
device pursuant to Part 15 of FCC Rules. These limits are designed to provide reasonable pro-
tection against such interference when operating in a commercial environment. This equip-
ment generates, uses, and can radiate radio frequency energy, and if not installed and used in
accordance with this guide, may cause harmful interference to radio communications.
Operation of this equipment in a residential area is likely to cause interference in which case
the user, at his or her own expense, will be required to take whatever measures may be
required to correct the interference.
Warning: Changes or modiÞcations to this device not explicitly approved by Lantronix will
void the user's authority to operate this device.
Cet appareil doit se soumettre avec la section 15 des statuts et r•glements de FCC. Le fonction-
nement est subjectŽ aux conditions suivantes:
(1) Cet appareil ne doit pas causer une interfŽrence malfaisante.
(2) Cet appareil do”t accepter n'importŽ quelle interfŽrence re“ue qui peut causer une
opŽration indŽsirable.

LSB4 Reference Manual
For Lantronix LSB4 Ethernet Switch

i
Contents
1
Introduction
About This Manual ...................................................................................................1-1
Manual Conventions ................................................................................................1-2
2
System Commands
Introduction ...............................................................................................................2-1
Set/Define System ....................................................................................................2-2
Show/Monitor/List System ....................................................................................2-4
Set Privileged .............................................................................................................2-5
3
Protocol Commands
Introduction ...............................................................................................................3-1
Set/Define Protocol ..................................................................................................3-2
Show/List Protocol ...................................................................................................3-4
4
Port Commands
Introduction ...............................................................................................................4-1
Set/Define Port .........................................................................................................4-2
Show/Monitor/List Port .........................................................................................4-4
5
SNMP Commands
Introduction ...............................................................................................................5-1
Set/Define SNMP .....................................................................................................5-2
Show/List SNMP ......................................................................................................5-3

ii
6
Filter Commands
Introduction ...............................................................................................................6-1
Configuring a Filter List ...........................................................................................6-2
Set/Define Filter .......................................................................................................6-4
Show/List Filter ......................................................................................................6-11
Clear/Purge Filter ..................................................................................................6-12
7
Switch Commands
Introduction ...............................................................................................................7-1
Set/Define Switch .....................................................................................................7-2
Show/Monitor/List Switch ....................................................................................7-5
8
Save Command
Introduction ...............................................................................................................8-1
Save .............................................................................................................................8-2
9
Miscellaneous Commands
Introduction ...............................................................................................................9-1
Cls ................................................................................................................................9-2
Finger ..........................................................................................................................9-2
Help ............................................................................................................................9-2
Initialize ......................................................................................................................9-3
Lock .............................................................................................................................9-4
Logout .........................................................................................................................9-5
Netstat ........................................................................................................................9-5
Ping .............................................................................................................................9-5
Show Users ................................................................................................................9-6
Unlock .........................................................................................................................9-6
Zero Counters ............................................................................................................9-7
Technical Support
Glossary
Index

1
Introduction
About This Manual .................................................................................................................1-1
Manual Conventions ..............................................................................................................1-2
Required Parameters ............................................................................................ 1-2
Optional Parameters .............................................................................................1-2
User Defined Parameters .....................................................................................1-2
Restrictions .............................................................................................................1-2

LSB4 Reference Manual Introduction
1-1
About This Manual
This manual lists all commands that can be used in conjunction with the
LSB4. These commands can be used to configure the switch to specific needs,
such as limiting access to the switch or setting a particular data transfer rate.
All parameters to be used with a command are listed, as well as the correct
syntax for the command. For instructions on the various methods used to ex-
ecute commands, see Chapter 3 of the LSB4 Installation Guide,
Set-Up and
Operation
.
This manual covers the following topics:
♦
Manual conventions
♦
System commands: Set/Define System, Show/
Monitor/List System, Set
Privileged
♦
Protocol commands: Set/Define Protocol, Show/List
Protocol
♦
Port commands: Set/Define Port, Show/Monitor/
List Port
♦
SNMP commands: Set/Define SNMP, Show/List
SNMP
♦
Filter commands: Set/Define Filter, Show/List
Filter, Clear/Purge Filter
♦
Switch commands: Set/Define Switch, Show/
Monitor/List Switch
♦
Miscellaneous commands: Cls, Finger, Help, Initialize, Lock,
Logout, Netstat, Ping, Show
Users, Unlock, Zero Counters
1chapternumber
Where
Show /
Monitor /List
Switch
and
Set/
Define Switch
commands are used,
ÒBridgeÓ can be
used in place of
ÒSwitch.Ó For ex-
ample,
List Bridge
has the same func-
tionality as
List
Switch
.

Introduction LSB4 Reference Manual
1-2
Manual Conventions
All command names are displayed in all capital letters. Manual conventions
for command parameters are discussed in the following paragraphs.
Required Parameters
♦
Requiredparametersareparametersthatmust
beusedwithapar-
ticular command.
♦
Required parameters appear in all capital letters and within brac-
es ( {} ).
♦
When there is a choice of two or more required parameters to be
used with a command, all available options will be displayed
within braces. For example, if either
Enabled
or
Disabled
must
be used with a command, the parameters will be displayed as
follows:
Optional Parameters
♦
Optional parameters are parameters that may be omitted or in-
cluded in a command.
♦
Optional parameters appear in all capital letters and within brack-
ets ( [] ).
♦
When there is a choice of two or more optional parameters that
may be used with a command, all available options will be dis-
played within brackets. For example, if either
Characteristics
or
Counters
may be used with a command, the parameters will be
displayed as follows:
User Defined Parameters
♦
These parameters are displayed in
italics
. The name of the param-
eter represents the type of information to enter, for example,
ipaddress
.
Restrictions
♦
Any restrictions on the use of a command or its parameters will
be covered in this section.
ENABLED
DISABLED



CHARACTERISTICS
COUNTERS
To determine the
syntax of a particu-
lar command, con-
sult the section
covering that com-
mand.
Parameters may be
abbreviated when
entering a com-
mand, however, an
abbreviation must
be unique to the de-
sired command. For
example,
Show
could not be abbre-
viated to S, as that S
could also denote
Set
.

2
System Commands
Introduction .............................................................................................................................2-1
Set/Define System .................................................................................................................. 2-2
Show/Monitor/List System .................................................................................................. 2-4
Set Privileged ...........................................................................................................................2-5

LSB4 Reference Manual System Commands
2-1
Introduction
System commands are used to configure and display the LSB4Õs
non-switch
functions, such as incoming logins, password protection, and the host from
which software will be downloaded.
Some of the system commands require the user to have privileged status. To
learn how to obtain privileged status, see page 2-5.
Set/Define and Show/Monitor/List Commands
Set/Define and Show/Monitor/List commands appear frequently in this man-
ual. It is important to note the difference between these commands.
Set
makes
an immediate change, but is not permanent. (Changes made with the Set com-
mand can be made permanent using the Save command.) Conversely,
Define
makes a permanent change, but it doesn't take effect until the LSB4 is rebooted.
The Show and List commands function in a similar manner to the Set/Define
commands.
Show
displays the current settings (including those Set but not
saved as permanent changes).
Monitor
displays the same current information as
Show but is updated every three seconds. The
List
command displays perma-
nent settings.
Set/Define System
Set System
and Define System
accept the following parameters:
♦
Incoming: SpeciÞes login restrictions
♦
Name: Assigns a name to the LSB4
♦
Login Password: Changes the password required to login
to the LSB4
♦
Privileged Password: Changes the password required for
particular commands
♦
Prompt: Sets a custom prompt string
♦
Software: SpeciÞes the name of a Þle to be down-
loaded to the LSB4
Show/Monitor/List System
Show System, Monitor System, and List System commands display LSB4 status
and configuration.
Set Privileged
This command enables privileged status, permitting a user to enter an additional
set of commands.
2chapternumber
Define Port
will
take effect as soon as
the port is logged
out.

System Commands LSB4 Reference Manual
2-2
Set/Define System
Parameters Incoming
Telnet
Enables incoming Telnet connections.
None
Disables incoming Telnet connections.
Password
Establishes a password requirement for logging into the LSB4.
Nopassword
Removes the password requirement for logging into the
LSB4.
Login Password
Establishes or changes the password required to log into the
LSB4.
CurrentPswd
Any combination of six digits or letters.
Name
Changes the LSB4Õs name. This name is used to connect to the
LSB4 from remote hosts.
systemname
Any combination of up to sixteen characters. When the LSB4
is shipped, the system name is in the form LSB4_xxxxxx. The
six xÕs represent the last six hexadecimal digits of the ethernet
address.
Privileged Password
Establishes or changes the password required to use privi-
leged commands.
SET
DEFINE



SYSTEM
INCOMING
TELNET
NONE
PASSWORD
NOPASSWORD







LOGIN PASSWORD[]
CurrentPswd []
NAME
systemname
PRIVILEGED PASSWORD[] CurrPrivPswd
PROMPT promptstring
REFRESH onds sec
SOFTWARE
filename



















Incoming has no
effect on the serial
console port.
The default
CurrentPswd is
access.
If the specified
Name contains
lower-case letters, it
must be enclosed in
quotation marks
(Ò Ò) and may not
include any spaces.

LSB4 Reference Manual System Commands
2-3
Set/Define System (cont.)
Parameters CurrentPrivPswd
Any combination of six digits or letters.
Prompt
Selects a custom command prompt.
promptstring
Any combination of up to sixteen printable ASCII characters.
The following special character combinations may be used in
the promptstring: %p, %n, %s, %D, %C, %P, and %%.
%p includes the name of the port currently logged into.
%n includes the number of the port currently logged
into.
%s includes the current name of the LSB4.
%D includes the LSB4 description characters.
%C includes the letters Lantronix.
%P includes a Ògreater-thanÓ symbol ( > ) whenever a
Set Privilege command has been entered.
%% includes a percent ( % ) symbol.
Refresh
Specifies how often information displayed by a Monitor com-
mand is updated.
seconds
A value from 2 to 60.
Software
Specifies the name and path to the file to be downloaded to
the LSB4 at boot time.
filename
Any combination of up to forty-six characters. The file name
may contain up to fifteen characters and the path may be up
to thirty-one characters.
Restrictions This command requires privileged status.
Examples Local> SET SYSTEM INCOMING TELNET
Local> SET SYSTEM NAME “Lab_Switch”
Local> DEFINE SYSTEM SOFTWARE “/tftpboot/LSB.SYS”
Local> SET SYSTEM PASSWORD
Password> hobbes (not echoed)
Verification> hobbes (not echoed)
See Also Set Privileged, page 2-5.
The default prompt
is Local>.
If lower-case letters
are used, the
promptstring must
be enclosed in quo-
tation marks.
The default value of
seconds is 3.
If lower-case letters
are used, the file-
name must be en-
closed in quotation
marks.

System Commands LSB4 Reference Manual
2-4
Show/Monitor/List System
Parameters Bootparams
Displays reloading information including the file name and
path as specified by the Set/Define System Software com-
mand, and the load host name specified by the Set/Define
Protocol commands.
Characteristics
Displays network settings, system flags, and any login restric-
tions.
Counters
Displays a current count of traffic being directed to the LSB4.
The counters represent traffic to the switch (telnet sessions
traffic to the switch, ping traffic to the switch, etc.), not traffic
that is being forwarded.
The counters are reset every time the LSB4 is turned on, re-
booted, re-initialized, or a Zero Counters System command is
entered.
Status
Displays available memory and login events.
SHOW
MONITOR



SYSTEM
BOOTPARAMS
CHARACTERISTICS
COUNTERS
STATUS







LIST SYSTEM BOOTPARAMS
CHARACTERISTICS




LSB4 Reference Manual System Commands
2-5
Set Privileged
Parameters Privileged
When entered, the user is prompted to enter the current priv-
ileged password as specified by a Set or Define System Privi-
leged command.
When the privileged password is accepted, supervisor status
is given. This status will remain in effect until the user logs out
of the LSB4, a Set Privileged Override command is entered, or
a Set Noprivileged command is entered.
Override
Permits user to obtain supervisor status when another user is
currently logged into the LSB4 with supervisor status. When
this command is entered, supervisor status is given and the
other user's supervisor status is immediately disabled.
Noprivileged
Immediately disables supervisor status.
SET PRIVILEGED OVERRIDE[]
NOPRIVILEGED




System Commands LSB4 Reference Manual
2-6

3Protocol Commands
Introduction .............................................................................................................................3-1
Set/Define Protocol ................................................................................................................ 3-2
Show/List Protocol .................................................................................................................3-4

LSB4 Reference Manual Protocol Commands
3-1
Introduction
Protocol commands are used to specify, configure and display the LSB4Õs proto-
col settings. Protocol settings are for setting values for incoming logins and for
downloading software.
Set/Define Protocol
Set Protocol and Define Protocol accept the following parameters [Table 3-1]:
Table 3-1: Set/Define Protocol Parameters
Show/List Protocol
Show Protocol and List Protocol display the status of the LSB4Õs protocol set-
tings.
Protocol Parameter Function
AppleTalk Zone IdentiÞes an AppleTalk zone for the LSB4
IP IPaddress SpeciÞes an IP address for the LSB4
Loadhost SpeciÞes a host from which to download
software to the LSB4
Subnet Mask Assigns a subnet mask
Netware Loadhost SpeciÞes a host from which to download
software to the LSB4
3chapternumber
For an explanation
of the Set and
Define commands,
see page 2-1.
For an explanation
of the Show and
List commands, see
page 2-1.

Protocol Commands LSB4 Reference Manual
3-2
Set/Define Protocol
When the LSB4 is booted up, the AppleTalk, IP, and Netware protocols (dis-
cussed below) are enabled. To improve performance, disable any protocols that
are not being used.
Parameters AppleTalk Zone
Specifies an AppleTalk zone in which the LSB4 will reside.
zonename
Any combination of characters, or an IP address. If the speci-
fied name contains lower case letters, it must be enclosed in
quotation marks.
An IP address must be in the following form:
nnn.nnn.nnn.nnn
where nnn is a decimal number between 0 and 255.
IP IPaddress
Specifies the LSB4Õs IP address.
address
An IP address in the following form:
nnn.nnn.nnn.nnn
where nnn is a decimal number between 0 and 255.
SET
DEFINE



PROTOCOL
APPLETALK ZONE zonename
ENABLED
DISABLED





IP
ENABLED
DISABLED
IPADDRESS address
LOADHOST name
SECONDARY LOADHOST address{}
SUBNETMASK address











NETWARE LOADHOST servername
ENABLED
DISABLED






























A protocol cannot
be ÒsetÓ to enabled
or disabled; it must
be defined using the
Define command.
A Set/Define
Protocol IP
Nameserver com-
mand must be given
before a text name
can be specified.

LSB4 Reference Manual Protocol Commands
3-3
Set/Define Protocol (cont.)
Parameters IP Loadhost
Specifies the name of a TFTP host to be used to download soft-
ware to the LSB4.
name
Any combination of characters, or an IP address. If the speci-
fied name contains lower case letters, it must be enclosed in
quotation marks.
An IP address must be in the following form:
nnn.nnn.nnn.nnn
where nnn is a decimal number between 0 and 255.
Secondary Loadhost
Specifies the IP address of a backup loadhost. This loadhost
will be used if the primary host cannot be reached.
address
An IP address in the following form:
nnn.nnn.nnn.nnn
where nnn is a decimal number between 0 and 255. The peri-
ods must be included.
IP Subnet Mask
Specifies the IP address of a subnet mask. A subnet mask is
automatically assigned when Set/Define Protocol IP IPAd-
dress is used to specify an IP address. This parameter is used
to override the assigned subnet mask.
address
An IP address in the following form:
nnn.nnn.nnn.nnn
where nnn is a decimal number between 0 and 255.
Netware Loadhost
Specifies the name of a Netware file server to be used to
download software to the LSB4.
servername
Any combination of characters. If the specified name contains
lower case letters, it must be enclosed in quotation marks.

Protocol Commands LSB4 Reference Manual
3-4
Set/Define Protocol (cont.)
Restrictions This command requires privileged status.
Examples Local> SET PROTOCOL IP LOADHOST “elmer.cid.ins.com”
Local> SET PROTOCOL APPLETALK ZONE “Lab_Zone”
Local> SET PROTOCOL NETWARE LOADHOST “Acct_Fserv”
See Also Set Privileged, page 2-5.
Show/List Protocol
Parameters AppleTalk/IP/Netware
Displays the current AppleTalk, IP, or Netware configuration.
SHOW
LIST



PROTOCOL APPLETALK
IP
NETWARE






4Port Commands
Introduction .............................................................................................................................4-1
Set/Define Port ........................................................................................................................4-2
Show/Monitor/List Port ....................................................................................................... 4-4