GenePING

This page provides instructions for getting and running the GenePING software. You have two main options:

• Just Run the Client
• Install the Server and Client from Source

Just Run the Client

UPDATE 2007-09-05: the Demo Server is no longer running. At this time, you'll need to get the source and run your own server to see GenePing in action. Over the next few months, we'll work to integrate the GenePing work into the main Indivo codebase. We'll keep you posted on this page.

To run the client against our demo server,

• Run the Java WebStart Client
• Wait for the 20+MB to download and start up.
• Log in using one of the following logins:
  • username patient1@ping.chip.org, password patient1
  • username patient2@ping.chip.org, password patient2
  • username doctor@ping.chip.org, password doctor
• In the left-side menu of the GenePING application, choose "Genomic Labs"

Install the Server and Client from Source

You'll need a few things:

• Java VM 1.4.2 (IMPORTANT!: you need v1.4.2_5 at least. earlier versions have serious problems with KeyStore. Note that this has not been tested in Java 1.5).
• Tomcat 5
• Ant (to compile and build)

The Server

• Download the GenePING Server Source Tarball.
• Gunzip and untar it, then cd into the resulting ping-server directory.
• Stop Tomcat.
• Assuming your Tomcat webapps directory is in /usr/local/jakarta/webapps:

  ant rebuild-and-install -Dwebapps="/usr/local/jakarta/webapps"
  

  NOTE: You may notice an error at this point "Failed to create account admin@ping.chip.org ...". This is normal, we've pre-baked some data into your pingstore.
• Restart Tomcat from the ping-server source directory.
• The PING Server should now be running at http://<your_url>/ping-server/PingServlet

The Client

• Download the GenePING Display Source Tarball
• Gunzip and untar it, then cd into the resulting ping-display directory.
• Edit the configuration file src/xml/configuration_gene.xml so that the parameter server-url is set to value http://<your_url>/ping-server/PingServlet.
• Run the client as follows:

  ant run-display-gene
  

Note: the first login will be slow as the Ping Server starts up and loads up its data from the store.

The source tarballs above come with ready-to-go data of patient1, patient2, and doctor as above.