Important: This copy of the installation documentation available on the DVD may be dated, to access the latest
documentation, see
Before installing Adobe ColdFusion 10, review the ColdFusion product editions, system requirements, and other highlevel considerations.
About the ColdFusion installation
ColdFusion provides a powerful and flexible installation and upgrade process. The ColdFusion installation process
includes the following phases:
1 Plan the installation by determining your installation, configuration, and upgrade options.
2 Run the ColdFusion installer.
3 (J2EE configuration only) Deploy and configure ColdFusion on your J2EE application server.
The ColdFusion installation process supports the following scenarios:
ColdFusion Help.
1
New installation Install ColdFusion on a computer with no earlier ColdFusion installation.
Upgrade installation You can upgrade from ColdFusion 8 or ColdFusion 9. When upgrading, the installer
preserves the existing settings and installs in a new directory, automatically assigning ports that do not conflict with
the existing installation.
You can install ColdFusion 10 in any of the following configurations:
Server configuration Lets you install ColdFusion 10 with an embedded JEE server. This was formerly known as the
stand-alone configuration. For enterprise and developer licenses, you can create and manage new ColdFusion
instances. For information on installing the server configuration, see
page 4.
Note: ColdFusion 10 does not offer a separate multi-server mode of installation.
J2EE configuration (Enterprise Edition only) Lets you deploy ColdFusion 10 as a Java application running on a Java
2 Enterprise Edition (J2EE) application server, using a third-party J2EE server, such as IBM WebSphere or Oracle
WebLogic. When you use the J2EE configuration, you can deploy ColdFusion 10 multiple times on a single
computer. For information on installing the J2EE configuration, see
page 22.
“Installing the Server Configuration” on
“Installing the J2EE Configuration” on
Installing ColdFusion 10
ColdFusion 10 product editions
The ColdFusion 10 product editions are available on the Adobe website. To view the product editions, go to
www.adobe.com/go/learn_cfu_cfeditions_en.
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Preparing to Install ColdFusion
System requirements
The ColdFusion 10 system requirements are available on the Adobe website. To view the system requirements,
including a list of supported J2EE application servers, see
www.adobe.com/go/learn_cfu_cfsysreqs_en.
Installation considerations
Before installing ColdFusion 10, review the considerations for installing or upgrading on your platforms.
Note: To use VisiBroker for CORBA connections in ColdFusion, see “Enabling CORBA support” on page 59.
• ColdFusion 10, ColdFusion 9, and ColdFusion 8 can coexist on the same system.
• In the case of ColdFusion cluster setup, any changes to the cluster settings, for example, adding a new member, or
changing member port (in the ColdFusion Administrator) causes web server restart. This may result in page time-out.
Refresh the page to resolve this issue.
• If ColdFusion uninstaller is not able to remove the connector for Apache (for example, in the case of Mac OS X),
do the following to manually remove it:
1 Delete the mod_jk.conf found in {apache_install_location}/conf/ directory.
2 Delete {cfroot}/config/wsconfig/1 folder which has the Apache connector file, mod_jk.so.
3 Remove the following line from {apache_install_location}/conf/httpd.conf file:
Include "{apache_install_location}\conf\mod_jk.conf".
2
4 Delete the file {apache_install_location}\conf\mod_jk.conf
• From the ColdFusion Administrator, when you wish to start multiple instances, start the cfusion instance first,
and then start the other instances..
• When you run the ColdFusion uninstaller, the logs folder (ColdFusion_Home/cfusion/) is deleted.
• When you install ColdFusion, you can install the Administrator Component to start and stop remote server.
Use the Remote Instance Administrator Component credentials to remotely start/stop the server from applications
such as Server Manager, Instance Manager in ColdFusion Administrator, or ColdFusion Builder.
• J2EE deployment of ColdFusion EAR or WAR on JRun is not supported. The EWS.jar must be present in the
systemclasspath while deploying on a J2EE server.
Installation considerations for all platforms
The following are installation considerations for all platforms:
Installation considerations for Windows
The following installation considerations are for Windows systems only:
• Do not configure the server running ColdFusion as a Primary Domain Controller (PDC) or Backup Domain
Controller (BDC). Adobe follows the Microsoft network model, in which the first level is the PDC or BDC. These
systems only manage the network or domain and are not designed to run application servers. ColdFusion should
reside on the second level of Microsoft Windows stand-alone systems. Stand-alone servers can participate in a
network or domain.
• Microsoft Windows XP handles only ten incoming TCP/IP connections concurrently. Therefore, Adobe does not
recommend using this operating system in a production environment; use Microsoft Windows 2003 Server and
Windows 2008 Server instead.
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Preparing to Install ColdFusion
Installation considerations for UNIX
The following are installation considerations for UNIX systems only:
• For troubleshooting purposes, the installer creates the following log file during an installation or upgrade in UNIX:
cf_root/Adobe_ColdFusion_10_InstallLog.log. If you contact AdobeTechnical Support for installation support,
send them this file.
• If you are deploying the J2EE configuration on a platform other than Linux or Solaris, use the
ColdFusion_10_WWEJ_java.jar. This Java-only installer does not include features that require platform-specific
binary files, such as C++ CFX support.
3
Last updated 7/9/2012
Chapter 2: Installing the Server
Configuration
The ColdFusion server configuration contains an embedded copy of Tomcat and is most similar to earlier versions of
ColdFusion.
Note: The cf_root directory refers to your installation directory. By default, this directory is C:\ColdFusion10 in
Windows, and /opt/coldfusion10 in UNIX.
Gathering information necessary to install the server
configuration
Although the ColdFusion 10 installer provides an intuitive interface, it helps to plan your answers to the questions
asked by the installer. Use the following tables to help plan for installing the server configuration of ColdFusion 10.
Identify a list of IP addresses that will have access to the ColdFusion Administrator.
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing the Server Configuration
QuestionAnswer
Configure OpenOffice___Yes
___No
Path to server binary? (Apache) ___________________________________________________
Whether to enable RDS?___ Yes
___ No
Note: RDS allows the server to interact with remotely connected developers. Adobe
recommends that you disable RDS for production servers.
Disabling RDS also disables the directory browsing applets in the ColdFusion
Administrator.
RDS password?___________________________________
Automatically check for server updates?___Yes
___No
Installing ColdFusion using the server configuration
5
Once you have determined the answers to the questions in the section “Gathering information necessary to install the
server configuration” on page 4, you can install the ColdFusion server configuration in Windows or UNIX, as
applicable.
Installing ColdFusion server configuration in Windows or MAC
Note: (Windows only) The Windows installer requires a computer that supports at least 256 colors.
Install ColdFusion in Windows or MAC
1 Read the online version of the Release Notes for any late-breaking information or updates. For more information,
www.adobe.com/go/learn_cfu_releasenote_en.
see
2 Ensure that your operating system meets the system requirements described on the Adobe website at
www.adobe.com/go/learn_cfu_cfsysreqs_en.
3 Review “Installation considerations for Windows” on page 2 and “Installation considerations for all platforms” on
page 2.
4 Determine the answers to the questions in the table in “Gathering information necessary to install the server
configuration” on page 4.
5 Close any applications that are currently running on your computer.
6 If you plan to configure an external web server, ensure that the web server is running.
7 Insert the DVD or download the setup file from the Adobe website.
8 If the installation wizard does not start automatically when you insert the DVD, locate the appropriate installer file
on the DVD and double-click it. If you are installing from a network or a downloaded file, locate the ColdFusion
installer Windows only: coldfusion_10_WWEJ_win32.exe/coldfusion_10_WWEJ_win64.exe and double-click
it.MAC only:Extract the coldfusion_10_WWEJ_osx10.dmg file and double-click the installer.
9 Follow the instructions in the installation wizard, and let it run to completion.
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing the Server Configuration
10 Click OK to open the ColdFusion Administrator and configure the server.
11 To install any other integrated Adobe or third-party technologies, see “Installing Integrated Technologies” on
page 46.
12 Configure and manage your system, as described in “Configuring Your System” on page 52.
13 To learn about ColdFusion, read the documentation, which is accessible through the Documentation link on the
Resources page of the ColdFusion Administrator.
Installing the ColdFusion server configuration in UNIX
By default, ColdFusion installs into the /opt/coldfusion10 directory. You can also choose to install ColdFusion 10 in a
different directory.
Note: The default user is nobody for the UNIX installer running ColdFusion.
Install the ColdFusion server configuration in UNIX
1 Read the online version of the Release Notes for any late-breaking information or updates. For more information,
www.adobe.com/go/learn_cfu_releasenote_en.
see
2 Ensure that your operating system meets the system requirements described on the Adobe website at
www.adobe.com/go/learn_cfu_cfsysreqs_en.
3 Review “Installation considerations for UNIX” on page 3 and “Installation considerations for all platforms” on
page 2.
4 Determine the answers to the questions in the section “Gathering information necessary to install the server
configuration” on page 4.
5 If you plan to configure an external web server, ensure that the web server is running.
6 Log in as root.
7 Copy the installation file that is appropriate for your platform and locale from the DVD or Adobe website, and save
it to a directory on your local disk.
The following installation files are those for the supported server configuration platforms:
8 Using the cd command, go to the directory that contains the installation file.
9 Ensure that you have executable permission for the installation file. You can change permissions on the file by using
the following command:
chmod 777 ColdFusion_10_WWEJ_solaris64.bin
10 Start the installation with the following command:
./<filename>
Note: To run the Linux installer in GUI mode, type ./<filename> -i gui.
11 Follow the prompts in the installation program, and let it run to completion.
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing the Server Configuration
Note: For security reasons, it is crucial that you do not use root for the runtime user.
12 Start ColdFusion with the following command:
/cf_root/cfusion/bin/coldfusion start
If you specified the use of an external web server when you ran the installer, ColdFusion automatically runs the
cf_root/cfusion/bin/cf-connectors.sh script when it starts the first time. This shell script runs the Web Server
Configuration Tool by using the settings that you specified during the installation. If there are problems running
this script, review the configuration and bin directory specifications, modify as necessary, and rerun the script. You
can also configure your web server by using the scripts in cf_root/cfusion/bin/connectors, as appropriate.
To stop ColdFusion, use the following command:
/cf_root/cfusion/bin/coldfusion stop
For more information on managing processes, see “Managing the ColdFusion process in UNIX” on page 53.
13 Open ColdFusion Administrator to run the Configuration wizard.
14 Configure and manage your system, as described in “Configuring Your System” on page 52.
15 To install any other integrated Adobe or third-party technologies, see “Installing Integrated Technologies” on
page 46.
16 To learn about ColdFusion, read the documentation, which is accessible through the Documentation link on the
Resources page of the ColdFusion Administrator.
7
ColdFusion installation directory structure
By default, ColdFusion10 is your installation directory. The following table describes the directory structure:
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing the Server Configuration
DirectoryDescription
cfusionContains the following directories:
• bin: Programs for starting, stopping, and viewing information for ColdFusion, and to run Crystal Reports (Windows
only). It also contains the password reset scripts for server administrator and Admin Component for remote server
start and stop.
• cache: Repository for temporary files from ColdFusion.
• cfx: Sample C++ and Java CFX files with their supporting files. You can also store your CFX files in this directory
(although you can put them in any location that is defined in your classpath).
• charting: Files for the ColdFusion graphing and charting engine.
• CustomTags: Repository for your custom tags
• db: The sample Apache Derby databases for all platforms.
• gateway: Files for ColdFusion event gateways.
• jetty: Solr configuration files and files related to remote instance start and stop.
• jintegra: (Applies only to Windows) JIntegra programs, libraries, and other supporting files (for example, to integrate
Java and COM code; manage access to ActiveX controls (OCXs) that are hosted in a graphical user interface (GUI)
container; and register the JVM and type libraries). (Applicable only for Windows.)
8
• jnbridge: Files for .NET Integration Services.
• lib: JAR, XML, property, and other files that are the foundation of ColdFusion, for functionality such as queries,
charting, mail, security, Solr, and system probes.
• logs: Repository for ColdFusion log files. JRE-specific log files are in the runtime/logs directory. Console outputs are
logged in to
coldfusion-out.log instead of cfserver.log.
• Mail: Repository for spooled mail and mail that cannot be delivered.
• META-INF: XML metadata for the ColdFusion Administrator.
• MonitoringServer: Contains crossdomain.xml used for multi-server monitoring.
• registry: (UNIX only) Flat file to store registry settings
• runtime: Programs and supporting files for the ColdFusion runtime. Also, contains the Tomcat libraries. The conf
directory in runtime contains all Tomcat configuration files.
• stubs: web services.
• wwwroot: Default web root directory for the built-in web server. When running on other web servers, this directory
contains the CFIDE and WEB-INF directories; do not remove this directory.
The following table shows the directories in ColdFusion 9 and the corresponding ones in ColdFusion 10:
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing the Server Configuration
ColdFusion 9ColdFusion 10
cfrootcfusion
9
ColdFusion9\runtim
e\jre
ColdFusion9\uninst
all
ColdFusion9\runtim
e\lib\wsconfig
ColdFusion10\jre
ColdFusion10\uninstall
ColdFusion10\config\wsconfi
g
Note: The ColdFusion_install\cfusion\bin directory contains the Jvm.config file.
Using the built-in web server
ColdFusion provides in-built Tomcat application server that you can use to develop ColdFusion applications.
During the ColdFusion installation, choose a web server. If you select the built-in web server, your web root directory
is located in the cfroot/wwwroot directory. By default, the web server runs on port 8500. It means that to display a page
in your application, append:
http://localhost:8500/YourApp1/index.cfm. If the page does not appear, ensure that the document is located in the
built-in web server’s web root directory; for example, C:\ColdFusion10\cfusion\wwwroot\YourApp1\index.cfm.
Note: If port 8500 is in use, the installer checks up to 100 ports (starting with 8501) to find a port that is not used.
ColdFusion uses that port and displays a message to indicate the selected port.
If you select an external web server during installation, the built-in web server is deactivated.
8500 to the host name or IP address in the URL; for example,
Change the port of the built-in web server
1 Back up the server.xml file.
This file is in the cfroot\cfusion\runtime\conf directory.
2 Open the original server.xml file for editing.
3 Search for internal webserver start. Update the port number.
Note: To enable OS Symbolic links after switching to Tomcat, edit the context.xml file found in
/cfusion/runtime/conf/ to add allowLinking="true" attribute to the context element.
Starting, stopping, and restarting ColdFusion
On Windows
❖ At prompt, go to the directory cfroot\cfusion\bin and run the following command: coldfusion.exe -start -
console.
To stop ColdFusion, use the command coldfusion.exe -stop -console. To restart, use the command
coldfusion.exe -restart -console.
Alternatively, you could also start, stop, and restart ColdFusion server using Windows Services.
10
Note: Paused tasks misfire when restarting ColdFusion.
Note: As possible in previous versions of ColdFusion, you can also use the cfstart script to start/stop the ColdFusion sever.
Note: The -console argument is optional. If it is not provided, the logs are saved in the cfroot\cfusion\logs
directory.
On UNIX/Linux/Solaris/MAC OSX
❖ At prompt, go to the directory cfroot\cfusion\bin and run the following command: ./coldfusion start
To stop ColdFusion, use the command ./coldfusion stop. To restart, use the command ./coldfusion
restart.
Note: Paused tasks misfire when restarting ColdFusion.
Note: Use the status command to find the status of ColdFusion server.
Editing the JVM settings
To edit the JVM settings, open the cfroot\cfusion\bin\jvm.config file and update the following details:
• java.home: Java home. If not set, ColdFusion verifies the default JRE in the cfroot\jre folder, in the registry, or
AVA_HOME environment variable.
in the J
• java.args: Settings for -Xmx, ColdFusion classpath, and so on.
• java.library.path: Settings for library path.
• java.class.path: Additional classpath settings in a comma-separated list.
• application.home: Default is cfroot\cfusion
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing the Server Configuration
Creating and editing a new ColdFusion instance
After installing ColdFusion in stand-alone mode, create an instance of ColdFusion using the ColdFusion
Administrator.
1 In the ColdFusion Administrator, go to Enterprise Manager > Instance Manager.
2 Click Add New Instance.
3 Enter the server name and server directory.
4 (Optional) Check Create Windows Service.
5 Click Submit.
In the Instance Manager, start, stop, restart, delete, access website, or access administrator.
6 Click the Edit icon to edit the instance manager.
7 Edit the internal webserver port and load balancing factor.
Load balancing factor represents the load the instance takes up. Load balancing factor is applicable only if the
instance is part of the cluster.
For example, the load balancing factor for the first instance is 1 and that of the second instance is 2. The second
instance receives two times more requests.
11
8 Click Submit.
Registering a remote instance
Register a new remote instance of ColdFusion using the ColdFusion Administrator.
1 In the ColdFusion Administrator, click Enterprise Manager > Instance Manager > Register Remote Instance.
2 Specify the details such as instance name, remote host, remote port, http port, and JVM route.
Instance name is a string that is used to identify the instance. Remote port and HTTP port are displayed in the
Instance Manager page. These ports are provided in the
the instance. Remote port is the AJP port and the instance port is the connector port.
JVM route is the remote instance name. The JVM route is an attribute that acts as an identifier for a particular
Tomcat worker. JVM route is provided in the
For more information on JVM route, see
Note: A remote instance and a local instance cannot have the same JVM route if they are added in a cluster with sticky
session enabled.
3 If you want remote start and stop functionality over HTTP, enter Admin Component port, Admin Component
user name, and Admin Component password. The default Admin Component port is 8985.
Note: To enable this feature, install admin component on the remote host.
a In the remote host, open the ColdFusion_installtion\cfusion\jetty\etc\jetty.xml.
b Search for the string, org.mortbay.jetty.bio.SocketConnector.
c Update the host with the IP address of the remote host.
d Restart the jetty server.
server.xml file available in the runtime\conf folder of the instance.
server.xml file available in the runtime\conf folder of
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing the Server Configuration
4 Click Submit.
Adding start and stop functionality to a remote instance
over HTTPS
You can start and stop a remote instance over HTTPS or HTTP. To enable this feature, install admin component while
installing ColdFusion. You can install Solr, admin component, or both while installing ColdFusion.
1 Do the following in the remote host.
a In the remote host, generate a private key in a keystore file. Provide the details at prompt.
c Register the remote instance using the ColdFusion Administrator. For more information, see “Registering a
remote instance” on page 11.
d In the Register Remote Instance page, enter the admin component port, admin component user name, and
admin component password (user name and password. These details you specified while installing the Remote
Instance Administrator). The default https port is 8443.
e Select the HTTPS check box.
f Click Submit.
Setting up remote start and stop functionality using
HTTPS in Server Manager
You can set up start and stop remote instance functionality in Server Manager. To enable this feature, install Remote
Instance Administrator while installing ColdFusion.
1 Do the following in the remote host.
a In the remote host, generate a private key in a keystore file. Provide the details at prompt.
3 Open wwwroot\CFIDE\ServerManager\ServerManager.air on the local host.
4 Specify the connection details.
5 Click Start/Stop Details.
6 Select HTTPS.
7 Provide the following information:
• App Server Username: User name for the admin component that you specified while installing ColdFusion.
Default value is admin.
• App Server Password: Password for the admin component.
• Port: ColdFusion remote instance’s HTTPS port.
• Server: ColdFusion remote instance name.
• ColdFusion Version: For ColdFusion, 10.
• Admin Server Port: Default https port is 8443. Port of the Jetty server.
• Context Root: Value is AdminServlet.
8 Click Apply.
14
Setting up remote start and stop functionality using
HTTP in Server Manager
You can set up start and stop remote instance functionality in Server Manager. To enable this feature, install Remote
Instance Administrator while installing ColdFusion.
1 Do the following in the remote host:
a In the remote host, open the ColdFusion_installtion\cfusion\jetty\etc\jetty.xml.
b Search for the string, org.mortbay.jetty.bio.SocketConnector.
c Update the host with the IP address of the remote host.
d Start the jetty server. Go to the ColdFusion_installation\cfusion\jetty directory and use jetty.exe.
You can also use the jetty services in the Windows services.
2 Open wwwroot\CFIDE\ServerManager\ServerManager.air on the local host.
3 Specify the connection details.
4 Click Start / Stop Details.
5 Select HTTP.
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing the Server Configuration
6 Provide the following information:
• App Server Username: User name for the admin component that you specified while installing ColdFusion.
The default value is
admin.
• App Server Password: Password for the admin component.
• Port: ColdFusion remote instance’s HTTP port.
• Server: ColdFusion remote instance name.
• ColdFusion Version: For ColdFusion Zeus, 10.
• Admin Server Port: Default https port is 8985. Port of the Jetty server.
• Context Root: Value is AdminServlet.
7 Click Apply.
Managing clusters
Manage clusters using the ColdFusion Administrator.
1 In the ColdFusion Administrator, click Enterprise Manager > Cluster Manager.
2 Enter a cluster name and then click Add.
3 Click the cluster name and move the servers to the cluster based on the requirement.
4 (If necessary) Edit the multicast port.
Multicast port is used to group the cluster members together. Default value of multicast port is 45564. After you
create a cluster, the port is added in the
cfroot\config\cluster.xml file.
15
For more information on multicast port, see http://tomcat.apache.org/tomcat-7.0-doc/config/cluster-
membership.html.
5 Specify if you need sticky session.
Sticky session ensures that after a session is established on an instance, all future requests from the client are
mapped to that instance.
6 Click Submit.
Note: Restart the web server if cluster instances are modified.
Adding a remote instance to a cluster
To add a remote instance to a cluster, add the cluster block to the remote instance’s server.xml. Then, register the
remote instance and add the instance to the cluster. For more information on configuring clusters on Tomcat, see
SSL allows the browser and the server to communicate over a secured connection. Data that is sent is encrypted at one
side, transmitted, and then decrypted at the other end. For more information about SSL configuration on Tomcat, see
Note: If you do not provide a password, the default password for keystore and key is changeit. If you don’t want to
use the default password, ensure that you provide the same password for the keystore and the key.
Running this command creates a certificate.keystore in the following location:
• Windows: C:\Documents and Settings\user's_directory
• Linux: usr/home
2 Open the cfroot\cfusion\runtime\conf\server.xml file and search for the string Define a SSL HTTP/1.1.
3 Uncomment the connector details and update the section as follows:
5 To change the doc root, change the docBase value in the above entry.
For more details on the Context attributes, see http://tomcat.apache.org/tomcat-6.0-doc/config/context.html.
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing the Server Configuration
Changing the connector port for cfstat
You can use the connector output for logging cfstat metric. The cfconnector port is defined in the
CFInstallation/cfusion/lib/neo-metric.xml file. If you have configured a connector, update the port with the
connector port. The connector port (AJP port) is provided in the
CFInstallation/cfusion/runtime/conf/server.xml.
To update the connector port using the Administrator console:
1 Login ColdFusion Administrator.
2 Click Debugging & Logging > Debug Output.
3 Update the connector port and click Submit Changes.
Enabling Search Engine Safe URLs
Search Engine Safe URL (SES) helps the search engines to index dynamic web pages. SES URLs pass parameters using
slashes instead of default URL pattern. By default, SES is enabled for stand-alone installation of ColdFusion on
Tomcat.
19
Note: SES is applicable only for stand-alone installation of Tomcat. It does not work if ColdFusion is deployed as a WAR
file on Tomcat.
Note: If you wish to use custom SES URLs, add the URL entry to the uriworkermap.properties file found in the
wsconfig folder for your web server.
Enabling Secure Profile
*New for ColdFusion 10*
ColdFusion allows you to secure ColdFusion server furthermore by enabling or disabling certain settings. When
installing ColdFusion, you can enable Secure Profile by selecting the option when prompted on the Secure Profile
screen. Further, you could provide a comma separate list of IP addresses that may be allowed to access the ColdFusion
Administrator. For more information, see Enabling Secure Profile for ColdFusion Administrator.
Changing the log rotation settings
You can change the log rotation settings such as maximum number of backup files and the size of the backup files.
1 Specify log file settings in the neo-logging.xml, located in the <ColdFusion_Home>\lib directory.
2 The size of coldfusion-out.log and coldfusion-error.log is set to 20MB by deafult. You can change the size of the log
in the neo-logging.xml file by changing the
3 You can also change the maximum number of backups of coldfusion-out.log and coldfusion-error.log that
ColdFusion takes during log rotation within the neo-logging.xml file. Change the
maxFileSize setting.
maxBackSize setting.
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing the Server Configuration
4 You can change the settings of the remaining files in the ColdFusion Administrator by going to the Debugging and
Logging > Logging Settings section. Change the Maximum file size and Maximum number of Archives settings
accordingly.
Enabling persistent session
To persist a session after a Tomcat restart, do the following:
1 Open the cfroot\cfusion\runtime\conf\context.xml file.
2 Uncomment the Manager pathname node.
Note: Flex sessions are not persisted after a Tomcat restart.
Updating from an earlier version
If you have skipped the migration or you have to make modifications to the previous installation that has to be
migrated, do the following:
20
1 Stop the server.
2 Save settings by copying the files cf_webapp_root/WEB-INF/cfusion/lib/neo-*.xml (of previous installation) to a
directory named cfXsettings (in which X is the earlier version of ColdFusion) in the
cf_webapp_new_installation_root_directory/WEB-INF/cfusion/lib directory.
3 Edit the ColdFusion 10 cfusion/lib/adminconfig.xml file by setting the value of the runmigrationwizard and the
migratecfX (in which X is the earlier version of ColdFusion) switch to true.
4 Restart the ColdFusion 10 application.
5 Browse to ColdFusion Administrator to run the migration wizard.
Uninstalling ColdFusion
Uninstalling ColdFusion deletes all program files and related components from your computer.
3 When the program completes, remove any remaining files and directories in the cf_root directory.
4 In some cases, the uninstall program may require you to restart the computer.
ColdFusion is deleted from your server.
Uninstall ColdFusion from UNIX
1 Log in as root.
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing the Server Configuration
2 Enter the following command to go to the cf_root/uninstall directory:
cd cf_root/uninstall
3 Enter the following command:
./uninstall.sh
4 When the program completes, remove any remaining files and directories in the cf_root directory.
ColdFusion is deleted from your server.
21
Last updated 7/9/2012
Chapter 3: Installing the J2EE
Configuration
Gathering information necessary to install the J2EE
configuration
Although the ColdFusion 10 installer provides an intuitive interface, it helps to plan your answers to the questions
asked by the installer. Use the following tables to help plan for installing the J2EE configuration of ColdFusion 10.
Identify a list of IP addresses that will have access to the ColdFusion Administrator.
___No
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing the J2EE Configuration
QuestionAnswer
Whether to enable RDS?___ Yes
___ No
Note: RDS allows the server to interact with remotely connected developers. Adobe
recommends that you disable RDS for production servers.
Disabling RDS also disables the directory browsing applets in the ColdFusion
Administrator.
RDS password?___________________________________
Automatically check for server updates?___ Yes
___ No
ColdFusion and J2EE application servers
One of the main advantages of ColdFusion is that you can install it as an integrated server (the server configuration)
or deploy it as a Java application on a standards-based J2EE application server (J2EE configuration). In addition to
greater flexibility, this allows your ColdFusion applications to leverage features of the J2EE architecture, such as
support for multiple application instances and multiple-instance clustering.
23
You can deploy ColdFusion in the J2EE configuration by using a J2EE application server, such IBM WebSphere. When
you use the J2EE configuration, you can use an existing J2EE application server; the installation wizard creates a web
application archive (WAR) or enterprise application archive (EAR) file, which you then deploy by using the tools
provided by your application server.
Choosing EAR or WAR deployment
In the J2EE environment, you deploy applications in one of the following formats:
Web application archive file Contains the ColdFusion application. A web application archive (also called a WAR) uses
a directory structure that contains a WEB-INF/web.xml deployment descriptor, which defines the servlets and context
parameters it uses. J2EE application servers can deploy web applications in this directory structures as-is or in
compressed WAR files that contain these directory structures. However, ColdFusion must run from an expanded
directory structure:
The cfusion.war file contains the ColdFusion web application. The rds.war file is a web application that redirects RDS
requests from /CFIDE to /context-root/CFIDE. It forwards requests to the ColdFusion Administrator when
ColdFusion uses a context root other than a forward slash (/).
Enterprise application archive file Contains the ColdFusion and RDS redirector web applications. An enterprise
application archive (also called an EAR) uses a directory structure that contains a META-INF/application.xml
deployment descriptor, which defines the web applications that it contains. J2EE application servers can deploy
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing the J2EE Configuration
enterprise applications in these directory structures as-is or in compressed EAR files that contain these directory
structures. However, ColdFusion must run from an expanded directory structure:
If your J2EE application server supports enterprise applications, install and deploy the EAR file. For more information,
“Installing an EAR file or WAR files” on page 25.
see
Context root
Because the J2EE environment supports multiple, isolated web applications running in a server instance, J2EE web
applications running in a server are each rooted at a unique base URL, called a context root (or context path). The J2EE
application server uses this initial portion of the URL (that is, the portion immediately following http://hostname) to
determine which web application services an incoming request.
24
For example, if you are running ColdFusion with a context root of cf10, you display the ColdFusion Administrator
using the URL http://localhost/cf10/CFIDE/administrator/index.cfm.
Most J2EE application servers allow one application in each server instance to use a forward slash (/) for the context
root. Setting the context root to / for the ColdFusion application is especially useful when serving CFM pages from the
web server, because it supports the functionality most similar to earlier ColdFusion versions. In addition, the RDS web
application is not required if you use a context root of /.
When you deploy the ColdFusion EAR file, it uses the context root that you specified when you ran the installation
wizard, which copied your specification to the
context-root element of the META-INF/application.xml file. When
you deploy ColdFusion as a WAR file, you use application-server-specific functionality to define the context root.
Multiple instances
When you use the J2EE configuration, you can define multiple server instances on a single computer, each running
ColdFusion. Running multiple instances of ColdFusion has the following advantages:
Application isolation You deploy an independent application to each server instance. Each server instance has
separate settings, and because each server instance runs in its own instance of the JVM, problems encountered by one
application have no effect on other applications.
Load balancing and failover You deploy the same application to each server instance and add the instances to a
cluster. The web server connector optimizes performance and stability by automatically balancing load and by
switching requests to another server instance when a server instance stops running.
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing the J2EE Configuration
Platforms
Full ColdFusion functionality is available for Windows, Macintosh, Linux, and Solaris, except that the following are
Windows-specific: COM, .NET, and ODBC Services. AIX support is provided for WebSphere application server only.
Functionality provided by platform-specific binary files. is not available on AIX. Additionally, you can install and
deploy the all-Java ColdFusion J2EE configuration on other platforms, although without the functionality provided by
platform-specific binary files (C++ CFXs).
Preparing to install using the J2EE configuration
Instead of JRun, Tomcat is embedded with a stand-alone ColdFusion 10 installation. Previous versions of ColdFusion
installer allow you to create multi-server installations whereas ColdFusion 10 installer lets you only install stand-alone
installation. After installing ColdFusion in stand-alone mode, you can create multiple instances and clusters, provided
you have an Enterprise or Developer license.
Note: This feature is not available in Standard Edition.
Installing an EAR file or WAR files
25
If your computer is already running a J2EE application server, the installation wizard creates an EAR file or WAR files,
which you deploy using application-server-specific tools.
The ColdFusion J2EE configuration must run from an expanded directory structure. Different J2EE application
servers have different functionality with regard to deployment and an expanded directory structure, as follows:
Deploy compressed archive to working directory. On some J2EE application servers (such as IBM WebSphere), the
deployment process expands the EAR/WAR file into a working directory and, from that point forward, the expanded
directory is considered to be the application. For these application servers, you deploy the compressed EAR/WAR file
and work in the resulting directory structure. For more information, see
configuration” on page 29.
Deploy expanded archive as working directory On other application servers (such as Oracle WebLogic), the
deployment process expands the EAR/WAR file into a temporary directory and (conceptually), the compressed
EAR/WAR file is still considered to be the application. For these application servers, expand the EAR/WAR file
manually, and then deploy the expanded directory structure, which becomes your working directory. For more
information, see
“ColdFusion J2EE deployment and configuration” on page 29.
“ColdFusion J2EE deployment and
Installing an EAR file or WAR files in Windows
You can install the ColdFusion J2EE configuration in Windows.
Note: The Windows installer requires a computer that supports at least 256 colors.
Install ColdFusion in Windows (J2EE configuration)
1 Read the online version of the Release Notes for any late-breaking information or updates. For more information,
www.adobe.com/go/learn_cfu_releasenote_en.
see
2 Ensure that your operating system meets the system requirements described on the Adobe website at
www.adobe.com/go/learn_cfu_cfsysreqs_en.
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing the J2EE Configuration
3 Review the “Installation considerations for Windows” on page 2 and “Installation considerations for all platforms”
on page 2.
4 Determine and record environment information, as described in “Preparing to install using the J2EE
configuration” on page 25.
5 Determine the answers to the questions in the section “Gathering information necessary to install the J2EE
configuration” on page 22
6 Close any applications that are currently running on your computer.
7 Insert the DVD or download the setup file from the Adobe website.
8 If the installation wizard does not start automatically when you insert the DVD, locate the appropriate installer on
the DVD and double-click it. If you are installing from a network or a downloaded file, locate the ColdFusion
installation executable file (ColdFusion_10_WWEJ_win32.exe (for 32-bit
systems)/ColdFusion_10_WWEJ_win64.exe (for 64-bit systems)) and double-click it.
9 Follow the instructions in the installation wizard, and let it run to completion.
10 Deploy ColdFusion and configure Java settings, as required by your application server. For more information, see
“ColdFusion J2EE deployment and configuration” on page 29.
11 Open the ColdFusion Administrator to run the Configuration wizard.
12 To install any other integrated Adobe or third-party technologies, see “Installing Integrated Technologies” on
page 46.
13 Configure and manage your system, as described in “Configuring Your System” on page 52.
14 To learn about ColdFusion, read the documentation, which is accessible through the Documentation link on the
Resources page of the ColdFusion Administrator.
15 Code ColdFusion CFM pages.
Store CFM pages under the web application root (either cfusion-ear\cfusion-war or cfusion-war) and access these
pages using a URL of the form http://hostname:portnumber/context-root/filename.cfm, as follows:
26
• hostname: The machine name, IP address, or localhost.
• portnumber: The port number used by your application server’s web server.
• contextroot: The context root for the ColdFusion web application. For more information, see “Context root” on
page 24.
• filename: The directory path and file to display. The path is relative to the cfusion-war directory.
Installing an EAR file or WAR files in UNIX
You can install the ColdFusion J2EE configuration in UNIX. If you are updating an existing deployment of ColdFusion
for J2EE, see
Install ColdFusion in UNIX (J2EE configuration)
1 Read the online version of the Release Notes for any late-breaking information or updates. For more information,
see
2 Ensure that your operating system meets the system requirements described on the Adobe website at
www.adobe.com/go/learn_cfu_cfsysreqs_en.
3 Review the “Installation considerations for UNIX” on page 3 and “Installation considerations for all platforms” on
page 2.
“Updating from an earlier version for J2EE” on page 29 before you continue.
www.adobe.com/go/learn_cfu_releasenote_en.
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing the J2EE Configuration
4 Determine and record environment information, as described in “Preparing to install using the J2EE
configuration” on page 25.
5 Determine the answers to the questions in the section “Gathering information necessary to install the J2EE
configuration” on page 22.
6 Log in as root.
7 Copy the installation file that is appropriate for your platform and locale from the DVD or Adobe website, and save
it to a directory on your local disk.
The following installation files are those for supported J2EE configuration platforms:
UNIX (other than Solaris or Linux)ColdFusion_10_WWEJ_java.jar
8 Using the cd command, go to the directory with the installation file.
9 Start the installation with the following command:
./<filename> -i console
The installation program starts.
To use the ColdFusion_10_WWEJ_java.jar file to install on a UNIX platform other than Solaris or Linux, enter the
following command (for more information, see
“Installation considerations for UNIX” on page 3):
Note: To run the Linux installer in GUI mode, type ./<filename> -i gui.
10 Follow the prompts, and let the installation program run to completion.
Note: For security reasons, it is crucial that you do not use root for the run-time user. Instead, use a nonprivileged user
that does not have a login shell, such as the default user account nobody, which exists for this type of situation.
11 Deploy ColdFusion and configure Java settings, as required by your application server.
For more information, see “ColdFusion J2EE deployment and configuration” on page 29.
Note: If you deployed the rds.war file, and an error message indicates that RDS is not installed or not enabled, edit the
rds.properties file to match the ColdFusion context root, restart the application server, and re-open the ColdFusion
Administrator.
12 Open the ColdFusion Administrator to run the Configuration wizard.
13 Configure and manage your system, as described in “Configuring Your System” on page 52.
14 To learn about ColdFusion, read the documentation, which is accessible through the Documentation link on the
Resources page of the ColdFusion Administrator.
15 Code and test ColdFusion CFM pages.
Store CFM pages under the web application root (either cfusion-ear/cfusion-war or cfusion-war) and access these
pages using a URL of the form http://hostname:portnumber/context-root/filename.cfm, as follows:
• hostname: The machine name, IP address, or localhost.
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing the J2EE Configuration
• portnumber: The port number used by your application server’s web server.
• contextroot: The context root for the ColdFusion web application. For more information, see “Context root” on
page 24.
• filename: The directory path and file to display. The path is relative to the cfusion-war directory.
Installing an EAR file or WAR files in Mac OS X
You can install the ColdFusion J2EE configuration for Mac OS X. If you are updating an existing deployment of
ColdFusion 8 for J2EE, see
Install ColdFusion in Mac OS X (J2EE configuration)
1 Read the online version of the Release Notes for any late-breaking information or updates.
For more information, see www.adobe.com/go/learn_cfu_releasenote_en.
2 Ensure that your operating system meets the system requirements described on the Adobe website at
www.adobe.com/go/learn_cfu_cfsysreqs_en.
3 Review the “Installation considerations for UNIX” on page 3 and “Installation considerations for all platforms” on
page 2.
4 Determine and record environment information, as described in “Preparing to install using the J2EE
configuration” on page 25.
5 Determine the answers to the questions in the section “Gathering information necessary to install the J2EE
configuration” on page 22.
6 Log in as root.
7 Copy the installation file that is appropriate for your platform and locale from the DVD or Adobe website, and save
it to a directory on your local disk.
The following installation files are those for supported J2EE configuration platforms:
“Updating from an earlier version for J2EE” on page 29 before you continue.
28
• ColdFusion_10_WWEJ_osx10.dmg - To install in Mac OS X systems
8 Start the installation by double-clicking the installation file on the desktop. The file ColdFusion 10 Installer.app is
installed in the same directory. Double click this APP file to start the installation in GUI mode.
9 Follow the prompts, and let the installation program run to completion.
Note: For security reasons, it is crucial that you do not use root for the runtime user. Instead, use a nonprivileged user
that does not have a login shell, such as the default user account nobody, which exists for this type of situation.
10 Deploy ColdFusion and configure Java settings, as required by your application server. For more information, see
“ColdFusion J2EE deployment and configuration” on page 29.
Note: If you deployed the rds.war file, and an error message indicates that RDS is not installed or not enabled, edit the
rds.properties file to match the ColdFusion context root, restart the application server, and reopen the ColdFusion
Administrator.
11 Open the ColdFusion Administrator to run the Configuration wizard.
12 Configure and manage your system, as described in “Configuring Your System” on page 52.
13 To learn about ColdFusion, read the documentation, which is accessible through the Documentation link on the
Resources page of the ColdFusion Administrator.
14 Code and test ColdFusion CFM pages.
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing the J2EE Configuration
Store CFM pages under the web application root (either cfusion-ear/cfusion-war or cfusion-war) and access these
pages using a URL of the form http://hostname:portnumber/context-root/filename.cfm, as follows:
• hostname The machine name, IP address, or localhost.
• portnumber The port number used by your application server’s web server.
• contextroot The context root for the ColdFusion web application. For more information, see “Context root”
on page 24.
• filename The directory path and file to display. The path is relative to the cfusion-war directory.
Updating from an earlier version for J2EE
If you previously deployed the ColdFusion J2EE configuration on your application server, you must also perform the
following steps as part of the installation procedure:
1 As appropriate for your application server, either stop the ColdFusion application and RDS application (if it is
running), or stop the application server before you start the installation wizard.
2 (Windows only) If you installed the SequelLink ODBC Agent, stop the ODBC services before you start the
installation wizard.
3 Copy application files to a backup directory.
4 Save settings by copying the files cf_webapp_root/WEB-INF/cfusion/lib/neo-*.xml to a backup directory.
5 Before you deploy ColdFusion 10, undeploy the previous ColdFusion application using your application-server-
specific undeploy functionality.
6 Deploy ColdFusion 10 as described in “Deploying ColdFusion 10 on IBM WebSphere” on page 31, “Deploying
ColdFusion 10 on Oracle WebLogic” on page 37, or “Deploying ColdFusion 10 on JBoss Application Server” on
page 40.
7 Create a directory named cfXsettings (in which X is the earlier version of ColdFusion) in the cf_webapp_root/WEB-
INF/cfusion/lib directory.
8 Copy the backed up settings files to the ColdFusion 10 cfusion/lib/cfXsettings directory.
9 Edit the ColdFusion 10 cfusion/lib/adminconfig.xml file by setting the value of the runmigrationwizard and the
migratecfX (in which X is the earlier version of ColdFusion) switch to true.
10 Restart the ColdFusion 10 application.
11 Browse to ColdFusion Administrator to run the migration wizard.
Note: The migration wizard supports only the migration of settings from ColdFusion 9.
29
ColdFusion J2EE deployment and configuration
The J2EE specification allows application servers to handle compressed and expanded deployments in a serverdependent manner; each application server has its own deployment and configuration mechanism, as the following
table shows:
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing the J2EE Configuration
Application serverDeployment mechanismExpanded or compressed deployment
Apache TomcatTomcat Deployment ManagerExpanded
IBM WebSphereIBM WebSphere Administrative ConsoleCompressed
30
Oracle WebLogicWeblogic Administration Console/Auto deploy to
server domains
JBOSS Application ServerAuto deploy to server rootExpanded
Oracle Weblogic ServerOracle Weblogic Server Administration ConsoleExpanded
Expanded
For basic deployment information, see your J2EE application server documentation. ColdFusion deployment
instructions differ for each J2EE application server. For more information, see deployment instructions for the specific
application server.
J2EE directory structure
The following table describes the directories under the cf_webapp_root web application directory when you use the
J2EE configuration:
DirectoryDescription
cfdocsDocumentation for ColdFusion.
CFIDEFiles for the ColdFusion Administrator.
WEB-INF/cfclassesCompiled ColdFusion templates in your ColdFusion applications.
WEB-INF/cfc-skeletonsSupport for ColdFusion components that are exported as web services.
WEB-INF/cfformFiles that support Flash forms.
WEB-INF/cftagsTemplates for ColdFusion.
WEB-ING/flexConfiguration and files for LiveCycle Data Services ES.
WEB-INF/gatewayFiles that support event gateways.
WEB-INF/cfusion/binExecutable files used by ColdFusion.
WEB-INF/cfusion/cfxCFX tag include file and examples.
WEB-INF/cfusion/chartingFiles for the ColdFusion graphing and charting engine.
WEB-INF/cfusion/Custom TagsRepository for your custom tags.
WEB-INF/cfusion/dbSample databases for all platforms. These databases are Apache Derby databases.
WEB-INF/cfusion/jintegraJIntegra programs, libraries, and other supporting files (for example, to integrate Java and
WEB-INF/cfusion/lib
WEB-INF/lib and
WEB-INF/cfusion/MonitoringServer
WEB-INF/cfusion/logsColdFusion log files.
WEB-INF/cfusion/MailFiles, including spool files, used by ColdFusion for mail.
COM code; manage access to ActiveX controls (OCXs) that are hosted in a graphical user
interface (GUI) container; and register the JVM and type libraries).
JAR, XML, property, and other files that are the foundation of ColdFusion, including
functionality such as queries, charting, mail, security, Solr searches, and system probes.
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing the J2EE Configuration
DirectoryDescription
WEB-INF/cfusion/registryUsed only in UNIX, by the cfregistry tag.
WEB-INF/cfusion/stubsCompiled code for web services.
WEB-INF/cfusion/solrSolr configuration and Jetty.
Deploying ColdFusion 10 on IBM WebSphere
The following instructions tell you how to deploy ColdFusion 10 on IBM WebSphere Application Server (AS) and
Network Deployment (ND).
The following terms refer to WebSphere and ColdFusion directories:
websphere_root The directory in which IBM WebSphere Application Server is installed; for example, C:\Program
Files\WebSphere in Windows, and /opt/WebSphere in UNIX.
cf_webapp_root The directory to which the ColdFusion web application is deployed; for example, C:\Program
Files\WebSphere\AppServer\installedApps\<My_Host>\cfusion.ear\cfusion.war in Windows, and
/opt/WebSphere/AppServer/installedApps/<My_Host>/cfusion.ear/cfusion.war in UNIX.
java_home The root directory of your Java 2 software development kit (J2SDK); for example, C:\j2sdk1.6.0_29.
31
Deploy ColdFusion 10 on WebSphere 7 or 8 (AS)
1 Start the IBM WebSphere Application Server, if it is not running.
2 Open the IBM WebSphere Administrative Console, if it is not running.
3 Select Applications > Install New Application.
4 When the Preparing for the Application Installation page appears, in the text box for the local file system, enter the
path to the EAR file that you installed when you installed ColdFusion; for example, C:\ColdFusion10\cfusion.ear.
If you are running the Administrative console from a browser that is not on the same system on which WebSphere
is running, that is, not from localhost, use the Remote file system option, which enables directory browsing on the
server file system.
5 Leave the Context Root box empty and click Next.
6 Accept the default values on the second Select Installation Options page, if appropriate for your WebSphere
configuration, and then click Next.
WebSphere might display an Application Security Warnings page with a message at the bottom of the page that
starts with "ADMA0080W: A template policy file without any permission set is included in the 1.2.x enterprise
application." You can ignore this warning.
7 If you have multiple application servers, select the application server in which to install the ColdFusion application
and RDS support, and then click Next.
8 When the Map Virtual Hosts for Web Modules panel appears, select the virtual host or hosts in which to install the
ColdFusion 10 application and Remote Development Services (RDS) support, and then click Next.
RDS must be on the same virtual host and port as ColdFusion 10.
9 When the Summary panel appears, review the installation configuration, and then click Finish.
10 When the Application Adobe ColdFusion 10 Installed Successfully message appears on the Installing page, select
Save To Master Configuration, and then select Save on the Save page to save your workspace.
If you changed the application name from the default, the message uses your application name.
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing the J2EE Configuration
11 Start the enterprise application named Adobe ColdFusion 10.
12 Browse to the ColdFusion Administrator to run the Configuration Wizard.
Note: Copy the version of tools.jar that the application server uses to the cfusion/lib directory.
Deploy ColdFusion 10 on WebSphere 7 or 8 (ND)
1 Start the IBM WebSphere Application Server, if it is not running.
2 Open the IBM WebSphere Administrative Console, if it is not running.
3 Select Applications > Install New Application.
4 When the Preparing for the Application Installation page appears, in the text box for the local file system, enter the
path to the EAR file that you installed when you installed ColdFusion; for example, C:\ColdFusion10\cfusion.ear.
If you are running the Administrative console from a browser that is not on the same system on which WebSphere
is running, that is, not from localhost, use the Remote file system option, which enables directory browsing on the
server file system.
5 Leave the Context Root box empty and click Next.
6 Accept the default values on the second Select Installation Options page, if appropriate for your WebSphere
configuration, and then click Next.
WebSphere might display an Application Security Warnings page with a message at the bottom of the page that
starts with "ADMA0080W: A template policy file without any permission set is included in the 1.2.x enterprise
application." You can ignore this warning.
32
7 Select the cluster on which to install the ColdFusion application and RDS support, and then click Next.
8 When the Map Virtual Hosts for Web Modules panel appears, select the virtual host or hosts in which to install the
ColdFusion 10 application and Remote Development Services (RDS) support, and then click Next.
RDS must be on the same virtual host and port as ColdFusion 10.
9 When the Summary panel appears, review the installation configuration, and then click Finish.
10 When the Application Adobe ColdFusion 10 Installed Successfully message appears on the Installing page, select
Save To Master Configuration, and then select Save on the Save page to save your workspace.
If you changed the application name from the default, the message uses your application name.
11 Start the enterprise application named Adobe ColdFusion 10.
12 Browse to the ColdFusion Administrator to run the Configuration Wizard.
Note: You must copy the version of tools.jar that the application server uses to the cfusion/lib directory.
On WebSphere ND, deploying multiple application server clones on a single computer is commonly referred to as
vertical clustering. Vertical clustering leverages the computer's processing power to obtain a higher level of efficiency;
however, if there is total computer failure, no application server instances are available. The applications deployed in
a vertical cluster share the same file system. Deploying the multiple application servers on multiple computers is
commonly referred as horizontal clustering; it provides the highest level of failover and scaling. The steps you perform
to deploy ColdFusion 10 in a clustered environment are the same, regardless of clustering method, because the
WebSphere Network Deployment Manager manages the cluster.
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing the J2EE Configuration
Enable sandbox security
1 Do the following to ensure that ColdFusion sandbox security secures Java access to files and network resources:
a On the WebSphere Administrative Console Security > Secure Administration panel, ensure that the Java 2
Security option is selected.
b Click Apply and then click Save.
2 Add the following lines to the Standard PropertiesThat Can Be Read By Anyone section of the JVM's security
policy file, java.policy. (For example, this file can be located in C:\Program
Files\WebSphere\AppServer\java\jre\lib\security\java.policy):
grant {
permission java.security.AllPermission;
};
Configure operating system-specific binary support in Windows
This process 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
You do this by configuring the search paths to find the required binary files, which are located in the
cf_webapp_root\WEB-INF\cfusion\lib directory.
33
Configure search paths
1 Make a backup copy of the setupCmdLine.bat file, located in the websphere_root\AppServer\bin directory.
2 Open the original file for editing and add the following on a single line before the line that starts with SET
WAS_CLASSPATH:
SET CF_APPS_PATH=cf_webapp_root\WEB-INF\cfusion\lib
Replace cf_webapp_root with the path to your web application directory; for example, enter the following:
SET CF_APPS_PATH=%WAS_HOME%\installedApps\%WAS_CELL%\
Adobe_ColdFusion_10.ear\cfusion.war\WEBINF\cfusion\lib;%WAS_HOME%\installedApps\%WAS_CELL%\
Adobe_ColdFusion_10.ear\cfusion.war\WEB-INF\flex\jars
3 Add the CF_APPS_PATH variable to the WAS_CLASSPATH by appending the following text to the path
statement:
;%CF_APPS_PATH%
The WAS_CLASSPATH line should look similar to the following:
SET
WAS_CLASSPATH=%WAS_HOME%/properties;%WAS_HOME%/lib/bootstrap.jar;%WAS_HOME%/lib/j2ee.jar;%
WAS_HOME%/lib/lmproxy.jar;%WAS_HOME%/lib/urlprotocols.jar;%CF_APPS_PATH%
4 Save the file.
5 Add the full path to the cf_webapp_root\WEB-INF\cfusion\lib directory to the WAS_PATH variable in the
setupCmdLine.bat file. The WAS_PATH line should look similar to the following:
SET WAS_PATH=%WAS_HOME%\bin;%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin;%PATH%;C:\Program
Files\IBM\WebSphere MQ\bin;C:\Program Files\IBM\WebSphere MQ\java\bin;C:/Program
Files/IBM/WebSphere MQ/WEMPS\bin;%CF_APPS_PATH%;
6 Save the file.
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing the J2EE Configuration
Enable COM support for Windows
You enable Component Object Model (COM) support in Windows after installing ColdFusion 10 so that you can use
cfreport tag with Crystal Reports. COM support is not required for the ColdFusion Report Builder or any reports
the
that you create with the ColdFusion reporting feature.
1 Make a backup copy of the setupCmdLine.bat file, which is located in the websphere_root\AppServer\bin directory.
2 Open the original file and add the following on a single line:
SET PATH=%PATH%;cf_webapp_root\WEB-INF\cfusion\jintegra\bin;cf_webapp_root\WEBINF\cfusion\jintegra\bin\international
Replace cf_webapp_root with the path to your web application root directory, for example:
SET
PATH=%PATH%;%WAS_HOME%\installedApps\%WAS_CELL%\AdobeColdFusion10.ear\cfusion.ear\cfusion.
war\WEBINF\cfusion\jintegra\bin;%WAS_HOME%\installedApps\%WAS_CELL%\Adobe_ColdFusion_10.ear\cfusi
on.war\WEB-INF\cfusion\jintegra\bin\international
3 Save the file.
In some cases, you might also have to do the following to register the Microsoft Type viewer:
4 Open a console window and go to the cf_webapp_root\WEB-INF\cfusion\lib directory.
5 Register TypeViewer.dll by issuing the following command:
regsvr32 TypeViewer.dll
34
Configure operating system-specific binary support for Solaris and Linux
This process is required to support CFX tags written in C++ that use binaries that are specific to your operating system.
You must configure the search paths to find the required binary files, which are located in the cf_webapp_root/WEBINF/cfusion/lib directory.
Configure search path
1 Make a backup copy of the startServer.sh file, which is located in the websphere_root/AppServer/bin directory.
The path specifications in these instructions assume that you deployed ColdFusion using the standard application
name (Adobe ColdFusion 10) and did not rename the application.
2 Open the original file, and in the PLATFORM case block, just above the LD_LIBRARY_PATH or LIBPATH line,
4 Save the file and restart your WebSphere Application Server.
Enable ColdFusion charting and graphing support for UNIX
1 Open the WebSphere Administrative Console.
2 In the left navigation bar, select Node_name > Servers > Application Servers.
3 Select your J2EE application server; for example, Server1.
4 Under Java and Process Management, select Process Definition.
5 On the Process Definition page, select Java Virtual Machine in the Additional Properties box.
6 If you are running ColdFusion 10 on a system without a monitor, do the following:
a In the Additional Properties box at the bottom of the page, select Custom Properties.
b On the Custom Properties page, select New and add a system property, completing the fields as follows:
Name java.awt.headless
Value true
35
7 Click OK.
8 Save the master configuration file.
Disable RDS
For security reasons, Adobe recommends that you disable RDS on a production server. If you enable RDS when you
install ColdFusion 10, you can disable it at a later time, as the following instructions describe.
If you disable RDS, the following ColdFusion 10 features do not work:
• The Browse Server button in the ColdFusion Administrator (for example, on the ColdFusion Mappings page)
• The Query Builder and charting in the ColdFusion Report Builder
To disable RDS on UNIX,
1 Stop ColdFusion.
2 In the WebSphere Administrative Console, select the Applications > Enterprise Applications panel, select the
Adobe ColdFusion 10 application, and then click Stop.
3 Do the following in both the cf_webapp_root\WEB-INF\web.xml and the
b If your ColdFusion 10 application context root is something other than /, disable or undeploy the RDS
redirector web module by doing the following:
6 In the WebSphere Administrative Console, select cell_name > Applications > Enterprise Applications.
7 Stop the Adobe ColdFusion 10 application if it is running.
8 Select Adobe ColdFusion 10 Application, select Manage Modules and then select the check box for ColdFusion
RDS application, and then click Remove.
36
Apply application server configuration
To apply application server configuration, restart the application server.
Configure ColdFusion 10
Ensure that the following settings and practices are in place before using WebSphere Application Server ND:
Event Gateway Ensure that the startup mode of the Socket gateway instances is set to manual. In particular, do not set
it to Automatic when using a vertical cluster. Select one of the instances in the vertical cluster and start the Socket
gateway on that instance manually.
Session Replication Either avoid ColdFusion-specific data types or serialize them to WDDX and store them in session
scope as strings.
ColdFusion Administrator:
• In a vertical cluster environment, avoid concurrent changes to the same service.
• In a horizontal cluster environment, each server has its own ColdFusion Administrator. You must make changes
once per server.
• In a vertical cluster environment, the ColdFusion Administrator scheduled tasks are scheduled on all servers.
Solr Server Only one Solr Search Server can run on each server computer.
Compilation Use precompiled classes and ensure that the Trusted Cache setting is enabled.
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing the J2EE Configuration
Deploying ColdFusion 10 on Oracle WebLogic
The following instructions tell you how to deploy ColdFusion 10 on Oracle WebLogic 11g. You can deploy ColdFusion
10 on WebLogic using either an expanded EAR file or WAR files.
The following terms refer to ColdFusion directories:
cfusion_install_directory The directory that contains the files extracted by the ColdFusion install, for example, C:\cf10
or /opt/cf10.
wl_root The directory that contains WebLogic, for example, C:\Oracle.
wldomain_root The directory that contains the WebLogic domain into which you deployed ColdFusion.
cf_webapp_root The directory into which you deployed the ColdFusion web application, for example,
java_home The root directory of your Java 2 software development kit (J2SDK); for example, C:\jdk1.6.0.
Install ColdFusion 10 on WebLogic
1 Run the ColdFusion installation wizard, choosing the J2EE configuration.
The installation wizard places the WAR files in the install directory.
2 Determine the WebLogic domain in which to deploy ColdFusion 10. Optionally, create a domain.
3 Because ColdFusion 10 must run from an expanded directory structure, expand the cfusion.war and rds.war files
manually, and expand the web applications by doing the following:
a Open a console window, navigate to the directory that contains the WAR files, and create a directory for the
ColdFusion WAR file (named whatever you want the context root to be) and the RDS WAR file (named CFIDE):
cd cf_install_directory
md cfusion (Windows, mkdir cfusion on UNIX)
md CFIDE (Windows, mkdir CFIDE on UNIX)
37
b Change to the cfusion directory and expand the cfusion.war file with the jar command:
cd cfusion
java_home/bin/jar -xvf ../cfusion.war
c Go up one level to the install directory:
cd ..
d Go to the CFIDE directory and expand the rds.war file with the jar command:
cd CFIDE
java_home/bin/jar -xvf ../rds.war
4 Open the weblogic.policy file. On WebLogic 11g, the file is located in the
WebLogic_HOME/wlserver_10.0/server/lib/ directory. In a text editor, comment out the restrictive permissions,
and add permission java.security.AllPermission; to the default permissions section, as the following example
shows:
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing the J2EE Configuration
...
// default permissions granted to all domains
grant {
permission java.security.AllPermission;
/*
7 Review the console messages and server log to ensure that ColdFusion 10 deployed successfully.
8 Start the ColdFusion Administrator, which runs the Configuration wizard.
9 To install any other integrated Adobe or third-party technologies, see “Installing Integrated Technologies” on
page 46.
10 Configure and manage your system, as described in “Configuring Your System” on page 52.
11 To learn about ColdFusion, read the documentation, which is accessible through the Documentation link on the
Resources page of the ColdFusion Administrator.
Note: You must copy the version of tools.jar that the application server uses to the cfusion/lib directory.
38
Configure operating system-specific binary support in Windows
1 Locate the startup script for the WebLogic domain, which is typically the startWebLogic cmd file, which is located
in the wldomain_root\bin directory.
2 Make a backup copy of this file.
3 Open the startup script.
4 Establish the following basic variables at the beginning of the script:
• CF_WEB_INF
• CF_SHARED_LIB
For example:
SET CF_WEB_INF=cf_webapp_root\WEB-INF
SET CF_SHARED_LIB=%CF_WEB_INF%\cfusion\lib
5 Save the startup script and restart the WebLogic Server.
Enable COM support for Windows
1 Open the startup script for the WebLogic domain, which is typically the startWebLogic cmd file, which is located
in the wldomain_root\bin directory.
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing the J2EE Configuration
2 Establish the following variables:
• JINTEGRA_PATH
• PRE_CLASSPATH
• PRE_PATH
For example:
SET JINTEGRA_PATH= %CF_WEB_INF%\cfusion\jintegra\bin;
%CF_WEB_INF%\cfusion\jintegra\bin\international
SET PRE_CLASSPATH=%CF_SHARED_LIB%\jintegra.jar
SET PRE_PATH=%CF_SHARED_LIB%;%JINTEGRA_PATH%
Configure operating system-specific binary support in UNIX
1 Locate the startup script for the WebLogic domain, which is typically the startWebLogic.sh file, which is located in
the wldomain_root\bin directory.
2 Make a backup copy of this file.
3 Open the startup script.
4 Establish the following basic variables at the beginning of the script:
5 Save the startup script and restart the WebLogic Server.
Enable ColdFusion security in Windows
1 Open the startup script for the WebLogic domain, which is typically the startWebLogic cmd file, which is located
in the wldomain_root\bin directory.
2 Establish or append to the following variable:
• CF_SECURITY_JVM_OPTIONS
• MEM_ARGS
If you are not using JRockit, append -Xms32m -Xmx512m -Xss64k -XX:MaxPermSize=128m to the existing
MEM_ARGS line of the startup script.
If you are using JRockit, append -Xms32m -Xmx512m -Xss64k to the existing MEM_ARGS line of the startup
script.
• JAVA_OPTIONS
Append the CF_SECURITY_JVM_OPTIONS variable to the existing JAVA_OPTIONS line of the startup
script)
For example:
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing the J2EE Configuration
@rem Security options are only required if enabling sandbox security
SET CF_SECURITY_JVM_OPTIONS="-Djava.security.manager"
@rem You must append %CF_SECURITY_JVM_OPTIONS% to the existing JAVA_OPTIONS value.
set JAVA_OPTIONS=Dweblogic.security.SSL.trustedCAKeyStore=C:\WebLogic_HOME\server\lib\cacerts
%CF_SECURITY_JVM_OPTIONS% %CF_COM_JVM_OPTIONS%
@rem You must append the following to the existing MEM_ARGS value.
@rem -Xms32m -Xmx512m -Xss64k -XX:MaxPermSize=128m
3 Save the startup script and restart the WebLogic Server.
Enable ColdFusion security and graphing support in UNIX
1 Open the startup script for the WebLogic domain, which is typically the startWebLogic.sh file, which is located in
the wldomain_root\bin directory.
2 Establish or append to the following variables:
• CF_SECURITY_JVM_OPTIONS
• CF_GRAPHING_JVM_OPTIONS
• MEM_ARGS
If you are not using JRockit, append -Xms32m -Xmx512m -Xss64k -XX:MaxPermSize=128m to the existing
MEM_ARGS line of the startup script.
40
If you are using JRockit, append -Xms32m -Xmx512m -Xss64k to the existing MEM_ARGS line of the startup
script.
• JAVA_OPTIONS
Append the CF_SECURITY_JVM_OPTIONS variable to the existing JAVA_OPTIONS line of the startup
script)
For example:
# Security options are only required if enabling sandbox security
CF_SECURITY_JVM_OPTIONS="-Djava.security.manager"
CF_GRAPHING_JVM_OPTIONS="-Djava.awt.headless=true"
# You must append ${CF_SECURITY_JVM_OPTIONS} and ${CF_GRAPHING_JVM_OPTIONS}
# to the existing JAVA_OPTIONS value.
# JAVA_OPTIONS="default java options ${CF_SECURITY_JVM_OPTIONS}
${CF_GRAPHING_JVM_OPTIONS}"
# You must append the following to the MEM_ARGS variable coded
# in the server startup file:
# "-Xmx512m -XX:MaxPermSize=128m"
3 Save the startup script and restart the WebLogic Server.
Deploying ColdFusion 10 on JBoss Application Server
ColdFusion 10 supports JBoss with the following specifications:
• JBoss 5.1,6.x,7.0, 7.1
• JRE 1.5 or 1.6
ColdFusion 10 has not been tested using JBoss under the following conditions:
1 JBoss using a servlet container other than Tomcat
2 Deploying ColdFusion to a JBoss cluster
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing the J2EE Configuration
Note: If you are already using an application with context root of /, use a context root other than / for the cfusion-ear file.
If you specified / when you installed ColdFusion, you can change it by opening the cfusion-ear/METAINF/application.xml file in a text editor and modifying the context-root element. After you deploy the cfusion-ear file,
you access ColdFusion pages by specifying
c Ensure that the jars available in WEB-INF/flex/jars are in the classpath.
d Save the run.bat file.
e Start the server by running the JBOSS_HOME\bin\run.bat file.
Note: If you use Apache Derby database, add the following in run.bat: JAVA_OPTS=%JAVA_OPTS% -
Djboss.platform.mbeanserver. This is to ensure that Apache Derby do not start a JMX management server that
might conflict with JBoss.
10 (Linux) Edit the JBOSS_HOME/bin/run.conf file by doing the following:
a In JAVA_OPTS, change -Xmx128m. to -Xmx512m.
b Add -XX:MaxPermSize=128m to JAVA_OPTS.
c Save the run.conf file.
d Start the server by running the JBOSS_HOME/bin/run.sh file.
To enable features with operating system-specific binaries, configure ColdFusion. 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)
Use the following 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.
Note: If you use Apache Derby database, add the following in run.bat: JAVA_OPTS="$JAVA_OPTS -
Djboss.platform.mbeanserver". This is to ensure that Apache Derby do not start a JMX management server
that might conflict with JBoss.
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing the J2EE Configuration
Note: (JBoss 7.x only) If cfusion.ear is not deployed before JBoss times out for deployment, you can change the
deployment timeout of JBoss in JBOSS_HOME\standalone\configuration\standalone.xml file.
Note: (JBoss 7.x only) After CF is deployed in JBoss 7.x, web services will not function. To resolve this, add <path
name="javax/annotation/processing"/> in JBOSS_HOME\modules\sun\jdk\main\module.xml file. For
more information, see
https://community.jboss.org/message/627008
Note: If you are running ColdFusion on MAC, documents and PDF functionality may fail with ClassNotFound for
com.aqua.LookAndFeel error. To resolve this, add the following entry to
JBOSS_HOME\modules\sun\jdk\main{color}module.xml file:<path name="com/apple/laf"/>
Note: In JBOSS 7.x, if OpenOffice is not functioning, start JBoss with the following flag: Djava.ext.dirs=JBOSS_DEPLOY_DIR/cfusion.ear/cfusion.war/WEB-INF/cfusion/lib/oosdk/;<java-home>/lib/ext/
(use ':' for Unix based machines and ';' for ColdFusion running on Windows) Also add the following to the
JBOSS_HOME\modules\sun\jdk\main\module.xml.
Configure operating system-specific binary support for Windows
1 Ensure that JBoss Server is stopped.
2 Edit JBOSS_HOME\bin\run.bat by adding the following:
set CF_LIB_PATH=JBOSS_DEPLOY_DIR\cfusion.ear\cfusion.war\WEB-INF\cfusion\lib
set PATH=%PATH%;%CF_LIB_PATH%
43
3 Edit the run.bat file that is located in the JBOSS_DEPLOY_DIR by doing the following:
a Locate the following text:
@echo off
rem -----------------------------------------------
rem JBoss Bootstrap Script for Win32
rem -----------------------------------------------
4 Below this text, insert three lines and paste.
set CF_LIB_PATH=JBOSS_DEPLOY_DIR\cfusion.ear\cfusion.war\WEB-INF\cfusion\lib
set PATH=%PATH%;%CF_LIB_PATH%
5 Save the file and start the server.
Note: You must copy the version of tools.jar that the application server uses to the cfusion/lib directory.
Configure operating system-specific binary support for Linux
1 Ensure that JBoss Server is stopped.
2 Edit JBOSS_HOME/bin/run.sh by adding the following:
2 Edit JBOSS_HOME\bin\run.bat by adding the following:
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing the J2EE Configuration
set CF_LIB_PATH=%CF_LIB_PATH%;CF_WEBAPP_ROOT\WEBINF\cfusion\jintegra\bin;CF_WEBAPP_ROOT\WEB-INF\cfusion\jintegra\bin\international
3 Save the file and start the server.
Enable communication with Flex
When ColdFusion is configured to use RMI for LiveCycle Data Services ES, ColdFusion listens on port 1099 by default.
However JBoss typically starts listening on this port before ColdFusion does; as a result, an exception is thrown. To
configure ColdFusion to use a different RMI port, on the Java and JVM page of the ColdFusion Administrator, specify
the following in the JVM arguments text area:
-Dcoldfusion.rmiport=nnnn
Replace nnn with the value of an unused port. If you try to connect from a LiveCycle Data Services ES server that is
running in another JVM server to ColdFusion over RMI, the Flex server must start with the same JVM argument.
Disable RDS
1 Stop ColdFusion.
2 Edit JBOSS_DEPLOY_DIR\cfusion.ear\cfusion.war\WEB-INF\web.xml by commenting out the following:
If you notice security-based errors when JBOSS is starting (errors that mention Java and security), edit the run.bat file
as follows:
1 Go to the line that contains the -Xmx512m parameter.
2 Change the text: -Dprogram.name=%PROGNAME% to be -Dcoldfusion.disablejsafe=true %JAVA_OPTS%.
These security errors occur because some versions of JBOSS cannot handle additional encryption software that
ColdFusion uses for higher security standards. Some features, such as EJB3, require JDK 1.5.
Undeploying ColdFusion
To undeploy ColdFusion in the J2EE configuration, you use application-server specific undeploy tools and methods.
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing the J2EE Configuration
Undeploy ColdFusion in the J2EE configuration
1 Remove all ColdFusion specifications from the java.args and java.library.path JVM arguments used by your
application server.
2 (Windows only) If you installed ODBC support, remove the ODBC Windows services by navigating to the
cf_webapp_root\WEB_INF\cfusion\db\SequeLink Setup directory and executing the RemoveSequeLink.bat file.
3 If necessary, copy and save CFM pages from the ColdFusion web application root.
4 Undeploy the ColdFusion web application using application-server-specific undeploy functionality.
a On WebLogic, open the WebLogic Administrator., open the WebLogic Administration Console
(http://hostname:portnumber/console) and go to domainname > Deployments > Applications. Click the trash
can to the right of the ColdFusion application, and then click Yes. Open the startup script for the WebLogic
domain and remove ColdFusion-specific entries, as follows:
CF_WEB_INF
CF_SHARED_LIB_DIR (also remove CF_SHARED_LIB_DIR from PRE_PATH)
LD_LIBRARY_PATH (UNIX only, remove ${CF_SHARED_LIBS})
(Windows only) JINTEGRA_PATH (also remove JINTEGRA_PATH from PRE_PATH)
(Windows only) Remove jintegra.jar from PRE_CLASSPATH
CF_SECURITY_JVM_OPTIONS
CF_GRAPHING_JVM_OPTIONS
Remove ColdFusion arguments from MEM_ARGS
Remove CF_SECURITY_JVM_OPTIONS and CF_GRAPHING_JVM_OPTIONS from JAVA_OPTIONS
45
5 If necessary, restart the application server.
Last updated 7/9/2012
Chapter 4: Installing Integrated
Technologies
ColdFusion 10 provides integration capabilities with several Adobe and third-party technologies. In some cases, you
can install these components when you install ColdFusion 10. In other cases, you might have to follow some steps
outside the ColdFusion installation.
Integrated Adobe and third-party technologies
ColdFusion 10 provides integration capabilities with several Adobe and third-party technologies.
Installing Dreamweaver extensions
46
1 Make a backup copy of the configuration/taglibraries/content/codehints folder and its contents.
2 Download the cf10dreamweaverextensions.mxp from the Adobe website or copy it from the ColdFusion 10 DVD.
3 Double-click the ColdFusion10_Tags_for_DW.mxp file.
You can update Dreamweaver to include all the new and updated tag and function hints and Help for ColdFusion 10.
Installing Report Builder
ColdFusion reporting consists of server-side run-time processing and the ColdFusion Report Builder. The server-side
processing is available on any platform, however, the ColdFusion Report Builder runs in Windows only.
Install the ColdFusion Report Builder
1 Access the ColdFusion Report Builder installer from one of the following locations:
• DVD - Use the DVD browser to select the ColdFusion reporting option.
• The Adobe website - Go to www.adobe.com/go/report_builder/.
2 Double-click the ColdFusion_10_ReportBuilder_WWEJ.exe file.
3 Follow the instructions in the installation.
Installing Solr search server
By default, the installer installs the Solr search server on the same computer as ColdFusion.
Note: In the case of J2EE deployments, if you deploy ColdFusion multiple times, then the Solr Home path must be updated
in the ColdFusion Administrator. To do this, go to Data & Services > Solr Server and then update the path in Solr Home
in the Configure Solr Server section.
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing Integrated Technologies
If you plan to install the Solr search server on a different computer from the one where you install ColdFusion, you
must install it separately.
Install the Solr search server separately
1 Download your platform-specific installer from the Adobe website or copy it from the ColdFusion 10 DVD, as
follows:
PlatformInstaller
WindowsColdFusion_10_Jetty_Solr_win.exe
47
Linux
• ColdFusion_10_Jetty_Solr_linux.bin
• ColdFusion_10_Jetty_Solr_linux64.bin
SolarisColdFusion_10_Solr_Jetty_solaris.bin
OSXColdFusion_10_Solr_Jetty_osx10.zip
AIXColdFusion_10_Solr_Jetty_aix.bin
2 Close any applications that are currently running on your computer.
3 Run the platform-specific installer using the appropriate command.
Note: Only console installations are available for UNIX systems.
Using Solr Search Server
Use the following steps to start and stop Solr.
Non-Windows platforms
• Start Solr using the following command:
sudo ./cfsolr start
• Stop Solr using the following command:
sudo ./cfsolr stop
Windows platform
• Start or stop the Solr service ColdFusion 10 Solr Service using Microsoft Management Console.
Enabling Flash Remoting
To interact with ColdFusion pages and components from an Adobe Flash SWF file, you can use the Flash Remoting
service in ColdFusion 10. To develop applications that use Flash Remoting, install the Flash Remoting components in
the Flash authoring environment. The Flash authoring environment or Adobe Flex is required to build applications
that connect to and interact with the Flash Remoting service in ColdFusion 10.
By default, Adobe Flash Remoting cannot access web services through ColdFusion 10.
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing Integrated Technologies
Enable Flash Remoting to access web services through ColdFusion 10
1 Open the cf_root/cfusion/wwwroot/WEB-INF/gateway-config.xml file in a text editor.
For more information on Flash Remoting, see the Developing Adobe® ColdFusion® 10 Applications guide.
Installing Flash Remoting Update
Flash Remoting Update lets you create rich Internet applications by using Adobe® Flash™ Builder™, with the advanced
data retrieval features of ColdFusion, such as the c
Update to create Flash Forms and SWF applications that contain features, such as server callbacks and customized user
interface.
fpop, cfldap, and cfquery tags. Also, you can use Flash Remoting
48
Install Flash Remoting Update
1 Install ColdFusion 10.
2 If your ColdFusion server uses something other than port 8500, do the following:
a Open the file <cf_root>\wwwroot\Web-INF\flex\services-config.xml.
b Change the following to specify the port that you are using in the endpoint URL:
<endpoint uri="http://localhost:8500/flex2gateway/" in flex-services.xml
c Save the file.
d Restart the ColdFusion server.
Installing the ColdFusion .NET Integration Services
You install Adobe ColdFusion 10 .NET Integration Service to access .NET assemblies from ColdFusion. The .NET
assemblies can exist either locally on the computer on which ColdFusion is running or on a remote machine. If the
computer on which you are installing ColdFusion does not have Microsoft .NET framework installed, the .NET
Integration Services option is disabled in the ColdFusion installer.
Installing ColdFusion .NET Integration Services with ColdFusion
If .NET assemblies exist locally, select the .NET Integration Services option when you install ColdFusion. Doing so
installs the Adobe Coldfusion 10 .NET Integration Services with ColdFusion. You can access .NET assemblies locally
only if you are running ColdFusion on a Windows computer; on other operating systems, the .NET assemblies must
be on a remote Windows computer.
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing Integrated Technologies
The ColdFusion installer puts the .NET Integration software in the cf_root\jnbridge directory. If you install the
ColdFusion J2EE configuration, you can specify the directory in which to install the .NET Integration software.
The installer automatically determines your Windows system .NET Framework version (1.x or 2.0) and installs the
appropriate .NET integration software. Both 32-bit and 64-bit systems are supported. If you upgrade your .NET
Framework, reinstall Adobe Coldfusion 10 .NET Integration Servies. Proxies that you generate for .NET Framework
1.x work with .NET Framework 2.0 and .NET Framework 3.0, but proxies generated for .NET Framework 2.0 do not
work with 1.x frameworks.
Installing ColdFusion .NET Service separately
If the .NET assemblies are on a remote computer, you use the .NET Service Installer
(ColdFusion_10_DotNetIntegration_WWEJ.exe) to install Adobe Coldfusion 10 .NET Service. Similarly, to install the
ColdFusion .NET Service when Coldfusion is already installed, you use the
ColdFusion_10_DotNetIntegration_WWEJ.exe.
Installing using the ColdFusion 10 .NET Service installer
1 Open the installer.
2 Select the directory in which to install the .NET Service files.
3 Do one of the following:
a To install the .NET Service on the computer that is running ColdFusion, select the Install .NET Service With
ColdFusion option and specify the ColdFusion root directory.
b To install the .NET Service remotely, select the Install .NET Service As Standalone option.
4 Review the Summary and click Install.
5 Restart ColdFusion.
49
Uninstall the ColdFusion 10 .NET Service
1 Select Start > Settings > Control Panel > Add or Remove Programs.
2 Select Adobe Coldfusion 10 .NET Service.
3 Click Uninstall.
Alternatively, you can uninstall the Adobe Coldfusion 10 .NET Service by running the Uninstall Adobe ColdFusion
10 .NET Integration Services.exe program. The program is located in the cf_root\jnbridge\uninstall directory on
ColdFusion server configurations. On J2EE configuration and on computers where you installed the Integration
software without ColdFusion, it is in the C:\ColdFusionDotNetService\uninstall directory by default.
Configuring OpenOffice
Configuring OpenOffice with ColdFusion 10 lets you use the cfdocument tag to convert Word documents to PDF and
PowerPoint presentations to PDF/HTML.
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing Integrated Technologies
Configuring OpenOffice for stand-alone
Download and install OpenOffice from http://download.openoffice.org/. When you install ColdFusion 10 in a nonWindows platform, the installer prompts you with the directory path where OpenOffice is installed. If you want to
specify a different installation path, you can specify the directory path as follows:
• For Macintosh platform:
/Applications/openoffice.org3
• For UNIX platform:
Depends on the UNIX flavor.
The location of OpenOffice installation might vary depending on the operating system that you use. In most cases,
the location would be /usr/lib/openoffice.org3
or
/usr/lib/ooo3.x.
You can also specify the OpenOffice installation path in the ColdFusion Administrator as follows:
1 Log in to ColdFusion Administrator.
2 Navigate to Server Settings > Document, and enter the OpenOffice directory.
50
Configuring OpenOffice for J2EE servers
The following instructions are not applicable for stand-alone ColdFusion 10.
1 Download and install OpenOffice from http://download.openoffice.org/.
2 For all other J2EE servers:
• Add the following classes and JAR files in the class path:
Specify the IP address (of the remote machine in which you want to configure OpenOffice) in the host attribute.
2 Log in to ColdFusion Administrator.
3 Navigate to Server Settings > Document, and enter the host, and port details.
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Installing Integrated Technologies
Configuring OpenOffice post ColdFusion 10 installation
If you have a version of ColdFusion 10 already installed on your system, for all platforms, follow these instructions to
configure OpenOffice:
1 Log in to ColdFusion Administrator.
2 Navigate to Server Settings > Document, and specify the OpenOffice directory.
3 Restart the ColdFusion server.
51
Last updated 7/9/2012
Chapter 5: Configuring Your System
You can manage ColdFusion services and processes, configure web servers manually, and change user accounts and
configure databases for ColdFusion.
Note: The term cf_root refers to your installation directory in the server configuration. By default, this directory is
C:\ColdFusion10 in Windows, /opt/coldfusion10 in UNIX, and /Applications/ColdFusion10 in OSX.
Overview of configuration tasks
Configuration taskWhen to do it
52
Managing ColdFusion services in
Windows and Managing the ColdFusion
process in UNIX
Configuring web serversWhen moving to a production server or when the built-in web server no longer meets your needs.
Enabling CORBA supportIf you must make CORBA invocations from ColdFusion. You can do this after you install ColdFusion
For your changes to take effect when you stop and restart ColdFusion, for example after you enable
or disable security in the ColdFusion Administrator or change any of the Java and JVM settings. You
can do this at any time after you install ColdFusion.
and before you make a CORBA call from ColdFusion.
For security reasons, disable RDS when you move an application to the production environment.
When running ColdFusion Enterprise Edition in a hosted environment, you might want to disable
JSP processing.
Iif you discover that the account under which ColdFusion is running has inappropriate access rights;
for example, to interact with remote data sources, other application pages, or COM objects. You
must also do this to be able to print to a printer using the
install ColdFusion and before you deploy your application.
cfprint tag. You can do this after you
For information about additional configuration tasks, see the Configuring and Administering ColdFusion guide.
Managing ColdFusion services in Windows
The ColdFusion installation creates the following services in the configuration indicated:
ServicePurposeConfiguration
ColdFusion 10 Application ServerThe main ColdFusion service. ColdFusion pages cannot be
processed if this service is not running.
ColdFusion 10 ODBC AgentThe service used to configure data sources for the ColdFusion 10
ODBC Server.
ColdFusion 10 ODBC ServerThe middle-tier service for ODBC connections that use the
DataDirect drivers for Microsoft Access and ODBC Socket.
ColdFusion 10 Jetty ServiceProvides support for the ColdFusion 10 search tags.. You cannot
use the ColdFusion 10 search tags if this process is not running.
ColdFusion 10 .NET ServiceLets you access local .NET assemblies on a Windows system that
runs ColdFusion.
Last updated 7/9/2012
Server
All
All
All
All
INSTALLING COLDFUSION 10
Configuring Your System
Note: In the ColdFusion Administrator, if you enable or disable security or change any option in the Java and JVM
Settings page, stop and restart ColdFusion 10 for your changes to take effect.
Start or stop a ColdFusion service
1 Open the Services dialog box by selecting Start > Settings > Control Panel > Administrative Tools > Services.
If a service is running, its status appears as Started in the Status column. If it is not running, no status appears for
the service.
2 Right-click a service, and select Stop, Start, or Restart.
The Services window refreshes.
Set ColdFusion 10 to start automatically or manually
1 Open the Control Panel > Services dialog box.
2 Right-click the service to configure, and select Properties.
3 In the Properties dialog box, on the General tab, select one of the following options in the Startup Type frame or
pop-up menu, and click OK:
• Automatic - Starts the service automatically when you start the computer.
• Manual - Requires a user or dependent service to manually start the service.
53
Managing the ColdFusion process in UNIX
The ColdFusion installation creates a single process in UNIX called coldfusion10. To check whether it is running,
use the following command:
ps -eaf | grep coldfusion10
If it is running, your computer returns something similar to the following line:
The ColdFusion process starts automatically when you start your computer and shuts down automatically when you
shut down your computer, if you specified that it should do so in the installation.
In the ColdFusion Administrator, if you enable or disable security or change any option in the Java and JVM Settings
page, stop and restart the ColdFusion process for your changes to take effect. This applies to the server configuration
only; in the J2EE configurations, you use application-server-specific methods to update Java settings.
Manage the ColdFusion process in UNIX
1 Log in as root, if you have not already done so.
2 Enter the following command:
cd cf_root/bin
3 Enter the appropriate command, as the following table describes:
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Configuring Your System
TaskCommand
Start ColdFusion 10./coldfusion start
Stop ColdFusion 10./coldfusion stop
Restart ColdFusion 10./coldfusion restart
View status of ColdFusion server./coldfusion status
Managing the ColdFusion process in Mac OS X
The ColdFusion installation creates a single process in UNIX called cfusion. To check whether it is running, use the
following command:
ps -eaf | grep coldfusion10
If it is running, your computer returns something similar to the following line:
Note: This discussion applies to the ColdFusion 10 server configuration only. With the J2EE configuration, you start and
stop ColdFusion 10 by starting the application server.
54
The ColdFusion process starts automatically when you start your computer and shuts down automatically when you
shut down your computer, if you specified that it should do so in the installation.
In the ColdFusion Administrator, if you enable or disable security or change any option in the Java and JVM Settings
page, stop and restart the ColdFusion process for your changes to take effect. This applies to the server configuration
only; in the J2EE configurations, you use application-server-specific methods to update Java settings.
Manage the ColdFusion process in UNIX
1 Log in as root, if you have not already done so.
2 Enter the following command:
cd cf_root/bin
3 Enter the appropriate command, as the following table describes:
TaskCommand
Start ColdFusion 10./coldfusion start
Stop ColdFusion 10./coldfusion stop
Restart ColdFusion 10./coldfusion restart
View performance information for ColdFusion 10./coldfusion status
Configuring web servers
You configure a web server to serve ColdFusion pages, for Windows and UNIX if you did not configure a web server
automatically during installation, if you want to change your web server, or to configure a web server for a cluster.
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Configuring Your System
You configure an external web server connection by using the Web Server Configuration Tool, which you can run
through a graphical user interface (GUI) or the command line. The Windows discussions describe GUI mode, and the
UNIX instructions describe command-line mode; however, you can use GUI mode in UNIX if you have access to a
graphical environment.
ColdFusion 10 provides batch files and shell scripts in the cf_root/cfusion/bin/connectors directory to help you get
started with command-line usage.
For more information on the Web Server Configuration Tool, including information on multihoming and distributed
usage, see the Configuring and Administering ColdFusion guide.
Note: If you cannot verify your configuration, repeat the procedure. If the problem persists, contact Adobe Technical
Support for assistance, or manually create the element that you cannot verify in the configuration (for example, manually
add an entry to the Apache httpd.conf file, as described here.).
Configuring web servers in Windows
You configure web servers in Windows by doing the following:
• Configuring IIS in Windows
• Configuring Sun Java System Web Server in Windows
• Configuring Apache web server in Windows
55
Configuring IIS in Windows
You configure IIS using the Web Server Configuration Tool in GUI or command-line mode. This discussion describes
how to use GUI mode.
(Server configuration only) To use the command line, open the batch files located in cf_root\cfusion\bin\connectors
or by navigating to <ColdFusion_Home>\runtime\bin directory.
For more information, see the Web Server Management chapter in the Configuring and Administering ColdFusion
guide.
Configure IIS for ColdFusion in Windows
Note: If you are configuring IIS 7 or IIS 7.5, before you proceed, ensure that you have the options ISAPI Extensions
(Internet Information Service > Web Management Tools > World Wide Web Services > Application Development
Features), ASP.NET , and CGI selected in the Windows Features dialog box (Start > Control Panel > Programs and
Features > Turn Windows features on or off).
1 Start the Web Server Configuration Tool by selecting Start > Programs > Adobe > ColdFusion 10 > Web Server
Configuration Tool.
2 Click Add.
3 In the Server pop-up menu, enter the host name and the cluster name to configure.
Note: The server or cluster does not have to reside on the web server computer.
❖ In the Web Server Properties area, select IIS and specify the website. For IIS, you typically specify All.
Verify your IIS configuration
1 Verify that the following folder was created: cf_root/config/wsconfig/number.
2 To set the connectionpooltimeout and reuseconnectioncount click on Advanced Setting tab. The option to
enable buffering and verbose debugging is available on the same page.
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Configuring Your System
Configuring IIS:
• Creates a folder 1 in cfroot\config\wsconfig, that contains all connector-related files.
• Creates a virtual directory Jakarta in cfroot\config\wsconfig (in IIS).
• Adds an entry, tomcat, under the ISAPI FILTERS. This points to
cfroot\config\wsconfig\1\isapi_redirect.dll.
• Adds an entry, tomcat, to cfroot\config\wsconfig\1\isapi_redirect.dll with permission allowed under
ISAPI and CGI Restrictions. It is applicable for global sites in IIS manager.
• Adds the following isapi handlers: cfcHandler, cfmHandler, cfmlHandler, cfrHandler, and cfswfHandler.
• For debugging issues, set the log level to debug, in the isapi_redirect.properties file present in the
cfroot\config\wsconfig\1\ directory.
• To disable webserver buffer, change the is_buffer_enable to false in the
cfroot\config\wsconfig\1\isapi_redirect.properties file. Disable webserver buffer if you want cfflush
to work over an IIS connector. If your application does not use
cfflush, set it to true for increase in the
performance.
Configure Sun Java System Web Server for ColdFusion in Windows
You configure Sun Java Web Server 6.x/Sun Java System Web Server 7 for ColdFusion in Windows, and verify your
configuration, by using the Web Server Configuration Tool in GUI or command-line mode. This discussion describes
how to use GUI mode.
56
Note: On Windows, only 32-bit Sun ONE is available.
Note: (Server configuration only) To use the command line, open the batch files located in cf_root/bin/connectors.
For more information, see the Web Server Management topic in the Configuring and Administering ColdFusion guide.
1 Start the Web Server Configuration Tool by selecting Start > Programs > Adobe > ColdFusion 10 > Web Server
Configuration Tool.
2 Click Add.
3 In the Server pop-up menu, enter the host name and the cluster name to configure.
Note: The server or cluster does not have to reside on the web server computer.
4 In the Web Server Properties area, select Sun Java Web Server (iPlanet), and specify the path to the directory that
contains the obj.conf and magnus.conf files.
Verify your configuration
1 Verify that the following folder was created: cf_root/config/wsconfig/number.
2 To set the connectionpooltimeout and reuseconnectioncount click on Advanced Setting tab. The option to
enable verbose debugging also is available on this page.
Configuring Sun ONE:
Note: On Windows and Linux 64-bit, only 32-bit Sun ONE is available. While using a 64-bit configurator, provide 32bit Sun ONE properties.
• Creates a folder 1 in the config\wsconfig folder that contains all connector-related files.
• Adds the following entry in the magnus.conf file of Sun ONE. Change the log level to debug for debugging issues.
Note: For unique configurations (such as the preconfigured Apache web servers from Redhat or Sun), add the -bin and script parameters, as described in the Configuring and Administering ColdFusion guide.
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Configuring Your System
Verify your Apache configuration
1 Verify that one of the following files was created:
• cf_root/config/wsconfig/number
2 To set the connectionpooltimeout and reuseconnectioncount click on Advanced Setting tab. The option to
enable verbose debugging also is available on this page.
Configuring Apache:
Note: To configure Apache connector in UNIX platforms, APXS installation is a prerequisite.
Note: Configuring Apache is not supported on Mac 10.5.
• Creates a folder 1 in cfroot\config\wsconfig that contains all connector-related files.
• Creates a file mod_jk.conf in Apache_root_folder\conf. This file has paths to all files in the
cfroot\config\wsconfig\1 directory.
• Adds an entry in the httpd.conf file of Apache to include mod_jk.conf.
• The following files are significant:
• uriworkermap.properties: Mapped extensions based on which the connector forwards requests to Tomcat.
• mod_jk.conf: Contains paths to all files in the \config\wsconfig\1 directory.
Change the entry JKloglevel info to JKloglevel debug for debugging purposes.
59
Note: For virtual host configuration, add the following entry in each of the virtual blocks: JkMountFile
You can configure and verify Sun Java Web Server (6.x)/Sun Java System Web Server (7.0) for ColdFusion in UNIX.
1 Launch the cfroot/cfusion/runtime/bin launch wsconfig tool.
2 Click Add, and then select Sun Web Server 7.
3 Select conf dir from the Sun Web Server root (created instance).
4 Select the Configure Web Server For ColdFusion Applications option and click Add.
Note: Use the following command to configure Sun Java Web Server using the command-line: ./wsconfig -ws
iplanet -dir config_folder_of_web_server_instance
Unconfigure Sun Java Web Server 6.0/Sun Java System Web Server 7 on UNIX
1 Go to <cf_home>/runtime/bin directory.
2 Execute the following command:./wsconfig -ws SunJWS -dir <Directory path> -remove
Enabling CORBA support
ColdFusion supports third-party Object Request Brokers (ORBs) through its integration with Borland Visibroker.
However, you must acquire the Common Object Request Broker Architecture (CORBA) software separately from
Borland.
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Configuring Your System
System requirements
You must have all of the following components installed on your computer before you can make CORBA invocations
from ColdFusion:
• Borland Visibroker 4.5.1 for Java
• Java Runtime Environment (JRE) 1.4 for the Visibroker Interface Repository
• JRE 1.6 or later for ColdFusion 10
Installing Visibroker for CORBA connections
1 Install Visibroker on the CORBA server side.
For more information, see the Borland Visibroker documentation.
2 Add the vbjorb.jar file to the ColdFusion classpath, as follows:
a In the ColdFusion Administrator, select Server Settings > Java and JVM. When using the J2EE configuration,
you add the vbjorb.jar file to the J2EE application server classpath, using the server-specific method.
b On the Java and JVM Settings page, in the Class Path text box, enter the path to your vbjorb.jar file (for example,
C:\Inprise\vbroker\lib\vbjorb.jar). Add the JVM Args text box.
You require only the JAR file on the computer that is running ColdFusion; you do not need the full Visibroker
installation.
Xbootclasspath/a:"C:/Inprise/vbroker/lib/vbjorb.jar", to
60
c Click Submit Changes.
3 Configure a Visibroker connector in ColdFusion, as follows:
a In the ColdFusion Administrator, select Extensions > CORBA Connectors.
b In the CORBA Connectors page, click Register CORBA Connector.
c In the CORBA Connector page, enter information for the connector.
The following is an example of a correctly configured connector:
FieldValue
ORB Namevisibroker
ORB Class Namecoldfusion.runtime.corba.VisibrokerConnector
e Select the radio button to the left of your new CORBA connector and click Select ORB Connector.
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Configuring Your System
This sets the new connector to be the default.
4 Prepare your CORBA server side, as follows:
a Start your Visibroker osagent service or process, if it is not already running, by entering the following command:
osagent
Note: If you must connect to an osagent in another subnetwork, include the following lines in the vbjorb.properties file:
vbroker.agent.addr=<IP address of machine running OSAGENT>
vbroker.agent.port=<port>
b Start the Interface Repository and load it with the IDL file that you plan to use, by entering an irep command,
as in the following example:
irep myir MyIDLFile.idl
c (Optional) Start the Naming Service by entering a command like the following:
nameserv namingroot
Note: The name of the Naming Service (namingroot in the previous example) must match the value for
SVCnameroot in the vbjorb.properties file.
d Start Visibroker on your CORBA server.
For more information, see the Borland Visibroker documentation.
61
5 Restart ColdFusion for your changes to take effect.
For more information, see “Managing ColdFusion services in Windows” on page 52 and “Managing the ColdFusion
process in UNIX” on page 53.
You can now make CORBA invocations from ColdFusion. For more information about integrating CORBA objects
into ColdFusion, see the Developing ColdFusion Applications guide.
Disabling Remote Development Services
If you use Adobe Dreamweaver, Macromedia HomeSite, Adobe Flash Builder, or Eclipse to develop your applications, you
can access a remote ColdFusion server using HTTP. However, you must configure Remote Development Services (RDS)
in your integrated development environment (IDE), and RDS must be enabled in ColdFusion. Using RDS, IDE users can
securely access remote files and data sources, build SQL queries from these data sources, and debug CFML code.
Note: The ColdFusion Report Builder uses RDS for the Query Builder and for charting support.
However, for security reasons, Adobe recommends that you disable RDS on a production server. To disable it, disable
the RDSServlet mapping.
Disable the RDSServlet mapping
1 Back up the web.xml file.
This file is in the cf_root\cfusion\wwwroot\WEB-INF directory in Windows and in the
cf_root/cfusion/wwwroot/WEB-INF directory in UNIX.
2 Open the original web.xml file for editing.
3 Comment out the RDSServlet mapping, as the following example shows:
ColdFusion Enterprise Edition provides support for JavaServer Pages (JSP) technology through the underlying J2EE
application server on which it runs. Because JSP code runs outside the realm of the ColdFusion security framework
and, therefore, is not subject to ColdFusion sandbox security, you do not typically deploy JSPs in a shared, hosted
environment where more than one customer shares a single server.
Disable JSP functionality
1 Open cf_root/cfusion/runtime/conf/web.xml in a text editor.
2 Find the servlet-mapping entry for JspLicenseServlet.
3 Comment out this entry, as the following example shows:
The ColdFusion services, by default, run under the highly privileged system accounts. For an extra level of security,
Adobe recommends that you create a Windows user under which you run the services and only give necessary
privileges to run the web application (for example, folder permissions for the web root.)
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Configuring Your System
Change the ColdFusion user account
1 Open the Services Control Panel. (For example, select Start > Settings > Control Panel > Administrative Tools >
Services.)
2 Right-click ColdFusion 10 Application Server, and select Properties.
The ColdFusion 10 Application Server Properties (Local Computer) dialog box appears.
3 On the Log On tab, select This account, and enter the account information.
4 Click OK.
5 In the Services control panel, right-click ColdFusion 10 Application Server, and select Restart.
Note: Do not rename your Windows Administrator account. This causes problems with security policies and profiles.
63
Last updated 7/9/2012
Chapter 6: Troubleshooting
If you encounter any of the common installation problems, you may be able to resolve the issue by following the steps
indicated for that issue.
Common installation problems
Spaces in the TEMP or TMP environment variables (Windows only)
Problem:
A space in the path of the TMP or TEMP environment variables in Windows causes the installer to stop after extracting
from the archive.
Solution:
Change the TEMP or TMP environment variable so it does not include spaces.
64
Incomplete download
Problem:
InstallAnywhere displays a message to choose another install location. No matter what location you choose, the install
doesn’t succeed.
Solution:
Ensure that you downloaded the complete installation file; if not, download the file again.
Problem:
When you try to download the ColdFusion installation file on an Apple Macintosh, the download stops before it is
complete, but the browser indicates that the download is complete.
Solution:
If you are using Safari:
1 Start the download.
2 Open the download window (Option-Command-L).
3 When the download looks like it has stalled, click the Stop (X) button.
4 Click the Resume button.
Safari continues the download from where it stalled.
5 Repeat Steps 3 and 4 as necessary
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Troubleshooting
Server error
Problem:
When trying to access any CFM page either from the server itself, or remotely, the following error appears:
Server Error
The server encountered an internal error and was unable to complete your request.
Solution:
Run the Web Server Configuration Tool to unconfigure and reconfigure your web server connectors, as described in
“Configuring web servers” on page 54.
Cannot start ColdFusion Server
Problem:
After installing Windows SP2 firewall, you cannot start ColdFusion services.
Solution:
After installing Windows XP Service Pack 2, the Windows Firewall is enabled by default. This prevents ColdFusion
from functioning correctly. For more information, see the Tech Note at
www.adobe.com/go/tn_19518.
65
Errors displaying Flash forms
Problem:
When you try to browse a ColdFusion page that contains a Flash form, the following errors appear:
2 Errors found.
Error /CFIDE/gettingstarted/community/webroot/index.cfm:-1
macromedia.css.LocatorParser
Error /CFIDE/gettingstarted/community/webroot/inde.mxml:381
The class 'mx.rpc.RemoteClassRelayResponder' could not be loaded.
Solution:
If you are using an external web server, such as Apache or IIS, run the Web Server Configuration Tool by selecting
Start > Programs > Adobe > ColdFusion 10 > Web Server Configuration Tool; also, try using the built-in server, using
port 8500. For more information, see
“Configuring web servers” on page 54.
Browsing a ColdFusion page displays a download window
Problem:
In earlier versions of ColdFusion, you used IIS to map the filename extension .cfm to ICSF.dll. In ColdFusion, you have
not mapped the .cfm filename extension to any .dll file. As a result, ColdFusion pages do not execute running under
IIS 5.0, but display a download window instead.
Solution:
Run the Web Server Configuration Tool by selecting Start > Programs > Adobe > ColdFusion 10 > Web Server
Configuration Tool. For more information, see
“Configuring web servers” on page 54.
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Troubleshooting
ColdFusion Administrator displays as an encrypted page
Problem:
After you install ColdFusion, you install Windows XP SP2. When you start ColdFusion Administrator, the
Administrator displays as an encrypted page.
Solution:
The Windows XP SP2 update may have undone the IIS mapping for ColdFusion. Run the batch scripts to uninstall,
and then reinstall the IIS connectors. For more information, see
“Configuring web servers” on page 54.
ColdFusion doesn’t start
Problem:
ColdFusion doesn’t start when you have McAfee Privacy Service installed on system.
Solution:
Remove McAfee Privacy Service.
66
Data source problems
Unable to add a Microsoft Access data source
Problem:
When you try to add a Microsoft Access data source, an error appears:
Solution:
Install and start up the ODBC service, or use the Microsoft Access with Unicode driver.
ODBC services do not install properly
Problem:
ODBC services do not install properly.
Solution:
Remove the existing ODBC services using the following code:
Unable to INSERT or UPDATE an Oracle 10 database when there is a CLOB field
Problem:
Columns have a 4 KB size limit in Oracle. If a column is larger that the 4 KB size limit, when you try to use either the
cfinsert or cfupdate tag, the following error is generated:
ORA-01704: string literal too long
Solution:
To avoid this error, use either the cfquery or cfqueryparam tag.
Migration problems
67
Data sources not recognized
Problem:
When you migrate from an earlier version of ColdFusion to ColdFusion 10, your application does not recognize data
sources.
Solution:
Redefine the data sources.
CFCs not recognized in Dreamweaver
Problem:
When you migrate from an earlier version of ColdFusion to ColdFusion 10, the CFCs do not appear in the
Components panel of Dreamweaver.
Solution:
Check the mappings and update them as necessary.
Installation fails
Problem:
On UNIX and Linux systems, when you try to install ColdFusion on systems where the /tmp partition is mounted
noexec, the installation fails.
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Troubleshooting
Solution:
This is because the install attempts to use the /tmp directory for unpacking and running the installer runtime. To avoid
this issue, set the
running the installer.
Problem:
When you try to install ColdFusion, the installation fails and generate the error:
"java.lang.OutOfMemoryError Invocation of this Java Application has caused an
InvocationTargetException. This application will now exit. (LAX)"
Solution:
You must clean up the directory to which the installer is trying to extract the JRE, for example, /tmp.
IATEMPDIR environment variable to a directory on the system that has execute permissions before
J2EE configuration problems
Problem:
When you install ColdFusion on Red Hat Enterprise Linux 4, the installation script incorrectly report a warning
regarding the C++ compatibility pack.
68
Solution:
If you plan to use C++ based custom CFX tags, you should interrogate your system for compat-libstdc++ and glibc
packages and install them if necessary. Either query all packages and use the
exact package name. For example, the command
or greps on the string
3.2.3-47.3 and compat-libstdc++-296-2.96-132.7.2.
compat-libstdc++. This command might produce two results, compat-libstdc++-33-
rpm -qa | grep compat-libstdc++ queries all packages and filters
grep command as a filter or query the
Postinstallation problems
CLOB and data corruption
Problem:
You are using the Japanese version of ColdFusion and Oracle 8/9 with NLS_Characterset JA16SJJS, and encounter
CLOB corruption and data corruption.
Solution:
Set codepageoverride=MS932 in the JDBC URL.
Last updated 7/9/2012
INSTALLING COLDFUSION 10
Troubleshooting
Uninstall problems
COM disabled
Problem:
You have an earlier version of ColdFusion on the system. When you uninstall ColdFusion, COM is disabled.
Solution:
Re-register the typeviewer.dll file associated with the earlier version of ColdFusion.
69
Last updated 7/9/2012
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.