
             IBM(R) Point of Sale Subsystem for Linux(R) 
                          Version 1.1.1
                       Installation Readme


  Instructions for installing the IBM Point of Sale Subsystem (POSS) 
  for Linux can also be found in the publication, "IBM Point of Sale
  Subsystem: Installation, Keyboards, and Code Pages", which is 
  available on the IBM Web site.



  IBM POINT OF SALE SUBSYSTEM FOR LINUX PACKAGES
  ==============================================
  
  Once you have downloaded and unzip'd the IBM POSS for Linux 
  package, you will have four files:

        * This file (readme.1st)  
        * ibmposs-linux-patch-ps2filter-1.1.tgz
        * ibmposs-linux-1.1.1-<build>.i386.rpm
        * ibmposs-linux-1.1.1-<build>.i386.tgz
        
  where <build> is the two-digit build number of the package.
  
  The IBM POSS for Linux V1.1.1 has been tested with Red Hat(R) Linux 
  V7.1 (kernel 2.4.2-2) running on IBM 4694-1xx, 4694-2xx, and 
  4694-3xx cash registers.
        
  
  
  Installing ANPOS Keyboard Support
  ---------------------------------
  
  If you intend to use an ANPOS keyboard as the system keyboard
  (i.e. attched via the PS/2 port), you must apply a keyboard
  kernel patch *before* installing the subsystem.  
  
  a) Decide which tar file you will use for the ANPOS keyboard
     patch:
  
     If you intend to install POSS for Linux using RPM, you will
     use the following tar file:
  
         ibmposs-linux-patch-ps2filter-1.1.tgz
         
     If you are not planning on using RPM to install POSS for 
     Linux, you will use this tar file:
  
         ibmposs-linux-1.1.1-<build>.i386.tgz

  b) Decompress/extract files from the tar file:
  
         tar zxvf ibmposs-linux-patch-ps2filter-1.1.tgz
         
                          or
  
         tar zxvf ibmposs-linux-1.1.1-<build>.i386.tgz
  
  c) Follow the instructions in ps2_patch/POS_patch_instructions.txt
     to install the keyboard patch.           
  
            
  INSTALLING THE POINT OF SALE SUBSYSTEM FOR LINUX
  ================================================
  
  Prerequisites
  -------------
  
  Download and install library updates from RedHat.  These libraries fix 
  a problem that intermittantly causes the application or driver subsystem 
  to crash.
                     
  For RedHat 7.1, the following library updates must be installed:

  ftp://updates.redhat.com/7.1/en/os/i386/glibc-common-2.2.4-29.i386.rpm
  ftp://updates.redhat.com/7.1/en/os/i386/glibc-2.2.4-29.i386.rpm 


  Installing POSS for Linux Using RPM
  -----------------------------------
     
  a) You will use the POSS for Linux RPM file:
   
         ibmposs-linux-1.1.1-<build>.i386.rpm
        
  b) To install/upgrade:
  
     i. Type the following:
 
            rpm -U ibmposs-linux-1.1.1-<build>.i386.rpm --prefix <path>
         
        The --prefix <path> is optional. By default, the package 
        installs binary utilities, libraries, font files, and 
        device-specific hardware files in the /usr directory.  
        Specify --prefix <path> to install these files somewhere 
        other than /usr where <path> indicates an alternate location 
        for package files.
     
  c) Reboot the system.
 


  Installing POSS for Linux Using the Installation Shell Script
  -------------------------------------------------------------

  a) You will use the POSS for Linux tar file:
 
         ibmposs-linux-1.1.1-<build>.i386.tgz

  b) Decompress/extract the POSS for Linux tar file:
 
         tar zxvf ibmposs-linux-1.1.1-<build>.i386.tgz

  c) Change directory into the top-level directory created:
  
         cd ibmposs-linux-1.1.1-<build>

  d) Run the following command:
 
         ./install_pos.sh --install 
        
     to install the POS subsystem files.  
    
  e) Reboot the system.




  UNINSTALLING THE POINT OF SALE SUBSYSTEM FOR LINUX
  ==================================================
  
 
  Removing ANPOS Keyboard Support
  -------------------------------
  Follow the instructions in ps2_patch/POS_patch_instructions.txt to 
  remove/reverse the ANPOS keyboard patch.
     

            
  Uninstalling POSS for Linux Using RPM
  -------------------------------------
     
  To uninstall, type the following:
     
         rpm -e ibmposs-linux
            
   

  Uninstalling POSS for Linux Using the Installation Shell Script
  ---------------------------------------------------------------

  To uninstall POSS for Linux, if you have not touched the untarred 
  sources, change directory into the top-level directory of these 
  sources -- ibmposs-linux-<version>;  if you no longer have these 
  sources or have modified them, change directory to the location of 
  install_pos.sh.  Run the following command:
        
         ./install_pos.sh --uninstall




=====================================================================
*  IBM is a registered trademark of the International Business 
   Machines Corporation.
*  Linux is a registered trademark of Linus Torvalds.
*  Red Hat is a registered trademark of Red Hat, Incorporated.
