Installing the ToolTalk Database Server

The ToolTalk Database server is used to store three types of information:

ToolTalk objects specs.
ToolTalk session IDs of sessions with clients that have joined a file using the tt_file_join call.
File-scoped messages that are queued because the message disposition is TT_QUEUED and a handler that can handle the message has not yet been started.

In addition, the ToolTalk Database server answers queries for the ToolTalk filename mapping API calls (tt_host_file_netfile() and tt_host_netfile_file()).

Note - The ToolTalk database server does not store messages that are scoped to file-in-session.

The ToolTalk service requires that a database server run on each machine that stores files that contain ToolTalk objects or files that are the subject of ToolTalk messages. When an application attempts to reference a file on a machine that does not contain a database server, an error similar to the following message is displayed:

% Error: Tool Talk database server on integral is not running: tcp

where integral is the hostname and tcp is the application protocol. This error message indicates that the connection failed. A failed connection can also be caused by network problems.

Confirming that the rpc.ttdbserverd is installed on a system.

All machines should have the SUNWtltk and SUNWdtcor packages installed if they contain files referenced in ToolTalk messages. To confirm that rpc.ttdbserverd is installed on a system:

Login to the system.

Use pkginfo(1) to determine that the SUNWtltk and SUNWdtcor packages are installed.

Caution - The /etc/inetd.conf config line below is installed by the SUNWdtcor Solaris package. If a system does not have SUNWtltk installed, you should make sure that SUNWdtcor is present before installing SUNWtltk. Do not copy a Solaris 7 (SunOS 5.7 or compatible) server onto a machine running the Solaris 1.0 (SunOS 4.0/4.1 or compatible) operating environment.

Check that the /etc/inetd.conf file contains the following line.
```
100083/1 tli rpc/tcp wait root /usr/openwin/bin/rpc.ttdbserverd
```
If you find that rpc.ttdbserverd is not present, then you can install it by adding the SUNWtltlk and SUNWdtcor packages using pkgadd(1M). After adding the packages have inetd reread its configuration file:
```
# ps -ef | grep inetd # kill -HUP inetd-pid
```
Note - inetd-pid is from the ps listing.

Confirming that the rpc.ttdbserverd is running on a system.

To determine if the ToolTalk database server is actually running on a specific system, you can use the rpcinfo(1M) command:

% rpcinfo -T tcp -t <hostname> 100083
program 100083 version 1 ready and waiting
%

Note - hostname is from hostname(1).

From the Solaris Distribution CD-Rom

To install the ToolTalk software package from the Solaris distribution cd-rom, use the pkgadd command. The package name for the ToolTalk software is SUNWt/tk; the developer's package name is SUNWt/tkd; and the manpage package name is SUNWt/tkm.