===============
SunSolve CD 4.x
===============

Welcome to SunSolve CD! 

Features
========
 * Document dates in search results list
 * Upgrade feature for server install (run 'install.sh')
 * Uninstall feature for server install (run 'install.sh -u')
 * Web browser interface
 * Searchable fields for some collections
 * New document compression and indexing scheme
 * Search term highlighting

System Requirements
===================
 * OS: Solaris 2.4 or greater (SPARC or x86), SunOS 4.1.3 or greater
 * Hardware: SPARCStation 5 or greater, 486/Pentium with 64-MB RAM
 * 650-MB hard disk space (for server installation)

Installation
============
You can run SunSolve from the CD-ROM or install it onto a local server for 
access by anyone on your network.

 - To run from the CD-ROM, insert and mount the CD-ROM. Then, run 'sunsolve'
   from the root level directory of the CD-ROM.

 - To perform a server installation, insert and mount the CD-ROM. Then, run
   'install.sh' from the root level directory of the CD-ROM. You will need 
   to know the root password of your machine. Once the server installation
   has been successfully completed, you can access it from a seperate browser, 
   such as HotJava or Netscape. An attempt to install the SunSolve Server to 
   port 80 will be made on the machine, but another port will be chosen if 80 
   is not available. See the installation output for the port used.

=================================
Linking to AnswerBooks (Optional)
=================================

The Sun AnswerBooks are valuable tools for solving system problems. You
can take advantage of these resources by linking SunSolve CD to AnswerBooks.

If you add AnswerBook to the SunSolve dataset, you can search the
AnswerBook collection along with the standard data collections provided.
The Power Search window will expand to accomodate the standard data
collections and the additional AnswerBook collections.

Server Configuration
====================

 - You must perform a server installation of SunSolve CD. 
 - You need to know the location of the existing AnswerBook card catalog 
   file (ab_cardcatalog).
 - You need to be logged in as root on your machine.  

Step 1
------

Set the SUNSOLVEHOME environment variable to the directory where you have
installed SunSolve:

      machine# setenv SUNSOLVEHOME <SunSolve_install_dir> 

Step 2
------

Change directories to the 'abook' subdirectory under the SunSolve installation
directory. 

      machine# cd $SUNSOLVEHOME/abook

Step 3
------

Run the 'ab_link' program to link to AnswerBook.

      machine# ./ab_link 

Follow the instructions displayed on-screen and answer the prompts
appropriately.

Client Configuration
====================

 - SunSolve uses a unique MIME type to identify AnswerBook documents from 
   other types of documents such as plain text documents or HTML documents. 

 - In order for a web browser client to view AnswerBooks, the following
   steps must be performed. 

Step 1
------

Make the '$SUNSOLVEHOME/abook/bin' subdirectory available for clients 
to automount.

Step 2
------

Configure the web browser client to associate the MIME type
'application/x-abook' with the AnswerBook viewer helper application located
at '$SUNSOLVEHOME/abook/bin/<os>/<arch>/mime2ab'.

**Note: While the steps to do this differ depending on the web browser, UNIX
versions of both the Netscape Navigator and NCSA Mosaic read the ~/.mailcap
file for this information, so if you are using either of those browsers, it 
should be sufficient to add the appropriate line to the .mailcap file. This 
can be done by typing the following: 

	echo "application/x-abook;	(continued on next line) 
	/net/<server>/sso/abook/bin/<os>/<arch>/mime2ab %s" >> ~/.mailcap

After this is done, the last step is to exit and restart your web browser 
to ensure that it has read the updated file.