MACROMEDIA COLFUSION MX 7 - INSTALLING AND USING COLDFUSION... Guide

COLDFUSION®MX 7
Installing and Using ColdFusion MX

Trademarks
1 Step RoboPDF, ActiveEdit, ActiveTest, Authorware, Blue Sky Software, Blue Sky, Breeze, Breezo, Captivate, Central,
ColdFusion, Contribute, Database Explorer, Director, Dreamweaver, Fireworks, Flash, FlashCast, FlashHelp, Flash Lite,
FlashPaper, Flex, Flex Builder, Fontographer, FreeHand, Generator, HomeSite, JRun, MacRecorder, Macromedia, MXML,
RoboEngine, RoboHelp, RoboInfo, RoboPDF, Roundtrip, Roundtrip HTML, Shockwave, SoundEdit, Studio MX, UltraDev,
and WebHelp are either registered trademarks or trademarks of Macromedia, Inc. and may be registered in the United States or
in other jurisdictions including internationally. 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.
This product includes code licensed from RSA Data Security.
Third-Party Information
This guide contains links to third-party websites that are not under the control of Macromedia, and Macromedia is not
responsible for the content on any linked site. If you access a third-party website mentioned in this guide, then you do so at your
own risk. Macromedia provides these links only as a convenience, and the inclusion of the link does not imply that Macromedia
endorses or accepts any responsibility for the content on those third-party sites.
Copyright © 1999–2005 Macromedia, Inc. All rights reserved. U.S. Patents Pending. This manual may not be copied,
photocopied, reproduced, translated, or converted to any electronic or machine-readable form in whole or in part without
written approval from Macromedia, Inc. Notwithstanding the foregoing, the owner or authorized user of a valid copy of
the software with which this manual was provided may print out one copy of this manual from an electronic version of this
manual for the sole purpose of such owner or authorized user learning to use such software, provided that no part of this
manual may be printed out, reproduced, distributed, resold, or transmitted for any other purposes, including, without
limitation, commercial purposes, such as selling copies of this documentation or providing paid-for support services.
Part Number ZCF70M100
Acknowledgments
Project Management: Randy Nielsen
Writing: Anne Sandstrom
Editing: Linda Adler, Noreen Maher
Production Management: Patrice O’Neill,
Media Design and Production: John Francis, Adam Barnett
Special thanks to Sawako Gensure, Seungmin Lee, Takashi Koto, Nozomi Kugita, Masayo Noda, Hiroshi Okugawa, Bowne
Global Solutions
First Edition: January 2005
Macromedia, Inc.
600 Townsend St.
San Francisco, CA 94103

3
CONTENTS
INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
CHAPTER 1: Preparing to Install ColdFusion MX 7 . . . . . . . . . . . . . . . . . . . . . . . . . 7
About the ColdFusion MX 7 installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
ColdFusion MX 7 product editions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
System requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Installation considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Gathering information necessary to install ColdFusion MX 7 . . . . . . . . . . . . . . . . 13
CHAPTER 2: Installing the Server Configuration . . . . . . . . . . . . . . . . . . . . . . . . . 15
Installing ColdFusion MX 7 using the server configuration. . . . . . . . . . . . . . . . . . 15
Installing the ColdFusion Report Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Installing the Verity search server separately. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
ColdFusion MX 7 server configuration directory structure . . . . . . . . . . . . . . . . . . 20
Using the built-in web server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Uninstalling ColdFusion MX 7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
CHAPTER 3: Installing the Multiserver Configuration . . . . . . . . . . . . . . . . . . . . . . 25
About multiserver configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Installing ColdFusion MX 7 using the multiserver configuration . . . . . . . . . . . . . 26
Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Installing the ColdFusion Report Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Installing the Verity search server separately. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Uninstalling ColdFusion MX 7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
CHAPTER 4: Installing the J2EE Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . 31
J2EE application servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Preparing to install using the J2EE configuration . . . . . . . . . . . . . . . . . . . . . . . . . 34
Installing an EAR file or WAR files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Installing the ColdFusion Report Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Installing the Verity search server separately. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
ColdFusion MX 7 J2EE deployment and configuration . . . . . . . . . . . . . . . . . . . . 39
Undeploying ColdFusion MX 7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

4 Contents
CHAPTER 5: Configuring Your System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Overview of configuration tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Managing ColdFusion MX 7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Configuring web servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Installing Verity Locales. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Enabling CORBA support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Disabling Remote Development Services. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Disabling JSP functionality (server configuration only) . . . . . . . . . . . . . . . . . . . . . 60
Changing the ColdFusion MX 7 user account in Windows. . . . . . . . . . . . . . . . . . 61
Connecting to an external JDBC Type 4 data source. . . . . . . . . . . . . . . . . . . . . . . 61
CHAPTER 6: Troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Common installation problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Data source problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Migration problems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
J2EE configuration problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Post-install problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Uninstall problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

5
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.
Documentation set
The ColdFusion MX 7 documentation set includes the following titles:
Book Description
Installing and Using
ColdFusion MX
Describes system installation and basic configuration for Windows, Solaris,
and Linux. To see this manual, go to www.macromedia.com/go/
livedocs_cfmx7docs_installing.
Configuring and
Administering
ColdFusion MX
Part I describes how to manage the ColdFusion environment, including
connecting to your data sources and configuring security for your
applications. Part II describes Verity search tools and utilities that you can
use for configuring the Verity Search Server engine, as well as creating,
managing, and troubleshooting Verity collections. To see this manual, go to
www.macromedia.com/go/livedocs_cfmx7docs_configadmin.
ColdFusion MX
Developer’s Guide
Describes how to develop your dynamic web applications, including
retrieving and updating your data, using structures, and forms. To see this
manual, go to www.macromedia.com/go/livedocs_cfmx7docs_dev.
Getting Started
Building
ColdFusion MX
Applications
Contains an overview of ColdFusion features and application development
procedures. Includes a tutorial that guides you through the process of
developing an example ColdFusion application. To see this manual, go to
www.macromedia.com/go/livedocs_cfmx7docs_gs.
CFML Reference Provides descriptions, syntax, usage, and code examples for all ColdFusion
tags, functions, and variables. To see this manual, go to
www.macromedia.com/go/livedocs_cfmx7docs__cfml_reference.
CFML Quick Reference Provides a brief guide that shows the syntax of ColdFusion tags, functions,
and variables.

6 Introduction:
Viewing online documentation
All ColdFusion MX 7 documentation is available online in HTML and Adobe Acrobat Portable
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.

7
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
information necessary to install ColdFusion MX 7” on page 13.
Contents
About the ColdFusion MX 7 installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
ColdFusion MX 7 product editions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
System requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Installation considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Gathering information necessary to install ColdFusion MX 7 . . . . . . . . . . . . . . . . . . . . . . . . . 13
About the ColdFusion MX 7 installation
ColdFusion MX 7 provides a powerful and flexible installation and upgrade process. The
ColdFusion MX 7 installation process includes the following phases:
1. Plan the installation. You determine your installation, configuration, and upgrade options.
2. Run the installer. You run the ColdFusion MX 7 installer.
3. (J2EE configuration only) Deploy ColdFusion MX 7. You deploy and configure
ColdFusion MX 7 on your J2EE application server.
The ColdFusion MX 7 installation process supports the following scenarios:
New installation Install ColdFusion MX 7 on a computer with no previous ColdFusion
installation.
Upgrade installation You can upgrade from ColdFusion 4.5, ColdFusion 5, ColdFusion MX,
and ColdFusion MX 6.1. When upgrading from ColdFusion 4.5, or 5, the installer migrates
previous settings to ColdFusion MX 7. When upgrading from ColdFusion MX or ColdFusion
MX 6.1, the installer preserves the existing settings and installs in a new directory, automatically
assigning ports that do not conflict with the existing installation.

8 Chapter 1: Preparing to Install ColdFusion MX 7
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. This was formerly
known as the stand-alone configuration. For information on installing the server configuration,
see Chapter 2, “Installing the Server Configuration,” on page 15.
Multiserver configuration (Enterprise Edition only) Installs JRun and automatically deploys
ColdFusion MX 7 in a separate JRun server instance. This configuration supports server instance
creation and ColdFusion deployment in the ColdFusion MX Administrator and lets you manage
ColdFusion MX 7 deployments on multiple JRun servers. For information on installing the
multiserver configuration, see Chapter 3, “Installing the Multiserver Configuration,” on page 25.
J2EE configuration (Enterprise Edition only) Lets you deploy ColdFusion MX 7 as a Java
application running on a Java 2 Enterprise Edition (J2EE) application server, either using the
bundled license of JRun or using a third-party J2EE server, such as IBM WebSphere or BEA
WebLogic. When you use the J2EE configuration, you can deploy ColdFusion MX 7 multiple
times on a single computer. For information on installing the J2EE configuration, see Chapter 4,
“Installing the J2EE Configuration,” on page 31.
The remainder of this chapter describes product editions and system requirements. After you
understand the editions and ensure that your environment meets the system requirements,
continue with the instructions in Chapter 2, “Installing the Server Configuration,” on page 15
Chapter 3, “Installing the Multiserver Configuration,” on page 25, or Chapter 4, “Installing the
J2EE Configuration,” on page 31, as appropriate.
ColdFusion MX 7 product editions
The following table describes each edition of ColdFusion MX 7:
Edition Description Licensing
Developer For Windows and Linux.
Supports requests from the local host and two remote IP
addresses. Includes every feature in the Enterprise Edition,
with the following exceptions:.
•Banded reports, output from the cfdocument tag, and
charts are watermarked.
•Verity update is supported on a single-server
configuration only.
•There is a 10K Verity document search limit.
•EAR/WAR deployment is not supported.
•If you install ColdFusion MX 7 in Trial mode, it reverts to
Developer Edition after 30 days.
Free for a single
computer used for
development and
evaluation purposes only.
Applications on
Development Edition
server are viewable from
up to five client machines.
Not licensed for
deployment.

ColdFusion MX 7 product editions 9
Standard For Windows and Linux.
Features full ColdFusion Markup Language (CFML)
support, including:
•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).
•Rich forms.
•A built-in charting and graphing engine, including
enhancements in ColdFusion MX 7.
•Database connectivity using ODBC with a desktop
database, such as Microsoft Access, and using a Type 4
driver for SQL Server or MySQL.
•Database and LDAP directory authentication, and
resource security.
•A 125K Verity document search limit.
•ColdFusion MX 7 reporting
Licensed per server (up to
eight processors per
server).
Edition Description Licensing

10 Chapter 1: Preparing to Install ColdFusion MX 7
Note: If you have a previous licensed version of ColdFusion installed, and you want to evaluate the
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.
To use third-party JDBC type 4 drivers, see “Connecting to an external JDBC Type 4 data
source” on page 61. The installation instructions also describe how to provide ODBC database
support on Windows.
Enterprise For Windows, Linux, and Solaris.
Includes every feature in the Standard Edition, and also
provides the following:
•Database connectivity using Type 4 drivers for Oracle,
DB2, Sybase, and Informix
•External Event Gateway support, including XMPP/
Jabber IM Gateway, Lotus Sametime IM Gateway,
Asynchronous CFML Gateway, SMS/Mobile Cell
Gateway, and local SMS development toolkit
•The ability to import and execute Java Server Page (JSP)
servlets and JSP Tag Library imports
•Server sandbox security
•A 250K Verity document search
•Advanced server management capabilities, including
server log analysis, configurable probes and alarms, and
automated archive and deployment options
•J2EE support, in particular, Servlet, Java Server Pages
(JSP), and Enterprise JavaBeans (EJB)
•Support for deployment on third-party J2EE application
servers
•Multiserver configuration and J2EE configuration
support running multiple instances of ColdFusion MX 7
on a single computer
•Backup mail servers and multithreaded e-mail delivery
•HTTP-based load-balancing and failover using the
Cluster Manager
•Complete JRun 4 included
•EAR/WAR package creation, and EAR/WAR
deployment
•Archive and deployment services
Licensed per CPU. Initial
license is for two CPUs;
licenses available in two-
CPU increments.
Edition Description Licensing