D Installing Associated Products

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

General installation information for all associated products (Section D.1)

Installing an associated product from CD-ROM (Section D.1.1)

Installing an associated product from a remote installation services (RIS) server (Section D.1.2)

Updating the whatis database after installing an associated product (Section D.1.3)

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.

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. See 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 directory 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.124.96): 56 data bytes
64 bytes from 16.59.124.96: icmp_seq=0 ttl=255 time=1 ms
64 bytes from 16.59.124.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 catman(8) for more information.