|
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 10gEnsure 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 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
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; };
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 WindowsConnect to Oracle AS 10g using Enterprise Manager.
Go to oc4j_instance/Administration/Server Properties.
Under the Environment Variables category, select Add Environment
Variable.
Enter PATH as the name.
Enter $ORACLE_HOME\j2ee\ oc4j_instance\applications\ cf_app\cfusion\WEB-INF\cfusion\lib;
as the value.
Ensure that the Append option is selected.
Select Apply.
When the Enterprise Manager prompts you to restart, select
the restart option.
Configure operating system-specific binary support for Solaris and LinuxConnect to Oracle AS 10g using Enterprise Manager.
Go to oc4j_instance/Administration/Server Properties.
Under the Environment Variables category, select Add Environment
Variable.
Enter LD_LIBRARY_PATH as the name.
Enter $ORACLE_HOME/j2ee/oc4j_instance /applications/cf_app /cfusion/WEB-INF/cfusion/lib;
as the value.
Ensure that the Append option is selected.
Select Apply.
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 supportIn Oracle AS 10g Enterprise Manager, go to oc4j_instance
/Administration/Server Properties.
In the Environment Variables category, ensure that the entry
PATH exists. If not, follow the instructions to enabling features
with operating system-specific binaries.
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.
Ensure that the Append option is enabled.
Select Apply.
When the Enterprise Manager prompts you to restart, select
the restart option.
In some cases, you might 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
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 graphingIn Oracle AS 10g Enterprise Manager, go to oc4j_instance/Administration/Server
Properties.
If the following entry does not exist in the Java Option
under the Command Line Options category, add it:
-Djava.awt.headless=true
Select Apply.
When the Enterprise Manager prompts you to restart, select
the restart option.
Disable the RDS web moduleIf 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.
In the Oracle AS 10g Enterprise Manager, select oc4j_instance
/Applications.
Select Adobe ColdFusion 9 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 option.
|