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

Installing and Using ColdFusion MX for

IBM® WebSphere®Application Server

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 CT27MNA

Acknowledgments

Project Management: Randy Nielsen

Writing: Hal Lichtin, Randy Nielsen

Editing: Linda Adler, Noreen Maher

Third Edition: February 2003

Fourth Edition: September 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. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

CHAPTER 1: Essential Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

About ColdFusion MX for IBM WebSphere Application Server . . . . . . . . . . . . . . . 8

Overview of the J2EE platform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Overview of ColdFusion MX for IBM WebSphere Application Server . . . . . . . . 8

System requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Operating system and Java requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Additional requirements and software support . . . . . . . . . . . . . . . . . . . . . . . . . 10

Directory structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Differences between ColdFusion MX and ColdFusion MX on WebSphere . . . . . . 12

General ColdFusion MX feature differences . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Differences in directory locations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Differences in the ColdFusion MX Administrator . . . . . . . . . . . . . . . . . . . . . . 14

Installing ColdFusion MX for IBM WebSphere Application Server. . . . . . . . . . . . 15

Considerations for all platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Considerations for Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Installation procedure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Creating and migrating applications on ColdFusion MX . . . . . . . . . . . . . . . . . . . 16

Learning about ColdFusion MX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Migrating existing ColdFusion applications . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

CHAPTER 2: Installing on WebSphere V5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Installing and deploying Macromedia ColdFusion MX . . . . . . . . . . . . . . . . . . . . . 18

Installing the ColdFusion MX files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Deploying ColdFusion MX on WebSphere. . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Running the Configuration and Settings Migration Wizard . . . . . . . . . . . . . . . 22

Enabling and configuring specific ColdFusion MX functionality . . . . . . . . . . . . . 23

Enabling features with operating system-specific binaries . . . . . . . . . . . . . . . . . 23

Enabling Access to COM objects (Windows only) . . . . . . . . . . . . . . . . . . . . . . 25

Enabling charting and graphing (UNIX) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Disabling RDS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Undeploying ColdFusion MX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

4 Contents

CHAPTER 3: Installing on WebSphere V4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Installing and deploying Macromedia ColdFusion MX . . . . . . . . . . . . . . . . . . . . . 30

Installing the ColdFusion MX files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Deploying ColdFusion MX on WebSphere. . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Running the Configuration and Settings Migration Wizard . . . . . . . . . . . . . . . 35

Enabling and configuring specific ColdFusion MX functionality . . . . . . . . . . . . . 36

Enabling features with operating system-specific binaries . . . . . . . . . . . . . . . . . 36

Enabling sandbox security (AIX) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Enabling access to COM objects (Windows) . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Enabling charting and graphing (Unix) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Supporting messages from a POP mail server (pre-FixPak 4) . . . . . . . . . . . . . . 40

Disabling RDS after installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Undeploying ColdFusion MX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

CHAPTER 4: Enabling and Using ColdFusion MX Features . . . . . . . . . . . . . . . . . 43

Enabling ColdFusion MX functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Installing Verity Search Packs for ColdFusion MX . . . . . . . . . . . . . . . . . . . . . . 44

Enabling CORBA support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Enabling web services access for Flash Remoting . . . . . . . . . . . . . . . . . . . . . . . 46

Using a third-party JDBC database driver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Managing ColdFusion MX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Managing the ColdFusion MX application. . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Managing ColdFusion MX Windows services . . . . . . . . . . . . . . . . . . . . . . . . . 47

Using the / context root. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

Accessing the ColdFusion MX Administrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Migrating a ColdFusion application to IBM WebSphere Application Server . . . . . 49

Using RDS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

About RDS configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Configuring RDS for a new ColdFusion MX context root . . . . . . . . . . . . . . . . 51

INTRODUCTION

Installing and Using ColdFusion MX for IBM WebSphere Application Server is intended for anyone

who needs to configure and manage their ColdFusion development environment.

About Macromedia ColdFusion MX documentation

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

participants.

Documentation set

The ColdFusion MX documentation set includes the following titles:

Book Description

Installing and Using

ColdFusion MX for IBM

WebSphere

Application Server

Describes system installation and basic configuration for Windows NT,

Windows 2000, AIX, Linux, and Solaris.

Configuring and

Administering

ColdFusion MX

Part I describes how to use the ColdFusion MX Administrator 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

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.

CHAPTER 1

Essential Information

This chapter describes Macromedia ColdFusion MX for IBM WebSphere Application Server and

provides information that applies to all WebSphere installations.

Contents

About ColdFusion MX for IBM WebSphere Application Server . . . . . . . . . . . . . . . . . . . . . . . . 8

System requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Directory structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Differences between ColdFusion MX and ColdFusion MX on WebSphere

Installing ColdFusion MX for IBM WebSphere Application Server . . . . . . . . . . . . . . . . . . . . . 15

Creating and migrating applications on ColdFusion MX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

8 Chapter 1: Essential Information

About ColdFusion MX for IBM WebSphere Application Server

Macromedia ColdFusion MX for IBM WebSphere Application Server enables you to add

ColdFusion MX capabilities to your Sun Java 2 Platform, Enterprise Edition (J2EE) application

server. It is a J2EE application that installs on top of your existing Java application server and

provides development, deployment, and management services for ColdFusion applications.

Overview of the J2EE platform

The J2EE platform is a set of detailed specifications and runtime services for developing

enterprise applications. A J2EE-compliant application is based on standardized, modular

components. J2EE provides these components with a complete set of services, and automatically

handles many details of the application behavior; for example, providing pluggable and scalable

database connection pooling and transparently managing web session clustering and failover.

J2EE provides a security model to protect your data and JDBC, an application programming

interface (API) to access your data. Also, J2EE is interoperable with other technologies that follow

the same modularized standard; for example, you can use Enterprise JavaBeans (EJBs), Java

Servlets, JavaServer Pages (JSP), and XML in your applications.

For more information, see http://java.sun.com/j2ee.

Overview of ColdFusion MX for IBM WebSphere Application Server

The ColdFusion MX for IBM WebSphere Application Server runtime environment is a Java

application that takes advantage of the services in the J2EE platform to connect to databases,

manage security, and process application requests. It provides the full scripting environment of

Macromedia ColdFusion MX and lets you develop fully featured Rich Internet Applications

rapidly and efficiently. When ColdFusion MX for IBM WebSphere Application Server is installed

on top of the WebSphere Application Server, it uses that server’s J2EE runtime to compile and

execute ColdFusion applications.

For more information about Macromedia ColdFusion MX, see the ColdFusion MX

documentation.

For information about differences between ColdFusion MX and ColdFusion MX for IBM

WebSphere Application Server on your operating system and application server version, see

“Differences between ColdFusion MX and ColdFusion MX on WebSphere” on page 12.

System requirements

This section lists the system requirements for ColdFusion MX for Windows and UNIX. This

information was up-to-date at the time this document was written. For any updates, see

www.macromedia.com/go/cfmxj2ee-cert.

Note: If you use Macromedia ColdFusion Studio to develop your web applications, note that

ColdFusion MX supports ColdFusion Studio versions 4.5.2 and 5.0 only.

System requirements 9

Operating system and Java requirements

The following table lists the operating systems supported by the ColdFusion MX for IBM

WebSphere Application Server editions. The following considerations also apply:

•The supported Java runtime environment is the default runtime installed with the application

server.

•Additional system update requirements follow the table.

For the most up-to-date list of certified platforms, see the Macromedia support site,

www.macromedia.com/support/coldfusion.

Include the following updates for your operating system:

•To use Microsoft Access or other databases that require an ODBC driver, on Windows NT 4.0

Server or Windows 2000 Server, you must have the following component installed: MDAC

2.5 SP1 (www.microsoft.com/data/download.htm).

•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.

•To use C++ CFXs with RedHat Linux 8.0, the Linux installation must have a RedHat libc

compatibility library such as the following:

RedHat-8.0 for i386 compat-libstdc++-7.3-2.96.110.i386.rpm

Users must have 7.3-2.* or later.

Edition Operating systems

IBM WebSphere 4 Windows NT 4.0 Server SP6A

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 8

AIX 4.3.3

AIX 5L v 5.1

10 Chapter 1: Essential Information

Additional requirements and software support

The following table lists the hardware requirements, supported browsers, specific supported

application server editions, and supported databases for the various ColdFusion MX for IBM

WebSphere Application Server editions:

Category J2EE server Requirement

Minimum hardware

requirements

All Processor

Windows and Linux: Pentium

Solaris: SPARC

AIX: POWER/3

Minimum RAM

Developer Edition, Windows: 128 MB

All others: 256 MB

Recommended RAM

Developer Mode, Windows: 256 MB

All others: 512 MB

Free hard disk space

To deploy: 400 MB

To run: 250 MB

CD-ROM drive

Browsers supported for

ColdFusion MX

Administrator

All Internet Explorer 5.x, 6

Netscape 4, 6, 7

Mozilla 1.0

Supported Databases All JDBC drivers are included for the

following databases:

Oracle 8.1.6 - 8.1.7, 9i (R1 - R2)

Sybase 11.5 -11.9, 12, 12.5

DB2 for Windows, UNIX, and Linux v7.1,

v7.2, v8.1

DB2 for OS/390 v6.1, v7

Informix 9.2.x, 9.3.x, and 9.4

Microsoft SQL Server 7.0, 2000

MySQL

On Windows, drivers are included for :

Access 97, 98, 2000, 2003

ODBC socket, supports ODBC compliant

databases

Connectivity is provided for all databases

for which JDBC drivers compliant with the

JDBC 3.0 specification are available.

This manual suits for next models

Table of contents

Other MACROMEDIA Software manuals

MACROMEDIA

MACROMEDIA COLDFUSION MX 61-DEVELOPING COLDFUSION MX User manual

MACROMEDIA

MACROMEDIA BREEZE PRESENTER User manual

MACROMEDIA

MACROMEDIA BREEZE User manual

MACROMEDIA

MACROMEDIA FLASH MX 2004-ACTIONSCRIPT LANGUAGE Service manual

MACROMEDIA

MACROMEDIA FLASH 8-GETTING STARTED WITH FLASH User manual

MACROMEDIA

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

MACROMEDIA

MACROMEDIA COLDFUSION MX 61-CFML Service manual

MACROMEDIA

MACROMEDIA BREEZE 5 User manual

MACROMEDIA

MACROMEDIA COLDFUSION 4.5-DEVELOPING WEB User manual

MACROMEDIA

MACROMEDIA BREEZE-USING THE BREEZE PUBLISH WIZARD Mounting instructions

MACROMEDIA

MACROMEDIA CONTRIBUTE-USING CONTRIBUTE Mounting instructions

MACROMEDIA

MACROMEDIA COLFUSION MX 7-CFML User manual

MACROMEDIA

MACROMEDIA FLASH MX PROFESSIONAL 2004 - FLASH LITE 1.1... Instruction Manual

MACROMEDIA

MACROMEDIA BREEZE 5 Operator's manual

MACROMEDIA

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

MACROMEDIA

MACROMEDIA DRUMBEAT 2000 ECOMMERCE EDITION User manual

MACROMEDIA

MACROMEDIA CONTRIBUTE 3-DEPLOYING CONTRIBUTE User manual

MACROMEDIA

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

MACROMEDIA

MACROMEDIA COLDFUSION 5-CFML Service manual

MACROMEDIA

MACROMEDIA FLEX - DEVELOPING COMPONENTS AND THEMES User manual

MACROMEDIA

MACROMEDIA FLASH 8-COMPONENTS LANGUAGE Service manual

MACROMEDIA

MACROMEDIA COLFUSION MX 7-GETTING STARTED BUILDING COLDFUSION... User manual

MACROMEDIA

MACROMEDIA COLDFUSION MX 61 - CONFIGURING AND ADMINISTERING COLDFUSION... User manual

MACROMEDIA

MACROMEDIA COLDFUSION MX 7.0.2-USING COLDFUSION MX WITH FLEX... 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