skysail-webconsole

an alternative to the (OSGi) felix webconsole

Motivation

Although I like the felix webconsole, more often than not I faced issues with integrating it with an existing codebase. OSGi is all about modularity, meaning (amongst others) that the OSGi framework makes sure that the runtime dependencies your code relies on are met. But, in the case of something like an OSGi webconsole, any dependency I have is too much. I want to install the webconsole in any kind of OSGi environment, and I want it to work immediately. I do not want something like "Unresolved requirement: Import-Package: org.apache.commons.fileupload; version="[1.2.0,2.0.0)"", which is what I get if I put the felix webconsole into eclipse Mars.

So, this bundle is an effort to provide a single bundle, ready to be dropped into any (recent) OSGi runtime, starting up an embedded server which gives me an insight into my OSGi application - even if the application doesn't start up.

Status

just started, needs serious polishing, internally and visually... - just a prove of concept. But it's already getting helpful (at least for me ;)).

Version

0.1.17

Screenshots

Bundles Overview:

Package Dependencies Graph

Bundle Details

Demo

this link should be working most of the time.

Limitations

• currently, the internal server will always start on port 2002.
• please be aware that there is no security concept applied yet.

Technology

• OSGi (Felix, bndtools)
• angular2
• d3.js

Features List

Category	Feature	State / in Version
Bundles
	Bundles Overview	0.1.1
	Bundle Detail Overview	0.1.1
	Bundle Exported Packages	0.1.7
	Bundle Imported Packages	0.1.7
	Bundle Imported Pkgs. Resolution	0.1.7
	Bundle Capabilities	0.1.7
	Bundle Requirements	0.1.7
	Bundle Manifest View	0.1.7
Services
	Services Overview	0.1.1
	Service Detail Overview	0.1.7
Packages
	Packages Overview	0.1.7
Logs
	Overview	0.1.7
Runtime
	Overview	0.1.12

Try it (and build yourself)

• clone or download this github repository and run "gradlew clean build"
• in the folder "... skysail-webconsole/webconsole.all/generated/" a jar file called webconsole.all should be created
• install it (like described below) using the OSGi console of a running OSGi application like this: "install file:///C:/git/skysail-webconsole/webconsole.all/generated/webconsole.all.jar"

Try it (with downloaded jar)

• Start an OSGi framework where you have access to the console (e.g. ./eclipse -console)
• to use the current build, run "install http://downloads.skysail.io/skysail-webconsole/webconsole.all.jar" in the console
• get the bundle id of the new webconsole bundle (e.g. by running "ss" (equinox) or "lb" (felix)
• start the bundle: "start <bundleId>"
• point your browser to "http://localhost:2002" (sorry, port is fixed for now) - chrome is more fun here than firefox than ie...