← Back to branch summary

~ubuntu-branches/ubuntu/utopic/gridengine/utopic

« back to all changes in this revision

Viewing changes to doc/htmlman/htmlman5/usermapping.html

  • Committer: Bazaar Package Importer
  • Author(s): Mark Hymers
  • Date: 2008-06-25 22:36:13 UTC
  • Revision ID: james.westby@ubuntu.com-20080625223613-tvd9xlhuoct9kyhm
Tags: upstream-6.2~beta2
Import upstream version 6.2~beta2

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/htmlman/htmlman5/usermapping.html
 
1
<HTML>
 
2
<BODY BGCOLOR=white>
 
3
<PRE>
 
4
<!-- Manpage converted by man2html 3.0.1 -->
 
5
NAME
 
6
     usermapping - user mapping entry file format
 
7
 
 
8
DESCRIPTION
 
9
     A usermapping entry is used to  define  alias  names  for  a
 
10
     cluster user. The user's name known by the scheduling system
 
11
     is known as the cluster user. If the  cluster  user  doesn't
 
12
     match  the user account name on an execution host, the user-
 
13
     mapping feature can solve the problem.
 
14
 
 
15
     Each line in the usermapping entry  file  specifies  a  user
 
16
     name and the host(s) where he has an account.
 
17
 
 
18
     A list of currently configured user mapping entries  can  be
 
19
     displayed  via  the <B><A HREF="../htmlman1/qconf.html">qconf(1)</A></B> -sumapl option. The contents of
 
20
     each enlisted user mapping entry can be shown via the -sumap
 
21
     switch.  The  output follows the <I>usermapping</I> format descrip-
 
22
     tion. New user entries can be created and  existing  can  be
 
23
     modified  via  the  -aumap,  -mumap  and  -dumap  options to
 
24
     <B><A HREF="../htmlman1/qconf.html">qconf(1)</A></B>.
 
25
 
 
26
FORMAT
 
27
     A user mapping entry contains two parameters:
 
28
 
 
29
  cluster_user
 
30
     The cluster_user keyword defines the cluster user name.  The
 
31
     rest  of  the textline after the keyword "cluster_user" will
 
32
     be taken as cluster user value.
 
33
 
 
34
 
 
35
  remote_user
 
36
     The user name on an execution host.  Please  note  that  the
 
37
     value  for this attribute might be overwritten for a certain
 
38
     hostgroups or single host.  Find an example below.
 
39
 
 
40
 
 
41
 
 
42
EXAMPLE
 
43
     This is a typical user mapping entry for a cluster user map-
 
44
     ping:
 
45
 
 
46
 
 
47
     cluster_user   peter
 
48
 
 
49
     remote_user    peter,[@linux=pet1],[fangorn=peter1]
 
50
 
 
51
     The entry will map the user peter which is  defined  in  the
 
52
     cluster system to the user peter on all hosts in the cluster
 
53
     except for all hosts which are referenced in  the  hostgroup
 
54
     @linux. For all these hosts the user will be mapped to pet1.
 
55
     For the host fangorn the remote user will be peter1.   <I>host-</I>
 
56
     <B><A HREF="../htmlman5/group.html">group(5)</A></B> to obtain for more information about that.
 
57
 
 
58
SEE ALSO
 
59
     <B><A HREF="../htmlman1/qconf.html">qconf(1)</A></B>, <B><A HREF="../htmlman5/hostgroup.html">hostgroup(5)</A></B>.
 
60
 
 
61
COPYRIGHT
 
62
     See <B><A HREF="../htmlman1/sge_intro.html">sge_intro(1)</A></B> for a full statement of rights and  permis-
 
63
     sions.
 
64
 
 
65
 
 
66
 
 
67
 
 
68
 
 
69
 
 
70
 
 
71
 
 
72
 
 
73
 
 
74
 
 
75
 
 
76
 
 
77
 
 
78
 
 
79
 
 
80
 
 
81
 
 
82
 
 
83
 
 
84
 
 
85
 
 
86
 
 
87
 
 
88
 
 
89
 
 
90
 
 
91
 
 
92
 
 
93
 
 
94
 
 
95
 
 
96
 
 
97
 
 
98
 
 
99
 
 
100
 
 
101
 
 
102
 
 
103
 
 
104
 
 
105
 
 
106
 
 
107
 
 
108
 
 
109
 
 
110
</PRE>
 
111
<HR>
 
112
<ADDRESS>
 
113
Man(1) output converted with
 
114
<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
 
115
</ADDRESS>
 
116
</BODY>
 
117
</HTML>