MACROMEDIA COLDFUSION 5 - INSTALING AND CONFIGURING... User manual

Macromedia, Inc.
Installing and
Configuring
ColdFusion Server
ColdFusion Server 5
install.book Page i Thursday, May 10, 2001 12:59 PM

Copyright Notice
© 2001 Macromedia Inc. All rights reserved.
Thismanual,aswellasthesoftwaredescribedinit,isfurnishedunderlicenseandmay
be used or copied only in accordance with the terms of such license. The content of
this manual is furnished for informational use only, is subject to change without
notice, and should not be construed as a commitment by Macromedia Inc.
Macromedia Inc. assumes no responsibility or liability for any errors or inaccuracies
that may appear in this book.
Except as permitted by such license, no part of this publication may be reproduced,
stored in a retrieval system, or transmitted in any form or by anymeans, electronic,
mechanical, recording, or otherwise, without the priorwrittenpermission of
Macromedia Inc.
ColdFusion and HomeSite are federally registered trademarks of Macromedia Inc,
HomeSite, and the ColdFusion logo are trademarks of Macromedia Inc. in the USA
and other countries. Microsoft, Windows,Windows NT,Windows 2000 Windows98,
Windows ME,Microsoft Access, and FoxProare registered trademarks ofMicrosoft
Corporation.Allotherproductsornamebrandsarethetrademarksoftheirrespective
holders. Solaris is a trademark of Sun Microsystems Inc. UNIX is a trademark of The
Open Group. PostScript is a trademark of Adobe Systems Inc.
Part number: ZCF50MINS
install.book Page ii Thursday, May 10, 2001 12:59 PM

Contents
Welcome to ColdFusion Server . . . . . . . . . . . . . . . . . . . vii
Intended Audience . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . viii
New Features . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . .. . . . . viii
Developer Resources . . . . .. . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . x
About ColdFusion Documentation. . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . xi
Printed and online documentation set . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. xi
Viewing online documentation . . . .. . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. xi
Getting Answers. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . xii
Contacting Macromedia . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . . .. . . . . xiii
Chapter 1 Installing ColdFusion Server in Windows . . 3
Windows System Requirements. .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . 4
Before You Beginthe Installation. . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. 5
Requiredoperating system updates . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . 5
Installing SNMP in Windows NT4.0 Server and Windows 2000 Server . . . 6
Important Network Considerations . . . . . . .. . . . . . . . . .. . . . . . . . . . . . .. . . . 7
Upgrading from a previous version . . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . .. 7
Verifyingthat a Web server is running . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . 8
Removing,modifying, repairing, or updating ColdFusion Server 5 . . . . .. 8
Installing ColdFusion Server inWindows . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . 10
ColdFusion Server services . . . . .. . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . 11
Configuring Your Installation. . . .. . . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . 14
Configuring Web servers manually . . . .. . . . . . . . . .. . . . . . . . . . . . . .. . . . . . 14
Configuring SNMP MIB . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . 19
Changing the ColdFusionServer user account . . . . . . .. . . . . . . . . .. . . . . . 20
What to Do Next . . . . .. . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . 21
install.book Page iii Thursday, May 10, 2001 12:59 PM

iv
Chapter 2 Installing ColdFusion Server in Solaris . . . 23
Solaris System Requirements . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . 24
Before You Beginthe Installation. . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . 25
Requiredoperating system patches . . . . . . .. . . . . . . . . .. . . . . . . . . . . . .. . . 25
Installing SNMP in Solaris . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . 26
Important Network Considerations . . . . . . .. . . . . . . . . .. . . . . . . . . . . . .. . . 27
Upgrading from a previous version . . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . . 27
Verifyingthat a Web server is running . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . 28
Uninstalling ColdFusion Server5 . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . 28
Installing ColdFusion Server in Solaris. . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . 29
ColdFusion Server Processes . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . 31
Configuring Your Installation. . . .. . . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . 33
Configuring Web servers manually . . . .. . . . . . . . . .. . . . . . . . . . . . . .. . . . . . 33
Configuring SNMP MIB . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . 36
Configuring databases . . . . .. . . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . 37
What to Do Next . . . . .. . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . 38
Chapter 3 Installing ColdFusion Server in Linux . . . . 39
Linux System Requirements . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . . .. . . . . . 40
Before You Beginthe Installation. . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . 41
Requiredoperating system patches . . . . . . .. . . . . . . . . .. . . . . . . . . . . . .. . . 41
Installing SNMP in RedHat . . . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . 41
Important Network Considerations . . . . . . .. . . . . . . . . .. . . . . . . . . . . . .. . . 42
Upgrading from a previous version . . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . . 43
Verifyingthat a Web server is running . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . 43
Uninstalling ColdFusion Server5 . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . 43
Installing ColdFusion Server inLinux. . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . 44
ColdFusion Server processes . . . . . .. . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . 46
Configuring Your Installation. . . .. . . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . 48
Configuring Web servers manually . . . .. . . . . . . . . .. . . . . . . . . . . . . .. . . . . . 48
Configuring SNMP MIB . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . 51
Configuring databases . . . . .. . . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . 51
What to Do Next . . . . .. . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . 53
Chapter 4 Installing ColdFusion Server in HP-UX . . . 55
HP-UX System Requirements. . . .. . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . .. . . . . . 56
Before You Beginthe Installation. . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . 57
Requiredoperating system settings . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . 57
Upgrading from a previous version . . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . . 57
Verifyingthat a Web server is running . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . 58
Mounting the installationCD-ROM . . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . . 58
Uninstalling ColdFusion Server5 . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . 59
Installing ColdFusion Server inHP-UX . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . 60
install.book Page iv Thursday, May 10, 2001 12:59 PM

v
ColdFusion Server processes . . . . . .. . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . 61
Configuring Your Installation. . . .. . . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . 62
Configuring Web servers manually . . . .. . . . . . . . . .. . . . . . . . . . . . . .. . . . . . 62
Configuring databases . . . . .. . . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . 64
What to Do Next . . . . .. . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . 66
Chapter 5 Basic ColdFusion Server Administration . 67
Initial Administration Tasks . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . 68
The ColdFusion Administrator. . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . 69
Accessingthe Administrator remotely . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . 69
Server Settings . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . 70
Caching . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . 71
Client Variables . . . . . .. . . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . .. . . 72
Migrating Client Variable Data . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . . 74
Memory Variables. . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . . 76
Locking . . .. . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . .. . . 77
Single threaded sessions . . . . . . .. . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . 77
Variable scope locking settings . . . .. . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . 77
Mappings .. . . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . .. . . 79
Mail/MailLogging.. . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . 80
Data Sources. . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . .. . . . . . 82
Verity Collections . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . 83
Managing collections . . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . . 84
Verity supported file types . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . . 86
Debug Settings. . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . 88
Debug Options . . . . .. . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . 88
Debugging IPs . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . 89
Automated Tasks. . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . 90
AutomationSettings . . . . . .. . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . .. . . . . . 90
Schedule Task . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . 90
Extensions. . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . .. . . . . . 93
JVM and JavaSettings . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . 93
Java Applets . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . 94
CFX Tags . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . 95
CustomTag Paths . . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . .. . . 97
CORBA Connectors .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . 97
Security . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . 99
Basic Security. . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . 100
CF Admin Password . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . . .. . . . . 100
Tag Restrictions . . . . .. . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . 100
CF StudioPassword . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . . .. . . . . 101
install.book Page v Thursday, May 10, 2001 12:59 PM

vi
Tools. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . 102
Logs and Statistics. . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . 103
LoggingSettings . . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . .. . . . . 103
Log files . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . 104
Server Reports . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . 107
Chapter 6 Managing Data Sources . . . . . . . . . . . . . . . 109
About ColdFusion Data Sources . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . 110
Supported Database Drivers. . . . .. . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . .. . . . . 111
What to donext . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . 113
Choosing the Correct Drivers. . . . . . . .. . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . 114
About ODBC drivers .. . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . 114
About OLEDB and native drivers . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . .. . 114
Adding Data Sources for ColdFusion .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . .. . 115
ColdFusion Settings . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . 118
Verifying ColdFusion Data Sources. . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . 120
Connecting toMicrosoft SQLServer Databases. . . . . . . .. . . . . . . . . . . . . .. . . . . 121
Configuring Microsoft SQL Server Options (Windows) . . . . . . . . . .. . . . . 121
Configuring Microsoft SQL Server Options (UNIX) . . . . . . . . .. . . . . . . . . 122
Connecting toMicrosoft Access Databases. . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . 123
Configuring Microsoft Access Options (Windows) . . . . . . . . . .. . . . . . . . . 123
Tips for connecting to Microsoft Access(Windows) . . .. . . . . . . . . . . . .. . 124
Connecting to RemoteAccess Data Sources . . . . .. . . . . . . . . .. . . . . . . . . 125
Connecting toOracle Databases . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . 127
Configuring Oracle 7.3.4/8.0.x options(Windows) . . . . . . . . . . . . . .. . . . . 127
Configuring Oracle 7.3.4/8.0.x options (UNIX) . . . . . . . . . .. . . . . . . . . .. . 127
Connectingto Oracle 7.3.4 and 8.0.x databases (UNIX) . . . . . .. . . . . . . . . 128
Connecting to Oracle 8.0.x through ODBC (UNIX) . . . . . . . . . . . . . .. . . . . 130
Troubleshooting the Oracle 7.3.4 native driver (Windows) . . .. . . . . . . . . 131
Configuring the Oracle 8 Client (Windows, UNIX) . . . . . . .. . . . . . . . . .. . 131
Chapter 7 Preparing Your Server for ClusterCATS . 135
Before You Install ColdFusion Server . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . .. . . . . 136
Configuring DNS servers . . .. . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . .. . . . . 136
Configuring Web server IP addressfail-over . . . . . . . . .. . . . . . . . . .. . . . . 139
Using ClusterCATS dynamic IP addressing . . . . . .. . . . . . . . . . . . . .. . . . . 140
Enablingthe STREAMS protocol (Windows NT only) . . . . . . . . . . .. . . . . 140
Configuring firewalls . . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . 142
Analyzing Web server content . . . . . . . .. . . . . . . . . .. . . . . . . . . . . . . .. . . . . 145
Considering domain controllers (Windows NTonly) . . . . . . . .. . . . . . . . . 145
AfterYou Install ColdFusion Server. . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . . . . 146
install.book Page vi Thursday, May 10, 2001 12:59 PM

Welcome to ColdFusion Server
Installing and Configuring ColdFusion Server is intended for server administrators
and anyone who is new to ColdFusion Server and needs to install and configure
ColdFusion Server 5.
Contents
•Intended Audience...................................................................................................viii
•New Features ............................................................................................................viii
•Developer Resources................................................................................................... x
•About ColdFusion Documentation .......................................................................... xi
•Getting Answers ........................................................................................................xii
•Contacting Macromedia..........................................................................................xiii
install.book Page vii Thursday, May 10, 2001 12:59 PM

viii Welcome to ColdFusion Server
Intended Audience
Installing and Configuring ColdFusion Server is intended for anyone who needs to
install, configure, and maintain ColdFusion Server 5. It describes:
•System requirements
•Installationprocesses for all supported operatingsystems
•Operating system-specific configuration instructions
•Basic configuration options using the ColdFusion Administrator
New Features
The following table lists the new features in ColdFusion 5:
Benefit Feature Description
Breakthrough
productivity User-defined functions Create reusable functions to accelerate development.
Query of queries Easily integrate data from
heterogeneous sources by merging
and querying data in memory using
standard SQL.
Server analysis and
troublshooting Quickly detect and diagnose server
errors with built-in server reporting
and the new Log File Analyzer.
Powerful
business
intelligence
capabilities
Charting engine Create professional-qualitychartsand
graphs from queried data without
leaving the ColdFusion environment.
Enhanced Verity K2
full-text search Index and search up to 250,000
documents and enjoy greater
performance.
Reporting interface for
Crystal Reports 8.0 Create professional-quality tabular
reports from queried data and
applications.
Enhanced
performance Core engine tuning Take advantage of dramatically
improved server performance and
reduced memory usage to deliver
faster, more scalable applications.
Incremental page
delivery Improve response time by delivering
page output to users as it is built.
Wire protocol
database drivers Deliver high-performance ODBC connectivity using new drivers.
install.book Page viii Thursday, May 10, 2001 12:59 PM

New Features ix
Easy
managment Application deployment
services Effortlessly and reliably deploy,
archive, or restore entire applications
using ColdFusion archive files.
Enhanced application
monitoring Keep track of server performance and availability with customizable alerts
and recovery.
SNMP support Monitor ColdFusion applications from
enterprise management systems.
Expanded
integration Expanded Linux support Deploy on additional Linux
distributions, including SuSE and
Cobalt.
Enhancedhardwareload
balancer integration Apply optimized, agent-based support
for hardware load balancers,
including new support for the Cisco
CSS 11000.
Enhanced COM support Experience easier integration with
COM components.
Benefit Feature Description
install.book Page ix Thursday, May 10, 2001 12:59 PM

x Welcome to ColdFusion Server
Developer Resources
Macromedia Corporation is committed tosetting thestandard for customer support
in developer education, technical support, and professional services. The Web site is
designed to give you quick access to the entire range of online resources, as the
following table describes.
Resource Description URL
MacromediaWeb
site General information about Macromedia products and services
Information on
ColdFusion Detailed product information on ColdFusion and related topics
Technical
Support Professional support programs that Macromedia offers.
ColdFusion
Support Forum Access to experienced ColdFusion developers through participation in the
Online Forums, where you can post
messages and read replies on many
subjects relating to ColdFusion.
Installation
Support Support for installation-related issues for all Macromedia products
Professional
Education Information about classes, on-site training, and online courses offered by
Macromedia
Developer
Community All the resources that you need to stay on the cutting edge of ColdFusion
development, including online discussion
groups, Knowledge Base, technical
papers and more
ColdFusion Dev
Center Development tips, articles, documentation, and white papers
Macromedia
Alliance Connection with the growing network of solution providers, application
developers, resellers, and hosting
services creating solutions with
ColdFusion
install.book Page x Thursday, May 10, 2001 12:59 PM