Internet Express Version 6.7 for Tru64 UNIX : Internet Express for Tru64 UNIX Read This First

Chapter 2 Documentation Notes

  Table of Contents

The Internet Express documentation consists of HTML and PDF versions of the following documents:

  • Read This First (this document)

  • Release Notes

  • Installation Guide

  • Administration Guide

  • Secure Web Server Administration Guide

  • Internet Monitor Administrator's Guide

  • Internet Services User's Guide

  • QuickSpecs

  • Software Description and Licensing Terms

  • Reference Pages

This section describes the different methods for accessing the Internet Express documentation.

Reading Documentation Using the Administration Utility

After installation of the Secure Web Server subset (IAEAPCH), the Internet Express Documentation subset (IAEDOC), and the Internet Express Administration utility (IAEADM subset), you need access to the Administration utility for Internet Express (as described in the Administration Guide), so that you can read the documentation following the link from the Web page at:

http://hostname.domain:8081

where hostname.domain is the host name and domain of the system running Internet Express.

Reading Documentation Using the Public Web Server

You can also read the documentation without the Administration utility by using the public Web server (if you chose to configure one) to access the documentation index page at http://hostname.domain/documents/bookshelf.html. If this URL does not work, verify that the Web server configuration file, /usr/internet/httpd/admin/conf/httpd.conf, contains the following line:

Alias /documents/ "/usr/internet/docs/IASS/"

The Internet Express documentation files are installed in the /usr/internet/docs/IASS directory.

  • You can access the Documentation Bookshelf installed on your system by entering the following URL (substituting the name of your system for hostname) in your browser:

    http://hostname/documents/bookshelf.html

  • You can also read the installed documentation directly from the file system using a Web browser running on the same system by using the file URL:

    file:/usr/internet/docs/IASS/bookshelf.html

Reading Documentation from the Internet Express Installation and Documentation CD–ROM

You can also access the Documentation Bookshelf on the Internet Express Installation and Documentation CD–ROM from your Tru64 UNIX System or a PC.

On a Tru64 UNIX System

To read the documentation from the Internet Express Installation and Documentation CD–ROM on an AlphaServer system:

  1. Log in to your system as root.

  2. Insert and mount the CD–ROM, replacing drive with the name of your CD–ROM drive:

    # mount /dev/drive /mnt

    Usually this will be:

    # mount /dev/disk/cdrom0c  /mnt
  3. In a Web browser, open the Documentation Bookshelf file by entering the following URL:

    file:/mnt/index.htm
  4. Click on the book you want to open.

On a PC

To read the documentation from the Internet Express Installation and Documentation CD–ROM on a PC:

  1. Insert the CD–ROM into your PC's CD–ROM drive.

    The Bookshelf page is automatically displayed in your browser.

    If the Bookshelf does not appear, open the following URL, replacing drive with the letter of your CD–ROM drive:

    file:drive:\index.htm
  2. Click on the book you want to open.

Reading Reference Pages for Internet Express Components

Reference pages for Open Source Internet Solutions components are available in HTML format from the Internet Express Reference Pages index page. These HTML reference pages can be viewed using a Web browser.

Alternatively, you can view these reference pages from a command line in a terminal window, if you modify the search path for the man(1) command.

The man(1) command's search path needs to include the following directories for Internet Express component reference pages:

/usr/share/man
/usr/local/man
/usr/internet/pgsql/man
/usr/internet/openldap/man
/usr/news/man
/usr/local/samba/man
/usr/internet/httpd/man
/usr/opt/hpapache2/man

You can specify an alternative search path when entering the man command by using the M or P options; for example:

# man -M /usr/news/man active.5

You can also define the man command's MANPATH environment variable on the command line or in a file, such as your .profile file or .login file.

For example, suppose your MANPATH environment variable was defined to be the following:

/usr/share/man:/usr/dt/share/man:/usr/local/man

If you are using the sh or ksh shell, you could modify the MANPATH to add to the search path by adding the following:

# set MANPATH $MANPATH:/usr/internet/pgsql/man:/usr/internet/openldap/man:/usr/news/man: \
/usr/local/samba/man:/usr/internet/httpd/man:/usr/opt/hpapache2/man

# export MANPATH

If you are using the csh shell, you would use a command line like the following:

# setenv MANPATH $MANPATH:/usr/internet/pgsql/man:/usr/internet/openldap/man: \
/usr/news/man:/usr/local/samba/man:/usr/internet/httpd/man:/usr/opt/hpapache2/man

For details about defining reference page search paths, see man(1).

Reading the Open Source Software Component Documentation

The product kit also provides documentation (in ASCII text and HTML) for software components included with Internet Express. This documentation is located in the /usr/internet/docs directory on the system where Internet Express is installed.

Reading the Internet Services User's Guide

The Internet Services User's Guide explains how to use Pine e-mail and the Pico editor, the TIN news reader, and the Lynx Web browser.

The Internet Services User's Guide is accessible from the Internet Express online Documentation Bookshelf. You can access the Bookshelf from links on the Administration utility home page (on port 8081), the default home page for the public Web server, or directly from the Internet Express Installation and Documentation CD–ROM.