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

System requirements 11
System requirements for Windows
This section lists the Windows system requirements for the Macromedia ColdFusion MX 6.1
Developer, Standard, and Enterprise Editions. An “x” in the following table means that the
edition supports the requirement in that row.
Requirement
Developer
Edition
Standard
Edition
Enterprise
Edition
Windows version
Windows 98*xxx
Windows Millennium Edition (ME)*xx
Windows NT 4.0 (Workstation and Server†) SP6A x x x
Windows NT 4 Server, Enterprise Edition SP6A x x x
Windows 2000 (Professional SP3 or higher, Server
SP3 or higher†, Advanced Server, and Datacenter
Server)
xxx
Windows XP (Home and Professional) x x x
Windows 2003 (Web, Standard, and Enterprise
Editions)
xxx
Hardware
Processor Pentium Pentium Pentium
Colors 256 256 256
Minimum RAM (MB) 128 256 256
Recommended RAM (MB) 256 512 512
Free hard disk space (MB) 450 to install
250 to run
450 to install
250 to run
450 to install
250 to run
CD drive x x x
Web servers
ColdFusion MX built-in web server x x x
Microsoft IIS 4.0, 5.x, 6 x x x
Netscape Enterprise Server 3.6x x x x
iPlanet 4.x
SunONE Web Server 6.x (formerly iPlanet 6.x
xxx
Apache web server 1.3.22–1.3.27, 2.0.43 or higher x x x

12 Chapter 1: Essential Information
* ColdFusion MX only supports the built-in web server for this platform. Macromedia does not recommend using the
built-in web server in a production environment.
† To install ColdFusion MX in Windows NT 4.0, or Windows 2000, Windows XP, or Windows 2003, you must
already have the following components installed: MDAC 2.6 SP2 (www.microsoft.com/data/download.htm) and the
Microsoft Visual C++ 6.0 runtime http://support.microsoft.com/default.aspx?scid=kb;en-us;259403).
£ ColdFusion MX does not include the driver for this database. For more information, see “Connecting to an external
JDBC Type 4 data source” on page 65.
Java Virtual Machine (JVM)
Note: ColdFusion MX 6.1 ships with the Sun 1.4.2 JVM.
Sun JDK/JRE 1.3.1 or later x x x
IBM JVM 1.2.2–1.3 or later x x x
Browsers for ColdFusion MX Administrator
Internet Explorer 5.x, 6 x x x
Netscape Communicator 4, 6 x x x
Mozilla 1.0 x x x
Databases
Oracle 8i R2-R3 (8.1.6 - 8.1.7)
Oracle 9i R1-R2
x
Sybase Adaptive Server 11.5 and higher
Sybase Adaptive Server Enterprise 12.0 and 12.5
x
DB2 UDB for Windows, UNIX, Linux, and
Linux/s390 v7.1, v7.2, v8.1
DB2 UDB for OS/390 v6.1
DB2 UDB for z/OS and OS/390 v7.1, v7.2
x
Informix Dynamic Server 9.2x and 9.3x x
Microsoft SQL Server 7.0, 2000 (including service
packs 1, 2, and 3)
xxx
MySQL 3.23.47 x x x
Microsoft Access 97, 98, 2000, 2003 (MDAC 2.6
sp2 or higher)
xxx
SQLAnywhere£ x x x
PostgreSQL£ x x x
Requirement
Developer
Edition
Standard
Edition
Enterprise
Edition

System requirements 13
System requirements for UNIX
This section lists the UNIX system requirements for the Macromedia ColdFusion MX 6.1
Developer, Standard, and Enterprise Editions. An “x” in the following table means that the
edition supports the requirement in that row.
Requirement
Developer
Edition
Standard
Edition
Enterprise
Edition
UNIX distributions
Red Hat Linux 7.2, 7.3, 8.0, 9
RedHat Linux AS 2.1
Install the latest patches (including the kernel and those
listed in “Configuring Your System” on page 49) from
ftp://ftp.redhat.com/pub
If you use Apache, ensure that the version is 1.3.22-
1.3.27 or 2.0.43 or later.
Verity does not support RedHat Linux 7.3, 8.0, and 9.
xxx
SuSE Linux 7.2, 7.3, 8.x
SuSE Linux Enterprise Server 8
Install the latest patches (including the kernel) from
ftp://ftp.suse.com/pub
Verity does not support SuSE Linux 7.3, 8.x, or SuSE
Linux Enterprise Server 8.
xxx
TurboLinux 8 Server (Japanese only)
Install the latest patches (including the kernel).
Verity does not support TurboLinux 8 server.
xxx
Solaris 7, 8, 9
For Solaris 7, install the latest patch bundles from
http://sunsolve.sun.com/pub-
cgi/show.pl?target=patches/patch-access
x
HP-UX 11i
Install the latest patch bundles from the Hewlett-
Packard website at http://www.hp.com
x
Hardware
Processor Pentium for Linux, SPARC for Solaris, and
PA-RISC version 1.1 or 2.0 for HP-UX
Minimum RAM (MB) 256 256 256
Recommended RAM (MB) 512 512 512
Free hard disk space (MB) 450 to install
250 to run
450 to
install
250 to run
450 to install
250 to run
CD drive x x x
Web servers
ColdFusion MX built-in web server x x x

14 Chapter 1: Essential Information
* ColdFusion MX does not include the driver for this database. For more information, see “Connecting to an external
JDBC Type 4 data source” on page 65.
For all UNIX distributions, install the latest production-level patches, including the kernel, from
the supplier’s download sites: for Red Hat, ftp://ftp.redhat.com/pub; for SuSE,
ftp://ftp.suse.com/pub; for Solaris, http://sunsolve.sun.com/pub-
cgi/show.pl?target=patches/patch-access; for AIX,
http://www.ibm.com/software/webservers/appserv/support.html.
Apache web server 1.3.22–1.3.27, 2.0.43 or higher x x x
Netscape Enterprise Server 3.6x x x x
iPlanet 4.x
SunONE Web Server 6.x (formerly iPlanet 6.x
xxx
Java Virtual Machine (JVM)
Note: ColdFusion MX 6.1 ships with the Sun 1.4.2 JVM.
Sun JDK/JRE 1.3.1 or later x x x
IBM JVM 1.3 or later x x x
Browsers for ColdFusion MX Administrator
Internet Explorer 5.x, 6 x x x
Netscape Communicator 4, 6 x x x
Mozilla 1.0 x x x
Databases
Oracle 8i R2-R3 (8.1.6 - 8.1.7)
Oracle 9i R1-R2
x
Sybase Adaptive Server 11.5 and higher
Sybase Adaptive Server Enterprise 12.0 and 12.5
x
DB2 UDB for Windows, UNIX, Linux, and Linux/s390
v7.1, v7.2, v8.1
DB2 UDB for OS/390 v6.1
DB2 UDB for z/OS and OS/390 v7.1, v7.2
x
Informix Dynamic Server 9.2x and 9.3x x
MySQL 3.23.47 x x x
Microsoft SQL Server 7.x, 2000 x x x
SQLAnywhere* x x x
PostgreSQL* x x x
Requirement
Developer
Edition
Standard
Edition
Enterprise
Edition

J2EE configuration requirements 15
J2EE configuration requirements
This section lists additional system requirements for Windows and UNIX when running in the
J2EE configuration. This information was up-to-date at the time this document was written. For
any updates, see www.macromedia.com/go/cfmxj2ee-cert.
Operating system and Java requirements
The following table lists the J2EE application servers supported by ColdFusion MX when
running in the J2EE configuration. For the most up-to-date list of certified platforms, see the
Macromedia support site, www.macromedia.com/support/coldfusion.
Edition Operating systems
BEA WebLogic Server 7.0
BEA WebLogic Server 8.1
Windows NT 4.0 Server SP6A
Windows 2000 Server SP2
Windows 2000 Advanced Server SP2
Red Hat Linux 7.2
Red Hat Advanced Server 2.1
SuSE Linux 7.2
Solaris 7
Solaris 8
IBM WebSphere 4 Windows NT 4.0 Workstation SP6A
Windows NT 4.0 Server SP6A
Windows 2000 Professional SP3
Windows 2000 Server SP3
Windows 2000 Advanced Server SP3
Red Hat Linux 7.2
SuSE Linux 7.2
Solaris 7
Solaris 8
AIX 4.3.3
AIX 5L v5.1
IBM WebSphere 5 Windows NT 4.0 Server SP6A
Windows 2000 Server SP3
Windows 2000 Advanced Server SP3
Red Hat Linux 8.0
RedHat Advanced Server 2.1
SuSE Linux 7.3
Solaris 7
Solaris 8
AIX 4.3.3
AIX 5L v 5.1

16 Chapter 1: Essential Information
To use third-party JDBC type 4 drivers, see “Connecting to an external JDBC Type 4 data
source” on page 65. The installation instructions also describe how to provide ODBC database
support on Windows.
Installation considerations
This section lists considerations for installing or upgrading to ColdFusion MX 6.1.
Note: To use VisiBroker for CORBA connections in ColdFusion MX, see “Enabling CORBA
support” on page 60. To install ClusterCATS, see Using ClusterCATS.
Installation considerations for all platforms
The following are installation considerations for all platforms:
•Macromedia supports upgrading to ColdFusion MX 6.1 from ColdFusion MX (the
installation functions as an updater), ColdFusion 4.5, and ColdFusion 5. If you are upgrading,
you must back up your existing ColdFusion applications first.
•If you have previously installed a Beta version of ColdFusion MX 6.1, you must uninstall it
before you install the release version.
•Macromedia recommends using the built-in (internal port-based) web server for development,
but not in a production environment.
•If you have ColdFusion 4.5 or 5 installed on your computer, you can upgrade to ColdFusion
MX (which disables ColdFusion 4.5 or 5), or you can install ColdFusion MX separately, in co-
exist mode. If you install ColdFusion MX separately, your ColdFusion 5 installation remains
the same and ColdFusion MX installs with its built-in web server. This is because ColdFusion
MX and ColdFusion 5 cannot use the same web server.
Macromedia JRun 4 Windows NT 4.0 Server SP6A
Windows 2000 Professional SP2
Windows 2000 Server SP2
Windows 2000 Advanced Server SP3
Windows XP Professional
Windows 2003
Red Hat Linux 7.2, 7.3, 8.0, 9.0
RedHat Advanced Server 2.1
SuSE Linux 7.3
Turbo Linux 8 (JA only)
Solaris 7, 8, 9
Sun ONE Application Server 7 Windows NT 4.0 Server SP6A
Windows 2000 Server SP2
Windows 2000 Advanced Server SP2
Windows XP
Red Hat Linux 7.2, 7.3
Solaris 8
Solaris 9
Edition Operating systems

Installation considerations 17
You can switch to use a different web server for ColdFusion MX after the installation, by
following the instructions for your platform and the web server in “Configuring web servers”
on page 53. However, if you configure the web server that uses ColdFusion 5 to use
ColdFusion MX instead, ColdFusion 5 will be disabled.
•During installation of the server configuration, if you select the built-in web server, your web
root directory is C:\CFusionMX\wwwroot by default. This web server runs on the 8500 port.
To display a page, append 8500 to the end of the host name or IP address; for example,
http://localhost:8500/MyApp.cfm. (If the page still does not display, make sure that the
document is located in the ColdFusion MX web root directory; for example,
c:\CFusionMX\wwwroot\MyApp.cfm.) For more information, see “Using the built-in web
server” on page 27.
•To interact with ColdFusion pages, components, and server-side ActionScript from a
Macromedia Flash movie, use the Flash Remoting service in ColdFusion MX. To develop
applications that use Flash Remoting, you must install the Flash Remoting components in the
Flash MX authoring environment. The Flash MX authoring environment is required to build
applications that connect to and interact with the Flash Remoting service in ColdFusion.
For more information on configuring ColdFusion MX 6.1 to use Flash Remoting, see
“Enabling web services access for Flash Remoting” on page 65. For more information on Flash
Remoting, see Developing ColdFusion MX Applications.
•ColdFusion MX is built in Java and when installing the server configuration, the ColdFusion
MX 6.1 installer automatically installs the JRE that is appropriate for your platform. When
installing the J2EE configuration, ColdFusion MX 6.1 uses the same JRE as your J2EE
application server.
•In an optimal production environment, each ColdFusion MX application is hosted on a
dedicated server; database, mail, and other servers are not on the same computer.
Installation considerations for Windows
The following are installation considerations for Windows only:
•If you previously added a cf_root\bin or cf_root\verity\_nti40\bin directory to your system path
for ColdFusion 5, you must remove it before installing ColdFusion MX. (For instructions, see
the Microsoft Windows online Help.) Otherwise, ColdFusion MX cannot locate the correct
Verity DLL files.
•Do not configure the server running ColdFusion MX as a Primary Domain Controller (PDC)
or Backup Domain Controller (BDC). Macromedia follows Microsoft’s network model, in
which the first level is the PDC/BDC. These systems only manage the network or domain and
are not designed to run application servers. ColdFusion MX should reside on the second level
of Windows NT and Windows 2000 stand-alone systems. Stand-alone servers can participate
in a network or domain.
•Windows NT 4.0 Workstation, Windows 2000 Professional handle only 10 TCP/IP
connections concurrently. Therefore, Macromedia does not recommend using these operating
systems in a production environment; use Window NT 4.0 Server or Windows 2000 Server
instead. In addition, Macromedia does not recommend using Windows ME, Windows 98, or
Windows XP Home Edition, because each was intended for personal use and not as a server
platform in a production environment.

18 Chapter 1: Essential Information
Installation considerations for UNIX
The following are installation considerations for UNIX only:
•For troubleshooting purposes, the installer creates the following log file during an installation
or upgrade on UNIX: cf_root/Macromedia_ColdFusion_MX_install.log. If you contact
Macromedia Technical Support for installation support, you must send them this file.
•If you are deploying the J2EE configuration on a platform other than Linux or Solaris, use the
coldfusion-61-other.jar installer. This Java-only installer does not include features that require
platform-specific binary files, such as Verity and C++ CFX support.

19
CHAPTER 2
Installing the Server Configuration
This chapter describes how to install and uninstall ColdFusion MX 6.1 in the server
configuration. The ColdFusion MX 6.1 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. By default, this directory is
C:\CFusionMX in Windows, and /opt/coldfusionmx on UNIX.
Contents
Installing ColdFusion MX 6.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
ColdFusion MX server configuration directory structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Using the built-in web server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Uninstalling ColdFusion MX 6.1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

20 Chapter 2: Installing the Server Configuration
Installing ColdFusion MX 6.1
This section provides installation instructions for the ColdFusion MX 6.1 server configuration on
Windows and UNIX. When installing the server configuration, you have the following options:
•New installation Select this option if you do not have ColdFusion MX on the computer or if
you have ColdFusion 4.5 or 5 on the computer.
•Update existing ColdFusion MX Select this option if ColdFusion MX is already installed on
the computer. You must update the existing version; ColdFusion MX and ColdFusion MX 6.1
cannot co-exist on the same computer.
Although the ColdFusion MX 6.1 installer provides an intuitive interface, it helps to plan your
answers to the questions asked by the installer:
Question Answer
All installation types
Platform-specific installer name? ______________________________________________
New installation or ColdFusion MX
update?
New install | ColdFusion MX update
Planned location of new ColdFusion
MX directory?
______________________________________________
Will you configure an external web
server (such as Apache or IIS)?
Yes | No
(Apache and iPlanet) Configuration
directory?
______________________________________________
(Apache) Path to server binary? ______________________________________________
If using an external web server,
location of your web root directory?
______________________________________________
ColdFusion MX Administrator
password?
______________________________________________
Upgrade from ColdFusion 4.5 or ColdFusion 5
Co-exist or upgrade? Co-exist | Upgrade
Location of existing ColdFusion 4.5
or 5 directory
______________________________________________
If using the built-in web server, what
port number will you use? The default
is 8500. You don’t typically change
this.
______________________________________________
Update from ColdFusion MX
Location of CFIDE directory?
(The update install renames your
existing CFIDE and cfdocs
directories to CFIDE_old and
cfdocs_old.)
______________________________________________