Macromedia MX 61 User Manual
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
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
3
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
4 Contents
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:
Book Description
Installing and Using
ColdFusion MX
Configuring and
Administering
ColdFusion MX
Developing ColdFusion
MX Applications
Getting Started
Building ColdFusion
MX Applications
CFML Reference Provides descriptions, syntax, usage, and code examples for all ColdFusion
CFML Quick Reference A brief guide that shows the syntax of ColdFusion tags, functions, and variables.
Describes system installation and basic configuration for Windows, Solaris,
Linux, and HP-UX.
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.
Describes how to develop your dynamic web applications, including retrieving
and updating your data, using structures, and forms.
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.
tags, functions, and variables.
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.
6 Introduction
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
7
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:
1 Plan the installation You determine your installation, configuration, and upgrade options.
2 Run 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.
4 Run 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.
8 Chapter 1: Essential Information
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.
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
Free for a single
computer used for
development and
evaluation purposes only.
Not licensed for
deployment.
Licensed per server (up to
8 processors per server).
ColdFusion MX 6.1 product editions 9
Edition Description Licensing
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)
System requirements
Licensed per CPU. Initial
license is for two CPUs;
licenses available in twoCPU increments.
This section lists the system requirements for ColdFusion MX 6.1 for Windows and UNIX.
10 Chapter 1: Essential Information
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.
Developer
Requirement
Windows version
Windows 98
Windows Millennium Edition (ME)
Windows NT 4.0 (Workstation and Server
Windows NT 4 Server, Enterprise Edition SP6A x x x
Windows 2000 (Professional SP3 or higher, Server
SP3 or higher
Server)
Windows XP (Home and Professional) x x x
Windows 2003 (Web, Standard, and Enterprise
Editions)
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
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
Apache web server 1.3.22–1.3.27, 2.0.43 or higher x x x
*
*
†
) SP6A x x x
†
, Advanced Server, and Datacenter
Edition
xxx
xx
xxx
xxx
250 to run
xxx
Standard
Edition
450 to install
250 to run
Enterprise
Edition
450 to install
250 to run
System requirements 11
Requirement
Developer
Edition
Standard
Edition
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
Sybase Adaptive Server 11.5 and higher
Sybase Adaptive Server Enterprise 12.0 and 12.5
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
Informix Dynamic Server 9.2x and 9.3x x
Microsoft SQL Server 7.0, 2000 (including service
xxx
packs 1, 2, and 3)
MySQL 3.23.47 x x x
Microsoft Access 97, 98, 2000, 2003 (MDAC 2.6
xxx
sp2 or higher)
SQLAnywhere£ x x x
PostgreSQL£ x x x
Enterprise
Edition
x
x
x
* 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.
12 Chapter 1: Essential Information
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.
Developer
Requirement
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.
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.
TurboLinux 8 Server (Japanese only)
Install the latest patches (including the kernel).
Verity does not support TurboLinux 8 server.
Solaris 7, 8, 9
For Solaris 7, install the latest patch bundles from
http://sunsolve.sun.com/pubcgi/show.pl?target=patches/patch-access
HP-UX 11i
Install the latest patch bundles from the Hewlett-
Packard website at http://www.hp.com
Hardware
Processor Pentium for Linux, SPARC for Solaris, and
Minimum RAM (MB) 256 256 256
Recommended RAM (MB) 512 512 512
Free hard disk space (MB) 450 to install
CD drive x x x
Web servers
ColdFusion MX built-in web server x x x
Edition
xxx
xxx
xxx
PA-RISC version 1.1 or 2.0 for HP-UX
250 to run
Standard
Edition
450 to
install
250 to run
Enterprise
Edition
x
x
450 to install
250 to run
System requirements 13
Developer
Requirement
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
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
Sybase Adaptive Server 11.5 and higher
Sybase Adaptive Server Enterprise 12.0 and 12.5
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
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
Edition
xxx
Standard
Edition
Enterprise
Edition
x
x
x
* 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/pubcgi/show.pl?target=patches/patch-access; for AIX,
http://www.ibm.com/software/webservers/appserv/support.html.
14 Chapter 1: Essential Information
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
IBM WebSphere 4 Windows NT 4.0 Workstation SP6A
IBM WebSphere 5 Windows NT 4.0 Server SP6A
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
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
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
J2EE configuration requirements 15
Edition Operating systems
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
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 coexist 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.
16 Chapter 1: Essential Information
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.
Installation considerations 17
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.
18 Chapter 1: Essential Information
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
19
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?
Planned location of new ColdFusion
MX directory?
Will you configure an external web
server (such as Apache or IIS)?
(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.)
New install | ColdFusion MX update
______________________________________________
Yes | No
______________________________________________
______________________________________________
______________________________________________
______________________________________________
______________________________________________
______________________________________________
20 Chapter 2: Installing the Server Configuration
Question Answer
UNIX
Runtime user Default is nobody (HP-UX must change this value).
For security reasons, it is crucial that you do not use root for
the runtime user.
Start at system startup (Solaris and
RedHat Linux only)
Yes | No
After running the installer, you must complete the installation process by running the
Configuration Wizard. You start the Configuration Wizard by opening the ColdFusion MX
Administrator. You should also plan your answers to the questions asked by the Configuration
Wizard.
Note: If you exit the browser before completing the Configuration Wizard, it continues from where
you stopped the next time the ColdFusion MX Administrator is opened.
Question Answer Comment
Upgrade from ColdFusion MX
When upgrading from ColdFusion MX, the Configuration Wizard updates the ODBC services, but
does not ask any questions.
All other installation types
Enable RDS? Yes | No RDS allows the server to interact
If enabling RDS, RDS password? ________________________
Install example applications and
getting started tutorial application?
Yes | No ColdFusion MX ships with a
with remotely connected
developers. It’s best to disable
RDS for production servers.
Disabling RDS also disables the
directory browsing applets in the
ColdFusion MX Administrator.
variety of example applications.
Installing the example
applications also installs the
supporting files used by the
Getting Started Building
ColdFusion MX Applications
tutorial lessons. Do not use the
example applications if you are
installing into a production
environment.
Installing ColdFusion MX 6.1 21
Loading...