The Univa Grid Engine 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 direc-
tories mounted under different paths on different hosts) and to ensure
that Univa Grid Engine is able to locate the appropriate working direc-
tories for executing batch jobs.
There is a system global path aliasing file and a user local file.
sge_aliases defines the format of both:
o Blank lines and lines with a '#' sign in the first column are
o Each line other than a blank line or a line lead by '#' has to con-
tain four strings separated by any number of blanks or tabs.
o The first string specifies a source-path, the second a submit-host,
the third an execution-host and the fourth the source-path replace-
o Both the submit- and the execution-host entries may consist of only
a '*' sign which matches any host.
If the -cwd flag (and only if - otherwise the user's home directory on
the execution host is selected to execute the job) to qsub(1) was spec-
ified, the path aliasing mechanism is activated and the files are pro-
cessed as follows:
o After 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.
o 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 neces-
o A translation is stored only if the submit-host entry matches the
host 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.
o As soon as both files are read the stored path aliasing information
is passed along with the submitted job.
o 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. Note: The current working
directory string will be changed in this case and subsequent path
aliases must match the replaced working directory path to be
global aliases file
$HOME/.sge_aliases user local aliases file
sge_intro(1), qsub(1), Univa Grid Engine Installation and Administra-
See sge_intro(1) for a full statement of rights and permissions.
UGE 8.0.0 $Date: 2004/04/19 10:52:09 $ SGE_ALIASES(5)
Man(1) output converted with