Page History

Converting an OC4J WAR application to a Tomcat 7 WAR application

1. Run Eclipse and open the Maven project that you want to convert to a Tomcat 7 application.

2. Open your project's decorators.xml file for editing.  The decorators.xml file is located in your project's WEB-INF directory.
   Your decorator.xml should look similar to the following:

   Code Block
   <decorators defaultdir="/WEB-INF/decorators"> <decorator name="ajax" page="ajax.jsp"> <pattern>/**/ajax/*</pattern> </decorator> <decorator name="ssb" page="ssb.jsp"> <pattern>/**/*</pattern> </decorator> </decorators>

   In each of the <pattern> tags, remove the leading /** so that the above now looks similar to the following:

   Code Block
   <decorators defaultdir="/WEB-INF/decorators"> <decorator name="ajax" page="ajax.jsp"> <pattern>/*ajax*</pattern> </decorator> <decorator name="ssb" page="ssb.jsp"> <pattern>/*</pattern> </decorator> </decorators>

   When you are satisfied that everything is correct, save the changes.

3. Open your project's applicationContext xml that contains the mitsisDataSource bean.  The mitsisDataSource beanshould look similar to:

   Code Block
   <bean id="mitsisDataSource" class="org.springframework.jndi.JndiObjectFactoryBean"> <property name="jndiName" value="jdbc/MitsisDS" /> </bean>

   Remember the value of the name property.  In this example the value is jdbc/MitsisDS (the default for most ES web apps).  This value will be the Resource Definition name used throughout the remainder of this page.
   Add a new property, resourceRef,to the bean definition:

   Code Block
   <bean id="mitsisDataSource" class="org.springframework.jndi.JndiObjectFactoryBean"> <property name="jndiName" value="jdbc/MitsisDS" /> <property name="resourceRef" value="true" /> </bean>

   Don't forget to use your Resource Definition name in place of jdbc/MitsisDS.
   When you are satisfied that everything is correct, save the changes.

4. Open your project's log4j.xml for editing and find the 2 lines similar to the following (attis the project's application context root):

   Code Block
   <param name="File" value="log/att.log" /> <param name="File" value="log/hbn-att.log" />

   and change them to:

   Code Block
   <param name="File" value="${logs.dir}/att/att.log" /> <param name="File" value="${logs.dir}/att/hbn-att.log" />

   When you are satisfied that everything is correct, save the changes.

5. Open your project's web.xml for editing and add the following after the <servlet-mapping> tags and before the <welcome-file-list> tag.

   Code Block
   <resource-ref> <description>Oracle Datasource</description> <res-ref-name>jdbc/MitsisDS</res-ref-name> <res-type>javax.sql.DataSource</res-type> <res-auth>Container</res-auth> </resource-ref>

   Don't forget to use your Resource Definition name in place of jdbc/MitsisDS.
   When you are satisfied that everything is correct, save the changes.

6. Open your Tomcat 7 server's context.xml, located at ${CATALINA_HOME}/conf/context.xml, and verify that a Resource Definition for your application exists.
   If the Resource Definition does not exits, add the following anywhere between the <context> and </context> tags:

   Code Block

   <Resource name="jdbc/MitsisDS" auth="Container" type="javax.sql.DataSource" driverClassName="oracle.jdbc.OracleDriver" url="jdbc:oracle:thin:@//earth-vault-2.mit.edu:1523/sundev11" 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"/>

   Don't forget to use your Resource Definition name in place of jdbc/MitsisDS.
   When you are satisfied that everything is correct, save the changes.

7. Open the project's pom.xml and delete the following dependency:

   Code Block
   <dependency> <groupId>oracle</groupId> <artifactId>ojdbc</artifactId> <version>1.4</version> <scope>test</scope> </dependency>

   and add the following dependency:

   Code Block
   <dependency> <groupId>com.oracle</groupId> <artifactId>ojdbc6</artifactId> <version>11.2.0.3</version> <scope>test</scope> </dependency>

   When you are satisfied that everything is correct, save the changes.

8. Search both Project Jar Dependencies and Project Test Jar Dependencies for any ojdbc-1.4.jar dependency and exclude the dependency.
   In Eclipse, this can be done by doing the following:
   1. Open a Project Explorer View, right click on your project and select Maven > Update Dependencies...
   2. Expand Maven Dependencies and scroll through the dependencies until you find the ojdbc-1.4.jar.
   3. Right click on the ojdbc-1.4.jar and select Maven > Exlude Maven Artifact...
      
9. Update APPLICATION_NAME.properties (following is for assignsupervisor property file located at:  /private/var/local/etc/assignsupervisor/assignsupervisor.properties)
   supervasgn.url=https://mv-ezproxy-com.ezproxyberklee.flo.org/advisorasgn
   supervasgn.view.on.websis.date=06/09/2011
   pdf.baseUrl=http://mv.ezproxy.com.ezproxyberklee.flo.org/advisorasgn/
   websis.url=student.mit.edu
   ###############
   email.address.from=youremail@mit.edu
   email.address.test.to=youremail@mit.edu
   email.production.mode=false
   ###############
   roles.function.category=REG
   local.authentication=true
    
   local.user.password=password
   local.user.name=srondlaavsingh
   local.mitroles=ADVISOR_ASSIGN
   local.mitroles=ADVISOR_ASSIGN_REGISTRAR
   local.mitroles=ADVISOR_ASSIGN_SUPERUSER
   local.mitroles.domain=REG
    
   import.upload.dir=${user.home}
10. Add highlighted tomcat plugin in pom.xml of maven project.
    

      <build>

            <plugins>

                <plugin>

                    <groupId>org.codehaus.mojo</groupId>

                    <artifactId>exec-maven-plugin</artifactId>

                    <version>1.2</version>

                    <configuration>

                        <executable>java</executable>

                        <arguments>

                            <argument>-jar</argument>

                            <argument>${oc4j.j2eeHome}${file.separator}admin_client.jar</argument>

                            <argument>${oc4j.connectionUri}</argument>

                            <argument>${oc4j.username}</argument>

                            <argument>${oc4j.password}</argument>

                            <argument>-deploy</argument>

                            <argument>-file</argument>

                            <argument>${project.build.directory}${file.separator}${project.artifactId}-${project.version}.${project.packaging}</argument>

                            <argument>-deploymentName</argument>

                            <argument>${project.artifactId}</argument>

                            <argument>-bindAllWebApps</argument>

                            <argument>default-web-site</argument>

                            <argument>-contextRoot</argument>

                            <argument>${project.artifactId}</argument>

                        </arguments>

                    </configuration>

                </plugin>

                <plugin>

                    <groupId>org.codehaus.mojo</groupId>

                    <artifactId>tomcat-maven-plugin</artifactId>

                    <version>1.1</version>

                    <configuration>

                        <update>true</update>

                        <server>tomcatServer</server>

                        <username>${tomcat.username}</username>

                        <password>${tomcat.password}</password>

                        <url>${tomcat.url}</url>

                        <path>${tomcat.contextPath}</path>

                    </configuration>

                </plugin>

                

                <!-- java compiler plugin -->

                <plugin>

                    <groupId>org.apache.maven.plugins</groupId>

                    <artifactId>maven-compiler-plugin</artifactId>

                    <version>3.3</version>

                    <configuration>

                        <source>1.6</source>

                        <target>1.6</target>

                    </configuration>

                </plugin>            

            </plugins>

        </build>

11. TOMCAT CONFIGURATION FOR AUTHENTICATION
    

        A)   Update server.xml and tomcat-users.xml in <tomcat home>/conf/server.xml

     

        Add the realm inside
        <Realm className="org.apache.catalina.realm.LockOutRealm">.

            <Realm className="org.apache.catalina.realm.JAASRealm" appName="Tomcat"               

                userClassNames="javax.security.auth.kerberos.KerberosPrincipal"     roleClassNames="javax.security.auth.kerberos.KerberosPrincipal" useContextClassLoader="true" debug="99"/>

     

     

        B) In <tomcat home>/tomcat-users.xml

     

        Add the role and user details under <tomcat-users>

     

        <role rolename="users"/>

     

        <user username="mayajose" password="password" roles="users"/>

     

     

        C) Create a new file "jaas.config" in in <tomcat home>/conf folder with the below contents.

     

        Tomcat {

     

        com.sun.security.auth.module.Krb5LoginModule required;

     

        };