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

FreeBSD Manual Pages

  
 
  

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

NAME
       bos_install - Installs a	new version of a binary	file

SYNOPSIS
       bos install -server <machine name> -file	<files to install>+
	   [-dir <destination dir>] [-cell <cell name>]
	   [-noauth] [-localauth] [-help]

       bos i -s	<machine name> -f <files to install>+
	   [-d <destination dir>] [-c <cell name>] [-n]
	   [-l]	[-h]

DESCRIPTION
       The bos install command copies each binary file specified with the
       -file argument to the local disk	of the server machine named by the
       -server argument, which is normally the binary distribution machine for
       its CPU/operating system	type. The destination directory	is
       /usr/local/libexec/openafs unless the -dir argument indicates an
       alternate directory. The	source file's UNIX mode	bits are preserved in
       the transfer.

       If there	is already a file of the same name in the destination
       directory, the BOS Server automatically saves it	by adding a ".BAK"
       extension. If there is a	current	".BAK" version at least	seven days
       old, it replaces	the current ".OLD" version. If there is	no current
       ".OLD" version, the current ".BAK" version becomes the ".OLD" version
       automatically. The bos getdate command displays the timestamps on the
       current versions	of the file.

       To start	using the new binary immediately, issue	the bos	restart
       command.	Otherwise, the BOS Server automatically	restarts the process
       at the time defined in the /usr/local/etc/openafs/BosConfig file; use
       the bos getrestart command to display the time and the bos setrestart
       time to set it.

OPTIONS
       -server <machine	name>
	   Indicates the binary	distribution machine on	which to install the
	   new binaries. Identify the machine by IP address or its host	name
	   (either fully-qualified or abbreviated unambiguously). For details,
	   see bos(8).

	   If the machine is not a binary distribution machine and is running
	   an "upclientbin" process, then the files are	overwritten the	next
	   time	the "upclientbin" process fetches the corresponding file from
	   the distribution machine (by	default	within five minutes).

       -file <files to install>+
	   Specifies the complete pathname of each binary file to copy into
	   the destination directory. Each source directory can	be on the
	   local disk or in AFS, in which case the issuer of the bos install
	   command must	have the necessary AFS access rights and the local
	   machine must	run the	Cache Manager. For the BOS Server to create
	   ".BAK" and ".OLD" versions, the last	element	in the pathname	(the
	   filename) must match	the name of a file in the destination
	   directory.  bos_create(8) lists the standard	binary file names.

       -dir <destination dir>
	   Provides the	complete pathname of the local disk directory in which
	   to install binary files. It is necessary only if the	destination
	   directory is	not /usr/local/libexec/openafs.

       -cell <cell name>
	   Names the cell in which to run the command. Do not combine this
	   argument with the -localauth	flag. For more details,	see bos(8).

       -noauth
	   Assigns the unprivileged identity "anonymous" to the	issuer.	Do not
	   combine this	flag with the -localauth flag. For more	details, see
	   bos(8).

       -localauth
	   Constructs a	server ticket using a key from the local
	   /usr/local/etc/openafs/server/KeyFile file. The bos command
	   interpreter presents	the ticket to the BOS Server during mutual
	   authentication. Do not combine this flag with the -cell or -noauth
	   options. For	more details, see bos(8).

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

EXAMPLES
       The following command copies the	file
       /afs/abc.com/rs_aix42/usr/local/libexec/openafs/vlserver	to the file
       /usr/local/libexec/openafs/vlserver on the machine "fs3.abc.com", which
       is the binary distribution machine for server machines running AIX 4.2
       in the "abc.com"	cell. The current version of the
       /usr/local/libexec/openafs/vlserver file	is moved to
       /usr/local/libexec/openafs/vlserver.BAK.

	  % bos	install	-server	fs3.abc.com \
			-file /afs/abc.com/rs_aix42/usr/local/libexec/openafs/vlserver

PRIVILEGE REQUIRED
       The issuer must be listed in the	/usr/local/etc/openafs/server/UserList
       file on the machine named by the	-server	argument, or must be logged
       onto a server machine as	the local superuser "root" if the -localauth
       flag is included.

       The bos install command cannot be run against servers which are in
       restricted mode.

SEE ALSO
       BosConfig(5), KeyFile(5), UserList(5), bos(8), bos_getdate(8),
       bos_getrestart(8), bos_restart(8), bos_setrestart(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			BOS_INSTALL(8)

NAME | SYNOPSIS | DESCRIPTION | 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=bos_install&sektion=8&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help