MACROMEDIA COLDFUSION MX 61 - CONFIGURING AND ADMINISTERING COLDFUSION... Guide

Installing and Using ColdFusion MX

Trademarks
Afterburner, AppletAce, Attain, Attain Enterprise Learning System, Attain Essentials, Attain Objects for Dreamweaver,
Authorware, Authorware Attain, Authorware Interactive Studio, Authorware Star, Authorware Synergy, Backstage, Backstage
Designer, Backstage Desktop Studio, Backstage Enterprise Studio, Backstage Internet Studio, ColdFusion, Design in Motion,
Director, Director Multimedia Studio, Doc Around the Clock, Dreamweaver, Dreamweaver Attain, Drumbeat, Drumbeat 2000,
Extreme 3D, Fireworks, Flash, Fontographer, FreeHand, FreeHand Graphics Studio, Generator, Generator Developer's Studio,
Generator Dynamic Graphics Server, JRun, Knowledge Objects, Knowledge Stream, Knowledge Track, Lingo, Live Effects,
Macromedia, Macromedia M Logo & Design, Macromedia Flash, Macromedia Xres, Macromind, Macromind Action, MAGIC,
Mediamaker, Object Authoring, Power Applets, Priority Access, Roundtrip HTML, Scriptlets, SoundEdit, ShockRave,
Shockmachine, Shockwave, Shockwave Remote, Shockwave Internet Studio, Showcase, Tools to Power Your Ideas, Universal
Media, Virtuoso, Web Design 101, Whirlwind and Xtra are 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, servicemarks, or tradenames of Macromedia, Inc. or other entities and may be
registered in certain jurisdictions including internationally.
This product includes code licensed from RSA Data Security.
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.
Apple Disclaimer
APPLE COMPUTER, INC. MAKES NO WARRANTIES, EITHER EXPRESS OR IMPLIED, REGARDING THE
ENCLOSED COMPUTER SOFTWARE PACKAGE, ITS MERCHANTABILITY OR ITS FITNESS FOR ANY
PARTICULAR PURPOSE. THE EXCLUSION OF IMPLIED WARRANTIES IS NOT PERMITTED BY SOME STATES.
THE ABOVE EXCLUSION MAY NOT APPLY TO YOU. THIS WARRANTY PROVIDES YOU WITH SPECIFIC LEGAL
RIGHTS. THERE MAY BE OTHER RIGHTS THAT YOU MAY HAVE WHICH VARY FROM STATE TO STATE.
Copyright © 1999–2003 Macromedia, Inc. All rights reserved. This manual may not be copied, photocopied, reproduced,
translated, or converted to any electronic or machine-readable form in whole or in part without prior written approval of
Macromedia, Inc.
Part Number ZCF61M100
Acknowledgments
Project Management: Randy Nielsen
Writing: Randy Nielsen
Editing: Linda Adler, Noreen Maher
First Edition: August 2003
Macromedia, Inc.
600 Townsend St.
San Francisco, CA 94103

3
CONTENTS
INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
About Macromedia ColdFusion MX documentation . . . . . . . . . . . . . . . . . . . . . . . 5
Documentation set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Viewing online documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
CHAPTER 1: Essential Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
About the ColdFusion MX 6.1 installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
ColdFusion MX 6.1 product editions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
System requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
System requirements for Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
System requirements for UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
J2EE configuration requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Operating system and Java requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Installation considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Installation considerations for all platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Installation considerations for Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Installation considerations for UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
CHAPTER 2: Installing the Server Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Installing ColdFusion MX 6.1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Installing ColdFusion MX 6.1 on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Installing ColdFusion MX 6.1 on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
ColdFusion MX server configuration directory structure. . . . . . . . . . . . . . . . . . . . 26
Using the built-in web server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Switching the port for the built-in web server. . . . . . . . . . . . . . . . . . . . . . . . . . 27
Switching from another web server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Uninstalling ColdFusion MX 6.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Uninstalling ColdFusion MX 6.1 from Windows. . . . . . . . . . . . . . . . . . . . . . . 29
Uninstalling ColdFusion MX 6.1 from UNIX . . . . . . . . . . . . . . . . . . . . . . . . . 29

4 Contents
CHAPTER 3: Installing the J2EE Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . 31
J2EE application servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Choosing EAR or WAR deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Context root. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Multiple instances. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Preparing to install using the J2EE configuration . . . . . . . . . . . . . . . . . . . . . . . . . 34
Installing the J2EE configuration with JRun . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Installing the J2EE configuration with JRun in Windows. . . . . . . . . . . . . . . . . 36
Installing the J2EE configuration with JRun on UNIX . . . . . . . . . . . . . . . . . . 37
Installing an EAR file or WAR files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Installing an EAR file or WAR files in Windows. . . . . . . . . . . . . . . . . . . . . . . . 40
Installing an EAR file or WAR files on UNIX. . . . . . . . . . . . . . . . . . . . . . . . . . 41
Updating from ColdFusion MX for J2EE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
ColdFusion MX J2EE deployment and configuration . . . . . . . . . . . . . . . . . . . . . . 43
Deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
ColdFusion MX J2EE configuration directory structure. . . . . . . . . . . . . . . . . . 46
Undeploying ColdFusion MX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
CHAPTER 4: Configuring Your System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Overview of configuration tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Managing ColdFusion MX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Managing ColdFusion MX services in Windows . . . . . . . . . . . . . . . . . . . . . . . 51
Managing the ColdFusion MX process on UNIX. . . . . . . . . . . . . . . . . . . . . . . 53
Configuring web servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Configuring web servers in Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Configuring web servers on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Installing Verity Locales. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Enabling CORBA support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
System requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Installing Visibroker for CORBA connections . . . . . . . . . . . . . . . . . . . . . . . . . 61
Disabling Remote Development Services (RDS) . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Disabling JSP functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Changing the ColdFusion MX user account in Windows . . . . . . . . . . . . . . . . . . . 63
Enabling web services access for Flash Remoting . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Connecting to an external JDBC Type 4 data source. . . . . . . . . . . . . . . . . . . . . . . 65
Configuring RedHat Linux 7.3, 8.0, and 9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

INTRODUCTION
Installing and Using ColdFusion MX is intended for anyone who needs to install and configure
ColdFusion MX 6.1.
About Macromedia ColdFusion MX documentation
The ColdFusion MX documentation is designed to provide support for the complete spectrum of
participants.
Documentation set
The ColdFusion documentation set includes the following titles:
Viewing online documentation
All ColdFusion MX 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.
Book Description
Installing and Using
ColdFusion MX
Describes system installation and basic configuration for Windows, Solaris,
Linux, and HP-UX.
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 K2 Server search engine, as well as creating, managing, and
troubleshooting Verity collections.
Developing ColdFusion
MX Applications
Describes how to develop your dynamic web applications, including retrieving
and updating your data, using structures, and forms.
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.
CFML Reference Provides descriptions, syntax, usage, and code examples for all ColdFusion
tags, functions, and variables.
CFML Quick Reference A brief guide that shows the syntax of ColdFusion tags, functions, and variables.

6 Introduction

7
CHAPTER 1
Essential Information
This chapter describes Macromedia ColdFusion MX 6.1 product editions, system requirements,
and other high-level considerations.
Contents
About the ColdFusion MX 6.1 installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
ColdFusion MX 6.1 product editions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
System requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
J2EE configuration requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Installation considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

8 Chapter 1: Essential Information
About the ColdFusion MX 6.1 installation
ColdFusion MX 6.1 provides a powerful and flexible installation and upgrade process. The
ColdFusion MX 6.1 installation process includes the following phases:
1Plan the installation You determine your installation, configuration, and upgrade options.
2Run the installer You run the ColdFusion MX 6.1 installer.
3(J2EE configuration only) Deploy ColdFusion MX You deploy and configure ColdFusion
MX on your J2EE application server.
4Run the Configuration Wizard You finish the installation by specifying configuration and
migration options.
The ColdFusion MX 6.1 installation process supports the following scenarios:
•New installation Install ColdFusion MX 6.1 on a computer with no previous ColdFusion
installation.
•Upgrade installation You can upgrade from ColdFusion 4.5, ColdFusion 5, and
ColdFusion MX. When upgrading from ColdFusion 4.5 or 5, the Configuration Wizard
migrates previous settings to ColdFusion MX 6.1. When upgrading from ColdFusion MX, the
ColdFusion MX 6.1 installer functions as an updater, which automatically preservers existing
settings.
You can install ColdFusion MX 6.1 in either of the following configurations:
•Server configuration Lets you install one instance of ColdFusion with an embedded J2EE
server. This version contains an embedded copy of JRun and is most similar to previous
ColdFusion versions. For information on installing the server configuration, see Chapter 2,
“Installing the Server Configuration,” on page 19.
•J2EE configuration (Enterprise and Developer Editions only) Lets you deploy
ColdFusion MX as a Java application running on a Java 2 Enterprise Edition (J2EE)
application server. This configuration allows you to run multiple instances of ColdFusion MX
on a single computer, either using the bundled license of JRun or using a third-party J2EE
application server, such as IBM WebSphere, Sun ONE Application Server, or BEA WebLogic.
For information on installing the J2EE configuration, see Chapter 3, “Installing the J2EE
Configuration,” on page 31.
The remainder of this chapter describes product editions and system requirements. Once 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 19 or
Chapter 3, “Installing the J2EE Configuration,” on page 31, as appropriate.

ColdFusion MX 6.1 product editions 9
ColdFusion MX 6.1 product editions
The following table describes each edition of ColdFusion MX 6.1:
Edition Description Licensing
Developer For Windows and Linux.
•Supports requests from the local host and one
remote IP address
•Includes every feature in the Enterprise Edition, with
the following exceptions:
•A 10K Verity document search
•No HTTP-based load-balancing and failover using
Macromedia ClusterCATS
If you install ColdFusion MX 6.1 in Trial mode, it reverts
to Developer Edition after 30 days.
Free for a single
computer used for
development and
evaluation purposes only.
Not licensed for
deployment.
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)
•A built-in charting and graphing engine
•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
Licensed per server (up to
8 processors per server).

10 Chapter 1: Essential Information
System requirements
This section lists the system requirements for ColdFusion MX 6.1 for Windows and UNIX.
Enterprise For Windows, Linux, Solaris, and HP-UX.
Includes every feature in the Standard Edition, and
also provides:
•Database connectivity using Type 4 drivers for
Oracle, DB2, Sybase, and Informix
•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 deploy
options
•J2EE support, in particular, Servlet, Java Server
Pages (JSP) and Enterprise JavaBeans (EJB).
•Support for deployment on third-party J2EE
application servers.
•J2EE configuration supports running multiple
instances of ColdFusion MX on a single computer.
•Backup mail servers and multithreaded e-mail
delivery.
•HTTP-based load-balancing and failover using
Macromedia ClusterCATS (installed separately)
Licensed per CPU. Initial
license is for two CPUs;
licenses available in two-
CPU increments.
Edition Description Licensing