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.

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.

Deploying Macromedia 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:

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

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

Deploy the ColdFusion MX 7 application using the command line tool dcmctl.bat, as the following example shows:

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.

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.

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:

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

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:

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

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.

Select Apply.

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.

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:

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

Select Macromedia ColdFusion MX application and select Edit.

In the Administration category, select Advanced Properties.

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

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

<!--
<web-module id="rds" path="rds.war" />
-->

Apply the changes.

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:

(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.