Adobe 38043740 - ColdFusion Standard - Mac User Manual
Adobe 38043740 - ColdFusion Standard - Mac User Manual

Adobe 38043740 - ColdFusion Standard - Mac User Manual

User guide
Hide thumbs Also See for 38043740 - ColdFusion Standard - Mac:
Table of Contents

Advertisement

Quick Links

ADOBE
COLDFUSION
8
®
INSTALLING AND USING COLDFUSION

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the 38043740 - ColdFusion Standard - Mac and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for Adobe 38043740 - ColdFusion Standard - Mac

  • Page 1 ADOBE COLDFUSION ® ™ INSTALLING AND USING COLDFUSION...
  • Page 2 Adobe Systems Incorporated. Please note that the content in this guide is protected under copyright law even if it is not distributed with software that includes an end user license agreement.
  • Page 3: Table Of Contents

    Chapter 6: Installing Integrated Technologies Integrated Adobe and third-party technologies ......... . . 67...
  • Page 4 Installing Flash Remoting Update ............71 Installing Adobe LiveCycle Data Services ES .
  • Page 5: Chapter 1: Introduction

    (PDF) files. Go to the documentation home page for ColdFusion on the Adobe website: www.adobe.com/support/documentation/en/coldfusion/. Also, you can view the documentation in LiveDocs, which lets you add comments to pages and view the latest comments added by Adobe, by going to www.adobe.com/go/livedocs_cf8docs.
  • Page 6 CHAPTER 1 Introduction...
  • Page 7: Chapter 2: Preparing To Install Coldfusion

    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 .
  • Page 8: Coldfusion 8 Product Editions

    For information on installing the J2EE configuration, see “Installing the J2EE Configuration” on page 25. ColdFusion 8 product editions The ColdFusion 8 product editions are available on the Adobe website. To view the product editions, go to www.adobe.com/go/cf8_editions/. System requirements The ColdFusion 8 system requirements are available on the Adobe website.
  • Page 9 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 2000 or Microsoft Windows 2003 stand-alone systems.
  • Page 10 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.
  • Page 11: Chapter 3: Installing The Server Configuration

    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.
  • Page 12 ___ .NET Integration Services ___ ColdFusion 8 Documentation ___ LiveCycle Data Services ES ColdFusion installation directory? ___________________________________________________ Serial number for Adobe LiveCycle Data ___________________________________________________ Services Enterprise Suite (ES)? (Only if you selected to install the Enterprise Edition of LiveCycle Data Services ES) If you leave this blank, the installer installs the Express Edition.
  • Page 13: Installing Coldfusion Using The Server Configuration

    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. Ensure that your operating system meets the system requirements described on the Adobe website at www.adobe.com/go/cf8_sysreqs. Review “Installation considerations for Windows” on page 5 and “Installation considerations for all platforms”...
  • Page 14 If you plan to configure an external web server, ensure that the web server is running. Log in as root. 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.
  • Page 15 Open ColdFusion Administrator to run the Configuration Wizard. Configure and manage your system, as described in “Configuring Your System” on page 75. To install any other integrated Adobe or third-party technologies, see “Installing Integrated Technologies” on page 67. To learn about ColdFusion, read the documentation, which is accessible through the Documentation link on...
  • Page 16: Coldfusion Server Configuration Directory Structure

    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 Programs for starting, stopping, and viewing information for ColdFusion, and to run Crystal Reports (Windows only).
  • Page 17: Using The Built-In Web Server

    ColdFusion has its own web server that you can use to develop ColdFusion applications, without depending on an external web server, such as Internet Information Server (IIS), Apache, or SunONE. Adobe does not recommend using the built-in web server in a production environment. However, it is more than suitable for development, allowing you to create virtual directories and set the default document (for example, default.cfm or...
  • Page 18: Switching From Another Web Server

    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. Open the original jrun.xml file for editing. Change the port number specified in the WebService port attribute (near the bottom of the file): <service class="jrun.servlet.http.WebService"...
  • Page 19: Uninstalling Coldfusion

    If you switch from the built-in web server to an external web server, you must copy the contents of the cf_root/wwwroot directory to your web server root. If you are using Adobe Dreamweaver, ensure that you reconfigure any sites that you move from one server to another.
  • Page 20 CHAPTER 3 Installing the Server Configuration Enter the following command: ./uninstall.sh When the program completes, remove any remaining files and directories in the cf_root directory. ColdFusion is deleted from your server.
  • Page 21: Chapter 4: Installing The Multiserver Configuration

    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 .
  • Page 22 ___ .NET Integration Services ___ ColdFusion 8 Documentation ___ LiveCycle Data Services ES JRun installation directory? ___________________________________________________ Serial number for Adobe LiveCycle Data ___________________________________________________ Services ES? (Only if you selected to install the Enterprise Edition of LiveCycle Data Services ES) If you leave this blank, the installer installs the Express Edition.
  • Page 23: About Multiserver Configuration

    Whether to enable RDS? ___ Yes ___ No Note: RDS allows the server to interact with remotely connected developers. Adobe recommends that you disable RDS for produc- tion servers. Disabling RDS also disables the directory browsing applets in the ColdFusion Administrator. RDS password?
  • Page 24: Installing Coldfusion Using The Multiserver Configuration

    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. Ensure that your operating system meets the system requirements described on the Adobe website at www.adobe.com/go/cf8_sysreqs. Review the “Installation considerations for Windows” on page 5 and “Installation considerations for all platforms”...
  • Page 25 Open the ColdFusion Administrator to configure the server. Configure and manage your system, as described in “Configuring Your System” on page 75. To install any other integrated Adobe or third-party technologies, see “Installing Integrated Technologies” on page 67. To learn about ColdFusion, read the documentation, which is accessible through the Documentation link on the Resources page of the ColdFusion Administrator.
  • Page 26 17. Log in as root. 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: coldfusion-80-lin.bin...
  • Page 27: Configuration

    ADOBE COLDFUSION 8 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.
  • Page 28: Uninstalling Coldfusion

    The steps for uninstalling ColdFusion depend on your operating system. Uninstall ColdFusion from Windows Select Start > Settings > Control Panel > Add/Remove Programs > Adobe ColdFusion 8 with JRun 4. Click Change/Remove. When the program completes, remove any remaining files and directories in the cf_webapp_root directory.
  • Page 29: Chapter 5: Installing The J2Ee Configuration

    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.
  • Page 30 Whether to enable RDS? ___ Yes ___ No Note: RDS allows the server to interact with remotely connected developers. Adobe recommends that you disable RDS for produc- tion servers. Disabling RDS also disables the directory browsing applets in the ColdFusion Administrator. RDS password?
  • Page 31: Coldfusion And J2Ee Application Servers

    ADOBE COLDFUSION 8 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 configu- ration) or deploy it as a Java application on a standards-based J2EE application server (multiserver configuration and J2EE configuration).
  • Page 32 CHAPTER 5 Installing the J2EE Configuration Contains the ColdFusion and RDS redirector web applications. An enter- Enterprise application archive file prise application archive (also called an EAR) uses a directory structure that contains a META-INF/appli- cation.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.
  • Page 33 ADOBE COLDFUSION 8 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 default- ear/META-INF/application.xml file.
  • Page 34: Preparing To Install Using The J2Ee Configuration

    JRun server. For installation details, see “Installing ColdFusion using the multiserver configuration” on page 20. Adobe recommends this configuration option if JRun or another J2EE application server is not already installed on the computer and you plan to use JRun 4 instead of another J2EE application server.
  • Page 35 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. Ensure that your operating system meets the system requirements described on the Adobe website at www.adobe.com/go/cf8_sysreqs. Review the “Installation considerations for Windows” on page 5 and “Installation considerations for all platforms”...
  • Page 36 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. Ensure that your operating system meets the system requirements described on the Adobe website at www.adobe.com/go/cf8_sysreqs. Review the “Installation considerations for UNIX” on page 6 and “Installation considerations for all platforms”...
  • Page 37 ADOBE COLDFUSION 8 Installing and Using ColdFusion 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.
  • Page 38 25. Log in as root. 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:...
  • Page 39 ADOBE COLDFUSION 8 Installing and Using ColdFusion coldfusion-80-osx.zip - To install in Mac OS X. Using the command, go to the directory with the installation file. 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.
  • Page 40: Updating From An Earlier Version For J2Ee

    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.1 J2EE configuration, or the ColdFusion MX 7 J2EE configuration on your application server, you must also perform the following steps as part of the installation procedure: 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.
  • Page 41: Coldfusion J2Ee Deployment And Configuration

    ADOBE COLDFUSION 8 Installing and Using ColdFusion ColdFusion J2EE deployment and configuration The J2EE specification allows application servers to handle compressed and expanded deployments in a server- dependent manner; each application server has its own deployment and configuration mechanism, as the...
  • Page 42 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.
  • Page 43 ADOBE COLDFUSION 8 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”...
  • Page 44 CHAPTER 5 Installing the J2EE Configuration Change the element from cfusion.war to cfusion-war (or the name of the directory that contains the web-uri expanded cfusion.war file). Change the element for rds.war to rds-war. A directory name in the web-uri web- element cannot contain a dot.
  • Page 45 ADOBE COLDFUSION 8 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.
  • Page 46 CHAPTER 5 Installing the J2EE Configuration com.gp.java2d.ExHeadlessGraphicsEnvironment instead of com.gp.java2d.ExGraphicsEnvironment In addition to enabling sandbox security in the ColdFusion Administrator, the application server must be running a security manager ( ) and you must define the following JVM arguments: java.lang.SecurityManager -Djava.security.manager -Djava.security.policy="cf_webapp_root/WEB-INF/cfusion/lib/coldfusion.policy"...
  • Page 47 ADOBE COLDFUSION 8 Installing and Using ColdFusion The root directory of your Java 2 software development kit (J2SDK); for example, C:\j2sdk1.4.1. java_home When you deploy ColdFusion on an existing version of IBM WebSphere, you must expand the EAR file or WAR files manually before deployment.
  • Page 48 CHAPTER 5 Installing the J2EE Configuration Change the element from cfusion.war to cfusion-war (or the name of the directory that contains the web-uri expanded cfusion.war file). Change the element for rds.war to rds-war. A directory name in the web-uri web-uri element cannot contain a dot.
  • Page 49 When the Summary panel appears, review the installation configuration, and then click Finish. When the Application Adobe ColdFusion 8 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.
  • Page 50 When the Summary panel appears, review the installation configuration, and then click Finish. When the Application Adobe ColdFusion 8 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.
  • Page 51 ADOBE COLDFUSION 8 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 Make a backup copy of the setupCmdLine.bat file, located in the websphere_root\AppServer\bin directory.
  • Page 52 The path specifications in these instructions assume that you deployed ColdFusion using the standard appli- cation name (Adobe ColdFusion 8) and did not rename the application. Open the original file, and in the PLATFORM case block, just above the LD_LIBRARY_PATH or LIBPATH...
  • Page 53 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 8, you can disable it at a later time, as the following instructions describe.
  • Page 54 Installing the J2EE Configuration Stop ColdFusion. In the WebSphere Administrative Console, select the Applications > Enterprise Applications panel, select the Adobe ColdFusion 8 application, and then click Stop. 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\ deploy- ments\cf_application_name\cfusion.war\WEB-INF\web.xml files (or the equivalent paths in UNIX). For...
  • Page 55 ADOBE COLDFUSION 8 Installing and Using ColdFusion Stop the Adobe ColdFusion 8 application if it is running. 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...
  • Page 56 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: The directory that contains the files extracted by the ColdFusion install, for example, cfmx_install_directory...
  • Page 57 Review the console messages and server log to ensure that ColdFusion 8 deployed successfully. Start the ColdFusion Administrator, which runs the Configuration Wizard. To install any other integrated Adobe or third-party technologies, see “Installing Integrated Technologies” on page 67. Configure and manage your system, as described in “Configuring Your System” on page 75.
  • Page 58 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 Save the startup script and restart the WebLogic Server. Enable COM support for Windows Open the startup script for the WebLogic domain, which is typically the startWebLogic cmd file, which is located in the wldomain_root\bin directory.
  • Page 59 ADOBE COLDFUSION 8 Installing and Using ColdFusion Save the startup script and restart the WebLogic Server. Enable access to Verity binary files in UNIX Open the startup script for the WebLogic domain, which is typically the startWebLogic.sh file, which is located in the wldomain_root\bin directory.
  • Page 60 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 Save the startup script and restart the WebLogic Server. Enable ColdFusion security and graphing support in UNIX Open the startup script for the WebLogic domain, which is typically the startWebLogic.sh file, which is located in the wldomain_root\bin directory.
  • Page 61 Before you deploy ColdFusion on Oracle 10g, ensure that the following is true: Oracle Application Server 10g is installed and running. You set up an OC4J J2EE container for the ColdFusion installation. Adobe recommends that you create an OC4J instance for ColdFusion to avoid potential classpath issues with other applications.
  • Page 62 CHAPTER 5 Installing the J2EE Configuration Under the Environment Variables category, select Add Environment Variable. Enter PATH as the name. Enter $ORACLE_HOME\j2ee\ oc4j_instance\applications\ cf_app\cfusion\WEB-INF\cfusion\lib; as the value. Ensure that the Append option is selected. Select Apply. When the Enterprise Manager prompts you to restart, select the restart option. Configure operating system-specific binary support for Solaris and Linux Connect to Oracle AS 10g using Enterprise Manager.
  • Page 63 Dreamweaver and earlier versions of HomeSite, do not work. In the Oracle AS 10g Enterprise Manager, select oc4j_instance /Applications. Select Adobe ColdFusion 8 application and select Edit. In the Administration category, select Advanced Properties. In the Configuration Files category, select orion-application.xml.
  • Page 64 CHAPTER 5 Installing the J2EE Configuration Apply the changes. 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.6 Host OS - Windows 2003 server SP1 and RH Linux 4 AS...
  • Page 65 ADOBE COLDFUSION 8 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). In cfusion-ear, create a directory named cfusion-war.
  • Page 66 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: Directory where JBoss is installed, for example, C:\jboss-4.0.5SP1 in Windows or /usr/local/jboss- JBOSS_HOME 4.0.5.SP1 on UNIX Application deployment directory in JBoss, for example, C:\jboss-...
  • Page 67 ADOBE COLDFUSION 8 Installing and Using ColdFusion (Windows) Edit the JBOSS_HOME\bin\run.bat file by doing the following: If not present, add the JVM GC ( ) parameter to JAVA_OPTS. -Xmx512m 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.
  • Page 68 CHAPTER 5 Installing the J2EE Configuration export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:CF_WEBAPP_ROOT/WEB-INF/cfusion/lib Save the file and start the server. Enable COM support (Windows only) Ensure that JBoss Server is stopped. Edit JBOSS_HOME\bin\run.bat by adding the following: set CF_LIB_PATH=%CF_LIB_PATH%;CF_WEBAPP_ROOT\WEB- INF\cfusion\jintegra\bin;CF_WEBAPP_ROOT\WEB-INF\cfusion\jintegra\bin\international 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.
  • Page 69: Undeploying Coldfusion

    Undeploy the ColdFusion web application, by using application-server-specific undeploy functionality. In JRun 4, you undeploy by deleting the jrun_root/server/servername/cfusion-ear directory. On Oracle 10g, using Enterprise Manager, go to oc4j_instance /Applications, select Adobe ColdFusion 8 application, and then select Undeploy. Return to the Enterprise Manager home page, go to oc4j_instance /Administration/Server Properties, select the PATH variable containing the following, and select Remove: $ORACLE_HOME\j2ee\oc4j_instance\applications\cf_app\cfusion\WEB-INF\cfusion\lib;...
  • Page 70 CHAPTER 5 Installing the J2EE Configuration...
  • Page 71: Chapter 6: Installing Integrated Technologies Integrated Adobe And Third-Party Technologies

    Integrated Adobe and third-party technologies ........
  • Page 72: Installing Homesite+ Extensions

    Double-click the filename. Install ColdFusion Extensions for Dreamweaver MX 2004 Make a backup copy of the configuration/taglibraries/content/codehints folder and its contents. Download the cf8dreamweaverextensions.mxp from the Adobe website. 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.
  • Page 73: Installing Report Builder

    You should start by planning the answers to questions asked by the Installer: "Where would you like to install?" _______________________________ Adobe recommends that you specify a location that is not a subdirectory of the application server directories. The IP address of the ColdFusion Server from which this machine will accept requests __________________...
  • Page 74: Enabling Flash Remoting

    SUSE 10 - compat-libstdc++-5.0.7-22.2 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 8. To develop applications that use Flash Remoting, you must install the Flash Remoting components in the Flash authoring environment.
  • Page 75: Installing Flash Remoting Update

    For more information on Flash Remoting, see the ColdFusion Developer’s Guide. Installing Flash Remoting Update Flash Remoting Update lets you create rich Internet applications by using Adobe® Flex™ Builder™, with the advanced data retrieval features of ColdFusion, such as the c , and tags.
  • Page 76: Installing Adobe Livecycle Data Services Es

    Installing ColdFusion .NET Service separately If the .NET assemblies are on a remote computer, you use the .NET Service Installer to install Adobe Coldfusion 8 .NET Service. Similarly, to install the ColdFusion .NET Service when Coldfusion is already installed, you use...
  • Page 77: Installing Coldfusion Extensions For Eclipse

    Select Adobe ColdFusion .NET Service. Click Uninstall. Alternatively, you can uninstall the Adobe Coldfusion 8 .NET Service by running the Uninstall Adobe ColdFusion 8 .NET Integration Services.exe program. The program is located in the cf_root\jnbridge\uninstall directory on ColdFusion server configurations. On multiserver and J2EE configurations and on computers where you installed the Integration software without ColdFusion, it is in the C:\ColdFusionDotNetService\uninstall directory by default.
  • Page 78 CHAPTER 6 Installing Integrated Technologies Select the Search For New Features To Install option, and then click Next. Click New Archive Site. Navigate to the location where you downloaded the ColdFusion_FlexBuilder_Feature.zip file, select the file, and then click Open. When the Edit Local Site dialog box appears, click OK. Ensure that the ColdFusion Flex Builder feature is selected, and then click Finish.
  • Page 79: Overview Of Configuration Tasks

    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.
  • Page 80: Managing Coldfusion Services In Windows

    CHAPTER 7 Configuring Your System Configuration task When to do it “Disabling Remote Develop- For security reasons, disable RDS when you move an application to the produc- ment Services” on page 91 tion environment. “Disabling JSP functionality When running ColdFusion Enterprise Edition in a hosted environment, you might (server configuration only)”...
  • Page 81: Managing The Coldfusion Process In Unix

    ADOBE COLDFUSION 8 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 config- uration only;...
  • Page 82: Managing The Coldfusion Process In Mac Os X

    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.
  • Page 83: Configuring Web Servers

    ADOBE COLDFUSION 8 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.
  • Page 84 For more information, see the Web Server Management chapter in Configuring and Administering ColdFusion. Configure IIS for ColdFusion in Windows Start the Web Server Configuration Tool by selecting Start > Programs > Adobe > ColdFusion 8 > Web Server Configuration Tool.
  • Page 85 ADOBE COLDFUSION 8 Installing and Using ColdFusion Note: Omitting the previous step causes your web server to serve ColdFusion source code. 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.
  • Page 86 For more information, see the Web Server Management topic in Configuring and Administering ColdFusion. Configure SunONE or iPlanet for ColdFusion in Windows: Start the Web Server Configuration Tool by selecting Start > Programs > Adobe > ColdFusion 8 > Web Server Configuration Tool.
  • Page 87 For more information, see the Web Server Management topic in Configuring and Administering ColdFusion. Configure Apache for ColdFusion in Windows Start the Web Server Configuration Tool by selecting Start > Programs > Adobe > ColdFusion 8 > Web Server Configuration Tool.
  • Page 88 CHAPTER 7 Configuring Your System In the multiserver configuration, this file is located under jrun_root/lib/wsconfig. 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. 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.so"...
  • Page 89 ADOBE COLDFUSION 8 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.
  • Page 90 CHAPTER 7 Configuring Your System Configure Netscape or iPlanet for ColdFusion in UNIX 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 The following is a sample command:...
  • Page 91 ColdFusion lets you do Verity searches for languages other than English. For more information on Verity, see Configuring and Administering ColdFusion. This section describes how to install a Verity Locales package from the ColdFusion DVD or Adobe website, and how to switch to a different Verity Locales package.
  • Page 92: Enabling Corba Support

    CHAPTER 7 Configuring Your System 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;...
  • Page 93 ADOBE COLDFUSION 8 Installing and Using ColdFusion Installing Visibroker for CORBA connections Install Visibroker for CORBA connections Install Visibroker on the CORBA server side. For more information, see the Borland Visibroker documentation. Add the vbjorb.jar file to the ColdFusion classpath, as follows: In the ColdFusion Administrator, select Server Settings >...
  • Page 94 CHAPTER 7 Configuring Your System org.omg.CORBA.ORBSingletonClass=com.inprise.vbroker.orb.ORB SVCnameroot=namingroot When you finish editing the page, click Submit. The CORBA Connectors page appears. 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. Prepare your CORBA server side, as follows: Start your Visibroker osagent service or process, if it is not already running, by entering the following command:...
  • Page 95: Disabling Remote Development Services

    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, you must disable the RDSServlet mapping.
  • Page 96: Disabling Jsp Functionality (Server Configuration Only)

    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.
  • Page 97: 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 Open the Services Control Panel.
  • Page 98 CHAPTER 7 Configuring Your System...
  • Page 99: Common Installation Problems

    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.
  • Page 100 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: Start the download. Open the download window (Option-Command-L).
  • Page 101 ErrorString: file:C:/Temp/0971.tmp/savedURL.1:31: java.io.FileNotFoundException: C:\coldfusion8\ConnectorInstall0.txt.bat (Access is denied) If so, shut down IIS, and then run the Web Server Configuration Tool by selecting Start > Programs > Adobe > ColdFusion 8 > Web Server Configuration Tool. 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.
  • Page 102 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.
  • Page 103: Data Source Problems

    ADOBE COLDFUSION 8 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.
  • Page 104: Migration Problems

    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 tag, the following error is generated: cfupdate...
  • Page 105: J2Ee Configuration Problems

    ADOBE COLDFUSION 8 Installing and Using ColdFusion Installation fails Problem: On UNIX and Linux systems, when you try to install ColdFusion 8 on systems where the partition is /tmp mounted , the installation fails. noexec Solution: This is because the install attempts to use the directory for unpacking and running the installer run time.
  • Page 106: Postinstallation Problems

    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 command as a filter grep or query the exact package name.
  • Page 107: Uninstall Problems

    ADOBE COLDFUSION 8 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.
  • Page 108 CHAPTER 8 Troubleshooting...
  • Page 109: Index

    Index Adobe Flex 70 deployment Apache web server app server differences 30 configuring 80 configuring in UNIX 84 app server mechanisms 37 IIS6 81 configuring in Windows 83 directory structure installation wizard, starting 10 application isolation 19, 29 EAR 28 installer, Java-only 6 application.xml file, web-uri...
  • Page 110 undeploying 65 This 11 Oracle Application Server 10g 57 UNIX install 32, 34 troubleshooting, log file 6 Windows install 31 J2EE servers, third-party 4 platform-specific binary files 29 java.lang.SecurityManager 23, 42 undeploying 65 port Java-only installer 6 uninstalling 8300 20 jIntegra binary directories 41, 42 from Windows 15 JRun web server 20...
  • Page 111 ADOBE COLDFUSION 8 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...

This manual is also suitable for:

Coldfusion 8

Table of Contents