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 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.0P2), 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).