kaui-standalone

Self-contained Kaui application. It mounts the following engines:

• Kaui: the core administrative UI
• The Analytics UI (available when the Analytics plugin is installed)
• The KPM UI (available when the KPM plugin is installed)
• The AvaTax administrative module (available when the AvaTax plugin is installed)

Release builds are available on Maven Central with coordinates org.kill-bill.billing.kaui:kaui-standalone.

Kill Bill compatibility

Kaui version	Kill Bill version
0.7.y	0.16.z
0.8.y	0.18.z (Rails 4)
0.9.y	0.18.z (Rails 5, where z >= 13)
1.x.y	0.20.z (Rails 5)
2.0.y	0.22.z (Rails 5)
2.1.y	0.24.z (Rails 6)
3.x.y	0.24.z (Rails 7)

Run

This is a standard Rails project:

bundle install
rails s

When using your own database, make sure to install the DDL file from Kaui.

• Kill Bill client configuration can be found in config/initializers/killbill_client.rb
• Database configuration can be found in config/database.yml

Additionally, the project can be packaged as a self-contained war. Builds are available on Maven Central. Simply drop the war in your container of choice (e.g. Tomcat).

We also provide Docker images.

Build

You need at least jruby-9.1.14.0.

To create a self-contained war:

bundle install && \
export RAILS_ENV=production && \
bundle exec rake assets:clobber assets:precompile && \
bundle exec warble

Alternatively, if you want to create a self-executable war:

bundle install && \
export RAILS_ENV=production && \
bundle exec rake assets:clobber assets:precompile && \
bundle exec warble executable war

You can then run it using:

java -Dkaui.db.adapter=mariadb \
     -Dkaui.url=http://127.0.0.1:8080 \
     -Dkaui.db.url=jdbc:mysql://localhost/kaui \
     -Dkaui.db.username=killbill \
     -Dkaui.db.password=killbill \
     -Dwarbler.port=3000 \
     -jar killbill-admin-ui-standalone.war

The startup process will be done when the following message appears:

2015-10-13 18:11:43.571:INFO:oejs.Server:main: Started @25244ms

The logs directory can be set via System Properties (e.g. -DLOGS_DIR=/var/log/tomcat7) or via a custom logback.xml (e.g. -Dlogback.configurationFile=/etc/killbill/logback.xml).