Telnet Tutorial

Subject: Telnet Tutorial Fri 25 Apr 2008, 12:24 am

Telnet Operation

My tutorial is provided as a supplement to the Gateway Installation
Manual and is designed to provide information on how to communicate with the
Gateway's Telnet Server. The Telnet Server provides a command and control path
for operation with the Gateway. The interaction between the Gateway and a
customer-supplied Telnet Client for many of the common Telnet functions are
documented below. The complete list of Telnet commands is available here.
The Telnet Functions described in this document are:
Ping
Establishing a Telnet Connection
Common Usage Commands
Change IP Addresses
Load New/modified Configuration
Load New Application
Log Telnet Sessions
Enlarge Telnet Window

Ping
Ping is an IP Command that is used to determine if a device is active.
Verify your device is connected to the LAN.
Type PING, the Gateway's IP Address and press the Enter key. For example:
"Ping 192.0.0.120"
If the Gateway is active, the Gateway will return echo replies back from
network server verifying that the Gateway's destination IP address is
reachable. Typically, if you can ping the Gateway, you can open a Telnet
session with the Gateway.
You may also Telnet to the Gateway and, from the command line type PING and an
IP address on your network to determine if the Gateway is able to communicate
with the specified device.

Establishing a Telnet Connection
Telnet is an IP function that allows communication with another device for
command and control. The remote device must run a Telnet Server and you must run
a Telnet Client. Telnet commands are not case sensitive and can be entered in
upper or lowercase.
Start your Telnet Client
Establish a Telnet connection to the the Telnet Server by entering the
command: Telnet 192.10.10.120 2000

In this example, 192.10.10.120 is the IP Address and 2000 is the port number.
You may be prompted for a Telnet Login Name and Password. Enter the Telnet
Name and Password defined in the configuration program. If these fields were
not defined, enter any characher in each field to begin the session with the
Telnet Server.

Common Usage Commands
HELP will return this list.
RESET resets the Gateway and its buffers, also disconnects any active socket
connections.
LOGOUT ends the current telnet session with the window, but does not kill any
active socket connections.
SHOW returns the send and receive statuses of all interfaces, any tasks that
may be running, and IP addresses/application version that is currently loaded
onto the gateway.
CHANGE allows the user to issue commands to modify the configuration from the
command line interface.

Change IP Addresses
Issuing the change command before any IP address will change the IP addresses
that the application is reading, but does not modify any IP addresses that
were originally entered in the configuration program.
Note: Any changes that were made in the telnet session with the Gateway must
be mirrored in the configuration program, if a configuration is to be
re-transferred with the changes that were made in the last Telnet session.

Load New/modified Configuration
Type Change conf load enabled. This sets the flag for loading a new
configuration.
Type Show to verify that the flag has been changed to "enabled".
Type Reset command. Once the Gateway receives the reset command, the
connection will be terminated. Your Telnet Client will display the message
"Connection to Host Lost". You must log back into the Gateway.
Startup TFTP Server or Async Server program, the old configuration will be
overwritten with the re-transferred configuration.
Re-open a Telnet session with Gateway. If configuration is successfully
reloaded, the conf load flag will report "disabled".
Note: User must re-enter the configuration program to re-transfer a new/modified
configuration (JBMGW50.CFG).

Load New Application
Type change boot app load enabled. This sets the flag for loading a new
application.
Type show to verify that the flag has been changed to "enabled".
If using a TFTP server, type change boot tftp ip 192.0.0.120 (example).
Startup the TFTP Server or Async Server program, the old application can be
overwritten with a new or upgraded application.
Type the reset command. Once the Gateway receives the reset command, the
connection will be terminated. Your Telnet Client will display the message
"Connection to Host Lost". You must log back into the Gateway.
Re-open a Telnet session with Gateway (You may have to wait 40-60 seconds
while the new application is being written to memory). If application is
successfully reloaded, the boot app load flag will report "disabled".
Type show app. Verify that the name of the new application is reported.
Note: User must copy/overwrite the old application with a new/upgraded
application (JBMGW50.BIN).

Log Telnet Sessions
Terminal -Start Logging will open telnet.log. User can rename file for
uniqueness. Move this file to a text editor to view or print.
Preferences-Stop Logging will end the current logging session.

Enlarge Telnet Window
Terminal-Preferences-increase buffer size from 25 to 100.