Installs new versions of binary files
Synopsis
bos install -server machine -file binary_file... [-dir alternate_dest]
[{-noauth | -localauth}]
[-help]
Options
-server machine
Names the server machine on which the new binary files are to be installed. The BOS Server on this machine executes the command. To run this command
using a privileged identity, specify the full DCE path name of the machine. To run this command using the unprivileged identity nobody (the equivalent of running the command with the
-noauth option), specify the machine's host name or IP address.
-file binary_file
Specifies the path name of each binary file to be installed on the machine specified by the -server option. For each file, specify either
the full path name or a relative path name (one that does not begin with a slash); relative path names are interpreted relative to the current working directory. The name of each file remains the
same when it is installed on the specified machine; the command automatically preserves an existing file of the same name as a file that is installed.
-dir alternate_dest
Provides the path name of the directory on the machine specified by the -server option in which all specified files are to be installed.
Omit this option to install the files in the default directory, dcelocal/bin; otherwise, provide a full or relative path name. Relative path names are interpreted relative to the
dcelocal directory on the machine specified by -server.
-noauth
Directs bos to use the unprivileged identity nobody as the identity of the issuer of the command. The command fails if you use this option and DFS
authorization checking is not disabled on the machine specified by -server. If you use this option, do not use the -localauth option.
-localauth
Directs bos to use the DFS server principal name of the machine on which the command is issued as the identity of the issuer. Use this option only if the
command is issued from a DFS server machine (a machine that has a DFS server principal in the local Registry Database). You must be logged into the server machine as root for this option to
work. If you use this option, do not use the -noauth option.
-help
Prints the online help for this command. All other valid options specified with this option are ignored.
Description
The bos install command installs each binary file specified with the -file option on the server machine specified with the -server option.
The -file option provides the path name of each file to be installed on the specified machine. By default, the command installs the files in the dcelocal/bin directory on
the specified machine; use the -dir option to indicate a different installation directory on the specified machine.
The command does not change the names of files when it installs them. To preserve the current version of a binary file that has the same name as a file being installed, the command adds a .BAK extension to the name of the existing file. If there is a .BAK version at least 7 days old, the command adds a .OLD extension to its name and it replaces the current .OLD version (if one exists). If there is a .BAK version less than 7 days old, it is overwritten when the current version receives a .BAK extension. If there is no .OLD version, the current .BAK version becomes the .OLD version automatically, regardless of its age.
The command is typically used to install new versions of binary files on Binary Distribution machines. The machine specified with the -server option should be the Binary Distribution machine for its CPU/operating system type. If it is not, newly installed binary files are overwritten the next time the upclient process on the specified machine copies new (or different) versions of binary files via the upserver process on the Binary Distribution machine of its CPU/OS type. (Note that the Update Server propagates binary files from Binary Distribution machines, but the BOS Server installs files when the bos install command is issued; by default, it takes the Update Server 5 minutes to propagate binary files from a Binary Distribution machine.)
To make the machine specified by -server immediately start using new binary files for server processes controlled by the BOS Server, issue the bos restart command. Otherwise, new binaries are not used until the BOS Server restarts the affected processes at the new binary restart time specified in the dcelocal/var/dfs/BosConfig file. Use the bos getrestart and bos setrestart commands to inspect and set the new binary restart time. (The information in this paragraph applies only to affected processes already under the control of the BOS Server.)
The bos install command installs all files with the UNIX mode bits set to 755 (rwxr-xr-x), regardless of the mode bits associated with a version of the file that currently exists in the destination directory. These permissions are subject to the umask associated with the BOS Server on the machine on which the files are installed (because the BOS Server on the specified machine actually executes the command). The mode bits associated with the current version of the file are preserved when it becomes the .BAK version, as are those of the .BAK version when it becomes the .OLD version. (The command does not preserve the access control list, or ACL, permissions of a file installed from a DCE LFS fileset, nor does it directly manipulate the ACL permissions of a file installed into a DCE LFS fileset.)
Use the bos uninstall command to replace the current version of a binary file with the next-oldest version of the file: the .BAK version, if it exists; otherwise, the .OLD version. If both the .BAK and .OLD versions exist, the .OLD version replaces the .BAK version when the latter becomes the current version. Use the -all option with the bos uninstall command to remove all versions of a file; use the bos prune command to remove .BAK and .OLD files from the dcelocal/bin directory (the command can also be used to remove core files from the dcelocal/var/dfs/adm directory). Use the bos getdates command to check the time stamps on binary files.
Privilege Required
You must be listed in the admin.bos file on the machine specified by -server.
Related Information
Commands: bos create(8dfs)
Files: BosConfig(4dfs)