|
Technical Note
Deploying Macromedia ColdFusion MX 6.1
Under Oracle Application Server 10g
Author: David Jason Bennett, Technical Manager
Date: February 2004
This document details the steps required to deploy and configure Macromedia ColdFusion MX 6.1 for J2EE under Oracle Application Server (OracleAS) 10g (9.0.4). Neither Macromedia nor Oracle currently provides any direct support for ColdFusion deployed to OracleAS 10g.
The basic steps for deploying ColdFusion MX as a J2EE application can be found at http://www.macromedia.com/support/coldfusion/j2ee/cfmxj2ee_home.html and http://www.macromedia.com/support/coldfusion/j2ee/cfmxj2ee_java_deploy.html. Portions of this document use steps provided in both of Macromedia's install docs. The steps outlined in this document were tested using OracleAS 10g Enterprise Edition running under UnitedLinux 1.0.
Step 1: Download and Run ColdFusion Installer to Create cfusion.ear File
Download ColdFusion MX 6.1 (if you don't already own it) from Macromedia's web site; a 30-day trial version of the software is available for most platforms. Next, as specified in the Macromedia installation doc:
- Run the ColdFusion MX 6.1 Installation Wizard after downloading the platform-specific installer.
- Answer the questions. When prompted, do the following:
- Select Developer Edition or upgrade (if you are upgrading an existing ColdFusion MX installation)
- Select J2EE configuration and EAR file.
- Specify the installation directory in which to place the EAR or WAR files. You can use a temporary directory as the installation directory.
- If you are deploying using an EAR file, specify the context root. Macromedia recommends the context root /cfusion, but you can deploy cfusion.war at any context root, including /, as supported by your application server.
- Specify a password for use with the ColdFusion MX Administrator. The Installation Wizard places the cfusion.ear or cfusion.war and rds.war files in the installation directory. Remember the password.
Step 2: Create an OC4J Instance for ColdFusion Deployment
Using the OracleAS Enterprise Manager Console, create an OC4J instance in which to deploy ColdFusion. After creating the OC4J instance, navigate to the server properties page for the new OC4J instance and add the following java option under command line options:
Xmx256m
This configuration change will ensure that enough RAM is available to deploy the application.
Step 3: Deploy cfusion.ear to the Application Server
Using the OracleAS Enterprise Manager Console, deploy the cfusion.ear generated by the ColdFusion MX 6.1 Installation Wizard under the OC4J instance created in Step 2. Choose an application name for the deployment (for example, /coldfusion or /cfmx61). Perform the following post-deployment actions:
- From the "Deployed Applications" page of the OC4J instance where you deployed ColdFusion, click the application name link.
- Under the "Administration," choose "General."
Add the following library paths:
<ORACLE HOME>/j2ee/<OC4J Instance>/applications/<application name>/
cfusion/WEB-INF/cfusion/lib
<ORACLE HOME>/j2ee/<OC4J Instance>/applications/<application name>/
cfusion/WEB-INF/cfusion/lib/<_solaris, or _ilnx21>/bin
<ORACLE HOME>/j2ee/<OC4J Instance>/applications/<application name>/
cfusion/WEB-INF/lib
Start and stop the OC4J Instance.
Step 4: Update Path to cfusion.jar in web.xml File
The web.xml (located at <ORACLE HOME>/j2ee/<OC4J Instance>/applications/<application name>/cfusion/WEB-INF) contains the following entry:
<context-param id="macromedia_context_88">
<param-name>cf.class.path</param-name>
<param-value>./WEB-INF/cfusion/lib/cfusion.jar</param-value>
</context-param>
After stopping the OC4J instance, modify the entry to contain the full path to the cfusion.jar:
<ORACLE HOME>/j2ee/<OC4J Instance Name>/applications/<application name>/
cfusion/WEB-INF/cfusion/lib/cfusion.jar
Save the web.xml file and re-start the OC4J instance.
Step 5: Configure ColdFusion 6.1 MX
Navigate to the ColdFusion Administration page at http://<host>:<port>/cfmx/CFIDE/administrator to complete basic configuration.
Step 6: Configure Additional Components as Defined in ColdFusion 6.1 MX Doc
The ColdFusion 6.1 MX documentation includes directions for configuring additional features such as Verity Server and charting. The configuration steps include adding additional library paths, which you can add in the same manner as described in Step 3.
Step 7: Deploy Applications
Under OracleAS 10g, applications are deployed via the expanded archive method. All applications are expanded under the <ORACLE HOME>/j2ee directory. ColdFusion applications are deployed under the document root located at <ORACLE HOME>\j2ee\<OC4J Instance>\applications\<application name>\cfusion\<directory>.
Review Macromedia ColdFusion Documentation
For more detailed information concerning the actual configuration of ColdFusion 6.1 MX, refer to ColdFusion documentation.
Other Resources
Oracle Application Server 10g Download
|
Bookmark
