sgepasswd.1

NAME

       sgepasswd - Modify the Grid Engine password file of Grid Engine

SYNTAX

       sgepasswd [[ -D domain ] -d user ]

       sgepasswd [ -D domain ] [ user ]

DESCRIPTION

       sgepasswd modifies the Grid Engine password file sgepasswd(5).

       This file contains a list of usernames and their Microsoft Windows
       password in encrypted form.  sge_execd(8) and sge_shepherd(8) on hosts
       running Microsoft Windows as operating systems use this information to
       start jobs for a certain user.

       Each user can use the sgepasswd application to add a new entry for
       their own user account.  (In fact, normal users can create an entry for
       any account, so the entry should be made initially, when the account is
       created.)  It is also possible to change the stored password with
       sgepasswd if the user knows the old one.

       The root user additionally has permission to change the password
       entries for other user accounts. Root can also delete existing entries.

       The sgepasswd binary is only available on non-Windows hosts.

OPTIONS

       -D domain
              By default sgepasswd will add/modify the current Unix username
              without a domain specification.  This switch can be used to add
              a domain specification in front of the current user name.
              Consult your Microsoft Windows documentation to get more
              information about domain users.

       -d user
              Only root can use this parameter to delete entries from the
              sgepasswd(5) file.

       -help  Prints a listing of all options.

NOTE

       Prevent relevant jobs running before a password is changed both with
       sgepasswd and in the Windows domain.  Otherwise, if multiple jobs try
       to run on a Windows host as the user concerned, and are unable to
       access the right password, Windows' intrusion detection system may
       disable the account.  sgepasswd and in the Windows domain.

SECURITY

       This is a non-trivial program which needs to be setuid root, operating
       with various user-supplied input.  It probably shouldn't be installed
       setuid if it is not needed to support Windows hosts.

       See above concerning making initial entries.

ENVIRONMENT VARIABLES

       SGE_CERTFILE   Specifies the location of the public key file. By
                      default sgepasswd will use
                      $SGE_ROOT/$SGE_CELL/common/sgeCA/certs/cert.pem.

       SGE_KEYFILE    If set, specifies the location of the private key file.
                      Default is
                      /var/lib/sgeCA/port$SGE_QMASTER_PORT/$SGE_CELL/private/key.pem.

       SGE_RANDFILE   If set, specifies the location of the seed used to
                      create encrypted versions of user passwords. Default is
                      /var/lib/sgeCA/port${SGE_QMASTER_PORT}/${SGE_CELL}/private/rand.seed.

SEE ALSO

       sge_intro(1), sgepasswd(5)

COPYRIGHT

       See sge_intro(1) for a full statement of rights and permissions.



SGE 8.1.3pre                      2012-02-17                     SGE_PASSWD(1)