3COM 812 User Manual
OfficeConnectTM Remote 812
®
ADSL Router
CLI User’s Guide
Release 1.0
http://www.3com.com/
3Com Corporation
5400 Bayfront Plaza
Santa Clara, California
95052-8145
Copyright © 2000 3Com Corporation. All rights reserved. No part of this documentation may be
reproduced in any form or by any means or used to make any derivative work (such as translation,
transformation, or adaptation) without written permission from 3Com Corporation.
3Com Corporation reserves the ri ght to revise this documen tation and to make changes in content fr om
time to time without obligation on the part of 3Com Corporation to provide notification of such revision or
change.
3Com Cor poration provides this documentation without wa rranty of any kind, either implied or expressed,
including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose.
3Com may ma ke improvements or c hanges i n the product(s) an d/or the program(s) described in this
documentation at any time.
UNITED STATES GOVERNMENT LEGENDS:
If you are a United States government agency, then this docu mentation and the software descr ibed herein
are provided to you subject to the following:
United States Government Legend: All technical data and computer software is commercial in nature
and develop ed sol el y at pr i vate exp ense . Soft wa re i s de li ver ed as C ommer c ia l Com pute r Sof tw ar e a s def ine d
in DF ARS 252. 227-7014 (June 1995) or as a c ommercial item as defined in FA R2.101(a) and as such is
prov ided with only such rights as are prov ided in 3Com’s standard commercial license for the Software.
Technical data is provided with limited rights only as provided in DFAR 252.227-7015 (Nov 1995) or FAR
52.227-14 (June 1987), whichever is applicable. You agree not to remove or deface any portion of any
legend pro vid ed on any lic ens ed progr am or do cum ent a tio n con tai ned in, or del i ver ed to yo u in conj un cti on
with this User’s Guide.
Unless o therwise indicated, 3Com regis tered trademarks are registered in th e United States and may or may
not be registered in other countries.
3Com, the 3Com logo, and OfficeConnect are registered trademarks of 3Com Corporation. OfficeConnect
Remote 812 is a trademark of 3Com Corporation. 3ComF a c ts is a se rvice ma rk of 3Com Corpora tion.
Artisoft and LANtastic are registered trademarks of Artisoft, Inc. Banyan and VINES are registered
trademarks of Banyan Systems Incorporated. CompuServe is a registe red trademark of CompuServe, Inc.
DEC and PATHWORKS are registered trademarks of Digital Equip ment Corporation. Intel and Pentium are
registered trademarks of Intel Corporation. AIX, AT, IBM, NetView, and OS/2 are registered trademarks and
Warp is a trademark of International Business Machines Corporation. Microsoft, MS-DOS, Windows, and
Windows NT are registered trademarks of Microsoft Corporation. Novell and NetWare are registered
trademarks of Nove ll, Inc. PictureTel is a regist ered trademark of Pi ctureTel Corpor ation. UNIX is a registere d
trademark of X/Ope n Company, Ltd. in the United States and oth er countri es.
Other brand and product names may be registered trademarks or trademarks of their respective holders.
ii
CONTENTS
1 ACCESSING THE CONFIGURATION INTERFACE
Establishing Communications with the OfficeConnect Remote 812 1
Local Connecti on 1
IBM-PC Compatible Computers 1
Macintosh Computers 1
UNIX-Based Computers 2
Remote Connection 2
2 CLI COMMAND CONVENTIONS AND TERMINOLOGY
Command Structure 1
Format 1
Parameters 1
Values 1
Names or Strings 2
Network Address Formats 2
Abbrevia tion and Command Completion 2
Control Characters 2
Help 2
Conventions 3
Conventions 3
Command Language Terminology 3
3 CONFIGURATION METHO DS
Quick Setup Instructions 1
QuickVC Setup Instructions 1
Manual Setup Instructions 2
4 QUICK SETUP
CLI Quick Setup Script 1
Introduction 1
Instructions 1
Setup Script 1
Password Pr otection 2
Which portions of the network do you want to configure? 2
Quick Setup Identification information 2
Quick Setup Management Information 2
TELNET information 3
Quick Setup IP information 3
Quick Set up IP X inf or mation 4
Quick Setup Bridge Information 5
Sample Identification Information 5
5 QUICK VC SETUP
CLI QuickVC Setup Script 1
Introduction 1
Instructions 1
Starting QuickVC Setup 1
A TM Parameters 1
Network Service 2
PPP Parameters 2
IP Configurat ion (Netwo rk Service PPP) 2
IP Configuration (Network Service RFC1483) 3
IPX Routing (Network Service PPP) 4
IPX Routing (Network Service RFC 1483) 4
Bridging 4
Review 4
Sample Identification Information 4
5
5
5
5
Sample Output Display as Quick Setup Executes 5
6 MANUAL SETUP
Configuration Overview 1
Remote Site Management 2
Managing a Remote Site 2
Configuring Network Service Information 3
Configuring ATM Information 3
IP Routing 4
Enabling IP Routing 5
show ip settings 6
show ip routing settings 6
Configuring an IP Network over the LAN 6
Configuring IP RIP on the LAN 6
Configuring IP for the Remote Site Connection 7
Configuring IP RIP for a Remote Site 8
Configuring Static and Framed IP Routes 8
IP Tools 9
Address Translation 9
Network Address Translatio n (NAT) 9
Configuring NAT 10
Monitoring NAT 11
DHCP 11
Configuring the DHCP Mode 11
Configuring the DHCP Server 11
Monitoring the DHCP Server 12
Configuring the DHCP Relay 13
Monitoring the DHCP Relay 13
DNS 13
Configuring DNS 14
DNS Host Entries 14
Managing the DNS Proxy 14
IPX Routing 15
Enabling IPX Routing 15
Configuring IPX for the LAN 15
Configuring IPX for Remote Site Connections 16
Configuring IPX Static and Framed Routes 16
Configuring IPX Static and Framed Services 17
Configuring IPX RIP and SAP 18
Bridging 19
Configuring Bridging for the LAN 20
Configuring Bridging for the Remote Site Connections 20
Bridging IP Traf fi c 20
Advanced Bridging Options 20
MAC-Encapsulated Routing 21
Configuring MAC-Encapsulated Routing 21
Simultaneous Bridging and Routing 22
System Administr ation 23
Setting Date and Time 23
Setting System Identification 23
Configuring Web Browser and TELNET Login Access 24
Providing TFTP Access 24
Setting Password Protection 25
Introduction 25
Filtering Overview 26
OfficeConnect Remote 812 Filtering Capabilities 26
Filter Classes 26
Filter Types 27
Data Filters 27
Advertisement Filters 27
Gener ic Fi lt e rs 28
Creating Fil ters Overv ie w 28
Creating Filters Using Command Line Interface 28
Filter File Components in CLI 28
Protocol Sections 29
Protocol Rules 29
Generic Filter Rule 31
Applying the Rules Using CLI 31
IP Source and Destination Network Filtering Using CLI 31
IP Source and Destination Port Filtering Using CLI 32
IP Protocol Filtering Using CLI 32
IP RIP Packet Filteri n g Usi ng CLI 32
IPX Source and Destination Network Filtering Using CLI 33
IPX Source and Destination Host Filtering Using CLI 33
IPX Source and Destination Socket Number Filtering Using CLI 33
IPX RIP Packet Filtering Using CLI 33
IPX SAP Packet Filtering Using CLI 34
Bridge / Generic Filtering Using CLI 34
Step by Step Guide to Creatin g Fi lter Files Using CLI 34
Assigning Filters 36
Interface Filters 36
Input Filter 36
Output Filters 36
Input Filters vs. Output Filters 36
VC/Remote Site Filters 36
Applying Filters Using CLI 36
Applying a Filter to an Interface Using CLI 37
Configuring a Filter for a VC/Remote Site Using CLI 37
Setting Fi lter Access Usin g CL I 37
Managing Filters Using CLI 38
Displaying the Managed Filter List Using CLI 38
Adding Filters to the Managed List Using CLI 38
Removing a Filter from an Interface Using CLI 38
38
Removing a Filter from a VC/Remote Site Profile Using CLI 38
Deleting a Packet Filter Using CLI 39
Verifying Filter File Syntax Using CLI 39
Showing Filter File Contents Using CLI 39
A OFFICECONNECT REMOTE 812 SAMPLE
CONFIGURATION
Global Configuration A-2
LAN IP Network Configuration A-2
DHCP and DNS Configuration A-2
LAN IPX Network Confi g u r ation A-3
Bridge Configuration A-3
Remote Site: Internet A-3
Remote Site: Corporate Access A-4
B CLI COMMAND DESCRIPTION
CLI Commands B-1
ADD B-1
add bridge network <network_name> B-1
add dns host <host_name> address <IP_address> B-1
add dns server <domain_name> B-1
add filter <filter_nam e> B-2
add framed_route vc <name> B-2
add ip defaultroute gateway <IP_address> B-2
add ip network <network_name> B-3
add ip route <ip_net_address> B-3
add ipx network <network_name> B-3
add ipx route <ipx_net_address> B-4
add ipx service [service_ na me] B-4
add ipx_rout e vc <name> B-5
add ipx_service vc <name> B-5
add nat tcp vc <user_name> B-7
add nat udp vc <vc_name> B-7
add network service <service_name> Status B-7
Add network service example: B-8
add snmp community <community_name> B-8
add snmp trap_community <name> B-8
add syslog <ip_name_or_addr> loglevel [loglevel] B-9
add tftp client <ip_name_or_addr> B-9
add user [name] password [password] B-9
add vc [name] B-9
ARP B-10
arp <ip_name _or_addr> B-10
DELETE B-10
delete bridge network <network_name> B-10
delete configuration B-10
delete dns host <host_name> B-10
delete dns server <domain_name> B-10
delete filter <filter_name> B-10
delete file <file_name> B-10
delete framed route vc B-10
delete ip network <network_name> B-10
delete ip route <IP_address> B-10
delete ipx network <name> B-10
delete ipx route <ipx_net_address> B-11
delete ipx service <serv ice_n am e> B-11
delete nat tcp vc <vc_name> B-11
delete nat udp vc <vc_name> B-11
delete network service <servic e_n ame> B-11
delete snmp community <name> B-11
delete snmp trap_community <name> B-11
delete syslog <ip_name_or_address> B-11
delete tftp client <ip_name_or_address> B-11
delete user <name> B-11
delete vc <name> B-11
DIAL B-12
dial <vc_name> B-12
DISABLE B-12
disable bridge network <name> B-12
disable bridge spanning_tree B-12
disable icmp B -12
disable interface <interface_name> B-12
disable ip forwarding B-12
disable ip network <network_name> B-12
disable ip rip B-12
disable ip routing B-12
disable ip static_remote_routes B-12
disable ipx network <network_name> B-12
disable link_traps interface <interface_name> B-12
disable network service <service_name> B-13
disable security_option snmp user_access B-13
disable security_option remote_user administration B-13
disable snmp authentication traps B-13
disable telnet escape B-13
disable user <user_name> B-13
disable vc <user_name> B-13
DO B-13
do <command_inputfile> output [outputfile] B-13
ENABLE B-13
enable bridge network <network_name > B-13
enable bridge spanning_tree B-13
enable interface <interfac e_n am e> B-14
enable ip forwarding B-14
enable ip network <network_name> B-14
enable ip rip B-14
enable ip routing B-14
enable ipx network <network_name> B-14
enable link_traps int erfac e <interface_name> B-14
enable network service <service _name> B-14
enable security_option remote_user administration B-14
enable security_optio n snmp user _acc es s B-14
enable snmp authentication tr aps B-14
enable telnet escape B-14
enable user <user name> B-15
enable vc <vc name> B-15
exit CLI B-15
HANGUP B-15
hangup interface <interface_name> B-15
hangup vc <vc_name> B-15
HELP B-15
help <command> B-15
HISTORY B-15
history B-15
KILL B-15
kill <“process n a me ”> B-15
LIST B-16
list active interfaces B-16
list bridge forwarding B-16
list call events B - 16
list call log B-16
list critical events B-16
list dns hosts B-16
list dns servers B-16
list facilities B-17
list filters B-17
list files B-17
list interfaces B-17
list ip addresses B-17
list ip arp B-17
list ip interf a ce _ blo c k B-17
list ip networks B-18
list ip routes B-18
list ipx networks B-18
list ipx routes B-18
list ipx services B -1 8
list lan interfaces B-19
list networks B-19
list processes B-19
list ppp B-19
list services B-19
list snmp communities or list snmp trap_communities B-20
list syslog B-20
list tcp connections B-20
list tftp clients B-20
list udp listeners B-20
list users B-20
list vc B-20
login_required B-21
password B-21
P AUSED COMMANDS B-21
PING B-21
ping <ip_name_or_addr> B-21
QUICKVC B-21
REBOOT B-21
RENAME B-21
rename file <input_file> <output_file> B-21
RESOLVE B-22
resolve name <IP_host_name> B-22
SAVE B-22
save all B- 22
SET B-22
set adsl reset B-22
set adsl wire [pair] B-22
set bridge B-22
set bridge firewall [firewall_mode] B-22
set command B-22
set date <date> B-23
set dhcp mode <mode> B-23
set dhcp relay server1 B-23
set dhcp relay server2 B-23
set dhcp server B-24
set dns B-24
set facility <facili ty_name> loglevel [level] B-25
set ilmi vpi <number> vci <number> B-25
set interface <interface_name> B-25
set ip network <name> B-26
set ip routing B-27
set ipx network <network_name> B-28
set ipx system B-29
set network service <admin_name> B-29
set ppp receiv e_au t h ent ication [NONE | PAP | CHAP | EITHER] B-30
set ppp echo_retries <number> B-30
set snmp community <community_name> B-30
set system B-30
set syslog <IP_address> loglevel [level ] B-31
set time <time> B-31
set user <user_name> B-31
set vc <vc_ n a me> B-31
set vc <vc_name> atm B-34
SHOW B-34
show atm status B-35
show adsl statistics B-35
show adsl performance B-35
show adsl transceiver_status B-35
show adsl version B-36
show bridge network <name> B-36
show bridge settings B-36
show call_log B-36
show command B-37
show configuration B-37
show critical_event settings B-37
show date B-37
show dhcp relay B-37
show dhcp server counters B-38
show dhcp server settings B-38
show dns counters B-39
SPECIFIC ERROR COUNTE R S B-39
show dns settings B-39
show filter <filter_name> B-39
show icmp counters B-40
ICMP COUNTERS B-40
show interface <interface_name> counters B-41
INPUT COUNTERS B-41
OUTPUT COUNTERS B-41
show interface <interface_name> settings B-41
show ip counters B-41
INPUT COUNTERS B-41
OUTPUT COUNTERS B-42
show ip settings B-42
show ip network <network_name> settings B-42
show ipx counters B-43
INPUT COUNTERS B-43
OUTPUT COUNTERS B-43
show ipx network <network_name> counters B-43
show ipx network <network_name> settings B-44
show ipx rip B-44
show ipx sap B-45
show ipx settings B-45
show memory B-45
show network <name> settings B -45
show network <name> counters B-45
show ppp on vc <vc_name> counters B-45
show ppp on vc <vc_name> settings B-45
show ppp on interface <name> counters B-46
COUNTERS for PPP BUNDLE 1 B-46
COUNTERS for PPP LINK 1 - 5 B-46
show ppp on interface <name> settings B-46
SETTINGS for PPP BUNDLE 1 B-46
SETTINGS for PPP BUNDLE 1 COMPRESSION
Operational Status - Opened or Not Opened B-47
SETTINGS for PPP LINK 1 - 5 B-47
SETTINGS for PPP LINK 1 - 5 AUTHENTICATION B-48
show ppp settings B-48
show security_option settings B-48
show snmp counters B-48
INPUT COUNTERS B-48
OUTPUT COUNTERS B-49
show snmp settings B-49
show system B-49
show telnet B-50
show tcp counters B-50
TCP COUNTERS B-50
show tcp settings B-50
TCP SETTINGS B-50
show udp B-50
INPUT COUNTERS B-50
OUTPUT COUNTERS B-50
show user <name> settings B-5 1
show vc <vc_name> settings B-51
TELNET B-51
tel net <ip_name_ or_addr> B-51
telnet <ip_name_or_addr> TCP_port <number> B-51
VERIFY B-51
verify filter <filter_name> B-51
TELNET Commands B-51
close B-51
help B-51
send <string> B-51
set_escape <string> B-52
status B-52
CLI Exit Co mm a n ds B-5 2
Bye, Exit, Leave, Quit B-52
Logout B-52
Command Features B-52
Command Retrieval B-52
Positional Help B-52
Command Completion B-52
Output Pause B-53
Command Kill B-53
Comments B-53
3COM CORPORATION LIMITED WARRANTY
FCC CLASS A VERIFICATION STATEMENT
FCC CLASS B STATEMENT
FCC DECLARATION OF CONFORMITY
ACCESSING THE CONFIGURATION
1
INTERFACE
This chapter explains how to attach to the configuration interface locally via the
console port or remotely via a Telnet session. This chapter also int roduces you to
the capabilities and conventions associated with management of your
OfficeConnect Remote 812.
Establishing
Communications
with the
OfficeConnect
Remote 812
Local Connection If you want to attach locally to the OfficeConnect Remote 812 via the console
(serial) port, you will need to connect the supplied serial cable to the Console Port
located on th e un it and the Ser ial Po rt on yo ur c omputer. In addition, you wi ll a l so
need a terminal emulation program appropriate for your computer. See the
following subsections for various emulation options.
No matter which emulator you use, configure your settings to:
9600 baud
8 data bits
no parity
1 stop bit
direct connect
IBM-PC Compatible Computers
Windows Terminal (included with Microsoft Windows) and ProComm Plus are
popular communications packages which support VT100 terminal emulation for
IBM-PC compatible computers. Hyp erTerm, bundled with Windows 95, also
provides terminal emulation.
Macintosh Computers
ProComm, M icroPhone, White Knight, Kermit, Red Ryder, VersaTerm and ZTerm
(a shareware application available on the Internet and many online services) are
popular communications programs which carry vt100 terminal emulation service
for Macintosh computers. If you don’t have a communications package or your
program doesn’t support vt100 emulation, ZTerm will function just as well.
1-2 CHAPTER 1: ACCESSING THE CONFIGURATION INTERFACE
UNIX-Based Computers
Kermit, minicom and tip are typical terminal emulation programs for UNIX-based
computers. Depending on the pla tform you’re using, you may need to modify a
configuration file for vt100 settings.
Remote Connection If you want to attach to the OfficeConnect Remote 812 via the LA N or WAN
interface of the unit, you will need to establish a Telnet connection to the unit.
The OfficeConnect Remote 812 must have an IP address and an administrative
login profile (username and password) in order to connect to it with Telnet. The IP
address and administrati ve lo gin profile are au tom aticall y cr eated when the u nit is
initially configured using the IP Wizard or in DHCP Smar t Mode. The default
username is 'r oot' and the def au lt pas swo rd is '! root '. R efe r to th e Of fic eCon ne ct
Remote 812 ADSL Router Install Guide for information on the IP Wizard or DHCP
Smart Mode initialization. Alternatively, the IP address and administrative login
profile can be created with CLI using the QuickSetup program or using individual
commands.
From W indows 95, you can go to the DOS Window and run:
telnet <ip_address>
This will bring up the login prompt for the unit. Once you have successfully
logged in, the Command Line Interface presentation is the same as if you were
locally attached.
When you want to terminate your Telnet session, type quit at the CLI prompt.
Ch
CLI COMMAND CONVENTIONS AND
2
Command
Structure
TERMINOLOGY
This chapter describes the command syntax, conventions and terminology used
within the Command Line Interface. Reviewing and understanding this chapter is
essential for you to understand subsequent chapters.
Format Commands can be followed by values and/or parameters and values. For example:
add ip network <network_name>
address [ip_addr]
{ interface [eth:1 ] }
add ip network is the command
<network_name> is the (required) value for the command
address is a required parameter
[ip_addr] is the value for the IP address parameter which you must provide
interface is only required if you want to override the default value, which is
eth:1
Parameters
are order independent
{ … } parameters enclosed by curly braces are required, and are provided with
default values. You do not need to specify these param eter s unless you wish to
override t he default.
Values
< … > required values for a command or parameter are enclosed by arrows.
[ … ] range of values following parameters are enclosed in brackets. Inside the
brackets, if you see a:
| (vertical bar) you may select only one of the displayed choices:
[FIRST | SECOND | THIRD]
, (comma) you can select one or more of the displayed choices:
[FIRST,SECOND,THIRD,...]
The type of value you enter must match the type requested. Numbers are
either decimal or hexadecimal. Text can be either a string that you create, or it
2-2 CHAPTER 2: CLI COMMAND CONVENTIONS AND TERMINOLOGY
may be a list of options you must choose from. When choosing an option, type
the text of the option exactly.
Names or Strings
“Double quotation marks” set off user-defin ed st rin gs. If yo u want wh it e spac e
or special characters in a string, it must be enclosed by “double quotation
marks”.
Network Address Formats
Many commands require a network address, to define a link to a remote host,
workstation or netwo rk. Net work ad dr esses ar e sho wn in th is d ocument using t he
syntax described in the following table:
Address Type Format Range
IP_address a.b.c.d 0.0.0.0 to 255.255.255.255
ip_net_address a.b.c.d/mask 255.255.255.255/A,B,C,H
mac_address xx:xx:xx:xx:xx:xx hexadecimal digit pairs
(decimal)
Abbreviation and
Command
Completion
Control Characters
Commands ca n be abbreviated if arguments you write are unique.
For example, you can type se vc jay pa bird, short for: set vc jay password
bird is acceptable, but se vc jay i 222.111.111.111 isn’t unique because i can
stan d for ip , ip_rou ting , or ip_source_validation.
As a convention, some commands illustrated in this manual are abbreviated
and annotated as such (abbr.) for brevity.
Also, some parameters are omitted in examples because they default to
standard values and do not require entry, or are unnecessary for common
configuration. See the CLI Reference section for more details.
Command completion finishes spelling a unique, abbreviated parameter for
you just by pressing the key. It’s handy when you’re in a hurry or uncertain
about a command. For example, if you type add ip n[ESC], it will spell out the
keyword network without losing your place in the command syntax.
Commands ca n be retrieved by typing <ctrl>p [^p] (for previous) and <ctrl>n
[^n] (for next). Command retrieval consults the history of previous f ully enter e d
commands, defaulting at the last ten commands. If an error occurs while a
command is processing, any partial command (up to and including the field in
error) is added to the history list.
The current command can be killed by pressing <ctrl>c [^ c].
A partially completed command line can be reprinted - a useful function if, due
to interrupted output, you’re unsure wh at OfficeConnect Remote 812 has
“seen” up to now - by pressing <ctrl>l [^ l] (for last).
Help
Help is general or positional. Type help <any command> to get a cursory list
of associated commands and its syntax. Type <any command> ? to get more
extensive, positional help for a particu lar field. Help is most useful during
configuration: query the list of possible parameters by typing ? and, when you
find the value you need, type it without losing your place in the argument. Just
be sure to leave a space between the keyword and the question mark.
Conventions
Command Structure 2-3
Conventions
Command Language
Terminology
Most commands are not cas e sens iti ve. As a rule, onl y <name> and [password]
values require typing the correct case.
Configuration changes occur immediately but are l os t on r ebo ot un les s y ou
save them. The save all command places configuration changes in FLASH
ROM (permanent memory) . Th e change s ar e l ost if not sa ved to FLASH ROM or
if power is lost before you can save them.
Commands to delete a network user, interface, route, TCP connection,
community name, network service and others cannot take place unless the
process or function has first been disabled.
Wherever an IP a ddr e ss value is required, you can en t er a host name prov ide d
you have configured a DNS server or put the name and address into the DNS
Local Host table.
The CLI command language creates, manages, displays and removes system
entities. These entities describe system and network connections and processes.
Most of the managed entities in the system are slotted in tables. Some common
examples are:
Network - defines local and remote networks, network connections, hosts
and routers
VC - A table of parameters that describes connection parameters associated
with a remote site. These parameters are used when establishing a network
connection over the WAN.
User - A table of parameters that describes connec tion parameters associated
with Telnet users that wish to attach and remotely manage the unit.
Filter - can be applied to interfaces, connections, and users to control access
through the system
Interface - describes phy sical device s; for exampl e, ports
Syslog Host - receives system messages
DNS Server - translates IP addresses to and from host names
Route - describes a path through the network to anothe r system or network
Table entries are created with an add command, and removed with a delete
command. The add command specifies the most important parameters of the
entry. Ad diti onal p ar ameter s ar e u sual ly s peci fie d with the set command, which is
also used to change configured parameters.
The list command displays table entries. For example, list users displays all
defined administrative login profiles.
The show command displays detai led info rmati on ab out a s peci fic ta ble en try. For
example, show user root displays detailed information for the administrative
login profile root.
2-4 CHAPTER 2: CLI COMMAND CONVENTIONS AND TERMINOLOGY
3
CONFIGURATION METHODS
OfficeConnect Remote 812 CLI offers three setup choices, all of whic h are
described in this section: the automated, Quick Setup method, the QuickVC Setup
method, and the manual method. Review the capabilities of each below and
decide which configuration method best suits your needs, then proceed to the
appropriate chapter for detailed configuration guidelines for each method.
Quick Setup
Instructions
QuickVC Setup
Instructions
The Quick Setup program for the CLI is designed to get your OfficeConnect
Remote 812 up and running fast. To ensure that you have all the information you
need on hand before you engage Quick Setup, we have supplied a script to jot
down system, management, and LAN configuration information. We recommend
that you fill out either script completely to get the full benefit of the program.
Used in combination with the QuickVC Setup program, Quick Setup allows
virtually complete console-based configuration of your OfficeConnect Remote 812
without requiring any knowledge of CLI command syntax.
The questions beginning in the next chapter represent nearly the full text of what
Quick Setup would query if you were to use every service available as configured
on the CLI. If you are using partial service - just IP configuration, for example Quick Setup will skip the Bridging section. Default values are enclosed in brackets
[ ].
If at any time you decide to quit Quick Setup, you can type <ctrl>c (^c)
throughout the program.
The QuickVC Setup program for the CLI is designed to get virtual circuits for your
OfficeConnect Remote 812 configured quickly. To ensure that you have all the
information you need on hand before you enga ge QuickVC Setup, we have
supplied a script to jot down information for VC connections. We recommend that
you fill out either script completely to get the full benefit of the program.
Used in combination with the Quick Setup program, QuickVC Setup allows
virtually complete console-based configuration of your OfficeConnect Remote 812
without requiring any knowledge of CLI command syntax.
The questions beginning in Chapter 5 represent nearly the full text of what
QuickVC Setup would query if you were to use every service available as
configured on the CLI. If you are using partial service Quic kVC Setup will skip
some sections. Default values are enclosed in brackets [ ].
3-2 CHAPTER 3: CONFIGURATION METHODS
Manual S etup
Instructions
Once you become familiar with the CLI interface, you might find it more efficient
to manage the OfficeConnect Remote 812 manually. Manual configuration is
most versatile in that you only enter commands that need to effectively change
from the current configuration. Also, many of the advanced features can only be
accessed through manual configuration (such as filtering).
4
CLI Quick Setup
Script
Introduction The CLI Quick Setup pr ogr am all ows you to quic kly c onfi gure LAN- side, global and
QUICK SETUP
This chapter will describe in detail the operations of the Quick Setup program. It
will identify the required information, steps involved, and sample output scripts
from the execution of this program.
management settings for your OfficeConnect Remote 812. Instead of using
cryptic commands, you will simply respond to a series of questions regarding
different aspects of your configuration. The program will convert your responses
into the appropriate CLI commands and execute them.
The CLI Quick Setup program automatically executes when the OfficeConnect
Remote 812 is powered on with no configuration and all DIP switches in the back
of the unit are in the OFF position. This boot mo de is called Unconfigured Mode.
An OfficeConnect Remote 812 unit can be restored to an unconfigured state by
ensuring that all DIP switches are in the OFF position and by deleting the
configuration by performing one of the following:
1 Press the Configuration reset button on the back of the unit while powering on.
2 Issue the delete configuration command from the CLI.
3 Use the browser-based OfficeConnect Remote 812 Manager to delete the
configuration.
For more information on the Of ficeConnect Re mote 812 boot modes see Chapter
2: Getting Started in the OfficeConnectRemote 812 A DSL Router Install Guide.
Instructions The following sections contain the CLI Quick Setup script. You will be required to
enter information concerning your network configuration. Questions in the script
are presented here in tables. Write the appropriate information for your desired
configura tion in the following tables.
Setup Script The OfficeConnect Remote 812 Quick Setup will let you set up LAN-side and
global configuration for your system.To configure wide-area profiles you should
run the OfficeConnect Remote 812 VC Wizard using the QUI CKVC command.
Do you want to continue with OfficeConne ct Remote 812 Quick Setup?
4-2 CHAPTER 4: QUICK SETUP
The OfficeConnect Remote 812 Quick Setup allows you to setup a simple
configura tion for IP, IPX, and bridging.
Please answer the following questions with "yes" or "no" to indicate which
portions of the system you want to configure.
When Quick Setup di splays a question it will display a default answer in square
brackets, like "[yes]". If you simply press enter, this is the answer that will be used
for you.
Password Protection
Question Default Your System
Do you want the CLI to be password
protected?
What is the console login password (no
more th a n 8 ch aract er s)?
[no ]
[ ]
Which portions of the network do you want to configure?
Question Default Your System
Network management ? [yes]
IP ? [yes]
IPX ? [no]
Bridging ? [no]
Quick Setup Identification information
Question Default Your System
Enter the name of your system: [ ]
Who is the system contact person? [ ]
Where is thi s system located? [ ]
Quick Setup Management Information
Question Default Your System
Do you want to be able to manage the system via
SNMP?
[yes]
An SNMP community names a group of systems that can manage yo ur system via
SNMP. It is a rudimentary form of security.
Question Default Your System
What SNMP community will manage this system? [public]
CLI Quick Setup Script 4-3
Along with a community name, you can limit access to a specific management
station. "0.0.0.0" means any station.
Question Default Your System
What is the IP address of the station for this
community?
[0.0.0.0]
You also need to specify if this community can only read information, or read and
write information.
Question Default Your System
Can this community change management
information?
[yes]
This completes the section on SNMP management configuration.
TELNET information
Question Default Your System
Do you want to allow command line management via
TELNET?
[yes]
For TELNET management of the system, you need to create a user name and
password to control access.
Question Default Your System
What user name wil l be allowed to manage th is system? [root]
What password will be used for this user ? [ ]
Quick Setup IP inf ormation
The OfficeConnect Remote 812 uses a network name to identify the network for
future managment commands.
Question Default Your System
Enter the network name of your IP network: [ip]
Enter the IP add ress for the Office Connect Remote
812:
[192.168.200.25
4]
The IP mask can be specified either as a class ("A", "B", or "C"), the number of
one bits in the mask, or as an address in the format 255.x.x.x.
4-4 CHAPTER 4: QUICK SETUP
Question Default Your System
What should the the mask be set to? [C]
You need to specify the frami ng for the IP network. It should be either
"ethernet_ii" or "snap".
Question Default Your System
What is the framing for the IP network? [ethernet_ii]
You can use the Routing Information Protocol (RIP) to exchange routing
information with other routers on the network.
Question Default Your System
Do you want to run RIP? [yes]
Choose the versi on of RIP to run: [v2]
The OfficeConnect Remote 812 can act as a DHCP server , pr oviding IP addr esses to
other stations on the local lan.
Question Default Your System
Do you want the OfficeConnect Remote 812 to act
as a DHCP server?
Enter the start address for the DHCP IP address
pool:
Enter the end address for the DHCP IP address
pool:
[yes]
[ ]
[ ]
It is possible to restrict access to the TFTP server to a specific system or a list of
systems. Quick Setup will allow you to enter one system that is allowed or allow
access to all systems.
Question Default Your System
Do you want to allow all systems to access the TFTP
server?
[yes]
IP setup is completed.
Quick Setup IPX information
The network name is used by the OfficeConnect Remote 812 to ide ntify your IPX
network.
CLI Quick Setup Script 4-5
Question Default Your System
Enter the name of your network: [ipx]
The network number is a non-zero hexadecimal number of up to 8 digits.
Question Default System
Enter the ipx network number: [ ]
You need to specify the framing for the IPX network. It should be one of the
following: “ethernet_ii”, “snap”, “dsap”, “novell_8023.”
Question Default System
What is the fram ing for the IPX netw ork ? [ethernet_ii]
Quick Setup Bridge Informat ion
The network name is used by the OfficeConnect Remote 812 to identify your
bridging setup.
Question Default Your System
Enter the network n a m e : [bridge]
The spanning tree algorithm is used to eliminate loops in a network that is linked
together with bridges. You should run the spanning tree algorithm in the
OfficeConnect Remote 812 if you have multipl e 812s linking your network to
another network; or if you think that there might be loops in your network.
Question Default System
Do you want to run the spanning tree algorithm? [no]
Would you like to review your current settings before executing [yes]?
Sample Identific ation Information
This section contains a sampl e of possible settings.
4-6 CHAPTER 4: QUICK SETUP
Management Information:
Console Login Required: yes
Console Logi n Password: password
SNMP Management:
SNMP Community: public
SNMP IP Address: 0.0.0.0
SNMP Read&Write: yes
TELNET Management:
TELNET User: root
TELNET Password: !root
IP Information:
IP Network Name: ip
IP Network Address: 192.168.200.254
IP Mask: C
IP Frame Type: ethernet_ii
IP RIP: v2
DHCP Server: Enabled
DHCP Pool Start IP Address: 192.168.200.1
DHCP Pool End IP Address: 192.168.200.40
TFTP Server Information:
TFTP Access: Any system
IPX Information:
IPX Network Name: ipx
IPX Network Number: 12345661
IPX Frame Type: ethernet_ii
Bridge Information:
Bridge Network Name: bridge
Spanning Tree: no
Do you want to change any answers [no]?
Do you want to actually execute these commands [yes]?
Loading...