{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}
h4.{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.{color}

Quick Links to:

Download and Install Tomcat 7

If you encounter any broken links, go to the Apache Tomcat web site and select the Tomcat version for the DOWNLOAD section.

  1. Go to the 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 that 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.29/

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"/>
    • 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.
    Be sure to change the passwords to passwords of your choice.
    When you are satisified that everything is correct, save your changes.
  2. Install the ojdbc14-10.2.0.5.jar
    Install the ojdbc14-10.2.0.5.jar in 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, you can download the ojdbc14-10.2.0.5.jar now and save it to your workstation.
  3. Configure context.xml
    Open ${CATALINA_HOME}/conf/context.xml with a text editor.  
    1. For non-Windows systems, change the <context> tag to the following: 
      <Context crossContext="true" useHttpOnly="false">
      For Windows systems, change the <context> tag to the following" 
      <Context antiResourceLocking="true" crossContext="true" useHttpOnly="false">

      By setting antiResourceLocking to true, Tomcat will prevent any file locking. This will significantly impact startup time of applications, but allows full webapp hot deploy and undeploy on platforms or configurations where file locking can occur. If not specified, the default value is false.

      Please note that setting this to true has some side effects, including the disabling of JSP reloading in a running server: see Bugzilla 37668.

      Please note that setting this flag to true in applications that are outside the appBase for the Host (the webapps directory by default) will cause the application to be deleted on Tomcat shutdown. You probably don't want to do this, so think twice before setting antiResourceLocking=true on a webapp that's outside the appBase for its Host.

      By default, Tomcat 7 sets HttpOnly to false on all session cookies.  This prevents any client side script from accessing the session ID.
      DWR uses the session cookie (and the session ID) to protect against cross site scripting attacks.  With HTTPOnly set to false, DWR will start popping up “CSRF Security Error” dialogs.
      To prevent DWR from popping up “CSRF Security Error” dialogs, useHttpOnly must be set to true.

    2. Add the following Resource Definition anywhere between the <context> and </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" />

<ResourceLink global="jdbc/MitsisDS" name="jdbc/MitsisDS" type="javax.sql.DataSource"/>
      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.  If you don't know what JNDI name to use, your team leader can get it for you.
      Be sure to change the username and password.
      When you are satisified that everything is correct, save the changes.
  4. Configure setenv.bat (setenv.bat is for Windows system.)
    For non-Windows systems use setenv.sh and convert the code below using the appropriate replacement for set.
    1. Open ${CATALINA_HOME}/bin/setenv.bat with a text editor.  If the setenv.bat file does not exist, create it.
    2. Add the following to setenv.bat: 
      set CSFDIR=/usr/local/etc/csf
set JAVA_HOME=/path/to/Java/jdk1.6.0_27
set PATH="%PATH%;/path/to/maven/apache-maven-2.2.1/bin"
set MAVEN_OPTS=-Djavax.net.ssl.trustStore=/path/to/keystores/serverTrustStore.jks -Djavax.net.ssl.trustStorePassword=changeit"
set CATALINA_OPTS=-Djavax.net.ssl.trustStorePassword=changeit -Djavax.net.ssl.keyStorePassword=changeit -Djavax.net.ssl.trustStore=/path/to/keystores/serverTrustStore.jks -Djavax.net.ssl.keyStore=/path/to/keystores/registrar.jks
set JAVA_OPTS=-server -Xmx1024m -Xms1024m -XX:MaxPermSize=1024m -DCSFDIR=%CSFDIR%
echo MAVEN_OPTS=%MAVEN_OPTS%
echo CATALINA_OPTS=%CATALINA_OPTS%
echo JAVA_OPTS=%JAVA_OPTS%
echo CSFDIR=%CSFDIR%
      Be sure to change the following:
      • /path/to/Java - the path to your Java JDK installation.
      • /path/to/maven - the path to your maven installation.
      • /path/to/keystores - the path to your truststore JKS and/or keystore JKS.
  5. 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