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

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

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

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

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

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

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
http://forums.coldfusion.com. 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

• 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

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

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

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

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

• 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.

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