Installing DocView

DocView is installed on a SCO UnixWare system using the standard scoadmin package manager. If it is not installed when the operating system is installed, you can follow these instructions to install it when logged onto the system as user root.

DocView requires certain packages to already be installed on the system:

• Perl

• Apache with mod_perl

Once the prerequisite packages are installed, you can install DocView as follows:

   pkgadd -d cdrom1 docview

Installing the package puts the files in place and configures the DocView webserver. It should also automatically start the webserver. See also the section below on starting and stopping the server.

Once the server is started, you should be able to browse the documentation by clicking on the "DocView" icon. You can also just point a browser at:

   http://localhost:8458

Search Engine Indexing crontab

In order for the DocView Search system to work, the search index must be generated on the system. The search index is not generated during installation because it takes significant time and disk space. Instead, a crontab(1) entry is installed for the root login that runs indexing early each day, so that any newly added documentation is immediately indexed. After installation, the documentation set will not be indexed until the next time the crontab is executed.

If there is no new documentation found to index, then noting is generated.

To see the indexing crontab entry, log in as root and enter:

   crontab -l

   10 3 * * * /usr/lib/docview/conf/rundig.crontab > /dev/null 2>&1

The above specifies that the documentation is indexed starting at 0310 local time every day. See crontab(1) for a description of the crontab file time syntax. See the instructions in ``Administering a DocView server'' for how to run indexing manually.