1. DL manuals
  2. 3Com
  3. Modem
  4. HomeConnect 3CP3647
  5. Cli User's Manual

3Com HomeConnect 3CP3647 Cli User's Manual

Other manuals for HomeConnect 3CP3647: Installation Manual
Manual is about: ADSL Modem Ethernet

Summary of HomeConnect 3CP3647

  • Page 1

    3com homeconnect adsl modem ethernet cli user’s guide version 1.0

  • Page 2

    3com corporation 3800 golf road rolling meadows, il 60008 copyright © 1999, 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 perm...

  • Page 3: Cli C

    1 a ccessing the c onfiguration i nterface establishing communications 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 c ommand c onventions and t erminology command structure 2-1 format 2-1 parameters 2-1 values 2...

  • Page 4

    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 f iltering c apabilities introduction 4-1 filtering capabilities of the 3com homeconnect adsl modem ethernet 4-1 fi...

  • Page 5: Adsl M

    Verifying filter file syntax 4-8 showing filter file contents 4-8 5 u pgrading 3c om h ome c onnect adsl m odem e thernet o perational s oftware 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 operationa...

  • Page 6

    Delete ip network a-4 delete ip route a-4 delete snmp community a-4 delete snmp trap_community a-4 delete syslog a-5 delete tftp client a-5 delete user 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 a-5 disabl...

  • Page 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...

  • Page 8

    Set facility loglevel [level] a-12 set interface a-13 set port a-13 set snmp community a-14 set snmp trap_community a-14 set system a-14 set syslog loglevel [level] a-14 set time a-15 set user a-15 show a-15 show adsl configuration a-15 show adsl performance a-15 show adsl statistics a-16 show adsl ...

  • Page 9

    Telnet tcp_port a-20 update a-20 update software ftp a-20 update software tftp a-21 verify a-21 verify filter a-21 telnet commands a-21 close a-21 help a-21 send a-21 set_escape 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-...

  • Page 10

    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.

  • Page 11: Ccessing

    1 a ccessing the c onfiguration i nterface 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 management of your 3com homeconnect adsl m...

  • Page 12

    1-2 c hapter 1: a ccessing the c onfiguration i 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 ...

  • Page 13: Cli C

    2 cli c ommand c onventions and t erminology 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 follow...

  • Page 14

    2-2 c hapter 2: cli c ommand c onventions and t erminology network address formats many commands require a network address, to define a link to a remote host, workstation or network. Network addresses are shown in this document using the syntax described in the following table: abbreviation and comm...

  • Page 15

    Command structure 2-3 command language terminology 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: ■ netw...

  • Page 16

    2-4 c hapter 2: cli c ommand c onventions and t erminology.

  • Page 17: Anual

    3 m anual 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 3com homeconnect adsl modem ethernet is a learning bridge. A learning bri...

  • Page 18

    3-2 c hapter 3: m anual setup you modify the profile using set port commands to setup the wan connection and network information. 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 permanen...

  • Page 19

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

  • Page 20

    3-4 c hapter 3: m anual 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 ...

  • Page 21

    Ip configuration 3-5 set port filter ■ to disable port filtering, use the command: set port filter none ip configuration to allow remote snmp and telnet management of the 3com homeconnect adsl modem ethernet you must configure the unit’s ip stack. The ip stack can receive packets from any bridge por...

  • Page 22

    3-6 c hapter 3: m anual setup name and password. (maximum character length of login name = 32, password maximum character length = 15.) configuring an ip network the 3com homeconnect adsl modem ethernet can have more than one ip address (i.E., belong to more than one ip network). To configure an ip ...

  • Page 23

    System administration 3-7 the route will appear as destination 0.0.0.0 in the ip routing table. ■ to delete an ip static route, use the command: delete ip route configuring dns you can configure the 3com homeconnect adsl modem ethernet to access a dns server to resolve host names. This facility is u...

  • Page 24

    3-8 c hapter 3: m anual setup the date and time information is provided in the following format: system date: 02-mar-1998 05:17:00 system uptime: 2d 08:37:54 you can set the date using the command: set date which sets the system date, and leaves the time unchanged. The format is: dd-mmm-yyyy. The mo...

  • Page 25

    System administration 3-9 providing tftp access trivial file transfer protocol (tftp) provides a simple way to transfer files from one machine to another. 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 a...

  • Page 26

    3-10 c hapter 3: m anual setup 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 suppor...

  • Page 27: Iltering

    4 f iltering c apabilities 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 ov...

  • Page 28

    4-2 c hapter 4: f iltering c apabilities ■ data filters - based on protocol-specific packet information. ■ generic filters - based on packet structure. Data filters data filters control network access based on the protocol and source / destination address of the packet. Generic filters generic filte...

  • Page 29

    Creating filters 4-3 ■ 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 ...

  • Page 30

    4-4 c hapter 4: f iltering c 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-...

  • Page 31

    Assigning filters 4-5 will define in the future. Also, use the # sign to add comments or what you expect the filter to do for future reference. 4 enter the rules you are defining. Observe the following guidelines. ■ begin each rule with a unique line number ranging from 1 - 998. ■ arrange rules in i...

  • Page 32

    4-6 c hapter 4: f iltering c apabilities ■ interfaces ■ ports interface filters you can configure interface filters for any interface. Interface filters control access to all networks available for both modem and non-modem interfaces. You can specify whether a filter applies to packets entering the ...

  • Page 33

    Managing filters 4-7 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 b...

  • Page 34

    4-8 c hapter 4: f iltering c 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...

  • Page 35: Pgrading

    5 u pgrading 3c om h ome c onnect adsl m odem e thernet o perational s oftware introduction the 3com homeconnect adsl modem ethernet operational software is stored in the unit’s flash memory. There are two ways to update the operational software: ■ you can load new software through the serial consol...

  • Page 36

    5-2 c hapter 5: u pgrading 3c om h ome c onnect adsl m odem e thernet o perational s oftware navigate through the directory structure to pub/xdsl/hceth. From this site, you can obtain document updates from the docs subdirectory and code updates from the binaries subdirectory. The code updates are st...

  • Page 37

    Update using built-in update software 5-3 3 power off your 3com homeconnect adsl modem ethernet. 4 open a dos window on your workstation. 5 change to the directory containing the new operational software. If you obtained the software from the installation cd or using instant update the default direc...

  • Page 38

    5-4 c hapter 5: u pgrading 3c om h ome c onnect adsl m odem e thernet o perational s oftware ■ username ■ 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 ■ path /pub/xdsl/hceth/binary ■ username anonymous ■ pa...

  • Page 39: Cli C

    A cli c ommand d escription cli commands add use the add command to define: ■ networks you will connect to ■ snmp communities ■ users who can telnet to the unit note that some parameters have default values. Add bridge access_mac_address adds a mac address to the access mac table. When the access ma...

  • Page 40

    A-2 a ppendix a: cli c ommand d 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. Add ip defaultroute gateway { metric [1] } defines a default gateway ip router, which acts as the default route for ip packets...

  • Page 42

    A-4 a ppendix a: cli c ommand d escription capture text capture text 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. Delete delete c...

  • Page 43

    Cli commands a-5 delete syslog deletes the specified ip address from the list of addresses which are authorized to 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 t...

  • Page 44

    A-6 a ppendix a: cli c ommand d escription do do output [outputfile] runs a script file that is stored in flash memory, which contains a series of cli commands. Enable enable bridge access_mac_addresses enables the access mac feature. When the access mac feature is enabled, only mac addresses in the...

  • Page 45

    Cli commands a-7 help help provides information about possible commands and their formats. Typing help alone lists the possible commands. Typing help lists the possible parameters for that command. Typing part of a keyword (command or parameter) and pressing esc completes the keyword. If you have no...

  • Page 46

    A-8 a ppendix a: cli c ommand d 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 forwarde...

  • Page 47

    Cli commands a-9 ■ 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 ...

  • Page 48

    A-10 a ppendix a: cli c ommand d 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: ■ syslog - ip address to which syslog entries will be sent ■ log level - repor...

  • Page 49

    Cli commands a-11 rename rename file renames files within the flash file system. The flash file system is a flat file system (no subdirectories). Use the list files command to see what files currently exist. Reset ethernet counters clears the statistics counters for the ethernet port. Reset port num...

  • Page 50

    A-12 a ppendix a: cli c ommand d escription set bridge aging_time forward_delay spanning_tree_priority sets parameters for all bridge networks. Set command history idle timout local_prompt prompt login_required enables or disables cli password protection. Password the cli password. It must consist o...

  • Page 53

    Cli commands a-15 set 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 message [“message”] password [password] session_timeout [seconds] tcp_port [tcp_port] terminal_type mod...

  • Page 54

    A-16 a ppendix a: cli c ommand d 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. S...

  • Page 55

    Cli commands a-17 show command ■ displays the settings for command history depth, and the current prompt. You can modify the history depth using set command history, and alter the prompt using set command prompt. Prompts can hold a maximum of 64 characters. For example: history depth: 10 current pro...

  • Page 56

    A-18 a ppendix a: cli c ommand d escription output counters ■ octets - bytes transmitted ■ ucast - unicast packets transmitted ■ multicast - multicast packets transmitted ■ discards - number of outbound packets which were chosen to be discarded even though no errors had been detected to prevent thei...

  • Page 57

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

  • Page 58

    A-20 a ppendix a: cli c ommand d escription show snmp settings displays snmp settings, which you can modify using enable or disable snmp authentication trapscommands. ■ authentication traps - enabled (default) or disabled show system displays system information. ■ system descriptor - for example: 3c...

  • Page 59

    Telnet commands a-21 update software tftp server path verify verify filter verifies the syntax of a filter file, which has been previously added to the table. If 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 ...

  • Page 60

    A-22 a ppendix a: cli c ommand d escription logout leave the cli and close this connection. This ends the telnet session. Command features the command language has several built in features that make it easier to use. When abbreviating commands, it is sometimes hard to remember the commands and thei...

  • Page 61

    A add command 2-2 adsl reset a-11 show settings a-16 show transceiver_status a-15 show version a-16 atm show status a-16 atm information, configuring 3-2 b bridge networks configuration enable bridge spanning_tree a-6 set bridge a-12 statistics list bridge forwarding a-7 bridge networks configuratio...

  • Page 62

    F filtering capabilities 4-1 filters add filter a-1 delete filter a-4 list filters a-8 flash rom 2-2 i interface 1-1 interfaces disable link_traps interface a-5 list interfaces a-8 internet, viewing web resources 1-1 ip configuration add ip network a-2 delete ip network a-4 disable ip network a-5 en...

  • Page 63

    N network user 2-2 p package, what’ s included 1-1 password 2-2 password protection 3-9 passwords add user a-3 pc 1-1 r remote site management 3-1 s scripts cli do (run cli script) a-6 security cli access disable security_option remote_user administration a-5 enable security_option remote_user admin...

  • 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 t telnet access 3-8 tftp access 3-9 time 3-7 u users delete user a-5 show user settings a-20 show vc settings a-18 v vc set vc a-13 virtual channel (vc) 2-3 w web browser access 3-8.

  • Page 65: Echnical

    T echnical s upport and l imited w arranty notice: this modem was not designed or approved for use in europe, australia, or new zealand. Technical support 3com provides easy access to technical support information through a variety of services. This section describes those services. Technical suppor...

  • Page 66

    Send the modem back in the original box. Send only the modem (not manuals, diskettes, etc.) include your sro number, name and address on the shipping label as well as inside the package. If possible, send the package via a courier capable of tracking the progress of the shipment. Ship to the followi...

  • 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 t...

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

  • Page 69

    Stock no. 004-000-0345-4 u.S. Government printing office washington, dc 20402 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 oper...

  • 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 alt...

  • Page 71

    Ensemble. Cette précaution est particulièrement importante dans les régions rurales. Avertissement: l'utilisateur ne doit pas tenter de faire ces raccordements lui même; il doit avoir recours à un service d'inspection des installations électriques, ou à un électricien, selon le cas. Centre de guaran...

  • Page 72

    The later of 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 an equivalent produ...

  • Page 73

    Warranties exclusive if a 3com product does not operate as warranted above, 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 ...

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