Provided by: gridengine-common_6.2~beta2-2_all bug

NAME

       usermapping - user mapping entry file format

DESCRIPTION

       A  usermapping  entry is used to define alias names for a cluster user.
       The user’s name known by the scheduling system is known as the  cluster
       user.  If  the  cluster  user doesn’t match the user account name on an
       execution host, the usermapping feature can solve the problem.

       Each line in the usermapping entry file specifies a user name  and  the
       host(s) where he has an account.

       A  list  of  currently configured user mapping entries can be displayed
       via the qconf(1) -sumapl option. The contents  of  each  enlisted  user
       mapping  entry  can  be shown via the -sumap switch. The output follows
       the usermapping format description. New user entries can be created and
       existing  can  be modified via the -aumap, -mumap and -dumap options to
       qconf(1).

FORMAT

       A user mapping entry contains two parameters:

   cluster_user
       The cluster_user keyword defines the cluster user name. The rest of the
       textline after the keyword "cluster_user" will be taken as cluster user
       value.

   remote_user
       The user name on an execution host. Please note that the value for this
       attribute might be overwritten for a certain hostgroups or single host.
       Find an example below.

EXAMPLE

       This is a typical user mapping entry for a cluster user mapping:

       cluster_user   peter

       remote_user    peter,[@linux=pet1],[fangorn=peter1]

       The entry will map the user peter  which  is  defined  in  the  cluster
       system  to  the  user  peter on all hosts in the cluster except for all
       hosts which are referenced in the hostgroup @linux. For all these hosts
       the  user  will be mapped to pet1. For the host fangorn the remote user
       will be peter1.  hostgroup(5) to  obtain  for  more  information  about
       that.

SEE ALSO

       qconf(1), hostgroup(5).

COPYRIGHT

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

                                    $Date$                      USERMAPPING(5)