xStack
®
DGS-3400 Series Layer 2 Gigabit Ethernet Managed Switch CLI Manual
2
U SING THE C ONSOLE CLI
The Switch 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 SNMPbased 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
•
115200 baud
•
8 data bits
•
No parity
•
One stop bit
No flow control
Users can also access the same functions over a Telnet interface. Once an IP address has been set for the Switch, users 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.
After the Switch reboots and you have logged in, the console looks like this:
UserName:
PassWord:
DGS-3450:admin# _
DGS-3450 Gigabit Ethernet Switch
Command Line Interface
Firmware: Build 2.70.B56
Copyright(C) 2010 D-Link Corporation. All rights reserved.
Figure 2- 1. Initial Console Screen after logging in
Commands are entered at the command prompt, DGS-3450:admin# .
There are a number of helpful features included in the CLI. Entering the ?
command will display a list of all of the toplevel commands.
3
xStack
®
DGS-3400 Series Layer 2 Gigabit Ethernet Managed Switch CLI Manual
DGS-3450:admin# ?
Command: ?
..
? cable_diag ports clear clear address_binding dhcp_snoop binding_entry ports clear address_binding nd_snoop binding_entry ports clear arptable clear attack_log clear counters clear dhcp_binding clear dhcpv6 binding clear fdb clear igmp_snooping date_driven_group clear jwac auth_state clear log clear mac_based_access_control auth_state clear mld_snooping data_driven_group clear port_security_entry port clear wac auth_state config 802.1p default_priority config 802.1p user_priority config 802.1x auth_failoverCTRL+C ESC q Quit SPACE n Next Page Enter Next Entry a All
Figure 2- 2. The ? Command
When users enter a command without its required parameters, the CLI will prompt a Next possible completions: message.
DGS-3450:admin# config account
Command: config account
Next possible completions:
<username>
DGS-3450:admin#
Figure 2- 3. Example Command Parameter Help
In this case, the command config account was entered with the parameter <username> . The CLI will then prompt to enter the <username> 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, all of the next possible sub-commands can be seen, 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.
4
xStack
®
DGS-3400 Series Layer 2 Gigabit Ethernet Managed Switch CLI Manual
DGS-3450:admin# config account
Command: config account
Next possible completions:
<username>
DGS-3450:admin# config account
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 <username> , the CLI returned the Next possible completions: <username> prompt. The up arrow cursor control key was pressed to reenter the previous command ( config account ) at the command prompt. Now the appropriate username can be entered and the config account command re-executed.
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.
DGS-3450:admin# the
Available commands:
.. ? cable_diag clear config create debug delete disable download enable login logout no ping ping6 reboot reconfig reset save show telnet traceroute traceroute6 upload
DGS-3450:admin#
Figure 2- 5. Available Commands
The top-level commands consist of commands such as 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 create command with no additional parameters, the CLI will then display all of the possible next parameters.
5
xStack
®
DGS-3400 Series Layer 2 Gigabit Ethernet Managed Switch CLI Manual
DGS-3450:admin# create
Command: create
Next possible completions:
802.1x access_profile account address_binding arpentry authen authen_enable authen_login authentication cpu dhcp dhcpv6 dot1v_protocol_group double_vlan erps fdb host_name igmp_snooping ip_tunnel ipif ipmc_vlan_replication_entry iproute ipv6 ipv6route jwac link_aggregation mac_based_access_control mac_based_access_control_local mac_based_vlan mirror multicast_fdb nlb route rspan sflow snmp stp subnet_vlan syslog trusted_host vlan vlan_translation wac
DGS-3450:admin#
Figure 2- 6. Next possible completions: Create command
In the above example, all of the possible next parameters for the create command are displayed.
6
