Creating a rice-2.6.3 workspace

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.

You will need to request gateway / tunnel authorization from the server support group (Mark Wiggins)

1. Download Rice from the GIT repository

 Click here to expand...

Build GIT repository location

 Clone GIT Repositories

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

 Import Maven 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:

 Import Ant Projects

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

 Property Files

PSCP :

pscp netid@updev.kfs.uconn.edu:/srv/uconn_configs/rice-config/log4j.properties C:\srv\uconn_configs\rice-config\log4j.properties
pscp netid@updev.kfs.uconn.edu:/srv/uconn_configs/rice-config/rice-config.xml C:\srv\uconn_configs\rice-config\rice-config.xml
pscp netid@updev.kfs.uconn.edu:/srv/uconn_configs/rice-config/rice.keystore C:\srv\uconn_configs\rice-config\rice.keystore
pscp rlr15105@updev.kfs.uconn.edu:/srv/OJB.properties C:/srv/OJB.properties

Edit the rice-config.xml datasource.url and change the host and port to match your PuTTY settings

Add file: to the keystore.file parameter <param name="keystore.file">file:${rice.config.directory}/rice.keystore</param>

3. Add Tomcat 8.5 Server

 Click here to expand...

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:

 Tomcat 8

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

 Click here to expand...
 Maven Workspace

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

 Click here to expand...

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:

Database Tunneling


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.