D Installing Associated Products

This appendix describes how to install associated products. The following topics are discussed:

General installation information for all associated products

Installing an associated product from CD-ROM

Installing an associated product from a remote installation services (RIS) server

Updating the whatis database after installing an associated product

Special installation instructions for the Netscape FasTrack Server

D.1 General Installation Information

Associated products are installed after the initial Full Installation by using the setld utility. The installation can be invoked from the Associated Products CD-ROM Volume 1 or 2 or from a remote installation services (RIS) server environment

Most of the product directories on the associated products CD-ROM contain a doc subdirectory, which contains the documentation (in HTML and text formats) for the product if it is available. A README file in each product directory provides a short description of the product.

With the exception of the Netscape FasTrack Server, follow the instructions in Section D.1.1 or Section D.1.2 to install all associated products.

D.1.1 Installing Associated Products from the CD-ROM

Follow this procedure to install an associated product from the Associated Products CD-ROM:

Become superuser (or log in as root):
```
# su -
Password: root_password
```

Mount the Associated Products CD-ROM at the /mnt directory. Refer to Section B.3 if you do not know how to mount a CD-ROM.
If you mount the CD-ROM at a mount point other than /mnt, modify the remaining steps accordingly.

Change directory to the mounted CD-ROM:
```
# cd /mnt
```

Examine the product directories to determine the directory name in which the product is located:
```
# ls -cF
```

Change back to the / (root) directory:
```
# cd /
```

Invoke the setld utility :
```
# /usr/sbin/setld -l /mnt/product_directory/kit
```
Replace product_directory with the name of the directory where the product is located.
The setld utility displays the list of software subsets that are available to install. Choose the software subsets you want from the list.

Repeat Steps 4 through 6 for each associated product you want to install.

D.1.2 Installing Associated Products from a Remote Server

Follow this procedure to install an associated product from a RIS server environment:

Ask your RIS server administrator to ensure that your system is a client of the RIS server and is registered for the right environment.

Ensure that your system can communicate with the RIS server:
```
# /sbin/ping -c2 ris_server_name
```
Successful communication between your system and the RIS server should result in a zero data packet loss. Command output looks similar to this:
```
# ping -c2 system9
PING system9 (16.59.l24.96): 56 data bytes
64 bytes from 16.59.l24.96: icmp_seq=0 ttl=255 time=1 ms
64 bytes from 16.59.l24.96: icmp_seq=1 ttl=255 time=0 ms
 
----system9 PING Statistics----
2 packets transmitted, 2 packets received, 0% packet loss
round-trip (ms)  min/avg/max = 0/0/1 ms
```
In the previous example, system9 is the name of the RIS server. If your system is not connected to the network, open the System Setup application (by entering /usr/sbin/checklist), and use the Quick Setup application to configure basic network services.

Invoke the setld utility. Remember to append a colon ( : ) to the RIS server name :
```
# /usr/sbin/setld -l ris_server_name:
```
The setld utility displays the list of software subsets that are available to install. Choose the software subsets you want from the list.

D.1.3 Updating the whatis Database After Installing Reference Pages for Associated Products

The apropos and man commands access reference page entries in the whatis database. The whatis database that is created in the /usr/share/man directory when you initially install base operating system reference pages includes entries only for those reference pages.

The whatis database provided as part of the operating system is not updated automatically when an associated product, layered product, third party, or site-specific reference pages are installed after the initial operating system installation. If the whatis database exists on your system, you should update the database by executing the catman -w command if you install product-specific reference pages. For information about using the catman -w command to rebuild the whatis database, see the catman(8) reference page.

D.2 Installing Netscape FastTrack Server

Because the FastTrack Server has its own installation program, instructions to install this product are different from the instructions for installing the other associated layered products.

Follow this procedure to install the Netscape FastTrack Server:

Log in to the root account on your system.

Install the WEBNETSCAPEFASTTRACK301 subset following the instructions in Section D.1.1.

When the installation is complete, change your directory to the FastTrack Server directory on your system:
```
# cd /usr/opt/netscape/suitespot
```

Read the README file in this directory:
```
#  more README
```
This README file contains information directly from Netscape about the FastTrack Server kit. Because you have installed FastTrack from the Associated Products Volume 1 CD-ROM, and not from a CD-ROM that was shipped to you by Netscape, you can ignore Steps 1 through 5 of the installation instructions contained in the README file. Steps 1 through 5 are installation instructions specific to installing from the Netscape CD-ROM.

Run the ns-setup program to begin configuring the FastTrack server, and follow the instructions in the README file:
```
# ./ns-setup
```