Adding Principals and Groups to Administrative Lists

To add principals and groups to an administrative list, do the following:

1. Verify that you have the necessary privilege to issue the command. You must be included in the admin.bos list on the machine on which the administrative list to be affected is located. If necessary, issue the bos lsadmin command to check the admin.bos list.

2. Issue the bos addadmin command to add principals, groups, or both to an administrative list:

$ bos addadmin -server machine -adminlist filename [-principal name...]
[-group name...] [-createlist]

The -adminlist filename option specifies the name of the administrative list to which principals and groups are to be added. The default directory for the administrative lists is the configuration directory, dcelocal/var/dfs. If the lists are stored in the default directory, you need to provide only the specific filename, admin.fl, admin.ft, admin.up, admin.bos, or admin.bak. If the lists are stored elsewhere, you must enter the pathname that was used when the specific process was started.

The -principal name option specifies the principal name of each user or server machine to be added to the list. A user from the local cell can be specified by a full or abbreviated principal name (for example, /.../cellname/username or just username); a user from a foreign cell can be specified only by a full principal name. A server machine from the local cell can be specified by a full or abbreviated principal name (for example, /.../cellname/hosts/hostname/self or just hosts/hostname/self); a server machine from a foreign cell can be specified only by a full principal name.

The -group name option specifies the name of each group to be added to the list. A group from the local cell can be specified by a full or abbreviated group name (for example, /.../cellname/group_name or just group_name); a group from a foreign cell can be specified only by a full group name.

The -createlist option specifies that the administrative list indicated with -adminlist is to be created if it does not already exist. Any principals or groups specified with the command are added to the new file; if no principals or groups are specified, the command creates an empty file. This option has no effect if the specified file already exists.