User Guide

3
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