Page 106 / 161 Scroll up to view Page 101 - 105
106
Appendix A
Starting and Ending a CLI Session
Starting and Ending a CLI Session
There are two ways to open a CLI session:
1.
Open a telnet connection from a workstation on your network
2.
Connect a terminal to the Maintenance Port located on the rear panel
of the Cayman Gateway.
Connecting from telnet
You initiate a telnet connection by issuing the following command from an IP
host that supports telnet, for example, a personal computer running a telnet
application such as NCSA Telnet.
You must know the IP address of the Cayman Gateway before you can make a tel-
net connection to it. By default, your Cayman Gateway uses 192.168.1.254 as
the IP address for its LAN interface. You can use a Web browser or the mainte-
nance console to configure the Cayman Gateway IP address.
Connecting from the Maintenance Console Port
You can connect a terminal or terminal emulator to the maintenance console port
on the Cayman Gateway to configure, administer, and monitor your Cayman
Gateway.
The settings for your terminal emulator are:
Speed: 9600 bps
Parity: None
Databits: 8
Stopbits: 1
Duplex: Full
Flow Control: None
The console interface uses the same command line interface as the telnet inter-
face.
Logging In
The command line interface log-in process emulates the log-in process for a UNIX
host. To logon, enter the username (either admin or user), and your password.
Entering the administrator password lets you display and update all Cayman
Gateway settings.
Entering a user password lets you display (but not update) Cayman Gateway
settings.
BOTH
telnet <
ip_address
>
Downloaded from
www.Manualslib.com
manuals search engine
Page 107 / 161
107
Appendix A
Using the CLI Help Facility
When you have logged in successfully, the command line interface lists the user-
name and the security level associated with the password you entered in the diag-
nostic log.
Ending a CLI Session
You end a command line interface session by typing
quit
from the SHELL node
of the command line interface hierarchy.
Saving Settings
The
save
command saves the working copy of the settings to the Gateway. The
Gateway automatically validates its settings when you save and displays a warn-
ing message if the configuration is not correct.
Using the CLI Help Facility
The
help
command lets you display on-line help for SHELL and CONFIG com-
mands. To display a list of the commands available to you from your current loca-
tion within the command line interface hierarchy, enter
help
.
To obtain help for a specific CLI command, type
help <
command
>
. You can
truncate the
help
command to
h
or a question mark when you request help for a
CLI command.
About SHELL Commands
You begin in SHELL mode when you start a CLI session. SHELL mode lets you per-
form the following tasks with your Cayman Gateway:
Monitor its performance
Display and reset Gateway statistics
Issue administrative commands to restart Cayman Gateway functions
SHELL Prompt
When you are in SHELL mode, the CLI prompt is the name of the Cayman Gate-
way followed by a right angle bracket (>). For example, if you open a CLI connec-
tion to the Cayman Gateway named “Coconut,” you would see
Coconut>
as
your CLI prompt.
SHELL Command Shortcuts
You can
truncate
most commands in the CLI to their shortest unique string. For
example, you can use the truncated command
q
in place of the full
quit
com-
mand to exit the CLI. However, you would need to enter
rese
for the
reset
command, since the first characters of
reset
are common to the
restart
command.
Downloaded from
www.Manualslib.com
manuals search engine
Page 108 / 161
108
Appendix A
SHELL Commands
The only command you cannot truncate is
restart
. To prevent accidental inter-
ruption of communications, you must enter the
restart
command in its
entirety.
You can use the Up and Down arrow keys to scroll backward and forward through
recent commands you have entered. Alternatively, you can use the
!!
command
to repeat the last command you entered.
Platform Convention
For each Shell and Config command, an “Index Tab” shows which platform(s) the
command supports. For example
Both the Cayman 3220-H and 2E-H platforms use this command.
The Cayman 3220-H platform uses this command.
The Cayman 2E-H platform uses this command.
SHELL Commands
Sends an Address Resolution Protocol (ARP) request to match the
nnn.nnn.nnn.nnn
IP address to an Ethernet hardware address.
Lets you check the ATM connection reachability and network connectivity. This
command sends five Operations, Administration, and Maintenance (OAM) loop-
back calls to the specified vpi/vci destination. There is a five second total timeout
interval.
Use the
segment
argument to ping a neighbor switch.
Use the
end-to-end
argument to ping a remote end node
Clears the configuration settings in a Cayman Gateway. If you do not use the
optional
yes
qualifier, you are prompted to confirm the
clear
command.
BOTH
arp
nnn.nnn.nnn.nnn
DSL
atmping
vpi
vci
[ segment | end-to-end ]
ENET
reset ppp [enet-B]
BOTH
arp
nnn.nnn.nnn.nnn
DSL
atmping
vpi
vci
[ segment | end-to-end ]
BOTH
clear [yes]
Downloaded from
www.Manualslib.com
manuals search engine
Page 109 / 161
109
Appendix A
SHELL Commands
Puts the command line interface into Configure mode, which lets you configure
your Cayman Gateway with Config commands. Config commands are described
starting on
page 105
.
Runs a diagnostic utility to conduct a series of internal checks and loopback tests
to verify network connectivity over each interface on your Cayman Gateway. The
console displays the results of each test as the diagnostic utility runs. If one test is
dependent on another, the diagnostic utility indents its entry in the console win-
dow. For example, the diagnostic utility indents the Check IP connect to Ethernet
(LAN) entry, since that test will not run if the Check Ethernet LAN Connect test
fails.
Each test generates one of the following result codes:
With no flags set, this command installs a file of configuration parameters into the
Cayman Gateway from a TFTP (Trivial File Transfer Protocol) server. The TFTP
server must be accessible on your Ethernet network.
With the
–fw
flag set, downloads a new firewall text configuration to the Gate-
way.
With the
–key
flag set, downloads a new feature key to the Gateway.
You can include one or more of the following arguments with the download com-
mand. If you omit arguments, the console prompts you for this information.
The
server_address
argument identifies the IP address of the TFTP server
from which you want to copy the Cayman Gateway configuration file.
The
filename
argument identifies the path and name of the configuration
file on the TFTP server.
If you include the optional
confirm
keyword, the download begins as soon as
all information is entered.
BOTH
configure
BOTH
diagnose
CODE
Description
PASS
The test was successful.
FAIL
The test was unsuccessful.
SKIPPED
The test was skipped because a test on
which it depended failed.
PENDING
The test timed out without producing a
result. Try running the test again.
BOTH
download [-fw –key
server_address
] [
filename
] [confirm]
Downloaded from
www.Manualslib.com
manuals search engine
Page 110 / 161
110
Appendix A
SHELL Commands
Downloads a new version of the Cayman Gateway operating software from a
TFTP (Trivial File Transfer Protocol) server, validates the software image, and pro-
grams the image into the Cayman Gateway memory. After you install new oper-
ating software, you must restart the Cayman Gateway.
The TFTP server must be accessible on your Ethernet network. The
server_address
argument identifies the IP address of the TFTP server on which
your Cayman Gateway operating software is stored. The
filename
argument
identifies the path and name of the operating software file on the TFTP server.
If you include the optional
confirm
keyword, you will not be prompted to iden-
tify a TFTP server or file name. Your Cayman Gateway begins the software installa-
tion using its default boot settings.
.
Adds the message in the
message_string
argument to the Cayman Gateway
diagnostic log.
Displays or modifies the types of log messages you want the Cayman Gateway to
record. If you enter the
loglevel
command without the optional
level
argu-
ment, the command line interface displays the current log level setting.
You can enter the
loglevel
command with the
level
argument to specify the
types of diagnostic messages you want to record. All messages with a level num-
ber equal to or greater than the level you specify are recorded. For example, if
you specify loglevel 3, the diagnostic log will retain high-level informational mes-
sages (level 3), warnings (level 4), and failure messages (level 5).
Use the following values for the
level
argument:
1
or
low
– Low-level informational messages or greater; includes trivial status
messages.
2
or
medium
– Medium-level informational messages or greater; includes sta-
tus messages that can help monitor network traffic.
3
or
high
– High-level informational messages or greater; includes status
messages that may be significant but do not constitute errors.
4
or
warning
– Warnings or greater; includes recoverable error conditions
and useful operator information.
5
or
failure
Failures; includes messages describing error conditions that
may not be recoverable.
Displays the IP interfaces for your Cayman Gateway.
BOTH
install [
server_address
] [
filename
] [confirm]
BOTH
log
message_string
BOTH
loglevel [
level
]
BOTH
netstat -i
Downloaded from
www.Manualslib.com
manuals search engine

Rate

4 / 5 based on 1 vote.

Bookmark Our Site

Press Ctrl + D to add this site to your favorites!

Share
Top