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