InJoy Dialer for Red Hat Linux.
Platform specific configuration and installation README.



==========================================================================
 	C O N T E N T S
==========================================================================



1.0   Prerequisites
2.0   Installation issues
3.0   System Implications
4.0   User Experience Issues
5.0   Manual Installation
6.0   Manual Deinstallation



==============================================================================
 1.	P R E R E Q U I S I T E S
==============================================================================



You are about to install a product that adds a new device driver to your 
Linux system.

If you are NOT experienced in the following areas:

     * TCP/IP networking and routing
     * Linux recovery options (i.e. recovery disk or single user mode)

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.


InJoy will run on any of the below Linux platforms:

   * Red Hat Linux 9.0
   * Red Hat Linux 8.0
   * Red Hat Linux 7.3
   * Red Hat Linux 7.2
   
May work on other disrtibutions adhering to the Linux standards base:

   * Red Hat Linux 7.1
   * Red Hat Linux 7.0
   * Red Hat Linux 6.2
   * Red Hat Linux 6.1

Additional Requirements:

   * Linux 2.4 kernel
   * Glibc 2.1
   * GTK 1.2 and Gnome (for GUI applications)



==============================================================================
 2.	I N S T A L L A T I O N   I S S U E S
==============================================================================



2.1 General issues
------------------

The installation script will install the required libraries in /usr/lib and
install boot scripts in /etc.  For this reason the installation script must
be run as root.

InJoy must be run as root, or have root privileges for creating routes, 
and accessing the /dev entries.

If your Red Hat distribution is not using one of the supported kernels
(indicated by the install script), follow the included instructions to
build the InJoy driver manually. See source/build.txt for help.


2.2 Upgrade issues
------------------

When upgrading to a new version, it is recommended you run install.sh
after un-tar'ing. If you don't wish to run install.sh, then be sure
to manually copy the new libraries to usr/lib.

When creating the menu items on the Gnome Menu, old items are not destroyed.
If you are upgrading from a previous install, you should either run the
uninstall script or manually remove the old menu items to ensure there are
no obsolete items.



==============================================================================
 3.	S Y S T E M   I M P L I C A T I O N S
==============================================================================



InJoy installs a device driver to create dynamic PPP devices.

Boot scripts in /etc are modified to reflect these changes.



==============================================================================
 4.	U S E R   E X P E R I E N C E   I S S U E S
==============================================================================



DW_BORDER_WIDTH and DW_BORDER_HEIGHT environment variables are used to
control the perceived size of the windows.  The default border widths
used are for the Red Hat 6.2 - 7.2 window managers default theme.



==============================================================================
 5.	M A N U A L   I N S T A L L A T I O N
==============================================================================



1) All of the libraries in the lib/ subdirectory need to be copied to 
   /usr/lib or somewhere else that is listed in the /etc/ld.so.conf. Then 
   /sbin/ldconfig needs to be run to recognise the newly installed libraries.

2) Then the boot scripts must be installed.  sys/fx goes into 
   /etc/rc.d/init.d, sys/S10fx and sys/S90fx must go into the runlevel which 
   you want to boot into. These scripts are named so that they load the fx.o 
   driver before the network initializes.  
   
Then all that is required is a reboot.



==============================================================================
 6.	M A N U A L   D E I N S T A L L A T I O N
==============================================================================



All that is required for deinstallation is deleting all of the files that
were installed during the installation phase and restore all instances of
eth# from their current fx#. 

Here is a list of files to delete:

   /etc/rc.d/rc?.d/S10fx
   /etc/rc.d/rc?.d/S90gateway
   /etc/rc.d/init.d/fx
   /etc/fx_forward
   /usr/share/gnome/apps/Internet/InJoy Dialer/*
   /usr/lib/libfirewall.so*
   /usr/lib/libfxip.so*
   /usr/lib/libfxmasq.so*
   /usr/lib/libfxutil.so*
   /usr/lib/libipfrag.so*
   /usr/lib/libfxipsec.so*
   /usr/lib/libdhcpd.so*
   /usr/lib/libfxcomm.so*
   /usr/lib/libwndansi.so*
   /usr/lib/libgenerate.so*
   /usr/lib/libdw.so*
   /usr/lib/libdwcompat.so*
   /usr/share/pixmaps/in-joy.png