ADOBE COLDFUSION 8 INSTALLING AND USING COLDFUSION ® ™
© 2007 Adobe Systems Incorporated. All rights reserved. Adobe® ColdFusion™ Installing and Using ColdFusion for AIX®, Linux®, Mac OS, Solaris™, UNIX®, and Windows®. If this guide is distributed with software that includes an end user agreement, this guide, as well as the software described in it, is furnished under license and may be used or copied only in accordance with the terms of such license.
iii Contents Chapter 1: Introduction Chapter 2: Preparing to Install ColdFusion About the ColdFusion installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 ColdFusion 8 product editions System requirements ............................................................. 4 ...................................................................... 4 Installation considerations ..............................................................
iv Installing Dreamweaver extensions Installing HomeSite+ Extensions Installing Report Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1 Chapter 1: Introduction Installing and Using ColdFusion is intended for anyone who installs and configures Adobe ColdFusion. About ColdFusion documentation The ColdFusion documentation is designed to provide support for the complete spectrum of participants. Documentation set Book Description Installing and Using ColdFu- Describes system installation and basic configuration for Windows, Macintoch, Solaris, sion Linux, and AIX.
2 CHAPTER 1 Introduction
3 Chapter 2: Preparing to Install ColdFusion Before installing Adobe ColdFusion 8, you should review ColdFusion product editions, system requirements, and other high-level considerations. Contents About the ColdFusion installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 ColdFusion 8 product editions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4 CHAPTER 2 Preparing to Install ColdFusion You can install ColdFusion 8 in any of the following configurations: Server configuration Lets you install one instance of ColdFusion 8 with an embedded J2EE server. This configu- ration most closely resembles the ColdFusion MX base release and other releases prior to ColdFusion MX, such as ColdFusion 5 and ColdFusion 4.5. This was formerly known as the stand-alone configuration.
ADOBE COLDFUSION 8 5 Installing and Using ColdFusion Installation considerations for all platforms The following are installation considerations for all platforms: • Adobe supports installing ColdFusion 8 side-by-side with ColdFusion MX 7, ColdFusion MX 6.1 and ColdFusion MX. • If you installed a Beta version of ColdFusion 8, you must uninstall it before you install the release version.
6 CHAPTER 2 Preparing to Install ColdFusion • Windows 2000 Professional or Microsoft Windows 2003 handles only ten TCP/IP connections concurrently. Therefore, Adobe does not recommend using this operating system in a production environment; use Windows 2000 Server or Microsoft Windows 2003 Server instead.
7 Chapter 3: Installing the Server Configuration The ColdFusion server configuration contains an embedded copy of Macromedia JRun from Adobe 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:\ColdFusion8 in Windows, and /opt/coldfusion8 in UNIX. Contents Gathering information necessary to install the server configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8 CHAPTER 3 Installing the Server Configuration Question Answer Subcomponents to install? ___ ColdFusion 8 ODBC Services ___ ColdFusion 8 Search Services ___ .
ADOBE COLDFUSION 8 9 Installing and Using ColdFusion Question Answer ColdFusion Administrator password? ___________________________________________________ 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.
10 CHAPTER 3 Installing the Server Configuration 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 setup.exe file 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-80-win.exe) and double-click it.
ADOBE COLDFUSION 8 11 Installing and Using ColdFusion The following installation files are those for the supported server configuration platforms: • coldfusion-80-lin.bin • coldfusion-80-sol64.bin 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-80-sol64.
12 CHAPTER 3 Installing the Server Configuration ColdFusion server configuration directory structure The following table describes the directories under the cf_root directory when you install the server configuration of ColdFusion: Directory Description bin Programs for starting, stopping, and viewing information for ColdFusion, and to run Crystal Reports (Windows only). cache Repository for temporary files from ColdFusion. cfx Sample C++ and Java CFX files with their supporting files.
ADOBE COLDFUSION 8 13 Installing and Using ColdFusion Directory Description uninstall Files to uninstall ColdFusion. verity Verity collections, configurations, and services directories. wwwroot Default web root directory for the built-in web server. When running on other web servers, this directory contains only the WEB-INF directory; do not remove this directory.
14 CHAPTER 3 Installing the Server Configuration This file is in the cf_root\runtime\servers\coldfusion\SERVER-INF directory in Windows, and in the cf_root/runtime/servers/coldfusion/SERVER-INF directory in UNIX. 2 Open the original jrun.xml file for editing. 3 Change the port number specified in the WebService port attribute (near the bottom of the file): PAGE 19ADOBE COLDFUSION 8 15 Installing and Using ColdFusion 1 name="maxHandlerThreads">1000 name="mapCheck">0 name="threadWaitTimeout">20 name="backlog">500 name="deactivated">true 5 Save the file.
16 CHAPTER 3 Installing the Server Configuration 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.
17 Chapter 4: Installing the Multiserver Configuration The multiserver configuration deploys and configures ColdFusion on its own JRun server. Contents Gathering information necessary to install the multiserver configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 About multiserver configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
18 CHAPTER 4 Installing the Multiserver Configuration Question Answer Subcomponents to install? ___ ColdFusion 8 ODBC Services ___ ColdFusion 8 Search Services ___ .
ADOBE COLDFUSION 8 19 Installing and Using ColdFusion Question Answer ColdFusion Administrator password? ___________________________________________________ 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.
20 CHAPTER 4 Installing the Multiserver Configuration Installing ColdFusion using the multiserver configuration You must install ColdFusion using the multiserver configuration on a computer that has no earlier versions of JRun. During the multiserver installation procedure, the installation wizard performs the following actions: • Installs JRun 4. • Creates a JRun server named cfusion (in addition to the admin and samples JRun servers).
ADOBE COLDFUSION 8 21 Installing and Using ColdFusion 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 setup.exe file 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-80-win.exe) and double-click it.
22 CHAPTER 4 Installing the Multiserver Configuration Installing the multiserver configuration in UNIX Install the multiserver configuration in UNIX 1 Read the online version of the Release Notes for any late-breaking information or updates. For more infor- mation, see www.adobe.com/go/cf8_releasenotes. 2 Ensure that your operating system meets the system requirements described on the Adobe website at www.adobe.com/go/cf8_sysreqs.
ADOBE COLDFUSION 8 23 Installing and Using ColdFusion 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 using the scripts in jrun_root/bin/connectors, or through java -jar jrun_root/lib/wsconfig.jar, as appropriate.
24 CHAPTER 4 Installing the Multiserver Configuration You configure these settings by using a text editor to modify the jrun_root/bin/jvm.config file. or through the Settings panel of the JRun Management Console (JMC). Uninstalling ColdFusion The steps for uninstalling ColdFusion depend on your operating system. Uninstall ColdFusion from Windows 1 Select Start > Settings > Control Panel > Add/Remove Programs > Adobe ColdFusion 8 with JRun 4. 2 Click Change/Remove.
25 Chapter 5: Installing the J2EE Configuration Follow the instructions in this topic to install, deploy, and undeploy Adobe ColdFusion Enterprise Edition in the J2EE configuration. Also follow the specific instructions for installing Macromedia JRun 4 from Adobe (which automatically deploys and configures ColdFusion), and general instructions for installing all J2EE application servers. Contents Gathering information necessary to install the J2EE configuration . . . . . . . . . . . . . . . . . . . . . .
26 CHAPTER 5 Installing the J2EE Configuration Question Answer EAR or WAR file? ___ EAR ___ WAR Subcomponents to install? ___ ColdFusion 8 ODBC Services ___ ColdFusion 8 Search Services ___ .
ADOBE COLDFUSION 8 27 Installing and Using ColdFusion 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 (multiserver configuration and J2EE configuration).
28 CHAPTER 5 Installing the J2EE Configuration 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 enterprise applications in these directory structures as-is or in compressed EAR files that contain these directory structures.
ADOBE COLDFUSION 8 29 Installing and Using ColdFusion Note: Each web application running in a server instance must have a unique context root. The JRun default web application uses / for a context root, so if you want to use / for the ColdFusion context root when you deploy on JRun, you must either delete the default-war application or change the default-war context root by editing the defaultear/META-INF/application.xml file.
30 CHAPTER 5 Installing the J2EE Configuration Preparing to install using the J2EE configuration When you install the J2EE configuration, you have the following options: New installation—multiserver configuration Use this option to install a copy of JRun 4 with ColdFusion deployed and configured as an enterprise application in a JRun server. For installation details, see “Installing ColdFusion using the multiserver configuration” on page 20.
ADOBE COLDFUSION 8 31 Installing and Using ColdFusion Installing an EAR file or WAR files in Windows You can install the ColdFusion J2EE configuration in Windows. If you are updating an existing deployment of ColdFusion MX, ColdFusion MX 6.1, or ColdFusion MX 7 for J2EE, see “Updating from an earlier version for J2EE” on page 36 before you continue. Note: The Windows installer requires a computer that supports at least 256 colors.
32 CHAPTER 5 Installing the J2EE Configuration 15 To learn about ColdFusion, read the documentation, which is accessible through the Documentation link on the Resources page of the ColdFusion Administrator. 16 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.
ADOBE COLDFUSION 8 33 Installing and Using ColdFusion 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: • coldfusion-80-lin.bin - To install on Linux. • coldfusion-80-sol.bin - To install on Solaris. • coldfusion-80-other.jar - To install on a UNIX platform other than Solaris or Linux.
34 CHAPTER 5 Installing the J2EE Configuration 16 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 • portnumber The machine name, IP address, or localhost. The port number used by your application server’s web server. • contextroot The context root for the ColdFusion web application.
ADOBE COLDFUSION 8 35 Installing and Using ColdFusion • coldfusion-80-osx.zip - To install in Mac OS X. 8 Using the cd command, go to the directory with the installation file. 9 Start the installation by double-clicking the coldfusion-macr-osx.zip file on the desktop. The file ColdFusion 8 Installer.app is installed in the same directory. Double click this APP file to start the installation in GUI mode. 10 Follow the prompts, and let the installation program run to completion.
36 CHAPTER 5 Installing the J2EE Configuration Updating from an earlier version for J2EE If you previously deployed ColdFusion MX for J2EE, the ColdFusion MX 6.
ADOBE COLDFUSION 8 37 Installing and Using ColdFusion 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: Application server Deployment mechanism Expanded or compressed deployment JRun 4 Auto deploy to server root or deploy using the JRun Administrative Console Expanded IBM WebSph
38 CHAPTER 5 Installing the J2EE Configuration Directory Description WEB-INF/cfc-skeletons Support for ColdFusion components that are exported as web services. WEB-INF/cfform Files that support Flash forms. WEB-INF/cftags Templates for ColdFusion. WEB-ING/flex Configuration and files for LiveCycle Data Services ES. WEB-INF/gateway Files that support event gateways. WEB-INF/cfusion/bin Executable files used by ColdFusion. WEB-INF/cfusion/cfx CFX tag include file and examples.
ADOBE COLDFUSION 8 39 Installing and Using ColdFusion If you are updating an existing deployment of ColdFusion MX, ColdFusion MX 6.1, or ColdFusion MX 7 for J2EE, you must undeploy ColdFusion MX, ColdFusion MX 6.1, or ColdFusion MX 7 for J2EE before you deploy ColdFusion 8, as described in “Updating from an earlier version for J2EE” on page 36.
40 CHAPTER 5 Installing the J2EE Configuration i Change the web-uri element from cfusion.war to cfusion-war (or the name of the directory that contains the expanded cfusion.war file). Change the web-uri element for rds.war to rds-war. A directory name in the weburi element cannot contain a dot. j Save the application.xml file. 2 Deploy ColdFusion 8 by copying the cfusion-ear directory structure to the jrun_root/servers/servername directory.
ADOBE COLDFUSION 8 41 Installing and Using ColdFusion The directory can have any name, but these instructions assume a directory name of cfusion under your JRun server instance. This directory becomes the context root into which ColdFusion is deployed. For example, if you are installing ColdFusion in the default JRun server, the directory is /opt/jrun4/servers/default/cfusion. 2 Create a directory named CFIDE.
42 CHAPTER 5 Installing the J2EE Configuration com.gp.java2d.ExHeadlessGraphicsEnvironment instead of com.gp.java2d.ExGraphicsEnvironment. 10 In addition to enabling sandbox security in the ColdFusion Administrator, the application server must be running a security manager (java.lang.SecurityManager) and you must define the following JVM arguments: -Djava.security.manager -Djava.security.policy="cf_webapp_root/WEB-INF/cfusion/lib/coldfusion.policy" -Djava.security.auth.
ADOBE COLDFUSION 8 43 Installing and Using ColdFusion java_home The root directory of your Java 2 software development kit (J2SDK); for example, C:\j2sdk1.4.1. When you deploy ColdFusion on an existing version of IBM WebSphere, you must expand the EAR file or WAR files manually before deployment.
44 CHAPTER 5 Installing the J2EE Configuration 9 Change the web-uri element from cfusion.war to cfusion-war (or the name of the directory that contains the expanded cfusion.war file). Change the web-uri element for rds.war to rds-war. A directory name in the web-uri element cannot contain a dot. 10 Save the application.xml file. On WebSphere ND, deploying multiple application server clones on a single computer is commonly referred to as vertical clustering.
ADOBE COLDFUSION 8 45 Installing and Using ColdFusion 8 If you selected to install LiveCycle Data Services ES , the Map Resource References to resources panel appears. Enter wm/default as the target for the resource wm/MessagingWorkManager. 9 When the Map Virtual Hosts for Web Modules panel appears, select the virtual host or hosts in which to install the ColdFusion 8 application and Remote Development Services (RDS) support, and then click Next.
46 CHAPTER 5 Installing the J2EE Configuration 8 If you selected to install LiveCycle Data Services ES , the Map Resource References to resources panel appears. Enter wm/default as the target for the resource wm/MessagingWorkManager. 9 When the Map Virtual Hosts for Web Modules panel appears, select the virtual host or hosts in which to install the ColdFusion 8 application and Remote Development Services (RDS) support, and then click Next. RDS must be on the same virtual host and port as ColdFusion 8.
ADOBE COLDFUSION 8 47 Installing and Using ColdFusion 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. Configure search paths 1 Make a backup copy of the setupCmdLine.bat file, located in the websphere_root\AppServer\bin directory.
48 CHAPTER 5 Installing the J2EE Configuration 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%\AdobeColdFusion8.ear\cfusion.ear\cfus ion.war\WEBINF\cfusion\jintegra\bin;%WAS_HOME%\installedApps\%WAS_CELL%\Adobe_ColdFusion_8.ear\c fusion.
ADOBE COLDFUSION 8 49 Installing and Using ColdFusion CF_APPS_PATH=cf_webapp_root/WEB-INF/cfusion/lib Replace cf_webapp_root with the path to your web application root directory; for example: CF_APPS_PATH="$WAS_HOME"/installedApps/"$WAS_CELL"/ Adobe_ColdFusion_8.ear/cfusion.war/WEB-INF/cfusion/lib 3 Append the CF_APPS_PATH environment variable to the LD_LIBRARY_PATH entry.
50 CHAPTER 5 Installing the J2EE Configuration 1 Stop ColdFusion. 2 In the WebSphere Administrative Console, select the Applications > Enterprise Applications panel, select the Adobe ColdFusion 8 application, and then click Stop. 3 Do the following in both the cf_webapp_root\WEB-INF\web.xml and the websphere_root\AppServer\config\cells\NodeName\applications\cf_application_name.ear\ deployments\cf_application_name\cfusion.war\WEB-INF\web.xml files (or the equivalent paths in UNIX).
ADOBE COLDFUSION 8 51 Installing and Using ColdFusion b Stop the Adobe ColdFusion 8 application if it is running. c Select Adobe ColdFusion 8 Application, select Manage Modules and then select the check box for ColdFusion RDS application, and then click Remove. Enable web services To enable web services, you must copy the tools.jar file from the websphere/appserver/java/lib directory to the cfusion/lib directory.
52 CHAPTER 5 Installing the J2EE Configuration Deploying ColdFusion 8 on BEA WebLogic The following instructions tell you how to deploy ColdFusion 8 on BEA WebLogic 7, 8.1, 9.2, and 10. You can deploy ColdFusion 8 on BEA WebLogic using either an expanded EAR file or WAR files. The following terms refer toJRun and ColdFusion directories: cfmx_install_directory The directory that contains the files extracted by the ColdFusion install, for example, C:\cf8 or /opt/cf8.
ADOBE COLDFUSION 8 53 Installing and Using ColdFusion java_home/bin/jar -xvf ../rds.war 4 Open the weblogic.policy file. On WebLogic 10, the file is located in the BEA_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: ... // default permissions granted to all domains grant { permission java.security.AllPermission; /* permission java.util.
54 CHAPTER 5 Installing the J2EE Configuration • 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.
ADOBE COLDFUSION 8 55 Installing and Using ColdFusion 5 Save the startup script and restart the WebLogic Server. Enable access to Verity binary files 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 the following variables: • CF_SHARED_LIBS • LD_LIBRARY_PATH For example: # Set up shared library path for ColdFusion to pick up Verity # shared libs.
56 CHAPTER 5 Installing the J2EE Configuration 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:\BEA_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.
ADOBE COLDFUSION 8 57 Installing and Using ColdFusion Deploying ColdFusion 8 on Oracle Application Server 10g The following instructions assume that you installed the J2EE configuration of ColdFusion 8 and that the EAR file to deploy is under C:\ColdFusion_J2ee\cfusion.ear. Before you deploy ColdFusion on Oracle 10g, ensure that the following is true: • Oracle Application Server 10g is installed and running. • You set up an OC4J J2EE container for the ColdFusion installation.
58 CHAPTER 5 Installing the J2EE Configuration 3 Under the Environment Variables category, select Add Environment Variable. 4 Enter PATH as the name. 5 Enter $ORACLE_HOME\j2ee\ oc4j_instance\applications\ cf_app\cfusion\WEB-INF\cfusion\lib; as the value. 6 Ensure that the Append option is selected. 7 Select Apply. 8 When the Enterprise Manager prompts you to restart, select the restart option.
ADOBE COLDFUSION 8 59 Installing and Using ColdFusion 5 Select Apply. 6 When the Enterprise Manager prompts you to restart, select the restart option. 7 In some cases, you might also have to do the following to register the Microsoft Type viewer: a Open a console window and go to cf_webapp_root\WEB-INF\cfusion\lib. b Register TypeViewer.dll by issuing the following command: regsvr32 TypeViewer.
60 CHAPTER 5 Installing the J2EE Configuration 6 Apply the changes. 7 Restart the OC4J instance. You can enable the RDS web module by repeating this procedure and selecting the Enabled option. Deploying ColdFusion 8 on JBoss Application Server ColdFusion 8 supports JBoss with the following specifications:J • JBoss 4.0.5 (uses Tomcat 5.5 Server Container) • Sun JRE 1.4.2_09, Sun JRE 1.5, and Sun JRE 1.
ADOBE COLDFUSION 8 61 Installing and Using ColdFusion java_home/bin/jar -xvf ../cfusion.ear This expands the cfusion.ear file into cfusion.war and rds.war (rds.war is not included if you specified a context root of / when you ran the installation wizard). c In cfusion-ear, create a directory named cfusion-war. md cfusion-war (mkdir cfusion-war on UNIX) d Change to the cfusion-war directory and expand the cfusion.war file with the jar command: cd cfusion-war java_root/bin/jar -xvf ../cfusion.
62 CHAPTER 5 Installing the J2EE Configuration To avoid this issue, edit run.sh and add the following parameters in the JVA_OPTS arguments -Djava.security.manager -Djava.security.policy="cf_root/WEB-INF/cfusion/lib/coldfusion.policy" -Djava.security.auth.policy="cf_root/WEB-INF/cfusion/lib/neo_jaas.policy" This document uses the following conventions: JBOSS_HOME Directory where JBoss is installed, for example, C:\jboss-4.0.5SP1 in Windows or /usr/local/jboss- 4.0.5.
ADOBE COLDFUSION 8 63 Installing and Using ColdFusion 10 (Windows) Edit the JBOSS_HOME\bin\run.bat file by doing the following: a If not present, add the JVM GC (-Xmx512m) parameter to JAVA_OPTS. b Ensure that the permanent generation heap size is set by adding -XX:MaxPermSize=128m to JAVA_OPTS. Without this parameter, the JVM can generate a java.lang.OutOfMemoryError error. For more information, see (http://wiki.jboss.org/wiki/Wiki.jsp?page=PermanentGeneration). c Save the run.bat file.
64 CHAPTER 5 Installing the J2EE Configuration export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:CF_WEBAPP_ROOT/WEB-INF/cfusion/lib 3 Save the file and start the server. Enable COM support (Windows only) 1 Ensure that JBoss Server is stopped. 2 Edit JBOSS_HOME\bin\run.bat by adding the following: 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.
ADOBE COLDFUSION 8 65 Installing and Using ColdFusion Undeploying ColdFusion To undeploy ColdFusion in the J2EE configuration, you use application-server specific undeploy tools and methods. 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.
66 CHAPTER 5 Installing the J2EE Configuration
67 Chapter 6: Installing Integrated Technologies ColdFusion 8 provides integration capabilities with several Adobe and third-party technologies. In some cases, you can install these components when you install ColdFusion 8. In other cases, you might have to follow some steps outside of the ColdFusion installation. Contents Integrated Adobe and third-party technologies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
68 CHAPTER 6 Installing Integrated Technologies 2 Double-click the filename. Install ColdFusion Extensions for Dreamweaver MX 2004 1 Make a backup copy of the configuration/taglibraries/content/codehints folder and its contents. 2 Download the cf8dreamweaverextensions.mxp from the Adobe website. 3 Double-click the cf8dreamweaverextensions.mxp file. Installing HomeSite+ Extensions You can update HomeSite+ to include all the new and updated tags and functions in ColdFusion 8.
ADOBE COLDFUSION 8 69 Installing and Using ColdFusion f Save booktree.xml. 4 Restart HomeSite+. Installing Report Builder ColdFusion reporting consists of server-side run-time processing and the ColdFusion Report Builder. The serverside processing is available on any platform, however, the ColdFusion Report Builder runs in Windows only.
70 CHAPTER 6 Installing Integrated Technologies The IP address is necessary only if you are installing Verity search server on a different computer from the one where you installed ColdFusion. If you do not specify an IP address, the Installer uses the default 127.0.0.1, which is localhost. Install the Verity search server separately 1 Download your platform-specific installer from the Adobe website at www.adobe.
ADOBE COLDFUSION 8 71 Installing and Using ColdFusion Enable Flash Remoting to access web services through ColdFusion 8 1 Open the cf_root/WEB-INF/gateway-config.xml file in a text editor. 2 Locate the following line. 3 Remove the comments so that the line appears as follows. coldfusion.flash.adapter.CFWSAdapter 4 Save the file. 5 Restart ColdFusion.
72 CHAPTER 6 Installing Integrated Technologies Installing Adobe LiveCycle Data Services ES You can install LiveCycle Data Services ES as part of the ColdFusion 8 installation. However, you could install LiveCycle Data Services ES on a different computer. For more information about using LiveCycle Data Services ES with ColdFusion, see ColdFusion Developer’s Guide. Installing the ColdFusion .NET Integration Services You install Adobe ColdFusion 8 .NET Integration Service to access .
ADOBE COLDFUSION 8 73 Installing and Using ColdFusion Installing using the ColdFusion 8 .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.
74 CHAPTER 6 Installing Integrated Technologies 4 Select the Search For New Features To Install option, and then click Next. 5 Click New Archive Site. 6 Navigate to the location where you downloaded the ColdFusion_FlexBuilder_Feature.zip file, select the file, and then click Open. 7 When the Edit Local Site dialog box appears, click OK. 8 Ensure that the ColdFusion Flex Builder feature is selected, and then click Finish. 9 Select the check box next to ColdFusion_FlexBuilder_Feature.
75 Chapter 7: 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:\ColdFusion8 in Windows, and /opt/coldfusion8 in UNIX. Jrun_root refers your installation directory in the multiserver configuration.
76 CHAPTER 7 Configuring Your System Configuration task When to do it “Disabling Remote Development Services” on page 91 For security reasons, disable RDS when you move an application to the production environment. “Disabling JSP functionality (server configuration only)” on page 92 When running ColdFusion Enterprise Edition in a hosted environment, you might want to disable JSP processing.
ADOBE COLDFUSION 8 77 Installing and Using ColdFusion Note: In the ColdFusion Administrator, if you enable or disable security or change any option in the Java and JVM Settings page, you must stop and restart ColdFusion 8 for your changes to take effect. This applies to the server configuration only; in the multiserver and J2EE configurations, you use application-server-specific methods to update Java settings.
78 CHAPTER 7 Configuring Your System 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, you must stop and restart the ColdFusion process for your changes to take effect.
ADOBE COLDFUSION 8 79 Installing and Using ColdFusion 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, you must stop and restart the ColdFusion process for your changes to take effect.
80 CHAPTER 7 Configuring Your System For more information on the Web Server Configuration Tool, including information on multihoming and distributed usage, see Configuring and Administering ColdFusion. 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.
ADOBE COLDFUSION 8 81 Installing and Using ColdFusion Note: Omitting the previous step causes your web server to serve ColdFusion source code. 6 Copy the CFIDE and cfdocs directories from cf_root/wwwroot to your web server root directory. In addition, copy your application’s CFM pages from cf_root/wwwroot to your web server root directory. In the multiserver configuration, these files are under the jrun_root/servers/cfusion/cfusion-ear/cfusion-war directory.
82 CHAPTER 7 Configuring Your System a Right-click the JRunScripts directory and select Properties. b In the Properties dialog box, on the Virtual Directories tab, verify that the Local Path text box contains the following path: path/wsconfig/number (typically 1) Configuring SunONE Web Server or iPlanet web server in Windows You configure SunONE Web Server 6 or iPlanet web server 6.
ADOBE COLDFUSION 8 83 Installing and Using ColdFusion 3 Verify that the following was added to the file: PathCheck fn=find-index {check index.cfm is added} PathCheck fn="jrunfilter" ObjectType fn=type-by-exp exp={*.cfm, *.cfc, *.cfswf, *.jsp, *.jws, *.cfr} type="jruninternal/ext" Service method=(GET|HEAD|POST) type="jrun-internal/*" fn="jrunservice" Configuring Apache web server in Windows You configure Apache by using the Web Server Configuration Tool in GUI or command-line mode.
84 CHAPTER 7 Configuring Your System In the multiserver configuration, this file is located under jrun_root/lib/wsconfig. 2 Open the Apache configuration file, httpd.conf, in your Apache conf directory. In Windows, the default is C:\Program Files\Apache Group\Apache\conf\httpd.conf. 3 Verify that the following code is appended to this file (except that if you are using Apache 2.2, the file name is mod_jrun22.so): # JRun Settings LoadModule jrun_module "c:/ColdFusion8/runtime/lib/wsconfig/1/mod_jrun.
ADOBE COLDFUSION 8 85 Installing and Using ColdFusion The following is a sample command: /opt/coldfusion8/runtime/bin/wsconfig -server coldfusion -ws Apache -dir /etc/httpd/conf-coldfusion -v Note: For unique configurations (such as the preconfigured Apache web servers from Redhat or Sun), add the bin and -script parameters, as described in Configuring and Administering ColdFusion. 2 Copy the CFIDE and cfdocs directories from cf_root/wwwroot to your web server root directory.
86 CHAPTER 7 Configuring Your System Configure Netscape or iPlanet for ColdFusion in UNIX 1 Enter the following command on a single line: wsconfig -server servername -ws sunone | iplanet | nes -dir path_to_config-coldfusion -v Note: You must enter the previous command as a single (long) line. Specify sunone, iplanet or nes.
ADOBE COLDFUSION 8 87 Installing and Using ColdFusion 4 Select the Configure Web Server For ColdFusion Applications option and click Add. 5 Edit both the magnus.conf file and the obj.conf file (located in the sun_install_dir/server_instance/conf directory) by commenting lines that contain j2ee. 6 Go to the sun_install_dir/bin directory. 7 Execute the following command: .
88 CHAPTER 7 Configuring Your System b In your browser, go to the following location on the Adobe website: www.adobe.com/go/verity, enter your ColdFusion license key, download the appropriate Verity Locales package, and then save it to the [verity]/k2/common directory. For example, if Verity is installed with the server configuration, the location is cf_root/verity/k2/common; if Verity is installed separately and you use the default, the location is C:\coldfusionverity\k2\common. • verity_asian_locales.
ADOBE COLDFUSION 8 89 Installing and Using ColdFusion Installing Visibroker for CORBA connections Install 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.
90 CHAPTER 7 Configuring Your System org.omg.CORBA.ORBSingletonClass=com.inprise.vbroker.orb.ORB SVCnameroot=namingroot d When you finish editing the page, click Submit. The CORBA Connectors page appears. e Select the radio button to the left of your new CORBA connector and click Select ORB Connector. This sets the new connector to be the default.
ADOBE COLDFUSION 8 91 Installing and Using ColdFusion Disabling Remote Development Services If you use Adobe Dreamweaver, Macromedia HomeSite, Adobe Flex 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.
92 CHAPTER 7 Configuring Your System Disabling JSP functionality (server configuration only) 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 of 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.
ADOBE COLDFUSION 8 93 Installing and Using ColdFusion Changing the ColdFusion user account in Windows 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 privileges needed to run the web application (for example, folder permissions for the web root.) Change the ColdFusion user account 1 Open the Services Control Panel.
94 CHAPTER 7 Configuring Your System
95 Chapter 8: 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.. Contents Common installation problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 Data source problems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
96 CHAPTER 8 Troubleshooting 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.
ADOBE COLDFUSION 8 97 Installing and Using ColdFusion 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 http://www.adobe.com/cfusion/knowledgebase/index.cfm?id=tn_19518.
98 CHAPTER 8 Troubleshooting 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 8 > Web Server Configuration Tool; also, try using the built-in server, using port 8500. For more information, see “Configuring web servers” on page 79.
ADOBE COLDFUSION 8 99 Installing and Using ColdFusion Solution: You must remove McAfee Privacy Service. 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.
100 CHAPTER 8 Troubleshooting 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 that, 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.
ADOBE COLDFUSION 8 101 Installing and Using ColdFusion Installation fails Problem: On UNIX and Linux systems, when you try to install ColdFusion 8 on systems where the /tmp partition is mounted noexec, the installation fails. Solution: This is because the install attempts to use the /tmp directory for unpacking and running the installer run time. To avoid this issue, set the IATEMPDIR environment variable to a directory on the system that has execute permissions before running the installer.
102 CHAPTER 8 Troubleshooting Solution: If you plan to use Verity or 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 grep command as a filter or query the exact package name. For example, the command rpm -qa | grep compat-libstdc++ queries all packages and filters or greps on the string compat-libstdc++. This command might produce two results, compat-libstdc++-33-3.2.3-47.
ADOBE COLDFUSION 8 103 Installing and Using ColdFusion Virtual mapping resource path of /* does not work Problem: You add a virtual mapping resource path of /* which does not work. Solution: Do not map any directories to wildcard resource paths that contain WEB-INF as a virtual mapping. In ColdFusion MX 6.1, the fact that this worked was a side-effect of the particular way the classloader was configured.
104 CHAPTER 8 Troubleshooting
105 Index A D Adobe Flex 70 deployment Apache web server IIS app server differences 30 configuring in UNIX 84 configuring in Windows 83 I configuring 80 app server mechanisms 37 directory structure IIS6 81 installation wizard, starting 10 application isolation 19, 29 EAR 28 installer, Java-only 6 application.
106 undeploying 65 O This 11 UNIX install 32, 34 Oracle Application Server 10g 57 troubleshooting, log file 6 J2EE servers, third-party 4 P U java.lang.
ADOBE COLDFUSION 8 107 Installing and Using ColdFusion built-in 5, 13 configuring overview 79 IIS 80 internal 13 iPlanet in Windows 82 iPlanet on UNIX 85 SunONE in Windows 82 SunONE on UNIX 85 switching 88 WebLogic 52 WebSphere Application Server 42 WebSphere ND 45 Windows installation considerations 5 installing in 9 installing multiserver configuration in 20 managing services in 76
108
