Sun Java System Directory Server Enterprise Edition 6.3 Installation Guide

ProcedureTo Deploy WAR File with Tomcat

After you install Directory Server Enterprise Edition, the WAR file, dscc.war, is at install-path/var/dscc6/.

The dscc.war is installed in the same way as any other web application, except the following settings:

The following example shows how to install DSCC in Tomcat on a Solaris 10 system.

  1. Initialize the DSCC registry.


    $ install-path/dscc6/bin/dsccsetup ads-create
    Choose password for Directory Service Manager:
    Confirm password for Directory Service Manager:
    Creating DSCC registry...
    DSCC Registry has been created successfully
  2. Identify your Tomcat installation and instance.


    $ setenv CATALINA_HOME tomcat-install-path
    $ setenv CATALINA_BASE tomcat-instance-path
    $ setenv JAVA_HOME jdk-home-dir
    

    For installing Tomcat and creating instances, refer to the Tomcat documentation.

  3. Deploy the WAR file.

    Create the dscc directory as shown below:


    $ mkdir ${CATALINA_BASE}/webapps/dscc

    Copy the dscc.war file into newly created dscc folder and unzip the dscc.war file.


    $ unzip -d ${CATALINA_BASE}/webapps/dscc install-path/var/dscc6/dscc.war

    Add the emphasized text in the ${CATALINA_BASE}/conf/web.xml file as shown below:


     ...
        <servlet>
            <servlet-name>jsp</servlet-name>
            <servlet-class>org.apache.jasper.servlet.JspServlet</servlet-class>
            <init-param>
                <param-name>fork</param-name>
                <param-value>false</param-value>
            </init-param>
            <init-param>
                <param-name>xpoweredBy</param-name>
                <param-value>false</param-value>
            </init-param>
    	...
            <init-param>
                <param-name>enablePooling</param-name>
                <param-value>false</param-value>
            </init-param>
            <load-on-startup>3</load-on-startup>
        </servlet>
        ....

    Verify the permissions of startup.sh (tomcat5.exe on Windows) and run the following command:


    $ ${CATALINA_HOME}/bin/startup.sh
  4. Use http://hostname:8080/dscc to connect to DSCC.

    The Directory Service Manager Login page displays.

    See Getting Started With Directory Service Control Center.