BosConfig - Defines server processes for the BOS Server to monitor


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 /etc/yfs/server 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 If exists when the BOS Server starts, it will rename that file to BosConfig before reading its configuration.


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)


IBM Corporation 2000. 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.


"AFS" is a registered mark of International Business Machines Corporation, used under license. (USPTO Registration 1598389)

"OpenAFS" is a registered mark of International Business Machines Corporation. (USPTO Registration 4577045)

The "AuriStor" name, log 'S' brand mark, and icon are registered marks of AuriStor, Inc. (USPTO Registrations 4849419, 4849421, and 4928460) (EUIPO Registration 015539653).

"Your File System" is a registered mark of AuriStor, Inc. (USPTO Registrations 4801402 and 4849418).

"YFS" and "AuriStor File System" are trademarks of AuriStor, Inc.