Sun Directory Server Enterprise Edition 7.0 Installation Guide

Appendix A Deploying DSCC WAR File With Supported Application Servers

To access and manage the server instances using web-based interface, you must deploy the WAR file, supplied with the Directory Server Enterprise Edition software, with any of the supported application servers.

All the supported application servers must comply to the following requirements:

For more information about the list of supported application servers, refer to Supported Application Servers for Directory Service Control Center in Sun Directory Server Enterprise Edition 7.0 Release Notes.

The following procedures help you in deploying your war file with an application server. These procedures do not intend to cover all the methods to deploy the war file in your application server. Refer to the respective application server documentation for more information.


Note –

The http port numbers, used to connect to the console, mentioned in the following sections are the default port numbers for each application server. The port numbers may differ if the default port numbers are already in use.


Deploying WAR File With Sun Java System Application Server

After you install Directory Server Enterprise Edition, you can deploy the WAR file to access DSCC. The following procedure contains the deployment instructions to deploy the WAR file:

ProcedureTo Deploy WAR File With Sun Java System Application Server

  1. Create the WAR file for DSCC.


    $ install-path/bin/dsccsetup war-file-create

    For native packages installation, the WAR file is created in the /var/opt/SUNWdsee7/ directory.

    For zip distribution installation, the WAR file is created in the install-path/var directory.

  2. Initialize the DSCC registry.


    $ install-path/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
  3. To create server instances on the same host where DSCC is deployed, register the DSCC agent in Common Agent Container.


    $install-path/bin/dsccsetup cacao-reg

    Type the following command to check the location and other statistics of your WAR file and DSCC registry:


    $ install-path/bin/dsccsetup status
  4. Create an application server instance.


    $ mkdir /local/domainroot
    $ cd app-server-install-path/bin
    $ asadmin create-domain --domaindir /local/domainroot --adminport 3737 \
    --user admin dscc7
  5. Edit the server.policy file.

    1. Open the server.policy file.


      $ vi /local/domainroot/dscc7/config/server.policy
    2. Add the following statements to the end of the file:


      // Permissions for Directory Service Control Center
      grant codeBase "file:${com.sun.aas.instanceRoot}/applications/j2ee-modules/dscc7/-" 
      {
      	permission java.security.AllPermission;
      };

    The addition configures the application server to grant all the Java permissions to the DSCC application.

  6. Deploy the WAR file in your application server instance.


    $ asadmin start-domain --domaindir /local/domainroot --user admin dscc7 
    $ cp install-path/var/dscc7.war /local/domainroot/dscc7/autodeploy

    For more information about creating and configuring application server instances and deploying the WAR file, refer to the Sun Java System Application Server Online Help.

  7. Open DSCC.

    Use http://hostname:8080/dscc7 or https://hostname:8181/dscc7 based on the configuration of your application server.

    The Directory Service Manager Login page displays.

Deploying WAR File With Tomcat

After you install Directory Server Enterprise Edition, you can deploy the WAR file to access DSCC. Refer to the following procedure for deployment instructions:

ProcedureTo Deploy WAR File With Tomcat

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

  1. Create the WAR file for DSCC.


    $ install-path/bin/dsccsetup war-file-create

    For native packages installation, the WAR file is created in the /var/opt/SUNWdsee7/ directory.

    For zip distribution installation, the WAR file is created in the install-path/var directory.

  2. Initialize the DSCC registry.


    $ install-path/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
  3. To create server instances on the same host where DSCC is deployed, register the DSCC agent in Common Agent Container.


    $install-path/bin/dsccsetup cacao-reg

    Type the following command to check the location and other statistics of your war file and DSCC registry:


    $ install-path/bin/dsccsetup status
  4. Install Tomcat and create an instance.

  5. Identify your Tomcat installation and instance.


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

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

  6. Enable replication topology rendering.


    ${CATALINA_HOME}/bin/shutdown.sh
    export CATALINA_OPTS="-Djava.awt.headless=true"
    ${CATALINA_HOME}/bin/startup.sh
  7. Deploy the WAR file.


    $ mkdir ${CATALINA_BASE}/webapps/dscc7
    $ unzip -d ${CATALINA_BASE}/webapps/dscc7 install-path/var/dscc7.war

    Note –

    You must disable the tag pooling on your Tomcat server instance by setting the enablePooling parameter value to false in ${CATALINA_BASE}/conf/web.xml. Add the following code in the web.xml file:



            <init-param>
                <param-name>enablePooling</param-name>
                <param-value>false</param-value>
            </init-param>

    Verify the permissions of startup.sh for Solaris operating system (tomcat5.exe or tomcat6.exe on Windows) and type the following command:


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

    The Directory Service Manager Login page displays.

Deploying WAR File With BEA WebLogic Server

After you install Directory Server Enterprise Edition, you can deploy the WAR file to access DSCC. Refer to the following procedure for deployment instructions:

ProcedureTo Deploy WAR File With BEA WebLogic Server

The following example shows how to install DSCC in BEA WebLogic Server on a Solaris 10 system.

  1. Create the WAR file for DSCC.


    $ install-path/bin/dsccsetup war-file-create

    For native packages installation, the WAR file is created in the /var/opt/SUNWdsee7/ directory.

    For zip distribution installation, the WAR file is created in the install-path/var directory.

  2. Initialize the DSCC registry.


    $ install-path/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
  3. To create server instances on the same host where DSCC is deployed, register the DSCC agent in Common Agent Container.


    $install-path/bin/dsccsetup cacao-reg

    Type the following command to check the location and other statistics of your war file and DSCC registry:


    $ install-path/bin/dsccsetup status
  4. Deploy the WAR file.

    1. Browse the WebLogic console using http://localhost:7001/console.

    2. Goto base_domain/Deployments.

    3. Click Lock and Edit.

    4. Click Install.

    5. Click Upload your file(s).

    6. In Deployment Archive, select install-path/var/dscc7.war.

    7. Click Next.

    8. Select dscc7.war and click Next a few times and Finish.

    9. Click Activate Changes in the top left corner.

    The dscc7 deployment must be in the active state.


    Note –

    The above steps are an example of how dscc7.war file is deployed into BEA WebLogic Server. The BEA WebLogic Server documentation is the only trustable source of information for deploying WAR files.


  5. Use http://hostname:port/dscc7 to connect to DSCC.

    The default port number for BEA WebLogic Server is 7001.

    The Directory Service Manager Login page displays.

Deploying WAR File With Sun Java System Web Server

After you install Directory Server Enterprise Edition, you can deploy the WAR file to access DSCC. Refer to the following procedure for deployment instructions:

ProcedureTo Deploy WAR File With Sun Java System Web Server

The following example shows how to install DSCC in Sun Java System Web Server on a Solaris 10 system.


Caution – Caution –

If you install Sun Java System Web Server as root, web server daemons run as a webservd user. In that case, the easiest way to make your deployment work successfully is to install Directory Server Enterprise Edition and pre-configure DSCC as a webservd user.


  1. Create the WAR file for DSCC.


    $ install-path/bin/dsccsetup war-file-create

    For native packages installation, the WAR file is created in the /var/opt/SUNWdsee7/ directory.

    For zip distribution installation, the WAR file is created in the install-path/var directory.

  2. Initialize the DSCC registry.


    $ install-path/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
  3. To create server instances on the same host where DSCC is deployed, register the DSCC agent in Common Agent Container.


    $install-path/bin/dsccsetup cacao-reg

    Type the following command to check the location and other statistics of your war file and DSCC registry:


    $ install-path/bin/dsccsetup status
  4. Deploy the war file.

    1. Browse the Sun Java System Web Server console using https://hostname:8989.

    2. Under the Common Tasks tab, click Add Web Application in the Virtual Server Tasks section.

    3. In the Add Web Application form, provide the following values and click OK.

      • Web Application Location: install-path/var/dscc7.var

      • URI: /dscc7

  5. Enable server-side HTML

    1. Click the Content Handling tab of the virtual server.

    2. In the Parsed HTML/SSI section, click New and then OK.

    3. In the main window, click Deployment Pending link located in the top right corner and complete deployment by following the wizard.

    4. Edit the magnus.conf file of the virtual server:


      # vi web-server-install-path/admin-server/config/magnus.conf 

      Add the following line:


      type=magnus-internal/parsed-html exts=shtml
    5. Under the Configurations tab, click the Refresh button.

    6. Click Instance Configuration Modified in the top right corner and click Pull and deploy configuration from virtual-server and click OK.

    For the detailed information about enabling server-side HTML, see Enabling Server-side HTML in Sun Java System Web Server 7.0 Developer’s Guide.

  6. Under the Configurations tab, select the configuration that you have created and click Start.

  7. Use http://hostname:8080/dscc7 to connect to DSCC.

    The Directory Service Manager Login page displays.