src/WINNT/doc/install/Documentation/en_US/html/SysAdminGd/auagd021.htm

   1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN">
   2 <HTML><HEAD>
   3 <TITLE>Administration Guide</TITLE>
   4 <!-- Begin Header Records  ========================================== -->
   5 <!-- /tmp/idwt3191/auagd000.scr converted by idb2h R4.2 (359) ID      -->
   6 <!-- Workbench Version (AIX) on 5 Nov 1999 at 14:06:34                -->
   7 <META HTTP-EQUIV="updated" CONTENT="Fri, 05 Nov 1999 14:06:34">
   8 <META HTTP-EQUIV="review" CONTENT="Sun, 05 Nov 2000 14:06:34">
   9 <META HTTP-EQUIV="expires" CONTENT="Mon, 05 Nov 2001 14:06:34">
  10 </HEAD><BODY>
  11 <!-- (C) IBM Corporation 2000. All Rights Reserved    -->
  12 <BODY bgcolor="ffffff">
  13 <!-- End Header Records  ============================================ -->
  14 <A NAME="Top_Of_Page"></A>
  15 <H1>Administration Guide</H1>
  16 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auagd002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auagd020.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Bot_Of_Page"><IMG SRC="../bot.gif" BORDER="0" ALT="[Bottom of Topic]"></A> <A HREF="auagd022.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auagd026.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
  17 <HR><H1><A NAME="HDRWQ796" HREF="auagd002.htm#ToC_651">Managing Administrative Privilege</A></H1>
  18 <P>This chapter explains how to enable system administrators
  19 and operators to perform privileged AFS operations.
  20 <HR><H2><A NAME="HDRWQ797" HREF="auagd002.htm#ToC_652">Summary of Instructions</A></H2>
  21 <P>This chapter explains how to perform the following tasks by
  22 using the indicated commands&#58;
  23 <BR>
  24 <TABLE WIDTH="100%">
  25 <TR>
  26 <TD ALIGN="LEFT" VALIGN="TOP" WIDTH="70%">Display members of <B>system&#58;administrators</B> group
  27 </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="30%"><B>pts membership</B>
  28 </TD></TR><TR>
  29 <TD ALIGN="LEFT" VALIGN="TOP" WIDTH="70%">Add user to <B>system&#58;administrators</B> group
  30 </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="30%"><B>pts adduser</B>
  31 </TD></TR><TR>
  32 <TD ALIGN="LEFT" VALIGN="TOP" WIDTH="70%">Remove user from <B>system&#58;administrators</B> group
  33 </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="30%"><B>pts removeuser</B>
  34 </TD></TR><TR>
  35 <TD ALIGN="LEFT" VALIGN="TOP" WIDTH="70%">Display <TT>ADMIN</TT> flag in Authentication Database entry
  36 </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="30%"><B>kas examine</B>
  37 </TD></TR><TR>
  38 <TD ALIGN="LEFT" VALIGN="TOP" WIDTH="70%">Set or remove <TT>ADMIN</TT> flag on Authentication Database entry
  39 </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="30%"><B>kas setfields</B>
  40 </TD></TR><TR>
  41 <TD ALIGN="LEFT" VALIGN="TOP" WIDTH="70%">Display users in <B>UserList</B> file
  42 </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="30%"><B>bos listusers</B>
  43 </TD></TR><TR>
  44 <TD ALIGN="LEFT" VALIGN="TOP" WIDTH="70%">Add user to <B>UserList</B> file
  45 </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="30%"><B>bos adduser</B>
  46 </TD></TR><TR>
  47 <TD ALIGN="LEFT" VALIGN="TOP" WIDTH="70%">Remove user from <B>UserList</B> file
  48 </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="30%"><B>bos removeuser</B>
  49 </TD></TR></TABLE>
  50 <HR><H2><A NAME="HDRWQ806" HREF="auagd002.htm#ToC_653">An Overview of Administrative Privilege</A></H2>
  51 <A NAME="IDX8103"></A>
  52 <A NAME="IDX8104"></A>
  53 <P>A fully privileged AFS system administrator has the following
  54 characteristics&#58;
  55 <UL>
  56 <P><LI>Membership in the cell&#39;s <B>system&#58;administrators</B>
  57 group. See <A HREF="#HDRWQ808">Administering the system&#58;administrators Group</A>.
  58 <P><LI>The <TT>ADMIN</TT> flag on his or her entry in the cell&#39;s
  59 Authentication Database. See <A HREF="#HDRWQ811">Granting Privilege for kas Commands&#58;  the ADMIN Flag</A>.
  60 <P><LI>Inclusion in the file <B>/usr/afs/etc/UserList</B> on the local disk
  61 of each AFS server machine in the cell. See <A HREF="#HDRWQ814">Administering the UserList File</A>.
  62 </UL>
  63 <P>This section describes the three privileges and explains why more than one
  64 privilege is necessary.
  65 <TABLE><TR><TD ALIGN="LEFT" VALIGN="TOP"><B>Note:</B></TD><TD ALIGN="LEFT" VALIGN="TOP">Never grant any administrative privilege to the user <B>anonymous</B>,
  66 even when a server outage makes it impossible to mutually authenticate.
  67 If you grant such privilege, then any user who can access a machine in your
  68 cell can issue privileged commands. The alternative solution is to put
  69 the affected server machine into no-authentication mode and use the
  70 <B>-noauth</B> flag available on many commands to prevent mutual
  71 authentication attempts. For further discussion, see <A HREF="auagd008.htm#HDRWQ157">Managing Authentication and Authorization Requirements</A>.
  72 </TD></TR></TABLE>
  73 <P><H3><A NAME="HDRWQ807" HREF="auagd002.htm#ToC_654">The Reason for Separate Privileges</A></H3>
  74 <P>Often, a cell&#39;s administrators require full
  75 administrative privileges to perform their jobs effectively. However,
  76 separating the three types of privilege makes it possible to grant only the
  77 minimum set of privileges that a given administrator needs to complete his or
  78 her work.
  79 <P>The <B>system&#58;administrators</B> group privilege is perhaps the
  80 most basic, and most frequently used during normal operation (when all the
  81 servers are running normally). When the Protection Database is
  82 unavailable due to machine or server outage, it is not possible to issue
  83 commands that require this type of privilege.
  84 <P>The <TT>ADMIN</TT> flag privilege is separate because of the extreme
  85 sensitivity of the information in the Authentication Database, especially the
  86 server encryption key in the <B>afs</B> entry. When the
  87 Authentication Database is unavailable due to machine or server outage, it is
  88 not possible to issue commands that require this type of privilege.
  89 <P>The ability to issue privileged <B>bos</B> and <B>vos</B> command
  90 is recorded in the <B>/usr/afs/etc/UserList</B> file on the local disk of
  91 each AFS server machine rather than in a database, so that in case of serious
  92 server or network problems administrators can still log onto server machines
  93 and use those commands while solving the problem.
  94 <HR><H2><A NAME="HDRWQ808" HREF="auagd002.htm#ToC_655">Administering the system&#58;administrators Group</A></H2>
  95 <A NAME="IDX8105"></A>
  96 <A NAME="IDX8106"></A>
  97 <A NAME="IDX8107"></A>
  98 <A NAME="IDX8108"></A>
  99 <A NAME="IDX8109"></A>
 100 <A NAME="IDX8110"></A>
 101 <A NAME="IDX8111"></A>
 102 <P>The first type of AFS administrative privilege is membership .
 103 Members of the <B>system&#58;administrators</B> group in the Protection
 104 Database have the following privileges&#58;
 105 <UL>
 106 <P><LI>Permission to issue all <B>pts</B> commands, which are used to
 107 administer the Protection Database. See <A HREF="auagd019.htm#HDRWQ721">Administering the Protection Database</A>.
 108 <P><LI>Permission to issue the <B>fs setvol</B> and <B>fs setquota</B>
 109 commands, which set the space quota on volumes as described in <A HREF="auagd010.htm#HDRWQ319">Setting and Displaying Volume Quota and Current Size</A>.
 110 <P><LI>Implicit <B>a</B> (<B>administer</B>) and by default <B>l</B>
 111 (<B>lookup</B>) permissions on the access control list (ACL) on every
 112 directory in the cell&#39;s AFS filespace. Members of the group can
 113 use the <B>fs setacl</B> command to grant themselves any other permissions
 114 they require, as described in <A HREF="auagd020.htm#HDRWQ788">Setting ACL Entries</A>.
 115 <P>You can change the ACL permissions that the File Server on a given file
 116 server machine implicitly grants to the members of the
 117 <B>system&#58;administrators</B> group for the data in volumes that it
 118 houses. When you issue the <B>bos create</B> command to create and
 119 start the <B>fs</B> process on the machine, include the
 120 <B>-implicit</B> argument to the <B>fileserver</B> initialization
 121 command. For syntax details, see the <B>fileserver</B> reference
 122 page in the <I>AFS Administration Reference</I>. You can grant
 123 additional permissions, or remove the <B>l</B> permission. However,
 124 the File Server always implicitly grants the <B>a</B> permission to
 125 members of the group, even if you set the value of the <B>-implicit</B>
 126 argument to <B>none</B>.
 127 </UL>
 128 <A NAME="IDX8112"></A>
 129 <A NAME="IDX8113"></A>
 130 <A NAME="IDX8114"></A>
 131 <A NAME="IDX8115"></A>
 132 <P><H3><A NAME="HDRWQ809" HREF="auagd002.htm#ToC_656">To display the members of the system&#58;administrators group</A></H3>
 133 <OL TYPE=1>
 134 <P><LI>Issue the <B>pts membership</B> command to display the
 135 <B>system&#58;administrators</B> group&#39;s list of members.
 136 Any user can issue this command as long as the first privacy flag on the
 137 <B>system&#58;administrators</B> group&#39;s Protection Database entry
 138 is not changed from the default value of uppercase <TT>S</TT>.
 139 <PRE>   % <B>pts membership system&#58;administrators</B>
 140 </PRE>
 141 <P>where <B>m</B> is the shortest acceptable abbreviation of
 142 <B>membership</B>.
 143 </OL>
 144 <P><H3><A NAME="Header_657" HREF="auagd002.htm#ToC_657">To add users to the system&#58;administrators group</A></H3>
 145 <A NAME="IDX8116"></A>
 146 <A NAME="IDX8117"></A>
 147 <A NAME="IDX8118"></A>
 148 <A NAME="IDX8119"></A>
 149 <OL TYPE=1>
 150 <P><LI>Verify that you belong to the <B>system&#58;administrators</B>
 151 group. If necessary, issue the <B>pts membership</B> command, which
 152 is fully described in <A HREF="#HDRWQ809">To display the members of the system&#58;administrators group</A>.
 153 <PRE>   % <B>pts membership system&#58;administrators</B>
 154
 155 </PRE>
 156 <P><LI>Issue the <B>pts adduser</B> group to add one or more users.
 157 <PRE>   % <B>pts adduser -user</B> &lt;<VAR>user&nbsp;name</VAR>><SUP>+</SUP> <B>-group system&#58;administrators</B>
 158 </PRE>
 159 <P>where
 160 <DL>
 161 <P><DT><B>ad
 162 </B><DD>Is the shortest acceptable abbreviation of <B>adduser</B>.
 163 <P><DT><B>-user
 164 </B><DD>Names each user to add to the <B>system&#58;administrators</B>
 165 group.
 166 </DL>
 167 </OL>
 168 <P><H3><A NAME="HDRWQ810" HREF="auagd002.htm#ToC_658">To remove users from the system&#58;administrators group</A></H3>
 169 <A NAME="IDX8120"></A>
 170 <A NAME="IDX8121"></A>
 171 <A NAME="IDX8122"></A>
 172 <A NAME="IDX8123"></A>
 173 <OL TYPE=1>
 174 <P><LI>Verify that you belong to the <B>system&#58;administrators</B>
 175 group. If necessary, issue the <B>pts membership</B> command, which
 176 is fully described in <A HREF="#HDRWQ809">To display the members of the system&#58;administrators group</A>.
 177 <PRE>   % <B>pts membership system&#58;administrators</B>
 178
 179 </PRE>
 180 <P><LI>Issue the <B>pts removeuser</B> command to remove one or more
 181 users.
 182 <PRE>   % <B>pts removeuser -user</B> &lt;<VAR>user&nbsp;name</VAR>><SUP>+</SUP> <B>-group system&#58;administrators</B>
 183 </PRE>
 184 <P>where
 185 <DL>
 186 <P><DT><B><B>rem</B>
 187 </B><DD>Is the shortest acceptable abbreviation of <B>removeuser</B>.
 188 <P><DT><B>-user
 189 </B><DD>Names each user to remove from the <B>system&#58;administrators</B>
 190 group.
 191 </DL>
 192 </OL>
 193 <HR><H2><A NAME="HDRWQ811" HREF="auagd002.htm#ToC_659">Granting Privilege for kas Commands&#58;  the ADMIN Flag</A></H2>
 194 <A NAME="IDX8124"></A>
 195 <P>Administrators who have the <TT>ADMIN</TT> flag on their Authentication
 196 Database entry can issue all <B>kas</B> commands, which enable them to
 197 administer the Authentication Database.
 198 <A NAME="IDX8125"></A>
 199 <A NAME="IDX8126"></A>
 200 <A NAME="IDX8127"></A>
 201 <P><H3><A NAME="HDRWQ812" HREF="auagd002.htm#ToC_660">To check if the ADMIN flag is set</A></H3>
 202 <A NAME="IDX8128"></A>
 203 <A NAME="IDX8129"></A>
 204 <A NAME="IDX8130"></A>
 205 <A NAME="IDX8131"></A>
 206 <OL TYPE=1>
 207 <P><LI><A NAME="LIWQ813"></A>Issue the <B>kas examine</B> command to display an entry
 208 from the Authentication Database.
 209 <P>The Authentication Server performs its own authentication rather than
 210 accepting your existing AFS token. By default, it authenticates your
 211 local (UFS) identity, which possibly does not correspond to an AFS-privileged
 212 administrator. Include the <B>-admin_username</B> argument (here
 213 abbreviated to <B>-admin</B>) to name a user identity that has the
 214 <TT>ADMIN</TT> flag on its Authentication Database entry.
 215 <PRE>   % <B>kas examine</B> &lt;<VAR>name&nbsp;of&nbsp;user</VAR>>   \
 216                  <B>-admin</B>  &lt;<VAR>admin&nbsp;principal&nbsp;to&nbsp;use&nbsp;for&nbsp;authentication</VAR>>
 217    Administrator&#39;s (<VAR>admin_user</VAR>) password&#58; <VAR>admin_password</VAR>
 218 </PRE>
 219 <P>where
 220 <DL>
 221 <P><DT><B>e
 222 </B><DD>Is the shortest acceptable abbreviation of <B>examine</B>.
 223 <P><DT><B><VAR>name of user</VAR>
 224 </B><DD>Names the entry to display.
 225 <P><DT><B>-admin
 226 </B><DD>Names an administrative account with the <TT>ADMIN</TT> flag on its
 227 Authentication Database entry, such as the <B>admin</B> account.
 228 The password prompt echoes it as <VAR>admin_user</VAR>. Enter the
 229 appropriate password as <VAR>admin_password</VAR>.
 230 </DL>
 231 </OL>
 232 <P>If the <TT>ADMIN</TT> flag is turned on, it appears on the first line, as
 233 in this example&#58;
 234 <PRE>   % <B>kas e terry -admin admin</B>
 235    Administrator&#39;s (admin) password&#58; <VAR>admin_password</VAR>
 236    User data for terry (ADMIN)
 237      key version is 0, <VAR>etc...</VAR>
 238 </PRE>
 239 <A NAME="IDX8132"></A>
 240 <A NAME="IDX8133"></A>
 241 <A NAME="IDX8134"></A>
 242 <A NAME="IDX8135"></A>
 243 <A NAME="IDX8136"></A>
 244 <A NAME="IDX8137"></A>
 245 <P><H3><A NAME="Header_661" HREF="auagd002.htm#ToC_661">To set or remove the ADMIN flag</A></H3>
 246 <OL TYPE=1>
 247 <P><LI>Issue the <B>kas setfields</B> command to turn on the <TT>ADMIN</TT>
 248 flag in an Authentication Database entry.
 249 <P>The Authentication Server performs its own authentication rather than
 250 accepting your existing AFS token. By default, it authenticates your
 251 local (UNIX) identity, which possibly does not correspond to an AFS-privileged
 252 administrator. Include the <B>-admin</B> argument to name an
 253 identity that has the <TT>ADMIN</TT> flag on its Authentication Database
 254 entry. To verify that an entry has the flag, issue the <B>kas
 255 examine</B> command as described in <A HREF="#HDRWQ812">To check if the ADMIN flag is set</A>.
 256 <P>The following command appears on two lines only for legibility.
 257 <PRE>    % <B>kas setfields</B> &lt;<VAR>name&nbsp;of&nbsp;user</VAR>>  {<B>ADMIN</B> |  <B>NOADMIN</B>} \
 258                    <B>-admin</B> &lt;<VAR>admin&nbsp;principal&nbsp;to&nbsp;use&nbsp;for&nbsp;authentication</VAR>>
 259     Administrator&#39;s (<VAR>admin_user</VAR>) password&#58; <VAR>admin_password</VAR>
 260 </PRE>
 261 <P>where
 262 <DL>
 263 <P><DT><B>sf
 264 </B><DD>Is an alias for <B>setfields</B> (and <B>setf</B> is the shortest
 265 acceptable abbreviation).
 266 <P><DT><B><VAR>name of user</VAR>
 267 </B><DD>Names the entry for which to set or remove the <TT>ADMIN</TT>
 268 flag.
 269 <P><DT><B>ADMIN | NOADMIN
 270 </B><DD>Sets or removes the <TT>ADMIN</TT> flag, respectively.
 271 <P><DT><B>-admin
 272 </B><DD>Names an administrative account with the <TT>ADMIN</TT> flag on its
 273 Authentication Database entry, such as the <B>admin</B> account.
 274 The password prompt echoes it as <VAR>admin_user</VAR>. Enter the
 275 appropriate password as <VAR>admin_password</VAR>.
 276 </DL>
 277 </OL>
 278 <HR><H2><A NAME="HDRWQ814" HREF="auagd002.htm#ToC_662">Administering the UserList File</A></H2>
 279 <A NAME="IDX8138"></A>
 280 <P>Inclusion in the file <B>/usr/afs/etc/UserList</B> on the local disk of
 281 each AFS server machine enables an administrator to issue commands from the
 282 indicated suites.
 283 <UL>
 284 <P><LI>The <B>bos</B> commands enable the administrator to manage server
 285 processes and the server configuration files that define the cell&#39;s
 286 database server machines, server encryption keys, and privileged users.
 287 See <A HREF="auagd008.htm#HDRWQ95">Administering Server Machines</A> and <A HREF="auagd009.htm#HDRWQ176">Monitoring and Controlling Server Processes</A>.
 288 <P><LI>The <B>vos</B> commands enable the administrator to manage volumes and
 289 the Volume Location Database (VLDB). See <A HREF="auagd010.htm#HDRWQ228">Managing Volumes</A>.
 290 <P><LI>The <B>backup</B> commands enable the administrator to use the AFS
 291 Backup System to copy data to permanent storage. See <A HREF="auagd011.htm#HDRWQ333">Configuring the AFS Backup System</A> and <A HREF="auagd012.htm#HDRWQ382">Backing Up and Restoring AFS Data</A>.
 292 </UL>
 293 <A NAME="IDX8139"></A>
 294 <A NAME="IDX8140"></A>
 295 <A NAME="IDX8141"></A>
 296 <A NAME="IDX8142"></A>
 297 <A NAME="IDX8143"></A>
 298 <A NAME="IDX8144"></A>
 299 <A NAME="IDX8145"></A>
 300 <A NAME="IDX8146"></A>
 301 <A NAME="IDX8147"></A>
 302 <A NAME="IDX8148"></A>
 303 <P>Although each AFS server machine maintains a separate copy of the file on
 304 its local disk, it is conventional to keep all copies the same. It can
 305 be confusing for an administrator to have the privilege on some machines but
 306 not others.
 307 <A NAME="IDX8149"></A>
 308 <P>If your cell runs the United States edition of AFS and uses the Update
 309 Server to distribute the contents of the system control machine&#39;s
 310 <B>/usr/afs/etc</B> directory, then edit only the copy of the
 311 <B>UserList</B> file stored on the system control machine. If you
 312 have forgotten which machine is the system control machine, see <A HREF="auagd008.htm#HDRWQ124">The Four Roles for File Server Machines</A>.
 313 <P>If your cell runs the international edition of AFS, or does not use a
 314 system control machine, then you must edit the <B>UserList</B> file on
 315 each server machine individually.
 316 <P>To avoid making formatting errors that can result in performance problems,
 317 never edit the <B>UserList</B> file directly. Instead, use the
 318 <B>bos adduser</B> or <B>bos removeuser</B> commands as described in
 319 this section.
 320 <A NAME="IDX8150"></A>
 321 <A NAME="IDX8151"></A>
 322 <A NAME="IDX8152"></A>
 323 <A NAME="IDX8153"></A>
 324 <P><H3><A NAME="HDRWQ815" HREF="auagd002.htm#ToC_663">To display the users in the UserList file</A></H3>
 325 <OL TYPE=1>
 326 <P><LI>Issue the <B>bos listusers</B> command to display the contents of the
 327 <B>/usr/afs/etc/UserList</B> file.
 328 <PRE>   % <B>bos listusers</B> &lt;<VAR>machine&nbsp;name</VAR>>
 329 </PRE>
 330 <P>where
 331 <DL>
 332 <P><DT><B>listu
 333 </B><DD>Is the shortest acceptable abbreviation of <B>listusers</B>.
 334 <P><DT><B><VAR>machine name</VAR>
 335 </B><DD>Names an AFS server machine. In the normal case, any machine is
 336 acceptable because the file is the same on all of them.
 337 </DL>
 338 </OL>
 339 <P><H3><A NAME="HDRWQ816" HREF="auagd002.htm#ToC_664">To add users to the UserList file</A></H3>
 340 <A NAME="IDX8154"></A>
 341 <A NAME="IDX8155"></A>
 342 <A NAME="IDX8156"></A>
 343 <A NAME="IDX8157"></A>
 344 <OL TYPE=1>
 345 <P><LI>Verify you are listed in the <B>/usr/afs/etc/UserList</B> file.
 346 If not, you must have a qualified administrator add you before you can add
 347 entries to it yourself. If necessary, issue the <B>bos
 348 listusers</B> command, which is fully described in <A HREF="#HDRWQ815">To display the users in the UserList file</A>.
 349 <PRE>   % <B>bos listusers</B> &lt;<VAR>machine name</VAR>>
 350 </PRE>
 351 <P><LI>Issue the <B>bos adduser</B> command to add one or more users to the
 352 <B>UserList</B> file.
 353 <PRE>   % <B>bos adduser</B> &lt;<VAR>machine&nbsp;name</VAR>> &lt;<VAR>user&nbsp;names</VAR>><SUP>+</SUP>
 354 </PRE>
 355 <P>where
 356 <DL>
 357 <P><DT><B>addu
 358 </B><DD>Is the shortest acceptable abbreviation of <B>adduser</B>.
 359 <P><DT><B><VAR>machine name</VAR>
 360 </B><DD>Names the system control machine if you use the Update Server to
 361 distribute the contents of the <B>/usr/afs/etc</B> directory (possible
 362 only in cells running the United States edition of AFS). By default, it
 363 can take up to five minutes for the Update Server to distribute the changes,
 364 so newly added users must wait that long before attempting to issue privileged
 365 commands.
 366 <P>If you are running the international edition of AFS, or do not use the
 367 Update Server, repeat the command, substituting the name of each AFS server
 368 machine for <VAR>machine name</VAR> in turn.
 369 <P><DT><B><VAR>user names</VAR>
 370 </B><DD>Specifies the username of each administrator to add to the
 371 <B>UserList</B> file.
 372 </DL>
 373 </OL>
 374 <P><H3><A NAME="Header_665" HREF="auagd002.htm#ToC_665">To remove users from the UserList file</A></H3>
 375 <A NAME="IDX8158"></A>
 376 <A NAME="IDX8159"></A>
 377 <A NAME="IDX8160"></A>
 378 <A NAME="IDX8161"></A>
 379 <OL TYPE=1>
 380 <P><LI>Verify you are listed in the <B>/usr/afs/etc/UserList</B> file.
 381 If not, you must have a qualified administrator add you before you can remove
 382 entries from it yourself. If necessary, issue the <B>bos
 383 listusers</B> command, which is fully described in <A HREF="#HDRWQ815">To display the users in the UserList file</A>.
 384 <PRE>   % <B>bos listusers</B> &lt;<VAR>machine name</VAR>>
 385 </PRE>
 386 <P><LI>Issue the <B>bos removeuser</B> command to remove one or more users
 387 from the <B>UserList</B> file.
 388 <PRE>   % <B>bos removeuser</B> &lt;<VAR>machine&nbsp;name</VAR>> &lt;<VAR>user&nbsp;names</VAR>><SUP>+</SUP>
 389 </PRE>
 390 <P>where
 391 <DL>
 392 <P><DT><B>removeu
 393 </B><DD>Is the shortest acceptable abbreviation of <B>removeuser</B>.
 394 <P><DT><B><VAR>machine name</VAR>
 395 </B><DD>Names the system control machine if you use the Update Server to
 396 distribute the contents of the <B>/usr/afs/etc</B> directory (possible
 397 only in cells running the United States edition of AFS). By default, it
 398 can take up to five minutes for the Update Server to distribute the change, so
 399 newly removed users can continue to issue privileged commands during that
 400 time.
 401 <P>If you are running the international edition of AFS, or do not use the
 402 Update Server, repeat the command, substituting the name of each AFS server
 403 machine for <VAR>machine name</VAR> in turn.
 404 <P><DT><B><VAR>user names</VAR>
 405 </B><DD>Specifies the username of each administrator to add to the
 406 <B>UserList</B> file.
 407 </DL>
 408 </OL>
 409 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auagd002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auagd020.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Top_Of_Page"><IMG SRC="../top.gif" BORDER="0" ALT="[Top of Topic]"></A> <A HREF="auagd022.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auagd026.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
 410 <!-- Begin Footer Records  ========================================== -->
 411 <P><HR><B>
 412 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 413 </B>
 414 <!-- End Footer Records  ============================================ -->
 415 <A NAME="Bot_Of_Page"></A>
 416 </BODY></HTML>