{color:green}Help is available by sending an email to [mailto:csf-support@mit.edu]{color}

{color:green}Have any suggestion on how improve this wiki?  Please give us your feedback at [mailto:csf-support@mit.edu]{color}
\\
\\
{color:red}All instructions are for *Tomcat 7.0.29*.  Please check with your team leader and verify which version of Tomcat you should download and install.
\\
If you encounter any broken links, go to the [Apache Tomcat web site | http://tomcat.apache.org] and select the Tomcat version for the DOWNLOAD section.{color}

Quick Links to:

Download and Install Tomcat 7

1. Go to the Apache Apache Tomcat download site.  Scroll down until you reach the 7.0.29 section.  Under Binary Distributions Core:, select the format for your OS and save the downloaded file to your workstation.
   

   For older versions of Tomcat If you are looking for an archieve version of Tomcat, go to the Apache Apache Tomcat download site.  Scroll down until you reach the Quick Navigation section and click on Archives.  Select the version of Tomcat the you want, then click on bin and select the Tomcat format for your OS and save the downloaded file to your workstation.

2. Unzip/untar the binaries to a new folder (e.g. /tomcat/7.0.9).
3. Create an environment variable CATALINA_HOME which contains the path to your Tomcat installation.  For example: CATALINA_HOME=/tomcat/7.0.9/

Download and Install Tomcat 7 is now complete

Configure Tomcat 7

1. Configure tomcat-users.xml
   Open ${CATALINA_HOME}/conf/tomcat-users.xml with a text editor.  Create the following 2 uses:

   <user username="script" password="XXXXXXXX" roles="manager-script,admin"/> <user username="gui" password="YYYYYYYY" roles="manager-gui,admin"/>

   Be sure to change the password to passwords of your choice.
   • The script user will be used to deploy your application to the Tomcat server.
   • The gui user will be used to access the Tomcat Manager.

When you are satisified that everything is correct, save your changes.

1. Install the ojdbc14-10.2.0.5.jar
   Install the ojdbc14-10.2.0.5.jar to either the ${CATALINA_HOME}/lib or the ${CATALINA_HOME}/common/lib directory.  The ojdbc14-10.2.0.5.jar has to go into only one directory.  If you do not have the ojdbc14-10.2.0.5.jar now, you can download the ojdbc14-10.2.0.5.jar and save it to your workstation.
2. Configure context.xml
   Open ${CATALINA_HOME}/conf/context.xml with a text editor.  
   1. change the <context> tag to the following:

      <Context crossContext="true" useHttpOnly="false">

   2. add the following anywhere beteen the <context> ans </context> tags:

      <Resource name="jdbc/MitsisDs" auth="Container" type="javax.sql.DataSource" driverClassName="oracle.jdbc.OracleDriver" url="jdbc:oracle:thin:@//earth-vault-2.mit.edu:1523/sundev2" username="XXXXXXXX" password="YYYYYYYY" maxActive="20" maxIdle="10" maxWait="-1" removeAbandoned="true" removeAbandonedTimeout="30" logAbandoned="true" />

      If your project's JNDI name is something other than MitsisDS, then you must change MitsisDS in the above to your project's JNDI name.
      Be sure to change the username and password.
      When you are satisified that everything is correct, save the changes.
3. Test the Tomcat installation
   1. Open a cmd window, cd to ${CATALINA_HOME}/bin and start the tomcat server.
   2. Open a browse and go to the URL: http://localhost:8080/manager/html.
   3. When prompted for the username and password, use gui for the user name and enter the password that you choose in Step 1 above.
      If everything was done correctly, you will have the following page displayed:
      

Configure Tomcat 7 is now complete