Man Linux: Main Page and Category List

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>