Gyrex 1.3 Changelog

If you want to have a more detailed into what has changed with Gyrex 1.3, here’s the Changelog

gyrex 1.3 changelog (compared to 1.2)

– complete maven build support
– bundle directory restructuring
– fixed unit tests
– introduced SystemSetting concept for better property access (Gunnar)
– Console command for updating context service filters
– introduce try-with-ressources
– Job definitions by annotations
– inject job params and logger
– Support Jersey’s per request tracing using X-Jersey-Trace-Accept header
– make JMX connector start async
– add latency of jetty requests to log
– support WebServlet annotation in ScanningJaxRSApplication
– Gyrex admin ui: enhancements in job page
– Updates: Eclipselink 2.6, Gemnini JPA 1.2
– Jetty 9.1 Servlet 3.1
– Bug 411016: Introduce Solr cloud repositories and configuration
– distributed event bus
– Updates: RAP 2.3
– Bug 413417: Fallback to “invalid” if there is not job id on load
– Bug 432561: Compute and store node addresses in ZooKeeper
– websocket based event transport
– Update: Equinox 3.10

Gyrey 1.3. Release

As part of the Eclipse Luna release train the Gyrex development team has released version 1.3 of Eclipse Gyrex. Eclipse Gyrex is an cluster application framework on top of Equinox OSGi. It provides seamless and pain-free creation and operation of OSGi clusters.

With Gyrex 1.3. the following new functionality is available:

Distributed EventBus

With the EventBus it’s now possible to distribute events between cluster nodes. Events can be of any type, i.e. they don’t need to implement a specific interface or extend an abstract class. This allows for a broad set of use-cases supporting pojos as well as sophisticated objects entities. Out of the box, strings byte arrays and byte buffers are supported event types. The (de-)serialization of event objects is extensible so that any preferred serialization mechanism can be used. Event handling is supported using either annotations on any public method with a compatible signature or by implementing a handler interface. They will be triggered once events of those types are distributed. With the EventBus feature you can support use cases like cluster wide cache invalidation of local (in-process) caches.

Servlet 3.1 API and WebSockets in JAX-RS application

Gyrex applications are mainly focused on providing REST-API resources, but with 1.3 it’s now also very easy to provide web sockets in your application. In addition to JAX-RS annotated resources and provides, servlets annotated with @WebServlet will be found and deployed. Also based on annotations you can build web socket endpoints and once you’ve configured your application in the Gyrex Admin Console and map it to an URL, the web socket is available immediately on all cluster nodes.

Of course, servlets support dependency injection using the @Inject JSR-330 DI mechanism, which includes injection of tenant specific objects (in a multi-tenant environment) as well as OSGi service proxies.

New Editor for Gyrex Context preferences in Admin Console

The web-based Admin Console got a new editor for modifying Gyrex context preferences. Previously, it was possible to modify preferences from the Gyrex shell (via telnet or ssh). The new editor provides a generic way to manage the preferences in a browser and will help you to more easily introduce and use preferences in your application.

Dependency Injection in distributed Eclipse Jobs API

The development of batch processing using the Eclipse Jobs API now support dependency injection. Instead of implementing and providing a custom JobProvider, Gyrex provides a ScanningJobProviderComponent implementation which can be registered as an OSGi DS component by any bundle. The component will scan the registering bundle for Eclipse Jobs annotated with @JobType. The jobs instances will be created on demand and support dependency injection using the @Inject JSR-330 DI mechanism, which includes injection of tenant specific objects (in a multi-tenant environment) as well as OSGi service proxies.

Dependency updates

With Gyrex 1.3. we’ve updated many of the tools and dependencies we use in Gyrex. Most notably are the upgrades of Jetty 9.1,  RAP 2.3 and EclipseLink 2.5.


Gyrex 1.3 can be downloaded here:

For more information, support and contributor engagement please visit

Gyrex 1.1 Released as part of Juno

It’s the second time Gyrex participated in the Eclipse Simultaneous Release Train. We released our 1.1 version together with Juno.

Gyrex 1.1 can be downloaded here:

The release review slides as well as the IP log is available here:

We also added new tutorials together with this release:

New Administration UI

Gyrex 1.1 contains a complete re-work of the Administration UI. This was possible because of some interesting new features in RAP 1.5. Gyrex is Built On RAP.

In addition to the Admin UI, logging and debugging has been improved in this release as well as the ZooKeeper connection recovery. Gyrex includes the latest Jetty 8.1.4 and Equinox 3.8 (Juno) versions.

Gyrex 1.0 Available

It’s my pleasure today to announce the general availability of version 1.0 of Gyrex. It’s a great milestone that finally brings us out of incubation. It emphasizes the fact the Gyrex is used in production today. We’ve been using it for a couple of years now.

Gyrex 1.0 can be downloaded here:

The release review slides as well as the IP log is available here:

I’m currently update the administration guide with the new features. There is also some interesting stuff in the pipeline for our upcoming 1.1 release that will be part of Juno. As always, please don’t hesitate to open bugs on issues you came across or leave feedback in this blog and/or on the forum.

Happy downloading!

How we do release engineering?

One of the challenging parts at Eclipse is doing the release engineering work. Large projects may have dedicated resources as well as well established processes. We don’t. However, I like the way the Eclipse project is doing their builds. They have (over simplified) a “” file that contains a list of bundles and a SCM tag to use. They are called map files and they drive the build.

For a long piece of Eclipse history, the map files were tagged manually by hand. Whenever a committer modified a bundle (aka. plug-in or feature). He also had to release those changes by tagging the bundle and updating the map file. When the Eclipse project migrated to Git they automated this process. A script is started before the real build begins. The script scans a branch for new commits since the last tag. If any new commits are found, the repository will be tag with a new tag and the map file will be updated.

I started migrating Gyrex to Git last week. The CVS to Git part was easy. Our build is running again. Thanks to an update to PDE Build it fully supports Git map files. Our process has always been as close to the Eclipse project as possible. We also use the map files which drive our build. We also used to tag our (CVS) projects by hand and we also used to update the map files by hand. Now with the change to Git we’ll also stop doing that.

I took the scripts from the Eclipse project and adapted them. We don’t run the script as part of our Hudson build job. Due to security concerns, the Hudson machines aren’t able to push changes back to Git repos. Thus, I run the tagging scripts on by cron. At the end of the run, a Hudson build will be triggered by the script via and Hudson API call.

You can find the scripts here:

Gyrex 0.11 Available

A few days ago we silently published the official repo for our second official Eclipse release. Gyrex 0.11 is now available. The IP log as well as the release review slides are available here.

Gyrex 0.11 can be downloaded here:

There is also a change in our development plan. Gyrex is now used in quite a few production deployments so we feel it’s time aiming for our 1.0 release together with graduation in March 2012. There is still some interesting new stuff we are working on for our 1.0 release.  But the main API has been stable for quite a few months now. Stay tuned!

Hacking Session Today 3:30pm @ EclipseCon Europe

Hey, just a quick reminder that there will be a hacking session at EclipseCon Europe today at 3:30pm (15:30 Uhr) in Seminarräume 5.

Developing Runtime Applications with Eclipse Gyrex
Thursday, 15:30, Seminarräume 5

Bring your laptop with you and we’ll build a small sample application for you to play with.

Website Update and Tutorials Published

Hurray, long story short, I finally managed to switch the Gyrex website to the new default template as well as structure. Here is a copy of the posting I just sent to the Gyrex newsgroup.


Today I published some updates to our main website. We now use the new
default look on the landing page as well as the default page structure.

Together with the update I also started creating better tutorials as
well as some simple screen casts. All is available through our new
documentation "hub"

If you have any recommendations please let me know!


So yes, we are making progress. Stay tuned for some more announcements now that I got some cycles to work on the interesting stuff again.

Oh and btw, we now have this:


Gyrex is alive!

Great news guys, Gyrex is alive. Our name change review got approved and CloudFree will now be renamed to Gyrex.

Meet us at EclipseCon! There will be a BoF on Monday evening (Room 201, 20:45-22:00). The scheduling is a bit unfortunate because there is the Jetty BoF in parallel. We make heavy use of Jetty so I’d love to attent this BoF too. Maybe we can finish a bit earlier and join the Jetty BoF later?

See you @ EclipseCon! 🙂