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

Windows System RequirementsThe following table compares the system requirements for the ColdFusion Server Professional and Enterprise Editions: Requirement ColdFusion Server Professional

Macromedia, Inc.

Installing and

Configuring ColdFusion Server

ColdFusion Server 5

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

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

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

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

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

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

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:

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

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

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

ColdFusion Dev

Center

Development tips, articles, documentation, and white papersMacromedia

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

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

Contacting Macromedia xiii

Contacting Macromedia

Corporate headquarters

Macromedia, Inc

600 Townsend StreetSan Francisco, CA 4103Tel: 415.252.2000Fax: 415.626.0554Web:

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

Tel: 617.219.2100Fax: 617.219.2101E-mail: sales@macromedia.comWeb:

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

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 2000 (Professional*, Server, and Advanced Server)

O’Reilly WebSite Professional* 2.0, 3.0 x x

* ClusterCATS and Application Management features are not supported on these platforms

† ColdFusion Server provides a precompiled module that is binary 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

compat-a custom version of Apcompat-ache 1.3.x For more informcompat-ation, see ing Web servers manually” on page 14

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

Windows 98 Service Pack 1 http://www.microsoft.com/downloads/

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

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 >

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

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

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

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

1 Select Start > Settings > Control Panel > Add/Remove Programs > ColdFusion

Server 5 Click Modify, then Next

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

1 Select Start > Settings > Control Panel > Add/Remove Programs > ColdFusion

Server 5 Click Repair, then Next

When the program completes, restart your system

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

Installing ColdFusion Server in Windows 11

The following table lists important installation options and considerations for ColdFusion Enterprise Edition customers:

8 Restart your system

ColdFusion Server services

The ColdFusion Server installation creates the following services in Windows NT and Windows 2000:

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

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

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:

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

* Available only in ColdFusion Server Enterprise

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

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

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

Configuring Your Installation

After installing ColdFusion Server, you may have to perform the following actions:

• Configuring Web servers manually

• Configuring SNMP MIB

• Changing the ColdFusion Server user account

Configuring Web servers manually

If you selected Other Server in the Web Server Selection dialog, or your Web server was not detected by the Install Wizard, you must manually configure it This section explains how to do this in Windows NT and Windows 2000 The instructions assume ColdFusion Server is installed in c:\cfusion

This section explains how to configure these Web servers:

• Internet Information Services (IIS)

• Apache Web server

• Netscape/iPlanet Enterprise Web Server

• O’Reilly WebSite Professional

Internet Information Services (IIS)

The following procedure uses Windows 2000 Professional as the example operating system The steps for Windows NT 4.0 are similar

Tip

If you run ColdFusion Server on Windows 2000 with IIS5, you can improve performance as follows: open the Internet Services Manager, right-click Default Web Site, and select Properties On the Home Directory tab, select Low (IIS Process) in the Application Protection drop-down list, and click Apply Stop IIS Admin and all Web services from the Windows NT Control Panel, and then restart IIS

To configure IIS for ColdFusion Server:

1 Start the Microsoft Management Console (MMC) by selecting Start > Programs >

Administrative Tools > Computer Management

Configuring Your Installation 15

The MMC displays:

2 In the Tree tab, under the Internet Information Services tree, right-click your Web site and select Properties

The Properties dialog box displays:

3 Click the Home Directory tab, then Configuration

Note

If the Configuration button is greyed out, click Create, then click Configuration

The Application Configuration dialog box displays:

4 In the App Mappings tab, select entries for.cfm and dbm, and click Remove

5 Click Add

The Add/Edit Application Extension Mappings dialog box displays:

6 Click Browse and go to c:\cfusion\bin\iscf.dll Enter cfm in the Extension text box, and verify that the Script engine check box is selected Click OK

7 Repeat Step 6, substituting dbm for the extension

Note

In previous versions, ColdFusion Server used the dbm file extension for ColdFusion Server files Macromedia recommends that you rename templates that have a dbm extension to cfm

8 Click OK in the Application Configuration dialog box to save your changes

Configuring Your Installation 17

Apache Web server

This procedure assumes that the Apache Web server is installed in c:\Apache

To configure Apache for ColdFusion Server:

1 If it is not already installed, download the Apache Web server from the Apache HTTP Server Project Web site at http://www.apache.org/ Read the Windows documentation at http://www.apache.org/docs/windows.html

2 If a version of the Apache Web server is running, shut down the Web server

3 Copy the cfusion\bin\ApacheModuleColdFusion.dll module to your Apache modules directory

For example: c:\Apache\modules\ApacheModuleColdFusion.dll

4 Edit the Apache configuration file (c:\Apache\conf\httpd.conf) Add this line:LoadModule coldfusion_module modules/ApacheModuleColdFusion.dll

5 Restart the Apache Web server

Netscape/iPlanet Enterprise Web Server

Manually configuring Netscape/iPlanet Web servers for ColdFusion Server requires modifying two files, obj.conf and mime.types, in the Netscape/iPlanet Web server directory, such as c:\netscape\server4\https-yourserver.com\config

Warning

Ensure that you do not alter files in the backup or install directories

To configure Netscape/iPlanet for ColdFusion Server:

1 Make a backup copy of the obj.conf file

2 Insert the following line at the top of the obj.conf file:

Init fn="load-modules" funcs="DoCFRequest" shlib="C:/CFUSION/Bin/ NS4CF.DLL"

3 Look for the following line in the same obj.conf file:

Service method =(GET|HEAD) type="magnus-internal/imagemap"

fn="imagemap"

After this line, insert the following line:

Service fn="DoCFRequest" method="(GET|POST)" type="magnus-internal/ cold-fusion"

4 Make a backup copy of the mime.types file, which is located in the same directory as the obj.conf file

5 Insert the following line to the mime.types file:

type=magnus-internal/cold-fusion exts=dbm,cfm,dbml,cfml

6 Go into the Netscape Administrator, and save the changes

Netscape is case sensitive, so add the lines exactly as they appear here Enter each command one line If you remove ColdFusion Server, you must undo these changes Otherwise, the iPlanet/Netscape Web server will not work

O’Reilly WebSite Professional

This example uses Windows 2000 Professional as the example operating system and O’Reilly WebSite Professional 3.0 as the Web server

To configure O’Reilly WebSite Professional for ColdFusion Server:

1 Select Start > Programs > WebSite Professional > Server Properties

The WebSite Pro Server Properties dialog box displays:

2 In the Mapping tab, click Associations in the Mapping Types box

a In the File Extension text box, enter cfm

b In the File Extension text box, click Browse; go to c:\cfusion\bin\WSCF.DLL Click Add

c Repeat Step 2, substituting dbm

d Click Add

The cfm and dbm mappings display in the File Extension box

3 In the Mapping tab, in the Mapping Types box, click Content Types

a In the File Extension text box, enter cfm and dbm

b In the Media or Server-Side Content text field, enter wwwserver/wsapi

c Click Add

Configuring Your Installation 19

Configuring SNMP MIB

To use the ColdFusion Server MIB features, you must configure these settings:

1 For each system, such as a system with the IP address 192.178.64.88, that is to receive trap messages from the local host, open the local host’s Registry to:

\\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\SNMP\Paramete rs\TrapConfiguration\public

For each system, add a value in the following form:

1: REG_SZ:192.178.64.88

2 Open the Debug Options page of the ColdFusion Administrator, and ensure that the Enable Performance Monitoring checkbox is selected

Tip

You can find a copy of the MIB definition in CFusion/cfam/Database/lhmib.mib

Using HTTPS and non-default ports

To use HTTPS, a different Web server name, or a different port to access the Web document root for ColdFusion MIB information, modify <installdir>/cfam/

Database/mib.properties For example, this file usually contains a single entry, such as http://maine wheremaine is the local host name, and http://maine is the Web document root for the ColdFusion MIB information To use HTTPS, a different Web document root (maine1), and port (459), edit the entry to https://maine1:459

Changing the ColdFusion Server user account

By default, ColdFusion Server runs under the host’s System account However, under this account, ColdFusion application pages may have access rights to interact with remote data sources, other application pages, and COM objects

You may have to run ColdFusion Server under a account that provides the necessary access rights These instructions use Windows 2000 Professional operating system

To change the ColdFusion Server user account:

1 Start the MMC by selecting Start > Programs > Administrative Tools > Computer

Management

a In the Tree tab, expand Services and Applications and select Services

b Right-click ColdFusion Application Server and select Properties

The ColdFusion Application Server Properties dialog box displays:

2 Select the Log On tab Click This account Enter appropriate account information

3 Click OK to apply the changes

Restart ColdFusion Server services

Warning

Do not rename your Windows Administrator account It causes problems with security policies and profiles

What to Do Next 21

What to Do Next

After installing ColdFusion Server and configuring your installation, you must perform some initial administration tasks using the ColdFusion Administrator, ColdFusion Server’s Web-based control console For more information, see “Initial Administration Tasks” on page 68

• Solaris System Requirements 24

• Before You Begin the Installation 25

• Installing ColdFusion Server in Solaris 29

• Configuring Your Installation 33

• What to Do Next 38

Solaris System Requirements

The following table contains the system requirements for the ColdFusion Server Enterprise Edition:

Requirement

ColdFusion Server Enterprise Solaris Version

compat-a custom version of Apcompat-ache 1.3.x For more informcompat-ation, see ing Web servers manually” on page 33

“Configur-Before You Begin the Installation 25

Before You Begin the Installation

This section contains the following pre-installation instructions:

• Required operating system patches

• Installing SNMP in Solaris

• Important Network Considerations

• Upgrading from a previous version

• Verifying that a Web server is running

• Uninstalling ColdFusion Server 5

Required operating system patches

The following table lists the patches and packages that must be installed before installing ColdFusion Server 5:

Note

All versions of Solaris require the SUNWxcu4 XCU4 Utilities package To download all patches and packages, go to http://sunsolve.sun.com

Operating

Solaris 2.6 105181-17 or higher Kernel patch

105591-09 or higher LibC: Shared library patch for C++

105210-25 or higher LibC: Shared library patch for C/C++

105568-14 or higher libthread: Shared library patchSolstice Enterprise

Agent (SEA) Runtime 1.0.3

Required only for MIB functionality For instructions, see “Installing SNMP in Solaris”

on page 26

Solaris 7 106541-08 or higher Kernel patch

106327-08 or higher LibC: Shared library patch for C++

106980-07 or higher libthread: Shared library patch107709-10 or higher Required only for MIB functionality For

instructions, see “Installing SNMP in Solaris”

on page 26

Solaris 8 108869-03 or higher Required only for MIB functionality For

instructions, see “Installing SNMP in Solaris”

on page 26

en_US locale U.S English language pack

Installing SNMP in Solaris

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

2 Install the SEA Runtime by performing the following steps:

a Uncompress the SEA file by entering the following command:

uncompress solaris2.6-sparc-rt.tar.Z tar -xvf solaris2.6-sparc-rt.tar

b Install the SEA packages, in sequence, as follows:

pkgadd -d SUNWmibii pkgadd -d SUNWsasnm pkgadd -d SUNWsadmi pkgadd -d SUNWsacom

Note

For more information on installing the SEA packages, see Chapter 2, "Installing Solstice Enterprise Agent" in the SEA User Guide Release 1.0 (docs/UGhtml/install_solaris.doc.html)

3 Apply Solaris patch 106787-12 or higher

4 Restart the SNMP process

To install SNMP in Solaris 7 and 8:

• For Solaris 7 install Solaris patch 107709-10 or higher

• For Solaris 8 install Solaris patch 108869-03 or higherAfter installing the ColdFusion Server, you must configure your system to use the MIB features For more information, see “Configuring SNMP MIB” on page 36

Before You Begin the Installation 27

Important Network Considerations

The following table includes important considerations to keep in mind when configuring your network before the ColdFusion Server installation:

• To install and configure Advanced Security for ColdFusion Server, you must have

an installed, running LDAP server available on your network You must have the Directory Manager DN, password, IP/port, and Root DN for this server

• If you intend to install ClusterCATS, you must first prepare your cluster For instructions, see “Preparing Your Server for ClusterCATS” on page 135

• ClusterCATS requires that the group btcats exist It attempts to create this group during the ColdFusion installation using groupadd If you are using NIS or NIS+, ensure that either nsswitch.conf allows for group resolution from the group file,

or the group btcats gets created in NIS/NIS+ before installing ClusterCATS

• In an optimal production environment, each ColdFusion Server application is hosted on a dedicated server A database, mail, or other server reside on the same server as ColdFusion Server

• Note the location and version number of your installed Web server The pkgaddutility prompts you for this information

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 or earlier, you must first run the registry migration utility cfregup.sh to preserve your registry settings You must uninstall the old version by running the pkgrm utility For details, see the

README.cfregup file

• If you are upgrading from ColdFusion 4.5, depending on the installation defaults

of your pkgadd utilities, you may have to edit the package installation defaults file before running the pkgadd utility This file is located at /var/sadm/install/admin/default Change the value of the instance from quit or unique to overwrite THis lets the new version of ColdFusion Server overwrite the existing version

• Using ClusterCATS Explorer or btcluadm, you must remove cluster member servers before upgrading them to ColdFusion Server 5 ALso, 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

Note

Before proceeding with the upgrade, backup your ColdFusion Server Web applications

Verifying that a Web server is running

Before installing ColdFusion Server, ensure 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

Uninstalling ColdFusion Server 5

Use the pkgrm utility to remove an installed version of ColdFusion Server