Table of Contents About This Manual ..........................4 Understanding the Command Line Interface ..................5 Accessing the Switch ..........................5 Logging in using the RS-232 Console ....................5 Logging in using Telnet ........................8 Command Modes ..........................11 Basic Configuration ........................11 Understanding All Command Modes ....................
1. About This Manual This manual describes how to use the command line to configure Moxa’s layer 3 managed Ethernet switches. Both the web interface configuration utility and command line interface help system administrators easily and quickly manage, monitor, and configure Moxa’s managed Ethernet switch. Moxa Managed Switch Next-generation OS (v3.x) Layer 3 Command Line Interface...
2. Understanding the Command Line Interface This chapter helps users understand the command line interface by giving a general overall introduction to the command line operations. Accessing the Switch Users can connect to the switch using one of two methods: by console or by Telnet. Logging in using the RS-232 Console The Moxa managed switch features an RJ45 serial console port to allow users to connect to the switch and configure settings.
Page 6
In Windows, click Start > Moxa > PComm Terminal Emulator. Click Port Manager > Open to establish a new connection. The Property window will appear. Moxa Managed Switch Next-generation OS (v3.x) Layer 3 Command Line Interface...
Page 7
On the Communication Parameter tab, select the COM port that will be used for the console connection. Configure the fields as follows: 115200 for Baud rate, 8 for Data bits, None for Parity, and 1 for Stop bits. On the Terminal tab, select VT100 as the Terminal Type, and click OK to continue. Moxa Managed Switch Next-generation OS (v3.x) Layer 3 Command Line Interface...
Log in to the console using the default login name admin and password moxa. This password will be required to access any of the consoles (web, serial, Telnet). When successfully connected to the switch, you can start configuring the switch parameters by using command line instructions.
Page 9
After making sure that the Moxa switch is connected to the same LAN and logical subnet as your PC, open the Moxa switch’s Telnet console as follows: In Windows, click Start > Run. In the Windows Run window, enter telnet followed by the Moxa switch’s IP address (192.168.127.253). You can also issue the Telnet command from a DOS prompt.
Page 10
Log in to the Telnet console using the default login name admin and password moxa. This password will be required to access any of the consoles (web, serial, Telnet). When successfully connected to the switch, you can start configuring the switch parameters by using command line instructions.
Command Modes Basic Configuration The CLI (Command Line Interface) for Moxa’s Managed switches can be accessed through either the serial console or the Telnet console. For either type of connection, access to the CLI is generally referred to as an EXEC session.
Refer to the following example of changing configuration modes below. Type config at the command prompt to enter configuration mode. Type exit to return to the previous configuration mode. Type end from within any configuration level to return to privileged Exec mode. Help Messages The CLI supports several types of interactive commands.
Special Usage and Limitations If the command contains any special characters, such as *, #, and %, you need to enclose the command in quotation marks (“”), as shown below. In addition, you may use a semicolon mark (;) to separate several commands. Refer to the figure below for an example.
In addition, when pressing Tab after typing the prefix letter, the syntax of the commands starting with that letter will be shown. See the figure below for details. No and Default Forms of Commands A “no” command can be used to perform the “delete”, “disable”, or “reset to default” functions. Type “no ?” to check how parameters can be used.
The following example shows how a “no” command can run the “reset to default” function. The following example shows how “no” can run the “disable” function. CLI Error Messages You may encounter some error messages while configuring Moxa’s Ethernet switch. Refer the following table for an overview of error messages and solutions.
3. Commands This chapter covers all layer 3 function commands that can be used to configure Moxa’s layer 3 managed Ethernet switches. Layer 3 Routing Static Route Create/Delete the Static Route Entry Commands ip route <prefix> <mask> {<next-hop> [<distance (1-255)>] | vlan <vlan-id> [<distance (1-255)>] [next-hop] } no ip route <prefix>...
Display the Existing ARP Entry List Commands show ip arp Syntax Description show Display configuration/statistics/general/information IP related information ARP related information Defaults Command Modes Privileged EXEC/ User EXEC Usage Guidelines Examples moxa# show ip arp IP Address MAC Address Interface --------------- ----------------- ---------- 192.168.127.95 00:19:cb:d6:db:b4 vlan1 Error Messages...
Page 18
Configure Interface Alias Description Commands description <string(63)> no description Syntax Description Remove configuration/delete entry/reset to default value description Set the mnemonic name of this interface <string(63)> The specific mnemonic name for the interface Defaults Command Modes Interface Configuration Mode Usage Guidelines Examples moxa(config)# interface 10 moxa(config-if)# description “Switch interface 10”...
Page 19
Configure the IPv4 Address for the Interface Commands ip address <ip-address> <subnet-mask> no ip address <ip-address> Syntax Description Remove configuration/delete entry/reset to default value ip address Configure the interface IPv4 address <ip-address> IPv4 address string <subnet-mask> Should be 255.255.255.255. Defaults Command Modes Interface Configuration Mode Usage Guidelines...
Page 20
Configure Interface MTU Commands ip mtu <mtu size> Syntax Description Configure IP related configuration Maximum transmission unit mtu size The size of the allowable MTU in bytes; the legitimate range is 1400 to 3000. Defaults Command Modes Interface VLAN Configuration Mode Usage Guidelines Examples moxa(config)# interface vlan 10...
Show ARP Status for the Existing Interfaces Commands show ip proxy-arp Syntax Description show Display configuration/statistics/general information IP related configuration proxy-arp Proxy-arp status Defaults Command Modes Privileged EXEC/ User EXEC Usage Guidelines Examples moxa# show ip proxy-arp PROXY Status ------------------------------- vlan1 : Disabled vlan2...
Page 22
Activate/Deactivate the Debug Function After System Reboots Commands debug system startup no debug system startup Syntax Description Disable the configuration/delete the entry/reset to default value debug Debugging information system Switch system internal startup System startup Defaults Disable Command Modes Global Configuration Mode Usage Guidelines Examples moxa# configure terminal...
Page 23
Configure the Debug Level Settings Commands debug level global { level } Syntax Description debug Debugging information level The intended level for debug messages; level "debug" will display the most sophisticated information, while level "emergency" only prints out the most imminent urgent messages, which needs administrator's immediate involvement.
Page 24
Configure the Debug Burst Settings Commands debug burst no debug burst Syntax Description Unlimited number of debug messages debug Debugging information burst Burst limitation Defaults 50 messages in 3 seconds Command Modes Privileged EXEC Usage Guidelines If the output debug messages exceed the burst limit, the run-time debug mechanism will immediately be stopped, and event log will have the message “Warning! Disabling the burst limitation could seriously impact system performance”...
Page 25
Configure the Debug Burst Period Settings Commands debug burst period <integer (1-10)> Syntax debug Debugging information Description burst The burst limitation period The burst period <integer> The allowable range is 1 to 10 Defaults 50 messages in 3 seconds Command Modes Privileged EXEC Usage Guidelines Examples...
Page 26
Configure the Debug Destination Size Settings Commands debug destination { file | ram} size <integer 1-10> Syntax Description debug Debugging information destination Destination file File in local non-volatile storage RAM disk or volatile memory size Maximum capacity of the reserved storage. Once the capacity is exceeded, the latest logs will overwrite the oldest 1Mb records.
Page 27
Display Global Settings for Debug Functions Commands show debug module global Syntax Description show Display configuration/statistics/general information debug Display debugging information module Module global Global configuration Defaults Command Modes Privileged EXEC Usage Guidelines Examples moxa# show debug module global Status: Started Configure to Start Debug Log on System Startup: Yes Level: Notice Burst Limitation: Disabled...
Page 28
Show Debug Destination File Information Commands show debug destination {ram | file} {[filter] | [latest [<integer(1-10000)>]]} Syntax Description show Display configuration/statistics/general information debug Display debugging information destination Destination RAM disk or memory file The local debug file filter Grep the associated debug messages with the specified “string”...
Page 29
Copy Debug Destination Files Commands copy debug destination {ram|file} {tftp://server/filename | sftp://<user-name>:<pass- word>@server/filename} Syntax Description copy Perform copy operation debug Debug log destination Destination RAM disk or volatile memory file File in local non-volatile storage <tftp_url> File in remote location to be copied via TFTP <sftp_url>...
OSPF Show OSPF Interface Information Commands show ip ospf interface [vlan <vlan id>] Syntax Description IP related information ospf OSPF related information interface Interface related information vlan VLAN related information <vlan id> Specified VLAN ID Defaults Command Modes Privileged EXEC/ User EXEC Usage Guidelines Examples moxa# show ip ospf interface vlan 3...
Page 31
Show OSPF Neighbor Information Commands show ip ospf neighbor [vlan <vlan id>] Syntax Description IP related information ospf OSPF related information neighbor Neighbor router vlan VLAN related information <vlan id> Specified VLAN ID Defaults Command Modes Privileged EXEC/ User EXEC Usage Guidelines Examples moxa# show ip ospf neighbor vlan 3...
Page 32
Show OSPF Re-transmission List Commands show ip ospf retransmission-list Syntax Description IP related information ospf OSPF related information retransmission-list OSPF Link state retransmission list information Defaults Command Modes Privileged EXEC/ User EXEC Usage Guidelines Examples moxa# show ip ospf retransmission-list OSPF Router with ID (10.5.6.6) Neighbor 10.5.6.4, interface - address 10.5.6.4 Queue length 1...
Page 33
Show OSPF Border Router Information Commands show ip ospf border-routers Syntax Description IP related information ospf OSPF related information border-routers OSPF border and boundary router information Defaults Command Modes Privileged EXEC/ User EXEC Usage Guidelines Examples moxa# show ip ospf border-routers OSPF Process Border Router Information Destination TOS Type NextHop...
Page 34
Show OSPF Information Commands show ip ospf Syntax Description IP related information ospf OSPF related information Defaults Command Modes Privileged EXEC/ User EXEC Usage Guidelines Examples moxa# show ip ospf OSPF Router with ID (10.4.0.1) It is an Area Border Router Autonomous System Boundary Router : Disabled Redistributing External Routes is disabled Rfc1583 compatibility is enabled...
Page 35
Show OSPF Database Information Commands show ip ospf database [{database-summary | self-originate}] Syntax Description IP related information ospf OSPF related information database Displays how many of each type of LSA there are for each area in the database database-summary Display how many of each type of LSA there are for each area in the database, and the total number of LSA types self-originate Displays only self-originated LSAs (from the local router)
Page 36
------- ---------- ---- -------- ---------- 10.4.0.1 10.4.0.1 1002 0x8000007d 0xf382 Summary Link States (Area 0.0.0.0) --------------------------------------- Link ID ADV Router Seq# Checksum ------- ---------- ---- -------- 10.10.2.0 10.4.0.1 0x80000094 0xdaa8 Router Link States (Area 0.0.0.6) --------------------------------------- Link ID ADV Router Seq# Checksum Link count -------...
Page 37
------- ---------- ---- -------- 10.10.2.0 10.4.0.1 0x80000094 0xdaa8 Router Link States (Area 0.0.0.6) --------------------------------------- Link ID ADV Router Seq# Checksum Link count ------- ---------- ---- -------- ---------- 10.4.0.1 10.4.0.1 1150 0x80000095 0x90b9 10.10.1.8 10.10.1.8 1094 0x80000093 0xf831 Network Link States (Area 0.0.0.6) --------------------------------------- Link ID ADV Router...
Page 38
Configure Route ID Commands router-id <ip_addr> no router-id Syntax Description Disable the configuration/delete the entry/reset to default value router-id Set OSPF router ID ip_addr IP address for the router Defaults Command Modes OSPF Router Configuration Mode Usage Guidelines Set the router-id as 0.0.0.0 or use no router-id command, it will dynamically select the lowest IP address as router ID Examples moxa(config-router)# router-id 10.4.0.1...
Page 39
Configure Redistribute Settings Commands redistribute {static | connected | all} [metric <integer(1-16777214)>] [metric-type <integer(1-2)>] no redistribute {static | connected | all} Syntax Description Disable the configuration/delete the entry/reset to default value redistribute Configures route redistribution related parameters static/connected/ rip/all Redistribute protocol metric Metric related configuration metric-type...
Page 40
Configure Area Virtual Link Settings Commands area < area-id > virtual-link < router-id > [auth { simple | md5 | sha-1 | sha-224 | sha-256 | sha384 | sha-512}] [hello-interval <short (1-65535)>][dead-interval <integer (1-65535)>] [{auth-key <string(8)> | key-id <integer (0-255)> auth-key <string(16)>}] no area <ip_addr>...
Page 41
Configure Area Range Settings Commands area <area-id> range <ip_addr> <ip_mask> {summary | Type7} no area <area-id> range <ip_addr> [Type7] Syntax Description Disable the configuration/delete the entry/reset to default value area Configures area related information range Address range configuration Summary/ LSA type is set as summary LSA or Type-7 LSA Type7 Defaults Command Modes...
Page 42
Configure OSPF with Legacy OSPFv2 (RFC1583) Compatibility Commands compatible rfc1583 no compatible rfc1583 Syntax Description Disable the configuration/delete the entry/reset to default value Compatible rfc1583 Set OSPF compatibility list compatible with RFC 1583 Defaults Command Modes OSPF Router Configuration Mode Usage Guidelines Examples moxa(config-router)# compatible rfc1583...
Page 43
Configure OSPF Priority Settings Commands ip ospf priority <integer(0 - 255)> no ip ospf priority Syntax Description Disable the configuration/delete the entry/reset to default value Configures IP related information ospf OSPF related configuration priority Router priority configuration integer(0-255) Set the priority parameter Defaults Command Modes Interface Configuration Mode...
Page 44
Configure the OSPF Cost Settings Commands ip ospf cost <integer (1-65535)> no ip ospf cost Syntax Description Disable the configuration/delete the entry/reset to default value Configures IP related information ospf OSPF related configuration cost Path cost configuration integer(10-65535) Set the cost parameter Defaults Command Modes Interface Configuration Mode...
Configure OSPF Network Settings Commands ip ospf network {broadcast | non-broadcast | point-to-multipoint | point-to-point} no ip ospf network Syntax Description Disable the configuration/delete the entry/reset to default value Configures IP related information ospf OSPF related configuration network Network related configuration Defaults broadcast Command Modes...
Page 46
Configure the VRRP Version Settings Commands vrrp version { v2 | v3 } Syntax Description vrrp Configure the VRRP related parameters version Version related configuration Enable VRRP Version 2 Enable VRRP Version 3 Defaults Command Modes VRRP Configuration Mode Usage Guidelines Examples moxa(config)# router vrrp moxa(config-vrrp)# vrrp version v2...
Page 47
Delete the Virtual Router in the Interface Commands no vrrp <vrid(1-255)> Syntax Description Disables configuration/delete entry/reset to default value vrrp VRRP related configuration vrid virtual router ID Defaults Command Modes Interface Configuration Mode Usage Guidelines Examples moxa(config)# interface vlan 2 moxa(config-if)# no vrrp 2 Error Messages Related Commands...
Page 48
Set the Virtual Router Priority Commands vrrp <vrid(1-255)> priority <priority(1-254)> Syntax Description vrrp Configures the VRRP related parameters vrid virtual router ID priority priority related configuration prio-value priority used for the virtual router master election process; larger number means higher priority Defaults Command Modes Interface Configuration Mode...
Page 49
Disable the Preempt Mode Commands no vrrp <vrid(1-255)> preempt Syntax Description Disables configuration/delete entry/reset to default value vrrp VRRP related configuration vrid virtual router ID preempt preempt mode related configuration Defaults enable Command Modes Interface Configuration Mode Usage Guidelines Examples moxa(config)# interface vlan 2 moxa(config-if)# no vrrp 2 preempt Error Messages...
Page 50
Set the Advertisement Timer for the Virtual Router Commands vrrp <vrid(1-255)> timer [msec] <interval(1-255)secs> Syntax Description vrrp Configures the VRRP related parameters vrid virtual router ID timer timer related configuration msec Unit is changed to milli-seconds interval Acceptable range for version 2 and version 3 are (1-40secs)/(30- 40000msecs) Defaults 1sec/1000msecs...
Page 51
Disable the Accept Mode Commands no vrrp <vrid(1-255)> accept-mode Syntax Description Disables configuration/delete entry/reset to default value vrrp VRRP related configuration vrid virtual router ID accept-mode accept mode related configuration Defaults enable Command Modes Interface Configuration Mode Usage Guidelines Examples moxa(config)# interface vlan 2 moxa(config-if)# no vrrp 2 accept-mode Error Messages...
Page 52
Show the VRRP Information for the Interface Commands show vrrp interface [ { vlan <vlan-id> } ] [ { brief | detail | statistics } ] Syntax Description show Display configuration / statistics / general information vrrp Displays VRRP information interface VRRP status for the interface vlan...
Need help?
Do you have a question about the MDS-G4000-L3-4XGS Series and is the answer not in the manual?
Questions and answers