root/branches/omero/docs/BUILDING.txt
| Revision 153, 1.4 kB (checked in by jmoore, 3 years ago) |
|---|
| Line | |
|---|---|
| 1 | |
| 2 | ------------------------------------------------- |
| 3 | OMERO - OME Read-Only Web App |
| 4 | ------------------------------------------------- |
| 5 | |
| 6 | To work with the OMERO source base, you will need to have a fully |
| 7 | working OME Database, a Java Development Kit, and a Servlet container. |
| 8 | |
| 9 | (1) Initialize environment: DB, Java, server, Maven |
| 10 | |
| 11 | * Install Java and a Servlet Container (Tomcat, Jetty, Resin, or JBoss et al.) |
| 12 | Warning: The Omero server side code requires Java 5 and Tomcat 5.5.x. |
| 13 | |
| 14 | * Set JAVA_HOME to your JDK installation |
| 15 | |
| 16 | * Set MAVEN_HOME to your Maven installation or alternatively to |
| 17 | OMERO_HOME/lib/maven/ If you use the latter also run: |
| 18 | |
| 19 | OMERO_HOME/lib/maven/bin/install_repo.sh HOME_DIR/.maven/repository |
| 20 | |
| 21 | install_repo.bat is available for Windows users. Also, place |
| 22 | MAVEN_HOME/bin/maven(.bat) on your PATH. |
| 23 | |
| 24 | * Copy docs/build.properties.example to OMERO_HOME or HOME; |
| 25 | edit the properties for your site. |
| 26 | |
| 27 | Note: This file should _not_ be put under revision control! |
| 28 | |
| 29 | (2) Build and install OMERO: |
| 30 | |
| 31 | * Run "maven bootstrap" to prepare the installation. Then run |
| 32 | "maven install" to place all jars and the war file in your local |
| 33 | maven repository. Copy the war file under |
| 34 | |
| 35 | OMERO_HOME/components/server/target |
| 36 | |
| 37 | to your servlet container. Enjoy! |
| 38 | |
| 39 | (Alternatively, follow the container-specific instructions under docs/ .) |
| 40 | |
| 41 | |
| 42 | TODO: Some of these instructions should go in INSTALL.txt. |
Note: See TracBrowser
for help on using the browser.
