. . . InJoy PPPoE Client 1.0 . July 1, 2000 . . . . . . . . . ___ _ ____ ____ ____ _____ . |_ _|_ __ | | ___ _ _ | _ \| _ \| _ \ ___ | ____| . | || '_ \ _ | |/ _ \| | | | | |_) | |_) | |_) / _ \| _| . | || | | | |_| | (_) | |_| | | __/| __/| __/ (_) | |___ . |___|_| |_|\___/ \___/ \__, | |_| |_| |_| \___/|_____| . |___/ . ____ _ _ _ . / ___| (_) ___ _ __ | |_ . | | | | |/ _ \ '_ \| __| . | |___| | | __/ | | | |_ . \____|_|_|\___|_| |_|\__| . . . . . . . . . . . F/X Communications . DK-4300 Holbaek . Denmark . E-mail: support@fx.dk . http://www.fx.dk . . . . . . Copyright (c) 1999-2000, F/X Communications, All Rights Reserved. . Your usage of this product and its documentation are subject to . your acceptance of the license agreement included with this product. . . IBM and OS/2 are registered trademarks of International . Business Machines, Inc. All other trademarks, registered trade . marks, service marks and other registered marks are the property . of their respective owners. ========================================================================== C O N T E N T S ========================================================================== 1. Introduction 2. System Requirements 3. Before Installation 4. Rapid Start Install 5. Install Notes 6. Uninstalling 7. Command Line Parameters 8. Contacts 9. Registration 10. Legal Information ========================================================================== 1. I N T R O D U C T I O N ========================================================================== The InJoy PPPoE Client is designed to offer reliable PPP over Ethernet (PPPoE) connectivity. For the full description and the complete list of features, refer to the product homepage: http://www.fx.dk/pppoe This document explains how to install the product and for configuration and frequently asked questions, refer to: docs/pppoe.txt docs/pppoefag.txt The InJoy PPPoE Client does not incorporate security features. For PPPoE combined with Firewall, Internet sharing and VPN in one product, refer to the InJoy Firewall, available here: http://www.fx.dk/firewall ========================================================================== 2. S Y S T E M R E Q U I R E M E N T S ========================================================================== o IBM OS/2 3.0 o 486 66Mhz CPU o 8 MB total memory o 20 MB free disk space o TCP/IP v4.0 or newer o LAN-to-LAN connection to the Internet o At least one 10/100 Mb Network Interface Card ========================================================================== 3 B E F O R E I N S T A L L A T I O N ========================================================================== o Caution: You are about to install a product that adds a new device driver to your OS/2 system. The device driver layers with existing device drivers shipped with your LAN adapter(s) and incompatibility or bugs in these drivers CAN (potentially) cause hazard to your OS/2 system. If you are NOT experienced in the following areas: * TCP/IP networking and routing * OS/2 recovery options (i.e. the Maintenance Desktop) THEN please backup critical data before installing this software and/or consult a local expert or seek help on the Internet. F/X Communications will in no way be held responsible for malfunctions or data loss inflected by our software. o MPTS Installation of FXWRAP.SYS makes it impossible for MPTS.EXE to correctly process PROTOCOL.INI. If you need to use MPTS to change your network and protocol configuration, then uninstall FXWRAP, make MPTS changes, and then reinstall FXWRAP. Simply use INSTALL.CMD to install and uninstall FXWRAP. Takes only a few seconds. ========================================================================== 4. R A P I D S T A R T I N S T A L L ========================================================================== Prerequisites: 1: Prepare an OS/2 PC with at least one LAN adapter. 2: Ensure the TCP/IP protocol is installed for the LAN adapter. 3: Ensure the LAN interface is enabled in the TCP/IP config. 4: Assign a dummy IP address and netmask to the LAN interface. Anything but 0.0.0.0 is acceptable. Software Installation: 1: Unzip the zipped archive into a product directory of choice. 2: Run folder.cmd to create/update the desktop folder. 3: Run install.cmd to install the FXWRAP.SYS device driver. (See 'Installing the device driver' section below). 4: Reboot OS/2 to load the device driver. Getting Connected: 1: Run PPPoE.EXE. 2: Click the Right Mouse Button (RMB) to set up an ISP profile. 3: Click RMB and select "Connect" from the pop up menu. 4: Register (see registration section). ========================================================================== 5. I N S T A L L N O T E S ========================================================================== Run INSTALL.CMD from the product directory to install the mandatory device driver. INSTALL.CMD will show a list of installed LAN adapters and you should choose the LAN adapter that is connected to the external network (i.e. Internet Link / ISP). INSTALL.CMD backs up CONFIG.SYS and PROTOCOL.INI before updating the files with the required changes. The FXWRAP.SYS file will be automatically copied from the product directory to x:\IBMCOM\MACS, where x: is the drive where MPTN is installed. o Reboot System. To load the newly installed device driver, please reboot your system. IMPORTANT: A new device driver can potentially cause malfunction and failure to boot. This can be caused by conflict with hardware or other device drivers and although unlikely, this may happen to you. If you experience such troubles, you need to use OS/2 Warp's Maintenance Desktop to recover your system. When you boot OS/2, you will see a white box in the upper left hand corner followed by "OS/2." Hit ALT-F1, and a menu pops up with several options such as immediately dropping to a command line. Dropping to a command line allows you to manually uninstall (see troubleshooting section). Having done that you be able to reboot normally and contact F/X Communications for further help. =========================================================================== 6. U N I N S T A L L I N G =========================================================================== Uninstalling is done in three simple steps: 1) Uninstall Device Driver 2) Uninstall PPPoE software 3) Reboot o Uninstall FXWRAP.SYS Uninstalling FXWRAP.SYS is done using the UNINSTAL.CMD and when running it, you will be prompted for an action: to install FXWRAP to uninstall previously installed FXWRAP Press 'U' followed by to start uninstalling the device driver. The files CONFIG.SYS and PROTOCOL.INI will be updated. o Uninstall PPPoE Software In order to uninstall, simply delete files from from the product directory. o Reboot System =========================================================================== 7. C O M M A N D L I N E P A R A M E T E R S =========================================================================== This product is intended to be run WITHOUT command line parameters, but the following parameters are available. o Command Line Parameters -? or -h Show help message (text version only) -t Enable packet tracing (text version only) -p Priority from 1 to 100 (100 is max) (text version only) -l[] Log messages to file (PM version only) -d Extra debug info to output screen (both versions) ў Option -t (trace) Enables packet tracing and should be used for diagnostic purposes only. Enabling this option in a production environment will significantly reduce product performance. ў Option -p (priority) The priority parameter specifies the priority that OS/2 will assign to the InJoy software. -- Any value larger than 75 percent, will register the gateway as a time critical process. Being time critical is a logic choice for a program handling the CPU demanding COM port. -- However, raising the value much above 90 percent may cause system hangs as the OS/2 scheduler will not allow other processes to "wake up" when they are really needed. ========================================================================== 8. C O N T A C T S ========================================================================== The below resources are pointers to where you might find more help in using InJoy products. Support: Our FREE mail list has more than 400 people connected and they will gladly take a stab at almost any problem. See below for help on subscribing to the list. Mailing lists: Subscribe at http://www.fx.dk/contadd.html Support: support@fx.dk Web: http://www.fx.dk/pppoe The most recent news about this product is posted at the F/X Communications site. ========================================================================== 9. R E G I S T R A T I O N ========================================================================== After successful evaluation of this product, you can register by obtaining a registration key from one of the resellers. Reseller information and pricing can be found in: 1) REGISTER.TXT from the distribution archive Most current pricing information and online registration services are available at the following address: 2) http://www.fx.dk/pppoe/register.html Once registered, you need to fill your registration code into the PPPOE.CF file - for example: [license] name=John Phillips code=2cd43a5e25639843 For more information contact sales@fx.dk ========================================================================== 10. L E G A L I N F O ========================================================================== This software requires registration after a 30 day trial period. For registration refer to the included file: REGISTER.TXT. By installing and using this program you accept it as is and agree to the limits of liability and other provisions outlined in LICENSE.TXT. You should read that file before proceeding with installation or using the program. Copyrights and trademarks remain the property of their owners. лллллллллллллллллллллллллллллллллллллллллллллллллллллллллллллллллллллллллл Copyright (c) 1999-2000 F/X Communications. All rights reserved.