Deploying ColdFusion 9 on Oracle Application Server 10g



The following instructions assume that you installed the J2EE configuration of ColdFusion 9 and that the EAR file to deploy is under C:\ColdFusion_J2ee\cfusion.ear.

Before you deploy ColdFusion on Oracle 10g, ensure that the following is true:

  • Oracle Application Server 10g is installed and running.

  • You set up an OC4J J2EE container for the ColdFusion installation. Adobe recommends that you create an OC4J instance for ColdFusion to avoid potential classpath issues with other applications.

  • (Recommended, but not required) You created an OC4J instance. To do so, connect to the Oracle Application Server using Enterprise Manager and create an OC4J instance. By default the HTTP URL is http://machineName:1810. If 1810 is unavailable, the next available port in sequential order is used.

  • You increased the heap size to at least 256 MB (although 512 MB is preferred). To do so, select the OC4J instance in Enterprise Manager, and select Administration / Server Properties. Under the Command Line Options category, add -Xmx256M to the Java Options, and then restart the OC4J instance.

Deploy ColdFusion 9 on Oracle 10g

  1. Ensure that the application server and the OC4J instance are running.

  2. Open a Windows command prompt and go to the oracle_root/dcm/bin directory.

  3. Deploy the ColdFusion 9 application by using the command-line tool dcmctl.bat, as follows:

    Dcmctl deployapplication -application cf_app -file c:\ColdFusion_J2ee\cfusion.ear -component oc4j_instance
  4. Edit the oracle_root/j2ee/oc4j_instance/config/java2.policy file by adding the following to the end of the file:

    grant { permission java.security.AllPermission; };
  5. Start the ColdFusion Administrator, which runs the Configuration and Settings Migration wizard.

    Note: To enable Livecycle Data Services ES on Oracle AS, specify the following JVM argument in the ColdFusion Administrator: -Doc4j.jmx.security.proxy.off=true

    You must perform some configuration steps to enable support for CFX tags written in C++, which binary files that are specific to your operating system.

Configure operating system-specific binary support for Windows

  1. Connect to Oracle AS 10g using Enterprise Manager.

  2. Go to oc4j_instance/Administration/Server Properties.

  3. Under the Environment Variables category, select Add Environment Variable.

  4. Enter PATH as the name.

  5. Enter $ORACLE_HOME\j2ee\ oc4j_instance\applications\ cf_app\cfusion\WEB-INF\cfusion\lib; as the value.

  6. Ensure that the Append option is selected.

  7. Select Apply.

  8. When the Enterprise Manager prompts you to restart, select the restart option.

Configure operating system-specific binary support for Solaris and Linux

  1. Connect to Oracle AS 10g using Enterprise Manager.

  2. Go to oc4j_instance/Administration/Server Properties.

  3. Under the Environment Variables category, select Add Environment Variable.

  4. Enter LD_LIBRARY_PATH as the name.

  5. Enter $ORACLE_HOME/j2ee/oc4j_instance /applications/cf_app /cfusion/WEB-INF/cfusion/lib; as the value.

  6. Ensure that the Append option is selected.

  7. Select Apply.

  8. When the Enterprise Manager prompts you to restart, select the restart option.

    You must enable Component Object Model (COM) support in Windows after installing ColdFusion 9 to use the cfreport tag with Crystal Reports. It is not required for the ColdFusion Report Builder or any reports that you create with the ColdFusion reporting feature.

Enable COM support

  1. In Oracle AS 10g Enterprise Manager, go to oc4j_instance /Administration/Server Properties.

  2. In the Environment Variables category, ensure that the entry PATH exists. If not, follow the instructions to enabling features with operating system-specific binaries.

  3. Add $ORACLE_HOME\j2ee\oc4j_instance\applications\cf_app\cfusion\WEB-INF\cfusion\jintegra\bin; $ORACLE_HOME\j2ee\oc4j_instance\applications\cf_app \cfusion\WEB-INF\cfusion\jintegra\bin\international as the value.

  4. Ensure that the Append option is enabled.

  5. Select Apply.

  6. When the Enterprise Manager prompts you to restart, select the restart option.

  7. In some cases, you might also have to do the following to register the Microsoft Type viewer:

    1. Open a console window and go to cf_webapp_root\WEB-INF\cfusion\lib.

    2. Register TypeViewer.dll by issuing the following command:

      regsvr32 TypeViewer.dll

      The following steps configure your application server to useColdFusion 9 charting and graphing on AIX, Linux, and Solaris systems. This step is not required to enable charting and graphing in Windows.

Enable charting and graphing

  1. In Oracle AS 10g Enterprise Manager, go to oc4j_instance/Administration/Server Properties.

  2. If the following entry does not exist in the Java Option under the Command Line Options category, add it:

    -Djava.awt.headless=true
  3. Select Apply.

  4. When the Enterprise Manager prompts you to restart, select the restart option.

Disable the RDS web module

If you installed ColdFusion 9 at a context root other than /, use the following procedure to disable the RDS redirector web module without undeploying it.

If you disable (or undeploy) the RDS redirector and do not disable the RDS servlet, RDS services are still available using the ColdFusion application context root, but tools that use RDS and require a context root of /, such as Dreamweaver and earlier versions of HomeSite, do not work.

  1. In the Oracle AS 10g Enterprise Manager, select oc4j_instance /Applications.

  2. Select Adobe ColdFusion 9 application and select Edit.

  3. In the Administration category, select Advanced Properties.

  4. In the Configuration Files category, select orion-application.xml.

  5. Comment out the RDS web module as the following example shows:

    <!-- 
    <web-module id="rds" path="rds.war" /> 
    -->
  6. Apply the changes.

  7. Restart the OC4J instance.

    You can enable the RDS web module by repeating this procedure and selecting the Enabled option.