RATSADMIN Details


"Ratsadmin" is the main RATS tool, though some can argue that the cgi account creation tool  is the primary tool.  Ratsadmin is meant to be used by system administrators only and so far it is the only CLI tool avaible for RATS.

With no arguments , ratsadmin will prompt the user for account information, personal information for the user to be created, and procced  create the account.  The account type must be one of the account types defined in the config file.  Users can be identified by IID, SSN, or USERNAME.  The admin would be expected to lookup this information in the PDB if necessary.   Note that the admin mode of the ratsadmin does not perform and roster, role, or campus validation of the user.  This means that if the selected account type requires that the target user be in some role or some class, this tool will ignore the requierment.  Further more, ratsadmin will not attempt to set the email address in the PDB unless the "-e" switch has been specified or set a kerberos password unless the "-k" switch was used.

To make things easier, the account type and the user information can be specified on the command line option as well.  A "-a" switch can specify the account type, and "-i", "-s", and "-U" can specify IID, SSN, or USERNAME.  Only one of the identifcation switches should be used.   In this mode, ratsadmin can be used as a bulk account creation tool. Also a password can be specified with the "-p" flag and the GCOS field can be overwritten with the "-g" flag.
 

Lastly, account can be removed completly using "ratsadmin -r <username>".  Note that this does not currently support removal of a account type from the user while leaving the others in place. This is scheduled for version 2.

For more info on the internal functioning of this tools please read Client Internels doc.

The usage is described bellow.  Note that currently the "-n", "-v",  and "-q" switches are noops.  The "-D" switch  produces ridiculos ammounts of logs which are sent to the log host defined in the config file.
 
 

usage ratsadmin [-n] [-q] [-D] [-v] -r <username>
      ratsadmin [-n] [-q] [-D] [-v] [-a] [-g] [-i<iid>] [-s<ssn>] [-U<username>]
where:  -g <gcos> to overide default
        -a account type
        -i <iid> 
        -s <ssn> 
        -U <username> 
        -r <user> remove user
        -n do nothing
        -v verbose
        -q quiet    
        -k do kerberos
        -e set email in PDB
        -p <pass> use password as user password if new account
        -D debug. This creates verbose log messages