1) Download and install Eclipse IDE for Java EE Developers 4.5 (Mars), e.g., from eclipse.org/downloads using the Eclipse Installer
2) Create UniTime project
If you plan to make changes, you should consider forking the UniTime project first. See Fork A Repo for more details.
a) If you already have a GIT project cloned somewhere, you can just import it:
- File > Import, select Git > Project from Git, Next
- Select "Existing local repository", click Next
- Click Add, select the git directory, select the UniTime git project, click Finish
- Select UniTime, click Next, click Next, click Finish
b) If you do not have a GIT project already cloned somewhere:
- File > Import, select Git > Project from Git, Next
- Select "Clone URI", click Next
- Enter "https://github.com/UniTime/unitime.git" as URI, the rest should auto populate from the URL, click Next
- Or, you can use "git@github.com:UniTime/unitime.git" as URI, and generate an SSH key (see Generating SSH keys for more details)
- If you have forked the unitime repository, the URI will be different
- Click Deselect All, select master and the maintenance branches you want/need (if any).
- Click Next
3) Install Google Plugin for Eclipse - Help > Install New Software...
- Click Add, Name: Google Plugin for Eclipse, Location: https://dl.google.com/eclipse/plugin/4.4, OK
- Select Google Plugin for Eclipse (required) and SDKs > Google Web Toolkit
- Click Next, Next, accept license terms and Finish
- If there is a warning about installing software that contains unsigned content, click OK
- Restart Eclipse after the install
- Download GWT 2.7.0 from gwtproject.org/download.html and unzip it.
- In Eclipse, open File > Properties, select Google > Web Toolkit, click Add
- Select a directory that has an unzipped distribution of GWT 2.7.0, hit OK
- Select gwt-2.7.0 as the default, click OK
- Right click on the UniTime project, click Properties, select Google > Web Application, toggle "This project has a WAR directory", click OK
This guide expects that you already have the Apache Tomcat downloaded and installed somewhere.
a) Setup JRE and its parameters - Open File > Properties, select Java > Installed JREs, click Edit
- Put in the following Default VM arguments, hit Finish
-Xmx2g -XX:+UseConcMarkSweepGC -XX:MaxPermSize=128m
- You can also include a path to the UniTime custom.properties file if needed
-Dtmtbl.custom.properties=/path/to/custom.properties
b) Create Apache Tomcat v.7.0 server configuration - Open File > Properties, select Server > Runtime Environments, click Add
- Select Apache Tomcat v7.0, check the "Create a new local server", click Next
- Select Tomcat installation directory, hit Finish
c) Compile GWT - Right click on the UniTime project, select Google, click on GWT Compile
- Make sure that either UniTimeDev (fewer permutations) or UniTime (all permutation) but not both is on the Entry Point Modules list, click Compile
- If asked, select WebContent as the WAR directory
c) Deploy UniTime - Right click on the UniTime project, click Properties, select Project Facets, toggle Dynamic Web Module, Java, and Java Script, click OK
- Right click on the UniTime project, select Run As, click on Run on Server
- If asked, select Tomcat v7.0 Server, click Finish
|
|
