Introduction

MiniX is a simplified version of the SetupX experimental design software and mainly used in cooperation with BinBase

Installation

At this point miniX comes in two different version.

Standalone in Jetty/Tomcat with external BinBase configuration

please download the tomcat war and just deploy it to your jetty or tomcat deploy directory,

Embeded in JBoss with embeded BinBase configuration

To use the embbeded version you first need to configure your jboss deployment order, since for some reason it deploys war files before ear files.

If you like to build this miniX version, please execute

grails -Dgrails.env=jboss war

This will ensure that you will not include libraries, which are already deployed in the jboss application server.

Todo this, please open the file:

JBOSS_HOME/server/all/conf/xmdesc/org.jboss.deployment.MainDeployer-xmbean.xml

and seach for the line where the deployment order is configured. This should look something like this:

 <descriptors>
   <value value="250:.rar,300:-ds.xml,400:.jar...."/>
 </descriptors>

and ensure that the value for :.war is larger than for .:ear

in our test system the values are

700:.war
650:.ear

this ensures that the war is deployed after all the binbase ear's and ejb's are deployed. You can find more about the deployment configuration in the official jboss manual or here

The next step is to copy the minix-jboss-4.2.0-GA.war into the server/all/deploy directory and to restart the server.

This assumes that you have binbase and the minix-connector successfully installed. MiniX will completely configure itself now, based on the DefaultDs datasource.

Please be aware that the DefaultDs datasource run's by default on HypersonicSQL, which is not recommended to use for production use. For this reason we recommend to modify the datasource configuration to a more suitable database like postgresSQL.

the first start

After your successful deployment in either of the container's please open the minix url. By default it should be

http://127.0.0.1:8080/minix

and it should ask you to enter the password, email and user details for the admin user. This is the user which has the most rights in the system and can create other users.

As soon as this is successfully done, you should be able to work with miniX and create and schedule experiments.