Roxy (RObust XQuerY Framework) is a lightweight framework for quickly developing well-structured, easily maintained XQuery applications. Roxy was heavily inspired by Ruby On Rails and CakePHP.
Roxy Deployer makes managing MarkLogic application easy. Simply edit a few configuration files and you have full access to create and deploy applications to MarkLogic servers, local or remote. Roxy Deployer is written in Ruby and is easily extended to add additional functionality.
The meat and potatoes of Roxy, the mVC (with a de-emphasis on m) is a light-weight MVC framework fashioned after Ruby on Rails and CakePHP. It relies heavily on Convention over Configuration.
What good is your code if it doesn't work? Testing is paramount to the development process. The Roxy Unit Tester tests XQuery with XQuery. Write your tests in XQuery and run them from the UI or from the command line. Roxy Unit Tester produces JUnit XML output so you can use it with your favorite continuous testing tool.
- MarkLogic:
- MarkLogic 4.x - You need the Docs appserver running on port 8000 - this port can be overridden in build.properties
- MarkLogic 5.x - You need the Manage appserver running on port 8002 - this port can be overridden in build.properties
- MarkLogic 6.x - You need the Manage appserver running on port 8002 - this port can be overridden in build.properties
- Ruby - Required for Roxy Deployer only.
- Java (jdk) - Only if you wish to run the Roxy Deployer [XQSync](http://developer.marklogic.com/code/xqsync, XQSync) or [RecordLoader](http://developer.marklogic.com/code/recordloader, RecordLoader) commands.
This section describes the quickest way to get started using Roxy.
- You already have one or more MarkLogic Servers running somewhere that you can access from your computer. If not, get it here.*
- You know the admin logon to your MarkLogic Server(s)
> git clone git://github.com/marklogic/roxy.git
- Open a command prompt in the root folder of Roxy
- Run ml init to create sample configuration files
> ml init app-name
3. Modify deploy/build.properties with your application's settings.
\# Username to authenticate to ML
user=your-ml-admin-username
\# password for ML authentication
password=your-ml-admin-password
\# the authentication type for the appserver (digest|basic|application-level)
authentication-method=application-level
\# the default user to authenticate with. defaults to nobody
default-user=nobody
\# the root path of your modules. Use this to override the modules db and use your filesystem location
modules-root=/the/path/to/your/files/on/the/filesystem
\# either 'filesystem' or 'name of db'
app-modules-db=filesystem
\# Specify the server(s) you wish to deploy to here. This tutorial assumes you are using localhost.
local-server=localhost
\#dev-server=
\#cert-server=
\#prod-server=
This step is only needed when database configurations have changed or on a fresh install. In most cases you will not need to restart your server.
- Open a command prompt in the root folder of Roxy
If your server is not configured as local-server in build.properties then substitute your environment here ( local | dev | prod ) > ml local bootstrap
- Depending on what, if anything, you changed you may need to restart MarkLogic in order to proceed. If you see output telling you to restart...
> ml local restart
This step describes how to deploy your Roxy application into your MarkLogic Server modules database. If you have elected to run your code locally out of the filesystem you do not need to do this.
- Open a command prompt in the root folder of Roxy
> ml local deploy modules
- Open your favorite web browser to http://localhost:port
Sub in your hostname and port from build.properties
Congratulations! You have Roxy running on your server. Now you need to start customizing it.
For more information run:
> ml -h