Distribution and copying of this document, use and communication of its contents is not permitted without written authorization
from THOMSON. The content of this document is furnished for informational use only, may be subject to change without notice,
and should not be construed as a commitment by THOMSON. THOMSON assumes no responsibility or liability for any errors or
inaccuracies that may appear in this document.
The following trademarks are used in this document:
SpeedTouch™ is a trademark of THOMSON.
Bluetooth® word mark and logos are owned by the Bluetooth SIG, Inc.
Ethernet™ is a trademark of Xerox Corporation.
Wi-Fi® and the Wi-Fi logo are registered trademarks of the Wi-Fi Alliance. "Wi-Fi CERTIFIED", "Wi-Fi ZONE", "Wi-Fi Alli-
ance", their respective logos and "Wi-Fi Protected Access" are trademarks of the Wi-Fi Alliance.
UPnP™ is a certification mark of the UPnP™ Implementers Corporation.
Microsoft®, MS-DOS®, Windows® and Windows NT® are either registered trademarks or trademarks of Microsoft Corpo-
ration in the United States and/or other countries.
Apple® and Mac OS® are registered trademarks of Apple Computer, Incorporated, registered in the United States and
other countries.
UNIX® is a registered trademark of UNIX System Laboratories, Incorporated.
Adobe®, the Adobe logo, Acrobat and Acrobat Reader are trademarks or registered trademarks of Adobe Systems, Incor-
porated, registered in the United States and/or other countries.
Netscape® and Netscape Navigator® are registered trademarks of Netscape Communications Corporation.
Other brands and product names may be trademarks or registered trademarks of their respective holders.
13Resetting the SpeedTouch™ ...................................203
E-DOC-CTC-20051017-0155 v1.0
v
Contents
vi
E-DOC-CTC-20051017-0155 v1.0
Used Symbols
About this Operator’s Guide
A note provides additional information about a topic.
A tip provides an alternative method or shortcut to perform an action.
A caution warns you about potential problems or specific precautions that
!
need to be taken.
About this Operator’s Guide
Terminology
Typographical
Conventions
Documentation and
software updates
Generally, the SpeedTouch™620 will be referred to as SpeedTouch™ in this
Operator’s Guide.
When we display interactive input and output we’ll show our typed input in a bold font and the computer output
Comments are added in italics.
Example:
=>language list
CODE LANGUAGE VERSION FILENAME
en* english 4.2.0.1 <system>
THOMSON continuously develops new solutions, but is also committed to improve
its existing products.
For more information on THOMSON's latest technological innovations, documents
and software releases, visit us at:
like this.
Only one language is available
www.speedtouch.com
E-DOC-CTC-20051017-0155 v1.0
1
About this Operator’s Guide
2
E-DOC-CTC-20051017-0155 v1.0
1Introduction
OverviewBeing a key component of your business network, a good operation of the
SpeedTouch™ is essential to gain maximum performance of your DSL connectivity.
Continuous management and diagnosis of the SpeedTouch™ should be performed
to ensure a faultless operation of the SpeedTouch™, 24hours a day, 7 days a week.
As such the SpeedTouch™ can be perfectly embedded in high quality networks.
ApplicabilityThis Operator’s Guide applies to the SpeedTouch™620 Wireless Business DSL
Router.
ContentsThis Operator’s guide consists of 2 major parts:
Configuration:
How to manage the SpeedTouch™ system configuration.
The SpeedTouch™ Command Line Interface.
How to manage the SpeedTouch™ system software.
How to activate software modules with activation keys.
How to configure the SpeedTouch™ system services.
The SpeedTouch™ file system.
How to access the SpeedTouch™ remotely.
How to use the integrated ISDN Modem of SpeedTouch™.
Monitoring and debugging:
How to monitor the SpeedTouch™.
How to identify the SpeedTouch™ with AWS.
The SpeedTouch™ Advanced Diagnostics.
SLA Monitoring.
How to reset the SpeedTouch™ to defaults.
Chapter 1
Introduction
E-DOC-CTC-20051017-0155 v1.0
3
Chapter 1
Introduction
4
E-DOC-CTC-20051017-0155 v1.0
2SpeedTouch™ Command Line Interface
2.1About the CLI Interface
CLI accessYou can access the Command Line Interface via:
The SpeedTouch™ CLI Web Interface
A Telnet session
The serial Console interface.
Chapter 2
SpeedTouch™ Command Line Interface
CLI web page access
requirements
CLI Telnet access
requirements
CLI serial access
requirements
To access the CLI via the SpeedTouch™ Web Interface, you need:
A TCP/IP connection between the computer and the SpeedTouch™.
A web browser on your computer. The web browser should be at least
Microsoft's Internet Explorer 4.0, Netscape's Communicator 4.06, or
equivalent. The web browser must support Java Script.
To access the CLI via an IP Telnet session, you need:
A TCP/IP connection between the computer and the SpeedTouch™.
A Telnet application on the computer.
All popular, recent Operating Systems feature a built-in telnet application.
To access the CLI via the serial Console port, you need:
A cable.
A terminal application that you can use to connect to other devices.
Example: Hilgraeve’s Hyperterminal application delivered with MS Windows
OSs.
The following application’s Port settings:
9600 bits per second
8 data bits
No parity
One stop bit
No Flow control
ANSI terminal emulation
E-DOC-CTC-20051017-0155 v1.0
5
Chapter 2
SpeedTouch™ Command Line Interface
2.2CLI Access via Telnet or Serial Console
Access via a Telnet
session or serial
console
As soon a session to the CLI is opened, a banner pops up, followed by the CLI
prompt:
If the SpeedTouch™ is protected by a system password, authentication will be
required before access is granted to the CLI.
6
E-DOC-CTC-20051017-0155 v1.0
2.3Basic Navigation
Chapter 2
SpeedTouch™ Command Line Interface
Command group
navigation
From the top level, you can change to a command group by executing the name of
the desired command group (for example type the name of the command group
and press ENTER).
To obtain a list of all available command groups, use the
help command from the
top level:
=>:help
Following commands are available :
help : Displays this help information
menu : Displays menu
? : Displays this help information
exit : Exits this shell.
.. : Exits group selection.
saveall : Saves current configuration.
ping : Send ICMP ECHO_REQUEST packets.
traceroute : Send ICMP/UDP packets to trace the ip path.
telnet : Open a telnet connection to a server.
Following command groups are available :
firewall service autopvc connection cwmp
dhcp dns dsd dyndns eth
expr ids igmp ip isdn
adsl atm capi config debug
env hostmgr interface ipqos label
language mbus memm mlp nat
ppp pptp rcapi router script
sla snmp sntp software ssh
syslog system tunnel upnp user
wireless
The exact list of available command groups depends on the type of
SpeedTouch™, the number and kind of activated software modules and on
the current version of the SpeedTouch™ System software.
To return to top level, or to go up one level (in case of nested command groups),
type two dots and press ENTER.
E-DOC-CTC-20051017-0155 v1.0
7
Chapter 2
SpeedTouch™ Command Line Interface
HelpYou can use help or ? from any level to list all available commands and command
groups for that level. Below an example is provided of executing help from the
firewall command group selection:
=>:firewall help
Following commands are available :
Executing :help firewall from top level gives the same result.
Entering
list
command group selection) results in a description of the syntax for the command:
=>:help firewall list
Display firewall configuration.
Syntax : list [format = <{pretty|cli}>]
Parameters :
Executing
available CLI commands (including syntax description). If entered from within a CLI
command group, the listing of all available CLI commands from that CLI command
group (including syntax description) are shown.
help followed by a specific command, for example :help firewall
(starting from top level) or help list (entered from within the firewall
[format = <{pretty|cli}>]
The format of the firewall list.
:help all from top level will generate the complete listing of all
Command completionThe CLI features command completion, which means that when starting to type a
command it can be completed by pressing TAB.
For the completion to be successful, the part already typed has to be unique.
Completion works for the command groups, for the commands and the options, but
not for values.
For example, typing the letter l at the firewall command group selection, followed
by pressing TAB results in the full command being completed. Entering
l
from top level and pressing TAB gives the same result: the command is
completed to
firewall list.
firewall
Going to the beginning
or end of a line
You can move the cursor to the beginning of the command line by pressing
"CTRL+A"; to move the cursor to the end of the Command Line press "CTRL+E".
Breaking off commandsYou can break off a command by pressing "CTRL+G". This can be useful in a
situation where a user wants to abort the command. This can be useful to break off
commands for which the user does not know the value of a required command
parameter.
8
E-DOC-CTC-20051017-0155 v1.0
Chapter 2
SpeedTouch™ Command Line Interface
History of CommandsThe CLI allows you to re-use commands you have used before during a CLI session.
To scroll through the previously used CLI commands use UP ARROW and DOWN
ARROW.
To execute a re-used command, press ENTER.
E-DOC-CTC-20051017-0155 v1.0
9
Chapter 2
SpeedTouch™ Command Line Interface
2.4Command Line Interface Commands
Executing Commands
from the Top Level
All CLI commands are commands that operate on, or configure, the SpeedTouch™
settings.
You can use these commands from top level, preceded by the name of the
command group from which the command should be executed (for example
----------------------------------------------------------------------fireenabled Firewall Administration Modulesink, for
ward, source
host_serviceenabled Firewall Host Service Moduleforward
levelenabled Firewall Level Moduleforward
system_serviceenabled Firewall System Service Modulesink
Executing Commands
from Anywhere
Using Partial Command
Statements
“!” in a command means NOT, for example the [!] parameter in the firewall rule
create command [
It is possible to enter a command from anywhere within the CLI, provided the
command is preceded by a colon (:) and the full command path, e.g.:
[firewall]=>:ip rtlist
Instead of typing a complete command with all of its required and optional
parameters and pressing ENTER, you can also enter the command itself, without
specifying any parameter. If all parameters are optional, the command is executed
immediately, assuming default values for all parameters. In case the CLI command
features required parameters, you are prompted to complete the command with the
required (and the optional, if present) parameters. For optional parameters you can
simply press ENTER without giving a value (to assume default value). In case the
parameter provides preset values, you can scroll through these via the UP and
DOWN arrow keys. For example, the
values enabled and disabled:
Saving the configurationAfter configuring the SpeedTouch™ via the CLI, it is advised to save your
configuration.
You can save the complete SpeedTouch™ configuration to persistent memory by
executing the
saveall command can be entered from any CLI prompt.
The
saveall command.
12
E-DOC-CTC-20051017-0155 v1.0
Chapter 2
SpeedTouch™ Command Line Interface
2.5Menu-driven CLI Navigation
IntroductionTo improve the user-friendliness of the SpeedTouch™ CLI, the CLI features a menu-
driven interface.
Entering the CLI menuTo enter the menu-driven interface, simply enter the command menu from the CLI
prompt:
The semi-graphical CLI offers you an attractive and easy-to-use configuration
environment for the CLI.
You can browse through the CLI command groups via the arrow keys. Pressing
ENTER executes your selection, i.e. for entering a CLI command group. From each
level you can select .. and press ENTER to go up one level.
Use TAB to change from the command menu to the control menu (the lower bar of
the menu) and vice versa.
Executing commandsTo setup a CLI command, simply press ENTER on its name. You can configure and
overview its various parameters at once. In case the parameter provides preset
values, scroll through the available values via the UP and DOWN arrow keys. If you
are satisfied with all parameter values, use TAB to select
execute the command:
Saving the configuration after configuring the SpeedTouch™ via the CLI, it is
advised to save your configuration.
Save the complete SpeedTouch™ configuration to persistent memory by executing
<OK> and press ENTER to
saveall after exiting the menu-driven CLI via <Cancel> from root menu.
E-DOC-CTC-20051017-0155 v1.0
13
Chapter 2
SpeedTouch™ Command Line Interface
14
E-DOC-CTC-20051017-0155 v1.0
3SpeedTouch™ System Software
3.1About the System Software
Chapter 3
SpeedTouch™ System Software
Upgrade system
software
System software
packages and security
For new system software packages, you can visit the SpeedTouch™ support pages
at: http://www.speedtouch.com
All SpeedTouch™ system software packages are:
Digitally signed and encrypted:
Packages that may have become corrupted, or have been altered in any way,
will not be accepted by the SpeedTouch™.
Specific per product.
This way, the SpeedTouch™, or its service can never be corrupted or lost.
E-DOC-CTC-20051017-0155 v1.0
15
Chapter 3
SpeedTouch™ System Software
3.2System Software Management via FTP
FTP accessFor more information on the SpeedTouch™ file system and how to access
it via FTP, see “7 The SpeedTouch™ File System” on page 75.
SpeedTouch™ system
software locations
OverviewThis section covers the following topics:
The SpeedTouch™ file system consists of two subdirectories: ‘/active’ and ‘/ dl’.
In the ‘/active’ subdirectory the currently running system software (the active
software version) is stored. The ‘/dl’ subdirectory stores the dormant system
software (the passive software version).
There are SpeedTouch™ devices where only the ‘/dl’ directory exist (single
directory file system).
In case no SpeedTouch™ system software upgrade was performed before, both
active and passive software will be the same.
Full read/write access is only granted in the ‘/dl’ subdirectory.
TopicSee Page
“3.2.1 Backup System Software via FTP”17
“3.2.2 Upgrade or Restore System Software via FTP”19
“3.2.3 Manual System Software Management via BOOTP/
TFTP server”
23
16
E-DOC-CTC-20051017-0155 v1.0
SpeedTouch™ System Software
3.2.1Backup System Software via FTP
IntroductionFor backup reasons, you can transfer system software files from both
SpeedTouch™’s ‘/active’ and ‘/dl’ subdirectories to your local disk.
Backup procedureTo transfer system software files from the SpeedTouch™ to your local disk as
backup, proceed as follows:
StepAction
Chapter 3
1
Open an FTP session to the SpeedTouch™. At the user name prompt,
enter a user name and at the password prompt, if applicable, the
Password (see “The Multi Level Access Policy Configuration Guide” for
more information):
C:\>ftp <SpeedTouch™ IP address>
Connected to <SpeedTouch™ IP address>.
220 Inactivity timer = 120 seconds. Use 'site idle <secs>' to
change.
User (<SpeedTouch™ IP address>:(none)): JohnDoe
331 SpeedTouch (00-90-D0-01-02-03) User 'JohnDoe' OK. Password
required.
Password:#####
230 OK
ftp>
2Enter binary file transfer mode. Optionally you can enable hashing:
ftp> bin
200 TYPE is now 8-bit binary
ftp> hash
Hash mark printing On ftp: (2048 bytes/hash mark).
ftp>
3Change to the SpeedTouch™ subdirectory from which you want to get
the system software file from. In the example below the ‘/dl’
subdirectory is chosen where the currently running - and usually most
recent - system software file is stored:
E-DOC-CTC-20051017-0155 v1.0
ftp>cd dl
250 Changed to /dl
ftp>
17
Chapter 3
SpeedTouch™ System Software
StepAction
4To identify the system software file name, use the quote site
software version
ftp> quote site software version
200- Flash image : 5.4.0.10.0
200- Active SW : ZZUIAA5.40A (5.4.0.a.0)
200- Passive SW : ZZUIAA5.40A (5.4.0.a.0)
200200 CLI command "software version" executed
You can also check for the system software file by making a listing of the
subdirectory’s contents:
ftp> dir
200 Connected to 192.168.1.60 port 1312
150 Opening data connection for /bin/ls
-rwxrwxrwx 1 0 0 3601488 Jun 29 1971 ZZUIAA5.40A
-rwxrwxrwx 1 0 0 20 Jun 29 1971 start.cmd
-r--r--r-- 1 0 0 9 Jun 29 1971 seed.dat
-r--r--r-- 1 0 0 790 Jun 29 1971 sslcert.pem
-r--r--r-- 1 0 0 963 Jun 29 1971 sslkey.pem
-r--r--r-- 1 0 0 692 Jun 29 1971 sshdsa.pem
-rwxrwxrwx 1 0 0 93013 Jun 29 1971 user.ini
226 Options: -l : 7 matches total
ftp: 466 bytes received in 0,00Seconds 466000,00Kbytes/sec.
command:
5Get the system software file:
ftp> get ZZUIAA5.40A
200 Connected to 192.168.1.60 port 1315
150 Opening data connection for ZZUIAA5.40A (3601488)
226 File transfer complete
ftp: 3601488 bytes received in 5,92Seconds 608,46Kbytes/sec.
ftp>
As a result the system software file will be stored on the location from where you
started the FTP session.
18
E-DOC-CTC-20051017-0155 v1.0
SpeedTouch™ System Software
3.2.2Upgrade or Restore System Software via FTP
Chapter 3
Upgrade/Restore
procedure
The procedure to upgrade or restore the SpeedTouch™ system software consists of
three main steps:
StepAction
1
2Mark system software file as Passive Software Version
3Activate the upgrade/ restored system software
Transfer system software to the SpeedTouch™
E-DOC-CTC-20051017-0155 v1.0
19
Chapter 3
SpeedTouch™ System Software
Transfer system
software to the
SpeedTouch™
To transfer a system software file stored on your local disk to the SpeedTouch™,
proceed as follows:
StepAction
1
Open an FTP session to the SpeedTouch™. At the user name prompt,
enter a user name. At the password prompt, if applicable, enter the
SpeedTouch™ system password (see “The SpeedTouch™ Multi Level
Password Configuration Guide”):
C:\>ftp <SpeedTouch™ IP address>
Connected to <SpeedTouch™ IP address>.
220 Inactivity timer = 120 seconds. Use 'site idle <secs>' to
change.
User (<SpeedTouch™ IP address>:(none)): JohnDoe
331 SpeedTouch (00-90-D0-01-02-03) User 'JohnDoe' OK. Password
required.
Password:#####
230 OK
2Enter binary file transfer mode. Optionally you can enable hashing:
ftp> bin
200 TYPE is now 8-bit binary
ftp> hash
Hash mark printing On ftp: (2048 bytes/hash mark).
3Change to the SpeedTouch™ ‘/dl’ subdirectory:
ftp>cd dl
250 Changed to /dl
4Use the quote site software version command to check
whether a passive system software version is stored in the ‘/dl’
subdirectory :
ftp> quote site software version
200- Flash image : 5.4.0.10.0
200- Active SW : ZZUIAA5.40A (5.4.0.a.0)
200- Passive SW : ZZUIAA5.40A (5.4.0.a.0)
200200 CLI command "software version" executed
5In case a passive software version is found, use the quote site