Accessibility
Adobe
Sign in Privacy My Adobe

ColdFusion Release Notes

Installing and Deploying ColdFusion MX 7 on Oracle 10g

Contents

About this document

You can deploy the Macromedia ColdFusion MX 7 J2EE configuration as an application running on a Java 2 Enterprise Edition (J2EE) application server. This document describes how to deploy this configuration on Oracle 10g.

Before reading this document, you should be familiar with:

Note: These instructions are for use with the ColdFusion MX 7 Updater and have been tested on Windows only.

This document uses the following conventions to refer to Oracle and ColdFusion directories:

Directory Description
oc4j_instance Name of the OC4J instance chosen for ColdFusion deployment.
oracle_root Directory where Oracle Application Server is installed; for example, C:\OraHome_1.
cf_webapp_root The directory to which the ColdFusion web application is deployed; for example, C:\oracle_root\j2ee\oc4j_instance\applications\cfmx\cfusion, where cfmx is the application name and cfusion is the name of WAR file.
cf_app Name of the deployed application.
cf_ctx_root Name of ColdFusion application context.
java_home Root directory of your Java 2 software development kit (J2SDK); for example, C: \j2sdk1.4.1.

Deploying Macromedia ColdFusion MX on Oracle 10g

This section describes how to deploy ColdFusion MX on Oracle 10g.

Note: These instructions assume that you have installed the J2EE configuration of ColdFusion MX 7 Updater and that the EAR file to deploy is under C:\CFusion_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 have set up an OC4J J2EE container for the ColdFusion installation. Macromedia recommends that you create an OC4J instance for ColdFusion to avoid potential classpath issues with other applications.
  • (Recommended, but not required) You have created an OC4J instance. To do so, connect to the Oracle Application Server using Enterprise Manager and create a new 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 have 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.

To deploy ColdFusion MX 7 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 MX 7 application using the command line tool dcmctl.bat, as the following example shows:

    Dcmctl deployapplication -application cf_app -file c:\CFusion_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 MX Administrator, which runs the Configuration and Settings Migration Wizard.

Enabling and configuring specific ColdFusion MX 7 functionality

For some ColdFusion MX 7 functionality to work properly, you must manually configure your application server.

This section provides instructions for procedures that are specific to Oracle 10g. These instructions describe what to do for the following functionality:

Additional procedures are identical for all J2EE platforms and are documented in Chapter 5, "Configuring Your System" in Installing and Using ColdFusion MX.

Enabling features with operating system-specific binaries

This step is required to support the following features that use binaries that are specific to your operating system:

  • CFX tags written in C++
  • Microsoft Access driver with Unicode support (Windows only)

These features work on Windows, Linux, and Solaris only.

Use the procedure for your operating system to configure the search paths to find the required binary files. These files are located in the cf_webapp_root\WEB-INF\cfusion\lib directory in Windows, and the cf_webapp_root/WEB-INF/cfusion/lib directory on UNIX.

To configure operating system-specific binary support in 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 check box is selected.
  7. Select Apply.
  8. When the Enterprise Manager prompts you to restart, select the restart option.

To configure operating system-specific binary support on 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 checkbox is enabled.
  7. Select Apply.
  8. When the Enterprise Manager prompts you to restart, select the restart option.

Enabling access to COM objects (Windows only)

This section describes how to enable Component Object Model (COM) support in Windows after installing ColdFusion MX 7. COM support is required 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.

To enable COM support:

  1. In Oracle AS 10g Enterprise Manager, go to oc4j_instance /Administration/Server Properties.
  2. In the Command Line Options category, add -DJINTEGRA_NATIVE_MODE -DJINTEGRA_PREFETCH_ENUMS to Java Options.
  3. In the Environment Variables category, ensure that the entry PATH already exists. If not, follow the instructions in Enabling features with operating system-specific binaries.
  4. 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.
  5. Ensure that the Append check box is enabled.
  6. Select Apply.
  7. When the Enterprise Manager prompts you a restart, select the restart option.

In some cases, you may 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

Enabling charting and graphing (UNIX)

This section describes how to configure your application server to use ColdFusion MX 7 charting and graphing on AIX, Linux, and Solaris systems. This step is not required to enable charting and graphing in Windows.

Note: For instructions on enabling charting on servers that use JVM 1.3.x, see cf_webapp_root\WEB-INF\cfusion\charting\java1.3\readme.txt

To enable charting and graphing:

  1. In Oracle AS 10g Enterprise Manager, go to oc4j_instance/Administration/Server Properties.
  2. Check the Java Option under the Command Line Options category for the entry -Djava.awt.headless=true. If this entry is not present, add it.
  3. Select Apply.
  4. When the Enterprise Manager prompts you a restart, select the restart option.

Disabling RDS

For security reasons, Macromedia recommends that you disable RDS on a production server. If you enable RDS when you install ColdFusion MX 7, you can disable it at a later time, as described in the following instructions.

Note: If you disable RDS, the following ColdFusion MX 7 features do not work: the Browse Server button in the ColdFusion MX Administrator (for example, on the ColdFusion Mappings page), and the Query Builder and charting in the ColdFusion Report Builder.

To disable RDS:

  1. Disable the ColdFusion MX 7 web module RDS Servlet. Doing so ensures that ColdFusion MX 7 cannot respond to any RDS requests.
  2. If your ColdFusion MX 7 application context root is not /, disable or undeploy the RDS redirector web module.

Disabling the RDS Servlet

To disable the RDS Servlet:

  1. In the Oracle AS 10g Enterprise Manager, select the oc4j_instance and select Stop.
  2. Make a backup copy of the cf_webapp_root\WEB-INF\web.xml file. For example, the file may be located at C:\OraHome_1\j2ee\oc4j_cf\Applications\cfmx\cfusion\WEB-INF\web.xml.
  3. Open the original web.xml file for editing.
  4. Comment out the RDS Servlet definition, as follows:

    <!--
    <servlet id="macromedia_servlet_8789">
    <servlet-name>RDSServlet</servlet-name>
    <display-name>RDS Servlet</display-name>
    <servlet-class>coldfusion.bootstrap.BootstrapServlet</servlet-class>
    <init-param id="InitParam_103401311065856789">
    <param-name>servlet.class</param-name>
    <param-value>coldfusion.rds.RdsFrontEndServlet</param-value>
    </init-param>
    </servlet>
    -->

    Some of the text in the servlet definition might vary.
  5. Comment out the RDS Servlet mapping, as the following example shows:

    <!—-
    <servlet-mapping id="macromedia_mapping_9">
    <servlet-name>RDSServlet</servlet-name>
    <url-pattern>/CFIDE/main/ide.cfm</url-pattern>
    </servlet-mapping>
    -->

    The servlet-mapping id value might vary.
  6. Save the file.
  7. Restart the ColdFusion MX 7 application.

Disabling the RDS redirector

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

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

To disable the RDS web module:

  1. In the Oracle AS 10g Enterprise Manager, select oc4j_instance /Applications.
  2. Select Macromedia ColdFusion MX 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 check box.

Undeploying ColdFusion MX 7

This section describes how to undeploy ColdFusion MX 7 from Oracle 10g.

To undeploy ColdFusion MX 7:

  1. (Windows only) If the ODBC services are installed, remove the services by navigating to the cf_webapp_root \WEB_INF\cfusion\db\SequeLink Setup directory and running the RemoveSequeLink.bat file.
  2. Using Enterprise Manager, go to oc4j_instance /Applications.
  3. Select Macromedia ColdFusion MX 7 application.
  4. Select Undeploy.
  5. Return to the Enterprise Manager home page.
  6. Go to oc4j_instance /Administration/Server Properties. Select the PATH variable containing the following, and select Remove:
    $ORACLE_HOME\j2ee\oc4j_instance\applications\cf_app\cfusion\WEB-INF\cfusion\lib;
    $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
  7. Remove the following entries from Java Option under the Command Line Options category:
    -DJINTEGRA_NATIVE_MODE -DJINTEGRA_PREFETCH_ENUMS
  8. Apply the settings.
  9. When Enterprise Manager prompts you to restart, select the restart option.

Top Support Topics

 

More ColdFusion Topics

Choose a category to see more topics.

Request Support

 

Additional ColdFusion Resources

 

ColdFusion Downloads

 

Outside Resources

 

Feedback

 

Community