Installs the former versions of binary files
Synopsis
bos uninstall -server machine -file binary_file... [-dir alternate_dest] [-all]
[{-noauth |
-localauth}] [-help]
Options
-server machine
Names the server machine on which the former versions of specified binary files are to be used. 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
Names each binary file to be replaced with its next-oldest version (.BAK, if it exists; otherwise, .OLD). All specified files must
reside in the same directory (dcelocal/bin, by default, or an alternate directory specified with the -dir option). Specify only file names; if a path name is provided for
a file, the command ignores all but the final element.
-dir alternate_dest
Provides the path name of the directory in which all specified files reside. Omit this option if the files reside in the default directory,
dcelocal/bin; otherwise, provide a full or relative path name. Relative path names (path names that do not begin with a slash) are interpreted relative to the dcelocal
directory on the machine specified by -server.
-all
Directs the BOS Server on the indicated machine to remove all versions (current, .BAK, and .OLD) of the specified files. Only versions of the files that
reside in the dcelocal/bin directory (or an alternate directory specified with the -dir option) are removed.
-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 uninstall command replaces each binary file specified with the -file option with its next-oldest version. Use the -server option
to specify the name of the server machine that houses the files to be manipulated. All specified files must reside in the same directory. By default, the command looks for the files in the
dcelocal/bin directory; use the -dir option to name a different directory. Versions of the files in other directories on the specified machine are not affected.
The command applies the following algorithm to the removal of each binary file:
· If current, .BAK, and .OLD versions of the file exist, the command makes the .BAK version the current version and it makes the .OLD version the .BAK version.
· If any version of the file does not exist, the command omits it from the algorithm. For example, if no .BAK version exists, the command makes the .OLD version the current version.
· If the -all option is included with the command, the command removes all versions (current, .BAK, and .OLD) of the file that exist.
· The command displays the following message if no version of the file exists, or if only the current version exists and the -all option is omitted:
bos: failed to uninstall filename (there is no earlier version present
to reinstall)
where filename is the name of the file that cannot be replaced or removed.
The machine specified with the -server option should be the Binary Distribution machine for its CPU/operating system type. If it is not, the 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 manipulates files when the bos uninstall 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 start using the reinstalled binary files immediately, issue the bos restart command. Otherwise, the binaries are not used until the BOS Server restarts the affected process 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.)
Use the bos install command to install new versions of binary files on a server machine. 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
The issuer must be listed in the admin.bos file on the machine specified by -server.
Related Information
Commands: bos getdates(8dfs)
Files: BosConfig(4dfs)