File: sge_aliases.5

package info (click to toggle)
gridengine 6.2-4
  • links: PTS, VCS
  • area: main
  • in suites: lenny
  • size: 51,532 kB
  • ctags: 51,172
  • sloc: ansic: 418,155; java: 37,080; sh: 22,593; jsp: 7,699; makefile: 5,292; csh: 4,244; xml: 2,901; cpp: 2,086; perl: 1,895; tcl: 1,188; lisp: 669; ruby: 642; yacc: 393; lex: 266
file content (158 lines) | stat: -rw-r--r-- 4,280 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
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
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
'\" t
.\"___INFO__MARK_BEGIN__
.\"
.\" Copyright: 2004 by Sun Microsystems, Inc.
.\"
.\"___INFO__MARK_END__
.\"
.\" $RCSfile$     Last Update: $Date$     Revision: $Revision$
.\"
.\" Some handy macro definitions [from Tom Christensen's man(1) manual page].
.\"
.de SB		\" small and bold
.if !"\\$1"" \\s-2\\fB\&\\$1\\s0\\fR\\$2 \\$3 \\$4 \\$5
..
.\"
.de T		\" switch to typewriter font
.ft CW		\" probably want CW if you don't have TA font
..
.\"
.de TY		\" put $1 in typewriter font
.if t .T
.if n ``\c
\\$1\c
.if t .ft P
.if n \&''\c
\\$2
..
.\"
.de M		\" man page reference
\\fI\\$1\\fR\\|(\\$2)\\$3
..
.TH xxQS_NAME_Sxx_ALIASES 5 "$Date$" "xxRELxx" "xxQS_NAMExx File Formats"
.\"
.SH NAME
xxqs_name_sxx_aliases \- xxQS_NAMExx path aliases file format
.\"
.\"
.SH DESCRIPTION
The xxQS_NAMExx path aliasing facility provides administrators and users with
the means to reflect complicated and in-homogeneous file system structures
in distributed environments (such as user home directories mounted under
different paths on different hosts) and to ensure that xxQS_NAMExx is able to
locate the appropriate working directories for executing batch jobs.
.PP
There is a system global path aliasing file and a user local file.
.I xxqs_name_sxx_aliases
defines the format of both:
.\"
.\"
.\"
.IP "\(bu" 3n
Blank lines and lines with a '#' sign in the first column are skipped.
.\"
.\"
.IP "\(bu" 3n
Each line other than a blank line or a line lead by '#' has to contain
four strings separated by any number of blanks or tabs.
.\"
.\"
.IP "\(bu" 3n
The first string specifies a source-path, the second a submit-host, the
third an execution-host and the fourth the source-path replacement.
.\"
.\"
.IP "\(bu" 3n
Both the submit- and the execution-host entries may consist of only a '*' 
sign which matches any host.
.PP
.\"
.\"
If the \fI-cwd\fP flag (and only if \- otherwise the user's
home directory on the execution host is selected to execute the job) to
.M qsub 1
was specified, the path aliasing mechanism is activated and the files are
processed as follows:
.\"
.\"
.IP "\(bu" 3n
After
.M qsub 1
has retrieved the physical current working directory path,
the cluster global path aliasing file is read if present. The user path
aliases file is read afterwards as if it were appended to the global
file.
.\"
.\"
.IP "\(bu" 3n
Lines not to be skipped are read from the top of the file one by one
while the translations specified by those lines are stored if
necessary.
.\"
.\"
.IP "\(bu" 3n
A translation is stored only if the submit-host entry matches the host
.M qsub 1
is executed on and if the source-path forms the initial part
either of the current working directory or of the source-path
replacements already stored.
.\"
.\"
.IP "\(bu" 3n
As soon as both files are read the stored path aliasing information is
passed along with the submitted job.
.\"
.\"
.IP "\(bu" 3n
On the execution host, the aliasing information will be evaluated. The
leading part of the current working directory will be replaced by the
source-path replacement if the execution-host entry of the path alias
matches the executing host. \fBNote:\fP The current working directory
string will be changed in this case and subsequent path aliases
must match the replaced working directory path to be applied.
.\"
.\"
.\"
.SH "EXAMPLES"
.PP
The following is a simple example of a path aliasing file resolving
problems with in-homogeneous paths if
.M automount 8
is used:
.PP
.nf

=====================================================
# Path Aliasing File
# src-path   sub-host   exec-host   replacement
/tmp_mnt/    *          *           /
# replaces any occurrence of /tmp_mnt/ by /
# if submitting or executing on any host.
# Thus paths on nfs server and clients are the same
=====================================================

.fi
.PP
.\"
.\"
.\"
.SH "FILES"
.nf
.ta \w'<xxqs_name_sxx_root>/   'u
\fI<xxqs_name_sxx_root>/<cell>/common/xxqs_name_sxx_aliases\fP
	global aliases file
.ta \w'$HOME/.xxqs_name_sxx_aliases   'u
\fI$HOME/.xxqs_name_sxx_aliases\fP	user local aliases file
.fi
.\"
.\"
.\"
.SH "SEE ALSO"
.M xxqs_name_sxx_intro 1 ,
.M qsub 1 ,
.I xxQS_NAMExx Installation and Administration Guide
.\"
.SH "COPYRIGHT"
See
.M xxqs_name_sxx_intro 1
for a full statement of rights and permissions.