----------------------------------------------------------- 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 text display (e.g. &amp;) - Various display improvements/corrections - Enhanced FONT control by introducing the selection of a font style & separate TOC font size. - Include new "Definition lists->compact" option under "View" - Correct search 'hang' problems - Enhance search keyboard functions - Include updated IBM Softcopy Reader User's Guide (hlcrug17) SCRV3_063005 - Balance <DL> and <DT> tags to improve list display - Correct 'Table of contents' font size problem - Various display flow corrections SCRV3_113004 - Install script no longer adds path to the environment variable. - Book Reader renders revision and box characters within tables plus other table rendering improvements. - Enhanced rendering of syntax diagrams - Help link URL in Help->About dialog updated to point to correct URL. - File->Open dialog fixed to use most recently opened directory. - Search results have been fixed to remove false positives on shelf searches. SCRV3_092204 - Shelf searching is now supported for extended shelves, both indexed and non indexed. - Indexed books now use proper icon. - Shelf Organizer uses CTITLE record for book files when necessary. - Ordered list numbering has been fixed. - Install adds SCR to path when installed for all users. - Formatting for CZ FLOW PC tag has been fixed in Book Reader. - Publication uniqueness within an XKS has been fixed to test for document ID and mime type. Previously it tested for document id alone. - Miscellaneous other defects and enhancements. SCRV3_080404 - Adobe PDF Users Guide included. SCRV3_071904 - Installation and packaging fixes and changes. - Various bug fixes. SCRV3_051304 - Configuration files on IBM Softcopy Reader for Linux are stored in ~/.IBM/SCR. - Limited support for indexes in extended shelves has been added, allowing extended shelves to be created with indexes. Searching an extended shelf is unsupported, however. - Various bug fixes and enhancements, including Linux improvements. - The Linux version requires the Sun Java VM 1.4.1_01 or greater, and is not included with this package. SCRV3_021104 - Mixing of .PDF and .BOO files in an extended shelf is now supported. - Enhanced table processing engine. - Added support for parameter lists. - Enhanced support for nested lists. - Miscellaneous improvements. SCRV3_111103 - Reduced package size. - Improved organization of User's Guide. - Added driver level to help about. - Allow bookshelf to be padded with blanks. - Various defects fixed. - Some users may experience program hangs when using the edit/copy feature Softcopy Reader on certain platforms. SCRV3_100203, Service Level S031031 - Shipping full JRE which prevents the print dialog from causing the Softcopy Reader from hanging. SCRV3_092503: - Fix defect preventing Windows users from opening pdf publications. SCRV3_091503b: - Computers with an ATI Mobility graphics chipset need to update to the latest ATI Mobility graphics driver. Obsolete drivers may cause the system to hang when running either the Softcopy Reader or Organizer. SCRV3_091503: - Formatting of definition lists has been improved. - Commandline debugging flag -debug - XKS debugging log file now only activated with debugging turned on. - Import PDF Publications dialog enhancements. - Various defects fixed. SCRV3_081503: - Syntax diagram formatting improved. - File dialogs now allow a full path directory instead of just a filename. - Traditional bookshelves and extended shelves can no longer cut/copy/paste between each other. - A title is now required when creating a traditional bookshelf. - Cross book linking, broken in an earlier driver level, is now fixed. - Windows NT is no longer supported. - Various defects fixed. SCRV3_071703: - PDF's can now be imported into extended shelves. - Various defects fixed. SCRV3_070703: - Various defects fixed. SCRV3_070303: - Enhanced extended shelf error messages - Various defects fixed. SCRV3_070103: - Various defects fixed. SCRV3_062603: - Extended Shelf (XKS) Support has been added, specifically the ability to list, view, create and modify Extended Shelves. Note that, currently, Extended Shelves may only contain Adobe Acrobat PDF files - The Shelf Organizer is now launched via the hlcs.bat file - Various defects fixed. ----------------------------------------------------------- LIMITATIONS ----------------------------------------------------------- - The function "View Description" for PDF files is not currently supported. For updates on this tool, please periodically visit the IBM BookManager web pages for Softcopy Reader at: http://www.ibm.com/software/applications/office/bkmgr/softcopyread.html ------------------------------------------------------------ SPECIAL NOTE TO HTTP SERVER ADMINISTRATORS ------------------------------------------------------------ If you transfer softcopy files from an IBM Collection Kit to an HTTP Server, you can provide the same access to these files as when the softcopy collection index (SCINDEX.HTM) is loaded within the SCFRAME.HTM frameset on a collection disc. However, to launch BookManager books and shelves from an HTTP Server with Softcopy Reader via the *Netscape* browser, the HTTP server administrator must modify the HTTP server configuration. Specifically, a MIME content type/subtype of application/x-boo must be assigned to the .boo file extension, application/x-bks must be assigned to the .bks file extension, and application/x-xks must be assigned to the .xks file extension. These assignments correspond to the content type values specified by the Softcopy Reader installation program in the .boo, .xks and .bks helper application information at the client. The method to make these assignments depends on the HTTP server. Here are some examples: - For the Apache HTTP server, create AddType directives in the httpd.conf file. - For the Microsoft IIS HTTP server, create MimeMap registry key entries. - For the Lotus Go HTTP server, use the Configuration and Administration function to add new entries to the Mime Types form. This HTTP Server configuration change is only required if serving Netscape clients as described above. ----------------------------------------------------------- GETTING HELP WITH BOOKMANAGER PRODUCTS ----------------------------------------------------------- This section contains information on how to obtain support and the latest corrective service for BookManager products. We recommend you obtain and apply any available corrective service from the ibm.com website at installation time. Both electronic and telephone support are available. ELECTRONIC SUPPORT ------------------ Electronic support is available via Internet, Web, and FTP. This support covers: - Hints & Tips - Most Frequently Asked Questions & Answers - Fixes (for some BookManager products) Internet -------- Email: bookmgr@us.ibm.com Web: BookManager Home Page - see Service, Hints and Tips icon: http://www.ibm.com/software/applications/office/bkmgr/ IBM Personal Systems Service & Support Home Page: http://ps.software.ibm.com/ FTP: FTP to ps.boulder.ibm.com logon anonymous use your email as your password change directory to /ps/products/bookmanager ----------------------------------------------------------- TRADEMARKS ----------------------------------------------------------- The following are trademarks of the IBM Corporation: - IBM - BookManager The following are trademarks of the Adobe Systems Incorporated: - Acrobat - Acrobat Reader The following are trademarks of the Microsoft Corporation: - Windows - Windows NT The following is a registered trademark of Red Hat, Inc: - Red Hat The following is a trademark of Linus Torvalds: - Linux The following are trademarks of Intel Corporation: - Intel - Pentium All other product names are trademarks of their respective owners. ----------------------------------------------------------- - End of readme.txt file - -----------------------------------------------------------