Summary of Contents for MACROMEDIA COLFUSION MX 7 - INSTALLING AND USING COLDFUSION MX
Page 1
COLDFUSION MX 7 ® Installing and Using ColdFusion MX...
Page 2
Other product names, logos, designs, titles, words, or phrases mentioned within this publication may be trademarks, service marks, or trade names of Macromedia, Inc. or other entities and may be registered in certain jurisdictions including internationally.
INTRODUCTION Installing and Using ColdFusion MX is intended for anyone who needs to install and configure Macromedia ColdFusion MX 7. About ColdFusion MX 7 documentation The ColdFusion MX 7 documentation is designed to provide support for the complete spectrum of participants.
Page 6
Document Format (PDF) files. Go to the documentation home page for ColdFusion MX on the Macromedia website: www.macromedia.com. In addition, you can view the documentation in LiveDocs, which lets you add comments to pages and view the latest comments added by Macromedia, by going to www.macromedia.com/go/livedocs_cfmx7docs.
CHAPTER 1 Preparing to Install ColdFusion MX 7 This chapter describes Macromedia ColdFusion MX 7 product editions, system requirements, and other high-level considerations. Before installing ColdFusion MX 7, you should review the information in this chapter and determine the answers to the questions in the section “Gathering...
You can install ColdFusion MX 7 in any of the following configurations: Server configuration Lets you install one instance of ColdFusion MX 7 with an embedded J2EE server. This configuration most closely resembles the ColdFusion MX base release and other releases prior to ColdFusion MX, such as ColdFusion 5 and ColdFusion 4.5.
Page 9
• Custom tags and ColdFusion Components. • Full support for server-side ActionScript and Macromedia Flash Remoting. • Extensibility and integration with Simple Object Access Protocol (SOAP) and Extensible Markup Language (XML), and with Component Object Model (COM), Enterprise Java Beans (EJBs), and Common Object Request Broker Architecture (CORBA).
Report Builder, you must install a trial or developer edition of ColdFusion MX 7. System requirements The ColdFusion MX 7 system requirements are available on the Macromedia web site. To view the system requirements, including a list of supported J2EE application servers, go to www.macromedia.com/go/sysreqscf.
“Using the built-in web server” on page • To interact with ColdFusion pages and components from a Macromedia Flash SWF file, use the Flash Remoting service in ColdFusion MX 7. To develop applications that use Flash Remoting, you must install the Flash Remoting components in the Flash MX authoring environment.
Page 12
This Java-only installer does not include features that require platform-specific binary files, such as Verity and C++ CFX support. • Macromedia does not recommend using Apple Mac OS X 10.3 in a production environment Chapter 1: Preparing to Install ColdFusion MX 7...
Gathering information necessary to install ColdFusion MX 7 Although the ColdFusion MX 7 installer provides an intuitive interface, it helps to plan your answers to the questions asked by the installer. Use the following table to help plan for installing ColdFusion MX 7.
Page 14
Do you want to enable Yes | No RDS? Note: RDS allows the server to interact with remotely connected developers. Macromedia recommends that you disable RDS for production servers. Disabling RDS also disables the directory browsing applets in the ColdFusion MX Administrator.
CHAPTER 2 Installing the Server Configuration This chapter describes how to install and uninstall ColdFusion MX 7 in the server configuration. The ColdFusion MX 7 server configuration contains an embedded copy of JRun and is most similar to previous ColdFusion versions. Note: In this chapter, cf_root refers to your installation directory.
Page 16
“Managing ColdFusion MX 7 services in Windows” on page Insert the CD or download the setup file from the Macromedia website. If the installation wizard does not start automatically when you insert the CD, locate the setup.exe file on the CD and double-click it. If you are installing from a network or a downloaded file, locate the ColdFusion MX 7 installation executable file (coldfusion-70- win.exe) and double-click it.
Page 17
To install the ColdFusion MX 7 server configuration on UNIX: Read the online version of the Release Notes for any late-breaking information or updates. For more information, see www.macromedia.com/go/proddoc_releasenotes. Ensure that your operating system meets the system requirements as described on the Macromedia web site at www.macromedia.com/go/sysreqscf.
Page 18
Log in as root. Copy the installation file that is appropriate for your platform and locale from the CD or Macromedia website, and save it to a directory on your local disk. The following are the installation files for supported server configuration platforms: coldfusion-70-lin.bin...
Go to the webroot/CFIDE/installers directory. The ColdFusion MX 7 CD Use the CD Browser to select the ColdFusion MX reporting option. The Macromedia web site Go to www.macromedia.com/go/cfmx7_reporting/. Double-click the CFReportBuilderInstaller.exe file. Follow the instructions in the installation. Installing the Verity search server separately By default, the installer installs the Verity search server on the same computer as ColdFusion MX 7.
ColdFusion MX 7 server configuration directory structure The following table describes the directories under the cf_root directory when you install the server configuration of ColdFusion MX 7: Directory Description Programs for starting, stopping, and viewing information for ColdFusion MX 7, and to run Crystal Reports (Windows only).
Internet Information Server (IIS), Apache, or SunONE. Macromedia 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 index.cfm).
Page 22
If you are using Macromedia Dreamweaver, be sure to reconfigure any sites that you move from one server to another.
Uninstalling ColdFusion MX 7 deletes all program files and related components from your computer. To uninstall ColdFusion MX 7 from Windows: Select Start > Settings > Control Panel > Add/Remove Programs > Macromedia ColdFusion MX7. Click Change/Remove. When the program completes, remove any remaining files and directories in the cf_root directory.
Page 24
Chapter 2: Installing the Server Configuration...
CHAPTER 3 Installing the Multiserver Configuration This chapter describes how to install Macromedia ColdFusion MX 7 in the multiserver configuration. Contents About multiserver configuration ..........25 Installing ColdFusion MX 7 using the multiserver configuration .
Note: The Windows installer requires a computer that supports at least 256 colors. To install the multiserver configuration in Windows: Read the online version of the Release Notes for any late-breaking information or updates. For more information, see www.macromedia.com/go/proddoc_releasenotes. Ensure that your operating system meets the system requirements described in “System requirements”...
Page 27
Insert the CD or download the setup file from the Macromedia website. If the installation wizard does not start automatically when you insert the CD, locate the setup.exe file on the CD and double-click it. If you are installing from a network or a downloaded file, locate the ColdFusion MX 7 installation executable file (coldfusion-70- win.exe) and double-click it.
Page 28
To install the multiserver configuration on UNIX: Read the online version of the Release Notes for any late-breaking information or updates. For more information, see www.macromedia.com/go/proddoc_releasenotes. Ensure that your operating system meets the system requirements described on the Macromedia web site at www.macromedia.com/go/sysreqscf. Review the “Installation considerations for UNIX”...
Go to the webroot/CFIDE/installers directory. The ColdFusion MX 7 CD Use the CD Browser to select the ColdFusion MX reporting option. The Macromedia web site Go to www.macromedia.com/go/cfmx7_reporting/. Double-click the CFReportBuilderInstaller.exe file. Follow the instructions in the installation. Installing the ColdFusion Report Builder...
To uninstall ColdFusion MX 7 from Windows: Select Start > Settings > Control Panel > Add/Remove Programs > Macromedia ColdFusion MX 7 with JRun 4. Click Change/Remove. When the program completes, remove any remaining files and directories in the cf_webapp_root directory.
CHAPTER 4 Installing the J2EE Configuration This chapter describes how to install, deploy, and undeploy Macromedia ColdFusion MX 7 Enterprise Edition in the J2EE configuration. It includes overview information, specific instructions for installing Macromedia JRun 4 (which automatically deploys and configures ColdFusion MX 7), and general instructions for use with all J2EE application servers.
Page 32
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 MX 7 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.
Page 33
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.
When you install the J2EE configuration, you have the following options: New installation—multiserver configuration Use this option to install a copy of Macromedia JRun 4 with ColdFusion MX 7 deployed and configured as an enterprise application in a JRun server. For installation details, see “Installing ColdFusion MX 7 using the multiserver...
Page 35
ColdFusion MX 7” on page 13 Close any applications that are currently running on your computer. Insert the CD or download the setup file from the Macromedia website. If the installation wizard does not start automatically when you insert the CD, locate the setup.exe file on the CD and double-click it.
Page 36
To install ColdFusion MX 7 on UNIX (J2EE configuration): Read the online version of the Release Notes for any late-breaking information or updates. For more information, see www.macromedia.com/go/proddoc_releasenotes. Ensure that your operating system meets the system requirements described on the Macromedia web site at www.macromedia.com/go/sysreqscf. Review the “Installation considerations for UNIX”...
Page 37
Using the command, go to the directory with the installation file. Start the installation with the following command: filename ./< > -i console The installation program starts. To use the coldfusion-70-other.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”...
Go to the webroot/CFIDE/installers directory. The ColdFusion MX 7 CD Use the CD Browser to select the ColdFusion MX reporting option. The Macromedia web site Go to www.macromedia.com/go/cfmx7_reporting/. Double-click the CFReportBuilderInstaller.exe file. Follow the instructions in the installation. Chapter 4: Installing the J2EE Configuration...
You should start by planning the answers to questions asked by the Installer: • "Where would you like to install?" _______________________________ Macromedia recommends that you specify a location that is not a subdirectory of the application server directories. • The IP address of the ColdFusion Server that this machine will accept requests...
Page 40
For basic deployment information, see your J2EE application server documentation. ColdFusion MX 7 deployment instructions differ for each J2EE application server. For up-to- date information on deploying ColdFusion MX 7 on a variety of J2EE application servers, see www.macromedia.com/go/cfmx7_j2eecert. For more information, see “Deployment” on page 40 “Configuration”...
Page 41
When you deploy ColdFusion MX 7 as a web application on an existing JRun server, you expand the cfusion.war file, deploy it, and optionally modify the context root. For complete information on deploying ColdFusion MX 7 on JRun 4 as a WAR file, see www.macromedia.com/go/ cfmx7_j2eecert. ColdFusion MX 7 J2EE deployment and configuration...
Page 42
Configuration After you deploy the ColdFusion MX 7 application, you define JVM arguments. Each J2EE application server has a different method for defining JVM arguments. Depending on your server, you can update variables in a batch file or shell script, define arguments in an administrative interface, modify the java.library.path JVM argument directly, or modify the system path directly.
Page 43
Additionally, certain application servers require that you disable server-specific policy-file permissions in order to enable the ColdFusion security manager. For more information, see the application-server-specific instructions at www.macromedia.com/go/cfmx7_j2eecert. If the version of the tools.jar file in your application server’s JRE is different from the version of the tools.jar file in the WEB-INF/cfusion/lib directory, you should rename or delete the WEB-...
Directory Description WEB-INF/cfusion/jintegra 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). WEB-INF/cfusion/lib and JAR, XML, property, and other files that are the foundation of WEB-INF/lib...
CHAPTER 5 Configuring Your System This chapter describes how to manage ColdFusion MX 7 services and processes, how to configure web servers manually, and how to change user accounts and configure databases for ColdFusion MX 7. Note: In this chapter, cf_root refers to your installation directory in the server configuration. By default, this directory is C:\CFusionMX7 in Windows, and /opt/coldfusionmx7 on UNIX.
Overview of configuration tasks The following table describes when to do the configuration tasks that are documented in this chapter: Configuration task When to do it “Managing You must stop and restart ColdFusion MX 7 after you enable or disable ColdFusion MX 7”...
Page 47
The multiserver configuration installation creates the following services in Windows 2000, Windows XP, and Windows 2003: Service Purpose Macromedia JRun Admin Runs the admin JRun server, used by the JRun Management Console Server (JMC). Macromedia JRun Runs the JRun cfusion server.
Page 48
To start or stop a ColdFusion service: Open the Services dialog box: In Windows 2000, Windows XP, or Windows 2003, select Start > Settings > Control Panel > Administrative Tools > Services. For other Windows platforms, see the Windows online Help. If a service is running, its status appears as Started in the Status column.
Note: If you cannot verify your configuration, repeat the procedure. If the problem persists, contact Macromedia 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 in this section).
Page 50
For more information, see the Web Server Management chapter in Configuring and Administering ColdFusion MX. To configure IIS for ColdFusion MX 7 in Windows: Start the Web Server Configuration Tool by selecting Start > Programs > Macromedia > ColdFusion MX 7 > Web Server Configuration Tool. Click Add.
Page 51
To verify your IIS configuration: Verify that the following file was created: cf_root/runtime/lib/wsconfig/jrun.dll (server configuration) or jrun_root/lib/wsconfig/jrun.dll (multiserver configuration). On IIS6, this file is named jrun_iis6.dll. For each of your IIS websites, verify that application mappings for .cfm, .cfml, .cfc, .cfswf, .cfr, .jsp, and .jws were added, as follows: In IIS, right-click an IIS website and select Properties.
Page 52
For more information, see the Web Server Management chapter of Configuring and Administering ColdFusion MX. To configure SunONE or iPlanet for ColdFusion MX 7 in Windows: Start the Web Server Configuration Tool by selecting Start > Programs > Macromedia > ColdFusion MX 7 > Web Server Configuration Tool. Click Add.
Page 53
For more information, see the Web Server Management chapter in Configuring and Administering ColdFusion MX. To configure Apache for ColdFusion MX 7 in Windows: Start the Web Server Configuration Tool by selecting Start > Programs > Macromedia > ColdFusion MX 7 > Web Server Configuration Tool. Click Add.
Page 54
To verify your Apache configuration: Verify that one of the following files was created: cf_root\runtime\lib\wsconfig\number\mod_jrun.so (Apache 1.3.2.7) cf_root\runtime\lib\wsconfig\number\mod_jrun20.so (Apache 2.x) 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.
Page 55
To configure the Apache web server for ColdFusion MX 7 on UNIX: Enter the following command on a single line: wsconfig -server servername -ws Apache -dir <apache config directory> - coldfusion -v Note: You must enter the previous command as a single (long) line. The wsconfig file is in cf_root/runtime/bin (server configuration) or jrun_root/bin (multiserver configuration) The following is a sample command:...
Page 56
Configuring SunONE or iPlanet web server on UNIX This section describes how to configure SunONE Web Server or iPlanet web server (4.x or 6.x) for ColdFusion MX 7 on UNIX, and how to verify your configuration. Note: When running the Web Server Configuration Tool on the multiserver configuration, wsconfig.jar is located in jrun_root/lib.
ColdFusion MX 7 lets you do Verity searches for languages other than English. For more information on Verity, see Configuring and Administering ColdFusion MX. This section describes how to install a Verity Locales package from the Macromedia website, and how to switch to a different Verity Locales package.
Page 58
Installing Visibroker for CORBA connections To 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 MX 7 classpath, as follows: In the ColdFusion MX 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.
Note: The ColdFusion Report Builder uses RDS for the Query Builder and for charting support. However, for security reasons, Macromedia recommends that you disable RDS on a production server. To disable it, you must disable the RDSServlet mapping. To disable the RDSServlet mapping: Back up the web.xml file.
Comment out the RDSServlet mapping, as the following example shows: <!-- <servlet-mapping id="macromedia_mapping_9"> <servlet-name>RDSServlet</servlet-name> <url-pattern>/CFIDE/main/ide.cfm</url-pattern> </servlet-mapping> --> Save the file. Restart ColdFusion MX 7. RDS is disabled on the ColdFusion MX 7 server. For more information, see “Starting and stopping services” on page 47 for Windows, or “Managing the process”...
The ColdFusion services, by default, run under the highly privileged system accounts. For an extra level of security, Macromedia 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.)
CHAPTER 6 Troubleshooting This chapter contains solutions to common installation problems. Contents Common installation problems ..........63 Data source problems.
Page 64
Solution: After installing Windows XP Service Pack 2, the Windows Firewall is enabled by default. This prevents ColdFusion MX 6.1 from functioning correctly. For more information see the Tech Note at www.macromedia.com/support/coldfusion/ts/documents/windowsspxp2.htm. Cannot access Flash content locally Problem: You cannot access any Flash content locally after installing ColdFusion MX 7 on IIS.
Page 65
Problem: After installing ColdFusion MX 7, you cannot run Macromedia Flex on it. Solution: You must install the J2EE configuration of ColdFusion MX 7 to run Macromedia Flex on ColdFusion MX 7. Browsing a ColdFusion page displays a download window Problem: In prior versions of ColdFusion, you used IIS to map the file extension .cfm to...
Data source problems Unable to add a Microsoft Access data source Problem: When you try to add a Microsoft Access data source, the following error appears: Unable to update the ColdFusion MX 7 ODBC Server. Timeout period expired without completion of C:\blackstone\db\slserver54\admin\swcla.exe Solution: Install and start up the ODBC service, or use the Microsoft Access with Unicode driver.
J2EE configuration problems Problem: When you install JRun 4, then install the ColdFusion MX 7 WAR, and attempt to open the ColdFusion MX Administrator, the following error appears: 500 The Security service is not available. The security service is not available. Solution: Look at the log files in cfusion/logs to see if a message indicates that you need the Java Crypto Extensions (JCE) on a 1.3 JVM.
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.
INDEX CORBA enabling 57 Apache web server JVM arguments for J2EE 42 configuring in Windows 53 configuring on UNIX 54 application isolation 25, 33 application.xml file, web-uri element 41 data sources applications, hosting 12 connecting to external Type 4 61 migrating 11 deployment app server differences 34...
Page 70
UNIX 12 ColdFusion MX 7 Reporting 19, 29, 38 considerations for UNIX 12 considerations for Windows 12 Macromedia Flex 11 extensions for Dreamweaver 16 Microsoft network model 12 general considerations 11 migrating in Windows 16, 26, 35...
Page 71
sandbox security, enabling in J2EE 29, 43 Verity security manager 43 installing 30 server configuration 8 locales, installing 57 server instances, multiple 25, 33 requirements 49 servers dedicated 12 services for ColdFusion MX 7 in Windows 47 WAR. See web application archive setup.exe 16, 27, 35 web application archive (WAR) start...