NAME
janitor - ARC Dynamic Runtime Environment Maintenance
SYNOPSIS
janitor [COMMAND] [JOB-ID] [RTE]...
DESCRIPTION
A core problem for grid computing is to provide a large set of
libraries across all contributing sites. In order to do so, an
automation of the software installation, referred to as dynamic Runtime
Environments, is a suitable solution to get the computational grid to
its full potential. Janitor is a tool providing a dynamical
installation, deinstallation and maintenance of supporting libraries
for jobs running in the grid.
COMMANDS
register
Registers a job and a set of runtime environments in the Janitor
database. Requires [JOB-ID] and a list of [RTE]s
deploy Downloads and installs the desired runtime environments.
Requires an already registered [JOB-ID].
remove Removes the placeholder of the job on the runtime environments.
If no more jobs are using the runtime environment and the
lifespan of the runtime environment has be expired, the runtime
environment can be removed using the sweep command. Requires an
existing [JOB-ID] to be removed.
sweep Removes unused runtime environments. No further arguements are
required. Using the additional option --force enforces the
removal of all unused runtime environments and expired jobs.
Runtime environments having the state FAILED will not be
removed.
setstate
Changes the state of a dynamically installed runtime
environment. This might be useful in case a runtime environment
with a state FAILED shall be removed (new state might be
REMOVAL_PENDING). Requires a [STATE] followd by a list of
[RTE]s.
search Performs a simple search in the catalog and the manually
installed runtime environments (see runtimedir of the arc
configuration file). Requires a list of string to be searched
for (no [JOB-ID] nor [RTE]s).
list Lists all information about jobs, automatically installed
runtime environments and manually installed runtime
environments. No additional parameters have to be passed. The
command may be followed by modifiers:
shortlist for printing short machine-readable output.
jobs only jobs are printed
local local manually installed runtime environments are listed
installed shows information about automatically installed
runtime environments
installable shows information about automatically installable
runtime environments
dynamic same as installed and installable
rtes information about all kinds of runtime environments is
printed
all prints information about all components
info Renders information about a job. Requires the parameter [JOB-
ID].
[JOB-ID]
A unique sequence of digits. Once Janitor registered a job id,
it cannot register a second job having the same job id.
[RTE] Runtime environments are defined by a continuous string. The
name of valid runtime environment names can be investigated
using the list or the search commands. They are defined in the
catalog or by the directories and scripts of the runtimedir of
the exttt{grid-manager}.
EXIT STATUS
register
0 Registration was successful. No noteworthy occurrences.
1 Registration was successful but some runtime environments
aren’t installed yet. Deploy is mandatory.
2 An error occured.
deploy
0 Sucessfully initialized job.
1 Can’t provide requested runtime environments.
remove
0 Sucessfully removed job or no such job.
1 Can’t provide requested runtime environments.
sweep
0 Always returns this exit code.
setstate
0 Changing the state was successful.
1 Can not change the state.
search
0 Search sucessfully finished.
list
0 Successfully retrieved information.
info
0 Successfully retrieved job information.
1 No such job.
2 Error while retrieving job information.
REPORTING BUGS
Report bugs to http://bugzilla.nordugrid.org/
COPYRIGHT
APACHE LICENSE Version 2.0
AUTHOR
Steffen Moeller <steffen_moeller@gmx.de>