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.

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

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

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

Other manuals for COLDFUSION MX 61 - CONFIGURING AND ADMINISTERING COLDFUSION...

This manual suits for next models

Table of contents

Other MACROMEDIA Software manuals

MACROMEDIA

MACROMEDIA BREEZE-FOR MEETING PARTICIPANTS User manual

MACROMEDIA

MACROMEDIA FLASH MEDIA SERVER 2-INSTALLING FLASH MEDIA SERVER... User manual

MACROMEDIA

MACROMEDIA DIRECTOR MX 2004-DIRECTOR SCRIPTING Service manual

MACROMEDIA

MACROMEDIA BREEZE 5-MANAGER User manual

MACROMEDIA

MACROMEDIA FLASH MX 2004-ACTIONSCRIPT LANGUAGE Service manual

MACROMEDIA

MACROMEDIA COLDFUSION MX 61-DEVELOPING COLDFUSION MX User manual

MACROMEDIA

MACROMEDIA COLDFUSION 5-DEVELOPING User manual

MACROMEDIA

MACROMEDIA FLASH MEDIA SERVER 2-SERVER-SIDE ACTIONSCRIPT... Service manual

MACROMEDIA

MACROMEDIA CONTRIBUTE-USING CONTRIBUTE Mounting instructions

MACROMEDIA

MACROMEDIA BREEZE 5 Operator's manual

MACROMEDIA

MACROMEDIA COLFUSION MX 7-MIGRATING APPLICATIONS TO COLDFUSION MX... User manual

MACROMEDIA

MACROMEDIA COLDFUSION 4.5-DEVELOPING WEB User manual

MACROMEDIA

MACROMEDIA FLASH MEDIA SERVER 2-CLIENT-SIDE ACTIONSCRIPT LANGUAGE REFERENCE FOR FLASH MEDIA SERVER... Service manual

MACROMEDIA

MACROMEDIA FLEX BUILDER-USING FLEX BUILDER Mounting instructions

MACROMEDIA

MACROMEDIA FLASH MX 2004-FLASH JAVASCRIPT DICTIONARY User manual

MACROMEDIA

MACROMEDIA FLASH REMOTING MX-USING FLASH REMOTING FOR FLASH MX 2004 ACTIONSCRIPT... Mounting instructions

MACROMEDIA

MACROMEDIA COLDFUSION STUDIO 4.5-USING COLDFUSION... Mounting instructions

MACROMEDIA

MACROMEDIA FLASH 8-USING FLASH Mounting instructions

MACROMEDIA

MACROMEDIA 38000382 - Macromedia JRun - Mac User manual

MACROMEDIA

MACROMEDIA CONTRIBUTE 3-DEPLOYING CONTRIBUTE User manual

MACROMEDIA

MACROMEDIA COLFUSION MX 7 - INSTALLING AND USING COLDFUSION... User manual

MACROMEDIA

MACROMEDIA DIRECTOR MX 2004-GETTING STARTED WITH... User manual

MACROMEDIA

MACROMEDIA CONTRIBUTE 3 - DEPLOYING AND PUBLISHING... User manual

MACROMEDIA

MACROMEDIA BREEZE-USING THE BREEZE PUBLISH WIZARD Mounting instructions

Popular Software manuals by other brands

COMPRO

COMPRO COMPROFM manual

Muratec

Muratec OFFICEBRIDGE ONLINE user guide

Oracle

Oracle Contact Center Anywhere 8.1 installation guide

Adobe

Adobe 65007312 - Photoshop Lightroom Programmer's guide

Avaya

Avaya NULL One-X for RIM Blackberry user guide

HP ProLiant BL420c user guide

PS Audio

PS Audio PowerPlay Programming manual

Brady

Brady LOCKOUT PRO 3.0 Administrator's guide

Avaya

Avaya Interaction Center user guide

Texas Instruments

Texas Instruments TI-83 Plus Silver Edition Guide book

Novell

Novell GROUPWISE 8 - INTERNET AGENT manual

Oracle

Oracle Application 9i Configuration guide

Acer

Acer RDM user guide

Canon

Canon Vixia HF21 instruction manual

Canon

Canon ZR950 instruction manual

Samsung

Samsung Auto Backup user manual

Polycom

Polycom Vortex EF2201 Application note

Brocade Communications Systems

Brocade Communications Systems Brocade 8/12c user manual