Configuring and managing the help server

Configuring SCOhelp to use a remote documentation server

To configure the system to use a remote documentation server instead of the local server, follow this procedure. (Individual users can override the system default in $HOME/.Xdefaults file.)

In this procedure:

The server system is helpsrv.sco.com.
The client system is helpcli.sco.com.
SCOhelp document resources (in /usr/X/lib/app-defaults/ScoHelpD) and scohelphttpd DocumentRoot values (in /usr/ns-home/httpd-scohelphttp/config/lang.conf) are set to the default values.

To configure SCOhelp to use a remote server:

Log in as root on the client system (helpcli.sco.com in this example).
If scohelphttpd is installed and you no longer intend to use it locally, disable it:

scohelphttp disable
Edit /usr/X/lib/app-defaults/ScoHelpD.

Find the following X resource definition:

   *docServer:		http://localhost:457/

Change it to:

   *docServer:		http://helpsrv.sco.com:457

Log on as root to helpsrv.sco.com and enter scohelphttp query. If the server is running, the output should resemble:
```
Scohelphttp is currently running.
Scohelphttp is enabled.
```
If it is not running, start it:

scohelphttp start
See also scohelphttp(X1M).

Test the new configuration:

Start help on helpcli.sco.com by entering scohelp at an xterm command line. If the top-level topic list appears, you have correctly configured helpcli.sco.com to use the help libraries on helpsrv.sco.com. If it does not, verify that you followed the steps correctly.
Make sure that context-sensitive help works on helpcli.sco.com by pressing <F1> with the cursor in any graphical application. If help for that application appears, context-sensitive help is working. If an error message or the top-level topic list appears, check to see that the directory /usr/lib/scohelp/hooks exists on your client system and restore it, if necessary. The files in this directory are required for SCOhelp to supply context-sensitive help. See ``Using context-sensitive help on a document server system''.

Using context-sensitive help on a document server system

For context-sensitive help to work on systems using a help server, configuration files, called ``hook'' files, must be installed on the local system (the system running the application requesting help). Hook files tell SCOhelp which help files to display when it receives a context-sensitive help request. The hook file is installed on the system in the directory /usr/lib/scohelp/hooks when you install the client.

If you set up a client system to use a documentation server and you remove the documentation from the client server, make sure that you do not remove the /usr/lib/scohelp/hooks directory or any files within it.