Tài liệu Installing and Configuring ColdFusion Server doc

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.
This manual, as well as the software described in it, is furnished under license and may
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 any means, electronic,
mechanical, recording, or otherwise, without the prior written permission 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 Windows 98,
Windows ME, Microsoft Access, and FoxPro are registered trademarks of Microsoft
Corporation. All other products or name brands are the trademarks of their respective
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 Begin the Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Required operating system updates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Installing SNMP in Windows NT 4.0 Server and Windows 2000 Server . . . 6
Important Network Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Upgrading from a previous version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Verifying that a Web server is running . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Removing, modifying, repairing, or updating ColdFusion Server 5 . . . . . . 8
Installing ColdFusion Server in Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
ColdFusion Server services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Configuring Your Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Configuring Web servers manually . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Configuring SNMP MIB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Changing the ColdFusion Server 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 Begin the Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Required operating system patches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Installing SNMP in Solaris . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Important Network Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Upgrading from a previous version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Verifying that a Web server is running . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Uninstalling ColdFusion Server 5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 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 Begin the Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Required operating system patches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Installing SNMP in Red Hat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Important Network Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Upgrading from a previous version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Verifying that a Web server is running . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Uninstalling ColdFusion Server 5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Installing ColdFusion Server in Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 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 Begin the Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Required operating system settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

Upgrading from a previous version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Verifying that a Web server is running . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Mounting the installation CD-ROM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Uninstalling ColdFusion Server 5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Installing ColdFusion Server in HP-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
Accessing the 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/Mail Logging. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 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
Automation Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Schedule Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Extensions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
JVM and Java Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Java Applets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
CFX Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Custom Tag Paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
CORBA Connectors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Basic Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
CF Admin Password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Tag Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
CF Studio Password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
install.book Page v Thursday, May 10, 2001 12:59 PM
vi
Tools. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Logs and Statistics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Logging Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Log files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Server Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Chapter 6 Managing Data Sources . . . . . . . . . . . . . . . 109
About ColdFusion Data Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Supported Database Drivers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
What to do next . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Choosing the Correct Drivers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
About ODBC drivers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114

About OLE DB and native drivers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Adding Data Sources for ColdFusion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
ColdFusion Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Verifying ColdFusion Data Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Connecting to Microsoft SQL Server Databases. . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Configuring Microsoft SQL Server Options (Windows) . . . . . . . . . . . . . . . 121
Configuring Microsoft SQL Server Options (UNIX) . . . . . . . . . . . . . . . . . . 122
Connecting to Microsoft Access Databases. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Configuring Microsoft Access Options (Windows) . . . . . . . . . . . . . . . . . . . 123
Tips for connecting to Microsoft Access (Windows) . . . . . . . . . . . . . . . . . . 124
Connecting to Remote Access Data Sources . . . . . . . . . . . . . . . . . . . . . . . . 125
Connecting to Oracle Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
Configuring Oracle 7.3.4/8.0.x options (Windows) . . . . . . . . . . . . . . . . . . . 127
Configuring Oracle 7.3.4/8.0.x options (UNIX) . . . . . . . . . . . . . . . . . . . . . . 127
Connecting to 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 address fail-over . . . . . . . . . . . . . . . . . . . . . . . . 139
Using ClusterCATS dynamic IP addressing . . . . . . . . . . . . . . . . . . . . . . . . . 140
Enabling the STREAMS protocol (Windows NT only) . . . . . . . . . . . . . . . . 140
Configuring firewalls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
Analyzing Web server content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
Considering domain controllers (Windows NT only) . . . . . . . . . . . . . . . . . 145
After You 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
• Installation processes for all supported operating systems
• 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-quality charts and
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.
Enhanced hardware load
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 to setting the standard 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
Macromedia Web
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
spectrum of participants. The print and online versions are organized to allow you 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 the ColdFusion 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
One of the best ways to solve particular programming problems is to tap into the vast
expertise of the ColdFusion developer communities on the ColdFusion Forums at
. Other developers on the forum can help you figure
out how to do just about anything with ColdFusion 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 in action.
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: 415.252.2000
Fax: 415.626.0554
Web:
Technical support Macromedia offers a range of telephone and Web-based
support options. Go to />for a complete description of technical support services.
You can make postings to the ColdFusion Support Forum
( at any
time.
Sales Toll Free: 888.939.2545
Tel: 617.219.2100
Fax: 617.219.2101
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:
• Required operating 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 lists the updates that must be
installed before installing ColdFusion Server 5:
Operating

System Update Where to find it
Windows 98 Service Pack 1 />MDAC 2.5 SP1 />MFC/MSVC 6.0 localdrive\ColdFusion
Image\Redistrib\MSVCRT\setup.exe
NT Option Pack />ntoptionpack/askwiz.asp
Window NT 4.0 Service Pack 6a />MDAC 2.5 SP1 />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 />MDAC 2.5 SP1 />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 is accessible 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 this information with your third-party system management 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 the ColdFusion Server MIB features, you must 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 chose to overwrite new files during the SNMP installation, you must re-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
After finishing the ColdFusion Server installation, you must configure your system to
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 running ColdFusion Server 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 ColdFusion Server.
• 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 Workstation or 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 not recommend
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 old version before installing ColdFusion Server 5.
• Using the ClusterCATS Explorer or
btcluadm
, you must remove cluster member
servers before upgrading them to ColdFusion Server 5. In addition, some
ClusterCATS management operations using the btcluadm utility require a license
key. The license key is "GoColdFusion".
• To continue to use VisiBroker for CORBA connections in ColdFusion Server 5,
copy the libraries bundled with ColdFusion Server 4.5.1 into the appropriate
directory. If you uninstall a previous release of ColdFusion Server before
installing ColdFusion Server 5, these libraries are removed from your system.
Copy the libraries to a safe location before the uninstall.
• If you used Advanced Security policy stores in ColdFusion Server 4.5, you must
import that data into ColdFusion Server 5. The ColdFusion installation
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 is stored 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 with the 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:
Enter the 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 will receive 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.
1Select Start > 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, click Yes.
When the program completes, restart your system.
To modify ColdFusion Server:
Modifying the ColdFusion server installation installs and uninstalls the components
that you select.
1Select Start > Settings > Control Panel > Add/Remove Programs > ColdFusion
Server 5. Click Modify, then Next.
install.book Page 8 Thursday, May 10, 2001 12:59 PM
Before You Begin the Installation 9
A dialog box displays a list ColdFusion Server components.
2 Select the components that you want removed or added, and click Next.
When the program completes, restart your system.
To repair/update ColdFusion Server:
Use the Repair/update feature to reinstall a component of ColdFusion Server.
Repairing ColdFusion Server refreshes the Windows registry, reset settings, and
replace missing files.
1Select Start > Settings > Control Panel > Add/Remove Programs > ColdFusion

Server 5. Click Repair, then Next.
When the program completes, restart your system.
install.book Page 9 Thursday, May 10, 2001 12:59 PM
10 Chapter 1 Installing ColdFusion Server in Windows
Installing ColdFusion Server in Windows
Macromedia recommends that you close all open applications before running the
Setup program. This ensures proper installation of the Merant ODBC 3.7 drivers.
This procedure describes a ColdFusion Server Enterprise Edition installation.
To install ColdFusion Server:
1 Close all open applications.
2 Log into your system using the Local Administrator account.
3 Open the Run dialog and browse to the
setup.exe
file on the ColdFusion Server 5
CD-ROM or an alternate location. Execute the file.
4 After the Welcome and Licence agreement dialogs, the Customer Information
dialog displays. Enter your information, including the ColdFusion Server license
key. You can find your ColdFusion Server license key on the product box and the
CD-ROM packaging.
The Web Server Selection dialog box displays next.
5 Do one of the following:
If your Web server is already installed, the Install Wizard automatically detects
it. Click the radio button for the Web server that you want ColdFusion Server to
use.
If your Web server is not listed, select Other Server and click Next. For
instructions on manually configuring your Web server to work with ColdFusion
Server, see “Configuring Web servers manually” on page 14.
6 After the Choose Destination Path dialog box, the Select Components dialog
displays:
Select the ColdFusion Server components to install. When you select a

component, a brief description displays in the Description box.
install.book Page 10 Thursday, May 10, 2001 12:59 PM
Installing ColdFusion Server in Windows 11
The following table lists important installation options and considerations for
ColdFusion Enterprise Edition customers:
Warning
Because of potential security concerns, the ColdFusion Server team recommends
that you not install the example applications in production environments.
7 After the Assign Password and Confirm Selections dialogs, the Install Wizard
begins copying the ColdFusion Server files to your system.
8 Restart your system.
ColdFusion Server services
The ColdFusion Server installation creates the following services in Windows NT and
Windows 2000:
If You Select Comment
ClusterCATS If you want the server on which you are installing
ClusterCATS to be able to assume the IP address
and HTTP traffic of a failed server in the cluster,
select Web Server (IP) Failover.
ClusterCATS and Application
Management together
The monitoring, alarms, and hardware
load-balancing features cannot be accessed using
the ColdFusion Administrator. Instead, use
ClusterCATS Explorer.
MIB support You must install Windows SNMP service before
installing ColdFusion. The MIB option is available
only if the SNMP service has been installed before
ColdFusion Server. 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.
Service Purpose
ColdFusion Application
Server
The main ColdFusion Server service. ColdFusion pages
cannot be processed if this service is not running.
ColdFusion Executive Polls the ColdFusion Application Server service and, if it is
not running, restarts it.
ColdFusion Remote
Development Service
(RDS)
Provides security, directory and file browsing, and
debugging services for ColdFusion Studio.
* Available only in ColdFusion Server Enterprise
install.book Page 11 Thursday, May 10, 2001 12:59 PM
12 Chapter 1 Installing ColdFusion Server in Windows
Starting and stopping ColdFusion Server services
In general, you should stop and restart ColdFusion Server after making changes in
the ColdFusion Administrator that affect a data source or connection parameter,
such as caching, thread count, and so on.
To start and stop a ColdFusion Service in Windows NT 4.0:
• Select Start > Settings> Control Panel > Services.
If a service is running, its status appears as "Started" in the Status column. If it is
not running, no status appears for the service.
− To stop a service, select it and click Stop. You are prompted to verify that you
want to stop the service; click Yes. The Services window refreshes, and the
status of the service is no longer shown as "Started."
− To start a service, select it and click Start. The status of the service appears as
"Started".

To configure ColdFusion Server to startup automatically or manually in
in Windows NT 4.0:
1Select Start > Settings> Control Panel > Services.
2 Double-click the service that you want to configure. The window for that service
opens.
3 In the Startup Type frame, select either the Automatic or Manual option.
4 To save the configuration, click OK.
SiteMinder Authentication
Service*
Available only if you select the Advanced Security option
during ColdFusion Server setup. Provides user
authentication services for advanced security.
SiteMinder Authorization
Service*
Available only if you select the Advanced Security option
during ColdFusion Server installation. Provides access
authorization services for advanced security.

ColdFusion Management
Service*
Supports ColdFusion Management features, including
Archive/Restore and Server Reporting.
ColdFusion Monitoring
Service*
Monitors the performance and availability of the
ColdFusion Server, the HTTP server, and probes that are
created. This service supports ClusterCATS and
Application Monitoring.
ColdFusion Graphing
Server*

Provides a Java runtime required for Macromedia
Generator (
cfgraph
) support.
ColdFusion Management
Repository Server*
Provides Repository Management facilities for the
ColdFusion Management Service.
Service Purpose
* Available only in ColdFusion Server Enterprise
install.book Page 12 Thursday, May 10, 2001 12:59 PM
Installing ColdFusion Server in Windows 13
To start and stop a ColdFusion Service in Windows 2000:
• Select Start > Control Panel > Settings > Administrative Tools > Services.
If a service is running, its status appears as "Started" in the Status column. If it is
not running, no status appears for the service.
− To stop a service, select it and click Stop. The Services window refreshes, and
the status of the service is no longer shown as "Started".
− To start a service, select it and click Start. The status of the service appears as
"Started".
To configure ColdFusion Server to startup automatically or manually in
Windows 2000:
1 In the MMC, right-click the service that you want to configure and select
Properties.
2 In the Properties dialog, select the General tab. In the Startup Type drop-down
menu, choose either Manual or Automatic.
3Click OK.
Running ColdFusion Server in Windows 98
Since Windows 98 does not have a services architecture, ColdFusion Server runs as
two executables:

When ColdFusion Server is running, two icons appear in the task bar. To stop the
ColdFusion Application Server executable, right-click the IDE service icon. To run
ColdFusion Server at startup, place a shortcut for the ColdFusion Server icon in the
Startup program group.
Executable Purpose
ColdFusion Application
Server
The main ColdFusion Server service. ColdFusion pages
cannot be processed if this service is not running.
ColdFusion RDS Provides security, directory and file browsing, and
debugging services for ColdFusion Studio.
install.book Page 13 Thursday, May 10, 2001 12:59 PM