Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
GWT phylogenetic tree viewer http://www.iplantcollaborative.org
Fetching latest commit…
Cannot retrieve the latest commit at this time.
|Failed to load latest commit information.|
phyloviewer =========== ==INTRODUCTION This is a technical solution to the scientific problem of visualizing phylogenetic relationships. It provides the visualization aspects needed. This is alpha code. It worked when we ran it, but no guarantees of any kind are made that it will work for anyone else anywhere. More information about iPlant's Open Source policies and current status is available at http://iplantcollaborative.org/opensource An update to this README is in progress. ==LICENSE See the LICENSE file included with this code. ==SOURCE Source code is available at: https://github.com/iPlantCollaborativeOpenSource/phyloviewer ==BUILD INFORMATION Build info for Apache Maven is in pom.xml. http://maven.apache.org/ ==REQUIREMENTS Download and compile Git http://git-scm.com/ Apache Maven http://maven.apache.org/ Server Apache Tomcat 7.0 http://tomcat.apache.org/ PostgreSQL 9.0 http://www.postgresql.org/ PostGIS spatial data extension http://postgis.refractions.net/ Deployment Download source code git clone git://github.com/iPlantCollaborativeOpenSource/phyloviewer.git Compile and package cd phyloviewer mvn clean package Deploy copy phyloviewer/apps/viewer/target/phyloviewer.war to your server's tomcat webapps directory restart tomcat note that overview images for previously uploaded trees will be lost when the app is redeployed. Database setup Phyloviewer retrieves trees from a PostgreSQL database. See phyloviewer/apps/viewer/src/main/sql/readme.txt for setup instructions Edit webapps/phyloviewer/WEB-INF/web.xml (in the deployed app) to configure the database connection. See https://pods.iplantcollaborative.org/wiki/display/iptol/Uploading+trees+to+the+server for instructions on uploading a tree to phyloviewer. Notes Redeploying the app currently deletes any tree overview images it generated, since they're stored inside the app directory. Move the images directory elsewhere while redeploying the app. (In the future, it should probably just be reconfigured to save images somewhere else, or regenerate them as needed.) If you are running tomcat behind an apache server proxy with SELinux enabled, SELinux must be set to allow the proxy to connect to tomcat, using setsebool httpd_can_network_connect 1. The fact that phyloviewer is behind the httpd proxy was messing up the servlet context path, and making it impossible for GWT to load its *.gwt.rpc files. Until recently, it's just been hitting that error, and falling back to some "legacy serialization policy", which seemed to work. Recent changes no longer work with the legacy serialization policy. The solution that seems to work best so far is to make phyloviewer the ROOT app in tomcat. Using the tomcat management web app makes the deployment a little simpler. Some setup is required. On portnoy, apache is currently configured to redirect some old tree URLs to new URLs, using RewriteMap. See /etc/httpd/conf.d/__vhosts.conf and id2hash for the mappings. ==USAGE Coming... ==ISSUES/BUGS/QUESTIONS Use the issue tracker available from the GitHub repository at the link listed under SOURCE above. Click Issues to submit a question or report a problem. ==CONTRIBUTING iPlant requires all outside collaborators (those not employed by iPlant) to sign and submit a Contributor License Agreement. Details as well as answers to Frequently Asked Questions about this agreement are available at http://www.iplantcollaborative.org/opensource/CLA. Other steps in the process are still being created. While this message remains, email email@example.com