Skip to content

Home

Jump to bottom
Tobias Neumann edited this page Apr 22, 2016 · 2 revisions

palantir: A JSF front-end for querying genomic count data from RNA-seq experiments and Screens

What is it?

In style of its eponym, palantir is a gateway browse other worlds, namely processed count data and transformations from experiments such as RNA-seq and Screens. Palantir is a deployable Maven 3 project compliant with Java EE6 on WildFly AS 10.x. It includes a persistence unit connecting to a MySQL datasource with processed and prepared NGS data utilizing palantir-processor and palantir-importer and transformations from experiments such as RNA-seq and Screens. The JSF front-end lets you conveniently browse the data and add metainformation such as sample annotations, screen candidate selection and comments, as well as grouping data into experiments.

Supported browsers

Palantir was tested on Mozilla Firefox, Safari and Opera. Google Chrome is explicitly not supported (not for a lack of trying 👎 ).

Configure Maven

If you have not yet done so, you must Configure Maven before building and deploying or running any tests.

Start WildFly AS 9 with the Web Profile

  1. Open a command line and navigate to the root of the WildFly server directory.

  2. The following shows the command line to start the server with the web profile:

     For Linux:   ./bin/standalone.sh
 For Windows: \bin\standalone.bat

Setup MySQL datasource on WildFly AS 9

The application server needs to have a configured JTA MySQL datasource containing the processed data import from palantir-importer as well as the installed MySQL connector.

After setup, configure the datasource in persistence.xml accordingly.

Build and Deploy the Quickstart

NOTE: The following build command assumes you have configured your Maven user settings. If you have not, you must include Maven setting arguments on the command line.

  1. Make sure you have started the WildFly Server as described above.

  2. Open a command line and navigate to the root directory of palantir.

  3. Type this command to build and deploy the archive:

     mvn clean package org.wildfly.plugins:wildfly-maven-plugin:deploy

  4. This will deploy target/palantir.war to the running instance of the server.

Access the application

The application will be running at the following URL: http://localhost:8080/palantir/.

Undeploy the Archive

  1. Make sure you have started the JBoss Server as described above.

  2. Open a command line and navigate to the root directory of this palantir.

  3. When you are finished testing, type this command to undeploy the archive:

     mvn org.wildfly.plugins:wildfly-maven-plugin:undeploy

Run the Arquillian Tests

Palantir also provides Arquillian tests. By default, these tests are configured to be skipped as Arquillian tests require the use of a container.

  1. Make sure you have started the WildFly Server as described above.

  2. Open a command line and navigate to the root directory of this palantir.

  3. Type the following command to run the test goal with the following profile activated:

     mvn clean test -Parq-wildfly-remote

Debug the Application

If you want to debug the source code or look at the Javadocs of any library in the project, run either of the following commands to pull them into your local repository. The IDE should then detect them.

mvn dependency:sources
mvn dependency:resolve -Dclassifier=javadoc
Clone this wiki locally