Skip to Content
Last modified by Pascal Robert on 2023/08/10 22:21
From version 90.1
edited by ted_archibald
on 2010/11/29 22:14
Change comment: There is no comment for this version
To version 97.1
edited by David Avendasora
on 2010/11/29 21:37
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.ted_archibald
1 +XWiki.avendasora
Content
... ... @@ -105,23 +105,20 @@
105 105  
106 106  List of available direct actions :
107 107  
108 -* {{{*}info{*}}} : returns the details (number of deaths, state, etc.; see example above), in JavaScript Object Notation (JSON)
109 -** ##**?type=all{**##} : Returns details about all instances of all applications
110 -** ##**?type=app&name=**{##}{{color value="maroon"}}{{{}{*}AppName{*}{}}}{{/color}} : Returns details about all instances of a specific application
111 -** ##**?type=ins&name=**{##}{{color value="maroon"}}{{{}{*}AppName{*}{}}}{{/color}}{{{}*\-*{}}}{{color value="maroon"}}{{{}{*}InstanceNumber{*}{}}}{{/color}} : Returns details about one specific instance
112 -* {{{*}running{*}}} : Returns {{{*}YES{*}}} or {{{*}NO{*}}}
113 -** ##**?type=all{**##} : Returns {{{*}YES{*}}} if all instances of all applications are running
114 -** ##**?type=app&name=**{##}{{color value="maroon"}}{{{}{*}AppName{*}{}}}{{/color}} : Returns {{{*}YES{*}}} if all instances of the specified application are running
115 -** ##**?type=ins&name=**{##}{{color value="maroon"}}{{{}{*}AppName{*}{}}}{{/color}}{{{}*\-*{}}}{{color value="maroon"}}{{{}{*}InstanceNumber{*}{}}}{{/color}} : Returns {{{*}YES{*}}} if the instance of the specified application is running
116 -* {{{*}stopped{*}}} : return NO if the instance is running, YES if not.
117 -* {{{*}bounce{*}}} : more on it later.
118 -* {{{*}clearDeaths{*}}} : clear the number of deaths (same action as clicking the "Clear deaths" in JavaMonitor)
119 -* {{{*}turnScheduledOn{*}}} : turn scheduling on for an application or instance. Call ///turnScheduledOff// to do the opposite.
120 -* {{{*}turnRefuseNewSessionsOn{*}}} : turn "Refuse new sessions" on, call //turnRefuseNewSessionsOff// to do the opposite.
121 -* {{{*}turnAutoRecoverOn{*}}} : guess what? It activate "Auto recover" And guess again? ///turnAutoRecoverOff// do the opposite
122 -* {{{*}forceQuit{*}}} : force quit an application, might be useful to call it from a monitoring system.
123 -* {{{*}stop{*}}} : stop an application/instance the normal way.
124 -* {{{*}start{*}}} : start an application/instance the normal way.
108 +* **##info##** : returns the details (number of deaths, state, etc.; see example above), in JavaScript Object Notation (JSON)
109 +** **##?type=all##** : Returns details about all instances of all applications
110 +** **##?type=app&name=##**{{color value="blue"}}{{AppName}}{{/color}} : Returns details about all instances of a specific application
111 +** **##?type=ins&name=AppName-InstanceNo##** : Returns details about one specific instance
112 +* **##running##** : Returns **##YES##** or **##NO##**
113 +* **##stopped##** : return NO if the instance is running, YES if not.
114 +* **##bounce##** : more on it later.
115 +* **##clearDeaths##** : clear the number of deaths (same action as clicking the "Clear deaths" in JavaMonitor)
116 +* **##turnScheduledOn##** : turn scheduling on for an application or instance. Call ///turnScheduledOff// to do the opposite.
117 +* **##turnRefuseNewSessionsOn##** : turn "Refuse new sessions" on, call //turnRefuseNewSessionsOff// to do the opposite.
118 +* **##turnAutoRecoverOn##** : guess what? It activate "Auto recover" And guess again? ///turnAutoRecoverOff// do the opposite
119 +* **##forceQuit##** : force quit an application, might be useful to call it from a monitoring system.
120 +* **##stop##** : stop an application/instance the normal way.
121 +* **##start##** : start an application/instance the normal way.
125 125  
126 126  ##?type=all## : returns details about all applications and instances
127 127  ##?type=app&name=AppName## : returns details about all instances of a specific application
... ... @@ -139,6 +139,28 @@
139 139  
140 140  [[http://monitorhost:port/cgi-bin/WebObjects/JavaMonitor.woa/admin/info?type=ins&name=AjaxExample-1]]
141 141  
139 +The response for the direct actions will either send a JSON array or YES/NO. For example, the query //info// for all instances will return :
140 +
141 +{{code}}
142 +
143 +[Hudson Build Server for Wonder|http://webobjects.mdimension.com/hudson/job/Wonder54/lastSuccessfulBuild/artifact/dist/]
144 +
145 +{{/code}}
146 +
147 +List of available direct actions :
148 +
149 +///info// : return details (number of deaths, state, etc.; see above), in JSON, about an instance.
150 +///running// : return YES if the instance is running, NO if not.
151 +///stopped// : return NO if the instance is running, YES if not.
152 +///bounce//: more on it later.
153 +///clearDeaths// : clear the number of deaths (same action as clicking the "Clear deaths" in JavaMonitor)
154 +///turnScheduledOn// : turn scheduling on for an application or instance. Call ///turnScheduledOff// to do the opposite.
155 +///turnRefuseNewSessionsOn// : turn "Refuse new sessions" on, call //turnRefuseNewSessionsOff// to do the opposite.
156 +///turnAutoRecoverOn// : guess what? It activate "Auto recover" And guess again? ///turnAutoRecoverOff// do the opposite
157 +///forceQuit// : force quit an application, might be useful to call it from a monitoring system.
158 +///stop// : stop an application/instance the normal way.
159 +///start// : start an application/instance the normal way.
160 +
142 142  ==== Remote Control via REST Routes ====
143 143  
144 144  On September 28th 2010, REST routes were added in JavaMonitor. Those routes + the direct actions explained in this document allow you to control almost everything remotely (make sure that your JavaMonitor installation is secure). As the direct actions, append //?pw=XXXX// to the URLs if JavaMonitor is password protected.
... ... @@ -147,7 +147,7 @@
147 147  
148 148  {{code title="Adding a New Host"}}
149 149  
150 -curl -X POST -d "{id: 'otherserver.com',type: 'MHost', osType: 'MACOSX',address: '192.168.20.5', name: 'otherserver.com'}" http://monitorhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mHosts.json
169 +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
151 151  
152 152  {{/code}}
153 153