From Fedora Project Wiki
(Feature has been announced on devel-announce mailing list on 2013-01-30)
(Feature is going to be dropped from F19 as consulted with the owner)
 
(11 intermediate revisions by 2 users not shown)
Line 4: Line 4:
Improved monitoring and serviceability tool for Java applications
Improved monitoring and serviceability tool for Java applications


== Owner ==
== Owner(s) ==
* Name: [[User:omajid| Omair Majid]]
* Name: [[User:omajid| Omair Majid]], [[User:jerboaa| Severin Gehwolf]]
* Email: omajid@redhat.com
* Email: omajid@redhat.com, sgehwolf@redhat.com


== Current status ==
== Current status ==
* Targeted release: [[Releases/19 | Fedora 19 ]]  
* Targeted release: [[Releases/19 | Fedora 19 ]]  
* Last updated: 2013-01-28
* Last updated: 2013-03-20
* Percentage of completion: 0%
* Percentage of completion: 80%


== Detailed Description ==
== Detailed Description ==
Line 30: Line 30:
== How To Test ==
== How To Test ==


Thermostat developers and packagers will test Thermostat using upstream test cases, as well as custom ones.
Thermostat developers and packagers will test Thermostat using upstream test cases, as well as custom ones. Some Thermostat hackers will also organize a [[Test_Day:2013-03-15_Thermostat| Fedora test day on Thermostat]].


Others can test that thermostat works as expected by following these steps. No special hardware is required.
Others can test that thermostat works as expected by following these steps. No special hardware is required.
Line 38: Line 38:
To test the command line interface of thermostat:
To test the command line interface of thermostat:
<pre>
<pre>
$ thermostat --help
$ thermostat help
$ thermostat help service
$ thermostat help service
$ thermostat shell
$ thermostat shell
Line 58: Line 58:


== User Experience ==
== User Experience ==
Thermostat 1.0 will not introduce major user interface changes. The command line will continue working mostly as before and the GUI client will look and behave mostly as before. A few new command line commands will appear (such as webservice) and some new tabs will appear in the GUI client to display additional information.
Thermostat 1.0 will not introduce major user interface changes. The command line will continue working mostly as before and the GUI client will look and behave mostly as before. A few new command line commands will appear and some new tabs will appear in the GUI client to display additional information.


Thermostat 1.0 will include a new and experimental eclipse plugin that developers can use instead of the regular GUI client.
Thermostat 1.0 will include a new and experimental eclipse plugin prototype that developers can use instead of the regular GUI client.


== Dependencies ==
== Dependencies ==
Line 80: Line 80:
* See [[Talk:Features/Thermostat1.0]]
* See [[Talk:Features/Thermostat1.0]]


<!-- [[Category:FeatureAnnounced]] -->
[[Category:FeaturePageIncomplete]]
[[Category:FeatureReadyForWrangler]]
<!-- When your feature page is completed and ready for review -->
<!-- When your feature page is completed and ready for review -->
<!-- remove Category:FeaturePageIncomplete and change it to Category:FeatureReadyForWrangler -->
<!-- remove Category:FeaturePageIncomplete and change it to Category:FeatureReadyForWrangler -->
<!-- After review, the feature wrangler will move your page to Category:FeatureReadyForFesco... if it still needs more work it will move back to Category:FeaturePageIncomplete-->
<!-- After review, the feature wrangler will move your page to Category:FeatureReadyForFesco... if it still needs more work it will move back to Category:FeaturePageIncomplete-->
<!-- A pretty picture of the page category usage is at: https://fedoraproject.org/wiki/Features/Policy/Process -->
<!-- A pretty picture of the page category usage is at: https://fedoraproject.org/wiki/Features/Policy/Process -->

Latest revision as of 12:05, 15 May 2013

Thermostat 1.0

Summary

Improved monitoring and serviceability tool for Java applications

Owner(s)

Current status

  • Targeted release: Fedora 19
  • Last updated: 2013-03-20
  • Percentage of completion: 80%

Detailed Description

Thermostat is a serviceability and instrumentation tool for OpenJDK. The 1.0 release of thermostat brings a number of new features that developers may find very useful.

  • More information for Hosts and Java Virtual Machines being monitored
  • A stable API for external plugin developers
  • Ability to use thermostat, securely, in a network or a cluster
  • An experimental eclipse plugin that lets developers use eclipse as a thermostat GUI

The goal is to get the 1.0 release of thermostat into Fedora 19. If upstream also releases 1.1 before the alpha deadline for Fedora 19, we may use that instead.

Benefit to Fedora

Thermostat 1.0 makes Fedora a better platform for Java developers to run their software on, since it provides tools to examine their applications as they are running, whether it's on Fedora as a single developer's OS or Fedora as an OS on a cluster node.

Scope

Only the Thermostat packages will be affected by this change. The thermostat package(s) will be updated to the 1.0 release as soon as upstream releases it. All of thermostat's (current) dependencies are already in Fedora.

How To Test

Thermostat developers and packagers will test Thermostat using upstream test cases, as well as custom ones. Some Thermostat hackers will also organize a Fedora test day on Thermostat.

Others can test that thermostat works as expected by following these steps. No special hardware is required.

To install thermostat, # yum install thermostat

To test the command line interface of thermostat:

$ thermostat help
$ thermostat help service
$ thermostat shell

To test the graphical interface of thermostat in a single-machine case:

$ thermostat service &

optionally run other Java programs, such as eclipse 

$ thermostat gui

A graphical application should show up showing the user's machine and all the Java processes running on it.

The examples shown in the User Guide should all work too.

User Experience

Thermostat 1.0 will not introduce major user interface changes. The command line will continue working mostly as before and the GUI client will look and behave mostly as before. A few new command line commands will appear and some new tabs will appear in the GUI client to display additional information.

Thermostat 1.0 will include a new and experimental eclipse plugin prototype that developers can use instead of the regular GUI client.

Dependencies

None. Thermostat is a stand-alone feature.

Contingency Plan

Prior to the 1.0 release, we will work with upstream to identify and fix major bugs and regressions on Fedora. If there are showstopper bugs, we will backport fixes or use the previous stable release.

If upstream delays the 1.0 release, we will use the latest stable release. This release may not have a stable plugin API.

Documentation

Release Notes

  • Fedora 19 includes Thermostat 1.0, the first API-stable release of thermostat, a monitoring, instrumentation and serviceability tool for OpenJDK.

Comments and Discussion