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

COLDFUSION®MX 7

Installing and Using ColdFusion MX

Trademarks

1 Step RoboPDF, ActiveEdit, ActiveTest, Authorware, Blue Sky Software, Blue Sky, Breeze, Breezo, Captivate, Central,

ColdFusion, Contribute, Database Explorer, Director, Dreamweaver, Fireworks, Flash, FlashCast, FlashHelp, Flash Lite,

FlashPaper, Flex, Flex Builder, Fontographer, FreeHand, Generator, HomeSite, JRun, MacRecorder, Macromedia, MXML,

RoboEngine, RoboHelp, RoboInfo, RoboPDF, Roundtrip, Roundtrip HTML, Shockwave, SoundEdit, Studio MX, UltraDev,

and WebHelp are either registered trademarks or trademarks of Macromedia, Inc. and may be registered in the United States or

in other jurisdictions including internationally. Other product names, logos, designs, titles, words, or phrases mentioned within

this publication may be trademarks, service marks, or trade names of Macromedia, Inc. or other entities and may be registered in

certain jurisdictions including internationally.

This product includes code licensed from RSA Data Security.

Third-Party Information

This guide contains links to third-party websites that are not under the control of Macromedia, and Macromedia is not

responsible for the content on any linked site. If you access a third-party website mentioned in this guide, then you do so at your

own risk. Macromedia provides these links only as a convenience, and the inclusion of the link does not imply that Macromedia

endorses or accepts any responsibility for the content on those third-party sites.

photocopied, reproduced, translated, or converted to any electronic or machine-readable form in whole or in part without

written approval from Macromedia, Inc. Notwithstanding the foregoing, the owner or authorized user of a valid copy of

the software with which this manual was provided may print out one copy of this manual from an electronic version of this

manual for the sole purpose of such owner or authorized user learning to use such software, provided that no part of this

manual may be printed out, reproduced, distributed, resold, or transmitted for any other purposes, including, without

limitation, commercial purposes, such as selling copies of this documentation or providing paid-for support services.

Part Number ZCF70M100

Acknowledgments

Project Management: Randy Nielsen

Writing: Anne Sandstrom

Editing: Linda Adler, Noreen Maher

Production Management: Patrice O’Neill,

Media Design and Production: John Francis, Adam Barnett

Special thanks to Sawako Gensure, Seungmin Lee, Takashi Koto, Nozomi Kugita, Masayo Noda, Hiroshi Okugawa, Bowne

Global Solutions

First Edition: January 2005

Macromedia, Inc.

600 Townsend St.

San Francisco, CA 94103

CONTENTS

INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

CHAPTER 1: Preparing to Install ColdFusion MX 7 . . . . . . . . . . . . . . . . . . . . . . . . . 7

About the ColdFusion MX 7 installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

ColdFusion MX 7 product editions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

System requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Installation considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Gathering information necessary to install ColdFusion MX 7 . . . . . . . . . . . . . . . . 13

CHAPTER 2: Installing the Server Configuration . . . . . . . . . . . . . . . . . . . . . . . . . 15

Installing ColdFusion MX 7 using the server configuration. . . . . . . . . . . . . . . . . . 15

Installing the ColdFusion Report Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Installing the Verity search server separately. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

ColdFusion MX 7 server configuration directory structure . . . . . . . . . . . . . . . . . . 20

Using the built-in web server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Uninstalling ColdFusion MX 7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

CHAPTER 3: Installing the Multiserver Configuration . . . . . . . . . . . . . . . . . . . . . . 25

About multiserver configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Installing ColdFusion MX 7 using the multiserver configuration . . . . . . . . . . . . . 26

Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Installing the ColdFusion Report Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Installing the Verity search server separately. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Uninstalling ColdFusion MX 7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

CHAPTER 4: Installing the J2EE Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . 31

J2EE application servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Preparing to install using the J2EE configuration . . . . . . . . . . . . . . . . . . . . . . . . . 34

Installing an EAR file or WAR files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Installing the ColdFusion Report Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Installing the Verity search server separately. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

ColdFusion MX 7 J2EE deployment and configuration . . . . . . . . . . . . . . . . . . . . 39

Undeploying ColdFusion MX 7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

4 Contents

CHAPTER 5: Configuring Your System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Overview of configuration tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Managing ColdFusion MX 7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Configuring web servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Installing Verity Locales. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

Enabling CORBA support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

Disabling Remote Development Services. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Disabling JSP functionality (server configuration only) . . . . . . . . . . . . . . . . . . . . . 60

Changing the ColdFusion MX 7 user account in Windows. . . . . . . . . . . . . . . . . . 61

Connecting to an external JDBC Type 4 data source. . . . . . . . . . . . . . . . . . . . . . . 61

CHAPTER 6: Troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Common installation problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Data source problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

Migration problems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

J2EE configuration problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

Post-install problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

Uninstall problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

INTRODUCTION

Installing and Using ColdFusion MX is intended for anyone who needs to install and configure

Macromedia ColdFusion MX 7.

About ColdFusion MX 7 documentation

The ColdFusion MX 7 documentation is designed to provide support for the complete spectrum of

participants.

Documentation set

The ColdFusion MX 7 documentation set includes the following titles:

Book Description

Installing and Using

ColdFusion MX

Describes system installation and basic configuration for Windows, Solaris,

and Linux. To see this manual, go to www.macromedia.com/go/

livedocs_cfmx7docs_installing.

Configuring and

Administering

ColdFusion MX

Part I describes how to manage the ColdFusion environment, including

connecting to your data sources and configuring security for your

applications. Part II describes Verity search tools and utilities that you can

use for configuring the Verity Search Server engine, as well as creating,

managing, and troubleshooting Verity collections. To see this manual, go to

www.macromedia.com/go/livedocs_cfmx7docs_configadmin.

ColdFusion MX

Developer’s Guide

Describes how to develop your dynamic web applications, including

retrieving and updating your data, using structures, and forms. To see this

manual, go to www.macromedia.com/go/livedocs_cfmx7docs_dev.

Getting Started

Building

ColdFusion MX

Applications

Contains an overview of ColdFusion features and application development

procedures. Includes a tutorial that guides you through the process of

developing an example ColdFusion application. To see this manual, go to

www.macromedia.com/go/livedocs_cfmx7docs_gs.

CFML Reference Provides descriptions, syntax, usage, and code examples for all ColdFusion

tags, functions, and variables. To see this manual, go to

www.macromedia.com/go/livedocs_cfmx7docs__cfml_reference.

CFML Quick Reference Provides a brief guide that shows the syntax of ColdFusion tags, functions,

and variables.

6 Introduction:

Viewing online documentation

All ColdFusion MX 7 documentation is available online in HTML and Adobe Acrobat Portable

Document Format (PDF) files. Go to the documentation home page for ColdFusion MX on the

Macromedia website: www.macromedia.com. In addition, you can view the documentation in

LiveDocs, which lets you add comments to pages and view the latest comments added by

Macromedia, by going to www.macromedia.com/go/livedocs_cfmx7docs.

CHAPTER 1

Preparing to Install ColdFusion MX 7

This chapter describes Macromedia ColdFusion MX 7 product editions, system requirements,

and other high-level considerations. Before installing ColdFusion MX 7, you should review the

information in this chapter and determine the answers to the questions in the section “Gathering

information necessary to install ColdFusion MX 7” on page 13.

Contents

About the ColdFusion MX 7 installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

ColdFusion MX 7 product editions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

System requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Installation considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Gathering information necessary to install ColdFusion MX 7 . . . . . . . . . . . . . . . . . . . . . . . . . 13

About the ColdFusion MX 7 installation

ColdFusion MX 7 provides a powerful and flexible installation and upgrade process. The

ColdFusion MX 7 installation process includes the following phases:

Plan the installation. You determine your installation, configuration, and upgrade options.

Run the installer. You run the ColdFusion MX 7 installer.

(J2EE configuration only) Deploy ColdFusion MX 7. You deploy and configure

ColdFusion MX 7 on your J2EE application server.

The ColdFusion MX 7 installation process supports the following scenarios:

New installation Install ColdFusion MX 7 on a computer with no previous ColdFusion

installation.

Upgrade installation You can upgrade from ColdFusion 4.5, ColdFusion 5, ColdFusion MX,

and ColdFusion MX 6.1. When upgrading from ColdFusion 4.5, or 5, the installer migrates

previous settings to ColdFusion MX 7. When upgrading from ColdFusion MX or ColdFusion

MX 6.1, the installer preserves the existing settings and installs in a new directory, automatically

assigning ports that do not conflict with the existing installation.

8 Chapter 1: Preparing to Install ColdFusion MX 7

You can install ColdFusion MX 7 in any of the following configurations:

Server configuration Lets you install one instance of ColdFusion MX 7 with an embedded

J2EE server. This configuration most closely resembles the ColdFusion MX base release and other

releases prior to ColdFusion MX, such as ColdFusion 5 and ColdFusion 4.5. This was formerly

known as the stand-alone configuration. For information on installing the server configuration,

see Chapter 2, “Installing the Server Configuration,” on page 15.

Multiserver configuration (Enterprise Edition only) Installs JRun and automatically deploys

ColdFusion MX 7 in a separate JRun server instance. This configuration supports server instance

creation and ColdFusion deployment in the ColdFusion MX Administrator and lets you manage

ColdFusion MX 7 deployments on multiple JRun servers. For information on installing the

multiserver configuration, see Chapter 3, “Installing the Multiserver Configuration,” on page 25.

J2EE configuration (Enterprise Edition only) Lets you deploy ColdFusion MX 7 as a Java

application running on a Java 2 Enterprise Edition (J2EE) application server, either using the

bundled license of JRun or using a third-party J2EE server, such as IBM WebSphere or BEA

WebLogic. When you use the J2EE configuration, you can deploy ColdFusion MX 7 multiple

times on a single computer. For information on installing the J2EE configuration, see Chapter 4,

“Installing the J2EE Configuration,” on page 31.

The remainder of this chapter describes product editions and system requirements. After you

understand the editions and ensure that your environment meets the system requirements,

continue with the instructions in Chapter 2, “Installing the Server Configuration,” on page 15

Chapter 3, “Installing the Multiserver Configuration,” on page 25, or Chapter 4, “Installing the

J2EE Configuration,” on page 31, as appropriate.

ColdFusion MX 7 product editions

The following table describes each edition of ColdFusion MX 7:

Edition Description Licensing

Developer For Windows and Linux.

Supports requests from the local host and two remote IP

addresses. Includes every feature in the Enterprise Edition,

with the following exceptions:.

•Banded reports, output from the cfdocument tag, and

charts are watermarked.

•Verity update is supported on a single-server

configuration only.

•There is a 10K Verity document search limit.

•EAR/WAR deployment is not supported.

•If you install ColdFusion MX 7 in Trial mode, it reverts to

Developer Edition after 30 days.

Free for a single

computer used for

development and

evaluation purposes only.

Applications on

Development Edition

server are viewable from

up to five client machines.

Not licensed for

deployment.

ColdFusion MX 7 product editions 9

Standard For Windows and Linux.

Features full ColdFusion Markup Language (CFML)

support, including:

•Custom tags and ColdFusion Components.

•Full support for server-side ActionScript and

Macromedia Flash Remoting.

•Extensibility and integration with Simple Object Access

Protocol (SOAP) and Extensible Markup Language

(XML), and with Component Object Model (COM),

Enterprise Java Beans (EJBs), and Common Object

Request Broker Architecture (CORBA).

•Rich forms.

•A built-in charting and graphing engine, including

enhancements in ColdFusion MX 7.

•Database connectivity using ODBC with a desktop

database, such as Microsoft Access, and using a Type 4

driver for SQL Server or MySQL.

•Database and LDAP directory authentication, and

resource security.

•A 125K Verity document search limit.

•ColdFusion MX 7 reporting

Licensed per server (up to

eight processors per

server).

Edition Description Licensing

10 Chapter 1: Preparing to Install ColdFusion MX 7

Note: If you have a previous licensed version of ColdFusion installed, and you want to evaluate the

Report Builder, you must install a trial or developer edition of ColdFusion MX 7.

System requirements

The ColdFusion MX 7 system requirements are available on the Macromedia web site. To view

the system requirements, including a list of supported J2EE application servers, go to

www.macromedia.com/go/sysreqscf.

To use third-party JDBC type 4 drivers, see “Connecting to an external JDBC Type 4 data

source” on page 61. The installation instructions also describe how to provide ODBC database

support on Windows.

Enterprise For Windows, Linux, and Solaris.

Includes every feature in the Standard Edition, and also

provides the following:

•Database connectivity using Type 4 drivers for Oracle,

DB2, Sybase, and Informix

•External Event Gateway support, including XMPP/

Jabber IM Gateway, Lotus Sametime IM Gateway,

Asynchronous CFML Gateway, SMS/Mobile Cell

Gateway, and local SMS development toolkit

•The ability to import and execute Java Server Page (JSP)

servlets and JSP Tag Library imports

•Server sandbox security

•A 250K Verity document search

•Advanced server management capabilities, including

server log analysis, configurable probes and alarms, and

automated archive and deployment options

•J2EE support, in particular, Servlet, Java Server Pages

(JSP), and Enterprise JavaBeans (EJB)

•Support for deployment on third-party J2EE application

servers

•Multiserver configuration and J2EE configuration

support running multiple instances of ColdFusion MX 7

on a single computer

•Backup mail servers and multithreaded e-mail delivery

•HTTP-based load-balancing and failover using the

Cluster Manager

•Complete JRun 4 included

•EAR/WAR package creation, and EAR/WAR

deployment

•Archive and deployment services

Licensed per CPU. Initial

license is for two CPUs;

licenses available in two-

CPU increments.

Edition Description Licensing

Other manuals for COLFUSION MX 7 - INSTALLING AND USING COLDFUSION...

Table of contents

Other MACROMEDIA Software manuals

MACROMEDIA

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

MACROMEDIA

MACROMEDIA FLASH COMMUNICATION SERVER MX-SERVER-SIDE COMMUNICATION ACTIONSCRIPT... User manual

MACROMEDIA

MACROMEDIA FLASH 8-INTRODUCTION TO FLASH LITE 2.X... Reference manual

MACROMEDIA

MACROMEDIA FLASH 8-ACTIONSCRIPT 2.0 LANGUAGE Service manual

MACROMEDIA

MACROMEDIA BREEZE-USING THE BREEZE PLUG-IN FOR MICROSOFT... Mounting instructions

MACROMEDIA

MACROMEDIA FLASH MX 2004-FLASH JAVASCRIPT DICTIONARY User manual

MACROMEDIA

MACROMEDIA COLDFUSION MX 61 - INSTALLING COLDFUSION MX FOR IBM WEBSPHERE APPLICATION... User manual

MACROMEDIA

MACROMEDIA BREEZE-USING THE BREEZE XML WEB SERVICES Mounting instructions

MACROMEDIA

MACROMEDIA BREEZE-CLUSTERING BREEZE LIVE User manual

MACROMEDIA

MACROMEDIA BREEZE 5 Operator's manual

MACROMEDIA

MACROMEDIA COLDFUSION MX 7.0.2-USING COLDFUSION MX WITH FLEX... Mounting instructions

MACROMEDIA

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

MACROMEDIA

MACROMEDIA COLDFUSION 4.5-ADMINISTRING COLDFUSION... User manual

MACROMEDIA

MACROMEDIA FLASH MEDIA SERVER 2-DEVELOPING MEDIA User manual

MACROMEDIA

MACROMEDIA CONTRIBUTE 3-CONTRIBUTE PUBLISHING SERVER User manual

MACROMEDIA

MACROMEDIA DIRECTOR MX 2004-USING DIRECTOR Mounting instructions

MACROMEDIA

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

MACROMEDIA

MACROMEDIA CONTRIBUTE 3 - USING AND ADMINISTERING... Mounting instructions

MACROMEDIA

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

MACROMEDIA

MACROMEDIA FIREWORKS 2-USING FIREWORKS Mounting instructions

MACROMEDIA

MACROMEDIA COLDFUSION 5-ADVANCED ADMINISTRATION User manual

MACROMEDIA

MACROMEDIA DIRECTOR MX 2004-USING DIRECTOR Mounting instructions

MACROMEDIA

MACROMEDIA FLASH MX 2004 - FLASH LITE AUTHORING GUIDELINES FOR THE I-MODE... Instruction Manual

MACROMEDIA

MACROMEDIA HOMESITE Installation and operating 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