Deploying the DSCC WAR File With a Supported Application Server

The following application servers are supported for use with DSCC:

• GlassFish Application Server 3.x

• Tomcat 6.x

• Oracle iPlanet Web Server 7.0.9 (and Sun Java System Web Server 7.0+)

• Oracle WebLogic Server 10.3.3

Application server versions prior to those listed above are not supported.

In addition, your application server must comply with the following requirements:

• All Java permissions must be granted to the DSCC application.

  By default, all the supported application servers grant these permissions to the DSCC application, with the exception of GlassFish Enterprise Server. (See Step 5 of the GlassFish procedure for information about granting permissions in GlassFish.)

• The tag pooling feature of your application server must be disabled.

  Tag pooling is disabled by default in all the supported application servers except Tomcat.

The following procedures describe the deployment instructions for each application server.

• To Deploy the DSCC WAR File With GlassFish Application Server

• To Deploy the DSCC WAR File With Tomcat

• To Deploy the DSCC WAR File With Oracle WebLogic Server

• To Deploy the DSCC WAR File With Oracle iPlanet Web Server

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.

To Deploy the DSCC WAR File With GlassFish Application Server

1. Create the WAR file for DSCC.

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

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

   For the zip 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 on which DSCC is deployed, register the DSCC agent in the 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 glassfish-domain-path $ cd app-server-install-path/bin $ asadmin create-domain --domaindir glassfish-domain-path --adminport 3737 \ --user admin dscc7

5. Edit the server.policy file.

   1. Open the server.policy file.

      $ vi glassfish-domain-path/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; };

   This statement 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 glassfish-domain-path --user admin dscc7 $ cp install-path/var/dscc7.war glassfish-domain-path/dscc7/autodeploy

   For more information about creating and configuring application server instances and deploying the WAR file, refer to the GlassFish 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 is displayed.

To Deploy the DSCC 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. Disable tag pooling.

   Tag pooling must be disabled for DSCC to work properly. To disable tag pooling, set the enablePooling parameter to false in the web.xml configuration file. For example:

   ... <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> ...

7. Enable replication topology rendering.

   ${CATALINA_HOME}/bin/shutdown.sh export CATALINA_OPTS="-Djava.awt.headless=true" ${CATALINA_HOME}/bin/startup.sh

8. Deploy the WAR file.

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

   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

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

   The Directory Service Manager Login page is displayed.

To Deploy the DSCC WAR File With Oracle WebLogic Server

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

This example assumes a basic knowledge of Oracle WebLogic Server administration and does not replace the Oracle WebLogic Server documentation. For conceptual information about domains, administration servers and managed servers, see Key Concepts in the Oracle Fusion Middleware Concepts Guide.

1. Create the WAR file for DSCC.

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

   In the native package distribution, the WAR file is created in the /var/opt/SUNWdsee7/ directory.

   In the zip distribution, 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 the 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. Navigate to base_domain/Deployments in the Domain Structure panel.

   3. Click Lock and Edit.

   4. Click Install.

   5. Click Upload your file(s).

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

   7. Select dscc7.war and click Next.

   8. Select Install this deployment as an application and click Next.

   9. Provide a Name for the deployment, accept the default Optional Settings and click Finish.

   10. Click Activate Changes in the top left corner.

   The dscc7 deployment must be in the active state.

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

   The default port number for Oracle WebLogic Server is 7001.

   The Oracle Directory Service Control Center authentication page is displayed.

To Deploy the DSCC WAR File With Oracle iPlanet Web Server

The following example shows how to install DSCC in Oracle iPlanet Web Server on a Solaris 10 system. The same procedure can be used for Sun Java System Web Server 7.0+.

If you install Oracle iPlanet 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 Oracle iPlanet 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.war

      • 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/https-example.com/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.