MACROMEDIA COLDFUSION 5 - INSTALING AND CONFIGURING SERVER 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

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

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

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 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: 617.219.2100

Fax: 617.219.2101

E-mail: sales@macromedia.com

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

Page is loading ...

MACROMEDIA COLDFUSION 5 - INSTALING AND CONFIGURING SERVER, ColdFusion Server 5 User manual

Related papers

Other documents