Creating a rice-2.6.3 workspace
- Richard Ritchie
Prerequisites:
You will need the following items to complete these instructions:
Each of the following should be installed on your local system prior to installation of Eclipse.
- Spring STS installed and configured
- Java 1.8 (PC users may require Unlimited Strength Cryptography Extension)
- Tomcat 8.5.5
- Copy ojdbc6.jar from kfs/build/drivers to your {tomcat install}/lib directory
- Copy spring-instrument-tomcat-4.3.18.RELEASE.jar to your {tomcat install}/lib directory
- Database Tunneling Software MIT Kerberos Ticket Manager (PuTTY for Windows)
- SourceTree (https://www.sourcetreeapp.com/)
- Git (https://git-scm.com/download/win)
- Maven (https://maven.apache.org/download.cgi)
1. Download Rice from the GIT repository
Build GIT repository location
Create directory in your $$Home directory (like Git_Repo)
Navigate to the directory, using your terminal window.
cd (name of newly created directory, like Git_Repo above)
Execute Git clone command.
git clone https://netid@stash.uconn.edu/scm/kfs/rice-2.6.3.git
Import your projects
Use File-> Import and select Existing Maven Projects.
Navigate to the git rice-2.6.3\rice-middleware directory
Import standalone/pom.xml, uconn/pom.xml, web/pom.xml:
In Eclipse, click on Window+Perspective+open Perspective+Other
Choose Git
click OK
Choose the create new local Git icon
Click Browse, to search for your Git directory
Choose your directory and click OK
Click Finish
You will see your project in the Git Repositories Tab.
Highlight your project
Right click on the project and select import projects.
click Finish
Click the Java button to switch to the Java perspective.
You will see the project in the Project Explorer window of the Java perspective.
2. Configure your Rice project
3. Add Tomcat 8.5 Server
Open the Server view by clicking on Window->Show View->Other then select Server from the Show View dialog and click OK.
The Servers tab will appear in the bottom window of Eclipse. Right-click and select New->Server.
In the New Server dialog, select Tomcat 8.5 and click Next.
Browse to the location where you have installed your Tomcat 8.5 server and then click Finish.
In the Servers tab, double click the Tomcat v8.5 server to open the Server information screen.
Make the following changes to the Server properties:
Right-click on the new server and select Properties.
We can use the defaults for most of the general configuration except the Timeouts. Sometimes the server can take longer to start so we will enter a large # of seconds:
Open the launch configuration so we can adjust the JVM arguments:
Click on the Arguments tab and add the following arguments to the end of the VM arguments field:
-Dtarget.environment="dev" -Dhttp.url=F1BQG72.grove.ad.uconn.edu -Drice.http.url=F1BQG72.grove.ad.uconn.edu -Dorg.apache.jasper.compiler.Parser.STRICT_QUOTE_ESCAPING=false -DOJB.properties="/srv/OJB.properties"
Click Apply and then OK.
Save and close the Tomcat window.
Change your context root
Right-click on your rice-standalone project and select Properties. Change the context root to kr-dev
4. Deploy Code to Server
Right-Click on Server and Pick "Add and Remove"
You should see your kfs-war project listed. Click Add to move it to the Configured Column. Click Finish.
Now, the server will need publishing, Right-click the server and pick Publish. Since it's the first publish, it may take a while.
Once published, make sure that the context root for the kfs project is set as kfs-dev. Open the server properties again and click the Modules tab at the bottom. Click the 'edit' button for our kfs-war project and set the path to /kfs-dev.
Click OK and then save the configuration. At this time you will also want to re-publish the server but it should be a lot quicker.
5. Start the Server
The KFS application should now be built and deployed to the Tomcat server.
Before starting the KFS application, you will need to have a tunnel created to the database server.
Refer to this link for instructions on setting up a tunnel to the database:
In the Servers tab, highlight the Tomcat 7 server, and click the Run button (the triangle with a green circle around it). The Console will display messages written during startup of the application.
Now, open your browser and go to the URL http://localhost:8080/kfs-dev.