Initializes the server portion of the Update Server
Synopsis
upserver -path {filename | directory_name}... [-adminlist filename] [-help]
Options
-path {filename | directory_name}
Names each file or directory to be distributed (exported) in unencrypted form upon request. If multiple paths are supplied,
they must be unique, disjoint trees in the file system. Paths are examined from left to right; paths that intersect with previous paths used in the command are logged as errors and ignored.
All files and subdirectories located beneath a specified directory can be distributed from the local machine. Therefore, you can specify a / (slash) to allow all files and directories on the local disk of the machine to be distributed.
-adminlist filename
Specifies the file that contains server principals authorized to request files from the local machine. If you do not specify the complete pathname
of a file, the file is assumed to reside in the current working directory. If this option is omitted, the upserver process uses the default file
(dcelocal/var/dfs/admin.up).
-help
Prints the online help for this command. All other options specified with this option are ignored.
The help and apropos commands available with all command suites are also available with the upserver command. See the bos help and bos apropos reference pages for examples of using these commands.
Description
The upserver command initializes the server portion (upserver process) of the Update Server. The upserver process distributes files from
the local disk of a machine in response to requests from the client portion (upclient process) of the Update Server running on other machines. An upserver process should be run on
the System Control machine for the cell or domain and on the Binary Distribution machine for each CPU/operating system type.
The upserver process is usually started and controlled by the BOS Server; if it is not, execute the upserver process as a background process. The binary file for the upserver process resides in dcelocal/bin/upserver.
The -path option specifies the files and directories the upserver process can distribute from the local disk of the machine on which it is run. The upserver process can distribute all files and subdirectories located beneath a specified directory on the local machine; an upclient process can request and receive any file from the specified directory. Specify a / (slash) to allow all files and directories on the local disk of the machine to be distributed.
If the -path option names only a single file from a directory, an upclient process can request and receive only that file. An upclient process that requests the entire directory in which the file resides receives no files. If you specify multiple files and directories, the paths must be disjoint (nonintersecting). Paths are examined from left to right; any path that intersects with a previous path is logged as an error and ignored.
The upserver process writes error messages to the dcelocal/var/dfs/adm/UpLog event log file. When the upserver process is started, it creates the UpLog file if the file does not already exist. It then appends messages to the file. If the file exists when the upserver process is started, the process moves it to the UpLog.old file in the same directory (overwriting the current UpLog.old file if it exists) before creating a new version to which to append messages.
Only one upserver process should be run on a machine at one time. The upserver process automatically creates the dcelocal/var/dfs/admin.up file if the file does not already exist. A machine must be named in the admin.up file for its upclient process to be permitted to access files from the upserver process.
Privilege Required
You must be logged in as root on the local machine.
Examples
The following command specifies that files from the directories /rs_aix32/bin and /usr/mike, which reside on the local disk of the machine, are to be
exported upon request from upclient processes. The indicated paths are nonintersecting, so the command executes as intended.
$ upserver -path /rs_aix32/bin /usr/mike
The following command specifies that files from the directories /rs_aix32/bin, /usr/mike/public, and /usr/mike, which are located on the local disk, are to be exported upon request. However, because the path /usr/mike/public is a subset of the path /usr/mike, the command logs an error in the UpLog file and ignores the /usr/mike path. The /usr/mike/public path is exported as requested.
$ upserver -path /rs_aix32/bin /usr/mike/public /usr/mike
Had /usr/mike been specified before /usr/mike/public in the previous command, the /usr/mike/public path would have been logged as an error in the UpLog file and ignored. In this case, the /usr/mike path would have been exported as intended.
Related Information
Commands: upclient(8dfs)
Files: admin.up(4dfs)