Adobe 38043740 User Guide - Page 4

iv

Installing Dreamweaver extensions

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

Installing HomeSite+ Extensions

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

Installing Report Builder

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

Installing Verity Search Server

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

Enabling Flash Remoting

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

Installing Flash Remoting Update

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

Installing Adobe LiveCycle Data Services ES

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

Installing the ColdFusion .NET Integration Services

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

Installing ColdFusion Extensions for Eclipse

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

Chapter 7: Configuring Your System

Overview of configuration tasks

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

Managing ColdFusion services in Windows

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

Managing the ColdFusion process in UNIX

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

Managing the ColdFusion process in Mac OS X

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

Configuring web servers

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

Enabling CORBA support

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

Disabling Remote Development Services

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

Disabling JSP functionality (server configuration only)

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

Changing the ColdFusion user account in Windows

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

Chapter 8: Troubleshooting

Common installation problems

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

Data source problems

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

Migration problems

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

J2EE configuration problems

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101

Postinstallation problems

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102

Uninstall problems

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

Index

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

Adobe 38043740 User Guide - Page 4

Configuring Your System, Troubleshooting, Index

Page 4 highlights

Section	Page
Contents	3
Chapter 1: Introduction	5
About ColdFusion documentation	5
Documentation set	5
Viewing online documentation	5
Chapter 2: Preparing to Install ColdFusion	7
About the ColdFusion installation	7
ColdFusion 8 product editions	8
System requirements	8
Installation considerations	8
Installation considerations for all platforms	9
Installation considerations for Windows	9
Installation considerations for UNIX	10
Chapter 3: Installing the Server Configuration	11
Gathering information necessary to install the server configuration	11
Installing ColdFusion using the server configuration	13
Installing ColdFusion server configuration in Windows	13
Installing the ColdFusion server configuration in UNIX	14
ColdFusion server configuration directory structure	16
Using the built-in web server	17
Switching the port for the built-in web server	17
Switching from another web server	18
Uninstalling ColdFusion	19
Chapter 4: Installing the Multiserver Configuration	21
Gathering information necessary to install the multiserver configuration	21
About multiserver configuration	23
Installing ColdFusion using the multiserver configuration	24
Installing the multiserver configuration in Windows	24
Installing the multiserver configuration in UNIX	26
Configuration	27
Uninstalling ColdFusion	28
Chapter 5: Installing the J2EE Configuration	29
Gathering information necessary to install the J2EE configuration	29
ColdFusion and J2EE application servers	31
Choosing EAR or WAR deployment	31
Context root	32
Multiple instances	33
Platforms	33
Preparing to install using the J2EE configuration	34
Installing an EAR file or WAR files	34
Installing an EAR file or WAR files in Windows	35
Installing an EAR file or WAR files in UNIX	36
Installing an EAR file or WAR files in Mac OS X	38
Updating from an earlier version for J2EE	40
ColdFusion J2EE deployment and configuration	41
Deploying ColdFusion 8 on JRun 4	42
Deploying ColdFusion 8 on IBM WebSphere	46
Deploying ColdFusion 8 on BEA WebLogic	56
Deploying ColdFusion 8 on Oracle Application Server 10g	61
Deploying ColdFusion 8 on JBoss Application Server	64
Undeploying ColdFusion	69
Chapter 6: Installing Integrated Technologies	71
Integrated Adobe and third-party technologies	71
Installing Dreamweaver extensions	71
Installing HomeSite+ Extensions	72
Installing Report Builder	73
Installing Verity Search Server	73
Installing Verity on Linux	74
Enabling Flash Remoting	74
Installing Flash Remoting Update	75
Installing Adobe LiveCycle Data Services ES	76
Installing the ColdFusion .NET Integration Services	76
Installing ColdFusion .NET Integration Services with ColdFusion	76
Installing ColdFusion .NET Service separately	76
Installing ColdFusion Extensions for Eclipse	77
Chapter 7: Configuring Your System	79
Overview of configuration tasks	79
Managing ColdFusion services in Windows	80
Managing the ColdFusion process in UNIX	81
Managing the ColdFusion process in Mac OS X	82
Configuring web servers	83
Configuring web servers in Windows	84
Configuring web servers in UNIX	88
Installing Verity Locales	91
Enabling CORBA support	92
System requirements	92
Installing Visibroker for CORBA connections	93
Disabling Remote Development Services	95
Disabling JSP functionality (server configuration only)	96
Changing the ColdFusion user account in Windows	97
Chapter 8: Troubleshooting	99
Common installation problems	99
Spaces in the TEMP or TMP environment variables (Windows only)	99
Incomplete download	99
Web Server connectors not installed	100
Server error	100
Cannot start ColdFusion Server	101
Cannot access Flash content locally	101
Errors displaying Flash forms	101
Browsing a ColdFusion page displays a download window	102
ColdFusion Administrator displays as an encrypted page	102
ColdFusion doesn’t start	102
Data source problems	103
Unable to add a Microsoft Access data source	103
ODBC services do not install properly	103
Unable to INSERT or UPDATE an Oracle 10 database when there is a CLOB field	104
Migration problems	104
Data sources not recognized	104
CFCs not recognized in Dreamweaver	104
Installation fails	105
Installation fails	105
J2EE configuration problems	105
Postinstallation problems	106
CLOB and data corruption	106
Unsupported keysize or algorithm parameters	106
Virtual mapping resource path of /* does not work	107
Uninstall problems	107
COM disabled	107
Index	109
A	109
Adobe Flex 70	109
Apache web server	109
configuring in UNIX 84	109
configuring in Windows 83	109
application isolation 19, 29	109
application.xml file, web-uri element 39, 43, 61	109
applications, hosting 5	109
B	109
Backup Domain Controller 5	109
BEA WebLogic 52	109
built-in web server, using 5, 13	109
C	109
clustering 19, 29	109
coexist, with earlier versions of ColdFusion 5	109
ColdFusion	109
starting in UNIX 78, 79	109
coldfusion command (UNIX) 78, 79	109
ColdFusion, editions 4	109
COM support 47	109
COM support, JVM arguments for J2EE 41, 42	109
configuration	109
multiserver 19	109
tasks, overview of 75	109
types of 4	109
context path 28	109
context root 28, 40	109
CORBA	109
enabling 88	109
D	109
deployment	109
app server differences 30	109
app server mechanisms 37	109
directory structure	109
EAR 28	109
WAR 27	109
directory structure, expanded 28, 30	109
disabling RDS 91	109
E	109
EAR file 43, 60	109
EAR file, expanding 39	109
EAR. See enterprise application archive	109
enterprise application archive (EAR)	109
deployment options 30	109
directory structure 28	109
expanded directory structure 28	109
expanded directory structure 30	109
external web servers	109
configuring 79	109
storing CFM pages on 23	109
F	109
failover 19, 29	109
Flash Remoting 70	109
H	109
headless switch 42	109
horizontal clustering 44	109
hosting, disabling JSPs 92	109
I	109
IIS	109
configuring 80	109
IIS6 81	109
installation wizard, starting 10	109
installer, Java-only 6	109
installing	109
considerations for UNIX 6	109
considerations for Windows 5	109
general considerations 5	109
in UNIX 22, 32	109
in Windows 9, 20, 31	109
multiserver configuration in UNIX 22	109
multiserver configuration in Windows 20	109
multiserver configuration on UNIX 22	109
multiserver configuration, about 20	109
on UNIX 10	109
internal web servers 13	109
iPlanet web server	109
configuring in UNIX 85	109
configuring in Windows 82	109
configuring on UNIX 85	109
J	109
J2EE configuration	109
all-Java version 29	109
deployment 37	109
directory structure 37	109
installing 20	109
JRun Windows install 20, 22	109
multiple instances 29	109
undeploying 65	110
UNIX install 32, 34	110
Windows install 31	110
J2EE servers, third-party 4	110
java.lang.SecurityManager 23, 42	110
Java-only installer 6	110
jIntegra binary directories 41, 42	110
JRE 5	110
JRun	110
installing 20	110
installing in Windows 20	110
installing on Unix 22	110
JRun Management Console (JMC), JVM arguments 24	110
JRun server 19	110
jvm.config file, JVM arguments 24	110
L	110
Linux 48	110
Linux, configuring web servers in 85	110
LiveCycle Data Services ES 64	110
load balancing 19, 29	110
log file, on UNIX 6	110
M	110
Microsoft network model 5	110
migrating	110
from previous versions of ColdFusion 36	110
multiple instances of ColdFusion 19, 29	110
multiple server instances 19, 29	110
multiserver configuration, installing 20	110
N	110
network model 5	110
O	110
Oracle Application Server 10g 57	110
P	110
platform-specific binary files 29	110
port	110
8300 20	110
JRun web server 20	110
Primary Domain Controller 5	110
production environment 5	110
R	110
RDS, disabling 91	110
rds.war, about 27	110
S	110
sandbox security 46	110
sandbox security, enabling in J2EE 23, 42	110
server configuration 4	110
server instances, multiple 19, 29	110
servers	110
dedicated 5	110
setup.exe 10, 21, 31	110
Solaris 42, 48	110
start	110
ColdFusion on UNIX 78, 79	110
installation wizard 10	110
stop	110
ColdFusion on UNIX 11	110
SunONE web server, configuring on UNIX 85	110
switch web servers 88	110
system requirements	110
overview 4	110
T	110
TCP/IP connections 6	110
This 11	110
troubleshooting, log file 6	110
U	110
undeploying 65	110
uninstalling	110
from Windows 15	110
UNIX 22	110
configuring iPlanet web server on 85	110
configuring Netscape web server on 85	110
installation considerations 6	110
managing process in 77	110
starting ColdFusion on 78, 79	110
user account, changing for ColdFusion 93	110
V	110
Verity	110
locales, installing 87	110
requirements 78, 79	110
vertical clustering 44	110
W	110
WAR file 40	110
WAR. See web application archive	110
web application archive (WAR)	110
deployment options 30	110
directory structure 27	110
Web Server Configuration Tool	110
about 79	110
shell scripts 11	110
starting with coldfusion command (UNIX) 78, 79	110
web servers	110
Apache in Windows 83	110
Apache on UNIX 84	110
built-in 5, 13	111
configuring overview 79	111
IIS 80	111
internal 13	111
iPlanet in Windows 82	111
iPlanet on UNIX 85	111
SunONE in Windows 82	111
SunONE on UNIX 85	111
switching 88	111
WebLogic 52	111
WebSphere Application Server 42	111
WebSphere ND 45	111
Windows	111
installation considerations 5	111
installing in 9	111
installing multiserver configuration in 20	111