doc/html/AdminReference/auarf242.htm

   1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
   2 <HTML><HEAD>
   3 <TITLE>Administration Reference</TITLE>
   4 <!-- Begin Header Records  ========================================== -->
   5 <!-- /tmp/idwt3672/auarf000.scr converted by idb2h R4.2 (359) ID      -->
   6 <!-- Workbench Version (AIX) on 3 Oct 2000 at 16:18:30                -->
   7 <META HTTP-EQUIV="updated" CONTENT="Tue, 03 Oct 2000 16:18:29">
   8 <META HTTP-EQUIV="review" CONTENT="Wed, 03 Oct 2001 16:18:29">
   9 <META HTTP-EQUIV="expires" CONTENT="Thu, 03 Oct 2002 16:18:29">
  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 Reference</H1>
  16 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf241.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="auarf243.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
  17 <P>
  18 <H2><A NAME="HDRUSS_INTRO" HREF="auarf002.htm#ToC_256">uss</A></H2>
  19 <A NAME="IDX5508"></A>
  20 <A NAME="IDX5509"></A>
  21 <A NAME="IDX5510"></A>
  22 <A NAME="IDX5511"></A>
  23 <A NAME="IDX5512"></A>
  24 <A NAME="IDX5513"></A>
  25 <A NAME="IDX5514"></A>
  26 <A NAME="IDX5515"></A>
  27 <A NAME="IDX5516"></A>
  28 <P><STRONG>Purpose</STRONG>
  29 <P>Introduction to the <B>uss</B> command suite
  30 <P><STRONG>Description</STRONG>
  31 <P>The commands in the <B>uss</B> command suite help administrators to
  32 create AFS user accounts more easily and efficiently. If <B>uss</B>
  33 commands are not used, creating an account requires issuing at least six
  34 separate commands to five different AFS servers.
  35 <P>There are three main commands in the suite:
  36 <UL>
  37 <P><LI>The <B>uss add</B> command creates a single complete user account,
  38 based on command line arguments and instructions in a template file.
  39 <P><LI>The <B>uss bulk</B> command creates multiple complete accounts at
  40 once, based on command line arguments, instructions in a template file and a
  41 bulk input file.
  42 <P><LI>the <B>uss delete</B> command removes most parts of a user
  43 account.
  44 </UL>
  45 <P>To obtain help, issue the <B>uss apropos</B> and <B>uss help</B>
  46 commands.
  47 <P><STRONG>Options</STRONG>
  48 <P>The following arguments and flags are available on many commands in the
  49 <B>uss</B> suite. The reference page for each command also lists
  50 them, but they are described here in greater detail.
  51 <DL>
  52 <P><DT><B>-admin &lt;<VAR>administrator to authenticate</VAR>>
  53 </B><DD>Specifies the AFS user name under which to establish a connection to the
  54 AFS server processes that administer the various parts of a user
  55 account. If it is omitted, the connection is established under the
  56 issuer's effective user ID (his or her identity in the local file
  57 system). Even when this argument is included, UNIX commands that run
  58 during the <B>uss</B> operation (for instance, the UNIX
  59 <B>/etc/chown</B> command) run under the effective user ID.
  60 <P><DT><B>-cell &lt;<VAR>cell name</VAR>>
  61 </B><DD>Names the cell in which to run the command. It is acceptable to
  62 abbreviate the cell name to the shortest form that distinguishes it from the
  63 other entries in the <B>/usr/vice/etc/CellServDB</B> file on the local
  64 machine. If the <B>-cell</B> argument is omitted, the command
  65 interpreter determines the name of the local cell by reading the following in
  66 order:
  67 <OL TYPE=1>
  68 <P><LI>The value of the AFSCELL environment variable
  69 <P><LI>The local <B>/usr/vice/etc/ThisCell</B> file
  70 </OL>
  71 <P><DT><B>-dryrun
  72 </B><DD>Reports actions that the command interpreter needs to perform when
  73 executing the <B>uss</B> operation, without actually performing
  74 them. Include this flag to verify that the command produces the desired
  75 account configuration. Combine it with the <B>-verbose</B> flag to
  76 yield even more detailed information. Note that the output does not
  77 necessarily reveal all possible problems that can prevent successful execution
  78 of the command, especially those that result from transient server or network
  79 outages.
  80 <P><DT><B>-help
  81 </B><DD>Prints a command's online help message on the standard output
  82 stream. Do not combine this flag with any of the command's other
  83 options; when it is provided, the command interpreter ignores all other
  84 options, and only prints the help message.
  85 <P><DT><B>-skipauth
  86 </B><DD>Bypasses mutual authentication with the AFS Authentication Server,
  87 allowing a site that uses Kerberos instead of the AFS Authentication Server to
  88 substitute that form of authentication.
  89 </DL>
  90 <P><STRONG>Privilege Required</STRONG>
  91 <P>The issuer of a <B>uss</B> command must have all the rights required
  92 for performing the equivalent actions individually. See each
  93 <B>uss</B> command's reference page.
  94 <P><STRONG>Related Information</STRONG>
  95 <P><A HREF="auarf054.htm#HDRUSSBULKINPUT">uss Bulk Input File</A>
  96 <P><A HREF="auarf055.htm#HDRUSSFILE">uss Template File</A>
  97 <P><A HREF="auarf243.htm#HDRUSS_ADD">uss add</A>
  98 <P><A HREF="auarf244.htm#HDRUSS_APROPOS">uss apropos</A>
  99 <P><A HREF="auarf245.htm#HDRUSS_BULK">uss bulk</A>
 100 <P><A HREF="auarf246.htm#HDRUSS_DELETE">uss delete</A>
 101 <P><A HREF="auarf247.htm#HDRUSS_HELP">uss help</A>
 102 <P>
 103 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf241.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="auarf243.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
 104 <!-- Begin Footer Records  ========================================== -->
 105 <P><HR><B>
 106 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 107 </B>
 108 <!-- End Footer Records  ============================================ -->
 109 <A NAME="Bot_Of_Page"></A>
 110 </BODY></HTML>