| 46 | |
| 47 | |
| 48 | ---- |
| 49 | |
| 50 | The following contents are retrieved from [source:trunk/browser/README]: |
| 51 | |
| 52 | = Build & Debug (with Eclipse) = |
| 53 | 1. Install GWT (Google Web Toolkit. version 1.4.10 or higher) |
| 54 | 2. In Window->Preference->Java->Classpath Variables, add a new variable as follows: |
| 55 | {{ |
| 56 | GWT_HOME=(your GWT installation folder) |
| 57 | }} |
| 58 | 3. (debug) launch Debug -> GenomeBrowser_gwtshell, which displays GWT debug shell and |
| 59 | genome browser interface. |
| 60 | |
| 61 | = Build (from command line) = |
| 62 | |
| 63 | 1. Download the Google Web Toolkit from the web. Version 1.4.10 or higher is required. |
| 64 | 2. Copy 'build.properties.sample' to 'build.properties' |
| 65 | 3. Open the 'build.property' file, then change the gwt.home variable to the path of your GWT (Google Web Toolkit) folder, |
| 66 | and comment out appropriate 'gwt.dev' lines to select GWT develeopement library on your OS. |
| 67 | - e.g. (in Windows) |
| 68 | {{ |
| 69 | gwt.home=C:/(somewhere in your PC)/gwt-windows-1.4.10 |
| 70 | gwt.dev=gwt-dev-windows.jar |
| 71 | #gwt.dev=gwt-dev-mac.jar |
| 72 | #gwt.dev=gwt-dev-linux.jar |
| 73 | }} |
| 74 | 4. > ant compileJs |
| 75 | 5. Open www/org.utgenome.gwt.utgb.UTGB/UTGB.html in your web browser (IE, Firefox, etc.) |
| 76 | |
| 77 | = Deploy = |
| 78 | |
| 79 | 1. Install Tomcat 5.0 (or higher) Java web server. |
| 80 | 2. Edit your build.properties file, and modify the following variables: |
| 81 | {{ |
| 82 | TOMCAT_HOME=(Tomcat Installation folder) |
| 83 | tomcat.base.url=http://localhost:8080 |
| 84 | tomcat.manager.username=(tomcat manager username) |
| 85 | tomcat.manager.password=(tomcat manager password) |
| 86 | }} |
| 87 | |
| 88 | 3. Set up GWT as described above (the section on build from command line) |
| 89 | 4. > ant deploy |
| 90 | * This generates a war file (web application archive), and deploy the war file in the tomcat server |
| 91 | |
| 92 | = Trouble Shooting = |
| 93 | |
| 94 | * Q: GWT Shell invokes a following error: |
| 95 | {{ |
| 96 | [ERROR] Errors in 'jar:file(...)UTGB%20Common/lib/gwt-dragdrop-1.0RC.jar!/com/allen_sauer/gwt/dragdrop/client/DeferredMoveCommand.java' |
| 97 | }} |
| 98 | * A: Your GWT version must be higher than 1.4.10 in order to use drag & drop facility. |
| 99 | |
| 100 | |
| 101 | * Q: out of memory error when running Ant. |
| 102 | * A: create a $HOME/.ant/ant.conf file, then write the following line: |
| 103 | {{ |
| 104 | ANT_OPTS="-Xmx512M" |
| 105 | }} |