Skip to Content

Wiki source code of Wonder JavaMonitor and wotaskd

Version 183.1 by Pascal Robert on 2023/11/13 11:54
Show last authors
1 [[image:attach:WonderJavaMonitor.png]]
2
3
4
5 {{toc/}}
6
7 === Introduction ===
8
9 JavaMonitor is a web-based tool used to configure and maintain deployed WebObjects applications. It is capable of handling multiple WebObjects applications, multiple instances of each application, and multiple WebObjects Applications Servers. In most cases you'll have one instance of JavaMonitor controlling all instances of your applications, even if they are spread across multiple Application Servers.
10
11 wotaskd (WebObjects task daemon) is the WebObjects Deployment tool that manages the instances on an Application Server. It's used by Monitor to propagate site configuration changes throughout the site's application hosts.
12
13 Apple released the original wotaskd and JavaMonitor to the community as open source in WebObjects 5.4. The source was then quickly modified and included in Project Wonder. Substantial improvements in both functionality and look-and-feel have been made over the years. These improved versions of **wotaskd.woa** and **JavaMonitor.woa** are available as standard Wonder applications.
14
15 === Where To Get Them ===
16
17 You can either download them pre-built from [[Wonder's Jenkins build server>>url:http://jenkins.wocommunity.org/job/Wonder7/lastSuccessfulBuild/||shape="rect"]] or build them from the source code.
18
19 To build them from the [[Wonder source code>>doc:WEB.Home.Getting Started.Getting the Wonder Source Code.WebHome]], simply run the following command from the Wonder directory at the root of the Wonder source.
20
21 {{code}}
22 ant frameworks deployment.tools -Ddeployment.standalone=true
23 {{/code}}
24
25 (% class="auto-cursor-target" %)
26 \\
27
28 {{info title="What this command does:"}}
29 * **ant**: calls Apache Ant. It is assumed that you have this already installed.
30 * **frameworks**: tells Ant to build the "frameworks" target. This may not be needed if you already have Wonder built and installed in a location Ant can find automatically.
31 * **deployment.tools**: tells Ant to build the "deployment.tools" target. This is the target that builds both wotaskd.woa and JavaMonitor.woa. You absolutely need this one.
32 * **-Ddeployment.standalone=true**: argument will embed the required Wonder and WebObjects frameworks in built applications. You need this to ensure that the required frameworks are embedded in the built applications.
33 {{/info}}
34
35 === Bug Fixes to Apple's Versions ===
36
37 ==== JavaMonitor ====
38
39 * Fixes an issue with the Application Delete page
40 * Selection in Application Detail page is now Ajax and is maintained
41
42 === Improvements to Apple's versions ===
43
44 ==== Automatic archive of SiteConfig.xml ====
45
46 On every change you make to an application's configuration, a backup of SiteConfig.xml will be created in, by default, /Library/WebObjects/Configuration.
47
48 ==== Simplified/Automated Bouncing ====
49
50 In the "list instances" page, you get a "Bounce" action link. This action only work if you have at least one active instance and one inactive instance (only one inactive instance takes part in the bounce). What it does is :
51
52 * Find one inactive (i.e., not started) instance and start it
53 * Find the active instances (minus the one started in the previous step) and enable "Refuse New Session"
54 * Stop the active instances that are refusing new sessions when the minimum session count is reached
55 * Restart all but one of the instances that were just stopped and turn on "Auto-Recover"
56
57 This feature, from Pascal's understanding, allows you to upload new versions of your application, start up the new version and refuse sessions for the instances running on the older version. This is designed to work so that you always have just **one** inactive instance that is only used while the bounce is performed. While waiting for the existing sessions to end you will have only one instance of your app accepting new sessions; you need to determine if this is acceptable for your app or not.
58
59 {{warning title="Database Changes"}}
60 It is uncertain what will happen if the new version of your application makes changes to your database schema (e.g., uses [[ERXMigrations>>doc:WO.Project WONDER-Frameworks-ERXMigration]]). The old instances may raise exceptions before they can gracefully shut down because the schema no longer matches what the old application's EOF expects. **Try it out on a test server first and then update this page so everyone knows!**
61 {{/warning}}
62
63 ==== Statistics ====
64
65 If you call [[http:~~/~~/monitorhost:port/cgi-bin/WebObjects/JavaMonitor.woa/wa/statistics>>url:http://monitorhostport||shape="rect"]]{{code language="none"}}{{/code}}, JavaMonitor will send you back statistics, in serialized Property List format, about instances, per application.
66
67 {{code title="Statistics Example Results" 0="none"}}
68
69 (
70 {
71 "configuredInstances" = "2";
72 "maxSessions" = "0";
73 "maxAvgIdleTime" = "2.078";
74 "avgTransactions" = "44.0000";
75 "sumSessions" = "0";
76 "avgAvgTransactionTime" = "0.0985000";
77 "refusingInstances" = "0";
78 "avgSessions" = "0.0000";
79 "maxTransactions" = "88";
80 "applicationName" = "AjaxExample";
81 "avgAvgIdleTime" = "1.0390000";
82 "maxAvgTransactionTime" = "0.197";
83 "runningInstances" = "2";
84 "sumTransactions" = "88";
85 },
86 {
87 "configuredInstances" = "2";
88 "maxSessions" = "0";
89 "maxAvgIdleTime" = "325.443";
90 "avgTransactions" = "0.5000";
91 "sumSessions" = "0";
92 "avgAvgTransactionTime" = "0.00000";
93 "refusingInstances" = "0";
94 "avgSessions" = "0.0000";
95 "maxTransactions" = "1";
96 "applicationName" = "AjaxExample2";
97 "avgAvgIdleTime" = "162.7215000";
98 "maxAvgTransactionTime" = "0.0";
99 "runningInstances" = "2";
100 "sumTransactions" = "1";
101 }
102 )
103
104 {{/code}}
105
106 (% class="auto-cursor-target" %)
107 \\
108
109 {{info}}
110 If JavaMonitor is configured with a password, and I hope you do, pass //pw=monitorpassword// as a argument to the query :
111
112 (% class="auto-cursor-target" %)
113 \\
114
115 {{code}}
116
117 http://monitorhost:port/cgi-bin/WebObjects/JavaMonitor.woa/wa/statistics?pw=monitorpassword
118
119 wget http://monitorhost:56789/cgi-bin/WebObjects/JavaMonitor.woa/admin/stop?type=app&name=InstanceName&pw=yourPassword
120
121 {{/code}}
122
123 (% class="auto-cursor-target" %)
124 \\
125 {{/info}}
126
127 ==== Direct Actions in JavaMonitor for Management Tasks ====
128
129 You can do most of the standard management tasks you'd normally do in JavaMonitor's web UI by calling standard WebObjects Direct Actions. Instead of using the {{code language="none"}}/wa/{{/code}} request handler though, these management tasks use a new {{code language="none"}}/admin/{{/code}} request handler. These Direct Actions can be very useful, especially if you need to restart instances or other do tasks from the command line, from within Ant or other build or deployment systems.
130
131 List of available direct actions :
132
133 * **info**{{code language="none"}}{{/code}} : Returns details (number of deaths, state, etc.), in JavaScript Object Notation (JSON) as specified
134 {{code language="none"}}info?{{/code}}**type=all**{{code language="none"}}{{/code}}
135 {{code language="none"}}info?{{/code}}**type=app&name=**{{code language="none"}}{{/code}}(% style="color: maroon;" %)**AppName**{{code language="none"}}{{/code}}(%%)
136 {{code language="none"}}info?{{/code}}**type=ins&name=**{{code language="none"}}{{/code}}(% style="color: maroon;" %)**AppName**{{code language="none"}}{{/code}}(%%)**-**{{code language="none"}}{{/code}}(% style="color: maroon;" %)**InstanceNumber**{{code language="none"}}{{/code}}
137
138 * **running**{{code language="none"}}{{/code}} : Returns **YES**{{code language="none"}}{{/code}} if **all** of the specified are running, {{code language="none"}}NO{{/code}} if not
139 {{code language="none"}}running?{{/code}}**type=all**{{code language="none"}}{{/code}}
140 {{code language="none"}}running?{{/code}}**type=app&name=**{{code language="none"}}{{/code}}(% style="color: maroon;" %)**AppName**{{code language="none"}}{{/code}}(%%)
141 {{code language="none"}}running?{{/code}}**type=ins&name=**{{code language="none"}}{{/code}}(% style="color: maroon;" %)**AppName**{{code language="none"}}{{/code}}(%%)**-**{{code language="none"}}{{/code}}(% style="color: maroon;" %)**InstanceNumber**{{code language="none"}}{{/code}}
142
143 * **stopped**{{code language="none"}}{{/code}} : Returns **YES**{{code language="none"}}{{/code}} if **all** the specified is running, **NO**{{code language="none"}}{{/code}} if not.
144 {{code language="none"}}stopped?{{/code}}**type=all**{{code language="none"}}{{/code}}
145 {{code language="none"}}stopped?{{/code}}**type=app&name=**{{code language="none"}}{{/code}}(% style="color: maroon;" %)**AppName**{{code language="none"}}{{/code}}(%%)
146 {{code language="none"}}stopped?{{/code}}**type=ins&name=**{{code language="none"}}{{/code}}(% style="color: maroon;" %)**AppName**{{code language="none"}}{{/code}}(%%)**-**{{code language="none"}}{{/code}}(% style="color: maroon;" %)**InstanceNumber**{{code language="none"}}{{/code}}
147
148 * **bounce**{{code language="none"}}{{/code}} : Returns **OK**{{code language="none"}}{{/code}} after Bouncing (see description above) as specified
149 {{code language="none"}}bounce?{{/code}}**type=all**{{code language="none"}}{{/code}}
150 {{code language="none"}}bounce?{{/code}}**type=app&name=**{{code language="none"}}{{/code}}(% style="color: maroon;" %)**AppName**{{code language="none"}}{{/code}}
151
152 * **clearDeaths**{{code language="none"}}{{/code}} : Returns **OK**{{code language="none"}}{{/code}} after clearing deaths as specified
153 {{code language="none"}}clearDeaths?{{/code}}**type=all**{{code language="none"}}{{/code}}
154 {{code language="none"}}clearDeaths?{{/code}}**type=app&name=**{{code language="none"}}{{/code}}(% style="color: maroon;" %)**AppName**{{code language="none"}}{{/code}}
155
156 * **turnScheduledOn**{{code language="none"}}{{/code}} : Returns **OK**{{code language="none"}}{{/code}} after turning on scheduling as specified. Call ///turnScheduledOff// to do the opposite.
157 {{code language="none"}}turnScheduledOn?{{/code}}**type=all**{{code language="none"}}{{/code}}
158 {{code language="none"}}turnScheduledOn?{{/code}}**type=app&name=**{{code language="none"}}{{/code}}(% style="color: maroon;" %)**AppName**{{code language="none"}}{{/code}}(%%)
159 {{code language="none"}}turnScheduledOn?{{/code}}**type=ins&name=**{{code language="none"}}{{/code}}(% style="color: maroon;" %)**AppName**{{code language="none"}}{{/code}}(%%)**-**{{code language="none"}}{{/code}}(% style="color: maroon;" %)**InstanceNumber**{{code language="none"}}{{/code}}
160
161 * **turnRefuseNewSessionsOn**{{code language="none"}}{{/code}} : Returns **OK**{{code language="none"}}{{/code}} after turning on "Refuse new sessions" as specified
162 {{code language="none"}}turnRefuseNewSessionsOn?{{/code}}**type=all**{{code language="none"}}{{/code}}
163 {{code language="none"}}turnRefuseNewSessionsOn?{{/code}}**type=app&name=**{{code language="none"}}{{/code}}(% style="color: maroon;" %)**AppName**{{code language="none"}}{{/code}}(%%)
164 {{code language="none"}}turnRefuseNewSessionsOn?{{/code}}**type=ins&name=**{{code language="none"}}{{/code}}(% style="color: maroon;" %)**AppName**{{code language="none"}}{{/code}}(%%)**-**{{code language="none"}}{{/code}}(% style="color: maroon;" %)**InstanceNumber**{{code language="none"}}{{/code}}
165
166 * **turnRefuseNewSessionsOff**{{code language="none"}}{{/code}} : Returns **OK**{{code language="none"}}{{/code}} after turning off "Refuse new sessions" as specified
167 {{code language="none"}}turnRefuseNewSessionsOff?{{/code}}**type=all**{{code language="none"}}{{/code}}
168 {{code language="none"}}turnRefuseNewSessionsOff?{{/code}}**type=app&name=**{{code language="none"}}{{/code}}(% style="color: maroon;" %)**AppName**{{code language="none"}}{{/code}}(%%)
169 {{code language="none"}}turnRefuseNewSessionsOff?{{/code}}**type=ins&name=**{{code language="none"}}{{/code}}(% style="color: maroon;" %)**AppName**{{code language="none"}}{{/code}}(%%)**-**{{code language="none"}}{{/code}}(% style="color: maroon;" %)**InstanceNumber**{{code language="none"}}{{/code}}
170
171 * **turnAutoRecoverOn**{{code language="none"}}{{/code}} : Returns **OK**{{code language="none"}}{{/code}} after turning on "Auto Recover" as specified
172 {{code language="none"}}turnAutoRecoverOn?{{/code}}**type=all**{{code language="none"}}{{/code}}
173 {{code language="none"}}turnAutoRecoverOn?{{/code}}**type=app&name=**{{code language="none"}}{{/code}}(% style="color: maroon;" %)**AppName**{{code language="none"}}{{/code}}(%%)
174 {{code language="none"}}turnAutoRecoverOn?{{/code}}**type=ins&name=**{{code language="none"}}{{/code}}(% style="color: maroon;" %)**AppName**{{code language="none"}}{{/code}}(%%)**-**{{code language="none"}}{{/code}}(% style="color: maroon;" %)**InstanceNumber**{{code language="none"}}{{/code}}
175
176 * **turnAutoRecoverOff**{{code language="none"}}{{/code}} : Returns **OK**{{code language="none"}}{{/code}} after turning off "Auto Recover" as specified
177 {{code language="none"}}turnAutoRecoverOn?{{/code}}**type=all**{{code language="none"}}{{/code}}
178 {{code language="none"}}turnAutoRecoverOn?{{/code}}**type=app&name=**{{code language="none"}}{{/code}}(% style="color: maroon;" %)**AppName**{{code language="none"}}{{/code}}(%%)
179 {{code language="none"}}turnAutoRecoverOn?{{/code}}**type=ins&name=**{{code language="none"}}{{/code}}(% style="color: maroon;" %)**AppName**{{code language="none"}}{{/code}}(%%)**-**{{code language="none"}}{{/code}}(% style="color: maroon;" %)**InstanceNumber**{{code language="none"}}{{/code}}
180
181 * **forceQuit**{{code language="none"}}{{/code}} : Returns **OK**{{code language="none"}}{{/code}} after force quitting as specified. This could be useful to call from a monitoring system.
182 {{code language="none"}}forceQuit?{{/code}}**type=all**{{code language="none"}}{{/code}}
183 {{code language="none"}}forceQuit?{{/code}}**type=app&name=**{{code language="none"}}{{/code}}(% style="color: maroon;" %)**AppName**{{code language="none"}}{{/code}}(%%)
184 {{code language="none"}}forceQuit?{{/code}}**type=ins&name=**{{code language="none"}}{{/code}}(% style="color: maroon;" %)**AppName**{{code language="none"}}{{/code}}(%%)**-**{{code language="none"}}{{/code}}(% style="color: maroon;" %)**InstanceNumber**{{code language="none"}}{{/code}}
185
186 * **stop**{{code language="none"}}{{/code}} : Returns **OK**{{code language="none"}}{{/code}} after calling "Stop" as specified
187 {{code language="none"}}stop?{{/code}}**type=all**{{code language="none"}}{{/code}}
188 {{code language="none"}}stop?{{/code}}**type=app&name=**{{code language="none"}}{{/code}}(% style="color: maroon;" %)**AppName**{{code language="none"}}{{/code}}(%%)
189 {{code language="none"}}stop?{{/code}}**type=ins&name=**{{code language="none"}}{{/code}}(% style="color: maroon;" %)**AppName**{{code language="none"}}{{/code}}(%%)**-**{{code language="none"}}{{/code}}(% style="color: maroon;" %)**InstanceNumber**{{code language="none"}}{{/code}}
190
191 * **start**{{code language="none"}}{{/code}} : Returns **OK**{{code language="none"}}{{/code}} after calling "Start" as specified
192 {{code language="none"}}start?{{/code}}**type=all**{{code language="none"}}{{/code}}
193 {{code language="none"}}start?{{/code}}**type=app&name=**{{code language="none"}}{{/code}}(% style="color: maroon;" %)**AppName**{{code language="none"}}{{/code}}(%%)
194 {{code language="none"}}start?{{/code}}**type=ins&name=**{{code language="none"}}{{/code}}(% style="color: maroon;" %)**AppName**{{code language="none"}}{{/code}}(%%)**-**{{code language="none"}}{{/code}}(% style="color: maroon;" %)**InstanceNumber**{{code language="none"}}{{/code}}
195
196 To get details about all instances of all applications:
197 [[http:~~/~~/monitorhost:port/cgi-bin/WebObjects/JavaMonitor.woa/admin/info?type=all>>url:http://monitorhostport||shape="rect"]]{{code language="none"}}{{/code}}
198
199 To get details about the **AjaxExample** application:
200 [[http:~~/~~/monitorhost:port/cgi-bin/WebObjects/JavaMonitor.woa/admin/info?type=app&name=AjaxExample>>url:http://monitorhostport||shape="rect"]]{{code language="none"}}{{/code}}
201
202 To get details about instance **1** of the **AjaxExample** application:
203 [[http:~~/~~/monitorhost:port/cgi-bin/WebObjects/JavaMonitor.woa/admin/info?type=ins&name=AjaxExample-1>>url:http://monitorhostport||shape="rect"]]{{code language="none"}}{{/code}}
204
205 ==== Remote Control via REST Routes (for JavaMonitor) ====
206
207 If the control offered by the Direct Actions isn't enough, JavaMonitor allows additional control via [[REST>>doc:ERRest Framework]] calls. Between the two methods (Direct Actions, REST) you have almost full remote-control of JavaMonitor. Just make sure that your JavaMonitor installation is secure! Just like with Direct Actions, you need to append {{code language="none"}}?pw=XXXX{{/code}} to the URLs if your JavaMonitor is password protected.
208
209 Be careful with these. This allows to do illegal stuff, that the UI wouldn't allow, for example, create two applications with the same name.
210
211 Examples of REST calls :
212
213 {{code title="Adding a New Host" 0="none"}}
214
215 curl -X POST -d "{id: 'otherserver.com',type: 'MHost', osType: 'MACOSX',address: '192.168.20.5', name: 'otherserver.com'}" http://monitorhost:port/apps/WebObjects/JavaMonitor.woa/ra/mHosts.json
216
217 {{/code}}
218
219 (% class="auto-cursor-target" %)
220 \\
221
222 {{code title="Fetching Details for All Applications" 0="none"}}
223
224 curl -X GET http://monitorhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications.json
225
226 {{/code}}
227
228 (% class="auto-cursor-target" %)
229 \\
230
231 {{code title="Adding a New Application" 0="none"}}
232
233 curl -X POST -d "{id: 'AjaxExample',type: 'MApplication', name: 'AjaxExample',unixOutputPath: '/opt/Local/Library/WebObjects/Logs', unixPath: '/opt/Local/Library/WebObjects/Applications/AjaxExample.woa/AjaxExample'}" http://monitorhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications.json
234
235 {{/code}}
236
237 (% class="auto-cursor-target" %)
238 \\
239
240 {{code title="Delete an Application" 0="none"}}
241
242 curl -X DELETE http://monitorhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample.json
243
244 {{/code}}
245
246 (% class="auto-cursor-target" %)
247 \\
248
249 {{code title="Adding a New Instance" 0="none"}}
250
251 curl -X GET http://monitorhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample/addInstance?host=localhost
252
253 {{/code}}
254
255 (% class="auto-cursor-target" %)
256 \\
257
258 {{code title="Delete an Instance" 0="none"}}
259
260 curl -X GET http://monitorhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample/deleteInstance?id=1
261
262 {{/code}}
263
264 (% class="auto-cursor-target" %)
265 \\
266
267 {{code title="Configuring the Site" 0="none"}}
268
269 curl -X PUT -d "{woAdaptor:'www.mydomain.com'}" http://monitorhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mSiteConfig.json
270
271 {{/code}}
272
273 Note that before configuring the site you must first add a host. If you attempt to configure the site prior to adding a host you will get an InvalidStateException.
274
275 ==== Remote Control via REST Routes (for wotaskd) ====
276
277 Starting on August 10th 2012, wotaskd also have REST routes. By using them, you can do most of the tasks using REST and you might not even need JavaMonitor. Just like the JavaMonitor REST and Direct Actions, you need to append {{code language="none"}}?pw=XXXX{{/code}} to the URLs if wotaskd is password protected.
278
279 Unfortunately, all changes you make in {{code language="none"}}wotaskd{{/code}} via this API will not be picked up by an already running {{code language="none"}}JavaMonitor{{/code}}, making all the modification endpoints here mostly useless.
280
281 \\
282
283 {{code title="Fetching Details for All Applications" 0="none"}}
284
285 curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications.json
286
287 {{/code}}
288
289 (% class="auto-cursor-target" %)
290 \\
291
292 {{code title="Adding a New Application" 0="none"}}
293
294 curl -X POST -d "{id: 'AjaxExample',type: 'MApplication', name: 'AjaxExample',unixOutputPath: '/opt/Local/Library/WebObjects/Logs', unixPath: '/opt/Local/Library/WebObjects/Applications/AjaxExample.woa/AjaxExample'}" http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications.json
295
296 {{/code}}
297
298 (% class="auto-cursor-target" %)
299 \\
300
301 {{code title="Delete an Application" 0="none"}}
302
303 curl -X DELETE http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample.json
304
305 {{/code}}
306
307 (% class="auto-cursor-target" %)
308 \\
309
310 {{code title="Adding a New Instance" 0="none"}}
311
312 curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample/addInstance?host=localhost
313
314 {{/code}}
315
316 (% class="auto-cursor-target" %)
317 \\
318
319 {{code title="Delete an Instance" 0="none"}}
320
321 curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample/deleteInstance?id=1
322
323 {{/code}}
324
325 (% class="auto-cursor-target" %)
326 \\
327
328 {{code title="Configuring the Site" 0="none"}}
329
330 curl -X PUT -d "{woAdaptor:'www.mydomain.com'}" http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mSiteConfig.json
331
332 {{/code}}
333
334 (% class="auto-cursor-target" %)
335 \\
336
337 {{code title="Starting all applications" 0="none"}}
338
339 curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/start
340
341 {{/code}}
342
343 (% class="auto-cursor-target" %)
344 \\
345
346 {{code title="Starting a specific application (AjaxExample in this example)" 0="none"}}
347
348 curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample/start
349
350 {{/code}}
351
352 (% class="auto-cursor-target" %)
353 \\
354
355 {{code title="Starting a specific instance of an application (instance 1 of AjaxExample in this example)" 0="none"}}
356
357 curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample/start?id=1
358
359 {{/code}}
360
361 (% class="auto-cursor-target" %)
362 \\
363
364 {{code title="Stopping all applications" 0="none"}}
365
366 curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/stop
367
368 {{/code}}
369
370 (% class="auto-cursor-target" %)
371 \\
372
373 {{code title="Stopping a specific application (AjaxExample in this example)" 0="none"}}
374
375 curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample/stop
376
377 {{/code}}
378
379 (% class="auto-cursor-target" %)
380 \\
381
382 {{code title="Stopping a specific instance of an application (instance 1 of AjaxExample in this example)" 0="none"}}
383
384 curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample/stop?id=1
385
386 {{/code}}
387
388 (% class="auto-cursor-target" %)
389 \\
390
391 {{code title="Force quit all applications" 0="none"}}
392
393 curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/forceQuit
394
395 {{/code}}
396
397 (% class="auto-cursor-target" %)
398 \\
399
400 {{code title="Force quit a specific application (AjaxExample in this example)" 0="none"}}
401
402 curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample/forceQuit
403
404 {{/code}}
405
406 (% class="auto-cursor-target" %)
407 \\
408
409 {{code title="Force quit a specific instance of an application (instance 1 of AjaxExample in this example)" 0="none"}}
410
411 curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample/forceQuit?id=1
412
413 {{/code}}
414
415 (% class="auto-cursor-target" %)
416 \\
417
418 {{code title="Information about all applications" 0="none"}}
419
420 curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/info
421
422 {{/code}}
423
424 (% class="auto-cursor-target" %)
425 \\
426
427 {{code title="Information about a specific application (AjaxExample in this example)" 0="none"}}
428
429 curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample/info
430
431 {{/code}}
432
433 (% class="auto-cursor-target" %)
434 \\
435
436 {{code title="Information about a specific instance of an application (instance 1 of AjaxExample in this example)" 0="none"}}
437
438 curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample/info?id=1
439
440 {{/code}}
441
442 (% class="auto-cursor-target" %)
443 \\
444
445 {{code title="Check if all applications are running" 0="none"}}
446
447 curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/isRunning
448
449 {{/code}}
450
451 (% class="auto-cursor-target" %)
452 \\
453
454 {{code title="Check if a specific application is running (AjaxExample in this example)" 0="none"}}
455
456 curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample/isRunning
457
458 {{/code}}
459
460 (% class="auto-cursor-target" %)
461 \\
462
463 {{code title="Check if a specific instance of an application is running (instance 1 of AjaxExample in this example)" 0="none"}}
464
465 curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample/isRunning?id=1
466
467 {{/code}}
468
469 (% class="auto-cursor-target" %)
470 \\
471
472 {{code title="Check if all applications are stopped" 0="none"}}
473
474 curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/isStopped
475
476 {{/code}}
477
478 (% class="auto-cursor-target" %)
479 \\
480
481 {{code title="Check if a specific application is stopped (AjaxExample in this example)" 0="none"}}
482
483 curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample/isStopped
484
485 {{/code}}
486
487 (% class="auto-cursor-target" %)
488 \\
489
490 {{code title="Check if a specific instance of an application is stopped (instance 1 of AjaxExample in this example)" 0="none"}}
491
492 curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample/isStopped?id=1
493
494 {{/code}}
495
496 === Troubleshooting ===
497
498 If JavaMonitor won't start up check the [[troubleshooting deployment>>doc:Troubleshooting Deployment]] section. In particular pay attention to the [[WOTaskd Didn't Start>>doc:Troubleshooting Deployment]] Q&A.