Deploying iTrust v8 (Fall 2009) at Home

Back to start

To install iTrust on your home system, download and install the following packages.

Once you unzip Tomcat into a directory on your machine (don't forget the MySQL driver!), you will need to set up the Web Tools environment to deploy projects. To do this, complete the following steps in Rational Team Concert or Eclipse:

• Go to Window > Show View > Other… Select Server > Servers…

• In the Servers view, right click and select “New”

• Select Apache > Tomcat 5.5. Hit next.
• Select the folder where you previously unzipped Tomcat (your version number might not match the screenshot - that's okay as long as it's 5.5).

• Hit Finish

• In the servers view, you should see your new runtime below. Click on the “Play” button to start the server.

• If you see the text Server startup in xxxxx ms in the Console view, and the Servers view shows that your status is “Synchronized”, then your server is properly configured. If the Console view isn't open, go to Window > Show View… > Console

iTrust needs to be able to connect to a MySQL database. Your instructor or TA may give you the database URL, username, and password details. If, however, you wish to have a local database (which performs significantly faster), you can install MySQL on your own machine. Here are instructions for how to set up your sever on Windows, Linux and Mac OS X. We recommend you use the Developer Machine option, and be sure to allow TCP/IP connections.

If you use a local MySQL setup, then you will also need to create a database. Use the GUI tools for this, or use the “MySQL Command Line Client”, and run the command Create Database XXXX; where XXXX is your desired database name.

Be sure to remember what you initialize as your root password (you will need it later).

If MySQL does not install properly and you wish to re-install, be sure to remove the log files and the data tables. For example, if you originally installed MySQL into c:\Program Files\MySQL\My SQL Server 5.0, then delete the MySQL folder before re-installing.

MySQL has a large community and extensive documentation, so if you can't find the answer to your question here, consult the MySQL website.

The source files will need to be imported as an Eclipse project, and deployed as a Tomcat application. To do this, follow these steps:

• Download the source (see link at the top) and save it to a location you can remember.
• From within Eclipse, switch to the Java perspective. (use Window > Open Perspective…, or use the icons in the upper-right corner)
• To import the project files, go to File → Import … and select Existing Projects Into Workspace. Click Next.

• Check the radio button Select Archive File and select Browse.
• Select the archive of your source code.
• Make sure that iTrust is checked in the projects selector and click Finish. The files are now in your workspace. The Package Explorer should look like this:

• Now you need to deploy the project to your Tomcat server. In the Servers view, right-click on your Tomcat installation and select Add and Remove Projects…
• iTrust should show up on the list, move it over to the “Configured Projects” pane, hit Finish
• If you click on the plus sign in your server configuration, you should see “iTrust” deployed (published) there.
• Now that iTrust is set up to be deployed on Tomcat, you need to set the database parameters. In the Package Explorer, Open up iTrust > WebRoot > META-INF > context.xml
• If the file is opened in “Design” mode, switch to the “Source” mode at the bottom of the editor.
• Follow the comments in the context.xml file to properly set up your database parameters. If you have a username, password, and URL for a database provided by the instructor or TA, or if you have a local database, please use those parameters.

For example, if you are using a local database, your parameters might look like the following:

username=“root” password=“pw” url=“jdbc:mysql://localhost/iTrust”

• To test your parameters, go to iTrust > unittests> edu.ncsu.csc.itrust. Right-click on DBBuilder.java, select Run as… > Java Application

(to view your packages easier, click on the triangle in the package explorer view, Package Presentation > “Hierarchical”)

• The console view should show many lines beginning with Executing: , then end with Operation Completed
• To populate your database with test data, go to unittests, and in the datagenerators package, run the TestDataGenerator.java program. You should also get a lot of Executing: , followed by an Operation Completed.

• Start the Tomcat Server in the Servers view as before.
• Open your internet browser and surf to http://localhost:8080/iTrust/. You should be able to log in and use the application as normal.