Skip to Content
Last modified by Pascal Robert on 2023/08/10 22:21
From version 182.1
edited by Marc Guenther
on 2023/08/10 22:21
Change comment: another addInstance typo
To version 175.1
edited by Maik Musall
on 2013/04/23 11:54
Change comment: see https://github.com/projectwonder/wonder/issues/426

Summary

Details

Page properties
Parent
... ... @@ -1,1 +1,0 @@
1 -Deployment
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.marc
1 +XWiki.mmusall
Tags
... ... @@ -1,1 +1,0 @@
1 -favourite|deployment
Content
... ... @@ -1,9 +1,7 @@
1 -[[image:attach:WonderJavaMonitor.png]]
1 +[[image:WonderJavaMonitor.png||border="1"]]
2 2  
3 +{{toc}}{{/toc}}
3 3  
4 -
5 -{{toc/}}
6 -
7 7  === Introduction ===
8 8  
9 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,26 +10,25 @@
10 10  
11 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 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.
11 +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 14  
15 15  === Where To Get Them ===
16 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.
15 +You can either download them pre-built from [[Wonder's Jenkins build server>>http://jenkins.wocommunity.org/job/Wonder/lastSuccessfulBuild/]] or build them from the source code.
18 18  
19 -To build them from the [[Wonder source code>>doc:WEB.Getting the Wonder Source Code]], simply run the following command from the Wonder directory at the root of the Wonder source.
17 +To build them from the [[Wonder source code>>Getting the Wonder Source Code]], simply run the following command from the Wonder directory at the root of the Wonder source.
20 20  
21 21  {{code}}
22 22  ant frameworks deployment.tools -Ddeployment.standalone=true
23 23  {{/code}}
24 24  
25 -(% class="auto-cursor-target" %)
26 -\\
27 -
28 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.
24 +
25 +* *ant*: calls Apache Ant. It is assumed that you have this already installed.
26 +* *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.
27 +* *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.
28 +* *\-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.
29 +
33 33  {{/info}}
34 34  
35 35  === Bug Fixes to Apple's Versions ===
... ... @@ -54,17 +54,19 @@
54 54  * Stop the active instances that are refusing new sessions when the minimum session count is reached
55 55  * Restart all but one of the instances that were just stopped and turn on "Auto-Recover"
56 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.
54 +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 58  
59 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!**
57 +
58 +It is uncertain what will happen if the new version of your application makes changes to your database schema (e.g., uses [ERXMigrations|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\!*
59 +
61 61  {{/warning}}
62 62  
63 63  ==== Statistics ====
64 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.
64 +If you call ##[[http://monitorhost:port/cgi-bin/WebObjects/JavaMonitor.woa/wa/statistics]]##, JavaMonitor will send you back statistics, in serialized Property List format, about instances, per application.
66 66  
67 -{{code title="Statistics Example Results" 0="none"}}
66 +{{code title="Statistics Example Results"}}
68 68  
69 69  (
70 70   {
... ... @@ -103,169 +103,140 @@
103 103  
104 104  {{/code}}
105 105  
106 -(% class="auto-cursor-target" %)
107 -\\
108 -
109 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 111  
112 -(% class="auto-cursor-target" %)
113 -\\
107 +If JavaMonitor is configured with a password, and I hope you do, pass _pw=monitorpassword_ as a argument to the query :
114 114  
115 -{{code}}
116 -
109 +{code}
117 117  http://monitorhost:port/cgi-bin/WebObjects/JavaMonitor.woa/wa/statistics?pw=monitorpassword
118 118  
119 119  wget http://monitorhost:56789/cgi-bin/WebObjects/JavaMonitor.woa/admin/stop?type=app&name=InstanceName&pw=yourPassword
113 +{code}
120 120  
121 -{{/code}}
122 -
123 -(% class="auto-cursor-target" %)
124 -\\
125 125  {{/info}}
126 126  
127 127  ==== Direct Actions in JavaMonitor for Management Tasks ====
128 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.
119 +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 ##/wa/## request handler though, these management tasks use a new ##/admin/## 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 130  
131 131  List of available direct actions :
132 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}}
123 +* {{{*}info{*}}} : Returns details (number of deaths, state, etc.), in JavaScript Object Notation (JSON) as specified
124 +##info?##{{{}{*}type=all{*}}}
125 +##info?##{{{}{*}type=app&name=*{}}}{{color value="maroon"}}{{{}{*}AppName{*}{}}}{{/color}}
126 +##info?##{{{}{*}type=ins&name=*{}}}{{color value="maroon"}}{{{}{*}AppName{*}{}}}{{/color}}{{{}*\-*{}}}{{color value="maroon"}}{{{}{*}InstanceNumber{*}{}}}{{/color}}
137 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}}
128 +* {{{*}running{*}}} : Returns {{{*}YES{*}}} if **all** of the specified are running, ##NO## if not
129 +##running?##{{{}{*}type=all{*}}}
130 +##running?##{{{}{*}type=app&name=*{}}}{{color value="maroon"}}{{{}{*}AppName{*}{}}}{{/color}}
131 +##running?##{{{}{*}type=ins&name=*{}}}{{color value="maroon"}}{{{}{*}AppName{*}{}}}{{/color}}{{{}*\-*{}}}{{color value="maroon"}}{{{}{*}InstanceNumber{*}{}}}{{/color}}
142 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}}
133 +* {{{*}stopped{*}}} : Returns {{{*}YES{*}}} if **all** the specified is running, {{{*}NO{*}}} if not.
134 +##stopped?##{{{}{*}type=all{*}}}
135 +##stopped?##{{{}{*}type=app&name=*{}}}{{color value="maroon"}}{{{}{*}AppName{*}{}}}{{/color}}
136 +##stopped?##{{{}{*}type=ins&name=*{}}}{{color value="maroon"}}{{{}{*}AppName{*}{}}}{{/color}}{{{}*\-*{}}}{{color value="maroon"}}{{{}{*}InstanceNumber{*}{}}}{{/color}}
147 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}}
138 +* {{{*}bounce{*}}} : Returns {{{*}OK{*}}} after Bouncing (see description above) as specified
139 +##bounce?##{{{}{*}type=all{*}}}
140 +##bounce?##{{{}{*}type=app&name=*{}}}{{color value="maroon"}}{{{}{*}AppName{*}{}}}{{/color}}
151 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}}
142 +* {{{*}clearDeaths{*}}} : Returns {{{*}OK{*}}} after clearing deaths as specified
143 +##clearDeaths?##{{{}{*}type=all{*}}}
144 +##clearDeaths?##{{{}{*}type=app&name=*{}}}{{color value="maroon"}}{{{}{*}AppName{*}{}}}{{/color}}
155 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}}
146 +* {{{*}turnScheduledOn{*}}} : Returns {{{*}OK{*}}} after turning on scheduling as specified. Call ///turnScheduledOff// to do the opposite.
147 +##turnScheduledOn?##{{{}{*}type=all{*}}}
148 +##turnScheduledOn?##{{{}{*}type=app&name=*{}}}{{color value="maroon"}}{{{}{*}AppName{*}{}}}{{/color}}
149 +##turnScheduledOn?##{{{}{*}type=ins&name=*{}}}{{color value="maroon"}}{{{}{*}AppName{*}{}}}{{/color}}{{{}*\-*{}}}{{color value="maroon"}}{{{}{*}InstanceNumber{*}{}}}{{/color}}
160 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}}
151 +* {{{*}turnRefuseNewSessionsOn{*}}} : Returns {{{*}OK{*}}} after turning on "Refuse new sessions" as specified
152 +##turnRefuseNewSessionsOn?##{{{}{*}type=all{*}}}
153 +##turnRefuseNewSessionsOn?##{{{}{*}type=app&name=*{}}}{{color value="maroon"}}{{{}{*}AppName{*}{}}}{{/color}}
154 +##turnRefuseNewSessionsOn?##{{{}{*}type=ins&name=*{}}}{{color value="maroon"}}{{{}{*}AppName{*}{}}}{{/color}}{{{}*\-*{}}}{{color value="maroon"}}{{{}{*}InstanceNumber{*}{}}}{{/color}}
165 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}}
156 +* {{{*}turnRefuseNewSessionsOff{*}}} : Returns {{{*}OK{*}}} after turning off "Refuse new sessions" as specified
157 +##turnRefuseNewSessionsOff?##{{{}{*}type=all{*}}}
158 +##turnRefuseNewSessionsOff?##{{{}{*}type=app&name=*{}}}{{color value="maroon"}}{{{}{*}AppName{*}{}}}{{/color}}
159 +##turnRefuseNewSessionsOff?##{{{}{*}type=ins&name=*{}}}{{color value="maroon"}}{{{}{*}AppName{*}{}}}{{/color}}{{{}*\-*{}}}{{color value="maroon"}}{{{}{*}InstanceNumber{*}{}}}{{/color}}
170 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}}
161 +* {{{*}turnAutoRecoverOn{*}}} : Returns {{{*}OK{*}}} after turning on "Auto Recover" as specified
162 +##turnAutoRecoverOn?##{{{}{*}type=all{*}}}
163 +##turnAutoRecoverOn?##{{{}{*}type=app&name=*{}}}{{color value="maroon"}}{{{}{*}AppName{*}{}}}{{/color}}
164 +##turnAutoRecoverOn?##{{{}{*}type=ins&name=*{}}}{{color value="maroon"}}{{{}{*}AppName{*}{}}}{{/color}}{{{}*\-*{}}}{{color value="maroon"}}{{{}{*}InstanceNumber{*}{}}}{{/color}}
175 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}}
166 +* {{{*}turnAutoRecoverOff{*}}} : Returns {{{*}OK{*}}} after turning off "Auto Recover" as specified
167 +##turnAutoRecoverOn?##{{{}{*}type=all{*}}}
168 +##turnAutoRecoverOn?##{{{}{*}type=app&name=*{}}}{{color value="maroon"}}{{{}{*}AppName{*}{}}}{{/color}}
169 +##turnAutoRecoverOn?##{{{}{*}type=ins&name=*{}}}{{color value="maroon"}}{{{}{*}AppName{*}{}}}{{/color}}{{{}*\-*{}}}{{color value="maroon"}}{{{}{*}InstanceNumber{*}{}}}{{/color}}
180 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}}
171 +* {{{*}forceQuit{*}}} : Returns {{{*}OK{*}}} after force quitting as specified. This could be useful to call from a monitoring system.
172 +##forceQuit?##{{{}{*}type=all{*}}}
173 +##forceQuit?##{{{}{*}type=app&name=*{}}}{{color value="maroon"}}{{{}{*}AppName{*}{}}}{{/color}}
174 +##forceQuit?##{{{}{*}type=ins&name=*{}}}{{color value="maroon"}}{{{}{*}AppName{*}{}}}{{/color}}{{{}*\-*{}}}{{color value="maroon"}}{{{}{*}InstanceNumber{*}{}}}{{/color}}
185 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}}
176 +* {{{*}stop{*}}} : Returns {{{*}OK{*}}} after calling "Stop" as specified
177 +##stop?##{{{}{*}type=all{*}}}
178 +##stop?##{{{}{*}type=app&name=*{}}}{{color value="maroon"}}{{{}{*}AppName{*}{}}}{{/color}}
179 +##stop?##{{{}{*}type=ins&name=*{}}}{{color value="maroon"}}{{{}{*}AppName{*}{}}}{{/color}}{{{}*\-*{}}}{{color value="maroon"}}{{{}{*}InstanceNumber{*}{}}}{{/color}}
190 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}}
181 +* {{{*}start{*}}} : Returns {{{*}OK{*}}} after calling "Start" as specified
182 +##start?##{{{}{*}type=all{*}}}
183 +##start?##{{{}{*}type=app&name=*{}}}{{color value="maroon"}}{{{}{*}AppName{*}{}}}{{/color}}
184 +##start?##{{{}{*}type=ins&name=*{}}}{{color value="maroon"}}{{{}{*}AppName{*}{}}}{{/color}}{{{}*\-*{}}}{{color value="maroon"}}{{{}{*}InstanceNumber{*}{}}}{{/color}}
195 195  
196 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}}
187 +##[[http://monitorhost:port/cgi-bin/WebObjects/JavaMonitor.woa/admin/info?type=all]]##
198 198  
199 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}}
190 +##[[http://monitorhost:port/cgi-bin/WebObjects/JavaMonitor.woa/admin/info?type=app&name=AjaxExample]]##
201 201  
202 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}}
193 +##[[http://monitorhost:port/cgi-bin/WebObjects/JavaMonitor.woa/admin/info?type=ins&name=AjaxExample-1]]##
204 204  
205 205  ==== Remote Control via REST Routes (for JavaMonitor) ====
206 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.
197 +If the control offered by the Direct Actions isn't enough, JavaMonitor allows additional control via [[REST>>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 ##?pw=XXXX## to the URLs if your JavaMonitor is password protected.
208 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 211  Examples of REST calls :
212 212  
213 -{{code title="Adding a New Host" 0="none"}}
201 +{{code title="Adding a New Host"}}
214 214  
215 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 216  
217 217  {{/code}}
218 218  
219 -(% class="auto-cursor-target" %)
220 -\\
207 +{{code title="Fetching Details for All Applications"}}
221 221  
222 -{{code title="Fetching Details for All Applications" 0="none"}}
223 -
224 224  curl -X GET http://monitorhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications.json
225 225  
226 226  {{/code}}
227 227  
228 -(% class="auto-cursor-target" %)
229 -\\
213 +{{code title="Adding a New Application"}}
230 230  
231 -{{code title="Adding a New Application" 0="none"}}
232 -
233 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 234  
235 235  {{/code}}
236 236  
237 -(% class="auto-cursor-target" %)
238 -\\
219 +{{code title="Delete an Application"}}
239 239  
240 -{{code title="Delete an Application" 0="none"}}
241 -
242 242  curl -X DELETE http://monitorhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample.json
243 243  
244 244  {{/code}}
245 245  
246 -(% class="auto-cursor-target" %)
247 -\\
225 +{{code title="Adding a New Instance"}}
248 248  
249 -{{code title="Adding a New Instance" 0="none"}}
227 +curl -X GET http://monitorhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample/addInstance&host=localhost
250 250  
251 -curl -X GET http://monitorhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample/addInstance?host=localhost
252 -
253 253  {{/code}}
254 254  
255 -(% class="auto-cursor-target" %)
256 -\\
231 +{{code title="Delete an Instance"}}
257 257  
258 -{{code title="Delete an Instance" 0="none"}}
259 -
260 260  curl -X GET http://monitorhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample/deleteInstance?id=1
261 261  
262 262  {{/code}}
263 263  
264 -(% class="auto-cursor-target" %)
265 -\\
237 +{{code title="Configuring the Site"}}
266 266  
267 -{{code title="Configuring the Site" 0="none"}}
268 -
269 269  curl -X PUT -d "{woAdaptor:'www.mydomain.com'}" http://monitorhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mSiteConfig.json
270 270  
271 271  {{/code}}
... ... @@ -274,221 +274,148 @@
274 274  
275 275  ==== Remote Control via REST Routes (for wotaskd) ====
276 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.
247 +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 ##?pw=XXXX## to the URLs if wotaskd is password protected.
278 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.
249 +{{code title="Fetching Details for All Applications"}}
280 280  
281 -\\
282 -
283 -{{code title="Fetching Details for All Applications" 0="none"}}
284 -
285 285  curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications.json
286 286  
287 287  {{/code}}
288 288  
289 -(% class="auto-cursor-target" %)
290 -\\
255 +{{code title="Adding a New Application"}}
291 291  
292 -{{code title="Adding a New Application" 0="none"}}
293 -
294 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 295  
296 296  {{/code}}
297 297  
298 -(% class="auto-cursor-target" %)
299 -\\
261 +{{code title="Delete an Application"}}
300 300  
301 -{{code title="Delete an Application" 0="none"}}
302 -
303 303  curl -X DELETE http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample.json
304 304  
305 305  {{/code}}
306 306  
307 -(% class="auto-cursor-target" %)
308 -\\
267 +{{code title="Adding a New Instance"}}
309 309  
310 -{{code title="Adding a New Instance" 0="none"}}
269 +curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample/addInstance&host=localhost
311 311  
312 -curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample/addInstance?host=localhost
313 -
314 314  {{/code}}
315 315  
316 -(% class="auto-cursor-target" %)
317 -\\
273 +{{code title="Delete an Instance"}}
318 318  
319 -{{code title="Delete an Instance" 0="none"}}
320 -
321 321  curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample/deleteInstance?id=1
322 322  
323 323  {{/code}}
324 324  
325 -(% class="auto-cursor-target" %)
326 -\\
279 +{{code title="Configuring the Site"}}
327 327  
328 -{{code title="Configuring the Site" 0="none"}}
329 -
330 330  curl -X PUT -d "{woAdaptor:'www.mydomain.com'}" http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mSiteConfig.json
331 331  
332 332  {{/code}}
333 333  
334 -(% class="auto-cursor-target" %)
335 -\\
285 +{{code title="Starting all applications"}}
336 336  
337 -{{code title="Starting all applications" 0="none"}}
338 -
339 339  curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/start
340 340  
341 341  {{/code}}
342 342  
343 -(% class="auto-cursor-target" %)
344 -\\
291 +{{code title="Starting a specific application (AjaxExample in this example)"}}
345 345  
346 -{{code title="Starting a specific application (AjaxExample in this example)" 0="none"}}
347 -
348 348  curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample/start
349 349  
350 350  {{/code}}
351 351  
352 -(% class="auto-cursor-target" %)
353 -\\
297 +{{code title="Starting a specific instance of an application (instance 1 of AjaxExample in this example)"}}
354 354  
355 -{{code title="Starting a specific instance of an application (instance 1 of AjaxExample in this example)" 0="none"}}
356 -
357 357  curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample/start?id=1
358 358  
359 359  {{/code}}
360 360  
361 -(% class="auto-cursor-target" %)
362 -\\
303 +{{code title="Stopping all applications"}}
363 363  
364 -{{code title="Stopping all applications" 0="none"}}
365 -
366 366  curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/stop
367 367  
368 368  {{/code}}
369 369  
370 -(% class="auto-cursor-target" %)
371 -\\
309 +{{code title="Stopping a specific application (AjaxExample in this example)"}}
372 372  
373 -{{code title="Stopping a specific application (AjaxExample in this example)" 0="none"}}
374 -
375 375  curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample/stop
376 376  
377 377  {{/code}}
378 378  
379 -(% class="auto-cursor-target" %)
380 -\\
315 +{{code title="Stopping a specific instance of an application (instance 1 of AjaxExample in this example)"}}
381 381  
382 -{{code title="Stopping a specific instance of an application (instance 1 of AjaxExample in this example)" 0="none"}}
383 -
384 384  curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample/stop?id=1
385 385  
386 386  {{/code}}
387 387  
388 -(% class="auto-cursor-target" %)
389 -\\
321 +{{code title="Force quit all applications"}}
390 390  
391 -{{code title="Force quit all applications" 0="none"}}
392 -
393 393  curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/forceQuit
394 394  
395 395  {{/code}}
396 396  
397 -(% class="auto-cursor-target" %)
398 -\\
327 +{{code title="Force quit a specific application (AjaxExample in this example)"}}
399 399  
400 -{{code title="Force quit a specific application (AjaxExample in this example)" 0="none"}}
401 -
402 402  curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample/forceQuit
403 403  
404 404  {{/code}}
405 405  
406 -(% class="auto-cursor-target" %)
407 -\\
333 +{{code title="Force quit a specific instance of an application (instance 1 of AjaxExample in this example)"}}
408 408  
409 -{{code title="Force quit a specific instance of an application (instance 1 of AjaxExample in this example)" 0="none"}}
410 -
411 411  curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample/forceQuit?id=1
412 412  
413 413  {{/code}}
414 414  
415 -(% class="auto-cursor-target" %)
416 -\\
339 +{{code title="Information about all applications"}}
417 417  
418 -{{code title="Information about all applications" 0="none"}}
419 -
420 420  curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/info
421 421  
422 422  {{/code}}
423 423  
424 -(% class="auto-cursor-target" %)
425 -\\
345 +{{code title="Information about a specific application (AjaxExample in this example)"}}
426 426  
427 -{{code title="Information about a specific application (AjaxExample in this example)" 0="none"}}
428 -
429 429  curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample/info
430 430  
431 431  {{/code}}
432 432  
433 -(% class="auto-cursor-target" %)
434 -\\
351 +{{code title="Information about a specific instance of an application (instance 1 of AjaxExample in this example)"}}
435 435  
436 -{{code title="Information about a specific instance of an application (instance 1 of AjaxExample in this example)" 0="none"}}
437 -
438 438  curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample/info?id=1
439 439  
440 440  {{/code}}
441 441  
442 -(% class="auto-cursor-target" %)
443 -\\
357 +{{code title="Check if all applications are running"}}
444 444  
445 -{{code title="Check if all applications are running" 0="none"}}
446 -
447 447  curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/isRunning
448 448  
449 449  {{/code}}
450 450  
451 -(% class="auto-cursor-target" %)
452 -\\
363 +{{code title="Check if a specific application is running (AjaxExample in this example)"}}
453 453  
454 -{{code title="Check if a specific application is running (AjaxExample in this example)" 0="none"}}
455 -
456 456  curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample/isRunning
457 457  
458 458  {{/code}}
459 459  
460 -(% class="auto-cursor-target" %)
461 -\\
369 +{{code title="Check if a specific instance of an application is running (instance 1 of AjaxExample in this example)"}}
462 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 465  curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample/isRunning?id=1
466 466  
467 467  {{/code}}
468 468  
469 -(% class="auto-cursor-target" %)
470 -\\
375 +{{code title="Check if all applications are stopped"}}
471 471  
472 -{{code title="Check if all applications are stopped" 0="none"}}
473 -
474 474  curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/isStopped
475 475  
476 476  {{/code}}
477 477  
478 -(% class="auto-cursor-target" %)
479 -\\
381 +{{code title="Check if a specific application is stopped (AjaxExample in this example)"}}
480 480  
481 -{{code title="Check if a specific application is stopped (AjaxExample in this example)" 0="none"}}
482 -
483 483  curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample/isStopped
484 484  
485 485  {{/code}}
486 486  
487 -(% class="auto-cursor-target" %)
488 -\\
387 +{{code title="Check if a specific instance of an application is stopped (instance 1 of AjaxExample in this example)"}}
489 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 492  curl -X GET http://wotaskdhost:port/cgi-bin/WebObjects/JavaMonitor.woa/ra/mApplications/AjaxExample/isStopped?id=1
493 493  
494 494  {{/code}}
... ... @@ -495,4 +495,4 @@
495 495  
496 496  === Troubleshooting ===
497 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.
395 +If JavaMonitor won't start up check the [[troubleshooting deployment>>Troubleshooting Deployment]] section. In particular pay attention to the [[WOTaskd Didn't Start>>Troubleshooting Deployment]] Q&A.
WonderJavaMonitor.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.XWikiGuest
Size
... ... @@ -1,1 +1,0 @@
1 -32.7 KB
Content
XWiki.XWikiComments[0]
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.dholt
Comment
... ... @@ -1,3 +1,0 @@
1 -In Misc it says that wotaskd and JavaMonitor are not built fully embedded. Is this still true? I thought with the move to Hudson, that the Applications were fully embedded at this location: [[http:~~/~~/webobjects.mdimension.com/hudson/job/Wonder54/lastSuccessfulBuild/artifact/dist/>>url:http://webobjects.mdimension.com/hudson/job/Wonder54/lastSuccessfulBuild/artifact/dist/||rel="nofollow" shape="rect" class="external-link"]]
2 -
3 -Can anyone confirm this so that we remove this information if incorrect?
Date
... ... @@ -1,1 +1,0 @@
1 -2010-11-26 19:47:32.0
XWiki.XWikiComments[1]
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.probert
Comment
... ... @@ -1,3 +1,0 @@
1 -The wotaskd/Monitor builds on webobjects.mdimension.com are fully embedded, but if you build them yourself, they are not fully embedded unless you use the "-Ddeployment.standalone=true" argument.
2 -
3 -And I just saw that the Wonder-latest-Applications* archive doesn't exist anymore in Hudson, but wotaskd and JavaMonitor are available as downloads and they are fully embedded.
Date
... ... @@ -1,1 +1,0 @@
1 -2010-11-26 20:40:32.0
XWiki.XWikiComments[2]
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.dholt
Comment
... ... @@ -1,1 +1,0 @@
1 -I have updated that section. Thanks Pascal.
Date
... ... @@ -1,1 +1,0 @@
1 -2010-11-26 21:48:35.0
XWiki.XWikiComments[3]
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.tedpet
Comment
... ... @@ -1,3 +1,0 @@
1 -On a Centos VM that I just created I tried to build both wotaskd/Monitor. There were errors until I told ant where the frameworks lived.
2 -
3 -ant -Dwo.system.frameworks=/opt/WO/Library/Frameworks frameworks deployment.tools -Ddeployment.standalone=true
Date
... ... @@ -1,1 +1,0 @@
1 -2016-07-01 08:21:16.993