ukernel-use-fsblkcnt-20090513
[openafs.git] / doc / xml / AdminGuide / c32432.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 <HTML
3 ><HEAD
4 ><TITLE
5 >Managing Administrative Privilege</TITLE
6 ><META
7 NAME="GENERATOR"
8 CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
9 REL="HOME"
10 TITLE="AFS Administration Guide"
11 HREF="book1.html"><LINK
12 REL="UP"
13 TITLE="Managing Users and Groups"
14 HREF="p24911.html"><LINK
15 REL="PREVIOUS"
16 TITLE="Managing Access Control Lists"
17 HREF="c31274.html"><LINK
18 REL="NEXT"
19 TITLE="Managing the NFS/AFS Translator"
20 HREF="a33047.html"></HEAD
21 ><BODY
22 CLASS="chapter"
23 BGCOLOR="#FFFFFF"
24 TEXT="#000000"
25 LINK="#0000FF"
26 VLINK="#840084"
27 ALINK="#0000FF"
28 ><DIV
29 CLASS="NAVHEADER"
30 ><TABLE
31 SUMMARY="Header navigation table"
32 WIDTH="100%"
33 BORDER="0"
34 CELLPADDING="0"
35 CELLSPACING="0"
36 ><TR
37 ><TH
38 COLSPAN="3"
39 ALIGN="center"
40 >AFS Administration Guide: Version 3.6</TH
41 ></TR
42 ><TR
43 ><TD
44 WIDTH="10%"
45 ALIGN="left"
46 VALIGN="bottom"
47 ><A
48 HREF="c31274.html"
49 ACCESSKEY="P"
50 >Prev</A
51 ></TD
52 ><TD
53 WIDTH="80%"
54 ALIGN="center"
55 VALIGN="bottom"
56 ></TD
57 ><TD
58 WIDTH="10%"
59 ALIGN="right"
60 VALIGN="bottom"
61 ><A
62 HREF="a33047.html"
63 ACCESSKEY="N"
64 >Next</A
65 ></TD
66 ></TR
67 ></TABLE
68 ><HR
69 ALIGN="LEFT"
70 WIDTH="100%"></DIV
71 ><DIV
72 CLASS="chapter"
73 ><H1
74 ><A
75 NAME="HDRWQ581"
76 ></A
77 >Chapter 16. Managing Administrative Privilege</H1
78 ><P
79 >This chapter explains how to enable system administrators and operators to perform privileged AFS operations.</P
80 ><DIV
81 CLASS="sect1"
82 ><H1
83 CLASS="sect1"
84 ><A
85 NAME="HDRWQ582"
86 >Summary of Instructions</A
87 ></H1
88 ><P
89 >This chapter explains how to perform the following tasks by using the indicated commands:</P
90 ><DIV
91 CLASS="informaltable"
92 ><A
93 NAME="AEN32438"
94 ></A
95 ><TABLE
96 BORDER="0"
97 FRAME="void"
98 CLASS="CALSTABLE"
99 ><COL
100 WIDTH="70*"><COL
101 WIDTH="30*"><TBODY
102 ><TR
103 ><TD
104 >Display members of <SPAN
105 CLASS="bold"
106 ><B
107 CLASS="emphasis"
108 >system:administrators</B
109 ></SPAN
110 > group</TD
111 ><TD
112 ><SPAN
113 CLASS="bold"
114 ><B
115 CLASS="emphasis"
116 >pts membership</B
117 ></SPAN
118 ></TD
119 ></TR
120 ><TR
121 ><TD
122 >Add user to <SPAN
123 CLASS="bold"
124 ><B
125 CLASS="emphasis"
126 >system:administrators</B
127 ></SPAN
128 > group</TD
129 ><TD
130 ><SPAN
131 CLASS="bold"
132 ><B
133 CLASS="emphasis"
134 >pts adduser</B
135 ></SPAN
136 ></TD
137 ></TR
138 ><TR
139 ><TD
140 >Remove user from <SPAN
141 CLASS="bold"
142 ><B
143 CLASS="emphasis"
144 >system:administrators</B
145 ></SPAN
146 > group</TD
147 ><TD
148 ><SPAN
149 CLASS="bold"
150 ><B
151 CLASS="emphasis"
152 >pts removeuser</B
153 ></SPAN
154 ></TD
155 ></TR
156 ><TR
157 ><TD
158 >Display <SAMP
159 CLASS="computeroutput"
160 >ADMIN</SAMP
161 > flag in Authentication Database entry</TD
162 ><TD
163 ><SPAN
164 CLASS="bold"
165 ><B
166 CLASS="emphasis"
167 >kas examine</B
168 ></SPAN
169 ></TD
170 ></TR
171 ><TR
172 ><TD
173 >Set or remove <SAMP
174 CLASS="computeroutput"
175 >ADMIN</SAMP
176 > flag on Authentication Database entry</TD
177 ><TD
178 ><SPAN
179 CLASS="bold"
180 ><B
181 CLASS="emphasis"
182 >kas setfields</B
183 ></SPAN
184 ></TD
185 ></TR
186 ><TR
187 ><TD
188 >Display users in <SPAN
189 CLASS="bold"
190 ><B
191 CLASS="emphasis"
192 >UserList</B
193 ></SPAN
194 > file</TD
195 ><TD
196 ><SPAN
197 CLASS="bold"
198 ><B
199 CLASS="emphasis"
200 >bos listusers</B
201 ></SPAN
202 ></TD
203 ></TR
204 ><TR
205 ><TD
206 >Add user to <SPAN
207 CLASS="bold"
208 ><B
209 CLASS="emphasis"
210 >UserList</B
211 ></SPAN
212 > file</TD
213 ><TD
214 ><SPAN
215 CLASS="bold"
216 ><B
217 CLASS="emphasis"
218 >bos adduser</B
219 ></SPAN
220 ></TD
221 ></TR
222 ><TR
223 ><TD
224 >Remove user from <SPAN
225 CLASS="bold"
226 ><B
227 CLASS="emphasis"
228 >UserList</B
229 ></SPAN
230 > file</TD
231 ><TD
232 ><SPAN
233 CLASS="bold"
234 ><B
235 CLASS="emphasis"
236 >bos removeuser</B
237 ></SPAN
238 ></TD
239 ></TR
240 ></TBODY
241 ></TABLE
242 ></DIV
243 ></DIV
244 ><DIV
245 CLASS="sect1"
246 ><H1
247 CLASS="sect1"
248 ><A
249 NAME="HDRWQ584"
250 >An Overview of Administrative Privilege</A
251 ></H1
252 ><P
253 >A fully privileged AFS system administrator has the following characteristics: <UL
254 ><LI
255 ><P
256 >Membership in the cell's <SPAN
257 CLASS="bold"
258 ><B
259 CLASS="emphasis"
260 >system:administrators</B
261 ></SPAN
262 > group. See <A
263 HREF="c32432.html#HDRWQ586"
264 >Administering the system:administrators Group</A
265 >.</P
266 ></LI
267 ><LI
268 ><P
269 >The <SAMP
270 CLASS="computeroutput"
271 >ADMIN</SAMP
272 > flag on his or her entry in the cell's Authentication Database. See <A
273 HREF="c32432.html#HDRWQ589"
274 >Granting Privilege for kas Commands: the ADMIN Flag</A
275 >.</P
276 ></LI
277 ><LI
278 ><P
279 >Inclusion in the file <SPAN
280 CLASS="bold"
281 ><B
282 CLASS="emphasis"
283 >/usr/afs/etc/UserList</B
284 ></SPAN
285 > on the local disk of each AFS server
286           machine in the cell. See <A
287 HREF="c32432.html#HDRWQ592"
288 >Administering the UserList File</A
289 >.</P
290 ></LI
291 ></UL
292 ></P
293 ><P
294 >This section describes the three privileges and explains why more than one privilege is necessary.</P
295 ><DIV
296 CLASS="note"
297 ><BLOCKQUOTE
298 CLASS="note"
299 ><P
300 ><B
301 >Note: </B
302 >Never grant any administrative privilege to the user <SPAN
303 CLASS="bold"
304 ><B
305 CLASS="emphasis"
306 >anonymous</B
307 ></SPAN
308 >, even when a server
309       outage makes it impossible to mutually authenticate. If you grant such privilege, then any user who can access a machine in
310       your cell can issue privileged commands. The alternative solution is to put the affected server machine into no-authentication
311       mode and use the <SPAN
312 CLASS="bold"
313 ><B
314 CLASS="emphasis"
315 >-noauth</B
316 ></SPAN
317 > flag available on many commands to prevent mutual authentication
318       attempts. For further discussion, see <A
319 HREF="c3025.html#HDRWQ123"
320 >Managing Authentication and Authorization
321       Requirements</A
322 >.</P
323 ></BLOCKQUOTE
324 ></DIV
325 ><DIV
326 CLASS="sect2"
327 ><H2
328 CLASS="sect2"
329 ><A
330 NAME="HDRWQ585"
331 >The Reason for Separate Privileges</A
332 ></H2
333 ><P
334 >Often, a cell's administrators require full administrative privileges to perform their jobs effectively. However,
335       separating the three types of privilege makes it possible to grant only the minimum set of privileges that a given
336       administrator needs to complete his or her work.</P
337 ><P
338 >The <SPAN
339 CLASS="bold"
340 ><B
341 CLASS="emphasis"
342 >system:administrators</B
343 ></SPAN
344 > group privilege is perhaps the most basic, and most
345       frequently used during normal operation (when all the servers are running normally). When the Protection Database is
346       unavailable due to machine or server outage, it is not possible to issue commands that require this type of privilege.</P
347 ><P
348 >The <SAMP
349 CLASS="computeroutput"
350 >ADMIN</SAMP
351 > flag privilege is separate because of the extreme sensitivity of the
352       information in the Authentication Database, especially the server encryption key in the <SPAN
353 CLASS="bold"
354 ><B
355 CLASS="emphasis"
356 >afs</B
357 ></SPAN
358 >
359       entry. When the Authentication Database is unavailable due to machine or server outage, it is not possible to issue commands
360       that require this type of privilege.</P
361 ><P
362 >The ability to issue privileged <SPAN
363 CLASS="bold"
364 ><B
365 CLASS="emphasis"
366 >bos</B
367 ></SPAN
368 > and <SPAN
369 CLASS="bold"
370 ><B
371 CLASS="emphasis"
372 >vos</B
373 ></SPAN
374 > command is
375       recorded in the <SPAN
376 CLASS="bold"
377 ><B
378 CLASS="emphasis"
379 >/usr/afs/etc/UserList</B
380 ></SPAN
381 > file on the local disk of each AFS server machine
382       rather than in a database, so that in case of serious server or network problems administrators can still log onto server
383       machines and use those commands while solving the problem.</P
384 ></DIV
385 ></DIV
386 ><DIV
387 CLASS="sect1"
388 ><H1
389 CLASS="sect1"
390 ><A
391 NAME="HDRWQ586"
392 >Administering the system:administrators Group</A
393 ></H1
394 ><P
395 >The first type of AFS administrative privilege is membership . Members of the <SPAN
396 CLASS="bold"
397 ><B
398 CLASS="emphasis"
399 >system:administrators</B
400 ></SPAN
401 > group in the Protection Database have the following privileges: <UL
402 ><LI
403 ><P
404 >Permission to issue all <SPAN
405 CLASS="bold"
406 ><B
407 CLASS="emphasis"
408 >pts</B
409 ></SPAN
410 > commands, which are used to administer the Protection
411           Database. See <A
412 HREF="c29323.html"
413 >Administering the Protection Database</A
414 >.</P
415 ></LI
416 ><LI
417 ><P
418 >Permission to issue the <SPAN
419 CLASS="bold"
420 ><B
421 CLASS="emphasis"
422 >fs setvol</B
423 ></SPAN
424 > and <SPAN
425 CLASS="bold"
426 ><B
427 CLASS="emphasis"
428 >fs setquota</B
429 ></SPAN
430 >
431           commands, which set the space quota on volumes as described in <A
432 HREF="c8420.html#HDRWQ234"
433 >Setting and Displaying Volume
434           Quota and Current Size</A
435 >.</P
436 ></LI
437 ><LI
438 ><P
439 >Implicit <SPAN
440 CLASS="bold"
441 ><B
442 CLASS="emphasis"
443 >a</B
444 ></SPAN
445 > (<SPAN
446 CLASS="bold"
447 ><B
448 CLASS="emphasis"
449 >administer</B
450 ></SPAN
451 >) and by default <SPAN
452 CLASS="bold"
453 ><B
454 CLASS="emphasis"
455 >l</B
456 ></SPAN
457 > (<SPAN
458 CLASS="bold"
459 ><B
460 CLASS="emphasis"
461 >lookup</B
462 ></SPAN
463 >) permissions on the access control list (ACL) on every
464           directory in the cell's AFS filespace. Members of the group can use the <SPAN
465 CLASS="bold"
466 ><B
467 CLASS="emphasis"
468 >fs setacl</B
469 ></SPAN
470 > command
471           to grant themselves any other permissions they require, as described in <A
472 HREF="c31274.html#HDRWQ573"
473 >Setting ACL
474           Entries</A
475 >.</P
476 ><P
477 >You can change the ACL permissions that the File Server on a given file server machine implicitly grants to the
478           members of the <SPAN
479 CLASS="bold"
480 ><B
481 CLASS="emphasis"
482 >system:administrators</B
483 ></SPAN
484 > group for the data in volumes that it houses. When
485           you issue the <SPAN
486 CLASS="bold"
487 ><B
488 CLASS="emphasis"
489 >bos create</B
490 ></SPAN
491 > command to create and start the <SPAN
492 CLASS="bold"
493 ><B
494 CLASS="emphasis"
495 >fs</B
496 ></SPAN
497 > process on the machine, include the <SPAN
498 CLASS="bold"
499 ><B
500 CLASS="emphasis"
501 >-implicit</B
502 ></SPAN
503 > argument to the
504           <SPAN
505 CLASS="bold"
506 ><B
507 CLASS="emphasis"
508 >fileserver</B
509 ></SPAN
510 > initialization command. For syntax details, see the <SPAN
511 CLASS="bold"
512 ><B
513 CLASS="emphasis"
514 >fileserver</B
515 ></SPAN
516 > reference page in the <SPAN
517 CLASS="emphasis"
518 ><I
519 CLASS="emphasis"
520 >IBM AFS Administration Reference</I
521 ></SPAN
522 >. You can
523           grant additional permissions, or remove the <SPAN
524 CLASS="bold"
525 ><B
526 CLASS="emphasis"
527 >l</B
528 ></SPAN
529 > permission. However, the File Server always
530           implicitly grants the <SPAN
531 CLASS="bold"
532 ><B
533 CLASS="emphasis"
534 >a</B
535 ></SPAN
536 > permission to members of the group, even if you set the value of
537           the <SPAN
538 CLASS="bold"
539 ><B
540 CLASS="emphasis"
541 >-implicit</B
542 ></SPAN
543 > argument to <SPAN
544 CLASS="bold"
545 ><B
546 CLASS="emphasis"
547 >none</B
548 ></SPAN
549 >.</P
550 ></LI
551 ></UL
552 ></P
553 ><DIV
554 CLASS="sect2"
555 ><H2
556 CLASS="sect2"
557 ><A
558 NAME="HDRWQ587"
559 >To display the members of the system:administrators group</A
560 ></H2
561 ><OL
562 TYPE="1"
563 ><LI
564 ><P
565 >Issue the <SPAN
566 CLASS="bold"
567 ><B
568 CLASS="emphasis"
569 >pts membership</B
570 ></SPAN
571 > command to display the <SPAN
572 CLASS="bold"
573 ><B
574 CLASS="emphasis"
575 >system:administrators</B
576 ></SPAN
577 > group's list of members. Any user can issue this command as long as the first
578           privacy flag on the <SPAN
579 CLASS="bold"
580 ><B
581 CLASS="emphasis"
582 >system:administrators</B
583 ></SPAN
584 > group's Protection Database entry is not
585           changed from the default value of uppercase <SAMP
586 CLASS="computeroutput"
587 >S</SAMP
588 >. <PRE
589 CLASS="programlisting"
590 >&#13;   % <SPAN
591 CLASS="bold"
592 ><B
593 CLASS="emphasis"
594 >pts membership system:administrators</B
595 ></SPAN
596 >
597 </PRE
598 ></P
599 ><P
600 >where <SPAN
601 CLASS="bold"
602 ><B
603 CLASS="emphasis"
604 >m</B
605 ></SPAN
606 > is the shortest acceptable abbreviation of <SPAN
607 CLASS="bold"
608 ><B
609 CLASS="emphasis"
610 >membership</B
611 ></SPAN
612 >.</P
613 ></LI
614 ></OL
615 ></DIV
616 ><DIV
617 CLASS="sect2"
618 ><H2
619 CLASS="sect2"
620 ><A
621 NAME="Header_657"
622 >To add users to the system:administrators group</A
623 ></H2
624 ><OL
625 TYPE="1"
626 ><LI
627 ><P
628 >Verify that you belong to the <SPAN
629 CLASS="bold"
630 ><B
631 CLASS="emphasis"
632 >system:administrators</B
633 ></SPAN
634 > group. If necessary, issue the
635           <SPAN
636 CLASS="bold"
637 ><B
638 CLASS="emphasis"
639 >pts membership</B
640 ></SPAN
641 > command, which is fully described in <A
642 HREF="c32432.html#HDRWQ587"
643 >To display
644           the members of the system:administrators group</A
645 >. <PRE
646 CLASS="programlisting"
647 >&#13;   % <SPAN
648 CLASS="bold"
649 ><B
650 CLASS="emphasis"
651 >pts membership system:administrators</B
652 ></SPAN
653 >
654 </PRE
655 ></P
656 ></LI
657 ><LI
658 ><P
659 >Issue the <SPAN
660 CLASS="bold"
661 ><B
662 CLASS="emphasis"
663 >pts adduser</B
664 ></SPAN
665 > group to add one or more users. <PRE
666 CLASS="programlisting"
667 >&#13;   % <SPAN
668 CLASS="bold"
669 ><B
670 CLASS="emphasis"
671 >pts adduser -user</B
672 ></SPAN
673 > &#60;<VAR
674 CLASS="replaceable"
675 >user name</VAR
676 >&#62;+ <SPAN
677 CLASS="bold"
678 ><B
679 CLASS="emphasis"
680 >-group system:administrators</B
681 ></SPAN
682 >
683 </PRE
684 ></P
685 ><P
686 >where <DIV
687 CLASS="variablelist"
688 ><DL
689 ><DT
690 ><SPAN
691 CLASS="bold"
692 ><B
693 CLASS="emphasis"
694 >ad</B
695 ></SPAN
696 ></DT
697 ><DD
698 ><P
699 >Is the shortest acceptable abbreviation of <SPAN
700 CLASS="bold"
701 ><B
702 CLASS="emphasis"
703 >adduser</B
704 ></SPAN
705 >.</P
706 ></DD
707 ><DT
708 ><SPAN
709 CLASS="bold"
710 ><B
711 CLASS="emphasis"
712 >-user</B
713 ></SPAN
714 ></DT
715 ><DD
716 ><P
717 >Names each user to add to the <SPAN
718 CLASS="bold"
719 ><B
720 CLASS="emphasis"
721 >system:administrators</B
722 ></SPAN
723 > group.</P
724 ></DD
725 ></DL
726 ></DIV
727 ></P
728 ></LI
729 ></OL
730 ></DIV
731 ><DIV
732 CLASS="sect2"
733 ><H2
734 CLASS="sect2"
735 ><A
736 NAME="HDRWQ588"
737 >To remove users from the system:administrators group</A
738 ></H2
739 ><OL
740 TYPE="1"
741 ><LI
742 ><P
743 >Verify that you belong to the <SPAN
744 CLASS="bold"
745 ><B
746 CLASS="emphasis"
747 >system:administrators</B
748 ></SPAN
749 > group. If necessary, issue the
750           <SPAN
751 CLASS="bold"
752 ><B
753 CLASS="emphasis"
754 >pts membership</B
755 ></SPAN
756 > command, which is fully described in <A
757 HREF="c32432.html#HDRWQ587"
758 >To display
759           the members of the system:administrators group</A
760 >. <PRE
761 CLASS="programlisting"
762 >&#13;   % <SPAN
763 CLASS="bold"
764 ><B
765 CLASS="emphasis"
766 >pts membership system:administrators</B
767 ></SPAN
768 >
769 </PRE
770 ></P
771 ></LI
772 ><LI
773 ><P
774 >Issue the <SPAN
775 CLASS="bold"
776 ><B
777 CLASS="emphasis"
778 >pts removeuser</B
779 ></SPAN
780 > command to remove one or more users. <PRE
781 CLASS="programlisting"
782 >&#13;   % <SPAN
783 CLASS="bold"
784 ><B
785 CLASS="emphasis"
786 >pts removeuser -user</B
787 ></SPAN
788 > &#60;<VAR
789 CLASS="replaceable"
790 >user name</VAR
791 >&#62;+ <SPAN
792 CLASS="bold"
793 ><B
794 CLASS="emphasis"
795 >-group system:administrators</B
796 ></SPAN
797 >
798 </PRE
799 ></P
800 ><P
801 >where <DIV
802 CLASS="variablelist"
803 ><DL
804 ><DT
805 ><SPAN
806 CLASS="bold"
807 ><B
808 CLASS="emphasis"
809 >rem</B
810 ></SPAN
811 ></DT
812 ><DD
813 ><P
814 >Is the shortest acceptable abbreviation of <SPAN
815 CLASS="bold"
816 ><B
817 CLASS="emphasis"
818 >removeuser</B
819 ></SPAN
820 >.</P
821 ></DD
822 ><DT
823 ><SPAN
824 CLASS="bold"
825 ><B
826 CLASS="emphasis"
827 >-user</B
828 ></SPAN
829 ></DT
830 ><DD
831 ><P
832 >Names each user to remove from the <SPAN
833 CLASS="bold"
834 ><B
835 CLASS="emphasis"
836 >system:administrators</B
837 ></SPAN
838 > group.</P
839 ></DD
840 ></DL
841 ></DIV
842 ></P
843 ></LI
844 ></OL
845 ></DIV
846 ></DIV
847 ><DIV
848 CLASS="sect1"
849 ><H1
850 CLASS="sect1"
851 ><A
852 NAME="HDRWQ589"
853 >Granting Privilege for kas Commands: the ADMIN Flag</A
854 ></H1
855 ><P
856 >Administrators who have the <SAMP
857 CLASS="computeroutput"
858 >ADMIN</SAMP
859 > flag on their Authentication Database entry can issue
860     all <SPAN
861 CLASS="bold"
862 ><B
863 CLASS="emphasis"
864 >kas</B
865 ></SPAN
866 > commands, which enable them to administer the Authentication Database.   </P
867 ><DIV
868 CLASS="sect2"
869 ><H2
870 CLASS="sect2"
871 ><A
872 NAME="HDRWQ590"
873 >To check if the ADMIN flag is set</A
874 ></H2
875 ><OL
876 TYPE="1"
877 ><LI
878 ><P
879 ><A
880 NAME="LIWQ591"
881 ></A
882 >Issue the <SPAN
883 CLASS="bold"
884 ><B
885 CLASS="emphasis"
886 >kas examine</B
887 ></SPAN
888 > command to display an entry from the
889           Authentication Database.</P
890 ><P
891 >The Authentication Server performs its own authentication rather than accepting your existing AFS token. By default,
892           it authenticates your local (UFS) identity, which possibly does not correspond to an AFS-privileged administrator. Include
893           the <SPAN
894 CLASS="bold"
895 ><B
896 CLASS="emphasis"
897 >-admin_username</B
898 ></SPAN
899 > argument (here abbreviated to <SPAN
900 CLASS="bold"
901 ><B
902 CLASS="emphasis"
903 >-admin</B
904 ></SPAN
905 >) to name a user identity that has the <SAMP
906 CLASS="computeroutput"
907 >ADMIN</SAMP
908 > flag on its
909           Authentication Database entry.</P
910 ><PRE
911 CLASS="programlisting"
912 >&#13;   % <SPAN
913 CLASS="bold"
914 ><B
915 CLASS="emphasis"
916 >kas examine</B
917 ></SPAN
918 > &#60;<VAR
919 CLASS="replaceable"
920 >name of user</VAR
921 >&#62;   \
922                  <SPAN
923 CLASS="bold"
924 ><B
925 CLASS="emphasis"
926 >-admin</B
927 ></SPAN
928 >  &#60;<VAR
929 CLASS="replaceable"
930 >admin principal to use for authentication</VAR
931 >&#62;
932    Administrator's (admin_user) password: &#60;<VAR
933 CLASS="replaceable"
934 >admin_password</VAR
935 >&#62;
936 </PRE
937 ><P
938 >where <DIV
939 CLASS="variablelist"
940 ><DL
941 ><DT
942 ><SPAN
943 CLASS="bold"
944 ><B
945 CLASS="emphasis"
946 >e</B
947 ></SPAN
948 ></DT
949 ><DD
950 ><P
951 >Is the shortest acceptable abbreviation of <SPAN
952 CLASS="bold"
953 ><B
954 CLASS="emphasis"
955 >examine</B
956 ></SPAN
957 >.</P
958 ></DD
959 ><DT
960 ><SPAN
961 CLASS="bold"
962 ><B
963 CLASS="emphasis"
964 >name of user</B
965 ></SPAN
966 ></DT
967 ><DD
968 ><P
969 >Names the entry to display.</P
970 ></DD
971 ><DT
972 ><SPAN
973 CLASS="bold"
974 ><B
975 CLASS="emphasis"
976 >-admin</B
977 ></SPAN
978 ></DT
979 ><DD
980 ><P
981 >Names an administrative account with the <SAMP
982 CLASS="computeroutput"
983 >ADMIN</SAMP
984 > flag on its Authentication
985                   Database entry, such as the <SPAN
986 CLASS="bold"
987 ><B
988 CLASS="emphasis"
989 >admin</B
990 ></SPAN
991 > account. The password prompt echoes it as
992                   admin_user. Enter the appropriate password as admin_password.</P
993 ></DD
994 ></DL
995 ></DIV
996 ></P
997 ></LI
998 ></OL
999 ><P
1000 >If the <SAMP
1001 CLASS="computeroutput"
1002 >ADMIN</SAMP
1003 > flag is turned on, it appears on the first line, as in this
1004       example:</P
1005 ><PRE
1006 CLASS="programlisting"
1007 >&#13;   % <SPAN
1008 CLASS="bold"
1009 ><B
1010 CLASS="emphasis"
1011 >kas e terry -admin admin</B
1012 ></SPAN
1013 >
1014    Administrator's (admin) password: &#60;<VAR
1015 CLASS="replaceable"
1016 >admin_password</VAR
1017 >&#62;
1018    User data for terry (ADMIN)
1019      key version is 0, etc...
1020 </PRE
1021 ></DIV
1022 ><DIV
1023 CLASS="sect2"
1024 ><H2
1025 CLASS="sect2"
1026 ><A
1027 NAME="Header_661"
1028 >To set or remove the ADMIN flag</A
1029 ></H2
1030 ><OL
1031 TYPE="1"
1032 ><LI
1033 ><P
1034 >Issue the <SPAN
1035 CLASS="bold"
1036 ><B
1037 CLASS="emphasis"
1038 >kas setfields</B
1039 ></SPAN
1040 > command to turn on the
1041           <SAMP
1042 CLASS="computeroutput"
1043 >ADMIN</SAMP
1044 > flag in an Authentication Database entry.</P
1045 ><P
1046 >The Authentication Server performs its own authentication rather than accepting your existing AFS token. By default,
1047           it authenticates your local (UNIX) identity, which possibly does not correspond to an AFS-privileged administrator.
1048           Include the <SPAN
1049 CLASS="bold"
1050 ><B
1051 CLASS="emphasis"
1052 >-admin</B
1053 ></SPAN
1054 > argument to name an identity that has the
1055           <SAMP
1056 CLASS="computeroutput"
1057 >ADMIN</SAMP
1058 > flag on its Authentication Database entry. To verify that an entry has the flag,
1059           issue the <SPAN
1060 CLASS="bold"
1061 ><B
1062 CLASS="emphasis"
1063 >kas examine</B
1064 ></SPAN
1065 > command as described in <A
1066 HREF="c32432.html#HDRWQ590"
1067 >To check if the
1068           ADMIN flag is set</A
1069 >.</P
1070 ><P
1071 >The following command appears on two lines only for legibility.</P
1072 ><PRE
1073 CLASS="programlisting"
1074 >&#13;    % <SPAN
1075 CLASS="bold"
1076 ><B
1077 CLASS="emphasis"
1078 >kas setfields</B
1079 ></SPAN
1080 > &#60;<VAR
1081 CLASS="replaceable"
1082 >name of user</VAR
1083 >&#62;  {<SPAN
1084 CLASS="bold"
1085 ><B
1086 CLASS="emphasis"
1087 >ADMIN</B
1088 ></SPAN
1089 > |  <SPAN
1090 CLASS="bold"
1091 ><B
1092 CLASS="emphasis"
1093 >NOADMIN</B
1094 ></SPAN
1095 >} \  
1096                    <SPAN
1097 CLASS="bold"
1098 ><B
1099 CLASS="emphasis"
1100 >-admin</B
1101 ></SPAN
1102 > &#60;<VAR
1103 CLASS="replaceable"
1104 >admin principal to use for authentication</VAR
1105 >&#62;  
1106     Administrator's (admin_user) password: &#60;<VAR
1107 CLASS="replaceable"
1108 >admin_password</VAR
1109 >&#62;
1110 </PRE
1111 ><P
1112 >where <DIV
1113 CLASS="variablelist"
1114 ><DL
1115 ><DT
1116 ><SPAN
1117 CLASS="bold"
1118 ><B
1119 CLASS="emphasis"
1120 >sf</B
1121 ></SPAN
1122 ></DT
1123 ><DD
1124 ><P
1125 >Is an alias for <SPAN
1126 CLASS="bold"
1127 ><B
1128 CLASS="emphasis"
1129 >setfields</B
1130 ></SPAN
1131 > (and <SPAN
1132 CLASS="bold"
1133 ><B
1134 CLASS="emphasis"
1135 >setf</B
1136 ></SPAN
1137 > is the
1138                   shortest acceptable abbreviation).</P
1139 ></DD
1140 ><DT
1141 ><SPAN
1142 CLASS="bold"
1143 ><B
1144 CLASS="emphasis"
1145 >name of user</B
1146 ></SPAN
1147 ></DT
1148 ><DD
1149 ><P
1150 >Names the entry for which to set or remove the <SAMP
1151 CLASS="computeroutput"
1152 >ADMIN</SAMP
1153 > flag.</P
1154 ></DD
1155 ><DT
1156 ><SPAN
1157 CLASS="bold"
1158 ><B
1159 CLASS="emphasis"
1160 >ADMIN | NOADMIN</B
1161 ></SPAN
1162 ></DT
1163 ><DD
1164 ><P
1165 >Sets or removes the <SAMP
1166 CLASS="computeroutput"
1167 >ADMIN</SAMP
1168 > flag, respectively.</P
1169 ></DD
1170 ><DT
1171 ><SPAN
1172 CLASS="bold"
1173 ><B
1174 CLASS="emphasis"
1175 >-admin</B
1176 ></SPAN
1177 ></DT
1178 ><DD
1179 ><P
1180 >Names an administrative account with the <SAMP
1181 CLASS="computeroutput"
1182 >ADMIN</SAMP
1183 > flag on its Authentication
1184                   Database entry, such as the <SPAN
1185 CLASS="bold"
1186 ><B
1187 CLASS="emphasis"
1188 >admin</B
1189 ></SPAN
1190 > account. The password prompt echoes it as
1191                   admin_user. Enter the appropriate password as admin_password.</P
1192 ></DD
1193 ></DL
1194 ></DIV
1195 ></P
1196 ></LI
1197 ></OL
1198 ></DIV
1199 ></DIV
1200 ><DIV
1201 CLASS="sect1"
1202 ><H1
1203 CLASS="sect1"
1204 ><A
1205 NAME="HDRWQ592"
1206 >Administering the UserList File</A
1207 ></H1
1208 ><P
1209 >Inclusion in the file <SPAN
1210 CLASS="bold"
1211 ><B
1212 CLASS="emphasis"
1213 >/usr/afs/etc/UserList</B
1214 ></SPAN
1215 > on the local disk of each AFS server machine
1216     enables an administrator to issue commands from the indicated suites. <UL
1217 ><LI
1218 ><P
1219 >The <SPAN
1220 CLASS="bold"
1221 ><B
1222 CLASS="emphasis"
1223 >bos</B
1224 ></SPAN
1225 > commands enable the administrator to manage server processes and the server
1226           configuration files that define the cell's database server machines, server encryption keys, and privileged users. See
1227           <A
1228 HREF="c3025.html"
1229 >Administering Server Machines</A
1230 > and <A
1231 HREF="c6449.html"
1232 >Monitoring and Controlling
1233           Server Processes</A
1234 >.</P
1235 ></LI
1236 ><LI
1237 ><P
1238 >The <SPAN
1239 CLASS="bold"
1240 ><B
1241 CLASS="emphasis"
1242 >vos</B
1243 ></SPAN
1244 > commands enable the administrator to manage volumes and the Volume Location
1245           Database (VLDB). See <A
1246 HREF="c8420.html"
1247 >Managing Volumes</A
1248 >.</P
1249 ></LI
1250 ><LI
1251 ><P
1252 >The <SPAN
1253 CLASS="bold"
1254 ><B
1255 CLASS="emphasis"
1256 >backup</B
1257 ></SPAN
1258 > commands enable the administrator to use the AFS Backup System to copy
1259           data to permanent storage. See <A
1260 HREF="c12776.html"
1261 >Configuring the AFS Backup System</A
1262 > and <A
1263 HREF="c15383.html"
1264 >Backing Up and Restoring AFS Data</A
1265 >.</P
1266 ></LI
1267 ></UL
1268 ></P
1269 ><P
1270 >Although each AFS server machine maintains a separate copy of the file on its local disk, it is conventional to keep all
1271     copies the same. It can be confusing for an administrator to have the privilege on some machines but not others. </P
1272 ><P
1273 >If your cell runs the United States edition of AFS and uses the Update Server to distribute the contents of the system
1274     control machine's <SPAN
1275 CLASS="bold"
1276 ><B
1277 CLASS="emphasis"
1278 >/usr/afs/etc</B
1279 ></SPAN
1280 > directory, then edit only the copy of the <SPAN
1281 CLASS="bold"
1282 ><B
1283 CLASS="emphasis"
1284 >UserList</B
1285 ></SPAN
1286 > file stored on the system control machine. If you have forgotten which machine is the system
1287     control machine, see <A
1288 HREF="c3025.html#HDRWQ90"
1289 >The Four Roles for File Server Machines</A
1290 >.</P
1291 ><P
1292 >If your cell runs the international edition of AFS, or does not use a system control machine, then you must edit the
1293     <SPAN
1294 CLASS="bold"
1295 ><B
1296 CLASS="emphasis"
1297 >UserList</B
1298 ></SPAN
1299 > file on each server machine individually.</P
1300 ><P
1301 >To avoid making formatting errors that can result in performance problems, never edit the <SPAN
1302 CLASS="bold"
1303 ><B
1304 CLASS="emphasis"
1305 >UserList</B
1306 ></SPAN
1307 > file directly. Instead, use the <SPAN
1308 CLASS="bold"
1309 ><B
1310 CLASS="emphasis"
1311 >bos adduser</B
1312 ></SPAN
1313 > or <SPAN
1314 CLASS="bold"
1315 ><B
1316 CLASS="emphasis"
1317 >bos removeuser</B
1318 ></SPAN
1319 > commands as described in this section.    </P
1320 ><DIV
1321 CLASS="sect2"
1322 ><H2
1323 CLASS="sect2"
1324 ><A
1325 NAME="HDRWQ593"
1326 >To display the users in the UserList file</A
1327 ></H2
1328 ><OL
1329 TYPE="1"
1330 ><LI
1331 ><P
1332 >Issue the <SPAN
1333 CLASS="bold"
1334 ><B
1335 CLASS="emphasis"
1336 >bos listusers</B
1337 ></SPAN
1338 > command to display the contents of the <SPAN
1339 CLASS="bold"
1340 ><B
1341 CLASS="emphasis"
1342 >/usr/afs/etc/UserList</B
1343 ></SPAN
1344 > file. <PRE
1345 CLASS="programlisting"
1346 >&#13;   % <SPAN
1347 CLASS="bold"
1348 ><B
1349 CLASS="emphasis"
1350 >bos listusers</B
1351 ></SPAN
1352 > &#60;<VAR
1353 CLASS="replaceable"
1354 >machine name</VAR
1355 >&#62;
1356 </PRE
1357 ></P
1358 ><P
1359 >where <DIV
1360 CLASS="variablelist"
1361 ><DL
1362 ><DT
1363 ><SPAN
1364 CLASS="bold"
1365 ><B
1366 CLASS="emphasis"
1367 >listu</B
1368 ></SPAN
1369 ></DT
1370 ><DD
1371 ><P
1372 >Is the shortest acceptable abbreviation of <SPAN
1373 CLASS="bold"
1374 ><B
1375 CLASS="emphasis"
1376 >listusers</B
1377 ></SPAN
1378 >.</P
1379 ></DD
1380 ><DT
1381 ><SPAN
1382 CLASS="bold"
1383 ><B
1384 CLASS="emphasis"
1385 >machine name</B
1386 ></SPAN
1387 ></DT
1388 ><DD
1389 ><P
1390 >Names an AFS server machine. In the normal case, any machine is acceptable because the file is the same on
1391                   all of them.</P
1392 ></DD
1393 ></DL
1394 ></DIV
1395 ></P
1396 ></LI
1397 ></OL
1398 ></DIV
1399 ><DIV
1400 CLASS="sect2"
1401 ><H2
1402 CLASS="sect2"
1403 ><A
1404 NAME="HDRWQ594"
1405 >To add users to the UserList file</A
1406 ></H2
1407 ><OL
1408 TYPE="1"
1409 ><LI
1410 ><P
1411 >Verify you are listed in the <SPAN
1412 CLASS="bold"
1413 ><B
1414 CLASS="emphasis"
1415 >/usr/afs/etc/UserList</B
1416 ></SPAN
1417 > file. If not, you must have a
1418           qualified administrator add you before you can add entries to it yourself. If necessary, issue the <SPAN
1419 CLASS="bold"
1420 ><B
1421 CLASS="emphasis"
1422 >bos listusers</B
1423 ></SPAN
1424 > command, which is fully described in <A
1425 HREF="c32432.html#HDRWQ593"
1426 >To display the users in
1427           the UserList file</A
1428 >. <PRE
1429 CLASS="programlisting"
1430 >&#13;   % <SPAN
1431 CLASS="bold"
1432 ><B
1433 CLASS="emphasis"
1434 >bos listusers</B
1435 ></SPAN
1436 > &#60;<VAR
1437 CLASS="replaceable"
1438 >machine name</VAR
1439 >&#62;
1440 </PRE
1441 ></P
1442 ></LI
1443 ><LI
1444 ><P
1445 >Issue the <SPAN
1446 CLASS="bold"
1447 ><B
1448 CLASS="emphasis"
1449 >bos adduser</B
1450 ></SPAN
1451 > command to add one or more users to the <SPAN
1452 CLASS="bold"
1453 ><B
1454 CLASS="emphasis"
1455 >UserList</B
1456 ></SPAN
1457 > file. <PRE
1458 CLASS="programlisting"
1459 >&#13;   % <SPAN
1460 CLASS="bold"
1461 ><B
1462 CLASS="emphasis"
1463 >bos adduser</B
1464 ></SPAN
1465 > &#60;<VAR
1466 CLASS="replaceable"
1467 >machine name</VAR
1468 >&#62; &#60;<VAR
1469 CLASS="replaceable"
1470 >user names</VAR
1471 >&#62;+
1472 </PRE
1473 ></P
1474 ><P
1475 >where <DIV
1476 CLASS="variablelist"
1477 ><DL
1478 ><DT
1479 ><SPAN
1480 CLASS="bold"
1481 ><B
1482 CLASS="emphasis"
1483 >addu</B
1484 ></SPAN
1485 ></DT
1486 ><DD
1487 ><P
1488 >Is the shortest acceptable abbreviation of <SPAN
1489 CLASS="bold"
1490 ><B
1491 CLASS="emphasis"
1492 >adduser</B
1493 ></SPAN
1494 >.</P
1495 ></DD
1496 ><DT
1497 ><SPAN
1498 CLASS="bold"
1499 ><B
1500 CLASS="emphasis"
1501 >machine name</B
1502 ></SPAN
1503 ></DT
1504 ><DD
1505 ><P
1506 >Names the system control machine if you use the Update Server to distribute the contents of the <SPAN
1507 CLASS="bold"
1508 ><B
1509 CLASS="emphasis"
1510 >/usr/afs/etc</B
1511 ></SPAN
1512 > directory (possible only in cells running the United States edition of AFS).
1513                   By default, it can take up to five minutes for the Update Server to distribute the changes, so newly added users
1514                   must wait that long before attempting to issue privileged commands.</P
1515 ><P
1516 >If you are running the international edition of AFS, or do not use the Update Server, repeat the command,
1517                   substituting the name of each AFS server machine for machine name in turn.</P
1518 ></DD
1519 ><DT
1520 ><SPAN
1521 CLASS="bold"
1522 ><B
1523 CLASS="emphasis"
1524 >user names</B
1525 ></SPAN
1526 ></DT
1527 ><DD
1528 ><P
1529 >Specifies the username of each administrator to add to the <SPAN
1530 CLASS="bold"
1531 ><B
1532 CLASS="emphasis"
1533 >UserList</B
1534 ></SPAN
1535 >
1536                   file.</P
1537 ></DD
1538 ></DL
1539 ></DIV
1540 ></P
1541 ></LI
1542 ></OL
1543 ></DIV
1544 ><DIV
1545 CLASS="sect2"
1546 ><H2
1547 CLASS="sect2"
1548 ><A
1549 NAME="Header_665"
1550 >To remove users from the UserList file</A
1551 ></H2
1552 ><OL
1553 TYPE="1"
1554 ><LI
1555 ><P
1556 >Verify you are listed in the <SPAN
1557 CLASS="bold"
1558 ><B
1559 CLASS="emphasis"
1560 >/usr/afs/etc/UserList</B
1561 ></SPAN
1562 > file. If not, you must have a
1563           qualified administrator add you before you can remove entries from it yourself. If necessary, issue the <SPAN
1564 CLASS="bold"
1565 ><B
1566 CLASS="emphasis"
1567 >bos listusers</B
1568 ></SPAN
1569 > command, which is fully described in <A
1570 HREF="c32432.html#HDRWQ593"
1571 >To display the users in
1572           the UserList file</A
1573 >. <PRE
1574 CLASS="programlisting"
1575 >&#13;   % <SPAN
1576 CLASS="bold"
1577 ><B
1578 CLASS="emphasis"
1579 >bos listusers</B
1580 ></SPAN
1581 > &#60;<VAR
1582 CLASS="replaceable"
1583 >machine name</VAR
1584 >&#62;
1585 </PRE
1586 ></P
1587 ></LI
1588 ><LI
1589 ><P
1590 >Issue the <SPAN
1591 CLASS="bold"
1592 ><B
1593 CLASS="emphasis"
1594 >bos removeuser</B
1595 ></SPAN
1596 > command to remove one or more users from the <SPAN
1597 CLASS="bold"
1598 ><B
1599 CLASS="emphasis"
1600 >UserList</B
1601 ></SPAN
1602 > file. <PRE
1603 CLASS="programlisting"
1604 >&#13;   % <SPAN
1605 CLASS="bold"
1606 ><B
1607 CLASS="emphasis"
1608 >bos removeuser</B
1609 ></SPAN
1610 > &#60;<VAR
1611 CLASS="replaceable"
1612 >machine name</VAR
1613 >&#62; &#60;<VAR
1614 CLASS="replaceable"
1615 >user names</VAR
1616 >&#62;+
1617 </PRE
1618 ></P
1619 ><P
1620 >where <DIV
1621 CLASS="variablelist"
1622 ><DL
1623 ><DT
1624 ><SPAN
1625 CLASS="bold"
1626 ><B
1627 CLASS="emphasis"
1628 >removeu</B
1629 ></SPAN
1630 ></DT
1631 ><DD
1632 ><P
1633 >Is the shortest acceptable abbreviation of <SPAN
1634 CLASS="bold"
1635 ><B
1636 CLASS="emphasis"
1637 >removeuser</B
1638 ></SPAN
1639 >.</P
1640 ></DD
1641 ><DT
1642 ><SPAN
1643 CLASS="bold"
1644 ><B
1645 CLASS="emphasis"
1646 >machine name</B
1647 ></SPAN
1648 ></DT
1649 ><DD
1650 ><P
1651 >Names the system control machine if you use the Update Server to distribute the contents of the <SPAN
1652 CLASS="bold"
1653 ><B
1654 CLASS="emphasis"
1655 >/usr/afs/etc</B
1656 ></SPAN
1657 > directory (possible only in cells running the United States edition of AFS).
1658                   By default, it can take up to five minutes for the Update Server to distribute the change, so newly removed users
1659                   can continue to issue privileged commands during that time.</P
1660 ><P
1661 >If you are running the international edition of AFS, or do not use the Update Server, repeat the command,
1662                   substituting the name of each AFS server machine for machine name in turn.</P
1663 ></DD
1664 ><DT
1665 ><SPAN
1666 CLASS="bold"
1667 ><B
1668 CLASS="emphasis"
1669 >user names</B
1670 ></SPAN
1671 ></DT
1672 ><DD
1673 ><P
1674 >Specifies the username of each administrator to add to the <SPAN
1675 CLASS="bold"
1676 ><B
1677 CLASS="emphasis"
1678 >UserList</B
1679 ></SPAN
1680 >
1681                   file.</P
1682 ></DD
1683 ></DL
1684 ></DIV
1685 ></P
1686 ></LI
1687 ></OL
1688 ></DIV
1689 ></DIV
1690 ></DIV
1691 ><DIV
1692 CLASS="NAVFOOTER"
1693 ><HR
1694 ALIGN="LEFT"
1695 WIDTH="100%"><TABLE
1696 SUMMARY="Footer navigation table"
1697 WIDTH="100%"
1698 BORDER="0"
1699 CELLPADDING="0"
1700 CELLSPACING="0"
1701 ><TR
1702 ><TD
1703 WIDTH="33%"
1704 ALIGN="left"
1705 VALIGN="top"
1706 ><A
1707 HREF="c31274.html"
1708 ACCESSKEY="P"
1709 >Prev</A
1710 ></TD
1711 ><TD
1712 WIDTH="34%"
1713 ALIGN="center"
1714 VALIGN="top"
1715 ><A
1716 HREF="book1.html"
1717 ACCESSKEY="H"
1718 >Home</A
1719 ></TD
1720 ><TD
1721 WIDTH="33%"
1722 ALIGN="right"
1723 VALIGN="top"
1724 ><A
1725 HREF="a33047.html"
1726 ACCESSKEY="N"
1727 >Next</A
1728 ></TD
1729 ></TR
1730 ><TR
1731 ><TD
1732 WIDTH="33%"
1733 ALIGN="left"
1734 VALIGN="top"
1735 >Managing Access Control Lists</TD
1736 ><TD
1737 WIDTH="34%"
1738 ALIGN="center"
1739 VALIGN="top"
1740 ><A
1741 HREF="p24911.html"
1742 ACCESSKEY="U"
1743 >Up</A
1744 ></TD
1745 ><TD
1746 WIDTH="33%"
1747 ALIGN="right"
1748 VALIGN="top"
1749 >Managing the NFS/AFS Translator</TD
1750 ></TR
1751 ></TABLE
1752 ></DIV
1753 ></BODY
1754 ></HTML
1755 >