----------------------------------------------------------- IBM Softcopy Reader V3.7 for RedHat Linux Installation Instructions & Version Notes (README) Service Level S061807 Driver Level SCRV3_061807 Build Number 1 Last Updated: 06/18/2007 (C) Copyright IBM Corp. 1989 - 2007. All rights reserved. ----------------------------------------------------------- This README file (available in English only) contains the information you need to install and configure IBM Softcopy Reader, which is made up of two programs: (1)Book Reader and (2)Shelf Organizer. The information is divided into the following categories: - Prerequisites - Before You Install - Installation of IBM Softcopy Reader - Running the Programs / Viewing the Documentation - Uninstalling - Version Notes - Limitations - Special Note to HTTP Server Administrators - Getting Help with BookManager Products - Trademarks ----------------------------------------------------------- PREREQUISITES ----------------------------------------------------------- Software Prerequisites ---------------------- - RedHat Enterprise Linux or Fedora Core, operating system with libstdc++.so.6 - Either a Sun or IBM Java Runtime 1.4.2 (or higher) - Optionally, a PDF reader (e.g. XPDF), configured to IBM Softcopy Reader, is required if you plan to view PDF files Hardware Prerequisites ---------------------- - Any personal computer capable of running RedHat Linux 9.0 or greater, with Intel Pentium II (or higher), or compatible processor, with a minimum of 256MB RAM - Display device supported by RedHat Linux (VGA or better resolution) - Any pointing device supported by RedHat Linux. - Hard-disk drive storage of 150MB for final installed image (Note: A total of 200MB free disk space is required to run the install program.) - One or more CD-ROM drives and the equipment needed to attach them to your workstation. - Optionally - a RedHat Linux supported printer. ----------------------------------------------------------- BEFORE YOU INSTALL ----------------------------------------------------------- Before you begin your installation: Uninstall the previous version of IBM Softcopy Reader if a version prior to 2.3.1 or greater than version 3.7 service level S061807 is already installed. ----------------------------------------------------------- INSTALLATION OF IBM SOFTCOPY READER ----------------------------------------------------------- These instructions assume either RedHat Enterprise Linux or Fedora Core Linux, hereafter referred to as Linux. It must have libstdc++.so.6. Also, a Sun or IBM JRE of 1.4.2 or greater is a pre-requisite for the Linux version. Install the JRE per manufacturer instructions, and ensure the java executable is executable from the path. As of this writing, Java downloads are available at http://java.sun.com/downloads/index.html. Note: IBM Softcopy Reader for Linux is fully contained within one directory. Download and Install From the IBM BookManager Web Site: ----------------------------------------------------------- 1. Start the Linux system. 2. Open your Web browser and go to IBM BookManager Web site: http://www.ibm.com/software/applications/office/bkmgr/softcopyread.html 3. Click on "Softcopy Reader for Linux" link. 4. Click on "Softcopy Reader for Linux V3.7" link. A dialog will prompt for a save location. 5. Select a suitable place download the .tgz file. The Softcopy Reader file will be downloaded to this location. 6. Open a terminal console window. Run the following steps in the terminal console: 7. "mkdir installdirectory" (replace installdirectory with the directory where the SCR program is to reside.) 8. "cd installdirectory" 9. "tar -zxvpf place_downloaded_to/ilrjaval.tgz" (replace place_downloaded_to with the directory where the .tgz file was downloaded). Scripts to run the Shelf Organizer and Book Reader are in "installdirectory/sys". These scripts are hlcs.sh and hlcb.sh. Add this directory to the user path as desired. There is limited support for file association under Linux. To do file association, first locate the hlcb.sh.desktop and hlcs.sh.desktop files in the install directory. Next, change the path specified under the lines starting with "Exec=" and "Icon=" to the path specified when untarring the Softcopy Reader package. Note: if the Softcopy Reader package is untarred to "/opt/scr", this step is not necessary. Next, copy both files to one of the following directories depending on who will be using Softcopy Reader: Directory User --------- ------------- /usr/share/applnk-redhat All KDE users /usr/share/gnome/apps All Gnome users /etc/X11/applnk All users ~/.kde/share/applnk-redhat Current user's when KDE is running ~/.gnome/apps Current user when Gnome is running Optionally you can copy the modified hlcb.sh.desktop and hlcs.sh.desktop files to your desktop, for example: For Fedura: copy the two files to ~/Desktop For Red Hat: copy the two files to ~/.gnome-desktop Note: Before attempting to run SCR check that you have a setting for the environment variable LD_LIBRARY_PATH. This can be done via the command "set" which will show all your Linux session parameters. Alternatively you can type "echo $LD_LIBRARY_PATH" to see just that particular parameter. If LD_LIBRARY_PATH is not set, set it as follows: export LD_LIBRARY_PATH=/opt/scr/sys - ie set it to the sys directory where you installed SCR. 10.When installation is complete, you can start using Book Reader and Shelf Organizer. It is not necessary to reboot your system. ----------------------------------------------------------- RUNNING THE PROGRAMS / VIEWING THE DOCUMENTATION ----------------------------------------------------------- 1. To run "Book Reader" choose: Start->Run Program and type "hlcb.sh" 2. To run "Shelf Organizer" choose: Start->Run Program and type "hlcs.sh" 3. To open the "User's Guide" (in the Book Reader) choose: Start->Run Program and type "hlcb.sh", in the Book Reader, click Help->User's Guide. Please note that you can also open books in the Book Reader from within the Shelf Organizer. ----------------------------------------------------------- UNINSTALLING ----------------------------------------------------------- To uninstall, delete the installation directory, and remove the installation directory from the user's PATH. ----------------------------------------------------------- VERSION NOTES ----------------------------------------------------------- These are the enhancements and fixes for Version 3.7 Service Level S061807 of the IBM Softcopy Reader, organized by driver levels: SCRV3_061807 - Fix displaying a book without a Table of Contents. - Fix book display problem with multiple revision characters. - Fix copyright display problem. - Additional miscellaneous items were fixed. SCRV3_081506 - Fix to add scroll bars for low resolution images in books - Correct Help/About link URL - Fix null pointer exception when running Shelf Organizer -s option - Add support for quick searching PDFs on indexed extended (XKS) shelves SCRV3_113005 - Include ability to link to books *outside* current shelf (**restrictions apply - see note below) - Font controls added to Shelf Organizer (as per Book Reader) - Enhancement to support the setup of .ini files in folders other than the installed folder. - Corrected problem with "Quick Search" function - Corrected problem with XKS creation - Added floating divider between shelves and books - Cannot open PDF files using Open publication option of File menu - Fix for saving size of columns in book portion - Fix for sort of books based on one column - Reverse/video correction - Correct greater than and equal & less than and equal symbols - Include updated IBM Softcopy Reader User's Guide (hlcrug18) ** The interbook link function will only work with book/PDF file names which are entirely UPPERCASE. ** Do NOT use names with 'lower case' OR 'mixed case'. SCRV3_081505 - Revision bar corrections - Correct arrow representation in graphic displays - Corrections to