1998/05/11

			PPP Decoder 1.0P2 Release Note


The PPP Decoder is a Java-based application that translates the
hexadecimal output from a PortMaster(R) into human-readable form, based
on PPP-related RFCs 1332,1552,1661,1887,1700,2153.

NOTE: If you have questions, bug reports, or requests for enhancements
for the PPP Decoder, send email to pppdecoder-feedback@livingston.com.
Please do not call Lucent Remote Access Business Unit Technical Support
about this product.

The PPP Decoder supports the following protocols:  LCP, PAP, CHAP,
IPCP, CCP, IPXCP but not BAP or BACP.


		Contents

Disclaimer
System Requirements
Installing and Starting the PPP Decoder
Using the PPP Decoder
Limitations of the PPP Decoder


		Disclaimer

The PPP Decoder is released on an unsupported basis.  It is a pilot,
intended to give our customers a glimpse of possible future technology,
and to invite product feedback from our customer base.  There is no
intention on the part of Lucent Technologies to fix bugs or make
enhancements to the PPP Decoder application.


		System Requirements

ComOS(R) version 3.8 or later is required to use the PPP Decoder.

The PPP Decoder runs on any host platform that supports Java
Development Kit (JDK) or Java Runtime Environment (JRE) 1.1.4 or
higher.  For more information regarding JDK and JRE see
http://java.sun.com/cgi-bin/java-ports.cgi.


		Installing And Starting the PPP Decoder

	Installing on UNIX Systems

Ensure that JDK or JRE 1.1.4 or later is installed on your UNIX system
before running the PPP Decoder.

1. Type the following commands to download the pppdecoder_1.0p2.tar
file from our FTP site:

 ftp ftp.livingston.com
 cd pub/le/software/java
 binary
 get pppdecoder_1.0p2.tar
 quit

2. In your .cshrc, .kshrc, or .bashrc file, define the path for your
Java interpreter.  For example, for a .cshrc file:

set path=( /usr/local/lib/jre1.1.4/bin $path )

3.  Type the following command to untar the file:

 tar xvf pppdecoder_1.0p2.tar

4.  Type the following command to start the PPP Decoder installation:	

 ./pppdecinstall

If your path is defined correctly in the .cshrc file, the installation
program displays options for you to select "jre" or "java" or to define
your own Java interpreter path.

5. Follow the installation instructions.  The default directory for the
PPP Decoder is Lucent/PPPDecoder.  The installation will create a shell
script for running the PPP Decoder.

6.  Type the following command to start the PPP Decoder:

 ./pppdecoder

7.  If you want to run the PPP Decoder from outside the installation
directory, make a copy of the pppdecoder file.  Open the file in a text
editor and change the -cp argument to include the full path to the
PPPDecoder.jar file as follows:

 jre -cp /fullpath/PPPDecoder.jar PPPDecoder


	Installing on Windows 95 and NT 4.0 Systems

Ensure that JDK or JRE 1.1.4 or later is installed on your Windows 95
or NT 4.0 system before running the PPP Decoder.

1. Type the following commands to download the pppdecoder_1.0p2.zip file
from our FTP site:

 ftp ftp.livingston.com
 cd pub/le/software/java
 binary
 get pppdecoder_1.0p2.zip
 quit

2. Using an unzip utility, unzip the pppdecoder_1.0p2.zip file to the
desired location.

3. To install the PPP Decoder, type the following at the command prompt:

 cd <directory where you unzipped pppdecoder_1.0p2.zip>
 pppdecinstall

4. After the installation is complete, launch the PPP Decoder by
selecting the PPP Decoder shortcut from the Lucent folder under
Programs in your Start menu.


		Using the PPP Decoder

	Connecting to a PortMaster

1. From the PPP Decoder interface, click the "Connect to PortMaster..."
button.

2. Enter the appropriate information in the Connect To dialog box.

PPP Debugging starts automatically when a successful connection is
made.  You do not need to telnet to a PortMaster and enable PPP
Debugging when using the PPP Decoder.


	Connecting to a Second PortMaster

1. From the PPP Decoder interface, click File then select New Window

This will open up a new PPP Decoder window.  From the new window you
can connect to a PortMaster the same way you did in the Connecting to a
PortMaster section.


	Saving Results to a Log File

1. In the text field located in the top center portion of the PPP
Decoder interface, type the filename to log results to.

2. Click the Echo to File check box.


	Translating and Viewing an Existing PPP Debug Log File

To open an existing PPP debug log file and translate it into
human-readable form:

1. Click the Read File button.

2. Select the desired PPP debug log file.


	Selecting Protocols

To enable or disable a list of selected protocols, click the check box
of any protocols that you do not want to decode.  By default all
protocols supported by the PPP Decoder are selected.


	Selecting Ports for Translation

When using the PPP Decoder, you may want to focus on one port or a
block of ports that you wish to translate PPP debugging information.

To apply PPP debug translation to the output of a single port or
multiple ports of a PortMaster or a PPP debug log, select the desired
ports from the port selection box on the left side of the PPP Decoder.


		Limitations of the PPP Decoder

The PPP Decoder currently does not decode BAP or BACP.

The Windows installation does not always create the shortcut in the
Start menu.

If you attempt to connect to an already open PortMaster in a new window
with an invalid password, the existing connection will be broken.


	Copyright and Trademarks

Copyright 1998 Lucent Technologies. All rights reserved.

PortMaster, ComOS, and ChoiceNet are registered trademarks of Lucent
Technologies, Inc. RADIUS ABM, PMVision, PMconsole, and IRX are
trademarks of Lucent Technologies, Inc. ProVision is a service mark of
Lucent Technologies, Inc. All other marks are the property of their
respective owners.

        Notices

Lucent Technologies, Inc. makes no representations or warranties
with respect to the contents or use of this publication, and specifically
disclaims any express or implied warranties of merchantability or
fitness for any particular purpose. Further, Lucent Technologies,
Inc. reserves the right to revise this publication and to make changes
to its content, any time, without obligation to notify any person or
entity of such revisions or changes.

	Contacting Lucent Remote Access Technical Support

Please DO NOT contact Lucent Remote Access Technical Support about this
product.  If you have questions, bug reports or request for enhancements
send email to pppdecoder-feedback@livingston.com.  Please include the
version of this product (1.0p1), the release of JDK or JRE you are using,
the platform you are running on it (uname -a), and the version of the
ComOS on the PortMaster you are running on (3.8 or later).
