README for 1 Network and USB Scan Drivers

Table of Contents 
-----------------
    Recommended operating system levels

    Known Issues

    Documentation


Recommended operating system levels
-----------------------------------

   Make sure you are running one of the Linux distributions listed 
   in the supported-platforms.txt file.  
   
   Note:
         Local scanning may work on some OSes. 
         
         Some package managers may display warnings during installation. 
         Just ignore and proceed with the installation.
         	 

Known Issues
------------

   1. The driver may not scan successfully if your system has an enabled 
      firewall.  This may likely be the cause if you get one of the following 
      situations while selecting your scan profile on the printer. 
 
        1.  Nothing happens on the host computer
        2.  Printer automatically cancels the scan job
        3.  Printer gives you a connection failure message

      You can either disable your firewall or open the required 
      scanning ports; tcp:9751-9760.  For most Linux distributions,
      you can open specific ports with the iptables command.

      Example:

      # iptables -I INPUT -p tcp --dport 9751:9760 -j ACCEPT -i eth0

      To determine how to disable or enable your firewall, see 
      the documentation that came with your operating system.

      For more information, see the users guide.

   2. Non-English based characters do not show up or display correctly.
      This is normally a locale or encoding issue. If you select
      the wrong encoding for your system/application(ex. UTF-8 encoding), 
      either some characters will not show up or display correctly. 
      
   3. Receiving error "Assertion 'c->xlib.lock' failed when launching 
      JAVA GUI in openSUSE 10.3. The error is caused by a problem in the 
      libxcb package. The easy way is just to install the 10.3 online updates, 
      which turn this into a warning. You should install them anyway to get 
      all the security fixes. 
      
      As a workaround you can run the following command from the command 
      line and then re-try your operation (from that same command-line) 
      
      #export LIBXCB_ALLOW_SLOPPY_LOCK=true


Documentation
-------------

   A complete user guide is available in HTML format for all 
   supported languages.

   English:
      /usr/Prinkscan/docs/ug/en/index.html 

   All other languages:
      /usr/Prinkscan/docs/ug/<LANG>/index.html 


