| | 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 | }} |