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.