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

About ColdFusion Documentation xi
About ColdFusion Documentation
ColdFusion Server documentation is designed to provide support for the complete
spectrumof participants. Theprintandonlineversionsareorganizedtoallowyou to
quickly locate the information that you need. The ColdFusion Server online
documentation is provided in HTML.
Printed and online documentation set
The ColdFusion documentation set consists of the following titles.
Viewing online documentation
ColdFusion documentation in Acrobat format is available on the ColdFusion
product CD-ROM and for download from theColdFusion Web site: http://
www.coldfusion.com.
Book Description
Installing and
Configuring
ColdFusion Server
Describes system installation and basic configuration for
Windows, Solaris, Linux, and HP-UX.
Advanced
ColdFusion
Administration
Describes how to connect your data sources to the ColdFusion
Server, configure security for your applications, and how to use
ClusterCATS to manage scalability, clustering, and
load-balancing for your site.
Developing
ColdFusion
Applications
Describes how to use ColdFusion Server to develop your
dynamic Web applications, including retrieving and updating
your data, using structures, and forms.
CFML Reference The online-only 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
install.book Page xi Thursday, May 10, 2001 12:59 PM

xii Welcome to ColdFusion Server
Getting Answers
Oneofthebest ways to solveparticularprogrammingproblemsis to tapintothevast
expertise of the ColdFusion developer communities on the ColdFusion Forums at
http://forums.coldfusion.com. Other developers on the forum can help you figure
out how to do just about anything withColdFusion Server. The search facility can
also help you search messages from the previous 12 months, allowing you to learn
how others have solved a problem that you might be facing. The Forums is a great
resource for learning ColdFusion, but it is also a great place to see the ColdFusion
developer community inaction.
install.book Page xii Thursday, May 10, 2001 12:59 PM

Contacting Macromedia xiii
Contacting Macromedia
Corporate
headquarters Macromedia, Inc.
600 Townsend Street
San Francisco, CA 4103
Tel: [phone]
Fax: [phone]
Web:
Technical support Macromedia offers a range of telephone and Web-based
support options. Go to http://www.coldfusion.com/support/
for a complete description of technical support services.
You can make postings to the ColdFusion Support Forum
(http://forums.coldfusion.com/DevConf/index.cfm) at any
time.
Sales Toll Free: 888.939.2545
Tel: [phone]
Fax: [phone]
E-mail: [e-mail]
Web:
install.book Page xiii Thursday, May 10, 2001 12:59 PM

xiv Welcome to ColdFusion Server
install.book Page xiv Thursday, May 10, 2001 12:59 PM

Chapter 1
Installing ColdFusion Server
in Windows
This chapter explains how to install and configure ColdFusion Server in Windows.
Contents
•Windows System Requirements................................................................................. 4
•Before You Begin the Installation............................................................................... 5
•Installing ColdFusion Server in Windows............................................................... 10
•Configuring Your Installation...................................................................................14
•What to Do Next........................................................................................................ 21
install.book Page 3 Thursday, May 10, 2001 12:59 PM

4 Chapter 1 Installing ColdFusion Server in Windows
Windows System Requirements
The following table compares the system requirements for the ColdFusion Server
Professional and Enterprise Editions:
Requirement
ColdFusion
Server
Professional
ColdFusion
Server
Enterprise
Windows Version
Windows 98 x
Windows NT 4.0 (Workstation and Server) x x
Windows 2000 (Professional*, Server, and
Advanced Server) xx
Hardware
Processor Pentium Pentium
Minimum RAM (MB) 128 256
Recommended RAM (MB) 256 512
Free Hard Disk Space (MB) 200 400
CD-ROM Drive x x
Web Servers
Microsoft Personal Web Server (PWS) x
Microsoft IIS 4.0, 5.0 x x
iPlanet/Netscape Enterprise Server 3.6, 4.1 x x
Apache Server 1.3.x*† xx
O’Reilly WebSite Professional*2.0, 3.0 xx
WebSite Server API (WSAPI)*xx
* ClusterCATS and Application Management features are not supported on
these platforms.
†ColdFusion Server provides a precompiled module that is binary compat-
ible with versions 1.3.6 through 1.3.19. ColdFusion Server also provides
the files required to build a version of the ColdFusion plug-in module for
a custom version of Apache 1.3.x. For more information, see “Configur-
ing Web servers manually”on page 14.
install.book Page 4 Thursday, May 10, 2001 12:59 PM

Before You Begin the Installation 5
Before You Begin the Installation
This section contains the following pre-installation instructions:
•Requiredoperating system updates
•Installing SNMP in Windows NT 4.0 Server and Windows 2000 Server
•Important Network Considerations
•Upgrading from a previous version
•Verifying that a Web server is running
•Removing, modifying, repairing,or updating ColdFusion Server 5
Required operating system updates
Categorized by Windows version, the following table liststhe updates that must be
installed before installing ColdFusion Server 5:
Operating
System Update Where to find it
Windows 98 Service Pack 1 http://www.microsoft.com/downloads/
MDAC 2.5 SP1 http://www.microsoft.com/data/downloads/
MFC/MSVC 6.0 localdrive\ColdFusion
Image\Redistrib\MSVCRT\setup.exe
NT Option Pack http://www.microsoft.com/msdownload/
ntoptionpack/askwiz.asp
Window NT 4.0 Service Pack 6a http://www.microsoft.com/downloads/
MDAC 2.5 SP1 http://www.microsoft.com/data/
download.htm
MFC/MSVC 6.0 localdrive\ColdFusion
Image\Redistrib\MSVCRT\setup.exe
Simple Network
Management
Protocol
(SNMP)*
Required only for MIB functionality. For
instructions, see “Installing SNMP in Windows
NT 4.0 Server and Windows 2000 Server”on
page 6 and “Configuring SNMP MIB”on page
19.
Windows 2000 Service Pack 1 http://www.microsoft.com/downloads/
MDAC 2.5 SP1 http://www.microsoft.com/data/
download.htm
MFC/MSVC 6.0 localdrive\ColdFusion
Image\Redistrib\MSVCRT\setup.exe
install.book Page 5 Thursday, May 10, 2001 12:59 PM

6 Chapter 1 Installing ColdFusion Server in Windows
Installing SNMP in Windows NT 4.0 Server and Windows 2000
Server
Managed data isaccessible in ColdFusion Server 5 Enterprise Edition through the
Simple Network Management Protocol (SNMP) Management Information Base
(MIB) for Advanced ColdFusion Application Management features. You can
integrate thisinformation withyour third-party systemmanagement tools. These
tools provide a way for you to manage diverse components of your enterprise from a
management station in your network.
If you want to use theColdFusion Server MIB features,youmust install SNMP before
installing ColdFusion Server. For instructions, see the following procedures.
To install the SNMP service in Windows NT 4.0:
1 From the Start menu, select Settings > Control Panel > Network > Service Tab >
Add > SNMP Service.
2 The installation begins. When prompted, insert your Windows installation
CD-ROM.
3 Start the SNMP trap service.
Note
If you choseto overwrite new files during the SNMP installation, you mustre-apply
your most recent operating system Service Pack after the SNMP installation because
the SNMP install includes some older files.
To install the SNMP service in Windows 2000:
1 From the Start menu, select Settings > Control Panel > Add/Remove Programs >
Add/Remove Windows Components.
2 Click Management and Monitoring Tools and Details.
3 Select Simple Network Management Protocol, and click OK.
4 To begin the installation, click Next.
SNMP†Required only for MIB functionality. For
instructions, see “Installing SNMP in Windows
NT 4.0 Server and Windows 2000 Server”on
page 6 and “Configuring SNMP MIB”on page
36.
* Windows NT 4.0 Server only
†Windows 2000 Server only
Operating
System Update Where to find it
install.book Page 6 Thursday, May 10, 2001 12:59 PM

Before You Begin the Installation 7
Afterfinishing the ColdFusionServerinstallation, you mustconfigure yoursystemto
use the MIB features. For more information, see “Configuring SNMP MIB” on page
19.
Important Network Considerations
The following table includes important considerations to keep in mind when
configuring your network before the ColdFusion Server installation:
•ColdFusion Server must be installed using the same administrator account that
was used to install Windows and IIS.
•The server runningColdFusionServer should not be configured as a Primary
Domain Controller (PDC) or Backup Domain Controller (BDC). Macromedia
follows Microsoft’s network model in which the first level is the PDC/BDC. These
systems only manage the network/domain and are not designed to run
application servers. ColdFusion Server should reside on the second level of
Windows NT and Windows 2000 standalone systems. Standalone servers can
participate in a network/domain.
•In an optimal production environment, each ColdFusion Server application is
hosted on a dedicated server. A database, mail, or other server should not reside
on the same server as ColdFusionServer.
•If you intend to install ClusterCATS, you must first prepare your server. For
instructions, see “Preparing Your Server for ClusterCATS” on page 135.
•Because Windows NT 4.0 Workstationor Windows 2000 Professional handle only
ten TCP/IP connections concurrently, Macromedia does not recommend using
those operating systems in a production environment. Use Window NT 4.0
Server or Windows 2000 Server. In addition, Macromedia does notrecommend
using Windows 98 because it is not intended as server platforms.
Upgrading from a previous version
The ColdFusion Server 5 installation upgrades your current version of ColdFusion
Server automatically. However, keep in mind the following important instructions
when upgrading from a previous release of ColdFusion Server:
•If you are upgrading from ColdFusion Server 4.0.1 or an earlier release, you must
uninstall the oldversion before installing ColdFusion Server 5.
•Using the ClusterCATS Explorer or btcluadm, you must remove cluster member
servers beforeupgrading them toColdFusion Server 5. Inaddition, some
ClusterCATSmanagement operationsusingthebtcluadmutility requirealicense
key. The license key is "GoColdFusion".
•To continue touse VisiBroker for CORBA connections in ColdFusionServer 5,
copy thelibraries bundled withColdFusion Server 4.5.1 into the appropriate
directory. If you uninstall a previous release of ColdFusion Server before
installing ColdFusion Server 5, theselibraries are removed from your system.
Copy the libraries to a safe location before the uninstall.
•If you usedAdvanced Security policy stores inColdFusion Server 4.5, you must
import that data into ColdFusion Server 5.The ColdFusioninstallation
install.book Page 7 Thursday, May 10, 2001 12:59 PM

8 Chapter 1 Installing ColdFusion Server in Windows
automatically detects and exports policy store data to an Extensible Markup
Language (XML) file named smpolicy451export.xml. It isstored in the
\cfusion\database\ directory. To complete the migration process, log into the
ColdFusion Administrator and click on the Advanced Security link. Detailed
instructions are provided for importing the policy store data.
Warning
Before proceeding withthe upgrade, backup your ColdFusion Server Web
applications.
Verifying that a Web server is running
Before installing ColdFusion Server, check that your Web server is installed and
running.
To check that your local Web server is running:
Enterthe URL for a Web page or site from your local Web server in your browser’s
Address field and press Enter.
For example, if the file myindex.htm is in your Web document root directory, load
the page in your browser using the localhost URL:
http://127.0.0.1/myindex.htm
If your Web server is not running, you willreceive an error message.
Removing, modifying, repairing, or updating ColdFusion
Server 5
To remove ColdFusion Server:
Removing ColdFusion Server deletes all program files and related components from
your system.
1SelectStart > Settings > Control Panel > Add/Remove Programs > ColdFusion
Server 5. Click Remove. then Next.
A dialog box displays to confirm the uninstall.
2 To begin the uninstall, clickYes.
When the program completes, restart your system.
To modify ColdFusion Server:
Modifying the ColdFusion server installation installs and uninstalls the components
that you select.
1SelectStart > Settings > Control Panel > Add/Remove Programs > ColdFusion
Server 5. Click Modify, then Next.
install.book Page 8 Thursday, May 10, 2001 12:59 PM