about
  demos
  download
  documentation

documentation

o getting started with omixed
o server installation
o server documentation
o example model schemas
o about the schematographer
o omixed taverna plugin

Overview

Omixed can be built and deployed on Mac OS X, Windows XP, Windows Vista and most flavours of Linux.

The build process is performed at the command line and requires Apache Ant.

If you are having difficulties, please check out the installation FAQ.

Prerequisites

The following pieces of software must be installed and configured on your chosen system:

  1. Java JDK 6
    • http://java.sun.com/javase
    • omixed uses several features of JDK 6, earlier Java versions will not suffice.
    • The javac compiler must be in the your path (or set via $JAVA_HOME) so that it will be found during the compilation process.
  2. Apache Tomcat 5.x or newer
    • http://tomcat.apache.org
    • configured to allow HTTPS access, i.e. you should be able access the management service at
      https://localhost:8081/
      (or whatever host:port you have chosen).
  3. MySQL or PostgreSQL
  4. GraphViz 2.20 or newer
    • http://www.graphviz.org
    • this is a graph visualisation package, available as binaries for all common platforms
      (or as source code if you need to compile it)
  5. Apache Ant
    • http://ant.apache.org
    • ant is used building and deploying the server
    • it should be accessible from the your chosen command line.

Configuration and deployment

  1. Unpack OmixedServer.zip into your chosen omixed installation directory. Ensure that the unpacking preserves the directory structure.
  2. We provide current versions of the JDBC connection library for both MySQL and PostgreSQL in the lib directory. If the provided version is not compatible with your installed database server, replace the JAR file in lib with one that is compatible.
  3. Create a file called build.properties by making a copy of the file templates/build.properties and setting the parameters therein to match your environment.
  4. Create a file called omixed.properties making a copy of the file templates/omixed.properties and adjusting the parameters therein to suit your environment.
  5. In your omixed installation directory, run ant clean followed by ant tomcat-deploy
  6. Verify that the service is running by visiting http://[HOSTNAME]:8080/omixed/server/wsdl. You should see the WSDL service description.
  7. In your omixed installation directory, execute java -jar AdminConsole.jar to set up your new resource and create user accounts. Please refer to the Admin Console User Manual for full instructions.