Provided by: nordugrid-arc-janitor_1.1.1-1_amd64 bug

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>