3Com ADSL Modem Ethernet User Manual

3Com HomeConnect ADSL
Modem Ethernet

CLI User’s Guide

Version 1.0

3Com Corporation
3800 Golf Road
Rolling Meadows, IL
60008

Copyright © 1999, 3C o m Corporation. All rig hts rese rved. N o p art of this documentat i on may b e reprodu ce d
in any form or by any means or used to make any derivative work (such as translation, transforma tion, or
adaptation) without written permission from 3Com Corporation.

3Com Corporation reserv es t he r i ght t o revise thi s d oc um ent atio n an d to make changes in c ont ent from tim e
to time without obligation on the part of 3Com Corporation to provide notification of such revision or change.

3Com Corporation provides this documentation without warranty 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 make improvements or changes in the product(s) and/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 documentation and the software described herein are
provided to you subject to the following:

United States Go vern men t Lege nd: All technical data and computer software is commercial in nature and
developed solely at private expense. Software is delivered as Commercial Computer Software as defined in
DFARS 252.227-7014 (June 1995) or as a commercial item as defined in FAR 2.101(a) and as such is provided
with only such rights as are provided 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 FAR52.22 7-14 (June

1987), whichever is applic able. You agree not to remove or deface any por ti o n of an y leg end provided on any
licensed program or documentation contained in, or delivered to you in conjunction with, this User Guide.

Unless otherwise indicated, 3Com registered trademarks are registered in the United States and may or may
not be registered in other countries.

3Com and the 3Com logo are registered trademarks of 3Com Corporation. ATMLink, AutoLink, CoreBuilder,
DynamicAccess, FDDILink, FMS, NetProbe, and PACE are trademarks of 3Com Corporation. 3ComFacts is a
service mark of 3Com Corporation.

Microsoft, MS-DOS, Windows, and WindowsNT are registered trademarks of Microsoft Corporation. Novell
and NetWare are registered trademarks of Novell, Inc. UNIX is a registered trademark of X/Open Company,
Ltd. in the United States and other countries.

Other brand and product names may be registered trademarks or trademarks of their respective holders.

YEAR 2000 INFORMATION:

For information on Year 2000 compliance and 3Com products, visit the 3Com Year 2000 web page:

http://www.3Com.com/products/yr2000.html

1 ACCESSING THE CONFIGURATION INTERFACE

Establishing Commun ica t ion s 1-1

Local Connection 1-1

IBM-PC Compatible Computers 1-1
Macintosh Computers 1-1
UNIX-Based Computers 1-1

Remote Connection 1-2

2 CLI COMMAND CONVENTIONS AND TERMINOLOGY

Command Structure 2-1

Format 2-1

Parameters 2-1
Values 2-1
Names or Strings 2-1

Network Address Formats 2-2
Abbreviation and Command Completion 2-2
Control Characters 2-2
Help 2-2
Conventions 2-2
Command Language Terminology 2-3

3 MANUAL SETUP

Configuration Overview 3-1
Managing Bridge Ports 3-1

Configuring ATM Information 3-2

Advanced Bridging 3-3

Advanced Bridging Settings 3-3
Restricting LAN Access 3-4
Canned Filters 3-4

IP Configuration 3-5

IP Wizard 3-5
Configuring an IP Network 3-6
Configuring Static Routes 3-6
Configuring DNS 3-7
IP Tools 3-7

System Administration 3-7

Setting Date and Time 3-7
Setting System Identification 3-8
Configuring TELNET Login Access 3-8
Providing TFTP Access 3-9
Setting Password Protection 3-9
Configuration Scripting 3-10

4 FILTERING CAPABILITIES

Introduction 4-1
Filtering Capabilities of the 3C om HomeConnect ADSL Modem

Ethernet 4-1

Filter Classes 4-1
Filter Types 4-1
Data Filters 4-2
Generic Filters 4-2

Creating Filters 4-2

Filter File Components 4-2
Protocol Sections/Bridge 4-2
Protocol Rules 4-3
Generic Filter Rule 4-4
Step by Step Guide to Creating Filter Files 4-4

Assigning Filters 4-5

Interface Filters 4-6
Input Filter 4-6
Output Filters 4-6
Input Filters vs. Output Filters 4-6
Port Filters 4-6

Applying Filters 4-6

Apply a Filter to an Interface 4-6
Configuring a Filter for a Port 4-7
Setting Filter Access 4-7

Managing Filters 4-7

Displaying the Managed Filter List 4-7
Adding Filters to the Managed List 4-7
Removing a Filter from an Interface 4-8
Removing a Filter from a Port Profile 4-8
Deleting a Packet Filter 4-8

Verifying Filter File Syntax 4-8
Showing Filter File Contents 4-8

5 UPGRADING 3COM HOMECONNECT ADSL MODEM ETHERNET

O

PERATIONAL SOFTWARE

Introduction 5-1
Serial Port Update 5-1

3Com Instant Update Process 5-1
3Com FTP Site 5-1
3Com HomeConnect ADSL Modem Ethernet CD 5-2
Installing Operational Software via DOS 5-2

Update Using Built-in Update Software 5-3

update software ftp <filename> 5-3
update software ftp <filename> 5-4
update software tftp <filename> 5-4

A CLI COMMAND DESCRIPTION

CLI Commands A-1

ADD A-1
add bridge access _mac_address <mac_address> A-1
add dns server <domain_name> A-1
add filter <filter name> A-1
add ip defaultroute gateway <IP_address> A-2
add ip network <network_name> A-2
add ip route <ip_net_address> A-2
add snmp community <community_name> A-3
add snmp trap_community <name> A-3
add syslog <ip_addr> loglevel [loglevel] A-3
add tftp client <ip_addr> A-3
add user [name] password [password] A-3
CAPTURE TEXT A-4
DELETE A-4
delete bridge access_mac_address <mac_address> A-4
delete configuration A-4

...............................................delete dns server <domain_name> A-4

delete file <file_name> A-4
delete filter <filter_n ame> A-4

delete ip network <network_name> A-4
delete ip route <IP_address> A-4
delete snmp community <name> A-4
delete snmp trap_co mmunity <name> A-4
delete syslog <ip_addr> A-5
delete tftp client <ip_addr> A-5
delete user <name> A-5
DISABLE A-5
disable bridge access_mac_addresses A-5
disable bridge forwarding A-5
disable bridge spanning_tree A-5
disable ip network <network_name> A-5
disable link_traps interface <int erface_name> A-5
disable port <port number> A -5
disable security_option snmp user_access A-5
disable security_option remote_user administration A-5
disable snmp authentication traps A-5
disable user <user_name> A-5
DO A-6
do <command_inputfile> output [outputfile] A-6
ENABLE A-6
enable bridge access_mac_addresses A-6
enable bridge forwarding A-6
enable bridge spanning_tree A-6
enable ip network <network_name> A-6
enable link_tr a ps int e rfa c e < inte r fa c e _n ame> A-6
enable port <port number> A-6
enable security_option remote_user administration A-6
enable security_option snmp user_access A-6
enable snmp authentication traps A-6
enable user <user name> A-6
exit CLI A-6
HELP A-7
help <command> A-7
HISTORY A-7
history A-7
idle timout <minutes> A-7
LIST A-7

list bridge access_mac_addresses A-7
list bridge forwarding A-7
list connection events A-8

..............................................................................list dns servers A-8

list facilities A-8
list filters A-8
list files A-8
list interfaces A-8
list ip addresses A-8
list ip arp A-9
list ip networks A-9
list ip routes A-9
list ports A-9
list snmp communities or list snmp trap_communities A-9
list syslog A-10
list tftp clients A-10
list users A-10
PAUSED COMMANDS A-10
PING A-10
ping <ip_name_or_addr> A-10
REBOOT A-10
RENAME A-11
rename file <input_file> <output_file> A-11
reset ethernet counters A-11
reset port <port number> A-11
SAVE A-11
save all A-1 1
SET A - 11
set adsl option <optn_value> A-11
set adsl power hi A-11
set adsl power lo A-11
set adsl psdm <psdm_value> A-11
set adsl reset A-11
set bridge A-12
set command A-12
login_required A-12
password A-12
set date <date> A-12

set facility <facility_name> loglevel [level] A-12
set interface <interface_name> A-13
set port <port number> A-13
set snmp community <community_name> A-14
set snmp trap_community <name> A-14
set system A-14
set syslog <IP_address> loglevel [level] A-14
set time <time> A-15
set user <user_name> A-15
SHOW A-15
show adsl configuration A-15
show adsl performance A-15
show adsl statistics A-16
show adsl transceiver_status A-16
show adsl version A-16
show atm status A-16
show bridge settings A-16
show command A-17
show crash_vector A-17
show date A-17
show file <filename> A-17
show filter <filter_name > A-17
show ethernet counters A-17

INPUT COUNTERS A-17

OUTPUT COUNTERS A-18
show ethernet settings A-18
show ip settings A-18
show memory A-18
show port <port number> settings A-18
show security_option settings A-18
show snmp counters A-18

INPUT COUNTERS A-18

OUTPUT COUNTERS A-19
show snmp settings A-20
show system A-20
show user <name> settin gs A-20
TELNET A-20
telnet <ip_name_or_addr> A-20

telnet <ip_addr> TCP_port <number> A -20
UPDATE A-20
update software ftp <filename> A-20
update software tftp <filename> A-21
VERIFY A-21
verify filt e r < fi lt e r_ n a me> A-21

TELNET Commands A-21

close A-21
help A-21
send <string> A-21
set_escape <string> A-21
status A-21

CLI Exit Commands A-21

Bye, Exit, Leave, Quit A-21
Logout A-22

Command Features A-22

Command Retrieval A-22
Positional Help A-22
Command Completion A-22

A-22
Output Pause A-22
Command Kill A-22
Comments A-22

TECHNICAL SUPPORT AND LIMITED WARRANTY

Technical Support i

Technical Support Hotline i
Online Technical Support i
If you need to Return the Modem to Us i

Manufacturer’s Declaration of Conformity ii

Caution to the User ii

Fax Branding iii
Radio and Television Interference iv
For Canadian Modem Users v

Industry Canada (IC) v
Notice v
«AVIS : vi

3Com Corporation Limited Warranty vii

YEAR 2000 WARRANTY vii
Obtaining Warranty Service viii
Warranties exclusive ix
Limitation of Liability ix
Disclaimer ix
Governing Law x

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 introduces you to
the capabilities and conventions associated with manag ement of your 3Com
HomeConnect ADSL Modem Ethernet.

Establishing Communications

Local Connection If you want to attach locally to the 3Com HomeConnect ADSL Modem Ethernet

via the console (serial) port, you will need to conne ct the supplied serial cable to
the Console Port located on the unit and the Serial Port on your computer. In
addition, you will also need a terminal emulation program appropriate for your
computer. See the following subsec tions 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

BM-PC Compatible Computers

I

Windows Terminal (i ncluded with Microsoft Windows 3.x) and ProComm Plus are
popular communications packages which support VT100 terminal emulation for
IBM-PC compatible comput ers. HyperTerminal, bundled with Windows 95 and 98,
also provides terminal emulation.

Macintosh Computers

ProComm, MicroPhone, 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 emulati on, ZTerm will function just as well.

UNIX-Based Computers

Kermit, minicom and tip are typical terminal emulation programs for UNIX-based
computers. Depending on the platform you’re using, you may need to modify a
configurati o n file for v t100 settings.

1-2 CHAPTER 1: A CCESSING THE CONFIGURATION INTERFACE

Remote Connection If you want to attach to the 3Com HomeConnect ADSL Modem Ethernet vi a the

LAN or WAN interface of the unit, you will need to establish a Telnet connection
to the unit.

The 3Com HomeConnect ADSL Modem Ethernet 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 administrative login profile are automatically
created when the unit is initially configured using the IP Wizard. The default
username is ’root’ and the default password is ’!root’. Refer to the Chapter 3 for
how to use the IP Wizard to assign an IP address to the unit. Alternatively, the IP
address and administrative login profile can be created using CLI commands.

From Windows 95, you can go to the DOS Window and run:

telnet <ip_address>

This will bring up the lo gin prompt for the unit. Once you have successfully
logged in, the Command Line Interface presentation is the same as if you were
locally a tt a ched.

When you want to terminate your Telnet session, type quit at the CLI prompt.

CLI COMMAND CONVENTIONS AND

2

Command Structure

Format Commands can be followed by values and/or parameters and values. For example:

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.

dd ip network <network_name> address [ip_addr]

D

■ 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 pro v ide

Parameters

■ are order independent

■ { … } parameters enclosed by curly braces are required, and are provided with

default values. You do not need to speci fy these paramet ers unle ss you wish to
override the default.

Values

■ < … > required values for a command or parameter are enclosed by arrows.

■ [ … ] range of values follo wing par ameter s ar e encl osed in bracket s. Insi de 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 ch oi c es:

[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 may be a
list of options you must choose from. When choosing an op tion, type the text of
the option exactly.

Names or Strings

“Double quotation marks” set off user-defined st rin gs. I f you wan t whi te sp ace or
special characters in a string, it must be enclosed by “double quotation marks”.

2-2 CHAPTER 2: CLI COMMAND CONVENTIONS AND TERMINOLOGY

Network Address Formats

Many commands require a network address, to define a link to a remote host,
workstation or networ k. Netw ork addr esses ar e shown in this document using the
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 (decimal)
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 pairs

Abbreviation and

Command

Completion

■ Commands can be abbreviated if arguments you write are unique.

For example, se po 2 vc 33, short for: set port 2 vci 33 is acc e ptable, but se

po 2 v 33 isn’t unique because v can stand for vpi or vci.

■ As a convention, some commands illustrated in this manual are abbrevi ated

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 t he command syntax.

Control Characters ■ Commands can be retrieved by typing <ctrl>P [^P] (for previous) and <ctrl>n

[^n] (for next). Command ret rieval consul ts th e history of previous fully enter ed
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 lis t.

■ The current command can be killed by pressing <ctrl>C [^C].

■ A partially comp leted co mmand l ine can b e reprinted - a useful func tion if, due

to interrupted output, you’re unsure what 3Com HomeConnect ADSL Modem
Ethernet 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, positi onal help for a particular field. Help is most useful during
configuration: query the list of possible parameters b y 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 bet w een the keyword and the question mark.

Conventions ■ Most commands are not case sensitive. As a rule, only <name> and [password]

values require typing the correct case.

■ Configuration changes are lost on reboot unless you save them. The save

all command places configuration changes in FLASH ROM (permanent

memory). The changes ar e lost if not saved to FLASH ROM or if power is lost
before you can save them.

■ Commands to change most bridge port settings do not take effect until the

port has been disabled and re-enabled.

Command Structure 2-3

Command Language

Terminology

The CLI command language creates, manages, displays and r emoves system
entities. These entiti es describe system and network connections and pro c esses.
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

■ Port - A table of pa rameters th at describe s the char acterist ics of a b ridge port .

These parameters are used when establishing a network connection over the
WAN

■ User - A table of par ameters that describes connection parameters associated

with Telnet users that wish to attach and remotely manag e the unit

■ Filter - can be applied to interfaces, c onnections, and theernet por t to control

access through the system

■ Interface - describes physical devices; for example, ports

■ Route - describes a path through the net w ork to another system or netwo rk

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 . Additional parameters are usually specified with the set command, which is
also used to change configured parameters.

The list command displays table entries. For example, list users displays al l
defined administrative login profiles.

The show command d isplays detaile d informa tion about a specifi c tabl e entry. For
example, show user root displays detailed information for the administrative
login profile root.

2-4 CHAPTER 2: CLI COMMAND CONVENTIONS AND TERMINOLOGY

3

MANUAL SETUP

This chapter describes how to manually setup the 3Com HomeConnect ADSL
Modem Ethernet.

Configuration Overview

A bridge connects two or more physical networks together to function as a single,
large network. The 3Co m HomeConnect ADSL Modem Ethernet is a learning
bridge. A learning bridge does more than just link networks; it separates network
traffic and f orwards only the packets that need to be forw arded.

Bridges separate traffic by examining the Media Access Control (MAC ) addresses
contained in data packets. MAC addresses uniquely identify e ach machine
attached to a network segment. A data packet is not forwarded to another
segment if its destination MAC addre ss resides on the same segment as its source.

To efficiently separate traffic, the bridge maintains a Bridge Forwardi ng Table. The
table contains a list of MAC add resses and their associated network segmen ts. The
table is built dynamically from the source MAC addresses of data packets passing
through the bridge.

The 3Com HomeConnect ADSL Modem Ethernet bridge supports the Spanning
Tree Protocol (STP). This feature is used when two ne tworks are joined by two
bridges forming a looped netw ork. STP pr events the dat a packets fr om cir cling the
two networks .

The 3Com HomeConnect ADSL Modem Ethernet is a 9-port bridge with a single
ethernet port on the Ethernet physical interface (named eth:1) and 8 ATM PVCs
(WAN ports) through the ATM/ADSL physical interface (named atm:1). Bridge
ports are numbered 1through 9, with the Ethernet port d e signated as port 1. By
default, packets are not bridged between the WAN ports.

Managing Bridge Ports

The rest of this chapter provides an overview of the 3Com HomeConnect ADSL
Modem Ethernet basic operations and configuration. The chapter is broken into
the following sections:

■ Bridge Port Management

■ Advanced Bridging

■ IP Access

■ System Administration

Each Bridge W AN Port (2-9) has an associated profile for storin g information
about the port. With this profile, you specify ATM Virtual Channel information,
description information and whether the port is currently enabled or disabled.

3-2 CHAPTER 3: MANUAL SETUP

You modify the profile using set port commands to setup the WAN connection
and network information.

Remember to save your configu ration using the save all command before
rebooting your 3Com HomeC on nect AD SL Modem Et he rn et so that your changes
will be written to permanent FLASH memory.

■ You can obtain a list of all currently configured port profiles using the

command:

list ports

■ You can view the contents of a particular profile using the command:

show port <port_number>

The 3Com HomeConnect ADSL Mo dem Ethernet always has a default profile.
Any value that is not set in a profile that you create will assume the values that ar e
present in the default profile.

■ You can view the default profile using the co m ma n d:

show port default

Configuring ATM

Information

Bridge port profiles ca n be en a b le d or di sa bled. When a port is enabl ed us in g the
enable port command, the 3Com HomeConnect ADSL Modem Ethernet r ead s the
connection parameter s for the port from the profile and establishes a connection.
When a port is disabled using the disable port command, the connection will be
terminated and no ot her data will be dire cted out the bridge port. Configuration
changes to a bridge port profile do not take effect until the next time the profile is
enabled. Thus, if you want to make changes to the prof ile you should disable the
profile, make your changes, and then re -enable the profile.

■ For example, if you want t o change the VCI value to 35 for bridge port 2:

disable port 2
set port 2 vci 35
enable port 2

The 3Com HomeConnect A DSL Modem Ethernet b ridges packe ts over ATM virtual
circuits. ATM allows for permanent connections (PVCs) and switched connections
(SVCs). Each PVC is identified by its Virtua l Path and Connection Identifiers
(VPI/VCI). The VPI/VCI uniquely specifies a path to a remote site and is placed in
the ATM cell header that is used to route each cell through the network.

Two ports with t he same VPI and VCI can not be enabled simultaneously. You
should disable all ports that use the same VPI/VCI and then enable the one that
should be active.

For SVCs, there i s not a fi xed VPI /VC I. In stead, a de stina tio n add r ess i s used to set
up a path through the ATM backbone network wh en the co nn e c tio n is to be
established.

Currently, the SVC capability is di sabled i n the 3Com HomeCon nect ADSL Mode m
Ethernet. The VPI/VCI values to use for a bridge port are specified using the ’set
port’ command:

set port <port_number> vci <vci_value> vpi <vpi_value>

Advanced Bridging

Advanced Bridging 3-3

The 3Com HomeConnect ADSL Modem Ethernet supports Unspecified Bit Rate
(UBR) traffic. The modem will normally attempt to use all of the available
upstream bandwidth when transmitting data. Optionally, on a bridge port basis,
the upstream traffic can be ’shaped’ to use only a portion of the available
bandwidth using the Peak Cell Rate parameter.

The Peak Cell Rate is specified in cell-per-se c ond. Use the following for m ula to
determine the Peak Cell Rate to enter for a given throughput.

pcr_value = throughput / 3392
where:
throughput is t he desired transmit rate in bits/second.

■ To set th e Peak Cell Rate use the command:

set port <port_number> pcr <pcr_value>

Remember to save your configuration using the save all command before
rebooting your 3Com Ho meC onnect ADSL Mod em Ether ne t so that your changes
will be written to permanent FLASH memory.

Advanced Bridging

Settings

Bridging is globally enabled by default, to disable bridging use the disable bridge
forwarding command.

The advanced bridging configuration options include Aging Time, Forward Delay,
Spanning Tree, and Spanning Tree Priority.

■ To see the cur rent settings for these options, use the command:

show bridge

Except for enabling Spanning Tree, most users do not need to change the
advanced parameters from their default settings.

The Aging Time is the time (in seconds) for aging out forwarding table
information.

■ To change t he Aging Time, use the command:

set bridge aging_time <seconds>

The Forward Delay is the time (in seconds) to wait while learning forwarding
information before starting to bridge packets.

■ To change t he Forwarding Delay, use the command:

set bridge forward_delay <seconds>

The Spanning Tree Protocol is used to eliminate network loo ps between bridges.

■ To disable or enable Spanning Tree, use the commands:

disable bridge spanning_tree or
enable bridge spanning_tree

3-4 CHAPTER 3: MANUAL SETUP

The Spanning Tree Priority is the priority assigned to a bridge that is running the
Spanning Tree Protocol. It is used for prioritizing the bridges when Spanning Tree
is enabled.

■ To change the Spanning Tree Priority, use the command:

set bridge spanning_tree_priority <priority value>

Restricting LAN Access Access to the bridging functions of the 3Com HomeConnec t ADSL Modem

Ethernet can be restricted to certain MAC addresses by using the Access MAC
Address feature. When enabled, only packets sourced by or destined for
workstations with MAC addresses in the Access MAC Address Table will be
bridged.

■ To add a MAC address to the Access MAC Address Table, use the command:

add bridge access_mac_address <mac _addr>

Note: the mac address should be entered in the form: xx.xx.xx.xx.xx.xx

■ To delete a MAC address from the Access MAC Address Table, use the

command:

delete bridge access_mac_address <mac _addr>

■ To enable the use of the Access MAC Addr ess feature, use the comm and:

enable bridge access_mac_addresses

■ To disabl e the use of the Access MAC Address feature, use the command:

disable bridge access_mac_addresses

Canned Filters The 3Com HomeConnect ADSL Modem Ethernet provides sophisticated generic

filtering capabilities. Normally, filters must be created with a text editor, copied to
the unit, and applied to the appropriate interface or bridge port. This process is
described in the chapter on Filtering.

To simplify this process, several pre-programmed filters installed in the unit. These

“canned” filters allow or restrict certain common protocols from being
transported over a Bridge WAN port. The filters can be applied to a Bridge WAN
port with a single command.

The following canned filters are pr e-programmed:

Table 3-1 Pre-Programmed Filters

Filter Name Function

NO_IP Do not allow IP packets
NO_IPX Do not allow IPX packets
NO_IP_IPX Do not allow IP or IPX packets
ONLY_IP Only allow IP packets
ONLY_IPX Only allow IPX packets
ONLY_IP_IPX Only allow IP or IPX packets
ONLY_PPPOE Only allow PPP-Over-Ethernet packets

■ To apply a canned filter to a bridge port, use the command:

IP Configuration 3-5

set port <port_number> filter <filter_name>

■ To disable port filtering, use the command:

set port <port_number> filter none

IP Configurati on To allo w r emote SN MP and Telnet management of the 3C om HomeCo nnect ADSL

Modem Ethernet you must configure the unit’s IP stack. The IP stack can receive
packets from any bridge port.

Remember to save your configuration using the save all command before
rebooting your 3Com HomeC onn ect ADSL Mod em Ether net so that your changes
will be written to permanent FLASH memory.

IP Wizard The IP Wizard is designed to help you assign a specific IP address to your unit.

In order to manage the 3Com HomeConnect ADSL Modem Ethernet, the unit
must be assigned an IP a ddress. You must also have an administrative l ogin pr o fil e
(user name and password) assigned.

To access the IP Wizard, go to Start > Pr ograms > 3Com HomeConnect ADSL
Modem Ethernet, and click on "IP Wizard".

IP Wizard will search the LAN for all unconfigured 3C om HomeConnect Modems.
As each unconfigur ed unit is found, the unit’s MAC address is placed in the
selection box. For mul tiple HomeConnect modems, you can determine which
MAC address belongs to the one you want to configure by disconnecting the
HomeConnect’s Ethernet cable and running IP Wizard a gain. The missing MAC
Address belongs to that unit.

Select which HomeConn ect Modem you want to configure and enter its LAN IP
address and netmask; then press Set.

If you assign the IP address with the IP Wizard, the administrative login name is

root and the password is !root. After you access the unit, you are strongly
advised to delete this login profile and create a new one with a secure

3-6 CHAPTER 3: MANUAL SETUP

name and passwor d. (M aximum cha racter length of login name = 32, passwor d
maximum character length = 15.)

Configuring an IP

Network

The 3Com HomeConnect AD SL Modem Ethernet can have mor e than one IP
address (i.e., bel ong to mor e than one IP ne twork). To configure an IP addr ess use
the add ip network command. Each network has a network name. You will use
the network name when entering commands related to the network.

The CIDR-supporte d network address includes a local station address and subnet
mask using the format: nnn.nnn. nnn.nnn/A B C or 8-30. The first 4 octets describe
the IP address, followed by the subnet mask (contiguous) designator.

Y o u can speci fy the su bnet in o ne of two way s: a class or numeri cal desi gnation . If
you specify a Class C subnet mask, for instance, this command will generate a

255.255.255.0 sub net valu e for you. I f you spe cify the num ber of bits (to be set t o

1), the acceptable range is 8-30. The network address is invalid if the portion of
the station address not covered by the mask is 0.

Defining a numerical subnet is useful when your value falls in between classes.
Y o u can al so omit the mask altogether; it will automatically be calculated from the
address.

■ To add an IP network, use the command:

add ip network <network name>

address <ip address/mask>
frame [ETHERNET_II | SNAP]

■ To list the defined IP networks, use the command

list ip networks

Configuring Stat ic

Routes

■ By default, the network is enabled when it is created. You can disable the

network using the following command:

disable ip network <network name>

■ You can delete a disabled network using the command:

delete ip network <network name>

The reconfigure ip network command can be used to modify an existing IP

network’s address or frame type.

A Static route is a configured route that will remain in the IP routing table until
deleted.

■ To add a St atic route over the LAN, use the command:

add ip route <ip network address>

gateway <ip address>

metric <metric>

The route will appea r in the IP routing table. You can display all IP routes with the
list ip routes command.

To add a default route, use the command:

add ip default route

gateway <ip_address>
metric <metric>

System Administration 3-7

The route will appear as destination 0.0.0.0 in the IP routing table.

■ To delet e an IP Static route, use the command:

delete ip route <ip network address>

Configuring DNS You can configure the 3Com HomeConnect ADSL Modem Ethernet to ac cess a

DNS server to resolve host names. This facility is used by the ping, telnet, rlogin
and update software ftp commands.

DNS server entries are stored in the DNS Serv er Table.
To add a DNS server use the command:

add dns server <domain_name>

primary <ip_addr>
secondary <ip_addr>

The <domain_name> parameter can be a specific domain (i.e., 3com.com) or it
can be the wildcard character ’*’, representing all domains. You can specify
different DNS servers for different domains. When searching for the appr opriate
DNS server, the modem first searches the local DNS server table for a entry for the
specific domain of the host name you are attempting to resolve. If no specific
entry is found, the wildcard entry is used.

IP Tools The 3Com HomeConnect ADSL Modem Ethernet CLI provides a stand ar d set of IP

System Administration

To list the entries in the DNS Server Table use the command:

list dns servers

To delet e an entry from the DNS Server Table use the command:

delete dns server <domain_name>

where domain name is the specific domain or the wildcard character ’*’.

utility prog rams including Ping, TELNET and RLOGIN.

This section provides details and examples for performing the following system
administration tasks:

■ Setting Date and Time

■ Setting System Identification

■ Configuring TELNET Login Access

■ Providing TFTP Access

■ Setting Password Protection

■ Configuration Scripting

Remember to save your configuration using the save all command before
rebooting your 3Com HomeC onn ect ADSL Mod em Ether net so that your changes
will be written to permanent FLASH memory.

Setting Date and Time Y ou can obtain the current date, time and system uptime using the command:

show date