D-Link DES-3326S - Switch - Stackable Command Line Interface Reference Manual
Text of the manual
D-Link DES-3326S Layer 3 Switch CLI Reference
Trademarks
Copyright 2005 D-Link Corporation.
Contents subject to change without prior notice.
D-Link is a registered trademark of D-Link Corporation/D-Link Systems, Inc. All other trademarks belong to their respective
proprietors.
Copyright Statement
No part of this publication may be reproduced in any form or by any means or used to make any derivative such as
translation, transformation, or adaptation without permission from D-Link Corporation/D-Link Systems Inc., as stipulated by
the United States Copyright Act of 1976.
FCC Warning
This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant to Part
15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference
when the equipment is operated in a commercial environment. This equipment generates, uses, and can radiate
radio frequency energy and, if not installed and used in accordance with this Manual, may cause harmful
interference to radio communications. Operation of this equipment in a residential area is likely to cause
harmful interference in which case the user will be required to correct the interference at his own expense.
CE Mark Warning
This is a Class A product. In a domestic environment, this product may cause radio interference in which case
the user may be required to take adequate measures.
VCCI Warning
Table of Contents
Introduction............................................................................................................................................................. 1
Using the Console CLI............................................................................................................................................ 4
Command Syntax.................................................................................................................................................... 8
Basic Switch Commands ...................................................................................................................................... 12
Switch Port Commands......................................................................................................................................... 32
Port Security Commands ...................................................................................................................................... 35
Network Management Commands........................................................................................................................ 40
MAC Notification Commands.............................................................................................................................. 66
Download/Upload Commands.............................................................................................................................. 71
Network Monitoring Commands .......................................................................................................................... 74
Spanning Tree Commands.................................................................................................................................... 93
Forwarding Database Commands ....................................................................................................................... 101
Broadcast Storm Control Commands.................................................................................................................. 110
QOS Commands ................................................................................................................................................. 113
Port Mirroring Commands.................................................................................................................................. 125
VLAN Commands .............................................................................................................................................. 131
Link Aggregation Commands............................................................................................................................. 140
Basic IP Commands............................................................................................................................................ 148
IGMP Snooping Commands............................................................................................................................... 151
802.1X Commands ............................................................................................................................................. 160
Access Control List and CPU Interface Filtering Commands ............................................................................ 176
Traffic Segmentation Commands ....................................................................................................................... 198
Stacking Commands ........................................................................................................................................... 201
Time and SNTP Commands ............................................................................................................................... 205
ARP Commands.................................................................................................................................................. 214
Routing Table Commands .................................................................................................................................. 220
Route Redistribution Commands........................................................................................................................ 224
IGMP Commands ............................................................................................................................................... 231
Bootp Relay Commands ..................................................................................................................................... 235
DNS Relay Commands....................................................................................................................................... 242
RIP Commands ................................................................................................................................................... 250
DVMRP Commands ........................................................................................................................................... 255
PIM Commands .................................................................................................................................................. 262
IP Multicasting Commands................................................................................................................................. 268
MD5 Configuration Commands.......................................................................................................................... 271
OSPF Configuration Commands ........................................................................................................................ 276
Command History List........................................................................................................................................ 305
Technical Specifications ..................................................................................................................................... 310
Glossary .............................................................................................................................................................. 312
D-Link DES-3326S Layer 3 Switch CLI Reference
1
INTRODUCTION
The Switch can be managed through the Switch’s serial port, Telnet, or the Web-based management agent. The
Command Line Interface (CLI) can be used to configure and manage the Switch via the serial port or Telnet
interfaces.
This manual provides a reference for all of the commands contained in the CLI. Configuration and management
of the Switch via the Web-based management agent is discussed in the User’s Guide.
Accessing the Switch via the Serial Port
The Switch’s serial port’s default settings are as follows:
•
9600 baud
•
no parity
•
8 data bits
•
1 stop bit
A computer running a terminal emulation program capable of emulating a VT-100 terminal and a serial port
configured as above is then connected to the Switch’s serial port via an RS-232 DB-9 cable.
With the serial port properly connected to a management computer, the following screen should be visible. If
this screen does not appear, try pressing Ctrl+r to refresh the console screen.
Figure 1-1. Initial Console screen
There is no initial username or password. Just press the Enter key twice to display the CLI input cursor − DES-
3326S:4#. This is the command line where all commands are input.
1
D-Link DES-3326S Layer 3 Switch CLI Reference
Setting the Switch’s IP Address
Each Switch must be assigned its own IP Address, which is used for communication with an SNMP network
manager or other TCP/IP application (for example BOOTP, TFTP). The Switch’s default IP address is
10.90.90.90. You can change the default Switch IP address to meet the specification of your networking address
scheme.
The Switch is also assigned a unique MAC address by the factory. This MAC address cannot be changed, and
can be found from the initial boot console screen – shown below.
Figure 1-2. Boot Screen
The Switch’s MAC address can also be found from the Web management program on the Switch Information
(Basic Settings) window on the Configuration menu.
The IP address for the Switch must be set before it can be managed with the Web-based manager. The Switch IP
address can be automatically set using BOOTP or DHCP protocols, in which case the actual address assigned to
the Switch must be known.
The IP address may be set using the Command Line Interface (CLI) over the console serial port as follows:
Starting
at
the
command
line
prompt,
enter
the
commands
config
ipif
System
ipaddress
xxx.xxx.xxx.xxx|yyy.yyy.yyy.yyy. Where the x’s represent the IP address to be assigned to the IP interface
named System and the y’s represent the corresponding subnet mask.
Alternatively, you can enter config ipif System ipaddress xxx.xxx.xxx.xxx|z. Where the x’s represent the IP
address to be assigned to the IP interface named System and the z represents the corresponding number of
subnets in CIDR notation.
The IP interface named System on the Switch can be assigned an IP address and subnet mask which can then be
used to connect a management station to the Switch’s Telnet or Web-based management agent.
2
D-Link DES-3326S Layer 3 Switch CLI Reference
Figure 1-3. Assigning the Switch an IP Address
In the above example, the Switch was assigned an IP address of 10.41.44.33 with a subnet mask of 255.0.0.0.
The system message Success indicates that the command was executed successfully. The Switch can now be
configured and managed via Telnet and the CLI or via the Web-based management agent using the above IP
address to connect to the Switch.
Note: Some nonalphanumeric characters may cause the Switch to reboot
if entered using the CLI interface. Be careful to use only alphanumeric
characters when entering commands.
3
D-Link DES-3326S Layer 3 Switch CLI Reference
2
USING THE CONSOLE CLI
The DES-3326S supports a console management interface that allows the user to connect to the Switch’s
management agent via a serial port and a terminal or a computer running a terminal emulation program. The
console can also be used over the network using the TCP/IP Telnet protocol. The console program can be used
to configure the Switch to use an SNMP-based network management software over the network.
This chapter describes how to use the console interface to access the Switch, change its settings, and monitor its
operation.
Note: Switch configuration settings are saved to non-volatile RAM using the save
command. The current configuration will then be retained in the Switch’s NV-RAM,
and reloaded when the Switch is rebooted. If the Switch is rebooted without using the
save command, the last configuration saved to NV-RAM will be loaded.
Connecting to the Switch
The console interface is used by connecting the Switch to a VT100-compatible terminal or a computer running
an ordinary terminal emulator program (e.g., the HyperTerminal program included with the Windows
operating system) using an RS-232C serial cable.
Your terminal parameters will need to be set to:
•
VT-100 compatible
•
9,600 baud
•
8 data bits
•
No parity
•
One stop bit
•
No flow control
You can also access the same functions over a Telnet interface. Once you have set an IP address for your
Switch, you can use a Telnet program (in VT-100 compatible terminal mode) to access and control the Switch.
All of the screens are identical, whether accessed from the console port or from a Telnet interface.
4
D-Link DES-3326S Layer 3 Switch CLI Reference
After the Switch reboots and you have logged in, the console looks like this:
Figure 2-1. Initial Console Screen
Commands are entered at the command prompt, DES-3326S:4#.
There are a number of helpful features included in the CLI. Entering the ? command will display a list of all of
the top-level commands.
Figure 2-2. The ? Command
The dir command has the same function as the ? command.
When you enter a command without its required parameters, the CLI will prompt you with a Next possible
completions: message.
5
D-Link DES-3326S Layer 3 Switch CLI Reference
Figure 2-3. Example Command Parameter Help
In this case, the command config account was entered with the parameter . The CLI will then
prompt you to enter the with the message, Next possible completions:. Every command in the
CLI has this feature, and complex commands have several layers of parameter prompting.
In addition, after typing any given command plus one space, you can see all of the next possible sub-commands,
in sequential order, by repeatedly pressing the Tab key.
To re-enter the previous command at the command prompt, press the up arrow cursor key. The previous
command will appear at the command prompt.
Figure 2-4. Using the Up Arrow to Re-enter a Command
In the above example, the command config account was entered without the required parameter ,
the CLI returned the Next possible completions: prompt. The up arrow cursor control key was
pressed to re-enter the previous command (config account) at the command prompt. Now the appropriate User
name can be entered and the config account command re-executed.
6
D-Link DES-3326S Layer 3 Switch CLI Reference
All commands in the CLI function in this way. In addition, the syntax of the help prompts are the same as
presented in this manual − angle brackets < > indicate a numerical value or character string, braces { } indicate
optional parameters or a choice of parameters, and brackets [ ] indicate required parameters.
If a command is entered that is unrecognized by the CLI, the top-level commands will be displayed under the
Available commands: prompt.
Figure 2-5. The Next Available Commands Prompt
The top-level commands consist of commands like show or config. Most of these commands require one or
more parameters to narrow the top-level command. This is equivalent to show what? or config what? Where the
what? is the next parameter.
For example, if you enter the show command with no additional parameters, the CLI will then display all of the
possible next parameters.
Figure 2-6. Next possible completions: Show Command
In the above example, all of the possible next parameters for the show command are displayed. At the next
command prompt, the up arrow was used to re-enter the show command, followed by the account parameter.
The CLI then displays the user accounts configured on the Switch.
7
D-Link DES-3326S Layer 3 Switch CLI Reference
3
COMMAND SYNTAX
The following symbols are used to describe how command entries are made and values and arguments are
specified in this manual. The online help contained in the CLI and available through the console interface uses
the same syntax.
Note: All commands are case-sensitive. Be sure to disable Caps Lock or
any other unwanted function that changes text case.
8
D-Link DES-3326S Layer 3 Switch CLI Reference
D-Link DES-3326S Layer 3 Switch CLI Reference
| vertical bar
Purpose
Separates two or more mutually exclusive items
in a list, one of which must be entered.
Syntax
show snmp [community|detail]
Description
In the above syntax example, you must specify
either community, or detail. Do not type the
backslash.
Example
Command
show snmp community
{braces}
Purpose
Encloses an optional value or set of optional
arguments.
Syntax
reset {[config|system]}
Description
In the above syntax example, you have the
option to specify config or detail. It is not
necessary to specify either optional value,
however the effect of the system reset is
dependent on which, if any, value is specified.
Therefore, with this example there are three
possible outcomes of performing a system
reset. See the following chapter, Basic
Commands for more details about the reset
command.
Example
command
reset config
10
D-Link DES-3326S Layer 3 Switch CLI Reference
Line Editing Key Usage
Delete
Deletes the character under the cursor and then
shifts the remaining characters in the line to the
left.
Backspace
Deletes the character to the left of the cursor
and shifts the remaining characters in the line to
the left.
Left Arrow
Moves the cursor to the left.
Right Arrow
Moves the cursor to the right.
Up Arrow
Repeat the previously entered command. Each
time the up arrow is pressed, the command
previous to that displayed appears. This way it
is possible to review the command history for
the current session. Use the down arrow to
progress sequentially forward through the
command history list.
Down Arrow
The down arrow will display the next command
in the command history entered in the current
session. This displays each command
sequentially as it was entered. Use the up arrow
to review previous commands.
Tab
Shifts the cursor to the next field to the left.
Multiple Page Display Control Keys
Space
Displays the next page.
CTRL+c
Stops the display of remaining pages when
multiple pages are to be displayed.
ESC
Stops the display of remaining pages when
multiple pages are to be displayed.
n
Displays the next page.
p
Displays the previous page.
q
Stops the display of remaining pages when
multiple pages are to be displayed.
r
Refreshes the pages currently displayed.
a
Displays the remaining pages without pausing
between pages.
Enter
Displays the next line or table entry.
11
D-Link DES-3326S Layer 3 Switch CLI Reference
4
BASIC SWITCH COMMANDS
The basic Switch commands in the Command Line Interface (CLI) are listed (along with the appropriate
parameters) in the following table.
Command
Parameters
create account
[admin|user]
config account
show account
show session
show switch
show serial_port
config serial_port
baud_rate [9600|19200|38400|115200]
auto_logout [never|2_minutes|5_minutes
|10_minutes|15_minutes]
enable clipaging
disable clipaging
enable telnet
disable telnet
enable web
disable web
save
reboot
reset
{config|system}
login
logout
Each command is listed, in detail, in the following sections.
12
D-Link DES-3326S Layer 3 Switch CLI Reference
create account
Purpose
Used to create user accounts
Syntax
create [admin|user]
Description
The create account command is used to create
user accounts that consist of a username of 1 to
15 characters and a password of 0 to 15
characters. Up to 8 user accounts can be
created.
Parameters
Admin
User
Restrictions
Only Administrator-level users can issue this
command.
Usernames can be between 1 and 15
characters.
Passwords can be between 0 and 15
characters.
Example Usage:
To create an administrator-level user account with the username “dlink”.
DES-3326S:4#create account admin dlink
Command: create account admin dlink
Enter a case-sensitive new password:****
Enter the new password again for confirmation:****
Success.
DES-3326S:4#
13
D-Link DES-3326S Layer 3 Switch CLI Reference
config account
Purpose
Used to configure user accounts
Syntax
config account
Description
The config account command configures a
user account that has been created using the
create account command.
Parameters
Restrictions
Only Administrator-level users can issue this
command.
Usernames can be between 1 and 15
characters.
Passwords can be between 0 15 characters.
Example Usage:
To configure the user password of “dlink” account:
DES-3326S:4#config account dlink
Command: config account dlink
Enter a old password:****
Enter a case-sensitive new password:****
Enter the new password again for confirmation:****
Success.
DES-3326S:4#
14
D-Link DES-3326S Layer 3 Switch CLI Reference
show account
Purpose
Used to display user accounts
Syntax
show account
Description
Displays all user accounts created on the
Switch. Up to 8 user accounts can exist on the
Switch at one time.
Parameters
none.
Restrictions
none.
Example Usage:
To display the accounts that have been created:
DES-3326S:4#show account
Command: show account
Current Accounts:
Username Access Level
--------------- ------------
dlink Admin
DES-3326S:4#
15
D-Link DES-3326S Layer 3 Switch CLI Reference
delete account
Purpose
Used to delete an existing user account
Syntax
delete account
Description
The delete account command deletes a user
account that has been created using the create
account command.
Parameters
Restrictions
Only Administrator-level users can issue this
command.
Example Usage:
To delete the user account “System”:
DES-3326S:4#delete account System
Command: delete account System
Success.
DES-3326S:4#
16
D-Link DES-3326S Layer 3 Switch CLI Reference
show session
Purpose
Used to display a list of currently logged-in
users.
Syntax
show session
Description
This command displays a list of all the users
that are logged-in at the time the command is
issued.
Parameters
None
Restrictions
None.
Example Usage:
To display the way that the users logged in:
DES-3326S:4#show session
Command: show session
ID Login Time Live Time From Level Name
-- ------------------- ------------ --------------- ----- ---------------
*8 00000 days 03:27:34 0:0:32.670 Serial Port 4 Anonymous
17
D-Link DES-3326S Layer 3 Switch CLI Reference
show serial_port
Purpose
Used to display the current serial port settings.
Syntax
show serial_port
Description
This command displays the current serial port
settings.
Parameters
none.
Restrictions
none
Example Usage:
To display the serial port setting:
DES-3326S:4#show serial_port
Command: show serial_port
Baud Rate : 9600
Data Bits : 8
Parity Bits : None
Stop Bits : 1
Auto-Logout : 10 mins
DES-3326S:4#
18
D-Link DES-3326S Layer 3 Switch CLI Reference
show switch
Purpose
Used to display information about the Switch.
Syntax
show switch
Description
This command displays information about the
Switch.
Parameters
None.
Restrictions
None.
Example Usage:
To display the Switch information:
DES-3326S:4#show switch
Command: show switch
Device Type : DES-3326S Fast-Ethernet Switch
Module Type : DES-332GS 1-port GBIC Gigabit Ethernet and 1 Stacking Port
Unit ID : 1
MAC Address : 00-05-5D-17-FF-60
IP Address : 10.90.90.90 (Manual)
VLAN Name : default
Subnet Mask : 255.0.0.0
Default Gateway : 10.1.1.254
Boot PROM Version : Build 0.00.001
Firmware Version : Build 4.01-B12
Hardware Version : 2B1
Device S/N :
System Name :
System Location :
System Contact :
Spanning Tree : Disabled
GVRP : Disabled
IGMP Snooping : Disabled
TELNET : Enabled (TCP 23)
WEB : Enabled (TCP 80)
RMON : Disabled
RIP : Disabled
CTRL+C ESC q Quit SPACE n Next Page ENTER Next Entry a All
19
D-Link DES-3326S Layer 3 Switch CLI Reference
show serial_port
Purpose
Used to display the current serial port settings.
Syntax
show serial_port
Description
This command displays the current serial port
settings.
Parameters
none.
Restrictions
none
Example Usage:
To display the serial port setting:
DES-3326S:4#show serial_port
Command: show serial_port
Baud Rate : 9600
Data Bits : 8
Parity Bits : None
Stop Bits : 1
Auto-Logout : 10 mins
DES-3326S:4#
20
D-Link DES-3326S Layer 3 Switch CLI Reference
config serial_port
Purpose
Used to configure the serial port.
Syntax
config serial_port
{baud_rate[9600|19200|38400|115200]|auto_logout
[never|2_minutes|5_minutes|10_minutes|
15_minutes]}
Description
This command is used to configure the serial port’s
baud rate and auto logout settings.
Parameters
[9600/19200/38400/115200] − The serial bit rate that
will be used to communicate with the management
host.
never − No time limit on the length of time the console
can be open with no user input.
2_minutes − The console will log out the current user if
there is no user input for 2 minutes.
5_minutes − The console will log out the current user if
there is no user input for 5 minutes.
10_minutes − The console will log out the current user
if there is no user input for 10 minutes.
15_minutes − The console will log out the current user
if there is no user input for 15 minutes.
Restrictions
Only administrator-level users can issue this
command.
Example Usage:
To configure baud rate:
DES-3326S:4#config serial_port baud_rate 9600
Command: config serial_port baud_rate 9600
Success.
DES-3326S:4#
21
D-Link DES-3326S Layer 3 Switch CLI Reference
enable clipaging
Purpose
Used to pause the scrolling of the console
screen when the show command displays more
than one page.
Syntax
enable clipaging
Description
This command is used when issuing the show
command will cause the console screen to
rapidly scroll through several pages. This
command will cause the console to pause at the
end of each page. The default setting is
enabled.
Parameters
none.
Restrictions
Only administrator-level users can issue this
command.
Example Usage:
To enable pausing of the screen display when show command output reaches the end of the page:
DES-3326S:4#enable clipaging
Command: enable clipaging
Success.
DES-3326S:4#
22
D-Link DES-3326S Layer 3 Switch CLI Reference
disable clipaging
Purpose
Used to disable the pausing of the console
screen scrolling at the end of each page when
the show command would display more than
one screen of information.
Syntax
disable clipaging
Description
This command is used to disable the pausing of
the console screen at the end of each page
when the show command would display more
than one screen of information.
Parameters
none.
Restrictions
Only administrator-level users can issue this
command.
Example Usage:
To disable pausing of the screen display when show command output reaches the end of the page:
DES-3326S:4#disable clipaging
Command: disable clipaging
Success.
DES-3326S:4#
23
D-Link DES-3326S Layer 3 Switch CLI Reference
enable telnet
Purpose
Used to enable communication with and
management of the Switch using the Telnet
protocol.
Syntax
enable telnet
Description
This command is used to enable the Telnet
protocol on the Switch. The user can specify the
TCP or UDP port number the Switch will use to
listen for Telnet requests.
Parameters
− The TCP port number.
TCP ports are numbered between 1 and 65535.
The “well-known” TCP port for the Telnet
protocol is 23.
Restrictions
Only administrator-level users can issue this
command.
Example Usage:
To enable Telnet and configure port number:
DES-3326S:4#enable telnet 23
Command: enable telnet 23
Success.
DES-3326S:4#
24
D-Link DES-3326S Layer 3 Switch CLI Reference
disable telnet
Purpose
Used to disable the Telnet protocol on the
Switch.
Syntax
disable telnet
Description
This command is used to disable the Telnet
protocol on the Switch.
Parameters
none.
Restrictions
Only administrator-level users can issue this
command.
Example Usage:
To disable the Telnet protocol on the Switch:
DES-3326S:4#disable telnet
Command: disable telnet
Success.
DES-3326S:4#
25
D-Link DES-3326S Layer 3 Switch CLI Reference
enable web
Purpose
Used to enable the HTTP-based management
software on the Switch.
Syntax
enable web
Description
This command is used to enable the Web-
based management software on the Switch.
The user can specify the TCP port number the
Switch will use to listen for Telnet requests.
Parameters
− The TCP port number.
TCP ports are numbered between 1 and 65535.
The “well-known” port for the Web-based
management software is 80.
Restrictions
Only administrator-level users can issue this
command.
Example Usage:
To enable HTTP and configure port number:
DES-3326S:4#enable web 80
Command: enable web 80
Success.
DES-3326S:4#
26
D-Link DES-3326S Layer 3 Switch CLI Reference
disable web
Purpose
Used to disable the HTTP-based management
software on the Switch.
Syntax
disable web
Description
This command disables the Web-based
management software on the Switch.
Parameters
none.
Restrictions
Only administrator-level users can issue this
command.
Example Usage:
To disable HTTP:
DES-3326S:4#disable web
Command: disable web
Success.
DES-3326S:4#
27
D-Link DES-3326S Layer 3 Switch CLI Reference
save
Purpose
Used to save changes in the Switch’s
configuration to non-volatile RAM.
Syntax
save
Description
This command is used to enter the current
Switch configuration into non-volatile RAM. The
saved Switch configuration will be loaded into
the Switch’s memory each time the Switch is
restarted.
Parameters
none.
Restrictions
Only administrator-level users can issue this
command.
Example Usage:
To save the Switch’s current configuration to non-volatile RAM:
DES-3326S:4#save
Command: save
Saving all settings to NV-RAM... 100%
done.
DES-3326S:4#
28
D-Link DES-3326S Layer 3 Switch CLI Reference
reboot
Purpose
Used to restart the Switch.
Syntax
reboot
Description
This command is used to restart the Switch.
Parameters
none.
Restrictions
none.
Example Usage:
To restart the Switch:
DES-3326S:4#reboot
Command: reboot
Are you sure you want to proceed with the system reboot? (y/n)
Please wait, the Switch is rebooting...
29
D-Link DES-3326S Layer 3 Switch CLI Reference
reset
Purpose
Used to reset the Switch to the factory default
settings.
Syntax
reset {config|system}
Description
This command is used to restore the Switch’s
configuration to the default settings assigned from
the factory.
Parameters
config − If config is specified, all of the factory
default settings are restored on the Switch
including the IP address, user accounts, and the
Switch history log. The Switch will not reboot. New
user accounts information and IP settings will need
to be assigned.
system − If system is specified all of the factory
default settings are restored on the Switch. The
Switch will reboot. New user accounts information
and IP settings will need to be assigned.
If no parameter is specified, the Switch’s current IP
address, user accounts, and the Switch history log
are retained. All other parameters are restored to
their factory default settings. The Switch will not
reboot.
Restrictions
Only administrator-level users can issue this
command.
Example Usage:
To restore all of the Switch’s parameters to their default values:
DES-3326S:4#reset config
Command: reset config
Success.
DES-3326S:4#
30
D-Link DES-3326S Layer 3 Switch CLI Reference
login
Purpose
Used to log in a user to the Switch’s console.
Syntax
login
Description
This command is used to initiate the login
procedure. The user will be prompted for his
Username and Password.
Parameters
none.
Restrictions
none.
Example Usage:
To initiate the login procedure:
DES-3326S:4#login
Command: login
UserName:
logout
Purpose
Used to log out a user from the Switch’s
console.
Syntax
logout
Description
This command terminates the current user’s
session on the Switch’s console.
Parameters
none.
Restrictions
none.
Example Usage:
To terminate the current user’s console session:
DES-3326S:4#logout
31
D-Link DES-3326S Layer 3 Switch CLI Reference
5
SWITCH PORT COMMANDS
The Switch port commands in the Command Line Interface (CLI) are listed (along with the appropriate
parameters) in the following table.
Command Parameters
config ports
[]
{speed[auto|10_half|10_full|100_half|100_half|1000_full
] learning [enable|disable] state [enable|disable]}
show ports
Each command is listed, in detail, in the following sections.
32
D-Link DES-3326S Layer 3 Switch CLI Reference
config ports
Purpose
Used to configure the Switch’s Ethernet port settings.
Syntax
config ports []
{speed[auto|10_half|10_full|100_half|100_half|1000_f
ull] learning [enable|disable] state [enable|disable]}
Description
This command allows for the configuration of the
Switch’s Ethernet ports. Only the ports listed in the
will be affected.
Parameters
all − Displays all ports on the Switch.
− Specifies a range of ports to be configured.
The port list is specified by listing the beginning port
number and the highest port number of the range. The
beginning and end of the port list range are separated by
a dash. For example, 3 would specify port 3. 4 specifies
port 4. 3-4 specifies all of the ports between port 3 and
port 4 − in numerical order.
auto − Enables auto-negotiation for the specified range
of ports.
[10/100/1000] − Configures the speed in Mbps for the
specified range of ports.
[half/full] − Configures the specified range of ports as
either full- or half-duplex.
flow_control [enable|disable] - Enables or disables the
flow control on the specified range of ports.
learning [enable|disable] − Enables or disables the MAC
address learning on the specified range of ports.
state [enable|disable] − Enables or disables the
specified range of ports.
Restrictions
Only administrator-level users can issue this command.
Example Usage:
To configure the speed of port 3 to be 10 Mbps, full duplex, learning and state enabled:
DES-3326S:4#config ports 1-3 speed 10_full learning on state enable
Command: config ports 1-3 speed 10_full learning on state enable
Success.
DES-3326S:4#
33
D-Link DES-3326S Layer 3 Switch CLI Reference
show ports
Purpose
Used to display the current configuration of a
range of ports.
Syntax
show ports {}
Description
This command is used to display the current
configuration of a range of ports.
Parameters
− Specifies a range of ports to be
configured. The port list is specified by listing
the beginning port number and the highest port
number of the range. The beginning and end of
the port list range are separated by a dash. For
example, 3 would specify port 3. 4 specifies port
4. 3-4 specifies all of the ports between port 3
and port 4 − in numerical order.
Restrictions
none.
Example Usage:
To display ports status:
DES-3326S:4#show ports
Command: show ports
Port Port Settings Connection Address
State Speed/Duplex/FlowCtrl Speed/Duplex/FlowCtrl Learning
------ -------- --------------------- --------------------- --------
1 Enabled Auto/Disabled Link Down Enabled
2 Enabled Auto/Disabled Link Down Enabled
3 Enabled Auto/Disabled Link Down Enabled
4 Enabled Auto/Disabled Link Down Enabled
5 Enabled Auto/Disabled Link Down Enabled
6 Enabled Auto/Disabled Link Down Enabled
7 Enabled Auto/Disabled Link Down Enabled
8 Enabled Auto/Disabled Link Down Enabled
9 Enabled Auto/Disabled Link Down Enabled
10 Enabled Auto/Disabled 100M/Full/None Enabled
11 Enabled Auto/Disabled Link Down Enabled
12 Enabled Auto/Disabled Link Down Enabled
13 Enabled Auto/Disabled Link Down Enabled
14 Enabled Auto/Disabled Link Down Enabled
15 Enabled Auto/Disabled Link Down Enabled
16 Enabled Auto/Disabled Link Down Enabled
17 Enabled Auto/Disabled 100M/Full/None Enabled
18 Enabled Auto/Disabled Link Down Enabled
19 Enabled Auto/Disabled Link Down Enabled
20 Enabled Auto/Disabled Link Down Enabled
CTRL+C ESC q Quit SPACE n Next Page p Previous Page r Refresh
34
D-Link DES-3326S Layer 3 Switch CLI Reference
6
PORT SECURITY COMMANDS
The Switch port security commands in the Command Line Interface (CLI) are listed (along with the appropriate
parameters) in the following table.
Command
Parameters
config port_security
|all
admin_state [enable|disable]
max_learning_addr <0-10>
lock_address_mode
[Permanent|DeleteOnTimout|DeleteOnReset
]
delete
port_security_entry
vlan_name mac_address
port
clear
port_security_entry
port
show port_security
Each command is listed, in detail, in the following sections.
35
D-Link DES-3326S Layer 3 Switch CLI Reference
config port_security
Purpose
Used to configure port lock settings.
Syntax
config port_security
|all
admin_state [enable|disable]
max_learning_addr
lock_address_mode [Permanent|DeleteOnTimout|DeleteOnReset]
Description
This command allows for the configuration of the port lock
security feature. Only the ports listed in the are
effected.
Parameters
all − configure port lock for all ports on the Switch.
portlist − specifies a range of ports to be configured. The port list is
specified by listing the lowest Switch number and the beginning port
number on that Switch, separated by a colon. Then highest Switch
number, and the highest port number of the range (also separeted by
a colon) are specified. The beginning and end of the port list range
are seperated by a dash. For example, 1:3 would specify Switch
number 1, port 3. 2:4 specifies Switch number 2, port 4. 1:3-2:4
specifies all of the ports between Switch 1, port 3 and Switch 2, port 4
− in numerical order.
admin_state [enable|disaled] – enable or disable port lock for the
listed ports.
max_learning_addr <1-10> - use this to limit the number of MAC
addresses dynamically listed in the FDB for the ports.
lock_address_mode[Permanent|DeleteOnTimout|DeleteOnReset] –
The options for clearing the aging out locked addresses for the port
are as follows:
Permanent – Locked MAC addresses do not age out. MAC
addresses retain locked status even if the Switch is restarted.
DeleteOnTimeout – Removes locked MAC addresses upon aging out
of the FDB. MAC address aging is set using FDB commands. (See
config fdb aging_time in Forwarding Database Commands).
DeleteOnReset – Locked MAC addresses do not age out. If the
Switch is restarted reset, the MAC addresses will no longer have
locked status. Any previously learned addresses will need to be
relearned.
Restrictions
Only administrator-level users can issue this command.
36
D-Link DES-3326S Layer 3 Switch CLI Reference
Example Usage:
To configure the port lock for ports 1:12 – 1:14 to delete the dynamic address table entries on timeout:
DES-3326S:4#config port_security ports 12-14
lock_address_mode DeleteOnTimeout
Command: config port_security ports 12-14 lock_address_mode
DeleteOnTimeout
Success.
DES-3326S:4#
delete port_security_entry
Purpose
Used to remove port security from specific devices
according to VLAN and port.
Syntax
delete port_security_entry vlan_name
mac_address
port
Description
This allows specific MAC addresses to be excluded
from port locked status for individual ports.
Parameters
− The name of the VLAN on which
the port resides.
− The MAC address that will be removed
from eligibility for locked status.
− The port number corresponding to the MAC
address of the device being removed.
Restrictions
Only administrator-level users can issue this
command.
Example Usage:
To remove a port eligibility for a specific device:
DES-3326S:4#delete port_security_entry vlan_name default
mac_address a1-01-01-01-01-01 port 4
Command: delete port_security_entry vlan_name default
mac_address A1-01-01-01-01-01 port 1:4
Success
DES-3326S:4#
37
D-Link DES-3326S Layer 3 Switch CLI Reference
config port_security_entry
Purpose
Used to clear the MAC entries learned from the
specified port(s) for the port security function
Syntax
clear port_security_entry port
Description
This will delete all entries from the forwarding data
base for a specific port or range of ports.
Parameters
portlist − specifies a range of ports to be configured.
The port list is specified by listing the lowest Switch
number and the beginning port number on that
Switch, separated by a colon. Then highest Switch
number, and the highest port number of the range
(also separeted by a colon) are specified. The
beginning and end of the port list range are seperated
by a dash. For example, 1:3 would specify Switch
number 1, port 3. 2:4 specifies Switch number 2, port
4. 1:3-2:4 specifies all of the ports between Switch 1,
port 3 and Switch 2, port 4 − in numerical order.
Restrictions
Only administrator-level users can issue this
command.
Example Usage:
To clear the port security entries for a specific port (port 10):
DES-3326S:4#clear port_security_entry port 10
Command: clear port_security_entry port 10
Success.
DES-3326S:4#
38
D-Link DES-3326S Layer 3 Switch CLI Reference
show port_security
Purpose
Used to display the current portr lock configuration.
Syntax
show port_security {}
Description
This command is used to display the current port lock
configuration of a range of ports.
Parameters
− specifies a range of ports to be viewed.
The port list is specified by listing the lowest Switch
number and the beginning port number on that Switch,
separated by a colon. Then highest Switch number,
and the highest port number of the range (also
separeted by a colon) are specified. The beginning
and end of the port list range are seperated by a dash.
For example, 1:3 would specify Switch number 1, port
3. 2:4 specifies Switch number 2, port 4. 1:3-2:4
specifies all of the ports between Switch 1, port 3 and
Switch 2, port 4 − in numerical order.
Restrictions
None.
Example Usage:
To display the port security configuration on the entire Switch:
DES-3326S:4#show port_security
Command: show port_security
Port# Admin State Max. Learning Addr. Lock Address Mode
---- ----------- ------------------- -----------------
1 Disabled 1 DeleteOnReset
2 Disabled 1 DeleteOnReset
3 Disabled 1 DeleteOnReset
4 Disabled 1 DeleteOnReset
5 Disabled 1 DeleteOnReset
6 Disabled 1 DeleteOnReset
7 Enabled 10 DeleteOnReset
8 Disabled 1 DeleteOnReset
9 Disabled 1 DeleteOnReset
10 Disabled 1 DeleteOnReset
11 Disabled 1 DeleteOnReset
12 Disabled 1 DeleteOnReset
13 Disabled 1 DeleteOnReset
14 Disabled 1 DeleteOnReset
15 Disabled 1 DeleteOnReset
16 Disabled 1 DeleteOnReset
17 Disabled 1 DeleteOnReset
18 Disabled 1 DeleteOnReset
19 Disabled 1 DeleteOnReset
20 Disabled 1 DeleteOnReset
CTRL+C ESC q Quit SPACE n Next Page p Previous Page r
Refresh
39
D-Link DES-3326S Layer 3 Switch CLI Reference
7
NETWORK MANAGEMENT COMMANDS
The network management commands in the Command Line Interface (CLI) are listed (along with the
appropriate parameters) in the following table.
The DES-3326S supports the Simple Network Management Protocol (SNMP) versions 1, 2c, and 3. You can
specifiy which version of the SNMP you want to use to monitor and control the Switch. The three versions of
SNMP vary in the level of security provided between the management station and the network device. The
following table lists the security features of the three SNMP versions:
SNMP
Version
Authentication Method
Description
v1
Community String
Community String is used for
authentication − NoAuthNoPriv
v2c
Community String
Community String is used for
authentication − NoAuthNoPriv
v3
Username
Username
is
used
for
authentication − NoAuthNoPriv
v3
MD5 or SHA
Authentication is based on the
HMAC-MD5
or
HMAC-SHA
algorithms − AuthNoPriv
v3
MD5 DES or SHA DES
Authentication is based on the
HMAC-MD5
or
HMAC-SHA
algorithms − AuthPriv.
DES 56-bit encryption is added
based on the CBC-DES (DES-56)
standard
40
D-Link DES-3326S Layer 3 Switch CLI Reference
Command
Parameters
create snmp user
v1|v2c|v3
encrypted
auth [md5|sha]
priv [none|des
show snmp user
show snmp groups
create snmp view
view_type [included|excluded]
delete snmp view
[all|oid]
show snmp view
create snmp
community
view [read_only|read_write]
delete snmp
community
show snmp
community
config snmp
engineID
show snmp
engineID
41
D-Link DES-3326S Layer 3 Switch CLI Reference
Command
Parameters
create snmp group
v1|v2c|v3
noauth_nopriv
auth_nopriv
auth_priv
read_view
write_view
notify_view
delete snmp group
create snmp host
v1|v2c|v3
noauth_nopriv
auth_nopriv
auth_priv
delete snmp host
show snmp host
enable rmon
disable rmon
ping
times
timeout
traceroute
port
timeout
probe
ttl
Each command is listed, in detail, in the following sections.
42
D-Link DES-3326S Layer 3 Switch CLI Reference
create snmp user
Purpose
Used to create a new SNMP user and adds the user to an SNMP
group that is also created by this command.
Syntax
create snmp user [v1|v2c|v3
{encrypted auth [md5|sha] priv [none|des
]}]
Description
The create snmp user command creates a new SNMP user and
adds the user to an SNMP group that is also created by this
command.
Parameters
− An alphanumeric name of up to 32 characters
that will identify the new SNMP user.
− An alphanumeric name of up to 32 characters
that will identify the SNMP group the new SNMP user will be
associated with.
v1 – Specifies that SNMP version 1 will be used. The Simple
Network Management Protocol (SNMP), version 1, is a network
management protocol that provides a means to monitor and
control network devices.
v2c – Specifies that SNMP version 2c will be used. The SNMP
v2c supports both centralized and distributed network
management strategies. It includes improvements in the
Structure of Management Information (SMI) and adds some
security features.
v3 – Specifies that the SNMP version 3 will be used. SNMP v3
provides secure access to devices through a combination of
authentication and encrypting packets over the network. SNMP
v3 adds:
Message integrity − ensures that packets have not been
tampered with in transit.
Authentication − determines that an SNMP message is from a
valid source.
Encryption − scrambles the contents of messages to prevent it
being seen by an unauthorized source.
encrypted – Specifies that the password will be in an encrypted
format.
auth [md5|sha] – Initiate an authentication-level setting session.
md5 − Specifies that the HMAC-MD5-96 authentication level will
be used.
sha − Specifies that the HMAC-SHA-96 authentication level will
be used.
− An alphanumeric sting of between 8
and 16 characters that will be used to authorize the agent to
receive packets for the host.
des − An alphanumeric string of between 8
and 16 characters that will be used to encrypt the contents of
messages the host sends to the agent.
Restrictions
Only administrator-level users can issue this command.
43
D-Link DES-3326S Layer 3 Switch CLI Reference
Example Usage:
To create an SNMP user on the Switch:
DES-3326S:4#create snmp user dlink default v3 encrypted auth
md5 auth_password priv none
Command: create snmp user dlink default v3 encrypted auth md5
auth_password priv none
Success.
DES-3326S:4#
delete snmp user
Purpose
Used to remove an SNMP user from an SNMP
group and also to delete the associated SNMP
group.
Syntax
delete snmp user
Description
The delete snmp user command removes an
SNMP user from its SNMP group and then
deletes the associated SNMP group.
Parameters
− An alphanumeric string of up
to 32 characters that identifies the SNMP user
that will be deleted.
Restrictions
Only administrator-level users can issue this
command.
44
D-Link DES-3326S Layer 3 Switch CLI Reference
Example Usage:
To delete a previously entered SNMP user on the Switch:
DES-3326S:4#delete snmp user dlink
Command: delete snmp user dlink
Success.
DES-3326S:4#
show snmp user
Purpose
Used to display information about each SNMP
username in the SNMP group username table.
Syntax
show snmp user
Description
The show snmp user command displays
information about each SNMP username in the
SNMP group username table.
Parameters
None.
Restrictions
Only administrator-level users can issue this
command.
Example Usage:
To display the SNMP users currently configured on the Switch:
DES-3326S:4#show snmp user
Command: show snmp user
Username Group Name SNMP Version Auth-Protocol
PrivProtocol
--------------- --------------- ------------ ------------- ------------
initial initial V3 None None
Total Entries: 1
DES-3326S:4#
45
D-Link DES-3326S Layer 3 Switch CLI Reference
show snmp groups
Purpose
Used to display the group-names of SNMP
groups currently configured on the Switch. The
security model, level, and status of each group
is also displayed.
Syntax
show snmp groups
Description
The show snmp groups command displays the
group-names of SNMP groups currently
configured on the Switch. The security model,
level, and status of each group is also
displayed.
Parameters
None.
Restrictions
Only administrator-level users can issue this
command.
Example Usage:
To display the currently configured SNMP groups on the Switch:
DES-3326S:4#show snmp groups
Command: show snmp groups
Vacm Access Table Settings
Group Name : Group3
ReadView Name : ReadView
WriteView Name : WriteView
Notify View Name : NotifyView
Securiy Model : SNMPv3
Securiy Level : NoAuthNoPriv
Group Name : Group4
ReadView Name : ReadView
WriteView Name : WriteView
Notify View Name : NotifyView
Securiy Model : SNMPv3
Securiy Level : authNoPriv
Group Name : Group5
ReadView Name : ReadView
WriteView Name : WriteView
Notify View Name : NotifyView
Securiy Model : SNMPv3
Securiy Level : authNoPriv
46
D-Link DES-3326S Layer 3 Switch CLI Reference
Group Name : Group6
ReadView Name : ReadView
WriteView Name : WriteView
Notify View Name : NotifyView
Securiy Model : SNMPv3
Securiy Level : authPriv
Group Name : Group7
ReadView Name : ReadView
WriteView Name : WriteView
Notify View Name : NotifyView
Securiy Model : SNMPv3
Securiy Level : authPriv
Group Name : initial
ReadView Name : restricted
WriteView Name :
Notify View Name : restricted
Securiy Model : SNMPv3
Securiy Level : NoAuthNoPriv
Group Name : ReadGroup
ReadView Name : CommunityView
WriteView Name :
Notify View Name : CommunityView
Securiy Model : SNMPv1
Securiy Level : NoAuthNoPriv
47
D-Link DES-3326S Layer 3 Switch CLI Reference
Group Name : ReadGroup
ReadView Name : CommunityView
WriteView Name :
Notify View Name : CommunityView
Securiy Model : SNMPv2
Securiy Level : NoAuthNoPriv
Group Name : WriteGroup
ReadView Name : CommunityView
WriteView Name : CommunityView
Notify View Name : CommunityView
Securiy Model : SNMPv1
Securiy Level : NoAuthNoPriv
Group Name : WriteGroup
ReadView Name : CommunityView
WriteView Name : CommunityView
Notify View Name : CommunityView
Securiy Model : SNMPv2
Securiy Level : NoAuthNoPriv
Total Entries: 10
DES-3326S:4#
48
D-Link DES-3326S Layer 3 Switch CLI Reference
create snmp view
Purpose
Used to assign views to community strings to
limit which MIB objects and SNMP manager can
access.
Syntax
create snmp view
view_type [included|excluded]
Description
The create snmp view assigns views to
community strings to limit which MIB objects an
SNMP manager can access.
Parameters
− An alphanumeric string of
up to 32 characters that identifies the SNMP
view that will be created.
− The object ID that identifies an object
tree (MIB tree) that will be included or excluded
from access by an SNMP manager.
included − Include this object in the list of
objects that an SNMP manager can access.
excluded − Exclude this object from the list of
objects that an SNMP manager can access.
Restrictions
Only administrator-level users can issue this
command.
Example Usage:
To create and SNMP view:
DES-3326S:4#create snmp view dlinkview 1.3.6 view_type included
Command: create snmp view dlinkview 1.3.6 view_type included
Success.
DES-3326S:4#
49
D-Link DES-3326S Layer 3 Switch CLI Reference
delete snmp view
Purpose
Used to remove an SNMP view entry previously
created on the Switch.
Syntax
delete snmp view
[all|]
Description
The delete snmp view command is used to
remove an SNMP view previously created on
the Switch.
Parameters
− An alphanumeric string of
up to 32 characters that identifies the SNMP
view to be deleted.
all − Specifies that all of the SNMP views on the
Switch will be deleted.
− The object ID that identifies an object
tree (MIB tree) that will be deleted from the
Switch.
Restrictions
Only administrator-level users can issue this
command.
Example Usage:
To delete a previously configured SNMP view from the Switch:
DES-3326S:4#delete snmp view dlinkview
Command: delete snmp view dlinkview
Success.
DES-3326S:4#
50
D-Link DES-3326S Layer 3 Switch CLI Reference
show snmp view
Purpose
Used to display an SNMP view previously
created on the Switch.
Syntax
show snmp view {}
Description
The show snmp view command displays an
SNMP view previously created on the Switch.
Parameters
− An alphanumeric string of
up to 32 characters that identifies the SNMP
view that will be displayed.
Restrictions
Only administrator-level users can issue this
command.
Example Usage:
To display the previously created SNMP view:
DES-3326S:4#show snmp view
Command: show snmp view
Vacm View Table Settings
View Name Subtree View Type
-------------------- ------------------------- ----------
ReadView 1 Included
WriteView 1 Included
NotifyView 1.3.6 Included
restricted 1.3.6.1.2.1.1 Included
restricted 1.3.6.1.2.1.11 Included
restricted 1.3.6.1.6.3.10.2.1 Included
restricted 1.3.6.1.6.3.11.2.1 Included
restricted 1.3.6.1.6.3.15.1.1 Included
CommunityView 1.3.6.1.6.3 Excluded
CommunityView .3.6.1.6.3.1 Included
Total Entries: 10
DES-3326S:4#
51
D-Link DES-3326S Layer 3 Switch CLI Reference
create snmp community
Purpose
Used to create an SNMP community string to define the
relationship between the SNMP manager and an agent. The
community string acts like a password to permit access to the
agent on the Switch. One or more of the following characteristics
can be associated with the community string:
An Access List of IP addresses of SNMP managers that are
permitted to use the community string to gain access to the
Switch’s SNMP agent.
An MIB view that defines the subset of all MIB objects that will be
accessible to the SNMP community.
Read/write or read-only level permission for the MIB objects
accessible to the SNMP community.
Syntax
create snmp community view
[read_only|read_write]
Description
The create snmp community command is used to create an
SNMP community string and to assign access-limiting
characteristics to this community string.
Parameters
− An alphanumeric string of up to 32
characters that is used to identify members of an SNMP
community. This string is used like a password to give remote
SNMP managers access to MIB objects in the Switch’s SNMP
agent.
− An alphanumeric string of up to 32 characters
that is used to identify the group of MIB objects that a remote
SNMP manager is allowed to access on the Switch.
read_only − Specifies that SNMP community members using the
community string created with this command can only read the
contents of the MIBs on the Switch.
read_write − Specifies that SNMP community members using the
community string created with this command can read from and
write to the contents of the MIBs on the Switch.
Restrictions
Only administrator-level users can issue this command.
Example Usage:
To create the SNMP community string “dlink:”
DES-3326S:4#create snmp community dlink view ReadView
read_write
Command: create snmp community dlink view ReadView read_write
Success.
52
D-Link DES-3326S Layer 3 Switch CLI Reference
delete snmp community
Purpose
Used to remove a specific SNMP community
string from the Switch.
Syntax
delete snmp community
Description
The delete snmp community command is
used to remove a previously defined SNMP
community string from the Switch.
Parameters
− An alphanumeric
string of up to 32 characters that is used to
identify members of an SNMP community. This
string is used like a password to give remote
SNMP managers access to MIB objects in the
Switch’s SNMP agent.
Restrictions
Only administrator-level users can issue this
command.
Example Usage:
To delete the SNMP community string “dlink:”
DES-3326S:4#delete snmp community dlink
Command: delete snmp community dlink
Success.
DES-3326S:4#
53
D-Link DES-3326S Layer 3 Switch CLI Reference
show snmp community
Purpose
Used to display SNMP community strings
configured on the Switch.
Syntax
show snmp community {}
Description
The show snmp community command is used
to display SNMP community strings that are
configured on the Switch.
Parameters
− An alphanumeric string
of up to 32 characters that is used to identify
members of an SNMP community. This string is
used like a password to give remote SNMP
managers access to MIB objects in the Switch’s
SNMP agent.
Restrictions
Only administrator-level users can issue this
command.
Example Usage:
To display the currently entered SNMP community strings:
DES-3326S:4#show snmp community
Command: show snmp community
SNMP Community Table
Community Name View Name Access Right
-------------------------------- -------------------------------- ------------
dlink ReadView read_write
private CommunityView read_write
public CommunityView read_only
Total Entries: 3
54
D-Link DES-3326S Layer 3 Switch CLI Reference
config snmp engineID
Purpose
Used to configure a name for the SNMP engine
on the Switch.
Syntax
config snmp engineID
Description
The config snmp engineID command
configures a name for the SNMP engine on the
Switch.
Parameters
− An alphanumeric string
that will be used to identify the SNMP engine on
the Switch.
Restrictions
Only administrator-level users can issue this
command.
Example Usage:
To give the SNMP agent on the Switch the name “0035636666”
DES-3326S:4#config snmp 0035636666
Command: config snmp engineID 0035636666
Success.
DES-3326S:4#
55
D-Link DES-3326S Layer 3 Switch CLI Reference
create snmp group
Purpose
Used to create a new SNMP group, or a table that maps SNMP users to
SNMP views.
Syntax
create snmp group [v1|v2c|v3
[noauth_nopriv|auth_nopriv|auth_priv]] {read_view |notify_view |notify_view }
Description
The create snmp group command creates a new SNMP group, or a
table that maps SNMP users to SNMP views.
Parameters
− An alphanumeric name of up to 32 characters that
will identify the SNMP group the new SNMP user will be associated
with.
v1 – Specifies that SNMP version 1 will be used. The Simple Network
Management Protocol (SNMP), version 1, is a network management
protocol that provides a means to monitor and control network devices.
v2c – Specifies that SNMP version 2c will be used. The SNMP v2c
supports both centralized and distributed network management
strategies. It includes improvements in the Structure of Management
Information (SMI) and adds some security features.
v3 – Specifies that the SNMP version 3 will be used. SNMP v3 provides
secure access to devices through a combination of authentication and
encrypting packets over the network. SNMP v3 adds:
Message integrity − ensures that packets have not been tampered with
in transit.
Authentication − determines that an SNMP message is from a valid
source.
Encryption − scrambles the contents of messages to prevent it being
seen by an unauthorized source.
noauth_nopriv − Specifies that there will be no authorization and no
encryption of packets sent between the Switch and a remote SNMP
manager.
auth_nopriv − Specifies that authorization will be required, but there will
be no encryption of packets sent between the Switch and a remote
SNMP manager.
auth_priv − Specifies that authorization will be required, and that
packets sent between the swtich and a remote SNMP manger will be
encrypted.
read_view – Specifies that the SNMP group being created can request
SNMP messages.
− An alphanumeric string of up to 32 characters that is
used to identify the group of MIB objects that a remote SNMP manager
is allowed to access on the Switch.
notify_view − Specifies that the SNMP group being created can recieve
SNMP trap messages generated by the Switch’s SNMP agent.
Restrictions
Only administrator-level users can issue this command.
56
D-Link DES-3326S Layer 3 Switch CLI Reference
Example Usage:
To create an SNMP group named “sg1:”
DES-3326S:4#create snmp group sg1 v3 noauth_nopriv
read_view v1 write_view v1 notify_view v1
Command: create snmp group sg1 v3 noauth_nopriv read_view
v1 write_view v1 notify_view v1
Success.
DES-3326S:4#
show snmp engineID
Purpose
Used to display the identification of the SNMP
engine on the Switch.
Syntax
show snmp engineID
Description
The show snmp engineID command displays
the identification of the SNMP engine on the
Switch.
Parameters
None.
Restrictions
Only administrator-level users can issue this
command.
Example Usage:
To display the current name of the SNMP engine on the Switch:
DES-3326S:4#show snmp engineID
Command: show snmp engineID
SNMP Engine ID : 0035636666
DES-3326S:4#
delete snmp group
Purpose
Used to remove an SNMP group from the
Switch.
Syntax
delete snmp group
Description
The delete snmp group command is used to
remove an SNMP group from the Switch.
Parameters
− An alphanumeric name of
up to 32 characters that will identify the SNMP
group the new SNMP user will be associated
with.
Restrictions
Only administrator-level users can issue this
command.
57
D-Link DES-3326S Layer 3 Switch CLI Reference
Example Usage:
To delete the SNMP group named “sg1”.
DES-3326S:4#delete snmp group sg1
Command: delete snmp group sg1
Success.
DES-3326S:4#
show snmp host
Purpose
Used to display the recipient of SNMP traps
generated by the Switch’s SNMP agent.
Syntax
show snmp host {}
Description
The show snmp host command is used to
display the IP addresses and configuration
information of remote SNMP managers that are
designated as recipients of SNMP traps that are
generated by the Switch’s SNMP agent.
Parameters
− The IP address of a remote SNMP
manager that will receive SNMP traps
generated by the Switch’s SNMP agent.
Restrictions
Only administrator-level users can issue this
command.
Example Usage:
To display the currently configured SNMP hosts on the Switch:
DES-3326S:4#show snmp host
Command: show snmp host
SNMP Host Table
Host IP Address SNMP Version Community Name SNMPv3 User Name
--------------- --------------------- -------------------- -----------------------------
10.48.76.23 V2c private
10.48.74.100 V3 authpriv public
Total Entries: 2
58
D-Link DES-3326S Layer 3 Switch CLI Reference
create snmp host
Purpose
Used to create a recipient of SNMP traps generated by the Switch’s SNMP
agent.
Syntax
create snmp host [v1|v2c|v3
[noauth_nopriv|auth_nopriv|auth_priv] ]
Description
The create snmp host command creates a recipient of SNMP traps
generated by the Switch’s SNMP agent.
Parameters
− The IP address of the remote management station that will serve
as the SNMP host for the Switch.
v1 – Specifies that SNMP version 1 will be used. The Simple Network
Management Protocol (SNMP), version 1, is a network management protocol
that provides a means to monitor and control network devices.
v2c – Specifies that SNMP version 2c will be used. The SNMP v2c supports
both centralized and distributed network management strategies. It includes
improvements in the Structure of Management Information (SMI) and adds
some security features.
v3 – Specifies that the SNMP version 3 will be used. SNMP v3 provides
secure access to devices through a combination of authentication and
encrypting packets over the network. SNMP v3 adds:
Message integrity − ensures that packets have not been tampered with in
transit.
Authentication − determines that an SNMP message is from a valid source.
Encryption − scrambles the contents of messages to prevent it being seen by
an unauthorized source.
noauth_nopriv − Specifies that there will be no authorization and no encryption
of packets sent between the Switch and a remote SNMP manager.
auth_nopriv − Specifies that authorization will be required, but there will be no
encryption of packets sent between the Switch and a remote SNMP manager.
auth_priv − Specifies that authorization will be required, and that packets sent
between the swtich and a remote SNMP manger will be encrypted.
− An alphanumeric string used to authorize a remote SNMP
manager to access the Switch’s SNMP agent.
Restrictions
Only administrator-level users can issue this command.
Example Usage:
To create an SNMP host to receive SNMP messages:
DES-3326S:4#create snmp host 10.48.74.100 v3 auth_priv public
Command: create snmp host 10.48.74.100 v3 auth_priv public
Success.
DES-3326S:4#
59
D-Link DES-3326S Layer 3 Switch CLI Reference
delete snmp host
Purpose
Used to remove a recipient of SNMP traps
generated by the Switch’s SNMP agent.
Syntax
delete snmp host
Description
The delete snmp host command deletes a
recipient of SNMP traps generated by the
Switch’s SNMP agent.
Parameters
− The IP address of a remote SNMP
manager that will receive SNMP traps
generated by the Switch’s SNMP agent.
Restrictions
Only administrator-level users can issue this
command.
Example Usage:
To delete an SNMP host entry:
DES-3326S:4#delete snmp host 10.48.74.100
Command: delete snmp host 10.48.74.100
Success.
DES-3326S:4#
60
D-Link DES-3326S Layer 3 Switch CLI Reference
show snmp host
Purpose
Used to display the recipient of SNMP traps
generated by the Switch’s SNMP agent.
Syntax
show snmp host {}
Description
The show snmp host command is used to
display the IP addresses and configuration
information of remote SNMP managers that are
designated as recipients of SNMP traps that are
generated by the Switch’s SNMP agent.
Parameters
− The IP address of a remote SNMP
manager that will receive SNMP traps
generated by the Switch’s SNMP agent.
Restrictions
Only administrator-level users can issue this
command.
Example Usage:
To display the currently configured SNMP hosts on the Switch:
DES-3326S:4#show snmp host
Command: show snmp host
SNMP Host Table
Host IP Address SNMP Version Community Name SNMPv3 User Name
--------------- --------------------- -------------------- -----------------------------
10.48.76.23 V2c private
10.48.74.100 V3 authpriv public
Total Entries: 2
DES-3326S:4#
61
D-Link DES-3326S Layer 3 Switch CLI Reference
enable rmon
Purpose
Used to enable RMON on the Switch.
Syntax
enable rmon
Description
This command is used, in conjunction with the
disable rmon command below, to enable and
disable remote monitoring (RMON) on the
Switch.
Parameters
none.
Restrictions
Only administrator-level users can issue this
command.
Example Usage:
To enable RMON:
DES-3326S:4#enable rmon
Command: enable rmon
Success.
DES-3326S:4#
62
D-Link DES-3326S Layer 3 Switch CLI Reference
disable rmon
Purpose
Used to disable RMON on the Switch.
Syntax
disable rmon
Description
This command is used, in conjunction with
the enable rmon command above, to
enable and disable remote monitoring
(RMON) on the Switch.
Parameters
none.
Restrictions
Only administrator-level users can issue
this command.
Example Usage:
To disable RMON:
DES-3326S:4#disable rmon
Command: disable rmon
Success.
DES-3326S:4#
63
D-Link DES-3326S Layer 3 Switch CLI Reference
ping
Purpose
Used to test the connectivity between network
devices.
Syntax
ping {times }
{timeout }
Description
This command sends Internet Control Message
Protocol (ICMP) echo messages to a remote IP
address. The remote IP address will then
“echo” or return the message. This is used to
confirm connectivity between the Switch and the
remote device.
Parameters
− the IP address of the remote device.
times − the number of individual
ICMP echo messages to be sent. The
maximum value is 255. The default is inifinite
times (pings are sent coninuosly).
timeout − defines the time-out
period while waiting for a response from the
remote device. A value of 1 to 99 seconds can
be specified. The default is 1 second.
Restrictions
Only administrator-level users can issue this
command.
Example Usage:
To send ICMP echo message to “10.48.74.121” for 4 times:
DES-3326S:4#ping 10.48.74.121 times 4
Command: ping 10.48.74.121
Reply from 10.48.74.121, time<10ms
Reply from 10.48.74.121, time<10ms
Reply from 10.48.74.121, time<10ms
Reply from 10.48.74.121, time<10ms
Ping Statistics for 10.48.74.121
Packets: Sent =4, Received =4, Lost =0
DES-3326S:4#
64
D-Link DES-3326S Layer 3 Switch CLI Reference
traceroute
Purpose
Used to determine the network path between
two devices.
Syntax
traceroute {ttl }
{port }
{timeout >}
{probe }
Description
This command allows you to trace a route
between the Switch and a give host on the
network.
Parameters
− the IP address of the remote device.
ttl − the time to live value of the
trace route request. This is the maximum
number of routers the traceroute command will
cross while seeking the network path between
two devices. The maximum value is
port − the port number.
Must be above 1024.
timeout defines the time-out
period while waiting for a response from the
remote device.
probe − the number of probing.
Restrictions
Only administrator-level users can issue this
command.
Example Usage:
Trace the routed path between the Switch and 10.48.74.121.
DES-3326S:4#traceroute 10.48.74.121 probe 3
Command: traceroute 10.48.74.121 probe 3
1 <10 ms. 10.48.74.121
1 <10 ms. 10.48.74.121
1 <10 ms. 10.48.74.121
DES-3326S:4#
65
D-Link DES-3326S Layer 3 Switch CLI Reference
8
MAC NOTIFICATION COMMANDS
Command
config
mac_notification
Parameters
ports |all
interval
historysize
enable
mac_notification
disable
mac_notification
show
mac_notification
{ports}
66
D-Link DES-3326S Layer 3 Switch CLI Reference
config mac_notification
Purpose
Used to configure MAC address notification.
Syntax
config mac_notification
ports |all
interval
historysize <1 - 500>
Description
MAC address notificiation is used to monitor
MAC addresses learned and entered into the
FDB.
Parameters
ports - specifies a range of ports to
be configured. The port list is specified by
listing the lowest Switch number and the
beginning port number on that Switch,
separated by a colon. Then highest Switch
number, and the highest port number of the
range (also separeted by a colon) are specified.
The beginning and end of the port list range are
seperated by a dash. For example, 1:3 would
specify Switch number 1, port 3. 2:4 specifies
Switch number 2, port 4. 1:3-2:4 specifies all of
the ports between Switch 1, port 3 and Switch 2,
port 4 − in numerical order.
all – to configure all ports for MAC notification.
interval - time in seconds
between notifications.
historysize <1 - 500> - maximum number of
entries listed in the history log used for
notification.
Restrictions
Only administrator-level users can issue this
command.
Example Usage:
To configure a 60 second interval for MAC address notification on unit 1 ports 6-9:
DES-3326S:4#config mac_notification ports 1:6-1:9 60
Command: config mac_notification ports 1:6-1:9 interval 60
Success.
DES-3326S:4#
67
D-Link DES-3326S Layer 3 Switch CLI Reference
enable mac_notification
Purpose
Used to globally enable MAC address
notification without changing the
mac_notification configuration.
Syntax
enable mac_notification
Description
Enables MAC notication on the Switch.
Parameters
none.
Restrictions
Only administrator-level users can issue this
command.
Example Usage:
To globally enable MAC notification:
DES-3326S:4#enable mac_notification
Command: enable mac_notification
Success.
DES-3326S:4#
disable mac_notification
Purpose
Used to disable MAC address notification
globally without changing mac_notification
configuration..
Syntax
disable mac_notification
Description
Disables MAC notication on the Switch.
Parameters
none.
Restrictions
Only administrator-level users can issue this
command.
Example Usage:
To globally disnable MAC notification:
DES-3326S:4#disable mac_notification
Command: disable mac_notification
Success.
DES-3326S:4#
68
D-Link DES-3326S Layer 3 Switch CLI Reference
show mac_notification
Purpose
Used to display MAC address notification.
Syntax
show mac_notification {ports}
Description
Displays MAC notification settings either per
port or globally as desired.
Parameters
none – this will display global MAC notification
settings currently configured including Interval,
History Size and State.
ports – this displays per ports MAC notification
settings.
Restrictions
Only administrator-level users can issue this
command.
Example usage:
To display global MAC notification settings:
DES-3326S:4#show mac_notification
Command: show mac_notification
Global Mac Notification Settings
State : Disabled
Interval : 1
History Size : 1
DES-3326S:4#
69
D-Link DES-3326S Layer 3 Switch CLI Reference
Example Usage:
To display per port MAC notification settings:
DES-3326S:4#show mac_notification ports
Command: show mac_notification ports
Port # MAC Address Table Notification State
------ ------------------ ----------- -------
1 Enabled
2 Enabled
3 Enabled
4 Enabled
5 Enabled
6 Enabled
7 Enabled
8 Enabled
9 Enabled
10 Enabled
11 Enabled
12 Enabled
13 Enabled
14 Enabled
15 Enabled
16
Enabled
17 Enabled
18 Enabled
19
Enabled
20
Enabled
CTRL+C ESC q Quit SPACE n Next Page p Previous Page r Refresh
70
D-Link DES-3326S Layer 3 Switch CLI Reference
9
DOWNLOAD/UPLOAD COMMANDS
The download|upload commands in the Command Line Interface (CLI) are listed (along with the appropriate
parameters) in the following table.
Command
Parameters
download
firmware
unit [all|]
configuration
{increment}
upload
configuration
log
Each command is listed, in detail, in the following sections.
71
D-Link DES-3326S Layer 3 Switch CLI Reference
download
Purpose
Used to download and install new firmware or a Switch
configuration file from a TFTP server.
Syntax
download [ firmware {unit
[all|]}|configuration
{increment}]
Description
This command is used to download a new firmware or a Switch
configuration file from a TFTP server.
Parameters
firmware − Download and install new firmware on the Switch from
a TFTP server.
configuration − Download a Switch configuration file from a TFTP
server.
− The IP address of the TFTP server.
− The DOS path and filename of the firmware or
Switch configuration file on the TFTP server. For example,
C:\3226S.had.
unit [all|] − all specifies all units (Switches), is the
unit id of the Switch that will receive the download.
increment − Allows the download of a partial Switch configuration
file. This allows a file to be downloaded that will change only the
Switch parameters explicitly stated in the configuration file. All
other Switch parameters will remain unchanged.
Restrictions
The TFTP server must be on the same IP subnet as the Switch.
Only administrator-level users can issue this command.
Example usage:
To download a configuration file:
DES-3326S:4#download configuration 10.48.74.121
c:\cfg\setting.txt
Command: download configuration 10.48.74.121 c:\cfg\setting.txt
Connecting to server................... Done.
Download configuration............. Done.
DES-3326S:4#
72
D-Link DES-3326S Layer 3 Switch CLI Reference
upload
Purpose
Used to upload the current Switch settings or
the Switch history log to a TFTP server.
Syntax
upload [configuration|log]
Description
This command is used to upload either the
Switch’s current settings or the Switch’s history
log to a TFTP server.
Parameters
configuration − Specifies that the Switch’s
current settings will be uploaded to the TFTP
server.
log − Specifies that the Switch history log will be
uploaded to the TFTP server.
− The IP address of the TFTP server.
The TFTP server must be on the same IP
subnet as the Switch.
− Specifies the location of the
Switch configuration file on the TFTP server.
This file will be replaced by the uploaded file
from the Switch.
Restrictions
The TFTP server must be on the same IP
subnet as the Switch. Only administrator-level
users can issue this command.
Example usage:
To upload a configuration file:
DES-3326S:4#upload configuration 10.48.74.121 c:\cfg\log.txt
Command: upload configuration 10.48.74.121 c:\cfg\log.txt
Connecting to server................... Done.
Upload configuration...................Done.
DES-3326S:4#
73
D-Link DES-3326S Layer 3 Switch CLI Reference
10
NETWORK MONITORING COMMANDS
The network monitoring commands in the Command Line Interface (CLI) are listed (along with the appropriate
parameters) in the following table.
Command
Parameters
show packet ports
show error ports
show utilitzation
clear counters
ports
clear log
show log
index
enable syslog
disable syslog
show syslog
create syslog host
all
severity
informational
warning
all
facility
local0
local1
local2
local3
local4
local5
local6
local7
udp_port
ipaddress
state [enable|disable]
config syslog host
all
severity
informational
warning
all
facility
local0
local1
local2
local3
local4
74
D-Link DES-3326S Layer 3 Switch CLI Reference
Command
Parameters
local5
local6
local7
udp_port
ipaddress
state [enable|disable]
delete syslog host
all
show syslog host
Each command is listed, in detail, in the following sections.
75
D-Link DES-3326S Layer 3 Switch CLI Reference
show packet ports
Purpose
Used to display statistics about the packets sent
and received by the Switch.
Syntax
show packet ports
Description
This command is used to display statistics about
packets sent and received by ports specified in
the port list.
Parameters
− specifies a range of ports to be
configured. The port list is specified by listing
the lowest Switch number and the beginning
port number on that Switch, separated by a
colon. Then highest Switch number, and the
highest port number of the range (also
separeted by a colon) are specified. The
beginning and end of the port list range are
seperated by a dash. For example, 1:3 would
specify Switch number 1, port 3. 2:4 specifies
Switch number 2, port 4. 1:3-2:4 specifies all of
the ports between Switch 1, port 3 and Switch 2,
port 4 − in numerical order.
Restrictions
None.
Example Usage:
To display the packets analysis for port 14:
DES-3326S:4#show packet port 14
Command: show packet ports 14
Port number : 14
Frame Size Frame Counts Frames/sec Frame Type Total Total/sec
------------ ------------ ---------- ---------- --------- ---------
64 254290 52 RX Bytes 41286744 17290
65-127 38129 12 RX Frames 359507 86
128-255 51878 13
256-511 8058 3 TX Bytes 72755 0
512-1023 2046 0 TX Frames 335 0
1024-1518 5441 6
Unicast RX 2245 0
Multicast RX 57480 20
Broadcast RX 299782 66
76
D-Link DES-3326S Layer 3 Switch CLI Reference
show error ports
Purpose
Used to display the error statistics for a range of
ports.
Syntax
show error ports
Description
This command will display all of the packet error
statistics collected and logged by the swtich for
a given port list.
Parameters
− Specifies a range of ports to be
configured. The port list is specified by listing
the lowest Switch number and the beginning
port number on that Switch, separated by a
colon. Then highest Switch number, and the
highest port number of the range (also
separated by a colon) are specified. The
beginning and end of the port list range are
separated by a dash. For example, 1:3 would
specify Switch number 1, port 3. 2:4 specifies
Switch number 2, port 4. 1:3-2:4 specifies all of
the ports between Switch 1, port 3 and Switch 2,
port 4 − in numerical order.
Restrictions
None.
Example Usage:
To display the error statistics of the port 3 of module 1:
DES-3326S:4#show errors port 1:3
RX Frames
TX Frames
---------------
----------------
CRC Error
0
Excessive Deferral 0
Undersize
0
CRC Error
0
Oversize
0
Late Collision
0
Fragment
0
Excessive Collision
0
Jabber 0
Single Collision 0
Drop Pkts
0
Collision
0
77
D-Link DES-3326S Layer 3 Switch CLI Reference
show utilization
Purpose
Used to display real-time port utilization
statistics.
Syntax
show utilization
Description
This command will display the real-time port
utilization statistics for the Switch.
Parameters
none.
Restrictions
none.
Example Usage:
To display the port utilization statistics:
DES-3326S:4#show utilization
Port TX/sec RX/sec Util Port TX/sec RX/sec Util
---- ---------- ---------- ---- ---- ---------- ---------- ----
1:1 0 0 0 1:22 0 0 0
1:2 0 0 0 1:23 0 0 0
1:3 0 0 0 1:24 0 0 0
1:4 0 0 0 1:25 0 0 0
1:5 0 0 0 1:26 19 49 1
1:6 0 0 0 2:1 0 0 0
1:7 0 0 0 2:2 0 0 0
1:8 0 0 0 2:3 0 0 0
1:9 0 0 0 2:4 0 0 0
1:10 0 0 0 2:5 0 0 0
1:11 0 0 0 2:6 0 0 0
1:12 0 0 0 2:7 0 30 1
1:13 0 0 0 2:8 0 0 0
1:14 0 0 0 2:9 30 0 1
1:15 0 0 0 2:10 0 0 0
1:16 0 0 0 2:11 0 0 0
1:17 0 0 0 2:12 0 0 0
1:18 0 0 0 2:13 0 0 0
1:19 0 0 0 2:14 0 0 0
1:20 0 0 0 2:15 0 0 0
1:21 0 0 0 2:16 0 0 0
78
D-Link DES-3326S Layer 3 Switch CLI Reference
clear counters
Purpose
Used to clear the Switch’s statistics counters.
Syntax
clear counters {ports }
Description
This command will clear the counters used by
the Switch to compile statistics.
Parameters
− Specifies a range of ports to be
configured. The port list is specified by listing
the lowest Switch number and the beginning
port number on that Switch, separated by a
colon. Then highest Switch number, and the
highest port number of the range (also
separated by a colon) are specified. The
beginning and end of the port list range are
separated by a dash. For example, 1:3 would
specify Switch number 1, port 3. 2:4 specifies
Switch number 2, port 4. 1:3-2:4 specifies all of
the ports between Switch 1, port 3 and Switch 2,
port 4 − in numerical order.
Restrictions
Only administrator-level users can issue this
command.
Example Usage:
To clear the counters:
DES-3326S:4#clear counters ports 2:7-2:9
Command: clear counters ports 2:7-2:9
Success.
79
D-Link DES-3326S Layer 3 Switch CLI Reference
clear log
Purpose
Used to clear the Switch’s history log.
Syntax
clear log
Description
This command will clear the Switch’s history log.
Parameters
none.
Restrictions
Only administrator-level users can issue this
command.
Example Usage:
To clear the log information:
DES-3326S:4#clear log
Command: clear log
Success.
DES-3326S:4#
80
D-Link DES-3326S Layer 3 Switch CLI Reference
show log
Purpose
Used to display the Switch history log.
Syntax
show log {index }
Description
This command will display the contents of the
Switch’s history log.
Parameters
index − The show log command will
display the history log until the log number
reaches this value.
Restrictions
None.
Example Usage:
To display the Switch history log:
DES-3326S:4#show log
Command: show log
Index Time Log Text
----- ------------------- ----------------------------------------------------
75 00000 days 01:17:05 Successful login through Telnet (Username: Anonymous)
74 00000 days 01:02:56 Successful login through Console (Username: Anonymou s)
73 00000 days 01:01:49 Successful login through Web (Username: Anonymous)
72 00000 days 01:01:22 Port 4 link up, 100Mbps FULL duplex
71 00000 days 00:45:55 Internal Power is recovered
70 00000 days 00:43:58 Internal Power failed
69 00000 days 00:19:37 Console session timed out (Username: Anonymous)
68 00000 days 00:07:43 Redundant Power is working
67 00000 days 00:05:37 Successful login through Console (Username: Anonymous)
66 00000 days 00:04:20 Logout through Console (Username: Anonymous)
65 00000 days 00:04:11 Successful login through Console (Username: Anonymous)
64 00000 days 00:00:01 System started up
63 00000 days 00:00:01 Spanning Tree Protocol is disabled
62 00000 days 00:06:19 Spanning Tree Protocol is disabled
61 00000 days 00:06:16 Configuration saved to flash (Username: Anonymous)
CTRL+C ESC q Quit SPACE n Next Page ENTER Next Entry a All
81
D-Link DES-3326S Layer 3 Switch CLI Reference
enable syslog
Purpose
Used to enable the system log to be sent to a
remote host.
Syntax
enable syslog
Description
The enable syslog command enables the
system log to be sent to a remote host.
Parameters
None.
Restrictions
Only administrator-level users can issue this
command.
Example Usage:
To enable the syslog function on the Switch:
DES-3326S:4#enable syslog
Command: enable syslog
Success.
DES-3326S:4#
82
D-Link DES-3326S Layer 3 Switch CLI Reference
disable syslog
Purpose
Used to enable the system log to be sent to a
remote host.
Syntax
disable syslog
Description
The disable syslog command disables the
system log to be sent to a remote host.
Parameters
None.
Restrictions
Only administrator-level users can issue this
command.
Example Usage:
To disable the syslog function on the swtich:
DES-3326S:4#disable syslog
Command: disable syslog
Success.
DES-3326S:4#
83
D-Link DES-3326S Layer 3 Switch CLI Reference
show syslog
Purpose
Used to display the syslog protocol status as
enable or disabled.
Syntax
show syslog
Description
The show syslog command displays the syslog
status as enabled or disabled.
Parameters
None.
Restrictions
None.
Example Usage:
To display the current status of the syslog function:
DES-3326S:4#show syslog
Command: show syslog
Syslog Global State: Enabled
DES-3326S:4#
84
D-Link DES-3326S Layer 3 Switch CLI Reference
create syslog host
Purpose
Used to create a new syslog host.
Syntax
config syslog host [all|] {severity [informational|warning|all]|
facility[local0|local1|local2|local3|
local4|local5|local6|local7]|udp_port| ipaddress |
state[enable|disable]
Description
The create syslog host command is used to create a new syslog host.
Parameters
all − Specifies that the command will be applied to all hosts.
− Specifies that the command will be applied to an index of hosts.
There are four available indexes, numbered 1 through 4.
severity − Severity level indicator. These are described in the following:
Bold font indicates that the corresponding severity level is currently supported
on the Switch.
Numerical Severity
Code
0 Emergency: system is unusable
1 Alert: action must be taken immediately
2 Critical: critical conditions
3 Error: error conditions
4 Warning: warning conditions
5 Notice: normal but significant condition
6 Informational: informational messages
7 Debug: debug-level messages
informational − Specifies that informational messages will be sent to the
remote host. This corresponds to number 6 from the list above.
warning − Specifies that warning messages will be sent to the remote host.
This corresponds to number 4 from the list above.
all − Specifies that all of the currently supported syslog messages that are
generated by the Switch will be sent to the remote host.
facility − Some of the operating system daemons and processes have been
assigned Facility values. Processes and daemons that have not been
explicitly assigned a Facility may use any of the"local use" facilities or they
may use the "user-level" Facility. Those Facilities that have been designated
are shown in the following: Bold font indicates the facility values that the
Switch currently supports.
85
D-Link DES-3326S Layer 3 Switch CLI Reference
create syslog host
Parameters
Numerical Facility
Code
0 kernel messages
1 user-level messages
2 mail system
3 system daemons
4 security|authorization messages
5 messages generated internally by syslog
6 line printer subsystem
7 network news subsystem
8 UUCP subsystem
9 clock daemon
10 security|authorization messages
11 FTP daemon
12 NTP subsystem
13 log audit
14 log alert
15 clock daemon
16 local use 0 (local0)
17 local use 1 (local1)
18 local use 2 (local2)
19 local use 3 (local3)
20 local use 4 (local4)
21 local use 5 (local5)
22 local use 6 (local6)
23 local use 7 (local7)
86
D-Link DES-3326S Layer 3 Switch CLI Reference
create syslog host
Parameters
local0 − Specifies that local use 0 messages will be sent to the remote host.
This corresponds to number 16 from the list above.
local1 − Specifies that local use 1 messages will be sent to the remote host.
This corresponds to number 17 from the list above.
local2 − Specifies that local use 2 messages will be sent to the remote host.
This corresponds to number 18 from the list above.
local3 − Specifies that local use 3 messages will be sent to the remote host.
This corresponds to number 19 from the list above.
local4 − Specifies that local use 4 messages will be sent to the remote host.
This corresponds to number 20 from the list above.
local5 − Specifies that local use 5 messages will be sent to the remote host.
This corresponds to number 21 from the list above.
local6 − Specifies that local use 6 messages will be sent to the remote host.
This corresponds to number 22 from the list above.
local7 − Specifies that local use 7 messages will be sent to the remote host.
This corresponds to number 23 from the list above.
udp_port − Specifies the UDP port number that the syslog protocol will
use to send messages to the remote host.
ipaddress − Specifies the IP address of the remote host where
syslog messages will be sent.
state [enable|disable] − Allows the sending of syslog messages to the remote
host, specified above, to be enabled and disabled.
Restrictions
Only administrator-level users can issue this command.
Example Usage:
To create syslog host:
DES-3326S:4#create syslog host 1 severity all facility local0
Command: create syslog host 1 severity all facility local0
Success.
DES-3326S:4#
87
D-Link DES-3326S Layer 3 Switch CLI Reference
config syslog host
Purpose
Used to configure the syslog protocol to send system log data to a remote
host.
Syntax
config syslog host [all|] {severity [informational|warning|all]|
facility[local0|local1|local2|local3|
local4|local5|local6|local7]|udp_port| ipaddress |
state[enable|disable]
Description
The config syslog host command is used to configure the syslog protocol to
send system log information to a remote host.
Parameters
all − Specifies that the command will be applied to all hosts.
− Specifies that the command will be applied to an index of hosts.
There are four available indexes, numbered 1 through 4.
severity − Severity level indicator. These are described in the following:
Bold font indicates that the corresponding severity level is currently supported
on the Switch.
Numerical Severity
Code
0 Emergency: system is unusable
1 Alert: action must be taken immediately
2 Critical: critical conditions
3 Error: error conditions
4 Warning: warning conditions
5 Notice: normal but significant condition
6 Informational: informational messages
7 Debug: debug-level messages
88
D-Link DES-3326S Layer 3 Switch CLI Reference
config syslog host
Parameters
informational − Specifies that informational messages will be sent to the
remote host. This corresponds to number 6 from the list above.
warning − Specifies that warning messages will be sent to the remote host.
This corresponds to number 4 from the list above.
all − Specifies that all of the currently supported syslog messages that are
generated by the Switch will be sent to the remote host.
facility − Some of the operating system daemons and processes have been
assigned Facility values. Processes and daemons that have not been
explicitly assigned a Facility may use any of the"local use" facilities or they
may use the "user-level" Facility. Those Facilities that have been designated
are shown in the following: Bold font indicates that the facility values the
Switch currently supports.
Numerical Facility
Code
0 kernel messages
1 user-level messages
2 mail system
3 system daemons
4 security|authorization messages
5 messages generated internally by syslog
6 line printer subsystem
7 network news subsystem
8 UUCP subsystem
9 clock daemon
10 security|authorization messages
11 FTP daemon
12 NTP subsystem
13 log audit
14 log alert
15 clock daemon
89
D-Link DES-3326S Layer 3 Switch CLI Reference
config syslog host
Parameters
Parameters
16 local use 0 (local0)
17 local use 1 (local1)
18 local use 2 (local2)
19 local use 3 (local3)
20 local use 4 (local4)
21 local use 5 (local5)
22 local use 6 (local6)
23 local use 7 (local7)
local0 − Specifies that local use 0 messages will be sent to the remote host.
This corresponds to number 16 from the list above.
local1 − Specifies that local use 1 messages will be sent to the remote host.
This corresponds to number 17 from the list above.
local2 − Specifies that local use 2 messages will be sent to the remote host.
This corresponds to number 18 from the list above.
local3 − Specifies that local use 3 messages will be sent to the remote host.
This corresponds to number 19 from the list above.
local4 − Specifies that local use 4 messages will be sent to the remote host.
This corresponds to number 20 from the list above.
local5 − Specifies that local use 5 messages will be sent to the remote host.
This corresponds to number 21 from the list above.
local6 − Specifies that local use 6 messages will be sent to the remote host.
This corresponds to number 22 from the list above.
local7 − Specifies that local use 7 messages will be sent to the remote host.
This corresponds to number 23 from the list above.
udp_port − Specifies the UDP port number that the syslog protocol will
use to send messages to the remote host.
ipaddress − Specifies the IP address of the remote host where
syslog messages will be sent.
state [enable|disable] − Allows the sending of syslog messages to the remote
host, specified above, to be enabled and disabled.
Restrictions
Only administrator-level users can issue this command.
Example Usage:
To create syslog host:
DES-3326S:4#config syslog host all severity all facility local0
Command: config syslog host all severity all facility local0
Success.
DES-3326S:4#
90
D-Link DES-3326S Layer 3 Switch CLI Reference
delete syslog host
Purpose
Used to remove a syslog host, that has been
previously configured, from the Switch.
Syntax
delete syslog host [|all]
Description
The delete syslog host command is used to
remove a syslog host, that has been previously
configured, from the Switch.
Parameters
− Specifies that the command will
be applied to an index of hosts. There are four
available indexes, numbered 1 through 4.
all − Specifies that the command will be applied
to all hosts.
Restrictions
Only administrator-level users can issue this
command.
Example Usage:
To delete a previously configured syslog host:
DES-3326S:4#delete syslog host 4
Command: delete syslog host 4
Success.
DES-3326S:4#
91
D-Link DES-3326S Layer 3 Switch CLI Reference
show syslog host
Purpose
Used to display the syslog hosts currently
configured on the Switch.
Syntax
show syslog host {}
Description
The show syslog host command is used to
display the syslog hosts that are currently
configured on the Switch.
Parameters
− Specifies that the command will
be applied to an index of hosts. There are four
available indexes, numbered 1 through 4.
Restrictions
None.
Example Usage:
To show Syslog host information:
DES-3326S:4#show syslog host
Command: show syslog host
Syslog Global State: Disabled
Host Id Host IP Address Severiry Facility UDP port Status
------- --------------- -------------- -------- -------- --------
1 10.1.1.2 All Local0 514 Disabled
2 10.40.2.3 All Local0 514 Disabled
3 10.21.13.1 All Local0 514 Disabled
Total Entries : 3
DES-3326S:4#
92
D-Link DES-3326S Layer 3 Switch CLI Reference
11
SPANNING TREE COMMANDS
The Switch supports 802.1w Rapid STP and 802.1d STP. The spanning tree commands in the Command Line
Interface (CLI) are listed (along with the appropriate parameters) in the following table.
Command
Parameters
config stp
maxage
hellotime
forwarddelay
priority
fdpdu [enable|disable]
txholdcount <1-10>
version [rstp|stp]
config stp ports
cost
priority
migrate [yes|no]
edge [true|false]
p2p [true|false|auto]
state [enable|disable]
enable stp
disable stp
show stp
show stp ports
Each command is listed, in detail, in the following sections.
93
D-Link DES-3326S Layer 3 Switch CLI Reference
config stp
Purpose
Used to setup STP and RSTP on the Switch.
Syntax
config stp {maxage |hellotime |forwarddelay
|priority |fbpdu [enable|disable]| txholdcount <1-10>|
version[rstp|stp]}
Description
This command is used to setup the Spanning Tree Protocol for the entire
Switch. By default, the Switch is uses Rapid Spanning Tree Protocl (RSTP)
when it is enabled. The default settings for the Switch have Spanning Tree
Protocol disabled (see enable/disable stp commands).
Parameters
maxage − The maximum amount of time (in seconds) that the Switch
will wait to receive a BPDU packet before reconfiguring STP. The default is 20
seconds.
hellotime − The time interval between transmission of configuration
messages by the root device. The default is 2 seconds.
forwarddelay − The maximum amount of time (in seconds) that the
root device will wait before changing states. The default is 15 seconds.
priority − A numerical value between 0 and 61440 that is used in
determining the root device, root port, and designated port. The device with
the highest priority becomes the root device. The lower the numerical value,
the higher the priority. The default is 32,768.
fbpdu [enable|disable] − Allows the forwarding of STP BPDU packets from
other network devices when STP is disabled on the Switch. The default is
enabled.
txholdcount <1-10> - the maximum number of Hello packets transmitted per
interval. Default value = 3.
version [rstp|stp] - select the Spanning Tree Protocol version used for the
Switch. For IEEE 802.1d STP select stp. Select rstp for IEEE 802.1w Rapid
STP.
Restrictions
Only administrator-level users can issue this command.
Example usage:
To configure STP with maxage 18 and hellotime 4:
DES-3326S:4#config stp maxage 18 hellotime 4
Command: config stp maxage 18 hellotime 4
Success.
DES-3326S:4#
94