admin.up(4dfs)

Contains the administrative list for the Update Server

Description
The admin.up file is an administrative list of all server principals that can receive copies of files using the Update Server. The admin.up file usually contains the UUIDs of server machines only; it is not necessary to add users or groups to the admin.up file.

The Update Server distributes files such as common configuration files, binary files, and administrative lists from System Control and Binary Distribution machines to the other server machines in a domain. Server machines that rely on System Control and Binary Distribution machines for these kinds of files run the upclient process, the client portion of the Update Server. System Control and Binary Distribution machines run the upserver process, the server portion of the Update Server.

Each instance of the upclient process frequently checks with the upserver process on the System Control and Binary Distribution machines to ensure that its local copies of the proper files are current. If newer versions of the files exist, the upclient process retrieves them from the upserver process and installs them in place of the outdated versions of the files. The admin.up file resides on machines running the upserver process; it specifies the machines whose upclient processes are permitted to obtain copies of files from the upserver process.

Each time the upserver process is started on any machine, it automatically creates the dcelocal/var/dfs/admin.up file if the file does not already exist. You can also create the file by including the -createlist option with the bos addadmin command.

Once the admin.up file exists, principals can be added to it with the bos addadmin command, and they can be removed from it with the bos rmadmin command. The bos lsadmin command can be used to list the principals currently in the file. Because administrative lists are stored as binary files, you must use these commands to modify them; you cannot edit them directly.

The admin.up file should be stored in the directory named dcelocal/var/dfs on each machine running the upserver portion of the Update Server. If it is stored in a different directory, the full pathname of the file must be specified when the upserver process is started. Do not create multiple copies of the admin.up file and store them in different directories; unauthorized users may be able to use the extraneous copies to have the upserver process allow unprivileged machines to obtain copies of files.

Related Information
Commands: bos addadmin(8dfs)

bos lsadmin(8dfs)

bos rmadmin(8dfs)

upclient(8dfs)

upserver(8dfs)