The Knopflerfish HTTP/HTML OSGi console is a small servlet that can be run on any OSGi platform with an installed HTTP server.
When started, the servlet registers at /servlet/console and allows access to the standard framework functions as bundle installation (both from URLs and using browser file upload), start, stop, update and uninstall. Additionally, detail info on a bundle such as state, manifest and services can be displayed.
Optionally, the HTTP console can request a login/pwd before enabling access. See configuration for details.
The HTTP console has been tested on Knopflerfish, Eclipse 3.0 and Oscar. It also runs well on Pocket PC (tested using KF on the IBM J9 VM).
The main screen lists all installed bundles. One or more bundles can be selected by marking the check box on the left. After selecting bundles, the operations available as toolbar icons can be performed.
Source is available via KF subversion
The toolbar display a set of command icons. When an icon is selected, the command will be performed. Any command result or errors will be displayed to the right of the bundle list.
![]() |
Reload page |
![]() |
Ask for a local bundle file, upload the file and install the bundle |
![]() |
Ask for a bundle URL and install this bundle |
![]() |
Start selected bundles |
![]() |
Stop selected bundles |
![]() |
Update selected bundles |
![]() |
Uninstall selected bundles |
![]() |
Info about selected bundles. If no bundle is selected, show framework info |
![]() |
Show help page |
Each bundle is displayed using an icon, the bundle's name and the bundle description. If a bundle's icon is clicked, the bundle is selected, and the bundle info page is displayed.
![]() |
Bundle with activator |
![]() |
Started bundle with activator |
![]() |
Bundle without activator |
![]() |
Started bundle without activator |
The HTTP console can be configured using system properties:
Name | Description | Value type | Default value |
---|---|---|---|
org.knopflerfish.httpconsole.alias | Alias for servlet registration. If set to '/', the http root will used for the console. | String | /servlet/console |
org.knopflerfish.httpconsole.filter | Filter string for matching HttpServices. This can be used to only show the console in some registered HttpServices. | String | (objectclass=org.osgi.service.http.HttpService) |
org.knopflerfish.httpconsole.requirelogin | If true, require login, using name and password. | boolean | false |
org.knopflerfish.httpconsole.user | User name required for login. | String | admin |
org.knopflerfish.httpconsole.pwd | User password required for login. | String | admin |
org.knopflerfish.httpconsole.expirationtime | Expiration time for login sessions, in seconds. After this time, the user will be logged out. | int (seconds) | 600 |