-----------------------------------------------------------
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

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 <XMP> 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 -
-----------------------------------------------------------