PREVNEXTINDEX

3 Installing and Viewing Online Books

The DataDirect CD and the DataDirect Technologies Web site provide online books for the DataDirect Product Series. In addition, they provide Adobe Acrobat Reader, which is required to view the online books.

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

This chapter explains how to:

NOTE: Instructions for downloading the online books and Acrobat Reader from the Web are provided on the DataDirect Technologies Web site:

http://www.datadirect-technologies.com/download/docs/
dochome.asp

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 4.x, or later, licensed from Adobe Systems. The DataDirect CD includes Acrobat Reader 5.x with Search for Windows, and Acrobat Reader 4.x with Search for UNIX (except Linux, which does not include the search capability).

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.

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:

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:
  2. On the Reader menu bar, select File / Open, and choose the path where the books.pdf file resides. For example, for SequeLink:

    3. D:\Program Files\DataDirect\slodbc54\books\slnk\books.pdf

    or for DataDirect Connect for ODBC:

    D:\Program Files\DataDirect\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. Some links take you to a URL on the DataDirect Technologies World Wide Web site (if you have an HTML browser installed on your computer). 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.x or Adobe Acrobat 4.0 or higher, you can customize the online books to reflect information specific to your work environment. For example:

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 4.x, or higher, licensed from Adobe Systems. This CD includes the English version of Acrobat Reader 5.x with Search for Windows 9x, Windows Me, Windows NT, Windows 2000, and Windows XP. It includes the English version of Acrobat Reader 4.x with Search for Solaris, IBM-AIX, and HP-UX; Acrobat Reader 5.x is not available for UNIX at this time. The CD also includes Acrobat Reader 4.x without search for the Linux platform; Acrobat Reader 4.x with Search is not available for Linux at this time.

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

5.x on Windows Platforms

4.x on Sun SPARCstation Workstations

4.x on HP Workstations

4.x on IBM-AIX Workstations

4.x on Linux

Installing Acrobat Reader

The CD contains Acrobat Reader 5.x. To view the online books, you must have Acrobat Reader 4.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.

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

    drive:\Readers\Windows\rp505enu.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.

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

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

    1. Open a UNIX shell.
    2. Change to the root user and type the root password:

      3. # su - root

      Password: root_password

    3. 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:

        • # /usr/sbin/pfs_mountd&

        # /usr/sbin/pfsd&

        # pfs_mount -o xlat=unix /dev/rdsk/deviceName /cdrom

        where deviceNameis the device name assigned to your CD-ROM drive. The device name can be found using the HP-UX tool sam. When installation is complete, unmount the CD-ROM with the command:

        # /usr/sbin/pfs_umount /cdrom

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

        # pfs_mount -o xlat=unix /dev/rdsk/c0t4d0 /cdrom

      • For IBM-AIX, enter:

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

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

      • For Linux, enter:

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

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

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

    4. # mount

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

  4. Copy the appropriate Acrobat Reader compressed file (.Z file) from the CD to your UNIX machine:
  5. Uncompress the file by entering:

    6. uncompress compressed_filename

  6. Untar the .tar file that was extracted from the compressed file:

    7. tar -xvf filename.tar

  7. Use the instructions in the Instguid.txt file to complete the Acrobat Reader installation. This file is one of the files that was extracted from the .tar file.

PREVNEXTINDEX