Oracle® Fusion Middleware Installation Guide for Oracle Directory Server Enterprise Edition 11g Release 1 (11.1.1.7.0) Part Number E28973-01 |
|
|
PDF · Mobi · ePub |
To access and manage server instances using a web-based interface, you must deploy the DSCC WAR file, supplied with the Directory Server Enterprise Edition software, with one of the supported application servers.
This appendix describes the minimum requirements that must be met by the application server and provides basic instructions on how to deploy the DSCC WAR file with the application server. These procedures do not intend to cover all possible methods to deploy the WAR file for a specific application server. For more information pertaining to a specific application server, refer to the respective application server documentation.
This Appendix contains the following topics:
Deploying the DSCC WAR File With a Supported Application Server
To Deploy the DSCC WAR File With GlassFish Application Server
For information about supported hardware and sofware, see the "ODSEE CertificationMatrix " (http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-certification-100350.html).
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..
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.
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.
Create an application server instance. Run the following commands:
$ mkdir glassfish-domain-path $ cd app-server-install-path/bin $ asadmin --user admin create-domain --domaindir glassfish-domain-path --adminport 3737 dscc7
Deploy the WAR file in your application server instance.
$ asadmin --user admin start-domain --domaindir glassfish-domain-path 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.
In the GlassFish JVM options settings, verify the following property is set to true
:
-Djava.awt.headless=true
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.
The following example shows how to install DSCC in Tomcat on a Solaris 10 system.
Install Tomcat.
For installing Tomcat and creating instances, refer to the Tomcat documentation.
Disable tag pooling.
Tag pooling must be disabled for DSCC to work properly. To disable tag pooling, in the $CATALINA_HOME/conf/web.xml
configuration file, set the enablePooling
parameter to false
. 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> ...
Enable replication topology rendering.
$ export CATALINA_OPTS="-Djava.awt.headless=true"
In the ${CATALINA_HOME}/conf/tomcat-users.xml
file, add a user that has a Tomcat administrator role. For example :
<role rolename="manager"/> <user username="admin" password="admin" roles="manager"/>
Restart Tomcat.
Verify that you have the appropriate permissions to run the startup script (startup.sh
on Solaris, tomcat5.exe
or tomcat6.exe
on Windows).
Type the following commands:
$ ${CATALINA_HOME}/bin/shutdown.sh $ ${CATALINA_HOME}/bin/startup.sh
Use a browser to open the Tomcat administration page.
Access the following URL: http://
hostname:8080
Click Tomcat Manager > Administration tab. Then log in as the administrative user you defined in the step 4 above.
Deploy the DSCC WAR file.
Copy the DSCC WAR file to an accessible file system.
In the Tomcat Administration tab, click the Deploy tab.
Browse your file system to find and select the DSCC WAR as the "WAR File to Deploy," and then click Deploy.
In the list of the Tomcat deployed applications to connect to, choose /dscc7
.
The Directory Service Manager Login page is displayed.
The following example shows how to install DSCC in Oracle WebLogic Server on a Solaris 10 system.
Note:
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.
Browse the WebLogic console using http://localhost:7001/console
.
Navigate to base_domain/Deployments
in the Domain Structure panel.
Click Lock and Edit.
Click Install.
Click Upload your file(s).
In Deployment Archive
, select install-path
/var/dscc7.war
and click Next.
Select dscc7.war
and click Next.
Select Install this deployment as an application and click Next.
Provide a Name for the deployment, accept the default Optional Settings and click Finish.
Click Activate Changes in the top left corner.
The dscc7
deployment must be in the active
state.
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.
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+.
Caution:
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.
Browse the Oracle iPlanet Web Server console using https://hostname:8989
.
Under the Common Tasks tab, click Add Web Application in the Virtual Server Tasks section.
In the Add Web Application form, provide the following values and click OK.
Web Application Location: install-path
/var/dscc7.war
URI: /dscc7
Enable server-side HTML.
Click the Content Handling tab of the virtual server.
In the Parsed HTML/SSI section, click New and then OK.
In the main window, click Deployment Pending link located in the top right corner and complete deployment by following the wizard.
Edit the magnus.conf
file of the virtual server:
# vi install-path/https-virtual-server/config/magnus.conf
Add the following line:
type=magnus-internal/parsed-html exts=shtml
Under the Configurations tab, click the Refresh button.
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 Oracle iPlanet Web Server 7.0.9 Developer's Guide.
Under the Configurations tab, select the configuration that you have created and click Start.
In the Oracle iPlanet Web Server JVM options settings, verify the following property is set to true:
-Djava.awt.headless=true
Use http://
hostname
:8080/dscc7
to connect to DSCC.
The Directory Service Manager Login page displays.