 
Getting Started

Online Documentation Library (ODL) for Tru64 UNIX


Overview

This document provides introductory information about the Online 
Documentation Library (ODL) CD-ROM Collections.  It provides general and 
platform-specific installation and user information for the ODL.

The Tru64 UNIX ODL CD-ROM set consists of:

*	An ISO 9660 Level 2 (ODL-ISO) compliant CD-ROM that can be run from 
Microsoft Windows and Tru64 UNIX platforms.

This disc contains documentation in HTML and PDF format, and uses HTML 
pages as the navigation mechanism to browse to and display 
documents.  A search engine is also included for full text searching.

*	A Bookreader CD-ROM set (ODL-BKB), which is an archive set containing 
documentation in Bookreader format only.  This set includes a disc for use 
on native platforms (ODL-BKB-UNIX), and a disc for Windows platforms 
(ODL-BKB-PC).  

These discs contain static documentation, and will not be updated.  As a 
result, documentation may not be the current revision.  Setup and user 
information for the ODL-BKB is included later in this document and in user 
documentation residing on each ODL-BKB CD-ROM.


System Requirements

ODL-ISO CD-ROM

*	Tru64 UNIX Version 4 or later
*	Windows 98 SE, Windows NT, Windows 2000, or Windows XP
*	Web Browser
*	Adobe Acrobat Reader
*	Java 2 Standard Edition (J2SE) 1.3 or later (for search)

ODL-BKB-UNIX

*	Tru64 UNIX Version 3.2C or later
*	DECwindows Motif Version 1.2-3 or later

ODL-BKB-PC

*	Windows 98 SE, Windows NT, Windows 2000, or Windows XP
*	Web Browser
*	Adobe Acrobat Reader


Mounting the ODL-ISO CD-ROM

Windows Platforms:

*	Insert the ODL-ISO disc into your CD-ROM drive.

Tru64 UNIX Platforms:

*	If you are using Tru64 UNIX Version 5.0 or higher, you can mount the Tru64 
ODL-ISO CD-ROM using the following command.  Where /mnt_point is the 
mount point directory for the CD-ROM.

# mount -t cdfs -o noversion /dev/disk/cdrom0c /mnt_point

*	For earlier versions of Tru64 UNIX, you can mount the CD-ROM by 
specifying the -t cdfs and -o rrip options to the mount command, as 
follows:

# mount -t cdfs -o noversion /dev/rz*c /mnt_point


Browsing the ODL-ISO 

To begin browsing the ODL-ISO CD-ROM, open index.htm from the root of the 
CD-ROM in your web browser.

For a listing of products available on this CD-ROM, open PRODLIST.HTM from the 
/ODLDOC folder on the CD-ROM or click on the link from CONTENTS.HTM.  This 
page also includes a listing of static documentation available on the Tru64 UNIX 
Bookreader CD-ROM.


Searching ODL-ISO

-Searching on Windows platforms:

The main ODL page should display and the ASTAware SearchDisc search engine 
should launch when the disc is inserted into the drive.  If it does not, run the 
SDWinjava.bat file from the root of the CD-ROM.  The ASTAware SearchDisc icon 
should appear in your taskbar when the search engine is running.

You can enter a search query in the search box from any ODL navigation page 
on the CD-ROM.

**IMPORTANT**  You must shut down the search engine by clicking the 
SearchDisc icon in your taskbar, before you eject the CD-ROM from your drive.

-Searching on Tru64 UNIX platforms:

Change directory to the CD-ROM mount point, and execute the following shell 
script:

searchdisc_unix.sh

This will launch the SearchDisc server and will set up the communication ports. 
Launch your web browser and open index.htm from your CD-ROM mount point.

You can enter a search query in the search box from any ODL navigation page 
on the CD-ROM.

***IMPORTANT**  You must shut down the search engine by clicking in the 
SearchDisc popup window, before you eject the CD-ROM from your drive.


Configuring ODL-ISO Search for a Hard Drive (Windows Platforms Only)

***Note:  See known issue below if your language settings are not set to US English.

If you choose to copy the ODL-ISO CD-ROM content to a hard drive, you will need to reconfigure the search engine to retrieve search results from the new location. 

* Copy the entire CD-ROM to an area on a hard drive.  For example, C:\ODL

* Be sure that the search engine is shut down before proceeding.  To shut the search engine down, click on the SearchDisc icon in your taskbar, and click yes when asked if you would like to shut down the search engine.

* Run MediaSwitcher.exe from the area you copied the CD-ROM to.  This will reconfigure the search engine to search and retrieve search results from the new ODL-ISO location.  This executable is located at the root of the CD-ROM.  

* Enter the path where you copied your ODL CD-ROM to in the "Select the SearchDisc Installation Folder" box.  For example, if you copied the CD-ROM to your C: drive in a folder named ODL, enter C:\ODL here.  Click Next.

* Enter the path again where you copied your ODL CD-ROM to in the "Select the Search Documents Folder" box.  Click Install.

* Restart the search engine by starting autolaunch.exe from the new location.  


***Known Issue***  The installer used for the Media Switch Utility, described above, is not currently supported for all language settings.   If your language is not supported, you will receive an error stating, “Installer User Interface Mode Not Supported,” when attempting to run MediaSwitcher.exe from the root of the ODL collection on your hard drive.  

You can use either of the following workarounds to address this:

* Create a network drive of the directory where the ODL CD-ROM was copied to, making it appear as a virtual drive.  From there, open autolaunch.exe.

* Temporarily change your regional settings on your computer to US English, run the MediaSwitcher.exe, then change the settings back to your original settings.  


Getting Started with the Bookreader ODL (ODL-BKB)
 
The ODL-BKB set consists of a single CD-ROM disc that runs on Tru64 UNIX 
platforms (ODL-BKB-UNIX), and a single CD-ROM disc that runs on Microsoft 
Windows platforms (ODL-BKB-PC).

These ODL discs use the Bookshelf Navigation Utility (BNU) as the primary 
interface to online bookshelves.  Bookshelves contain links to documentation in 
Bookreader format.  The BNU invokes the Bookreader viewer to display ODL 
documentation.  
 
Installation instructions for both platforms of the ODL-BKB follow.  For BNU system 
requirements and more detailed installation instructions, refer to the Online 
Documentation Library CD-ROM User's Guide, which is available online in the 
Getting Started bookshelf, and is available in PostScript and text formats in the 
[readme] directory on each ODL-BKB disc.

Note:  Previous releases of ODL on native platforms required and/or provided 
other viewers (Netscape, Hyperhelp) for other file types.  These are not required 
for the ODL-BKB discs.  References made to these viewers in the Online 
Documentation Library CD-ROM User’s Guide do not apply to the ODL-BKB CD-
ROM.  Documentation is in Bookreader format only.
 

Installing and Using the ODL-BKB-UNIX (Tru64 UNIX Platforms)

Procedures for installing the ODL-BKB-UNIX, including example commands, are 
summarized below.  

*	Create the mount point directory

# mkdir -p /usr/share/doclib/ODL/U05BKB_1

*	Insert the ODL CD-ROM disc into the CD-ROM reader, making sure that 
you use the disc that includes for Tru64 UNIX platforms on the label.

*	Mount the ODL CD-ROM on the mount point directory

For Tru64 UNIX V5.0 and higher:

# mount -r /dev/disk/cdrom0c /usr/share/doclib/ODL/U05BKB_1

For versions of Tru64 UNIX lower than V5.0:

# mount -r /dev/rz4c /usr/share/doclib/ODL/U05BKB_1

*	Change directory to the setup directory

# cd /usr/share/doclib/ODL/U05BKB_1/setup

*	Run the setup script

# ./setup.scp

*	Exit the Common Desktop Environment (CDE) session and log back in 
using a non-root user name.

*	Run BNU

% bnu


Installing and Using the ODL-BKB-PC (Windows Platforms)

The procedures for installing the ODL-BKB-PC are as follows:

*	Insert the ODL-BKB-PC CD-ROM for MS-Windows Platforms into the CD-
ROM reader. 

*	View the "Readme.txt" file in the top level directory for important 
information before proceeding with the installation.

*	From the "Start" menu, select "Run...", and enter E:\Setup.exe, where E is 
the drive letter assigned to the ODL-BKB-PC CD-ROM.

*	Respond to the setup program dialogs as desired and/or take the default 
responses by pressing <enter>.

*	After completion of the setup program, invoke the BNU from 
"Start/Programs/Compaq ODL/BNU". 

*	If you wish to copy the contents of the ODL-BKB-PC CD-ROM to a hard 
disk and have sufficient available space, invoke the Copy ODL program 
from “Start/Programs/Compaq ODL/Copy ODL”. 
 

Your Feedback Is Appreciated

Users are welcome to provide feedback to the ODL program by sending e-mail 
to:

ODLcdrom@ACLabs.com


© 2005 Hewlett-Packard Development Company, L.P.
