Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
BUSERVER(8)		     AFS Command Reference		   BUSERVER(8)

NAME
       buserver	- Initializes the Backup Server

SYNOPSIS
       buserver	[-database <database directory>]
	   [-auditlog <log path>] [-audit-interface (file | sysvmq)]
	   [-cellservdb	<cell configuration directory>]	[-resetdb]
	   [-noauth] [-smallht]	[-servers <list	of ubik	database servers>+]
	   [-enable_peer_stats]	 [-enable_process_stats] [-rxbind]
	   [-p <number of threads>] [-help]

DESCRIPTION
       The buserver command initializes	the Backup Server, which runs on
       database	server machines	and maintains the Backup Database. In the
       conventional configuration, the binary file is located in the
       /usr/local/libexec/openafs directory on a file server machine.

       The buserver command is not normally issued at the command shell
       prompt, but rather placed into a	database server	machine's
       /usr/local/etc/openafs/BosConfig	file with the bos create command. If
       it is ever issued at the	command	shell prompt, the issuer must be
       logged onto a file server machine as the	local superuser	"root".

       As it initializes, the Backup Server process creates the	two files that
       constitute the Backup Database, bdb.DB0 and bdb.DBSYS1, in the
       /var/openafs/db directory if they do not	already	exist. The Backup
       Database	houses information about volume	sets and entries, the dump
       hierarchy, Tape Coordinators, and previously performed dump sets. Use
       the commands in the backup suite	to administer the database.

       The Backup Server records a trace of its	activity in the
       /var/openafs/logs/BackupLog file. Use the bos getlog command to display
       the contents of the file.

       This command does not use the syntax conventions	of the AFS command
       suites. Provide the command name	and all	option names in	full.

CAUTIONS
       The buserver process reserves port 7021 for its use. Unexpected
       behavior	can occur if another process tries to reserve this port	while
       the buserver process is running.

OPTIONS
       -database <database directory>
	   Specifies the pathname of an	alternate directory for	the Backup
	   Database files, ending in a final slash ("/"). If this argument is
	   not provided, the default is	the /var/openafs/db directory.

       -auditlog <log path>
	   Turns on audit logging, and sets the	path for the audit log.	 The
	   audit log records information about RPC calls, including the	name
	   of the RPC call, the	host that submitted the	call, the
	   authenticated entity	(user) that issued the call, the parameters
	   for the call, and if	the call succeeded or failed.

       -audit-interface	(file |	sysvmq)
	   Specifies what audit	interface to use. Defaults to "file". See
	   fileserver(8) for an	explanation of each interface.

       -cellservdb <cell configuration directory>
	   Specifies the pathname of the directory from	which the Backup
	   Server reads	in an alternate	version	of the CellServDB file.	This
	   argument is mandatory for correct functioning when the Backup
	   Server is running on	a subset of the	cell's database	server
	   machines that is not	a majority of the machines listed in the
	   standard /usr/local/etc/openafs/server/CellServDB file (which the
	   Backup Server consults if this argument is not provided). It	is not
	   appropriate in any other circumstances.

       -resetdb
	   Removes all of the information in the Backup	Database files in the
	   /var/openafs/db directory, leaving zero-length versions of them.
	   The backup operator must recreate the configuration entries in the
	   database (for volume	sets, the dump hierarchy and so	on) before
	   performing backup operations.

       -noauth
	   Establishes an unauthenticated connection between the issuer	and
	   the Backup Server, in which the Backup Server treats	the issuer as
	   the unprivileged user "anonymous". It is useful only	when
	   authorization checking is disabled on the database server machine.
	   In normal circumstances, the	Backup Server allows only authorized
	   (privileged)	users to issue commands	that affect or contact the
	   Backup Database, and	refuses	to perform such	an action even if the
	   -noauth flag	is used.

       -smallht
	   Directs the Backup Server to	use smaller internal hash tables for
	   the Backup Database,	which reduces memory requirements but can make
	   data	access take longer.

       -servers	<list of ubik database servers>+
	   Specifies the database server machines on which to start the	Backup
	   Server. Use this argument if	running	the Backup Server on a subset
	   of the database server machines that	is not a majority of the
	   machines listed in the /usr/local/etc/openafs/server/CellServDB
	   file.

       -enable_peer_stats
	   Activates the collection of Rx statistics and allocates memory for
	   their storage. For each connection with a specific UDP port on
	   another machine, a separate record is kept for each type of RPC
	   (FetchFile, GetStatus, and so on) sent or received. To display or
	   otherwise access the	records, use the Rx Monitoring API.

       -enable_process_stats
	   Activates the collection of Rx statistics and allocates memory for
	   their storage. A separate record is kept for	each type of RPC
	   (FetchFile, GetStatus, and so on) sent or received, aggregated over
	   all connections to other machines. To display or otherwise access
	   the records,	use the	Rx Monitoring API.

       -rxbind
	   Bind	the Rx socket to the primary interface only.  (If not
	   specified, the Rx socket will listen	on all interfaces.)

       -p <number of threads>
	   Sets	the number of server lightweight processes (LWPs or pthreads)
	   to run.  Provide a positive integer from the	range 3	to 16. The
	   default value is 3.

       -help
	   Prints the online help for this command. All	other valid options
	   are ignored.

EXAMPLES
       The following example bos create	command	creates	a "buserver" process
       on the file server machine "fs3.abc.com". It appears here on two	lines
       only for	legibility.

	  % bos	create -server fs3.abc.com -instance buserver \
		       -type simple -cmd /usr/local/libexec/openafs/buserver

PRIVILEGE REQUIRED
       The issuer must be logged in as the superuser "root" on a file server
       machine to issue	the command at a command shell prompt. It is
       conventional instead to create and start	the process by issuing the bos
       create command.

SEE ALSO
       BackupLog(5), BosConfig(5), CellServDB(5), bdb.DB0(5), backup(8),
       bos_create(8), bos_getlog(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.

OpenAFS				  2016-12-14			   BUSERVER(8)

NAME | SYNOPSIS | DESCRIPTION | CAUTIONS | OPTIONS | EXAMPLES | PRIVILEGE REQUIRED | SEE ALSO | COPYRIGHT

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=buserver&sektion=8&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help