How Do I Deploy to Oracle9iAS 9.0.2.x via Remote DCM using Oracle9i JDeveloper
9.0.3 ?
An Oracle JDeveloper How To Document
November 19, 2002
Content
Introduction
This document describes in detail the steps required to remotely deploy applications
to Oracle9iAS 9.0.2.x from Oracle9i JDeveloper 9.0.3 using Oracle9iAS Distributed
Configuration Management (DCM).
Note:- Deployment of BC4J applications to Oracle9iAS 9.0.2.x from Oracle9i
JDeveloper 9.0.3 is not supported . For more information see supported
configurations.
Deploying DCM Servlet to Oracle9iAS 9.0.2.x
For successful deployment of applications created in JDeveloper Version
9.0.3 to Oracle9iAS 9.0.2.x via the DCM servlet, you must install the
DCM Servlet, Oc4jDcmServlet.ear, to a running Oracle Enterprise Manager
instance. This servlet is required to run in the same OC4J instance (same
JVM) as the Enterprise Manager servlet. The DCM Servlet is located in:
<jdev_install>/dcm/lib/Oc4jDcmServlet.ear
Deploy the Oc4jDcmServlet.ear using the following two admin.jar commands.
Enter the commands exactly as follows substituting ${xxx} parameters with
the actual values for your configuration. For example, substitute ${ORACLE_HOME}
with the Oracle Home directory for your iAS configuration. All the other
parameters must have the exact literal values shown (adjustments for the
paths to Java and Oc4jDcmServlet.ear).
1. Java -jar <jdev_install>/j2ee/home/admin.jar ormi://${EM_OC4J_HOST}:${EM_OC4J_PORT}
${IAS_ADMIN_USER} ${IAS_ADMIN_PASS} -deploy -file Oc4jDcmServlet.ear -deploymentName
Oc4jDcmServlet
Example
Java -jar <jdev_install>/j2ee/home/admin.jar ormi://localhost:1811
ias_admin manager -deploy -file Oc4jDcmServlet.ear -deploymentName Oc4jDcmServlet
2. Java -jar ${ORACLE_HOME}/j2ee/home/admin.jar ormi://${EM_OC4J_HOST}:${EM_OC4J_PORT}
${IAS_ADMIN_USER} ${IAS_ADMIN_PASS} -bindWebApp Oc4jDcmServlet Oc4jDcmServlet
emd-web-site /Oc4jDcmServletAPI
Example
Java -jar ${ORACLE_HOME}/j2ee/home/admin.jar ormi://localhost:1811 ias_admin
manager -bindWebApp Oc4jDcmServlet Oc4jDcmServlet emd-web-site /Oc4jDcmServletAPI
where the username and password for Enterprise Manager is ias_admin/manager.
Modify the Enterprise Manager servlet configuration
Modify the Enterprise Manager servlet configuration by editing the following
files:
In ${ORACLE_HOME}/sysman/j2ee/application-deployments/em/emd/orion-web.xml,
comment out the following lines:
<!--
<classpath path="/technology/<ORACLE_HOME>/dcm/lib/dcm.jar" />
-->
<!--
<classpath path="/technology/<ORACLE_HOME>/j2ee/home/jaznplugin.jar"
/>
-->
In ${ORACLE_HOME}/sysman/j2ee/config/em-app.xml, add the following lines:
<!-- Added dcm.jar and jaznplugin.jar in order to let -->
<!-- EM share the same DCM stack with the DCM servlet API -->
<library path="/technology/<ORACLE_HOME>/j2ee/home/jaznplugin.jar" />
<library path="/technology/<ORACLE_HOME>/dcm/lib/dcm.jar" />
where ${ORACLE_HOME} is the location of the Oracle9iAS ORACLE_HOME.
After deploying oc4j-dcm-servlet.ear to a running Enterprise Manager OC4J
instance and editing the orion-web.xml and em-app.xml files, you must
restart Enterprise Manager by issuing these commands from
${ORACLE_HOME}/bin/:
emctl stop
emctl start
Note: You will be prompted for the Enterprise Manager password. On
Windows platform you can stop and start enterprise manager using Windows
Services also.
Creating a connection to Oracle9iAS
To create a connection to an Oracle9iAS instance via remote DCM:
- In the Navigator, click + to expand the Connections node.
- Right-click Application Servers.
- Choose New Connections from the context menu. The Connection Wizard
- Welcome page is displayed.
- Click Next.
- Enter a Connection Name for this connection.
- In the Connection Type list box, select Oracle9i Application Server
- Remote DCM.
- Click Next.
- Enter a Username and Password that corresponds to the Oracle9iAS admin
user.
- Click Next.
- On the Connection page, configure the settings for the Enterprise
Manager host and port, the Oracle Home directory for the remote Oracle9iAS
instance, and the OC4J instance name.
- Click Next.
- On the Test page, Click Test Connection.
- After successful completion, click Finish.
Deploying applications to Oracle9iAS connection
In the Navigator, right-click on the deployment profile node (with .deploy
extension) and choose the Oracle9iAS connection created earlier.
FAQ
- Test Connection returns
Test failed (-2). Invalid Oracle Home directory
Make sure the Remote Oracle9iAS Home directory is correctly specified
in connection page. Directory name is case sensitive.
- Test Connection returns
HTTP response code = 404, HTTP response msg = Not Found####
HTTP response is NOT ok
Closing connection to Oc4jDcmServlet####
DCM command did not complete successfully (404)####
Invalid servlet path
Make sure the DCM Servlet deployment commands are properly executed.
Binding names used for the DCM Servlet are case sensitive. If there
is a mismatch in the binding name,
re-deploy DCM Servlet
- Test Connection returns
Test failed (401). HTTP return code was 401
Make sure the username/password specified for the connection is correct
| 
Bookmark
