3334 |
14 May 07 |
nicklas |
1 |
<?xml version="1.0" encoding="UTF-8"?> |
3334 |
14 May 07 |
nicklas |
2 |
<!DOCTYPE appendix PUBLIC |
3334 |
14 May 07 |
nicklas |
3 |
"-//Dawid Weiss//DTD DocBook V3.1-Based Extension for XML and graphics inclusion//EN" |
3334 |
14 May 07 |
nicklas |
4 |
"../../../../lib/docbook/preprocess/dweiss-docbook-extensions.dtd"> |
3334 |
14 May 07 |
nicklas |
5 |
<!-- |
3334 |
14 May 07 |
nicklas |
$Id$ |
3334 |
14 May 07 |
nicklas |
7 |
|
4889 |
06 Apr 09 |
nicklas |
Copyright (C) 2007 Jari Häkkinen, Peter Johansson, Nicklas Nordborg |
3334 |
14 May 07 |
nicklas |
9 |
|
3334 |
14 May 07 |
nicklas |
This file is part of BASE - BioArray Software Environment. |
3334 |
14 May 07 |
nicklas |
Available at http://base.thep.lu.se/ |
3334 |
14 May 07 |
nicklas |
12 |
|
3334 |
14 May 07 |
nicklas |
BASE is free software; you can redistribute it and/or |
3334 |
14 May 07 |
nicklas |
modify it under the terms of the GNU General Public License |
4477 |
05 Sep 08 |
jari |
as published by the Free Software Foundation; either version 3 |
3334 |
14 May 07 |
nicklas |
of the License, or (at your option) any later version. |
3334 |
14 May 07 |
nicklas |
17 |
|
3334 |
14 May 07 |
nicklas |
BASE is distributed in the hope that it will be useful, |
3334 |
14 May 07 |
nicklas |
but WITHOUT ANY WARRANTY; without even the implied warranty of |
3334 |
14 May 07 |
nicklas |
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
3334 |
14 May 07 |
nicklas |
GNU General Public License for more details. |
3334 |
14 May 07 |
nicklas |
22 |
|
3334 |
14 May 07 |
nicklas |
You should have received a copy of the GNU General Public License |
4509 |
11 Sep 08 |
jari |
along with BASE. If not, see <http://www.gnu.org/licenses/>. |
3334 |
14 May 07 |
nicklas |
25 |
--> |
3334 |
14 May 07 |
nicklas |
26 |
|
3334 |
14 May 07 |
nicklas |
27 |
<appendix id="appendix.jobagent.sh"> |
5782 |
04 Oct 11 |
nicklas |
28 |
<?dbhtml filename="jobagent.sh.html" ?> |
3334 |
14 May 07 |
nicklas |
29 |
<title>jobagent.sh reference</title> |
3334 |
14 May 07 |
nicklas |
30 |
|
3334 |
14 May 07 |
nicklas |
31 |
<para> |
3376 |
24 May 07 |
nicklas |
32 |
The <filename>jobagent.sh</filename> (or <filename>jobagent.bat</filename> on |
3411 |
30 May 07 |
jari |
33 |
Windows) is a command-line utility for controlling the job agent. |
3376 |
24 May 07 |
nicklas |
34 |
The syntax is: |
3376 |
24 May 07 |
nicklas |
35 |
|
3376 |
24 May 07 |
nicklas |
36 |
<informalexample> |
3376 |
24 May 07 |
nicklas |
37 |
<programlisting> |
3376 |
24 May 07 |
nicklas |
38 |
./jobagent.sh [options] command |
3376 |
24 May 07 |
nicklas |
39 |
</programlisting> |
3376 |
24 May 07 |
nicklas |
40 |
</informalexample> |
3376 |
24 May 07 |
nicklas |
41 |
|
3376 |
24 May 07 |
nicklas |
42 |
The options are optional, but a <command>command</command> |
3376 |
24 May 07 |
nicklas |
43 |
must always be given. The script is located in the |
3411 |
30 May 07 |
jari |
44 |
<filename><base-dir>/bin</filename> directory and you must |
3376 |
24 May 07 |
nicklas |
45 |
change to that directory to be able to use the script. |
3334 |
14 May 07 |
nicklas |
46 |
</para> |
3334 |
14 May 07 |
nicklas |
47 |
|
3376 |
24 May 07 |
nicklas |
48 |
|
3376 |
24 May 07 |
nicklas |
49 |
<simplesect id="appendix.jobagent.sh.options"> |
3376 |
24 May 07 |
nicklas |
50 |
<title>Options</title> |
3376 |
24 May 07 |
nicklas |
51 |
|
3376 |
24 May 07 |
nicklas |
52 |
<variablelist> |
3376 |
24 May 07 |
nicklas |
53 |
<varlistentry> |
3376 |
24 May 07 |
nicklas |
54 |
<term><option>-c</option></term> |
3376 |
24 May 07 |
nicklas |
55 |
<listitem> |
3376 |
24 May 07 |
nicklas |
56 |
<para> |
3376 |
24 May 07 |
nicklas |
57 |
The path to the configuration file to use, for example: |
3376 |
24 May 07 |
nicklas |
58 |
|
3376 |
24 May 07 |
nicklas |
59 |
<informalexample> |
3376 |
24 May 07 |
nicklas |
60 |
<programlisting> |
3376 |
24 May 07 |
nicklas |
61 |
./jobagent.sh -c other.config start |
3376 |
24 May 07 |
nicklas |
62 |
</programlisting> |
3376 |
24 May 07 |
nicklas |
63 |
</informalexample> |
3376 |
24 May 07 |
nicklas |
64 |
|
3376 |
24 May 07 |
nicklas |
65 |
The default value is <filename>jobagent.properties</filename>. |
3992 |
22 Nov 07 |
nicklas |
66 |
The classpath is not searched which means that it doesn't find |
3992 |
22 Nov 07 |
nicklas |
67 |
the configuration file in <filename><base-dir>/www/WEB-INF/classes/</filename> |
3992 |
22 Nov 07 |
nicklas |
68 |
unless you specify the path to it. |
3376 |
24 May 07 |
nicklas |
69 |
See <xref linkend="appendix.jobagent.properties" /> |
3376 |
24 May 07 |
nicklas |
70 |
for more information about job agent configuration files. |
3376 |
24 May 07 |
nicklas |
71 |
</para> |
3376 |
24 May 07 |
nicklas |
72 |
</listitem> |
3376 |
24 May 07 |
nicklas |
73 |
</varlistentry> |
3376 |
24 May 07 |
nicklas |
74 |
</variablelist> |
3376 |
24 May 07 |
nicklas |
75 |
</simplesect> |
3376 |
24 May 07 |
nicklas |
76 |
|
3376 |
24 May 07 |
nicklas |
77 |
<simplesect id="appendix.jobagent.sh.commands"> |
3376 |
24 May 07 |
nicklas |
78 |
<title>Commands</title> |
3376 |
24 May 07 |
nicklas |
79 |
|
3376 |
24 May 07 |
nicklas |
80 |
<variablelist> |
3376 |
24 May 07 |
nicklas |
81 |
<varlistentry> |
3376 |
24 May 07 |
nicklas |
82 |
<term><command>register</command></term> |
3376 |
24 May 07 |
nicklas |
83 |
<listitem> |
3376 |
24 May 07 |
nicklas |
84 |
<para> |
3376 |
24 May 07 |
nicklas |
85 |
Register the job agent with the BASE server. |
3376 |
24 May 07 |
nicklas |
86 |
If the job agent already exists this command does nothing. |
3376 |
24 May 07 |
nicklas |
87 |
</para> |
3376 |
24 May 07 |
nicklas |
88 |
</listitem> |
3376 |
24 May 07 |
nicklas |
89 |
</varlistentry> |
3376 |
24 May 07 |
nicklas |
90 |
|
3376 |
24 May 07 |
nicklas |
91 |
<varlistentry> |
3376 |
24 May 07 |
nicklas |
92 |
<term><command>unregister</command></term> |
3376 |
24 May 07 |
nicklas |
93 |
<listitem> |
3376 |
24 May 07 |
nicklas |
94 |
<para> |
3376 |
24 May 07 |
nicklas |
95 |
Unregister/delete the job agent from the BASE server. If the |
3487 |
13 Jun 07 |
peter |
96 |
job agent does not exist this command does nothing. |
3376 |
24 May 07 |
nicklas |
97 |
</para> |
3376 |
24 May 07 |
nicklas |
98 |
</listitem> |
3376 |
24 May 07 |
nicklas |
99 |
</varlistentry> |
3376 |
24 May 07 |
nicklas |
100 |
|
3376 |
24 May 07 |
nicklas |
101 |
<varlistentry> |
3376 |
24 May 07 |
nicklas |
102 |
<term><command>start</command></term> |
3376 |
24 May 07 |
nicklas |
103 |
<listitem> |
3376 |
24 May 07 |
nicklas |
104 |
<para> |
3376 |
24 May 07 |
nicklas |
105 |
Start the job agent. As soon as it is up and running it will |
3411 |
30 May 07 |
jari |
106 |
check the database for jobs that are waiting to be executed. |
3376 |
24 May 07 |
nicklas |
107 |
</para> |
3376 |
24 May 07 |
nicklas |
108 |
</listitem> |
3376 |
24 May 07 |
nicklas |
109 |
</varlistentry> |
3376 |
24 May 07 |
nicklas |
110 |
|
3376 |
24 May 07 |
nicklas |
111 |
<varlistentry> |
3376 |
24 May 07 |
nicklas |
112 |
<term><command>pause</command></term> |
3376 |
24 May 07 |
nicklas |
113 |
<listitem> |
3376 |
24 May 07 |
nicklas |
114 |
<para> |
3376 |
24 May 07 |
nicklas |
115 |
Pause the job agent. The job agent will continue running but |
3487 |
13 Jun 07 |
peter |
116 |
does not check the database for jobs. To start it again use the |
3376 |
24 May 07 |
nicklas |
117 |
<command>start</command> command. |
3376 |
24 May 07 |
nicklas |
118 |
</para> |
3376 |
24 May 07 |
nicklas |
119 |
</listitem> |
3376 |
24 May 07 |
nicklas |
120 |
</varlistentry> |
3376 |
24 May 07 |
nicklas |
121 |
|
3376 |
24 May 07 |
nicklas |
122 |
<varlistentry> |
3376 |
24 May 07 |
nicklas |
123 |
<term><command>stop</command></term> |
3376 |
24 May 07 |
nicklas |
124 |
<listitem> |
3376 |
24 May 07 |
nicklas |
125 |
<para> |
3376 |
24 May 07 |
nicklas |
126 |
Stop the job agent. To start it again use the <command>start</command> |
3376 |
24 May 07 |
nicklas |
127 |
command. |
3376 |
24 May 07 |
nicklas |
128 |
</para> |
3376 |
24 May 07 |
nicklas |
129 |
</listitem> |
3376 |
24 May 07 |
nicklas |
130 |
</varlistentry> |
3376 |
24 May 07 |
nicklas |
131 |
|
3376 |
24 May 07 |
nicklas |
132 |
<varlistentry> |
3376 |
24 May 07 |
nicklas |
133 |
<term><command>info</command></term> |
3376 |
24 May 07 |
nicklas |
134 |
<listitem> |
3376 |
24 May 07 |
nicklas |
135 |
<para> |
3376 |
24 May 07 |
nicklas |
136 |
Get information about the job agent. This will output a string |
3376 |
24 May 07 |
nicklas |
137 |
in the form: |
3376 |
24 May 07 |
nicklas |
138 |
<computeroutput> |
3376 |
24 May 07 |
nicklas |
139 |
<literallayout> |
3376 |
24 May 07 |
nicklas |
140 |
Status:Running |
5678 |
29 Jun 11 |
nicklas |
141 |
Cpu:15 |
5678 |
29 Jun 11 |
nicklas |
142 |
Total memory:8254955520 |
5678 |
29 Jun 11 |
nicklas |
143 |
Used memory:8002252800 |
5678 |
29 Jun 11 |
nicklas |
144 |
Job:42 |
5678 |
29 Jun 11 |
nicklas |
145 |
Job.42.slot:SHORT |
3376 |
24 May 07 |
nicklas |
146 |
</literallayout> |
3376 |
24 May 07 |
nicklas |
147 |
</computeroutput> |
3376 |
24 May 07 |
nicklas |
148 |
<emphasis>Status</emphasis> can be either <constant>Running</constant> |
5678 |
29 Jun 11 |
nicklas |
149 |
or <constant>Paused</constant>. There is some information about the |
5678 |
29 Jun 11 |
nicklas |
150 |
current CPU and memory usage, but this information may not be available on |
5678 |
29 Jun 11 |
nicklas |
151 |
all platforms. For each job that is currently running, the ID is given. A |
5678 |
29 Jun 11 |
nicklas |
152 |
second entry gives information about the slot the job uses for execution. |
5678 |
29 Jun 11 |
nicklas |
153 |
In the future, the <command>info</command> command may output more information. |
3376 |
24 May 07 |
nicklas |
154 |
</para> |
3376 |
24 May 07 |
nicklas |
155 |
</listitem> |
3376 |
24 May 07 |
nicklas |
156 |
</varlistentry> |
3992 |
22 Nov 07 |
nicklas |
157 |
|
3992 |
22 Nov 07 |
nicklas |
158 |
<varlistentry> |
3992 |
22 Nov 07 |
nicklas |
159 |
<term><command>status</command></term> |
3992 |
22 Nov 07 |
nicklas |
160 |
<listitem> |
3992 |
22 Nov 07 |
nicklas |
161 |
<para> |
3992 |
22 Nov 07 |
nicklas |
162 |
Similar to the <command>info</command> command but with less output. |
3992 |
22 Nov 07 |
nicklas |
163 |
The output is either <computeroutput>Running, Pauses or Stopped</computeroutput>. |
3992 |
22 Nov 07 |
nicklas |
164 |
In case of an unexpected error, an error message may be displayed instead. |
3992 |
22 Nov 07 |
nicklas |
165 |
</para> |
3992 |
22 Nov 07 |
nicklas |
166 |
</listitem> |
3992 |
22 Nov 07 |
nicklas |
167 |
</varlistentry> |
3376 |
24 May 07 |
nicklas |
168 |
|
3376 |
24 May 07 |
nicklas |
169 |
<varlistentry> |
3376 |
24 May 07 |
nicklas |
170 |
<term><command>help</command></term> |
3376 |
24 May 07 |
nicklas |
171 |
<listitem> |
3376 |
24 May 07 |
nicklas |
172 |
<para> |
3376 |
24 May 07 |
nicklas |
173 |
Display usage information. |
3376 |
24 May 07 |
nicklas |
174 |
</para> |
3376 |
24 May 07 |
nicklas |
175 |
</listitem> |
3376 |
24 May 07 |
nicklas |
176 |
</varlistentry> |
3376 |
24 May 07 |
nicklas |
177 |
|
3376 |
24 May 07 |
nicklas |
178 |
</variablelist> |
3376 |
24 May 07 |
nicklas |
179 |
</simplesect> |
3376 |
24 May 07 |
nicklas |
180 |
|
3334 |
14 May 07 |
nicklas |
181 |
</appendix> |
3334 |
14 May 07 |
nicklas |
182 |
|