NAME

BosConfig - Defines server processes for the BOS Server to monitor

DESCRIPTION

The BosConfig file lists the processes that the Basic OverSeer (BOS) Server monitors on its server machine, and thus defines which AFS server processes run on the machine. It specifies how the BOS Server reacts when a process fails, and also defines the times at which the BOS Server automatically restarts processes as part of performance maintenance. The file must reside in the /usr/afs/local directory on each AFS server machine.

A server process entry in the BosConfig file records the following information:

In addition to server process entries, the BosConfig file specifies the times at which the BOS Server performs two types of automatic process restarts:

Finally, there is an entry specifying whether the BOS Server will start in restricted mode.

Although the BosConfig file is in ASCII format, it is normally best not to use a text editor to alter it. The parser is very picky, and incorrectly formatted entries can prevent server startup in ways that are difficult to diagnose. Instead, use the appropriate commands from the bos command suite:

There are also bos commands that start and stop processes without changing entries in the BosConfig file. The BOS Server reads the BosConfig file only when it starts, transferring the information into its memory. Thus a process's status as represented in the BOS Server's memory can diverge from its status in the BosConfig file. The following commands change a process's status in the BOS Server's memory only:

When the BOS Server shuts down, it rewrites BosConfig, discarding any changes made manually to that file. To change the configuration for the next BOS Server restart, instead write a new file to BosConfig.new. If BosConfig.new exists when the BOS Server starts, BosConfig will be replaced by BosConfig.new before the BOS Server reads its configuration. Note that the BOS Server will notice a new BosConfig.new file whenever the general restart time is reached, if one is configured, since the BOS Server restarts itself at that time.

SEE ALSO

bos_create(8), bos_delete(8), bos_getrestart(8), bos_getrestricted(8), bos_restart(8), bos_setrestart(8), bos_setrestricted(8), bos_shutdown(8), bos_start(8), bos_startup(8), bos_status(8), bos_stop(8), bos_salvage(8), fileserver(8), salvager(8), volserver(8)

COPYRIGHT

IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.

This documentation is covered by the IBM Public License Version 1.0. It was converted from HTML to POD by software written by Chas Williams and Russ Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.