Patton electronics Industrial Ethernet Extender with LCD Interface... Instruction Manual

Model 3231
Industrial Ethernet Extender with
LCD
CLI Reference Guide
Sales Office: [phone]
Technical Support: [phone]
E-mail: [email protected]
WWW: www.patton.com
Part Number: 07M3231-CLI, Rev. A
Revised: October 29, 2008
Important
This is a Class A device and is intended for use in a light industrial environment. It is not intended nor approved for use in an industrial
or residential environment.
Start Installation
For Quick

Patton Electronics, Inc.
Trademark Statement
All other trademarks presented in this document are the property of their
respective owners.
Copyright © 2008, Patton Electronics. All rights reserved.
The information in this document is subject to change without notice. Patton assumes
no liability for errors that may appear in this document.
Warranty Information
Patton warrants all Model 3231 components to be free from defects, and will—at our
option—repair or replace the product should it fail within one year from the first date
of shipment.
This warranty is limited to defects in workmanship or materials, and does not cover
customer damage, abuse or unauthorized modification. If this product fails or does not
perform as warranted, your sole recourse shall be repair or replacement as described
above. Under no condition shall Patton be liable for any damages incurred by the use
of this product. These damages include, but are not limited to, the following: lost prof-
its, lost savings and incidental or consequential damages arising from the use of or
inability to use this product. Patton specifically disclaims all other warranties,
expressed or implied, and the installation or use of this product shall be deemed an
acceptance of these terms by the user.
Note
Conformity documents of all Patton products can be viewed online at
www.patton.com under the appropriate product page.

3
Summary Table of Contents
1Alarm Commands ......................................................................................................................................... 13
2Bridge Commands......................................................................................................................................... 18
3CPE Config Commands ................................................................................................................................27
4Ethernet Commands...................................................................................................................................... 31
5Firewall Commands ...................................................................................................................................... 38
6G.SHDSL Commands ................................................................................................................................... 55
7Help Commands ........................................................................................................................................... 76
8IP Commands ............................................................................................................................................... 78
9Logger Commands ........................................................................................................................................ 99
10 Port Commands .......................................................................................................................................... 102
11 PPP Commands .......................................................................................................................................... 105
12 PPPoA Commands...................................................................................................................................... 113
13 PPPoE Commands ...................................................................................................................................... 123
14 RFC1483 Commands.................................................................................................................................. 133
15 Security Commands .................................................................................................................................... 140
16 SNMP Commands....................................................................................................................................... 150
17 Source Commands....................................................................................................................................... 156
18 System Commands ...................................................................................................................................... 158
19 Transport Commands ................................................................................................................................. 174
20 User Commands.......................................................................................................................................... 179
21 Webserver Commands................................................................................................................................. 183

4
Table of Contents
Summary Table of Contents ........................................................................................................................... 3
Table of Contents ........................................................................................................................................... 4
About this guide ........................................................................................................................................... 10
Audience............................................................................................................................................................... 10
Structure............................................................................................................................................................... 10
Using the CLI .......................................................................................................................................................11
Connect a PC and log in .................................................................................................................................11
Precautions ........................................................................................................................................................... 12
Typographical conventions used in this document................................................................................................ 12
General conventions .......................................................................................................................................12
1Alarm Commands ......................................................................................................................................... 13
alarm all alarmStatus..............................................................................................................................................14
alarm set <index> alarmSeverity.............................................................................................................................15
alarm set <index> alarmStatus................................................................................................................................16
alarm show ............................................................................................................................................................17
Example Output: alarm show .........................................................................................................................17
2Bridge Commands......................................................................................................................................... 18
bridge add interface ...............................................................................................................................................19
bridge attach..........................................................................................................................................................20
bridge clear interfaces.............................................................................................................................................21
bridge delete interface............................................................................................................................................22
bridge detach .........................................................................................................................................................23
bridge list interfaces ...............................................................................................................................................24
Example Output: bridge list interfaces ............................................................................................................24
bridge set ...............................................................................................................................................................25
bridge show ...........................................................................................................................................................26
Example Output: bridge show ........................................................................................................................26
Example Output: bridge show interface br1 ....................................................................................................26
3CPE Config Commands ................................................................................................................................27
cpeconfig action.....................................................................................................................................................28
cpeconfig set..........................................................................................................................................................29
cpeconfig show ......................................................................................................................................................30
Example Output: cpeconfig show ...................................................................................................................30
4Ethernet Commands...................................................................................................................................... 31
ethernet add transport ...........................................................................................................................................32
ethernet clear transports.........................................................................................................................................33
ethernet delete transport ........................................................................................................................................34
ethernet list............................................................................................................................................................35
Example Output: ethernet list ports ................................................................................................................35

5
Model 3231 CLI Reference Guide Table of Contents
Example Output: ethernet list transports .........................................................................................................35
ethernet set transport .............................................................................................................................................36
ethernet show transport .........................................................................................................................................37
Example Output: ethernet show transport eth1 ...............................................................................................37
5Firewall Commands ...................................................................................................................................... 38
firewall add policy..................................................................................................................................................39
firewall add portfilter .............................................................................................................................................40
firewall add validator .............................................................................................................................................42
firewall clear ..........................................................................................................................................................43
firewall delete.........................................................................................................................................................44
firewall disable .......................................................................................................................................................45
firewall enable........................................................................................................................................................46
firewall list .............................................................................................................................................................47
Example Output: firewall list policies ..............................................................................................................47
Example Output: firewall list portfilters pex_in ...............................................................................................47
Example Output: firewall list protocol ............................................................................................................48
Example Output: firewall list validators pdmz_in ............................................................................................48
firewall set IDS ......................................................................................................................................................49
firewall set securitylevel..........................................................................................................................................50
firewall set validator...............................................................................................................................................51
firewall show..........................................................................................................................................................52
Example Output: firewall show IDS ...............................................................................................................52
Example Output: firewall show IDS blacklist ..................................................................................................52
Example Output: firewall show portfilter hei_http pex_in ..............................................................................53
Example Output: firewall show validator item0 pdmz_in ................................................................................53
firewall status.........................................................................................................................................................54
Example Output: firewall status ......................................................................................................................54
6G.SHDSL Commands ................................................................................................................................... 55
gshdsl set BERMeterMode ....................................................................................................................................56
gshdsl set Clocking ................................................................................................................................................57
gshdsl set EthLinkKill............................................................................................................................................58
gshdsl set LineProbe ..............................................................................................................................................59
gshdsl set action.....................................................................................................................................................60
gshdsl set clockingcombination..............................................................................................................................61
gshdsl set datarateI.................................................................................................................................................62
gshdsl set dslrateTS................................................................................................................................................63
gshdsl set errMonIntervalCnt ................................................................................................................................64
gshdsl set errMonIntervalThreshold.......................................................................................................................65
gshdsl set errMonIntervalTime ..............................................................................................................................66
gshdsl set errMonStartupDelay..............................................................................................................................67
gshdsl set errMonTotalIntervals.............................................................................................................................68
gshdsl set gshannex ................................................................................................................................................69
gshdsl set interface .................................................................................................................................................70

6
Model 3231 CLI Reference Guide Table of Contents
gshdsl set terminal .................................................................................................................................................71
gshdsl seta..............................................................................................................................................................72
gshdsl show............................................................................................................................................................73
Example Output: gshdsl show .........................................................................................................................73
gshdsl showTestMode............................................................................................................................................74
Example Output: gshdsl showTestMode .........................................................................................................74
gshdsl showc..........................................................................................................................................................75
Example Output: gshdsl showc .......................................................................................................................75
7Help Commands ........................................................................................................................................... 76
help .......................................................................................................................................................................77
8IP Commands ............................................................................................................................................... 78
ip add defaultroute ................................................................................................................................................79
ip add interface......................................................................................................................................................80
ip add route ...........................................................................................................................................................81
ip attach ................................................................................................................................................................82
ip attachbridge.......................................................................................................................................................83
ip attachvirtual.......................................................................................................................................................84
ip clear...................................................................................................................................................................85
ip delete.................................................................................................................................................................86
ip detach................................................................................................................................................................87
ip interface.............................................................................................................................................................88
Example Output: ip interface ip1 list proxyarpentries .....................................................................................89
Example Output: ip interface ip1 list secondaryipaddresses .............................................................................89
ip list .....................................................................................................................................................................90
Example Output: ip list arpentries ..................................................................................................................90
Example Output: ip list connections ...............................................................................................................90
Example Output: ip list interfaces ...................................................................................................................91
Example Output: ip list riproutes ....................................................................................................................91
Example Output: ip list routes ........................................................................................................................91
ip ping...................................................................................................................................................................92
ip set interface........................................................................................................................................................93
ip set rip ................................................................................................................................................................94
ip set route.............................................................................................................................................................95
ip show..................................................................................................................................................................96
Example Output: ip show debuginfo ..............................................................................................................96
Example Output: ip show interface ip1 ...........................................................................................................97
Example Output: ip show route default ..........................................................................................................97
ip traceroute ..........................................................................................................................................................98
9Logger Commands ........................................................................................................................................ 99
logger set .............................................................................................................................................................100
logger show..........................................................................................................................................................101
Example Output: logger show .......................................................................................................................101

7
Model 3231 CLI Reference Guide Table of Contents
10 Port Commands .......................................................................................................................................... 102
port ethernet........................................................................................................................................................103
port list................................................................................................................................................................104
Example Output: port list all ........................................................................................................................104
Example Output: port list atm ......................................................................................................................104
Example Output: port list ethernet ...............................................................................................................104
Example Output: port list hdlc .....................................................................................................................104
11 PPP Commands .......................................................................................................................................... 105
ppp add transport ................................................................................................................................................106
ppp clear transports .............................................................................................................................................107
ppp delete transport.............................................................................................................................................108
ppp list transports................................................................................................................................................109
Example Output: ppp list transports .............................................................................................................109
ppp set transport..................................................................................................................................................110
ppp show transport..............................................................................................................................................112
Example Output: ppp show transport ppp1 ..................................................................................................112
12 PPPoA Commands...................................................................................................................................... 113
pppoa add transport ............................................................................................................................................114
pppoa clear transports..........................................................................................................................................115
pppoa delete ........................................................................................................................................................116
pppoa list transports ............................................................................................................................................117
Example Output: pppoa list transports ..........................................................................................................117
pppoa set transport ..............................................................................................................................................118
pppoa show transport ..........................................................................................................................................122
Example Output: pppoa show transport ppp1 ..............................................................................................122
13 PPPoE Commands ...................................................................................................................................... 123
pppoe add transport.............................................................................................................................................124
pppoe clear transports..........................................................................................................................................125
pppoe delete transport .........................................................................................................................................126
pppoe list transports ............................................................................................................................................127
Example Output: pppoe list transports ..........................................................................................................127
pppoe set transport ..............................................................................................................................................128
pppoe show transport ..........................................................................................................................................132
14 RFC1483 Commands.................................................................................................................................. 133
rfc1483 add transport ..........................................................................................................................................134
rfc1483 clear transports .......................................................................................................................................135
rfc1483 delete transport.......................................................................................................................................136
rfc1483 list transports..........................................................................................................................................137
Example Output: rfc1483 list transports .......................................................................................................137
rfc1483 set transport............................................................................................................................................138
rfc1483 show transport........................................................................................................................................139
Example Output: rfc1483 show transport rfc1 ..............................................................................................139

8
Model 3231 CLI Reference Guide Table of Contents
15 Security Commands .................................................................................................................................... 140
security add .........................................................................................................................................................141
security clear........................................................................................................................................................142
security delete ......................................................................................................................................................143
security disable ....................................................................................................................................................144
security enable .....................................................................................................................................................145
security list ..........................................................................................................................................................146
Example Output: security list interfaces ........................................................................................................146
Example Output: security list triggers ...........................................................................................................146
security set trigger................................................................................................................................................147
security show .......................................................................................................................................................148
Example Output: security show interface ip1 ................................................................................................148
Example Output: security show trigger t2_h323 ...........................................................................................148
security status ......................................................................................................................................................149
Example Output: security status ....................................................................................................................149
16 SNMP Commands....................................................................................................................................... 150
snmp add.............................................................................................................................................................151
snmp delete .........................................................................................................................................................152
snmp save ............................................................................................................................................................153
snmp set ..............................................................................................................................................................154
snmp show ..........................................................................................................................................................155
Example Output: snmp show ........................................................................................................................155
17 Source Commands....................................................................................................................................... 156
source <filename>................................................................................................................................................157
18 System Commands ...................................................................................................................................... 158
system add...........................................................................................................................................................159
system config.......................................................................................................................................................160
system cpu...........................................................................................................................................................161
Example Output: system cpu npOverThreshold ...........................................................................................161
Example Output: system cpu npThreshold get .............................................................................................161
Example Output: system cpu npUsage ..........................................................................................................161
Example Output: system cpu ppOverThreshold ...........................................................................................161
Example Output: system cpu ppThreshold get ..............................................................................................162
Example Output: system cpu ppUsage ..........................................................................................................162
system delete........................................................................................................................................................163
system ifTable reset..............................................................................................................................................164
system info ..........................................................................................................................................................165
Example Output: system info ........................................................................................................................165
system legal..........................................................................................................................................................166
Example Output: system legal .......................................................................................................................166
system list ............................................................................................................................................................167
Example Output: system list errors ...............................................................................................................167
Example Output: system list logins ...............................................................................................................167

9
Model 3231 CLI Reference Guide Table of Contents
Example Output: system list openfiles bun ...................................................................................................167
Example Output: system list users .................................................................................................................168
system log............................................................................................................................................................169
Example Output: system log list ....................................................................................................................169
Example Output: system log list op ...............................................................................................................170
system restart.......................................................................................................................................................171
system set ............................................................................................................................................................172
system show.........................................................................................................................................................173
Example Output: system show aticmem ........................................................................................................173
Example Output: system show firmware update protection ...........................................................................173
19 Transport Commands ................................................................................................................................. 174
transports clear ....................................................................................................................................................175
transports delete...................................................................................................................................................176
transports list.......................................................................................................................................................177
Example Output: transports list ....................................................................................................................177
transports show....................................................................................................................................................178
Example Output: transports show eth1 .........................................................................................................178
20 User Commands.......................................................................................................................................... 179
user change..........................................................................................................................................................180
user logout...........................................................................................................................................................181
user password ......................................................................................................................................................182
21 Webserver Commands................................................................................................................................. 183
webserver clear.....................................................................................................................................................184
webserver disable .................................................................................................................................................185
webserver enable..................................................................................................................................................186
webserver load .....................................................................................................................................................187
webserver set........................................................................................................................................................188
webserver show....................................................................................................................................................189
Example Output: webserver show info ..........................................................................................................189
Example Output: webserver show stats .........................................................................................................189

10
About this guide
This guide describes commands for configuring the Patton Model 3231 Industrial Ethernet Extender with
LCD.
Note
For general information regarding setting up, installing and operating
the 3231, refer to the Getting Started Guide .
Audience
This guide is intended for administrators and operators.
Structure
•Chapter 1, "Alarm Commands" on page 13 describes commands for configuring alarms.
•Chapter 2, “Bridge Commands” on page 18 describes commands for configuring the bridge.
•Chapter 3, “CPE Config Commands” on page 27 describes commands for configuring the CPE.
(These commands are only available from the CO unit).
•Chapter 4, “Ethernet Commands” on page 31 describes commands for configuring Ethernet transports.
•Chapter 5, “Firewall Commands” on page 38 describes commands for configuring the firewall.
•Chapter 6, “G.SHDSL Commands” on page 55 describes commands for configuring the G.SHDSL port.
•Chapter 7, “Help Commands” on page 76 describes commands for accessing the top-level CLI help.
•Chapter 8, “IP Commands” on page 78 describes commands for configuring IP interfaces.
•Chapter 9, “Logger Commands” on page 99 describes commands for logging into a remote host.
•Chapter 10, “Port Commands” on page 102 describes commands for configuring physical ports.
•Chapter 11, “PPP Commands” on page 105 describes commands for configuring PPP over HDLC.
•Chapter 12, “PPPoA Commands” on page 113 describes commands for configuring PPP over ATM.
•Chapter 13, “PPPoE Commands” on page 123 describes commands for configuring PPP over Ethernet.
•Chapter 14, “RFC1483 Commands” on page 133 describes commands for configuring RFC 1483 trans-
ports.
•Chapter 15, “Security Commands” on page 140 describes commands for configuring security features.
•Chapter 16, “SNMP Commands” on page 150 describes commands for configuring SNMP settings.
•Chapter 17, “Source Commands” on page 156 describes commands for viewing source files.
•Chapter 18, “System Commands” on page 158 describes commands for managing the system.
•Chapter 19, “Transport Commands” on page 174 describes commands for configuring transports.
•Chapter 20, “User Commands” on page 179 describes commands for managing user login information.
•Chapter 21, “Webserver Commands” on page 183 describes commands for configuring the Web Server.

Using the CLI 11
Model 3231 CLI Reference Guide
Using the CLI
The Model 3231 may be configured through the CLI, although basic settings should be configured through
the LCD menu on the unit.
Connect a PC and log in
Use an RS-232/Ethernet cable and DB9-RJ45 adapter to connect a PC’s serial port to the 3231’s Console port
(see figure 1).
Figure 1. Connecting the 3231 to the PC’s serial port
1. Start a HyperTerminal session on the PC using the settings:
9600 bps, 8 data bits, no parity, 1 stop bit, no flow control
2. Log in to the 3231 using the factory-default login ( superuser ) and password ( superuser ):
The interconnecting cables shall be acceptable for external use
and shall be rated for the proper application with respect to volt-
age, current, anticipated temperature, flammability, and
mechanical serviceability.
CAUTION
Connect to Console port
Serial port
PC with
terminal emulator
Ethernet
Reset
Line
Power
5V,1A Console

Using the CLI 12
Model 3231 CLI Reference Guide
Precautions
Notes, cautions, and warnings, which have the following meanings, are used throughout this guide to help you
become aware of potential problems.
Note
A note presents additional information or interesting sidelights.
Typographical conventions used in this document
This section describes the typographical conventions and terms used in this guide.
General conventions
The procedures described in this manual use the following text conventions:
The alert symbol and IMPORTANT heading calls attention to
important information.
The alert symbol and CAUTION heading indicate a potential haz-
ard. Strictly follow the instructions to avoid property damage.
Table 1. General conventions
Convention Meaning
Garamond blue type Indicates a cross-reference hyperlink that points to a figure, graphic, table, or sec-
tion heading. Clicking on the hyperlink jumps you to the reference. When you
have finished reviewing the reference, click on the Go to Previous View
button in the Adobe® Acrobat® Reader toolbar to return to your starting point.
Futura bold type Commands and keywords are in boldface font.
Futura bold-italic type Parts of commands, which are related to elements already named by the user, are
in boldface italic font.
Italicized Futura type Variables for which you supply values are in italic font
Futura type Indicates the names of fields or windows.
Garamond bold type Indicates the names of command buttons that execute an action.
IMPORTANT
CAUTION

13
Chapter 1 Alarm Commands
Chapter contents
alarm all alarmStatus..............................................................................................................................................14
alarm set <index> alarmSeverity.............................................................................................................................15
alarm set <index> alarmStatus................................................................................................................................16
alarm show ............................................................................................................................................................17
Example Output: alarm show .........................................................................................................................17

alarm all alarmStatus 14
Model 3231 CLI Reference Guide 1 • Alarm Commands
alarm all alarmStatus
Set the alarm state for all alarms.
Table 2. alarm all alarmStatus
Command Explanation
alarm all alarmStatus clear Set the alarm state to "clear" for all alarms. Does not clear the
number of occurences and the time of the most recent occurrence.
alarm all alarmStatus reset Set the alarm state to "clear" for all alarms. Clears the number of
occurrences and the time of the most recent occurrence.

alarm set <index> alarmSeverity 15
Model 3231 CLI Reference Guide 1 • Alarm Commands
alarm set <index> alarmSeverity
Set the index for the severity level of an alarm.
Table 3. alarm set <index> alarmSeverity
Command Explanation
alarm set <index> alarm Severity
critical
Determine the level of importance for specific alarms.
Critical/Major = The most severe alarms
Ignore/Informational/Minor = Non-severe alarms
alarm set <index> alarm Severity
ignore
alarm set <index> alarm Severity
informational
alarm set <index> alarm Severity
major
alarm set <index> alarm Severity
minor

alarm set <index> alarmStatus 16
Model 3231 CLI Reference Guide 1 • Alarm Commands
alarm set <index> alarmStatus
Set the index for the status level of an alarm.
Table 4. alarm set <index> alarmStatus
Command Explanation
alarm set <index> alarm Status
active
Mark the alarm condition as a currently present alarm.
alarm set <index> alarm Status
clear
Clear a specific alarm. Does not clear the number of occurrences
or the most recent occurrence.
alarm set <index> alarm Status
inactive
Mark the alarm condition as not currently present.
alarm set <index> alarm Status
reset
Clear a specific alarm. Clears the number of occurrences or the
most recent occurrence.

alarm show 17
Model 3231 CLI Reference Guide 1 • Alarm Commands
alarm show
Show alarm status.
Example Output: alarm show
--> alarm show
Current Box State: Major
Alarm Table
Alarm
Active | ID | Alarm String | Severity | Time | Count
--------|-----|------------------------|-----------------|-----------|------
| 1 | PP Over Threshold | Informational | 00:00:00s | 0
| 2 | NP Over Threshold | Informational | 00:00:00s | 0
| 3 | G.SHDSL Loss Of Signal | Major | 00:00:00s | 0
**** | 4 | Ethernet Link Down | Major | 00:00:05s | 1
----------------------------------------------------------------------------
Table 5. alarm show
Command Explanation
alarm show Show alarm status.

18
Chapter 2 Bridge Commands
Chapter contents
bridge add interface ...............................................................................................................................................19
bridge attach..........................................................................................................................................................20
bridge clear interfaces.............................................................................................................................................21
bridge delete interface............................................................................................................................................22
bridge detach .........................................................................................................................................................23
bridge list interfaces ...............................................................................................................................................24
Example Output: bridge list interfaces ............................................................................................................24
bridge set ...............................................................................................................................................................25
bridge show ...........................................................................................................................................................26
Example Output: bridge show ........................................................................................................................26
Example Output: bridge show interface br1 ....................................................................................................26

bridge add interface 19
Model 3231 CLI Reference Guide 2 • Bridge Commands
bridge add interface
Add a named interface to the bridge.
Table 6. bridge add interface
Command Explanation
bridge add interface <name> Add a named interface to the bridge.

bridge attach 20
Model 3231 CLI Reference Guide 2 • Bridge Commands
bridge attach
Attach existing transport to existing bridge interface.
Table 7. bridge attach
Command Explanation
bridge attach <name> <transport> Attach existing transport to existing bridge interface.