1JANITOR(8)             NorduGrid System Managers Manual             JANITOR(8)
2
3
4

NAME

6       janitor - ARC Dynamic Runtime Environment Maintenance
7

SYNOPSIS

9       janitor [COMMAND] [JOB-ID] [RTE]...
10

DESCRIPTION

12       A  core  problem  for  grid  computing  is  to  provide  a large set of
13       libraries across all contributing sites. In order to do so, an  automa‐
14       tion of the software installation, referred to as dynamic Runtime Envi‐
15       ronments, is a suitable solution to get the computational grid  to  its
16       full  potential.  Janitor is a tool providing a dynamical installation,
17       deinstallation and maintenance of supporting libraries for jobs running
18       in the grid.
19

COMMANDS

21       register
22              Registers a job and a set of runtime environments in the Janitor
23              database. Requires [JOB-ID] and a list of [RTE]s
24
25       deploy Downloads  and  installs  the  desired   runtime   environments.
26              Requires an already registered [JOB-ID].
27
28       remove Removes  the placeholder of the job on the runtime environments.
29              If no more jobs are using the runtime environment and the  life‐
30              span  of  the  runtime  environment  has be expired, the runtime
31              environment can be removed using the sweep command. Requires  an
32              existing [JOB-ID] to be removed.
33
34       sweep  Removes  unused  runtime environments. No further arguements are
35              required. Using  the  additional  option  --force  enforces  the
36              removal  of  all  unused  runtime environments and expired jobs.
37              Runtime  environments  having  the  state  FAILED  will  not  be
38              removed.
39
40       setstate
41              Changes  the  state  of a dynamically installed runtime environ‐
42              ment. This might be useful in case a runtime environment with  a
43              state  FAILED shall be removed (new state might be REMOVAL_PEND‐
44              ING). Requires a [STATE] followd by a list of [RTE]s.
45
46       search Performs a  simple  search  in  the  catalog  and  the  manually
47              installed  runtime  environments (see runtimedir of the arc con‐
48              figuration file). Requires a list of string to be  searched  for
49              (no [JOB-ID] nor [RTE]s).
50
51       list   Lists  all  information about jobs, automatically installed run‐
52              time environments and manually installed  runtime  environments.
53              No  additional parameters have to be passed.  The command may be
54              followed by modifiers:
55
56              shortlist for printing short machine-readable output.
57
58              jobs only jobs are printed
59
60              local local manually installed runtime environments are listed
61
62              installed shows information about automatically  installed  run‐
63              time environments
64
65              installable  shows  information  about automatically installable
66              runtime environments
67
68              dynamic same as installed and installable
69
70              rtes information about all  kinds  of  runtime  environments  is
71              printed
72
73              all prints information about all components
74
75       info   Renders  information  about  a job. Requires the parameter [JOB-
76              ID].
77
78       [JOB-ID]
79              A unique sequence of digits. Once Janitor registered a  job  id,
80              it cannot register a second job having the same job id.
81
82       [RTE]  Runtime  environments  are  defined  by a continuous string. The
83              name of valid runtime  environment  names  can  be  investigated
84              using  the  list or the search commands. They are defined in the
85              catalog or by the directories and scripts of the  runtimedir  of
86              the exttt{grid-manager}.
87

EXIT STATUS

89       register
90
91              0      Registration was successful. No noteworthy occurrences.
92
93              1      Registration was successful but some runtime environments
94                     aren't installed yet. Deploy is mandatory.
95
96              2      An error occured.
97
98       deploy
99
100              0      Sucessfully initialized job.
101
102              1      Can't provide requested runtime environments.
103
104       remove
105
106              0      Sucessfully removed job or no such job.
107
108              1      Can't provide requested runtime environments.
109
110       sweep
111
112              0      Always returns this exit code.
113
114       setstate
115
116              0      Changing the state was successful.
117
118              1      Can not change the state.
119
120       search
121
122              0      Search sucessfully finished.
123
124       list
125
126              0      Successfully retrieved information.
127
128       info
129
130              0      Successfully retrieved job information.
131
132              1      No such job.
133
134              2      Error while retrieving job information.
135

REPORTING BUGS

137       Report bugs to http://bugzilla.nordugrid.org/
138

140       APACHE LICENSE Version 2.0
141

AUTHOR

143       Steffen Moeller <steffen_moeller@gmx.de>
144
145
146
147NorduGrid ARC 1.1.0                May 2009                         JANITOR(8)
Impressum