GDI HES7000 User manual

HES7000
ICLI USER’S GUIDE
A01583 Rev. A

Page 2of 37 HES7000 ICLI User’s Guide A01583 Rev. A
GDI COMMUNICATIONS, LLC
897 Deming Way
Sparks, Nevada 89431
Phone: [phone]
FAX: [phone]
www.sgdi.com
Proprietary Data
This document contains confidential, proprietary
data with all rights and titles reserved by
GDI Communications LLC. By accepting this
document, the recipient assumes custody hereof
and agrees not to dislcose this data or any portion
of this data to any unauthorized person without
the prior written consent of GDI Communications
LLC. Recipient further agrees not to incorporate
these drawings, specifications or technical
information, in whole or in part, in any other
product or endeavor.
THIS LEGEND SHALL BE INCLUDED ON
ANY REPRODUCTION OF THIS DOCUMENT

HES7000 ICLI User’s Guide A01583 Rev. A

HES7000 ICLI User’s Guide A01583 Rev. A
Table of Contents
1. Introduction ..................................................................1
1.1. Front Panel Connectors, Indicators, and switches: ......................1
1.1. Using this guide: ..........................................................................1
2. Quick Start ....................................................................2
2.1. Log In and Reset Configuration to Factory Defaults .....................2
2.2. Set Device Hostname and admin User Password..........................2
2.3. Set VLAN 1 IP Address .................................................................3
2.4. Display and Save Configuration to FLASH ....................................4
3. ICLI Basics ....................................................................6
3.1. The ICLI has some key characteristics: ........................................6
3.2. Command Structure and Syntax...................................................6
3.2.1. Syntax 7
3.3. Ethernet Interface Naming ..........................................................9
3.4. Using the Keyboard....................................................................10
3.4.1. Basic Line Editing ................................................................................................. 10
3.4.2. Command History ................................................................................................ 11
3.4.3. Context-sensitive Help .......................................................................................... 11
3.4.4. Other Special Keys ............................................................................................... 13
3.5. Filtering Output..........................................................................14
3.6. Understanding Modes and Sub-modes .......................................15
3.6.1. ICLI Mode Transitions ........................................................................................... 17
3.7. Understanding Privilege Levels ..................................................19
3.8. Understanding Terminal Parameters..........................................20
3.8.1. Using Banners ..................................................................................................... 22
4. Configuring the System ...............................................24
4.1. Resetting or Removing Configuration with “no”.........................25

Page 2of 37 HES7000 ICLI User’s Guide A01583 Rev. A
5. Managing Users...........................................................26
6. Using show Commands................................................28
6.1. show running-config ..................................................................31
6.1.1. show running-config [ all-defaults ] ........................................................................ 32
6.1.2. show running-config feature feature_name [ all- defaults ] ........................................ 32
6.1.3. show running-config interface list [ all-defaults ]...................................................... 32
6.1.4. show running-config vlan list [ all-defaults ] ............................................................ 32
6.1.5. show running-config interface vlan list [ all-defaults ] ............................................... 33
6.1.6. show running-config line { console | vty } list [ all- defaults ].................................... 33
7. Working with Configuration Files ................................34
7.1. Reverting to Default Configuration ............................................35
8. Working with Software Images...................................37

HES7000 ICLI User’s Guide A01583 Rev. A Page 1of 37
1.Introduction
1.1.Front Panel Connectors, Indicators, and switches:
1.1.Using this guide:
This User Guide describes basic usage and configuration of the Industrial Command Line
Interface (ICLI). The ICLI is a fully comprehensive, industrial class management interface on
the device, and the only management interface accessible on the serial console. That is to
say even if there is no network connectivity the device can still be managed using a serial
connection.
The style used within this document shows user input written in bold:
# show version
Terminal input/output is in the format shownbelow.
MEMORY : Total=86382 KBytes, Free=70497 KBytes, Max=70496 KBytes
FLASH : 0x40000000-0x40ffffff, 64 x 0x40000 blocks
MAC Address : 00-50-c2-0f-00-20
Previous Restart : Cold

Page 2of 37 HES7000 ICLI User’s Guide A01583 Rev. A
2.Quick Start
This section will help the user perform thefollowing:
Log in and reset configuration to factory defaults
Set device hostname and admin user password
Set VLAN 1 IP address
Verify connectivity using ‘ping’
Display the current configuration and save it to FLASH storage
The following assumes the device is powered on and its console port is connected to an
RS323 communications port on a computer.
The computer must be running a terminal emulator such as TeraTerm or PuTTYon
Windows, or Minicom onLinux set to the following configuration:
115200 baud, No parity,8
data bits, 1 stop bit, no flowcontrol
2.1.Log In and Reset Configuration to Factory Defaults
Press <Enter> one or more times until the Username: prompt appears. Type admin and
press <Enter>. At the “Password:” prompt, press <Enter> as there is nopassword required.
This completes the login sequence and displays the prompt,‘#’.
Username: admin
Password:
#
At this point the admin user is operating at the highest privilege level, level15.
This implies
full control over the device and its configuration, and it istherefore possible to reset the
configuration to factory defaults.
Type reload defaults and then press <Enter>. When the prompt returns the system has
reverted to factory defaultsas shown below.
# reload defaults
% Reloading defaults. Please standby.
#
2.2.Set Device Hostname and admin User Password
The ICLI has several different modes. The current mode is called exec mode;it allows the
user to perform operations related to configuration files,reloading defaults, displaying system
information, etc., but it does not allow the userto change detailed configuration items. Such
operations are performed while inthe configuration mode.
To set the hostname, first change the ICLI mode to configuration. Type configure terminal
then press <Enter>, then type hostname myDevice <Enter>,where myDevice is a suitable
name for the unit. Finally type exit <Enter>.The sequence should appear as shownhere.
# configure terminal
(config)# hostname myDevice
myDevice(config)# exit
myDevice#
The commands are executed immediately, so ‘hostname’ changes thedevice
hostname right
away. This is reflected in the prompt aswell.

HES7000 ICLI User’s Guide A01583 Rev. A Page 3of 37
To set the admin password perform the following:
myDevice# configure terminal
myDevice(config)# username admin privilege 15 password unencrypted very-secret
myDevice(config)# exit
myDevice#
The user, admin, now has the password “very-secret”. Other users can be addedin
similar
fashion.
2.3.Set VLAN 1 IP Address
The objective is to assign an IP address to the device on VLAN 1. This isoften sufficient for
small local area networks that use Dynamic HostConfiguration Protocol, DHCP, or static IP
addressallocation.
A DHCP client function has been implemented in the device that, once enabled, will send out
requests for IP address configuration. Those requests are received by a DHCP server on
the network (if present and appropriately configured). The DHCP server will thensearch
through its pool of available IP addresses, allocate one and return it to theDHCP client. The
returned information includes IP address, netmask and defaultgateway, but may also
contain other information such as Domain Name Service server addresses.
The configuration proceeds in the same manner as setting the hostname:Enter
configuration
mode, input and execute configuration commands,leave configuration mode. The following
commands instruct the device to use DHCPto obtain an IP address but if DHCP fails, use a
static “fallback”IP address. Inclusionof a fallback IP is optional and may beomitted.
myDevice# configure terminal
myDevice(config)# interface vlan 1
myDevice(config-if-vlan)# ip address dhcp fallback 172.16.1.2 255.255.0.0
myDevice(config-if-vlan)# exit
myDevice(config)#
Notice how the prompt changes; the interface vlan 1 command entersa
configuration sub-
mode that allows, among other things, configuration ofIP address.
NOTE that IP addresses can only be assigned to VLAN interfaces.
After configuration is complete the resulting IP address can be inspected. Asseen
below,
the DHCP negotiation succeeded and the device obtained an IP address:
myDevice# show ip interface brief
Vlan Address Method Status
---- -------------------- -------- ------
1 172.16.1.17/16 DHCPUP
myDevice#
show ip interface brief displays all configured and active IP interfaces. The
status should
be UP. If it isn’t then the reason could be that there is no link onany port.
If DHCP negotiation had failed then the fallback IP of172.16.1.2/255.255.0.0
would be
assigned.

Page 4of 37 HES7000 ICLI User’s Guide A01583 Rev. A
The most basic system configuration is now complete. Connectivity to the network can be
verified by issuing a ping command to a known IP address:
myDevice# ping ip 172.16.1.1
PING server 172.16.1.1, 56 bytes of data.
64 bytes from 172.16.1.1: icmp_seq=0, time=0ms
64 bytes from 172.16.1.1: icmp_seq=1, time=0ms
64 bytes from 172.16.1.1: icmp_seq=2, time=0ms
64 bytes from 172.16.1.1: icmp_seq=3, time=0ms
64 bytes from 172.16.1.1: icmp_seq=4, time=0ms Sent 5 packets, received 5 OK, 0 bad
myDevice#
If the ping is successful, network logins can now be performed via telnet or sshto the
address on VLAN interface 1, 172.16.1.17 (or172.16.1.2).
2.4.Display and Save Configuration to FLASH
The current configuration of the device can be displayed in the form of a virtualfile containing
the full set of commands necessary to create an identicalconfiguration. A few exceptions
exist since certain items are not displayed, such as privateSSH keys.
This virtual file is called running-config and is volatile by nature; it does not survive across
reboots. It is therefore necessary to save the file to FLASHstorage under the name startup-
config, as this file is read and executed upon every bootto restore the running configuration
of the system to the state it had when the saving took place.
The command show running-config will display the configuration settingsas
seen below.
For brevity some details were edited out. Note that the set of interfacesis dependent on
hardware capabilities.
myDevice# show running-config
Building configuration...
hostname myDevice
username admin privilege 15 password none
!
vlan 1
!
spanning-tree mst name 00-01-c1-00-8b-70 revision 0
snmp-server contact Extreme Copper Inc.
voice vlan oui 00-01-E3 description Siemens AG phones
network-clock wait-to-restore 5
!
…
interface GigabitEthernet 1/1
!
interface vlan 1
…
ip address dhcp
!
spanning-tree aggregation
spanning-tree link-type point-to-point
!
!
line console 0
!
line vty 0
!
end
myDevice#
Lines that begin with ‘!’ are comments. The file begins with thehostname command and the
password for the admin user, followed by VLANs 1 and 42and other items, such as
Spanning Tree Protocol (STP). A list of all port interfaceson the device, ordered by switch
ID, type and port number comesnext.