INDEX   TOC
Introduction
Product Overview
Settings and Administration
ADSL
SIP Support
Security
  Broadband Security
  Firewall Overview
  The Firewall in
  VPN Pass Through
  Security Log
  Smart Card Reader
Firewall Administration
Troubleshooting

Configure Using Command Line Interface

The command line interface (CLI), or shell as it also often is called, is a text based administration interface, which is used as an alternative or a complement to the web based interface.

The CLI is accessible by using the Telnet protocol, provided that access has been enabled in the security profile configuration.

Access to the CLI is granted through a login (authentication) procedure, requesting a username and a password. (Note that Telnet transmits this information in cleartext, i.e. not encrypted in any way.) The CLI uses the same user database as the web interface for authentication.

Overview

Once a user has logged in, a prompt is displayed and the CLI waits for the user to type a line of input. All command lines follow the same format: a command name, possibly followed by a number of arguments.

Depending on which command is specified some arguments are required, while others are optional. Most commands display usage information if the first argument is -h (help). There is also a help command which displays a short description of what the specified command does.

More than one "line" of input can be entered on the same line, using a semicolon as a separator, e.g. ls /tmp ; cat /tmp/foo.txt

The /proc filesystem

The /proc filesystem is a virtual filesystem which contains (virtual) files. These files contain information about the current state of the system. It works like a "normal" filesystem in the sense that the same commands can be used, e.g. cat , ls , etc. However, the illusion isn't perfect so sometimes the result isn't what one might expect.

The /proc/cfg directory offers access to "live" configuration parameters either by specifying a parameter name or a configuration context. Specific parameters are accessible as /proc/cfg/<parameter name>, while contexts are accessed as /proc/cfg/<context name>/[<sub context name>/]all. Use ls to find out which contexts that are available.

Note!

  •  
  • The /proc filesystem is currently read-only.

    Examples

    Example 1 - A simple command

    admin@ix66# ls /usr

    Lists the contents of the directory /usr.

    Example 2 - Issuing multiple commands

    admin@ix66# ls /usr ; cat /usr/net.cfg

    Lists the contents of the directory /usr and then display the contents of the file /usr/net.cfg

    Example 3 - Displaying a live configuration parameter value

    admin@ix66# cat /proc/cfg/net.et1.ip=

    Display the IP-address of interface et1.

    Example 4 - Configure a subsystem

    admin@ix66# save /usr/net.cfg

    Perform a configuration of the network susbsystem by "saving" the file /usr/net.cfg.

    Example 5 - Upgrade the firmware

    admin@ix66# tftpupgrade 192.168.0.10 66X122__.tar

    Upgrade the firmware using the file 66X122__.tar located at the TFTP-server with the IP-address 192.168.0.10.

    Example 6 - Execute a shell script

    admin@ix66# source /tmp/script.txt

    Read commands from the file /tmp/script.txt and execute them as if they had been entered by the operator.

    Command reference table

    Note!

  •  
  • Apart from the arguments listed in the table below, most commands can be invoked with -h as the first argument to print usage information.
  •  
  • Multiple arguments are separated by a space.

    Command name Description
    cat Concatenate ("join") files and print to standard output. Arguments: one or more filenames.
    exit Exit the shell. Arguments: none.
    help Print a short descriptive text of what a command does. Arguments: none (displays general help) or command name (optional)
    ls List directory contents. Arguments: one or more directory names.
    reboot Exit the shell and reboot the system. Arguments: now (required)
    rm Remove (delete) files. Arguments: one or more filenames.
    save Save (and activate) a configuration file, i.e. an operation similar to pressing a "Save" button in the web interface. Arguments: source filename (optional), confiugration file filename ( -h displays a list of supported configuration files).
    source Read and execute (shell) commands from the specified file(s). Arguments: one or more filenames.
    tftpget Retrieve a file from a TFTP-server. Arguments: TFTP server address (hostname or IP-address), source (remote) file name, destination (local) filename.
    tftpput Send a file to a TFTP-server. Arguments: TFTP server address (hostname or IP-address), source (local) filename, destination (remote) filename.
    tftpsave Retreive a configuration file from a TFTP-server and then save it - see "save" above for more information. Arguments: TFTP server address (hostname or IP-address), source (remote) file name, destination (local) filename.
    tftpupgrade Retrieve an "upgrade file" (tar-archive) from a TFTP-server and upgrade the unit's firmware using that file. Arguments: TFTP server address (hostname or IP-address), source (remote) file name.