Run Roxy as a Jar

Run as a Jar

Roxy can be packaged up as a Java Jar file and run in environments where Ruby is not installed. Be warned that there is considerable startup cost for running a jarred version of JRuby. Roxy Jar will run slower than regular Roxy.

Creating the Jar file

Prerequisites

Roxy uses a Ruby gem called Warbler to package the jar. To get started you need to install some dependencies.

1. Install JRuby
   You should consider using a tool like RVM or RBEnv to manage your Ruby versions
2. Install and use this version of the Warbler gem:
   $ gem install warbler -v 1.4.9

Create Jar

$ ml jar

If everything goes well you should get a jar version or Roxy called roxy.jar.

Using the Jar file

Use the Jar file just as you would use Roxy but with a few extra bits to make it run:

$ java -jar roxy.jar {normal roxy arguments}

Example

Bootstrap

Roxy: $ ml local bootstrap

Roxy Jar: $ java -jar roxy.jar local bootstrap

Troubleshooting

If the Jar throws an error about app_specific not being found, you built it with the wrong version of warbler.