3
Installing and Viewing Online Books

The DataDirect CD provides online books for the DataDirect Product Series. In addition, it provides Adobe Acrobat Reader, which is required to view the online books.

Some of the DataDirect product installers allow you to install the online books along with the product. In this case, the books are installed in the product's installation directory in a directory named books. To install the books when installing the product, remember to select the Online Books component.

The Connect JDBC installer automatically installs the online books into the Connect JDBC installation directory in a directory named books.

This chapter explains how to install the online books without using a product installer, view the online books, customize the online books, and install Acrobat Reader from the CD.

This chapter covers the following topics:

• About DataDirect's Online Books

• Installing the Online Books

• Viewing the Online Books

• Customizing the Online Books

• About Acrobat Reader

• Product Requirements for Acrobat Reader 4.x

• Installing Acrobat Reader

About DataDirect's Online Books

You can view the online books from the CD or install them to a local or network location. You must view the online books using Acrobat Reader 3.x, or later, licensed from Adobe Systems. The DataDirect CD includes Acrobat Reader 4.x with Search.

You can print the online books to create high-quality, hard-copy books. While viewing an online book in the Acrobat Reader, select File / Print to print the entire file (book), the current page, or a range of pages.

Note: If you want to view the online books on a Windows 3.1x machine, you must view the online books with Acrobat Reader 3.x.

Installing the Online Books

If you want to install the online books without using a product installer, you must maintain the same directory structure that is on the CD. You can install all the online books or specific ones:

• To install all product books, copy the entire \books directory to your local or network drive.

• To install a specific set of books, copy that book's directory structure (beneath the \books directory) to your local or network drive. For example, to install the Connect ODBC books, you would copy the entire odbc directory beneath the books directory (\books\odbc).

Viewing the Online Books

To help you navigate through a DataDirect product's online books, an Acrobat file, called books.pdf, is provided. This file lists each online book provided for a product. We recommend that you open this file first and, from this file, open the book you want to view.

If you want to keep the books.pdf file open until you choose to close it, go to the Reader menu bar and select File / Preferences / General. Clear the check box for the Open Cross-Document Links in Same Window option.

Note: If you do not already have Acrobat Reader installed, you must install it before you can view the books. See "Installing Acrobat Reader" for details.

To View the Online Books:

1. Start Acrobat Reader in one of the following ways:
   • For Windows, click Start on the Taskbar and select Programs. Select the Adobe Acrobat folder that was created during the installation of the Acrobat Reader, and click the Acrobat Reader icon.

   • For UNIX, you can start the Reader from the command line by using its launch script:

   • If the launch script directory is in the search path set by the PATH environment variable, type the following to start Acrobat Reader:

   • % acroread

   • If the launch script directory is not set in the PATH environment variable, type:

     % /acrobatreaderinstalldir/bin/acroread
     

2. On the Reader menu bar, select File / Open, and choose the path where the books.pdf file resides. For example, for SequeLink:

   D:\Program Files\Merant\slodbc51\books\slnk\books.pdf

   or for Connect ODBC:

   D:\Program Files\Merant\books\odbc\books.pdf

3. Click Open.

   While viewing the online books, you can use hypertext links, perform text searches, and use bookmarks.

Using Hypertext Links

Cross-reference links within online books allow you to jump to related topics and other books within a product's documentation set. These links are displayed in blue and allow you to jump to a cross reference with a single click of the mouse. The page numbers in the table of contents and index are also hypertext links.

Performing Text Searches

With Acrobat Reader with Search, you can perform full-text, boolean searches across all of a product's online books. You type a query and Acrobat Reader displays the matching text.

Note: If you will be performing searches across online books on the CD over a non-UNIX network, you must explicitly map to the network drive that contains the CD to enable the Search tool.

The search indexes for DataDirect online books were created with the word stemming search option. This option finds words that share a stem with a search word. For example, if you search for "programming," the Reader will also find "program" and "programs." The search indexes were not created using the Sounds Like and Case Sensitive options. Therefore, you cannot use these options when searching online books. Finally, numbers are not included in the search index and will not be found by a search.

Using Bookmarks

All of the online books contain predefined bookmarks that make it easy for you to quickly jump to a specific topic. By default, the bookmarks are displayed to the left of each online book. For more information about using Acrobat Reader, refer to the online help for the product.

Customizing the Online Books

If you have Adobe Acrobat Exchange 3.0 or higher, you can customize the online books to reflect information specific to your work environment. For example:

• Notes: You can embed notes within an online book to help identify important procedures or helpful hints specific to your organization. A note appears in the online books as a note icon; double-click the icon to view the embedded note text.

• Bookmarks: You can also add customized bookmarks to an online book to help you find topics even faster. Bookmarks can be used to jump to topics within a book, or to other PDF files.

For specific instructions on how to customize a book, refer to the Acrobat documentation.

About Acrobat Reader

You must view the online books using Acrobat Reader 3.x, or later, licensed from Adobe Systems. This CD includes the English version of Acrobat Reader 4.x with Search for the following platforms: Windows 9x, Windows NT, Windows 2000, Solaris, IBM-AIX, and HP-UX. The CD also includes Acrobat Reader 4.x without search for the Linux platform; Acrobat Reader 4.x with Search is not available at this time on Linux.

DataDirect software products may support platforms that are not supported by the Reader. To view the online books for these products, you must do so on a platform that the Reader does support.

Note: For the latest information about supported platforms for Acrobat Reader, refer to the Adobe Web site at: http://www.adobe.com/prodindex/acrobat/readstep.html

Product Requirements for Acrobat Reader 4.x

Note: If you want to view the online books on a Windows 3.1x machine, you must view the online books with Acrobat Reader 3.x.

Windows Platforms

• 486 or Pentium processor-based personal computer

• Microsoft Windows 9x, Windows NT 4.0 with Service Pack 3 or later, Windows 2000

• 10 MB of RAM for Windows 9x (16 MB recommended); 16 MB of RAM for Windows NT and Windows 2000 (24 MB recommended)

• A hard disk with at least 10 MB of free disk space

• CD-ROM drive, locally or on a network

Sun SPARCstation Workstations

• Solaris 2.3 or later operating system (Acrobat Reader will not run on SunOS, Solaris 2.0, 2.1, or 2.2)

• Sun OpenWindows 3.0 or later, Motif 1.2.3 or later, OpenLook 3.0, or Common Desktop Environment (CDE) 1.0 or later

• A hard disk with at least 12 MB of free disk space

• 32 MB of RAM

• CD-ROM drive, locally or on a network

HP Workstations

• HP 9000 Series Workstations model 700 or 800

• HP-UX 9.0.3 or later operating system

• X Window System X11R5 running HP-VUE or Common Desktop Environment (CDE) 1.0 or later

• 32 MB of RAM

• A hard disk with at least 12 MB of free disk space

• CD-ROM drive, locally or on a network

IBM-AIX Workstations

• RS/6000 workstation

• AIX 4.2.1 or later operating system

• Common Desktop Environment (CDE) 1.0 or later, or Motif

• 32 MB of RAM

• A hard disk with at least 12 MB of free disk space

• CD-ROM drive

Linux

• Red Hat Linux 5.1 or later (non-glibc versions)

• 32 MB of RAM

• A hard disk with at least 12 MB of free disk space

Installing Acrobat Reader

The CD contains Acrobat Reader 4.x. To view the online books, you must have Acrobat Reader 3.x or later installed on a local or network location. You cannot start the Reader directly from the CD. If you already have a copy of the correct version of Acrobat Reader with Search installed on your machine, you can skip the procedure documented in this section.

Network Administrators: To allow users to install Acrobat Reader from a network location, copy the entire \Readers\platform directory and its contents from the CD into a directory on the network server.

Windows Platforms

The instructions to install the Reader are the same whether you install it locally or to the network.

To install Acrobat Reader:

1. Insert the DataDirect CD into the CD-ROM drive. If the CD-ROM drive is on a network, you must mount the CD and create a mapping to the CD-ROM drive.

2. Start the Setup program as follows, substituting the appropriate CD-ROM drive letter if necessary.

   From Windows Explorer, navigate to the drive and directory containing the Reader; then, double-click the self-extracting program:

   drive:\Readers\Win95nt\rs405eng.exe
   

3. Follow the on-screen instructions to complete the installation.

UNIX Platforms

To install Acrobat Reader on UNIX:

1. Insert the CD into the CD-ROM drive.

2. Mount the drive on a local workstation as a file system.

   NOTE: To mount a CD-ROM drive, you must know your system's root password. If you do not know the password, contact your system administrator

   1. The following examples assume that the /cdrom mount point is available on your UNIX system. If not, replace /cdrom with a valid mount point.

   2. Open a UNIX shell.

   3. Change to the root user and type the root password:

   4. # su - root

   5. Password: root_password

   6. On Solaris, by default the CD-ROM drive mounts automatically when you insert the CD. The other UNIX platforms supported do not automatically mount the CD by default. If your workstation is not configured to automatically mount a CD, you must enter the command for mounting the drive.

   • For HP-UX, enter:

     # mount -F cdfs -o cdcase device mount_point

     where device is the device name assigned to your CD-ROM drive. The device name can be found using the HP-UX tool sam.

     For example, if the device name for your CD-ROM drive is /dev/dsk/c0t4d0 and you want to mount it over the directory /cdrom, you would enter the following command:

     # mount -F cdfs -o cdcase /dev/dsk/c0t4d0 /cdrom

   • For IBM-AIX, enter:

     # mount -r -v cdrfs /dev/device /cdrom

     where device is the device name assigned to your CD-ROM drive. The device name can be found using the AIX tool smith.

   • For Linux, enter:

     # mount -r -t iso9660 /dev/device /mnt/cdrom

     where device is the device name assigned to your CD-ROM drive.

3. Verify that the drive containing the CD is mounted by entering:

   # mount

   You should see a list of mounted file systems, including the CD-ROM drive you just mounted.

   Copy the appropriate Acrobat Reader compressed file (.Z file) from the CD to your UNIX machine: