Copyright E 2000 Paradyne Corporation.
All rights reserved.
Printed in U.S.A.
Notice
This publication is protected by federal copyright law. No part of this publication may be copied or distributed,
transmitted, transcribed, stored in a retrieval system, or translated into any human or computer language in any form
or by any means, electronic, mechanical, magnetic, manual or otherwise, or disclosed to third parties without the
express written permission of Paradyne Corporation, 8545 126th Ave. N., Largo, FL 33773.
Paradyne Corporation makes no representation or warranties with respect to the contents hereof and specifically
disclaims any implied warranties of merchantability or fitness for a particular purpose. Further, Paradyne Corporation
reserves the right to revise this publication and to make changes from time to time in the contents hereof without
obligation of Paradyne Corporation to notify any person of such revision or changes.
Changes and enhancements to the product and to the information herein will be documented and issued as a new
release to this manual.
Warranty, Sales, Service, and Training Information
Contact your local sales representative, service representative, or distributor directly for any help needed. For
additional information concerning warranty , sales, service, repair, installation, documentation, training, distributor
locations, or Paradyne worldwide office locations, use one of the following methods:
H Internet: Visit the Paradyne World Wide Web site at www.paradyne.com. (Be sure to register your warranty
at www.paradyne.com/warranty.)
H Telephone: Call our automated system to receive current information by fax or to speak with a company
representative.
— Within the U.S.A., call 1-800-870-2221
— Outside the U.S.A., call 1-727-530-2340
Document Feedback
We welcome your comments and suggestions about this document. Please mail them to Technical Publications,
Paradyne Corporation, 8545 126th Ave. N., Largo, FL 33773, or send e-mail to userdoc@paradyne.com. Include
the number and title of this document in your correspondence. Please include your name and phone number if you
are willing to provide additional clarification.
Trademarks
ACCULINK, COMSPHERE, FrameSaver, and Hotwire are registered trademarks of Paradyne Corporation.
NextEDGE, MVL, OpenLane, Performance Wizard, and TruePut are trademarks of Paradyne Corporation. All other
products and services mentioned herein are the trademarks, service marks, registered trademarks, or registered
service marks of their respective owners.
This document is intended for administrators and operators who maintain the
endpoints at customer premises. A basic understanding of internetworking
protocols and their features is assumed. Specifically, you should have familiarity
with the following internetworking concepts:
HTCP/IP applications
HIP and subnet addressing
HIP routing
HBridging
It is also assumed that you have already installed a Hotwire DSL Router. If not,
refer to Product-Related Documents on page vii for installation documents.
6371-A2-GB20-00
March 2000
v
Page 8
About This Guide
Document Summary
SectionDescription
Chapter 1Introduction to Hotwire DSL Routers. Provides an overview
Chapter 2Accessing the DSL Router. Describes the Hotwire DSL
Chapter 3Configuring the DSL Router. Describes the DSL router
Chapter 4DSL Router Configuration Examples. Presents several
Chapter 5Monitoring the DSL Router. Describes operator programs
Chapter 6Diagnostics and Troubleshooting. Describes common
of the Hotwire DSL Routers.
Routers access control and provides instructions on how to
log in and log out of the system.
interfaces, Domain Types, IP Routing, and network
considerations.
common DSL router configuration examples.
that monitor the Hotwire system.
Hotwire operational problems and solutions. Contains
SysLog information.
Appendix ACommand Line Interface. Provides explanation of the DSL
router’s Command Line Interface and command syntax with
examples.
Appendix BConfiguration Defaults & Command Line Shortcuts.
Provides a list of all configuration options with factory
default settings and a list of all command line shortcuts with
the abbreviated command line input.
The following syntax is used throughout this document.
SyntaxTranslation
[ ]
{ }
|
Italics
Bold
x.x.x.x32-bit IP address and mask information where x is an
xx:xx:xx:xx:xx:xxMAC address information where x is a hexadecimal
Square brackets represent an optional element.
Braces represent a required entry.
Vertical bar separates mutually exclusive elements.
Entry is a variable to be supplied by the operator.
Enter (type) as shown.
8-bit weighted decimal notation.
notation.
viii
March 2000
6371-A2-GB20-00
Page 11
Introduction to Hotwire DSL
Routers
What is a Hotwire DSL Router?
The Hotwirer DSL (Digital Subscriber Line) Router operates as an IP router
connecting a DSL link to an Ethernet network. This system provides high-speed
Internet or corporate LAN (Local Area Network) access over traditional
twisted-pair copper telephone wiring to the end user.
DSL Technologies Supported
1
The Paradyne’s Hotwire DSL network supports the following types of
technologies:
HHotwire IDSL (ISDN DSL) products provide IDSL multirate symmetrical
packet transport and can operate over a connection with an ISDN repeater or
digital facilities. Data rates of 64 kbps, 128 kbps, or 144 kbps can be
configured.
HHotwire RADSL (Rate Adaptive DSL) products are applicable for both
asymmetric and symmetric applications. The 1 Mbps symmetric operation is
ideal for traditional business applications while the 7 Mbps downstream with
1.1 Mbps upstream asymmetric operation provides added bandwidth for
corporate Internet access. RADSL products can also save line costs by
optionally supporting simultaneous data and voice over the same line.
HHotwire SDSL (Symmetric DSL) packet-based products provide high-speed
symmetric DSL services for business applications that require more
bandwidth. These products are configurable from 144 kbps up to 2.3 Mbps.
This gives service providers the opportunity to sell multiple services with a
single product.
6371-A2-GB20-00
March 2000
1-1
Page 12
Introduction to Hotwire DSL Routers
Typical DSL Router System
DSL is a local loop technology that uses standard twisted-pair copper wire to
support high-speed access over a single pair of twisted copper wires. DSL
applications are all point-to-point, requiring DSL devices at the central site and at
the end-user site.
The Hotwire DSL routers interoperate with the following types of Hotwire DSL
cards to deliver applications at high speeds in support of packet services over a
DSL link:
HThe Hotwire 8323 or 8324 IDSL Cards interoperate with two Hotwire IDSL
Routers:
— Hotwire 6321 IDSL Router with one Ethernet port
— Hotwire 6322 IDSL Router with a 4-port Ethernet hub
HThe Hotwire 8343 or 8344 Packet SDSL Cards interoperate with two Hotwire
Symmetric DSL Routers:
— Hotwire 6341 SDSL Router with one Ethernet port
— Hotwire 6342 SDSL Router with a 4-port Ethernet hub
HThe Hotwire 8510, 8373, and 8374 RADSL Cards interoperate with the
Hotwire 6371 RADSL Router
The following illustration shows a typical Hotwire system with a Hotwire DSL
Router. The Hotwire 6371 RADSL Router can function simultaneously with data
and POTS. The other DSL routers transport data only.
Network Access Provider (NAP)Service Subscriber
Customer Premises (CP)
DSL
Router
POTS
CP
POTS
Splitter
Optional
Network
Service
Provider
Corporate
Intranet
Core
Router
Central Office (CO)
DSL
CARD
DSLAM
POTS
Splitter
Optional
CO
MDF
POTS/DSL
Data
Interface
1-2
Legend: DSL – Digital Subscriber LinePOTS–Plain Old Telephone Service
MDF – Main Distribution Frame
March 2000
6371-A2-GB20-00
00-16576-01
Page 13
Hotwire DSL Router Features
The Hotwire DSL routers contain the following features.
HIP routing with:
— NAT (Network Address Translation).
— DHCP Server (Dynamic Host Configuration Protocol) and DHCP Relay
Agent.
— A full set of IP filters.
HHigh-speed Internet or intranet access.
HDiagnostics. Provides the capability to diagnose device and network
problems and perform tests.
HDevice and Test Monitoring. Provides the capability of tracking and
evaluating the unit’s operation.
HRemote Firmware Download. Provides easy setup and activation of
firmware upgrades from a remote location.
Introduction to Hotwire DSL Routers
HSecurity. Provides multiple levels of security, which prevents unauthorized
HConsole Terminal Interface. Provides an interface for configuring and
Service Subscriber
The Service Subscriber is the user (or set of users) that has contracted to receive
networking services (e.g., Internet access, remote LAN access) for the end-user
system from one or more NSPs (Network Service Provider). Service subscribers
may be:
HResidential users connected to public network services (e.g., the Internet)
HWork-at-home users connected to their corporate intranet LAN
HCommercial users at corporate locations (e.g., branch offices) connected by
The Hotwire DSL Router must be installed at the customer premises to provide
the end user with access to any of the above services.
access to the DSL router.
managing the DSL router.
a LAN to other corporate locations or connected to public network services
NOTE:
If you would like more information on DSL-based services, applications, and
network deployment, refer to Paradyne’s The DSL Sourcebook. The book
may be downloaded or ordered through Paradyne’s World Wide Web site at
www.paradyne.com/library.
6371-A2-GB20-00
March 2000
1-3
Page 14
Introduction to Hotwire DSL Routers
This page intentionally left blank.
1-4
March 2000
6371-A2-GB20-00
Page 15
Accessing the DSL Router
Access Control to the DSL Router
The Hotwire DSL Router can be managed from the command line interface.
There are two methods to access the command line interface:
HLocal access at the DSL router through the Console port, or
HAccess by a Telnet session (controlled through the management interface at
the Hotwire chassis).
When a local console connection is first established, a login prompt appears. The
Hotwire DSL Router accepts only one login session at a time. To provide login
security to the DSL system, configure a login ID and password.
2
Levels of Access
There are two levels of privileges on the Hotwire DSL system. Your user account
can be configured with a user name, password, and privilege of:
HAdministrator. The Administrator has two levels of access to the DSL router.
— Administrator, configuration mode, has complete read/write access to the
DSL router.
HOperator. The Operator has read-only access to display device information
with no modification permission and no access to management functions.
Refer to Appendix A, Command Line Interface, for access level details for each
command line entry.
6371-A2-GB20-00
March 2000
2-1
Page 16
Accessing the DSL Router
Changing Access Session Levels
HYou can change the Administrator access level by entering:
admin enable
This command provides Administrator access level privileges. The DSL
router will respond with a prompt to enter the password for Administrator
access.
HYou can end the Administrator access level by entering:
admin disable
This command results in ending the Administrator access level session. No
password is needed.
Entering exit has the same results. Refer to Exiting from the System on
page 2-5 for further details on ending a session.
The Operator and Administrator have the same Login ID with different passwords
for their access level. To determine the level of access for a session, refer to
Determining the Current Access Level on page 2-4.
Local Console Access
The DSL router ships with the local console enabled. After login, the local console
can be disabled with the command console disable. After saving this
command and ending the session, there is no local access through the console
port. All access must be through a Telnet session.
NOTE:
Entering console disable results in NO local access to the DSL router.
To determine if the local console is enabled, log in and enter:
show console
The display returned for the show console command will be:
Hconsole enabled – Command line management at the local console is
available, or
Hconsole disabled – No command line management is available at the
local console.
For steps to set up the new user’s login, refer to Setting Up the New User’s Login
on page 2-3.
2-2
March 2000
6371-A2-GB20-00
Page 17
Setting Up the New User’s Login
The DSL router will provide the login prompt when the local console connection is
first established. When the login prompt appears, a locally connected console
defaults to Console Enabled with Operator access only.
" Procedure
For first-time access to the Hotwire DSL Router’s command line interface:
1. At the initial login> prompt, type the default login ID paradyne and press
Enter.
2. At the password> prompt (for Operator), type the default password abc123
and press Enter.
The login ID and password fields are validated together.
3. At the system identity of CUSTOMER> prompt, type admin enable and press
Enter.
4. At the password> prompt (for Administrator), type the default passwordabc123 and press Enter.
Accessing the DSL Router
5. The system identity will change to the Administrator display mode of
CUSTOMER#>. Type configure terminal and press Enter.
6. The system identity will change to the Administrator configuration mode of
CUSTOMER - CONFIG#>.
7. To change the login ID, enter text to replace the default of paradyne:
name your new login ID
NOTE:
The Login ID and Password fields are NOT case-sensitive.
8. Enter a new password and specify the level:
password level password
Example: type password operator 238clrd3 and press Enter.
Both the Login ID and the Password fields are 1–31 printable alphanumeric
ASCII characters in the ASCII hex range of 0x21–0x7E. No spaces are
allowed. The following table lists the invalid characters.
Invalid Characters
#Number sign0x23
$Dollar sign0x24
ValueASCII Hex T ranslation
%Percentage0x25
&Ampersand0x26
6371-A2-GB20-00
March 2000
2-3
Page 18
Accessing the DSL Router
For more information regarding the system identity, refer to Determining theCurrent Access Level, below.
If you are denied access during a Telnet session, the session stops and an error
is logged. If you accessing the DSL router locally and a Telnet session is active,
you will receive a message:
Telnet Access
The Telnet access defaults to Administrator level. If the login is at the Operator
level, then Operator level access is available. Telnet access is always enabled.
9. At the prompt, enter the new Administrator-level password to replace abc123:
password admin new password and press Enter
save and press Enter
NOTE:
Any input during an Administrator configuration session must be saved
while still in configuration mode.
Local console disabled by conflict
Determining the Current Access Level
To determine the local console access level, log in to the DSL router. The
command line prompt following the login displays the access level. The default
System identity is CUSTOMER>.
To determine the commands available at the current login access level, enter:
Hhelp or
Then the DSL router
access level is . . .
mode
configuration mode
And if you entered a System
identity of Paradyne, the
prompt displays . . .
Paradyne #>
Paradyne – CONFIG#>
H? (question mark)
2-4
March 2000
6371-A2-GB20-00
Page 19
Using the List Command
The list command displays a sequence of commands, in the form of ASCII
strings, that would have the effect of setting all configuration settings to the
current values. (The two passwords are not output.)
To determine the commands available at the current login access level, enter the
Administrator mode and enter either:
Hlist
Displays the output in on-screen page mode. In on-screen page mode, the
user interface displays 23 lines of information. When the 24th line is reached,
More... is displayed. Pressing any key will display the next page.
Hlist confg
Displays the output in scroll mode as a text file. Scroll mode creates a file and
captures all command strings in the text file for use with a terminal emulation
program. Refer to Appendix C, DSL Router Terminal Emulation.
Changing the System Identity
Accessing the DSL Router
Procedure
"
To change the System Identity from the factory default of CUSTOMER>:
1. Login and enter the ADMIN-configuration mode.
2. At the CUSTOMER-CONFIG#> prompt, type the new System identity
(no spaces allowed), press Enter, type save, and press Enter.
system identity new system identity
For example:
system identity Paradyne and press Enter
save and press Enter
3. In this example, after saving the entry and ending the configuration mode, the
System identity will display:
Paradyne #>
Exiting from the System
You can manually log out of the system, unplug the Console cable, or let the
system automatically log you out. The DSL router will log you out immediately if
you disconnect the Console cable. Any unsaved configuration input will be lost.
6371-A2-GB20-00
March 2000
2-5
Page 20
Accessing the DSL Router
Manually Logging Out
To log out, there are two commands: logout and exit.
" Procedure
To log out of the Hotwire DSL Router command line session or Telnet session:
" Procedure
To exit the Hotwire DSL Router’s current access level:
1. At the > prompt, type logout and press Enter.
2. The system ends the session immediately. Any configuration updates must
be saved before exiting or the updates will be lost.
1. At the > prompt, type exit and press Enter. If there are any unsaved
configuration changes, you will be prompted to save changes before exiting.
2. The exit command has the following effect:
If you are accessing the DSL router . . .
At the Local console and logged in at the
Administrator level, configuration mode
At the Local console and logged in at the
Administrator level, non-configuration
mode
At the Local console and logged in at the
Operator level
Via a Telnet session and logged in at any
access level
Automatically Logging Out
The DSL router has an automatic timeout feature that logs you out of the system
after five minutes of inactivity. Any input that is not saved is lost. You will need to
log back in. At the console, press Enter to display the login> prompt to log
back in.
Then . . .
You are placed at the Operator level
and any configuration updates must be
saved or the updates will be lost.
You are placed at the Operator level.
The Exit command responds exactly
like the Logout command.
Entering either of the following ends
the Telnet session immediately:
H Exit
H Ctrl + ] (right bracket)
The autologout {enable | disable} command factory default is enabled.
Unsaved configuration input is lost.
HWhen enabled, the current configuration as displayed with the list command
is retained through a power recycle.
HWhen disabled, the system inactivity timer is disabled.
2-6
March 2000
6371-A2-GB20-00
Page 21
Configuring the DSL Router
Overview of DSL Router Configuration
The Hotwire DSL Routers support various customer premises distribution
networks that contain IP forwarding devices or routers, in addition to locally
attached hosts or subnets. The Hotwire DSL Router has an IP Routing Table that
contains IP address and subnet mask information.
The DSL router supports Internet Protocol as specified in RFC 791 and Internet
Control Message Protocol (ICMP) as specified in RFCs 792 and 950. The DSL
router acts as a router (or gateway) as defined in RFC 791.
3
Interfaces for the DSL Router
The Hotwire DSL Router has two interfaces.
HDSL Interface
HEthernet Interface
DSL Interface
The Hotwire DSL Router interface type is determined by the model number.
H6321 and 6322 are Hotwire IDSL Routers
H6341 and 6342 are Hotwire SDSL Routers
H6371 is a Hotwire RADSL Router
The DSL interface has a unique MAC address assigned before shipping.
6371-A2-GB20-00
March 2000
3-1
Page 22
Configuring the DSL Router
Ethernet Interface
HThe Ethernet interface is a 10/100BaseT interface that automatically
HThe DSL router can be configured for either DIX format or IEEE 802.3 format.
HThe Hotwire 6322 IDSL and the 6342 SDSL Routers each have a hub
HAll DSL routers have an Ethernet interface with a unique MAC address
HThe DSL router only accepts frames on the Ethernet interface with its own
negotiates the rate. If all attached Ethernet devices support 100BaseT, the
DSL router will default to 100BaseT. Otherwise, the DSL router operates at
10BaseT.
When the DSL router is configured to use IEEE 802.3 format, the DSL router
uses SNAP encapsulation as specified in RFC 1042.
configuration with four Ethernet connectors. The hub acts as a bit-level
repeater. There is logically one Ethernet communications interface and one
single collision domain.
assigned before shipping.
MAC address or a broadcast or multicast MAC address.
Ethernet and DSL Interface Identifiers
The following are the naming conventions used for the Hotwire DSL Router
interfaces:
HMultiple Service Domains can be defined using network addresses and
subnet masks.
HFor both the DSL interface and the Ethernet interface, four Service Domain
IP Addresses and subnet masks can be defined.
3-2
March 2000
6371-A2-GB20-00
Page 23
Numbered DSL Interface
In this scenario, the hosts attached to the DSL router’s Ethernet interface are on
a different logical network than the core router. The DSL router is the next hop
router for the hosts. The upstream next hop router for the DSL router is the core
router.
Configuring the DSL Router
Simplified Network Topology
Core
Router
The hosts can be assigned IP addresses on the network attached to the DSL
router’s Ethernet interface. The upstream next hop router is assigned an address
on a different logical network than the hosts.
Actions required to configure the DSL router interfaces in this scenario:
HAssign IP address to Ethernet interface: e0
HAssign IP address to DSL interface: d0
HAssign upstream next hop router
Unnumbered DSL Interface
In this LAN extension application scenario, the hosts connected to a corporate
network for virtual office connection or teleworkers want to look like they are on
the same network as the core router. The core router will be the next hop router
for the hosts.
WAN
DSL
Router
Host
(End Users)
99-16609
Actions required to configure the DSL router interfaces in this scenario:
HAssign IP address to Ethernet interface: e0
HSpecify the DSL interface as unnumbered: d0
HAssign upstream next hop router
HEnable Proxy ARP for both the e0 and d0 interfaces
HDisable scoping at the DSL card
6371-A2-GB20-00
March 2000
3-3
Page 24
Configuring the DSL Router
IP Routing
The DSL router uses destination-based routing for downstream traffic. An IP
Routing Table is maintained to specify how to forward IP datagrams downstream.
The DSL router is capable of supporting 32 entries in the IP Routing Table. This
table can be viewed by both Operator and Administrator access levels.
The DSL router uses source-based forwarding for upstream traffic to ensure that
packets are forwarded to the upstream router specified for each of the configured
Service Domains.
Refer to Chapter 4, DSL Router Configuration Examples, for further details.
Network Considerations
The DSL routers can be configured to function in a variety of network
environments. The following sections provide descriptions of some of the DSL
router features:
— Basic NAT
— Network Address Port Translation (NAPT)
— Applications Supported by NAT
HDynamic Host Configuration Protocol (DHCP) Server
HDHCP Relay Agent
HIP Filtering
Address Resolution Protocol (ARP)
Address Resolution Protocol, as specified in RFC 826, is supported in the DSL
router. The DSL router provides for a total of 256 ARP table entries. The timeout
for completed and for uncompleted ARP table entries is configurable.
The Command Line Interface provides the ability to:
HCreate up to 64 static ARP table entries to be retained across power cycles.
HDisplay the ARP table.
HDelete ARP table entries.
HAdd and delete dynamic ARP table entries by the DHCP server function.
Refer to Dynamic Host Configuration Protocol (DHCP) Serveron page 3-7.
3-4
March 2000
6371-A2-GB20-00
Page 25
Proxy ARP
The DSL router supports Proxy ARP. Proxy ARP responses are based on the IP
Routing table contents. The IP Routing table must have an entry for every host
that is reachable on the Ethernet interface, including hosts for which the DSL
router will not forward packets because of IP filters. If an ARP request is received
on one interface for an IP address that is reachable on the other interface, the
DSL router will respond with its own MAC address.
The Command Line Interface provides the ability to enable and disable Proxy
ARP for each interface.
NOTES:
— When Basic NAT is enabled, the DSL (d0) interface must have Proxy
ARP enabled if the d0 interface address is part of the Basic NAT global
IP network address.
— Proxy ARP and NAPT cannot be enabled at the same time.
Network Address Translation (NAT)
Configuring the DSL Router
Network Address Translation is used when a private network’s internal IP
addresses cannot be used outside the private network. The IP addresses may be
restricted for privacy reasons or they may not be valid public IP addresses.
The DSL router provides NAT as described in RFC 1631TheIP Network AddressTranslator (NAT). NAT allows the private (local) hosts to transparently access
public (global) external IP addresses.
Two variations of traditional NAT are supported:
HBasic NA T
HNAPT (Network Address Port Translation)
NOTE:
Basic NAT and NAPT cannot be enabled at the same time.
6371-A2-GB20-00
March 2000
3-5
Page 26
Configuring the DSL Router
Basic NAT
Basic NAT allows hosts in a private network to transparently access the external
network by using a block of public addresses. Static mapping enables access to
selective local hosts from the outside. Basic NAT is often used in a large
organization with a large network setup for internal use and the need for
occasional external access.
Basic NAT provides a one-to-one mapping by translating a range of assigned
public IP addresses to a similar-sized pool of unassigned private addresses
(typically from the 10.x.x.x address space). Each local host currently
communicating with a external host appears to have an unique IP address.
The public address used by NAT must be a Class C address. This private
address space can be structured in any way. More than 254 clients can use Basic
NAT but not simultaneously.
Network Address Port Translation (NAPT)
NAPT allows multiple clients in a local network to simultaneously access remote
networks using a single IP address. This benefits telecommuters and SOHO
(Small Office/Home Office) users that have multiple clients in an office running
TCP/UDP applications.
NAPT provides a many-to-one mapping and uses one public address to interface
numerous private users to an external network. All hosts on the global side view
all hosts on the local side as one Internet host. The local hosts continue to use
their corporate or private addresses. When communicating with each other, the
translation is based on the IP address and the IP port numbers used by TCP/IP
applications.
Applications Supported by NAT
The DSL routers support the following applications and protocols when the
connection or session is initiated from the local hosts on the Ethernet side of the
DSL router:
The DSL router provides a DHCP Server feature as specified in RFC 2131,
Dynamic Host Configuration Protocol, and RFC 2132, DHCP Option and BOOTP
Vendor Extensions. DHCP is the protocol used for automatic IP address
assignment.
DHCP setup considerations:
HThe range of IP addresses to be used by the DHCP server must be
configured. The maximum number of clients is 256.
HWhen the DHCP IP address range is changed, all binding entries and
dynamic routes for the clients configured with the old address range are
removed. When the DHCP Server is enabled, there can be only one service
domain (Ethernet interface) configured.
HThe IP address for the next hop router that is provided to the hosts in the
DHCP reply must be configured.
HThe subnet mask can be configured along with the IP address range. This is
optional.
Configuring the DSL Router
DHCP Relay Agent
HThe DHCP server must be enabled.
HThe DHCP server domain name can be configured. This is optional.
HThe Domain Name Server (DNS) IP address can be configured. This is
optional.
HThe minimum and maximum lease time settings can be configured.
For additional information, refer to Chapter 4, DSL Router Configuration
Examples.
The DSL router provides the capability of serving as a DHCP Relay Agent, as
specified in RFC 2131, Dynamic Host Configuration Protocol. The DSL router
provides the capability to enable and disable the DHCP Relay Agent and to
configure the IP address of the DHCP server to which the DHCP requests are to
be forwarded.
The DHCP server assigns an IP address to the end-user system. The Hotwire
DSL Router IP Routing tables are automatically updated.
The supported DHCP relay agent in the DSL router should be used when there is
a DHCP server upstream in the service domain. DHCP relay agent setup
considerations:
HDHCP server IP address must be configured.
HDHCP relay must be enabled.
HDHCP server function and DHCP relay function cannot be enabled at the
same time.
HNAT and DHCP relay cannot be enabled at the same time.
6371-A2-GB20-00
March 2000
3-7
Page 28
Configuring the DSL Router
IP Filtering
The DSL router can filter out IP packets.
By default, filtering is disabled on the Hotwire DSL Card for the DSL router.
If enabled, filtering provides security advantages on LANs by restricting traffic on
the network and hosts based on the IP source and/or destination addresses.
IP packets can be filtered based on:
HDestination IP Address
HIP Protocol Type
HSource and Destination Port Number (if applicable)
HSource IP Address
HTCP Filter (prevents the receipt of downstream TCP connect requests)
NOTE:
All Hotwire DSL Router filters are configured on the Hotwire DSL Card.
NOTE:
If the Source IP Address filter is enabled on the Hotwire card and an
IP address is assigned to the DSL interface, there must also be an entry
configured in the Hotwire Client Table for the DSL interface’s IP address.
For more information about IP filtering, see the Hotwire MVL, RADSL, IDSL, and
The Hotwire DSL Router configuration examples include only a few of the
possible scenarios. This chapter covers some of the common configurations.
The command syntax will vary based on your network setup.
Configuration commands require the access level of Administrator-Config and
changes need to be saved while in configuration mode to take effect. Refer to
Chapter 2, Accessing the DSL Router.
4
The Hotwire DSL Router configuration examples include:
HBasic Configuration
HBasic NA T
HNAPT
HUnnumbered DSL Interface with Proxy ARP
HDHCP Relay with Proxy ARP
HDHCP Server with Basic NA T
HDownstream Router
Refer to Appendix A, Command Line Interface, for specific commands and
syntax.
Refer to Appendix B, Configuration Defaults & Command Line Shortcuts, for
specific command default settings and abbreviated command line syntax.
NOTES:
— The examples in this chapter are provided to illustrate some of the
features of the Hotwire DSL Routers. Not all possible feature
configurations are covered in the examples.
— The IP addresses used in the examples are for illustrative purposes only.
6371-A2-GB20-00
These addresses are not intended for use when configuring your local
network.
March 2000
4-1
Page 30
DSL Router Configuration Examples
Basic Configuration Example
Core
Router
155.1.4.253
WAN
155.1.4.254
In this basic example:
DSL
d0
DSL
Router
Customer Premises (CP)
Console
Port
Connection
Ethernet
e0
155.1.3.254
Hub
End-user
Systems
155.1.3.1
155.1.3.2
155.1.3.3
155.1.3.4
99-16590
HThere are multiple clients with statically assigned public IP addresses
configured on the Ethernet side of the DSL router.
HThe IP addresses of the clients are contained within the subnet specified by
the configured Ethernet IP address.
HThe next hop router of the clients is the Ethernet (e0) interface of the DSL
router.
HThe next hop router for downstream forwarding from the core router is the
DSL (d0) interface of the DSL router.
The command line syntax is:
Public IP Addresses for Basic NATPrivate IP Addresses
192.128.1.110.1.3.2
DSL Router Configuration Examples
End-user
Systems
10.1.3.2
10.1.3.3
Hub
10.1.3.9
99-16613
192.128.1.210.1.3.3
. . .. . .
192.128.1.810.1.3.9
In this DHCP Server with Basic NAT example:
HThe clients are using dynamic IP address assignment and use the Ethernet
(e0) interface of the DSL router as the next hop router.
HThe DSL (d0) interface must be numbered.
HThe DSL router is configured as the DHCP server giving the private IP
addresses to the clients.
HThe Ethernet interface is in private address space. NAT is used for
one-to-one mapping of addresses.
The command line syntax is:
ifn address e0 10.1.3.10 255.255.255.240
ifn address d0 155.1.3.2 255.255.255.0
ip route create upstream e0 155.1.3.1
nat basic address 192.128.1.0
nat basic enable
dhcp server addresses 10.1.3.2 10.1.3.9
dhcp server router 10.1.3.10
dhcp server enable
6371-A2-GB20-00
March 2000
4-7
Page 36
DSL Router Configuration Examples
Downstream Router Configuration Example
Customer Premises (CP)
End-user
Systems
120.26.7.1
Core
Router
155.1.3.1
WAN
120.26.7.2
DSL
d0
155.1.3.2
DSL
Router
Console
Port
Connection
Ethernet
e0
120.26.7.5
Hub
120.26.7.3
120.26.7.100
Router
Hub
130.26.7.1
130.26.7.2
130.26.7.3
In this downstream router example:
HThere are clients statically configured and connected to the DSL router.
HThere are also clients connected behind a downstream router.
HThe DSL (d0) interface is numbered.
This chapter presents information on how to access and monitor the Hotwire DSL
Router’s status and performance statistics. You can monitor DSL router
operations by viewing:
HLEDs on the DSL router’s front panel.
HDSL Router Interfaces Status, including DSL and Ethernet LED status.
HDSL Router Statistics, including DSL Service Domain, DSL Management
Domain, Ethernet, and IP statistics.
5
Detecting Problems
The DSL router can detect and report problem conditions and the user can
perform diagnostic tests. The DSL router offers a number of indicators to alert
you to possible problems:
HLEDs provide status. Refer to Status LEDs in the Hotwire DSL Router
HStatus messages for both the Ethernet and DSL links. Refer to Status of
HNetwork performance statistics for both the Ethernet and DSL links. Refer to
For additional information regarding diagnostic tests, System Log messages, and
troubleshooting, refer to Chapter 6, Diagnostics and Troubleshooting.
Installation Instructions for LED indications and troubleshooting of the
hardware installation.
Interfaces on page 5-2.
Interface Statistics on page 5-3.
6371-A2-GB20-00
March 2000
5-1
Page 38
Monitoring the DSL Router
Status of Interfaces
From the Command Line Interface, the current status of the Ethernet (e0)
Interface and the DSL (d0) Interface can be obtained with one command:
The information displayed for Ethernet and DSL Interfaces is presented below.
show interface
show interface {e0 | d0}
Use to request status statistics for the named interface, e0 or d0.
Minimum access level: Operator
e0 – Ethernet interface
d0 – DSL interface
e0 status – Fields included in the display of Ethernet status: e0
– Ethernet Link – { up | down }
This is the same status as reflected by the Ethernet LED.
* The Primary designation of a numbered interface marks that interface as the one
whose IP address will be used as a Router ID. If no interface is defined as Primary , the
last numbered interface created will become the Primary IP Address.
5-2
March 2000
6371-A2-GB20-00
Page 39
Interface Statistics
Monitoring the DSL Router
From the Command Line Interface, statistics are available for DSL, Ethernet, and
IP processing. Statistics are available for all three selections, e0, d0, and ip, with
one command:
show statistics
The format of the statistics information display is presented below.
show statistics [ e0 | d0 | ip ]
Use to request statistics for the named interface, e0 or d0, or IP processing statistics.
Minimum access level: Operator
e0 – Ethernet interface statistics
d0 – DSL interface statistics
ip – IP processing statistics
The Discard Statistics represents the number of frames or packets discarded.
The display includes the reason for the discard. The following tables list discard
reasons for:
Table 5-1. Discard Reasons for the Ethernet Interface (e0) (1 of 2)
Discard Reasons for the Ethernet Interface (e0)
Alignment Error
CRC Error
Defers on TX
Excessive Collisions
Excessive Defers on TX
FIFO Overflow Error
Frame Length Greater than Max
Late Collision on TX
No Carrier Detect on TX
Parity Error
Receive Buffer Pool Depletion
Receiver Halted
5-4
March 2000
6371-A2-GB20-00
Page 41
Monitoring the DSL Router
Table 5-1. Discard Reasons for the Ethernet Interface (e0) (2 of 2)
Bad Port to Destination
Bad Port to Source
DSL Receive Packets Filtered
DSL Transmit Packets Filtered
Ethernet Receive Packets Filter
Ethernet Transmit Packets Filter
Fragmentation Failures
ICMP Errors
IP Processing Disabled
No Route to Destination
No Route to Source
No Upstream Route
Other Reassembly Failures
Other Receive Errors
Other Transmit Errors
Packets Pending on ARP Discarded
Reassembly Timeout
TCP Errors
Time to Live Expired
Transport Protocol Not Handled
UDP Errors
5-6
March 2000
6371-A2-GB20-00
Page 43
Diagnostics and Troubleshooting
Diagnostics and Troubleshooting Overview
There are several features available to assist in evaluating the Hotwire DSL
Router. The following sections are covered in this chapter:
HDevice Restart
HAlarms Inquiry
HSystem Log
HPING
6
Device Restart
Alarms Inquiry
HTraceRoute
The DSL router can be restarted locally or remotely. From the Command Line
Interface, type Restart and press Enter.
The DSL router reinitializes itself, performing a power-on self-test and resetting
the local System Log (SYSLOG).
show alarms
This command allows the operator to display the list of current alarm conditions, if any .
Minimum access level: Operator
The possible output lines are:
Alarm: Management Address Conflict
Alarm: Failed Selftest
Alarm: System Error
No alarm condition is set
6371-A2-GB20-00
March 2000
6-1
Page 44
Diagnostics and Troubleshooting
System Log
The Hotwire DSL Router has the capability to log significant system events
(SYSLOG). The SYSLOG can be maintained locally on the DSL router and can
also be sent to a remote SYSLOG server. To activate:
HThe DSL router must be configured to enable the output of SYSLOG
messages via the syslog enable command. (The Management Controller
Card (MCC) has SYSLOG always enabled.)
HAn IP address (loopback or remote) must be supplied.
HThe SYSLOG can also be captured by a remote SYSLOG server running the
UNIX daemon syslogd or an equivalent program. It is necessary to know the
IP address where the syslogd resides and the UDP port number the syslogd
is using.
The advantage of using a remote SYSLOG server is that ALL events will be
maintained upon restart of the DSL router. The local SYSLOG is cleared
upon restart.
Events are classified by severity level and the system administrator can specify
the minimum severity to be logged.
show syslog
Displays the current status of system as enabled or disabled. If enabled, the severity
level, management IP address, and UDP port will be displayed.
Specifies the IP address for the host to send system log entries to.
Minimum access level: Administrator/Config
ip-addr – The IP address for SYSLOG (typically loopback address of 127.0.0.1).
{syslog port} [port-number]
Specifies the UDP port number on the server to which the system events will be sent.
Minimum access level: Administrator/Config
port-number – The UDP port number. Default = 514.
6-2
March 2000
6371-A2-GB20-00
Page 45
Diagnostics and Troubleshooting
gy
unusable
syslog level level
Specifies the minimum severity level to be logged. Refer to Table 6-1, SYSLOG
Messages, for a list of messages by severity level.
Minimum access level: Administrator/Config
level – The minimum level to be logged. The default is NORM.
The choices for severity level (displayed as high severity to low severity) are as follows:
EMER – emergency, the system is unusable
ERR – error conditions reported
NORM – normal or administrative reporting
INFO – informational reporting
Example: To log EMER and ERR severity levels, enter syslog level ERR
show log [number]
Displays the contents of the local system error log. (The 100 most recent SYSLOG
entries are kept locally.) The user specifies how many entries they wish to view. Entries
are displayed in reverse order from most recent to oldest.
number – The number of local entries to be seen. Default = 10. Range = 1–100.
NOTE: The SYSLOG retained locally will be reset at the DSL router if the restart
command is issued. External logs are retained after a DSL router restart.
SYSLOG Events
The following are some of the SYSLOG events that will be reported for defined
severity levels.
Table 6-1. SYSLOG Messages (1 of 2)
Level
EMEREmergency and
ERRError conditions
DescriptionEvent
the system is
unusable
reported
Alarm Cleared
Alarm Set
System Abort
ARP Table size exceeded
Executable image in flash invalid
Frame received in error
6371-A2-GB20-00
March 2000
6-3
Page 46
Diagnostics and Troubleshooting
g
re orting
Table 6-1. SYSLOG Messages (2 of 2)
LevelEventDescription
NORMNormal or
administrative
reportin
INFOInformational
reporting
Admin enable
Admin enable failure
Any configuration change command
Configuration changes saved
Download completed
Download failure
Login
Login failure
Logout
Statistics cleared
Switch program LMC message received
System started
ARP table entry created due to packet arrival
ARP table entry created for DHCP address assignment
ARP table entry deleted due to time out
Device information LMC message received
Packet filter action
Routing table entry created for DHCP address
The PING program is an IP-based application used to test reachability to a
specific IP address by sending an ICMP echo request and waiting for a reply.
From the Command Line Interface, PING can test connectivity upstream or
downstream.
PINGs the specified destination IP address. Once PING starts, the input prompt will not
redisplay until either the PING finishes or the PING command is aborted with Ctrl-c.
Minimum access level: Administrator
dest-ip – The destination IP address of the device to PING.
source-ip – The source IP address to be used. The default source address is from the
service domain in which the test is being done. The IP address is validated to verify that
it is an interface IP address.
mgt – Specifies that the IP address is in the management domain (through the MCC).
Do not use with –x source-ip selection.
bytes – Bytes of data (l = length). Default = 64 bytes. Range = 0–15,000.
time – Number of seconds to wait before ending PING attempt. Default = 10 seconds.
PING test results display in the following formats.
HPING successful:
Ping reply [x.x.x.x]: bytes of data=nn
HPING timeout:
Ping reply [x.x.x.x]: REQUEST TIMED OUT
HICMP echo response of an unreachable destination:
Ping reply [x.x.x.x]: DESTINATION UNREACHABLE
6371-A2-GB20-00
March 2000
6-5
Page 48
Diagnostics and Troubleshooting
TraceRoute
The TraceRoute program is an IP diagnostic tool that allows you to learn the path
a packet takes from the service domain local host to its remote host.
If you are unable to PING a device in a Hotwire network configuration, you may
want to run TraceRoute to identify the link (destinations up to 64 hops) between
the DSL router and the device that is not forwarding the PING message.
traceroute dest-ip[
Performs TraceRoute to the specified destination IP address. Once T raceRoute starts,
the input prompt will not redisplay until either TraceRoute finishes or the T raceRoute
command is aborted with Ctrl-c.
Minimum access level: Administrator
dest-ip – The destination IP address for TraceRoute.
source-ip – The source IP address used. The default source address is from the
service domain in which the test is being done. The IP address is validated to verify that
it is an interface IP address.
bytes – Bytes of data (l = length). Default = 64 bytes. Range = 0–15,000.
time – Decimal number for time in seconds before the TraceRoute is abandoned.
Default = 10 seconds. Range = 0–60.hops – Decimal number that specifies the maximum number of hops to be tested.
The Hop # is the Time to Live (TTL) value set in the IP packet header. The Round
Trip Time contains the time in 100ms intervals for each attempt to reach the
destination with the TTL value.
6-6
Round T rip Time
Try #1Try #2Try #3
March 2000
IP Address of
Responding System
6371-A2-GB20-00
Page 49
Command Line Interface
Command Line Interface Feature
The Hotwire DSL Router is managed with text commands from the Command
Line Interface. The Command Line Interface can be accessed:
HLocally with an ASCII terminal connected to the Console port, or
HRemotely via a Telnet session.
The Command Line Interface is ASCII character-based and provides the
capability to:
A
Navigation
HDisplay the syntax of commands.
HChange the operational characteristics of the DSL router by setting
configuration values.
HRestore all configuration values to the initial factory defaults.
HDisplay DSL router hardware and identification information.
HDisplay system status, including DSL link status and Ethernet status.
HDisplay a sequence of commands that would have the effect of setting all
configurable parameters to their current value.
Refer to Appendix B, Configuration Defaults & Command Line Shortcuts.
Most terminal emulation programs use the following keys:
HEnter or Return – Accepts the input.
HCtrl-c – Aborts the entry or clears the input line.
HDown Arrow – Repeats an entry within the last five entered.
HUp Arrow – Repeats the input selected with the down arrow.
6371-A2-GB20-00
March 2000
A-1
Page 50
Command Line Interface
Document Conventions
This syntax is used throughout this manual. The Command Line Interface is not
case-sensitive, with the exception of the Login ID and Password fields.
SyntaxTranslation
[ ]
{ }
|
Italics
Bold
Square brackets represent an optional element.
Braces represent a required entry.
Vertical bar separates mutually exclusive elements.
Entry is a variable to be supplied by the operator.
Enter (type) as shown.
x.x.x.x32-bit IP address and mask information where x is an
8-bit weighted decimal notation.
xx:xx:xx:xx:xx:xxMAC address information where x is a hexadecimal
notation.
Command Line Interface Commands
Configuration Control Commands
configure {terminal | factory}
Enables the Administrator configuration mode. Configuration mode will remain in effect
until the exit or logout command has been entered. While in configuration mode, the
show commands are unavailable.
Minimum access level: Administrator
configure terminal – Configuration mode is in effect and all changes entered by the
Administrator are made on top of the current running configuration. When finished
entering the commands needed to configure the DSL router, the save command must
be input to save the configuration changes or the exit command can be used to discard
the configuration changes and leave the configuration mode.
configure factory – Causes the configuration mode to be entered and the factory
default settings are loaded. The save command must be used to save the configuration
factory defaults as the active configuration.
CAUTION: All interface IP address assignments, static and dynamic route table
save
Saves configuration changes to the active configuration in NVRAM. No configuration
changes will be in effect until the save command is issued. If the save command is
entered and there are changes that require a reboot of the DSL router, the Administrator
will be prompted that a reset is required for the changes to take effect.
Minimum access level: Administrator/Config
yes – Changes are stored and the DSL router resets automatically.
no – DSL router is left in configuration mode.
entries, ARP cache entries, NAT static entries, and DHCP server entries
will be purged when the DSL router resets.
A-2
6371-A2-GB20-00March 2000
Page 51
Ethernet Frame Format
frame [format ]
Specifies the Ethernet frame format that is to be used.
Minimum access level: Administrator/Config
format – 802.3 or DIX may be requested. Default = DIX
Specifies the IP address associated with either the Ethernet interface or the DSL
interface. Up to four (4) IP addresses may be assigned on each interface. An interface
address and mask cannot be changed while there is a static route (upstream or
downstream) that uses it. Interface IP address ranges must not overlap.
Minimum access level: Administrator/Config
e0, e0/1, e0/2, e0/3, e0/4 – Ethernet interface. e0 is the same as e0/1.
d0, d0/1, d0/2, d0/3, d0/4 – DSL interface. d0 is the same as d0/1.
ip-address – The IP address associated with the specified interface.
mask – Mask for the associated subnet.
primary – The Primary designation of a numbered interface marks that interface as the
one whose IP address will be used as a Router ID. If no interface is defined as Primary ,
the last numbered interface created will become the Primary IP Address.
unnumbered – Specifies that the DSL interface is to be unnumbered.
NOTES: – For each defined Ethernet interface, a corresponding upstream next hop
router IP address must be configured for routing of packets on that
interface. See ip route create upstream command for more details.
– When the e0 is assigned an IP address, this section also defines the
logical network (subnet) containing the locally attached hosts. An IP
route table entry will automatically be created to correspond to the
subnet defined by the mask.
– When the DSL interface is numbered, multiple logical Ethernet interfaces
can be assigned to the same DSL logical interface by configuring the
same upstream next hop router.
– The configured DSL logical interfaces must be either all numbered or a
single unnumbered interface. When NA T is being used, the DSL
interface must be numbered. Only one logical interface must be defined
for each physical interface, i.e., one IP address to each interface.
– When NAT, DHCP Server, or DHCP Relay is enabled, there can be only
one service domain configured.
Examples: ifn address d0 135.300.41.8
ifn d0 primary
Command Line Interface
6371-A2-GB20-00
March 2000
A-3
Page 52
Command Line Interface
IP Routing Table
delete {e0[/ifn] | d0[/ifn]}
Deletes any of the assignments that are configured for the IP address or interface. Only
the specific Ethernet or DSL interface number needs to be specified.
An interface address and mask cannot be deleted while there is a static route (upstream
or downstream) that uses it. First, delete the IP route with the ip route delete
command (see IP Routing Table).
Minimum access level: Administrator/Config
e0, e0/1, e0/2, e0/3, e0/4 – Ethernet interface. e0 is the same as e0/1.
d0, d0/1, d0/2, d0/3, d0/4 – DSL interface. d0 is the same as d0/1. Only d0 or d0/1 are
acceptable inputs for an unnumbered interface.
Example: delete e0/4
ip route create dest-ip dest-mask {next-hop-ip | remote}
ip route delete dest-ipdest-mask
Configures the downstream static routes. Downstream routes cannot be created unless
at least one Ethernet interface has been configured.
create – Create an IP route table entry.
delete – Delete an IP route table entry. This will delete an IP route placed in the table by
the DHCP server, the DHCP relay, or manually entered static entries.
NOTE: An interface route is created automatically when an address and mask are
dest-ip – IP address of the destination. The destination IP address must be within the
address range of a configured Ethernet interface.
dest-mask – IP mask for the destination IP address.
next-hop-ip – IP address of the next hop (downstream) router used to reach the
destination. A next hop with an IP address of 0.0.0.0 specifies a directly reachable client.
A nonzero next-hop-ip address must be within the address range of an Ethernet
interface.
remote – Indicates that the device specified by the destination ip and destination mask
is logically within a local subnet route but is not on the physical Ethernet and resides
upstream from the DSL Router. A remote route cannot be created unless at least one
DSL interface has been configured.
Example: Refer to Chapter 4, DSL Router Configuration Examples.
assigned to an Ethernet interface with the ifn address command. The
Ethernet interface route can be deleted with the ip route purge or the
ip route delete command. Once deleted, the interface route must be
entered manually using ip route create or the ifn address
command.
A-4
6371-A2-GB20-00March 2000
Page 53
Command Line Interface
ip route create upstream e0[/ifn] next-hop-ip
ip route delete upstream e0[/ifn]
Enter or delete upstream IP routing table entries. When the DSL interface is
unnumbered, an IP routing table entry will be created automatically with the next hop
router as remote.
Minimum access level: Administrator/Config
create – Create an IP route table entry.
delete – Delete an IP route table entry.
e0, e0/1, e0/2, e0/3, e0/4 – Ethernet interface. e0 is the same as e0/1. Specified logical
Ethernet interface.
next-hop-ip – IP address of the next hop upstream router used to reach the remote
destination.
NOTE: When the DSL interface is configured for numbered mode, the next hop
Example: Refer to Refer to Chapter 4, DSL Router Configuration Examples.
router IP address must fall into one of the (service domain) IP subnets
configured for the DSL interface.
ip route purge
Deletes all static and dynamic IP route table entries, including interface routes.
NOTE: An interface route is created automatically when an address and mask are
Minimum access level: Administrator/Config
assigned to an Ethernet interface with the ifn address command. The
Ethernet interface route can be deleted with the ip route purge or the
ip route delete command. Once deleted, the interface route must be
entered manually using ip route create or the ifn address
command.
6371-A2-GB20-00
March 2000
A-5
Page 54
Command Line Interface
ARP Table
arp timeout incomplete time
Specifies the ARP table timeout value in seconds for incomplete ARP table entries.
Default = 5 seconds.
Minimum access level: Administrator/Config
arp timeout complete time
Specifies the ARP table timeout value in minutes for complete ARP table entries.
Default = 20 minutes.
Minimum access level: Administrator/Config
arp { create | delete } ip-address mac-address
Creates or deletes a single, static ARP table entry . Static ARP entries created with this
command are retained across resets/power cycles.
Minimum access level: Administrator/Config
create – Create an ARP table entry.
delete – Delete an ARP table entry.
ip-address – The IP address of the ARP entry to be created or deleted.
mac-address – MAC address (valid for create command).
Examples:arp create 132.53.4.2
arp delete 132.53.4.2
Proxy ARP
arp purge ALL
Deletes ALL static and dynamic ARP table entries.
Minimum access level: Administrator/Config
proxy arp { e0 | d0 } [ enable | disable ]
Enables or disables proxy ARP for the specified interface. If enable/disable is not
specified in the command, enable is the default.
Minimum access level: Administrator/Config
e0 – The Ethernet interface.
d0 – The DSL interface.
enable – Enable Proxy ARP.
disable – Disable Proxy ARP.
NOTE: Proxy ARP and NAPT cannot be enabled at the same time. When Basic
NAT is enabled, Proxy ARP is allowed on the d0 interface.
Example: proxy arp d0 disable
A-6
6371-A2-GB20-00March 2000
Page 55
NAT
Command Line Interface
nat { basic | napt } address ip-addr
Defines the public IP addresses used in the one-to-one mapping function of Basic NA T
or the public IP address of a single host for use in the many to one mapping function of
NAPT. NAPT cannot accept incoming requests, unless a static NAT entry has been
configured.
Minimum access level: Administrator/Config
ip-addr – For Basic NAT, ip-addr is the IP address of a Class C network. For NAPT,
ip-addr is any valid public IP address.
Example: nat napt address 10.1.3.2
nat napt map {udp | tcp } server-ip port
Specifies global access to a local server, such as a Web server. Port-based static
entries can be configured for NAPT. This allows a global host to access a server behind
the DSL router without exposing the local server’s IP address.
Minimum access level: Administrator/Config
udp, tcp – Specify the protocol to be used.
server-ip – Enter the IP address of a local server. Only one server of a particular type
(FTP, Telnet, SMPT, TFTP, gopher, finger, http, etc.) can be supported at one time.
port – The destination port number for the specified server.
Example: nat napt map tcp 192.128.1.1 102
nat timeout time
Specifies the NA T timeout values for mapping set up dynamically.
Minimum access level: Administrator/Config
time – The timeout value in minutes. Default = 60 minutes.
Example: nat timeout 90
Statically maps public to private IP addresses for the one-to-one mapping function of
Basic NAT. In the first command, a single address pair is mapped. In the second
command, a range of IP addresses will be contiguously mapped starting at the pair
defined by the lower-public-ip and lower-private-ip argument.
Minimum access level: Administrator/Config
public-ip – IP address of the public address space which is to be mapped to the IP
address of a local host.
private-ip – IP address of a local host which is to be mapped to an IP address in the
public IP address space.
lower-public-ip – Lowermost IP address of a range of public addresses which are to be
mapped to a range of IP addresses of local hosts.
lower-private-ip – Lowermost IP address of a range of local host IP addresses which
are to be mapped to a range of IP addresses in the public IP address space.
upper-private-ip – Uppermost IP address of a range of local IP addresses which are to
be mapped to a range of IP addresses of local hosts.
Example: nat basic map 192.128.1.1 10.1.3.2
In the first command, the command deletes static mapping entries associated with the
one-to-one mapping of Basic NA T. In the second command, a range of IP addresses will
be contiguously deleted starting at the pair defined by the lower-private-ip and ending
with the upper-private-ip argument.
Minimum access level: Administrator/Config
private-ip – Statically mapped IP address of the local host.
lower-private-ip – Lowermost IP address of a range of local host IP addresses which
are to be deleted.
upper-private-ip – Uppermost IP address of a range of local IP addresses which are to
be deleted.
Example: nat basic delete 192.128.1.1
nat napt delete {udp | tcp} port
Deletes static mapping entries which identify a local server.
Minimum access level: Administrator/Config
udp, tcp – Specify the protocol used.
port – The port number associated with the server-ip.
Example: nat napt delete tcp 102
nat basic enable
Enables the one-to-one mapping function of Basic NA T. Enabling Basic NAT
automatically disables NA T NAPT. If Basic NAT is enabled, Proxy ARP must be enabled
on the d0 interface when the d0 interface address is part of the Basic NA T global IP
network address.
Minimum access level: Administrator/Config
nat napt enable
Enables the many-to-one mapping function of NAPT. Enabling NAT NAPT automatically
disables Basic NAT.
Minimum access level: Administrator/ Config
NOTE: Proxy ARP and NAPT cannot be enabled at the same time.
nat disable
Disables the currently enabled NAT, either Basic NAT or NAPT.
Minimum access level: Administrator/Config
nat purge
Purges all mapping entries.
Minimum access level: Administrator/Config
A-8
6371-A2-GB20-00March 2000
Page 57
DHCP Server
Command Line Interface
The DHCP Server can be enabled and disabled, configured by IP address option.
Based on RFC 2131 and RFC 2132, supported options are:
HDomain Name
HDomain Name Server
HRouter
dhcp server {enable
Enables or disables the DHCP server.
Minimum access level: Administrator/Config
enable – Enable the DHCP Server.
disable – Disable the DHCP Server. Default = disable.
Example: dhcp server enable
| disable}
dhcp server addresses lower-ip-address upper-ip-address
Specifies the range of IP addresses to be used by the DHCP server. When the DHCP
address range is changed, all binding entries and dynamic routes are removed.
Minimum access level: Administrator/Config
Example: dhcp server address 132.53.4.2 132.53.4.350
dhcp server leasetime min-lease-time max-lease-time
Specifies the lease-time settings used by the DHCP server.
Minimum access level: Administrator/Config
Specifies the router IP address used by the DHCP server.
Minimum access level: Administrator/Config
Example: dhcp server router 132.53.4.2
dhcp server name domain name
Specifies the domain name used by the DHCP server.
Minimum access level: Administrator/Config
Example: dhcp server name Clearwater7
6371-A2-GB20-00
March 2000
A-9
Page 58
Command Line Interface
DHCP Relay Agent
dhcp server nameserver ip-address
Specifies the DNS IP address used by the DHCP server.
Minimum access level: Administrator/Config
Example: dhcp server nameserver 132.53.4.2
dhcp relay {enable | disable}
Enables or disables the DHCP relay agent. The DHCP relay agent will maintain up to
256 DHCP clients.
Minimum level access: Administrator/Config
enable – Enable the DHCP relay. Default = enable.
disable – Disable the DHCP relay.
Example: dhcp relay enable
dhcp relay address ip-address
IP Packet Processing
Use this command to specify the DHCP server to forward DHCP requests to.
Minimum level access: Administrator/Config
Example: dhcp relay address 132.23.4.2
IP multicast {enable | disable}
Enables or disables the forwarding of IP multicast packets. This setting is retained
across power cycles.
Minimum access level: Administrator
enable – Enable forwarding of IP multicast packets.
disable – Disable forwarding of IP multicast packets. Default = disable.
IP processing {enable | disable}
Enables or disables the processing of IP packets in the service domain. This setting is
retained across power cycles.
Minimum access level: Administrator
enable – Enable processing of IP packets. Default = enable.
disable – Disable processing of IP packets.
A-10
6371-A2-GB20-00March 2000
Page 59
Show Command Outputs
show console
Displays: console enabled or console disabled
show system
Sample show system display:
Jul 21 09:53:26 1999
System ID: xxxxxxxx
Model #: xxxx, Serial #: xxxxxxxxxxxx, HW-Rev: xxx
Boot: FW-Version: xxxxxxxx
2nd Stage Boot: FW-Version: xxxxxxxx
Image 0: FW-Version: xxxxxxxx, [active]
Image 1: FW-Version: xxxxxxxx
DSL: FW-Version: xxx
Selftest Result: { pass | failed }
If an IP address is not provided, the entire table will be displayed with the upstream
routes displayed first and the downstream routes next. If the IP address is provided, only
the specific entry will be displayed. If the next hop IP address = 0.0.0.0, the host is
directly reachable on the Ethernet interface (e0).
Minimum access level: Operator
Sample show ip route display:
source ip-addr
x.x.x.xx.x.x.xx.x.x.xd0
source subnet-masknexthop ip-addrinterface
dest ip-addr
x.x.x.xx.x.x.xx.x.x.xe0
6371-A2-GB20-00
dest subnet-masknexthop ip-addrinterface
March 2000
A-11
Page 60
Command Line Interface
show arp
Sample show arp display:
ip-addr
x.x.x.xxx:xx:xx:xx:xx:xx xxxx xxxx
MAC addresstimeout (minutes) incomplete status (seconds)
NOTES: – The timeout value shown is the actual time left for the specific entry.
– The timeout value shown will be Static for configured static entries.
show arp timeout
ARP timeout for completed ARP table entries = nn minutes
ARP timeout for incomplete ARP table entries = nn seconds
show nat basic
Sample show nat basic display:
NAT basic – { disabled | enabled }
NAT basic – public network address
NAT timeout – xx minutes
NAT basic mappings:
public ip-addr
x.x.x.xx.x.x.x
private-ip-addr
show NAT napt
Sample show NAT NAPT display:
NAT napt – { disabled | enabled }
NAT napt – public ip-addr xxx.xxx.xxx.xxx
NAT timeout – xx minutes
NAT napt mappings –
server ip-addr
x.x.x.xxxxx{ udp | tcp }
portprotocol
A-12
6371-A2-GB20-00March 2000
Page 61
show dhcp server
Displays the DHCP relay’s current status and configuration.
Minimum access level: Administrator
Sample show dhcp server display:
DHCP server – { disabled | enabled }
DHCP server – router ip-addr: x.x.x.x
DHCP server – name: domain name.com
DHCP server – nameserver ip-addr: x.x.x.x
DHCP server address range –
lower ip-addr
upper ip-addr
DHCP server – leasetime –
minimum minutes xxxx
maximum minutes
DHCP server bindings –
ip-addrMAC addressleasetime (minutes)
x.x.x.xxx:xx:xx:xx:xx:xxnnnn
x.x.x.x
x.x.x.x
xxxx
Command Line Interface
show DHCP relay
Displays the DHCP relay agent’s current status and configuration.
Minimum level access: Administrator
Refer to Chapter 6, Diagnostics and Troubleshooting.
6371-A2-GB20-00
March 2000
A-13
Page 62
Command Line Interface
This page intentionally left blank.
A-14
6371-A2-GB20-00March 2000
Page 63
Configuration Defaults &
Command Line Shortcuts
Configuration Default Settings
All configuration options and factory default settings are listed alphabetically in
Table B-1, Default Configuration Settings. Refer to Table B-2, Command Line
Shortcuts, for abbreviated command line input.
Table B-1. Default Configuration Settings (1 of 2)
B
Configuration Option
ARP cache entriespurged
ARP timeout for complete entries20 minutes
ARP timeout for incomplete entries5 seconds
console access locallyenabled
d0 interface IP address (DSL)purged
DHCP relaydisabled
DHCP relay address assignmentpurged
DHCP serverdisabled
DHCP server address assignmentpurged
DHCP server max-lease-time4320 minutes
DHCP server min-lease-time120 minutes
DHCP server name assignmentpurged
DHCP server nameserver assignmentpurged
DHCP server router assignmentpurged
Factory Default Setting
Ethernet frameDIX
e0 interface IP address (Ethernet)purged
6371-A2-GB20-00
March 2000
B-1
Page 64
Configuration Defaults & Command Line Shortcuts
Table B-1. Default Configuration Settings (2 of 2)
Configuration OptionFactory Default Setting
IP multicastdisabled
IP processingenabled
login-IDparadyne
NATdisabled
NAT basic static IP address mappingspurged
NAT IP addresspurged
NAT NAPT static port mappingspurged
NAT timeout20 minutes
passwordabc123
ping data size64 bytes
ping time-out10 seconds
proxy ARPdisabled
system identity stringcustomer
syslog IP addresspurged
syslog levelnorm
syslog messagespurged
syslog port514
syslog statusdisabled
traceroute data size64 bytes
traceroute time-out10 seconds
traceroute max number of hops8
B-2
6371-A2-GB20-00March 2000
Page 65
Command Line Input Shortcuts
Text in bold is the minimum input for each command line entry.
Table B-2. Command Line Input Shortcuts (1 of 2)
admin {disable | enable}
arp create <ip–addr> <mac–addr>
arp delete <ip–addr>
arp timeout complete [<time>]
arp timeout incomplete [<time>]
arp purge
autologout {disable | enable}
configure {factory | terminal}
console {disable | enable}
clear statistics {d0 | e0 | ip}
delete {d0[/ifn] | e0[/ifn]}
dhcp relay {disable | enable}
dhcp relay address <ip–addr>
dhcp server {disable | enable}
dhcp server address <lower–ip> <upper–ip> <ip–mask>
dhcp server leasetime <min–time> <max–time>
dhcp server name <name>
dhcp server nameserver <ip–addr>
dhcp server router <ip–addr>
exit
frame {dix | 802.3}
help
ifn address {d0[/ifn] | e0[ifn]} <ip–addr> <ip–mask> [primary]
ifn address d0 unnumbered
ifn {d0[/ifn] | e0[/ifn]} primary
ip multicast {disable | enable}
ip processing {disable | enable}
ip route create <dest–ip> <dest–mask> <next–hop–ip>
ip route create <dest–ip> <dest–mask> remote
ip route create upstream {e0[/ifn] | d0[/ifn]} <next–hop–ip>
ip route delete <dest–ip> <dest mask>
ip route delete upstream e0[/ifn]>
ip route purge
list [config]
logout
name <name>
Configuration Defaults & Command Line Shortcuts
6371-A2-GB20-00
March 2000
B-3
Page 66
Configuration Defaults & Command Line Shortcuts
Table B-2. Command Line Input Shortcuts (2 of 2)
nat basic address <ip–addr>
nat basic delete <private–ip>
nat basic delete <lower–private–ip> <upper–private–ip>
nat basic enable
nat basic map <public–ip> <private–ip>
nat basic map <lower–public–ip> <lower–private–ip> <upper–private–ip>
nat disable
nat napt address <ip–addr>
nat napt delete {udp | tcp} <port>
nat napt enable
nat napt map {udp | tcp} <server–ip> <port>
nat purge
nat timeout <time>
password {admin | operator} <password>
ping <dest–ip> [mgt | –x <source_ip> ] [–l <bytes>] [–w <time>]
proxy arp {d0 | e0} {disable | enable}
restart
save
show alarms
show arp
show arp <ip–addr>
show arp timeout
show config
show console
show dhcp {relay | server}
show interface {d0 | e0}
show ip route
show ip route <ip–addr>
show log [<number of entries>]
show nat {basic | napt}
show statistics [d0 | e0 | ip]
show syslog
show system
syslog {disable | enable}
syslog ip <ip–addr>
syslog level {emer | err | norm | info | debug}
syslog port <port>
system identity <identity>
traceroute <dest–ip> [–x <src–ip>] [–l <bytes>] [–w <time>] [–h <hops>]
B-4
6371-A2-GB20-00March 2000
Page 67
DSL Router Terminal Emulation
DSL Router Terminal Emulation
The Command Line Interface is available at the DSL router when the Console
cable is connected to a VT100-compatible terminal or a PC running a terminal
emulation program. Verify the terminal settings:
HData rate set to 19.2 kbps (19200 bps)
HCharacter length set to 8
C
HParity set to None
HStop bits set to 1
HFlow control set to Off or None
Accessing the List Command Output
Use the list confg command to output command strings needed to restore
the current running configuration. Output from the List Confg command can be
captured to a text file using most terminal emulation programs. Examples of two
VT100-compatible programs are provided.
Once the text file is captured, the DSL router can be placed in configuration
mode. The text file can be fed back to configure the DSL router and save the
configuration.
6371-A2-GB20-00
March 2000
C-1
Page 68
DSL Router Terminal Emulation
Terminal Emulation Programs
Examples of configuring two different terminal emulation programs:
HHyperTerminal – playback feature is accessed through its T ransfer menu.
HProcomm+ – playback feature is accessed through its Online menu.
" Procedure
To configure the HyperTerminal:
1. Select menu option Transfer → Send Text File.
2. Select File → Properties.
3. In the Properties dialog, select the Settings tab.
4. Set Emulation to VT100.
5. Select the Terminal Setup button and set to 132 column mode.
6. Select OK to exit Terminal Setup.
7. Select the ASCII Setup button.
— Set Line delay to 50 ms.
— Set Character delay to 2 ms.
8. Select OK to exit ASCII Setup.
9. Select OK to exit Properties.
" Procedure
To configure Procomm+:
1. Select menu option Online → Send File.
2. In the Send File dialog, set the protocol to ASCII.
3. Select the Setup button.
4. Select the Transfer Protocol button (on the left).
5. Select ASCII in the Current Protocol drop-down box.
— Set delay between Character to 2 ms.
— Set delay between Lines to 2 ms.