ContextualWorkManager has been changed over to present a ScheduledExecutorService for applications to use, rather than a WorkManager.

Starting up the Admin service now works.  AdminService is not yet fully implemented.
10 files changed
tree: 643f8bccee2307078c91ca0378821866ec02a22c
  1. admin-app/
  2. admin-module/
  3. admin-svc/
  4. browser/
  5. browser-module/
  6. product/
  7. reggie-module/
  8. river-container-core/
  9. river-container-maven-plugin/
  10. river-hsm/
  11. src/
  12. test-container/
  13. transient-mahalo-module/
  14. transient-outrigger-module/
  15. user-docs/
  16. .gitignore
  18. NOTICE
  19. pom.xml


Initial development on Apache River Container

Building from Source

mvn clean install

Running Services in the Container

cd product/target/product*
sh bin/ [profile] arg*

If you don‘t specify [profile] the ‘default’ profile will be used. ‘arg*’ isn’t really used much in the service container profiles (like ‘default’).

Services are packaged into a jar file and placed into the ‘deploy’ folder of the profile that you want to run. When you run the container, all services in the profile are started up. The default profile monitors the deploy folder each 5s and starts up any new services you put into the deploy folder. The ‘default’ profile already includes a transient reggie instance and a transient mahalo instance. You can add your own services to this folder as well.

Have a look at the ‘reggie-module’ or ‘mahalo-module’ target folders to see what the archive should look like. Startup parameters are in ‘’. ‘’ calls out the startup class and the parameters to its constructor (typically the name of the configuration file and any overrides to the config).

Running Client Applications

cd product/target/product*
sh bin/ client AppName arg*

Starts up the container using the ‘client’ profile, which then starts the client that is named by ‘AppName’ (and only that client, no matter if there are multiple apps in the deploy folder).

The container will host client applications, making the downloads available via a codebase server, and setting up all the security polices that are required. Client apps are packaged much like the services mentioned above.

Service Browser

cd product/target/product*
sh bin/ client browser

Starts up the service browser.

Sample Service

Reggie-module and mahalo-module might be interesting samples. For a simpler ‘hello-world’ example with a Maven build, see