3Com HomeConnect 3CP3647 Cli User's Manual
  1. Manuals
  2. Brands
  3. 3Com Manuals
  4. Modem
  5. HomeConnect 3CP3647
  6. Cli user's manual

3Com HomeConnect 3CP3647 Cli User's Manual

Adsl modem ethernet
Hide thumbs Also See for HomeConnect 3CP3647:
Table of Contents

Advertisement

Quick Links

Download this manual See also: Installation Manual
3Com HomeConnect ADSL
Modem Ethernet
CLI User's Guide
Version 1.0

Advertisement

Table of Contents
loading

Related Manuals for 3Com HomeConnect 3CP3647

Summary of Contents for 3Com HomeConnect 3CP3647

  • Page 1 3Com HomeConnect ADSL Modem Ethernet CLI User’s Guide Version 1.0...
  • Page 2 3Com Corporation reserves the right to revise this documentation and to make changes in content from time 60008 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.

  • Page 3: Table Of Contents

    CCESSING THE ONFIGURATION Establishing Communications Local Connection IBM-PC Compatible Computers Macintosh Computers UNIX-Based Computers Remote Connection CLI C OMMAND ONVENTIONS AND Command Structure Format Parameters Values Names or Strings Network Address Formats Abbreviation and Command Completion Control Characters Help Conventions Command Language Terminology ANUAL SETUP Configuration Overview...
  • Page 4 Setting System Identification Configuring TELNET Login Access Providing TFTP Access Setting Password Protection Configuration Scripting ILTERING APABILITIES Introduction Filtering Capabilities of the 3Com HomeConnect ADSL Modem Ethernet Filter Classes Filter Types Data Filters Generic Filters Creating Filters Filter File Components...
  • Page 5 OFTWARE Introduction Serial Port Update 3Com Instant Update Process 3Com FTP Site 3Com HomeConnect ADSL Modem Ethernet CD Installing Operational Software via DOS Update Using Built-in Update Software update software ftp <filename> update software ftp <filename> update software tftp <filename>...
  • Page 6 delete ip network <network_name> delete ip route <IP_address> delete snmp community <name> delete snmp trap_community <name> delete syslog <ip_addr> delete tftp client <ip_addr> delete user <name> DISABLE disable bridge access_mac_addresses disable bridge forwarding disable bridge spanning_tree disable ip network <network_name> disable link_traps interface <interface_name>...
  • Page 7 list bridge access_mac_addresses list bridge forwarding list connection events ... list dns servers list facilities list filters list files list interfaces list ip addresses list ip arp list ip networks list ip routes list ports list snmp communities or list snmp trap_communities list syslog A-10 list tftp clients...
  • Page 8 set facility <facility_name> loglevel [level] set interface <interface_name> set port <port number> A-13 set snmp community <community_name> set snmp trap_community <name> set system A-14 set syslog <IP_address> loglevel [level] set time <time> A-15 set user <user_name> A-15 SHOW A-15 show adsl configuration A-15 show adsl performance A-15...
  • Page 9 telnet <ip_addr> TCP_port <number> UPDATE A-20 update software ftp <filename> update software tftp <filename> VERIFY A-21 verify filter <filter_name> 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...
  • Page 10 3Com Corporation Limited Warranty YEAR 2000 WARRANTY Obtaining Warranty Service viii Warranties exclusive Limitation of Liability Disclaimer Governing Law...

  • Page 11: Establishing Communications

    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 connect 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.

  • Page 12: Remote Connection

    ONFIGURATION NTERFACE Remote Connection If you want to attach to the 3Com HomeConnect ADSL Modem Ethernet via 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.

  • Page 13: Command Structure

    CLI C 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. Command Structure Format Commands can be followed by values and/or parameters and values. For example: Ddd ip network <network_name>...

  • Page 14: Network Address Formats

    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 what 3Com HomeConnect ADSL Modem Ethernet has “seen” up to now - by pressing <ctrl>L [^ L] (for last).

  • Page 15: Command Language Terminology

    Command Language The CLI command language creates, manages, displays and removes system Terminology 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 Port - A table of parameters that describes the characteristics of a bridge port.
  • Page 16 2: CLI C HAPTER OMMAND ONVENTIONS AND ERMINOLOGY...

  • Page 17: Configuration Overview

    STP prevents the data packets from circling 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).

  • Page 18: Configuring Atm Information

    ATM backbone network when the connection is to be established. Currently, the SVC capability is disabled in the 3Com HomeConnect ADSL Modem Ethernet. The VPI/VCI values to use for a bridge port are specified using the ’set port’...

  • Page 19: Advanced Bridging

    Advanced Bridging Remember to save your configuration using the save all command before rebooting your 3Com HomeConnect ADSL Modem Ethernet so that your changes will be written to permanent FLASH memory. Advanced Bridging Bridging is globally enabled by default, to disable bridging use the disable bridge Settings forwarding command.

  • Page 20: Restricting Lan Access

    <priority value> Restricting LAN Access Access to the bridging functions of the 3Com HomeConnect 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.

  • Page 21: Ip Configuration

    IP address. You must also have an administrative login profile (user name and password) assigned. To access the IP Wizard, go to Start > Programs > 3Com HomeConnect ADSL Modem Ethernet, and click on "IP Wizard".

  • Page 22: Configuring An Ip Network

    (Maximum character length of login name = 32, password maximum character length = 15.) Configuring an IP The 3Com HomeConnect ADSL Modem Ethernet can have more than one IP Network address (i.e., belong to more than one IP network). To configure an IP address use the add ip network command.

  • Page 23: Configuring Dns

    <domain_name> where domain name is the specific domain or the wildcard character ’*’. IP Tools The 3Com HomeConnect ADSL Modem Ethernet CLI provides a standard set of IP utility programs including Ping, TELNET and RLOGIN. System This section provides details and examples for performing the following system...

  • Page 24: Setting System Identification

    The name, location, and contact can be up to 32 characters long. For example, set system name Modem1 location Rack4 contact SysAdmin@555-1212 Configuring TELNET Setting up a login user allows you to provide controlled access to the 3Com Login Access HomeConnect ADSL Modem Ethernet through TELNET. Connecting using TELNET on a workstation allows you to remotely manage the unit using CLI.

  • Page 25: Providing Tftp Access

    The 3Com HomeConnect ADSL Modem Ethernet has a TFTP server that allows you to copy files to or from the unit. All you have to do is set up TFTP access on the 3Com HomeConnect ADSL Modem Ethernet and run a TFTP client program on a workstation.

  • Page 26: Configuration Scripting

    Note: This capability is useful for system administrators or users who wish to restrict access to the 3Com HomeConnect ADSL Modem Ethernet. Care should be taken to remember the configured password. If the password is forgotten, the unit must be sent back to 3Com support to have the feature disabled. Configuration Scripting The 3Com HomeConnect ADSL Modem Ethernet provides a scripting utility that will generate the CLI commands required to recreate a given configuration.

  • Page 27: Introduction

    Introduction The 3Com HomeConnect ADSL Modem Ethernet provides an extensive set of data filtering capabilities. For instance, filters can accept packets only from specific addresses to provide added security, or filters can be added to reduce network traffic and improve overall performance.

  • Page 28: Data Filters

    Ethernet interface, to packets going out the WAN (ATM) interface, or to packets coming from a specific port. The first step in creating a filter on the 3Com HomeConnect ADSL Modem Ethernet is to create a file using filter syntax. The file can be created using a text editor on a remote workstation or it can be created using the CLI create text command.

  • Page 29: Protocol Rules

    If you do not specify a protocol section in the filter file, no filtering will occur and packets of that protocol type will be accepted. If you specify a protocol section but do not define any rules, an error will occur. To comment out the protocol section, you must place a pound (#) sign before the section header and before all rules defined in the section.

  • Page 30: Generic Filter Rule

    4: F HAPTER ILTERING APABILITIES The OR operation can be implemented by successive rules. For example, to accept a packet if the source address is xxx, or the destination address is yyy, the following rules are used: BR-ETH: 1 ACCEPT src-addr=00-20-69-00-00-01; 2 ACCEPT dst-addr=00-20-69-00-00-02;...

  • Page 31: Assigning Filters

    10 From a machine that has access to the same network as the bridge, use a TFTP command to transfer the filter file to the bridge FLASH memory. For example, from the workstation command line enter tftp <3Com HomeConnect ADSL Modem Ethernet IP address> put <filter filename>...

  • Page 32: Interface Filters

    This occurs when a network is disabled, the WAN connection goes down then up, or when the 3Com HomeConnect ADSL Modem Ethernet is rebooted.

  • Page 33: Configuring A Filter For A Port

    Interface name is eth:1 for the Ethernet interface and atm:1 for the ATM interface. For example, to apply an input filter to the ethernet interface: set interface eth:1 input_filter filter.flt When assigning the filter to the Ethernet interface, you must turn off filter access by entering the CLI command set interface eth:1 filter_access off.

  • Page 34: Removing A Filter From An Interface

    4: F HAPTER ILTERING APABILITIES If the syntax is invalid, the filter is still added to the managed list with a status of verify failed. To correct filter file errors, you must make the changes to the original filter file using a text editor, and re-TFTP the file to the bridge’s FLASH memory. Then use the verify filter command to check the filter file syntax.

  • Page 35: Serial Port Update

    3Com FTP site, without installing or running the 3Com Instant Update. Launch your browser and enter in the location of the 3Com FTP site ftp.3com.com in your browser’s address or location field. You will then need to...

  • Page 36: Com Homeconnect Adsl Modem Ethernet Cd

    The 3Com HomeConnect ADSL Modem Ethernet operational software (the *.nac file) included on the CD is copied to your hard drive and not the 3Com HomeConnect ADSL Modem Ethernet unit. It is installed to c:\Program Files\3Com\3Com HomeConnect ADSL Modem Ethernet\Update.

  • Page 37: Update Using Built-In Update Software

    The update software FTP and update software TFTP commands allow you to Update Software utilize the 3Com HomeConnect ADSL Modem Ethernet FTP or TFTP clients to obtain and install the new operational software. You can access these commands directly from the serial console CLI session or through TELNET.

  • Page 38: Update Software Ftp

    5: U HAPTER PGRADING username <username> password <password> If you are obtaining the code update from the 3Com FTP site, you would use the command: update software ftp server ftp.3com.com <filename> path /pub/xdsl/hceth/binary username anonymous password <password> where <filename> is the NAC file to load and <password> is your email address (i.e., name@company.com).

  • Page 39: Cli Commands

    CLI C CLI Commands Use the ADD command to define: Note that some parameters have default values. add bridge Adds a MAC Address to the Access MAC table. When the Access MAC feature is access_mac_address enabled, only MAC Addresses in the Access MAC Table will be bridged. <mac_address>...

  • Page 40: Add Ip Defaultroute Gateway

    A: CLI C PPENDIX OMMAND ESCRIPTION TFTP to export the updated file to the system’s FLASH file system, and use the verify filter command to check the filter’s syntax. Parameters <filter_name> add ip defaultroute gateway <IP_address> Defines a default gateway IP router, which acts as the default route for IP packets destined for remote hosts.

  • Page 41: Add Snmp Community

    add snmp community <community_name> Adds to the list of SNMP authorized users. The community name and IP address of SNMP requests from managers on the network must match the list, which you can see using list snmp communities. Parameters <community_name> address access add snmp...

  • Page 42: Capture Text

    A: CLI C PPENDIX OMMAND ESCRIPTION Name Password Enabled CAPTURE TEXT capture text <filename> Redirects console input into a text file. Input redirection is terminated by Ctrl-D. This command serves as a simple way to create filter files or to create command scripts that can be executed using the DO command.

  • Page 43: Delete Syslog

    delete syslog Deletes the specified IP address from the list of addresses which are authorized to <ip_addr> receive syslog information. Use list syslog to see the currently allowed addresses. delete tftp client Deletes the specified IP address from the list of addresses which are authorized to <ip_addr>...

  • Page 44: Do Output [Outputfile]

    A: CLI C PPENDIX OMMAND ESCRIPTION Runs a script file that is stored in FLASH memory, which contains a series of CLI <command_inputfile> commands. output [outputfile] ENABLE enable bridge Enables the Access MAC feature. When the Access MAC feature is enabled, only access_mac_addresses MAC Addresses in the Access MAC Table will be bridged.

  • Page 45: Help

    CLI Commands HELP help <command> Provides information about possible commands and their formats. Typing help alone lists the possible commands. Typing help <command name> lists the possible parameters for that command. Typing part of a keyword (command or parameter) and pressing Esc completes the keyword.

  • Page 46: List Connection Events

    A: CLI C PPENDIX OMMAND ESCRIPTION Fltr - Number of packets received from this MAC station that were filtered out (discarded) Fwd - Number of packets received from this MAC station that were forwarded TxPkt - Number of packets forwarded to this MAC station TxOctets - Number of bytes forwarded to this MAC station list connection events Displays the contents of the Connection Event Table.

  • Page 47: List Ip Networks

    Interface - interface this IP address uses to connect to the system list ip arp Displays the contents of the ARP cache. It lists: IP Address - IP address for this entry Phys Address - MAC address that the IP address maps to Type - interface type: Ethernet or Token Ring If Name - eth:1, DA:1 or loopback list ip networks...

  • Page 48: List Syslog

    A-10 A: CLI C PPENDIX OMMAND ESCRIPTION list syslog Displays IP addresses which get syslog entries from the system. See add syslog for more information, and delete syslog command to remove entries. This command shows: Also see list facilities and set facilities commands, which let you view and change log reporting levels for each system facility.

  • Page 49: Rename

    RENAME rename file Renames files within the FLASH file system. The FLASH file system is a flat file <input_file> system (no subdirectories). Use the list files command to see what files currently <output_file> exist. Parameters <input_file> <output_file> reset ethernet counters Clears the statistics counters for the Ethernet port.

  • Page 50: Set Bridge

    A-12 A: CLI C PPENDIX OMMAND ESCRIPTION set bridge Sets parameters for all bridge networks. Parameters aging_time forward_delay spanning_tree_ priority set command login_required Enables or disables CLI password protection. password The CLI password. It must consist of 1 to 8 alphanumeric (printable) characters, inclusive.

  • Page 51: Set Interface

    set interface <interface_name> Sets filter parameters for the specified protocol on the specified interface. You can see the available filter files using list filters, view the contents of a filter file using show filter, and add filter files to FLASH memory using TFTP. Parameters <interface_name>...

  • Page 52: Set Snmp Community

    A-14 A: CLI C PPENDIX OMMAND ESCRIPTION set snmp community <community_name> Modifies parameters for an SNMP authorized user. The community name and IP address of SNMP requests from managers on the network must match the list, which you can see using list snmp communities. Parameters <community_name>...

  • Page 53: Set Time

    set time <time> Sets the system time, and leaves the date unchanged. Use show date to see what the current settings are. The format is: hh:mm:ss. The seconds field is optional. set user <user_name> Modifies user parameters. Parameters <user_name> message password session_timeout tcp_port...

  • Page 54: Show Adsl Statistics

    A-16 A: CLI C PPENDIX OMMAND ESCRIPTION show adsl statistics Displays block count statistics for the ADSL interface. It reports the number of blocks transmitted and received. It also reports the number of blocks received with corrected errors, and the number received with uncorrectable errors. show adsl Displays the current status of the ADSL transceiver.

  • Page 55: Show Command

    For character-oriented or fixed-length interfaces, the number of inbound transmission units that contained errors preventing them from being deliverable to a number of inbound transmission units that contained higher-layer protocol. Unknown Prot - unknown protocol in packet CLI Commands 3COM-DSL> 3COM-DSL> 09-FEB-2107 15:06:10 2d 08:37:54 A-17...

  • Page 56: Output Counters

    A-18 A: CLI C PPENDIX OMMAND ESCRIPTION OUTPUT COUNTERS show ethernet settings Displays settings for the ethernet interface. show ip settings Displays system wide IP information. show memory Displays System RAM Memory usage. show port <port Displays the parameters defined for the specified VC. You can use list vc to see number>...

  • Page 57: Output Counters

    CLI Commands A-19 Bad Versions - SNMP messages for an unsupported SNMP version Bad Community Names - SNMP messages which used an unknown SNMP community name Bad Community Uses - SNMP messages which represented an SNMP operation not allowed by the SNMP community named in the message ASN.1 Parse Errors - sum of ASN.1 or BER errors Too Big Errors - SNMP PDUs for which the value of the error-status field is ‘tooBig’...

  • Page 58: Show Snmp Settings

    Displays system information. System Descriptor - for example: 3Com HomeConnect™ Remote 810 V1.0.0, Built on Oct 31 1996 at 11:33:05. Object ID - identifies this system to SNMP managers System UpTime - time the system has been running since last boot...

  • Page 59: Update A

    update software tftp <filename> VERIFY verify filter Verifies the syntax of a filter file, which has been previously added to the table. If <filter_name> you update a filter file and TFTP it to the FLASH file system, and the file already exists in the filter table, then you use this command to verify the files syntax.
  • Page 60 A-22 A: CLI C PPENDIX OMMAND ESCRIPTION Logout Leave the CLI and close this connection. This ends the TELNET session. Command The command language has several built in features that make it easier to use. Features When abbreviating commands, it is sometimes hard to remember the commands and their syntax.
  • Page 61 Add command 2-2 ADSL reset A-11 show settings A-16 show transceiver_status A-15 show version A-16 show status A-16 ATM Information, configuring 3-2 Bridge Networks Configuration enable bridge spanning_tree A-6 set bridge A-12 Statistics list bridge forwarding A-7 bridge Networks Configuration disable bridge spanning_tree A-5 show bridge settings A-16 Managing...
  • Page 62 Filtering Capabilities 4-1 Filters add filter A-1 delete filter A-4 list filters A-8 FLASH ROM 2-2 Interface 1-1 Interfaces disable link_traps interface A-5 list interfaces A-8 Internet, viewing Web resources 1-1 Configuration add ip network A-2 delete ip network A-4 disable ip network A-5 enable ip network A-6 list ip networks A-9...
  • Page 63 Network user 2-2 Package, what’ s included 1-1 Password 2-2 Password Protection 3-9 Passwords add user A-3 PC 1-1 Remote Site Management 3-1 Scripts do (run CLI script) A-6 Security CLI Access disable security_option remote_user administration A-5 enable security_option remote_user administration A-6 Dial-in disable user A-5 enable user A-6...
  • Page 64 help A-7 history A-7 list facilities A-8 list files A-8 reboot A-10 rename file A-11 System ID 3-8 TELNET access 3-8 TFTP access 3-9 Time 3-7 Users delete user A-5 show user settings A-20 show vc settings A-18 set vc A-13 Virtual Channel (VC) 2-3 Web Browser access 3-8...
  • Page 65 Canadian customers can speak to a technical support representative by contacting Keating Technologies. Online Technical 3Com offers product support 24 hours a day, 7 days a week, through: Support If you need to Return Contact 3Com Customer Support. If the support representative...
  • Page 66 Ship to the following address: Customers in Canada needing to return a modem for repair or replacement should send the modem to the following address: Manufacturer’s 3Com Corporation Declaration of 3800 Golf Road Conformity Rolling Meadows, IL 60008 U.S.A.
  • Page 67 This equipment complies with FCC Rules Part 68. Located on the bottom of the modem is the FCC Registration Number and Ringer Equivalence Number (REN). You must provide this information to the telephone company if requested. The REN is used to determine the number of devices you may legally connect to your telephone line.
  • Page 68 the telephone number of the sending machine or of such business, other entity, or individual. (The telephone number provided may not be a 900 number or any other number for which charges exceed local or long-distance transmission charges.) In order to program this information into your modem, refer to the RapidComm manual on the CD-ROM that shipped with your modem.
  • Page 69 In accordance with Part 15 of the FCC rules, the user is cautioned that any changes or modifications to the equipment described in this manual that are not expressly approved by 3Com could void the user’s authority to operate the equipment.
  • Page 70 telecommunication companies do not allow users to connect their equipment to jacks except in precise situations that are spelled out in tariffing arrangements with those companies. Repairs to certified equipment should be coordinated by a representative designated by the supplier. Any repairs or alterations made by the user to this equipment, or equipment malfunctions, may give the telecommunications company cause to request the user to disconnect the equipment.
  • Page 71 Limited Warranty workmanship and materials, under normal use and service, for the lifetime of the product from the date of purchase from 3Com or its authorized reseller. 3Com’s sole obligation under this express warranty shall be, at 3Com’s option and expense, to repair the defective product or...
  • Page 72 April 1, 2000, or ninety (90) days after purchase of the product from 3Com or its authorized reseller, 3Com shall, at its option and expense, provide a software update which would effect the proper performance of such product, repair such product, deliver to Customer...
  • Page 73 CUSTOMER’S SOLE REMEDY FOR BREACH OF THAT WARRANTY SHALL BE REPAIR, REPLACEMENT, OR REFUND OF THE PURCHASE PRICE PAID, AT 3COM’S OPTION. TO THE FULL EXTENT ALLOWED BY LAW, THE FOREGOING WARRANTIES AND REMEDIES ARE EXCLUSIVE AND ARE IN LIEU OF ALL OTHER WARRANTIES, TERMS, OR CONDITIONS, EXPRESS OR...
  • Page 74 exclusions may be limited in their application to you. When the implied warranties are not allowed to be excluded in their entirety, they will be limited to the duration of the applicable written warranty. This warranty gives you specific legal rights which may vary depending on local law. Governing Law This Limited Warranty shall be governed by the laws of the State of California, U.S.A.

Table of Contents