Macromedia ColdFusion - 8.0 User Manual
ADOBE® COLDFUSION™8
CONFIGURING AND ADMINISTERING COLDFUSION
© 2007 Adobe Systems Incorporated. All rights reserved.
Adobe® ColdFusion® Configuring and Administering ColdFusion
If this guide is distributed with software that includes an end user agreement, this guide, 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. Except as permitted by any such
license, no part of this guide 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 Adobe Systems Incorporated. Please note that the content
in this guide is protected under copyright law even if it is not distributed with software that includes an end user license agreement.
The content of this guide is furnished for informational use only, is subject to change without notice, and should not be construed as a
commitment by Adobe Systems Incorporated. Adobe Systems Incorporated assumes no responsibility or liability for any errors or
inaccuracies that may appear in the informational content contained in this guide.
Any references to company names in sample templates are for demonstration purposes only and are not intended to refer to any actual
organization.
Adobe, the Adobe logo, Acrobat, ColdFusion, Dreamweaver, Flash, FlashPaper, Flex, HomeSite, LiveCycle, and Macromedia are either
registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries.
IBM is a trademark of International Business Machines Corporation in the United States, other countries, or both. Java, Solaris, and
Sun are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries. Linux is the registered
trademark of Linus Torvalds in the U.S. and other countries. Solaris is a trademark or registered trademark of Sun Microsystems, Inc. in
the United States and other countries. UNIX is a trademark of The Open Group in the US and other countries. Microsoft is either a
registered trademark or a trademark of Microsoft Corporation in the United States and/or other countries. All other trademarks are the
property of their respective owners.
This product includes software developed by the Apache Software Foundation (http://www.apache.org/)
This product contains either BISAFE and/or TIPEM software by RSA Data Security, Inc.
Portions include technology used under license from Autonomy, and are copyrighted.
Verity and TOPIC are registered trademarks of Autonomy.
Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA.
Notice to U.S. Government End Users. The Software and Documentation are “Commercial Items,” as that term is defined at 48 C.F.R.
§2.101, consisting of “Commercial Computer Software” and “Commercial Computer Software Documentation,” as such terms are
used in 48 C.F.R. §12.212 or 48 C.F.R. §227.7202, as applicable. Consistent with 48 C.F.R. §12.212 or 48 C.F.R. §§227.7202-1
through 227.7202-4, as applicable, the Commercial Computer Software and Commercial Computer Software Documentation are
being licensed to U.S. Government end users (a) only as Commercial Items and (b) with only those rights as are granted to all other end
users pursuant to the terms and conditions herein. Unpublished-rights reserved under the copyright laws of the United States. For U.S.
Government End Users, Adobe agrees to comply with all applicable equal opportunity laws including, if appropriate, the provisions of
Executive Order 11246, as amended, Section 402 of the Vietnam Era Veterans Readjustment Assistance Act of 1974 (38 USC 4212),
and Section 503 of the Rehabilitation Act of 1973, as amended, and the regulations at 41 CFR Parts 60-1 through 60-60, 60-250, and
60-741. The affirmative action clause and regulations contained in the preceding sentence shall be incorporated by reference.
Part Number: 90084501 (06/07)
Contents
Chapter 1: Introduction
Administering ColdFusion 3
Chapter 2: Administering ColdFusion
About the ColdFusion Administrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Chapter 3: Using the ColdFusion Administrator
Initial administration tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Accessing user assistance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Server Settings section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Data & Services section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Debugging & Logging section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Server Monitoring section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Extensions section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Event Gateways section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Security section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Packaging and Deployment section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Enterprise Manager section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Custom Extensions section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Administrator API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
iii
Chapter 4: Data Source Management
About JDBC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Adding data sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Connecting to Apache Derby Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Connecting to Apache Derby Embedded . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Connecting to DB2 Universal Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Connecting to Informix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Connecting to Microsoft Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Connecting to Microsoft Access with Unicode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Connecting to Microsoft SQL Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Connecting to MySQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
CONTENTS
iv
Connecting to ODBC Socket . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Connecting to Oracle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Connecting to other data sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Connecting to PostgreSQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Connecting to Sybase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Connecting to JNDI data sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Connecting to an external JDBC Type 4 data source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Chapter 5: Web Server Management
About web servers in ColdFusion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Using the built-in web server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Using an external web server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Web server configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Multihoming . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Chapter 6: Deploying ColdFusion Applications
Archive and deployment options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Packaging applications in CAR files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Packaging applications in J2EE archive files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Using the cfcompile utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Chapter 7: Administering Security
About ColdFusion security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Using password protection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Using sandbox security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Chapter 8: Using Multiple Server Instances
About multiple server instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Defining additional server instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Enabling application isolation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Enabling clustering for load balancing and failover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .118
Defining remote server instances to the ColdFusion Administrator . . . . . . . . . . . . . . . . . . . . . . . . 121
Chapter 9: Using the ColdFusion Server Monitor
Gathering information about ColdFusion servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .123
Starting the ColdFusion Server Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Viewing Server Monitor Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
Specifying Server Monitor Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
ColdFusion Server Monitor API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Using the Server Monitor to improve server performance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Administering Verity 141
Chapter 10: Introducing Verity and Verity Tools
Collections and the ColdFusion Verity architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .143
About Verity Spider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
About the Verity utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
Chapter 11: Indexing Collections with Verity Spider
About Verity Spider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
About Verity Spider syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Core options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
Processing options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
Networking options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
Path and URL options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
Content options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
Locale options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
Logging options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
Maintenance options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
Setting MIME types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
v
Chapter 12: Using Verity Utilities
Overview of Verity utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
Using the mkvdk utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
Using the rck2 utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
Using the rcvdk utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
Using the didump utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
Using the browse utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
Using the merge utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
CONTENTS
vi
Chapter 1: Introduction
Configuring and Administering ColdFusion is intended for anyone who needs to configure and manage their
Adobe® ColdFusion 8 development environment.
About ColdFusion documentation
The ColdFusion 8 documentation is designed to provide support for the complete spectrum of participants.
Documentation set
The ColdFusion documentation set includes the following titles:
Book Description
1
Installing and Using ColdFusion
Configuring and Administering ColdFusion
ColdFusion Developer’s
Guide
CFML Reference Provides descriptions, syntax, usage, and code examples for all ColdFusion tags, func-
Describes system installation and basic configuration for Windows, Macintoch, Solaris,
Linux, and AIX.
Part 1 describes how to manage the ColdFusion environment, including connecting
to your data sources, configuring security for your applications, and monitoring server
activity. Part 2 describes Verity search tools and utilities that you can use for configuring the Verity Search Server engine, as well as creating, managing, and troubleshooting Verity collections.
Describes how to develop your dynamic web applications, including retrieving and
updating your data, using structures, and forms.
tions, and variables.
Viewing online documentation
All ColdFusion documentation is available online in HTML and Adobe Acrobat Portable Document Format
(PDF) files. Go to the documentation home page for ColdFusion on the Adobe website:
www.adobe.com/support/documentation/en/coldfusion/. In addition, you can view the documentation in
LiveDocs, which lets you add comments to pages and view the latest comments added by Adobe, by going to
www.adobe.com/go/livedocs_cf8docs.
CHAPTER 1
2
Introduction
Part 1: Administering ColdFusion
You can use ColdFusion to manage the ColdFusion environment, including using the ColdFusion Administrator,
connecting to your data sources, managing your web server, deploying your applications, and configuring security
for your applications.
The following topics are included:
Administering ColdFusion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Using the ColdFusion Administrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Data Source Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Web Server Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Deploying ColdFusion Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Administering Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Using Multiple Server Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Using the ColdFusion Server Monitor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
3
Chapter 2: Administering ColdFusion
Although you use the ColdFusion Administrator to perform most ColdFusion administration tasks, you can also
manage databases, web server configurations, and Verity Search Server.
Contents
About the ColdFusion Administrator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
About web server administration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
About Verity administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
About the ColdFusion Administrator
The ColdFusion Administrator provides a browser-based interface for managing your ColdFusion environment.
You can configure many settings to provide optimal levels of security and functionality. The available options are
based on your edition of ColdFusion 8—Standard or Enterprise—as well as your configuration: server, multiserver, or J2EE. For more information on ColdFusion configurations, see “About the ColdFusion installation” on
page 3 in “Preparing to Install ColdFusion” on page 3 in Installing and Using ColdFusion.
5
The default location for the ColdFusion Administrator login page is:
http://servername[:portnumber]/CFIDE/administrator/index.cfm
Where servername is the fully qualified domain name of your web server. Common values for servername are
localhost or 127.0.0.1 (each refers to the web server on the local computer).
If you are using the ColdFusion built-in web server, include the port number as part of the servername. The
default port number for the server configuration is 8500; for example, http://servername:8500/CFIDE/administrator/index.cfm. The default port number for the multiserver configuration is 8300. If you are using the J2EE
configuration, include the port number that the J2EE application server’s web server uses.
If you were using the built-in web server in a version earlier than ColdFusion MX 7 and upgraded to ColdFusion
8, the installer automatically finds an unused port for the built-in web server (typically 8501).
If your ColdFusion Administrator is on a remote computer, use the Domain Name Services (DNS) name or
Internet Protocol (IP) address of the remote host.
To access the ColdFusion Administrator, enter the password specified when you installed ColdFusion.
CHAPTER 2
6
Administering ColdFusion
Note: If you are running ColdFusion in a multihomed environment and have problems displaying the ColdFusion
Administrator, see “Web Server Management” on page 79 for configuration information.
For more information, see “Using the ColdFusion Administrator” on page 7.
About web server administration
Co ldFusi on appli cat ions r equire a web s erve r to pro cess C oldFus ion Markup L ang uag e (CFML ) pa ges. Th e se rver
and multiserver configurations provide a built-in web server along with support for external web servers, such as
Apache, IIS, and Sun ONE Web Server (formerly known as iPlanet).
For more information, see “Web Server Management” on page 79.
About Verity administration
ColdFusion includes Verity K2 Server search technology. Verity K2 Server is a high-performance search engine
designed to process searches quickly in a high-performance, distributed system.
For more information, see “Introducing Verity and Verity Tools” on page 143.
Chapter 3: Using the ColdFusion Administrator
Use the ColdFusion Administrator to perform basic administration tasks. You can also use the Administrator
application programming interface (API) to perform Administrator functionality programmatically.
Contents
Initial administration tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Accessing user assistance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Server Settings section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Data & Services section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Debugging & Logging section. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Server Monitoring section. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Extensions section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Event Gateways section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Security section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Packaging and Deployment section. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Enterprise Manager section. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Custom Extensions section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42
Administrator API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
7
Initial administration tasks
Immediately after you install ColdFusion, you might have to perform some or all of the administrative tasks
described in the following table:
CHAPTER 3
8
Using the ColdFusion Administrator
Task Description
Establish database connections
Specify directory mappings Directory mappings redirect relative file paths to physical directories on your server.
Configure debugging
settings
Set up e -mail E-mail lets ColdFusion applications send automated e-mail messages. To configure an
Change passwords You might have to change the passwords that you set for the ColdFusion Adminis-
Define user-specific access
to the ColdFusion Administrator
ColdFusion applications require data source connections to query and write to databases. To create, verify, edit, and delete database connections, use the Data Sources
page.
For more information, see “Data Source Management” on page 47.
To specify server-wide directory aliases, use the Mappings page.
For more information, see “Mappings page” on page 17.
Debugging information provides important data about CFML page processing. To
choose the debugging information to display, and to designate an IP address to
receive debugging information, use the Debugging & Logging section.
For more information, see “Debugging Output Settings page” on page 26.
e-mail server and mail options, use the Mail Server page.
For more information, see “Mail page” on page 17.
trator and Remote Development Service (RDS) during ColdFusion installation. To
change passwords, use the Security section.
For more information, see “Administrator page” on page 38 and “RDS page” on
page 38.
To grant user-specific access to the ColdFusion Administrator, you create users and
specify a username, password, applicable sandboxes, and the sections of the ColdFusion Administrator that each user can access. For more information, see “Security
section” on page 37.
Configure Java settings (Server configuration only) You might have to customize Java settings, such as class-
Restrict tag access Some CFML tags might present a potential security risk for your server. To disable
path information, to meet the needs of your applications. To change Java settings, use
the Java and JVM page.
For more information, see “Extensions section” on page 33.
certain tags, use the Sandbox Security page.
For more information, see “Administering Security” on page 101.
Configuring and Administering ColdFusion
ADOBE COLDFUSION 8
Accessing user assistance
You can use the buttons on the top left of the ColdFusion Administrator to access online Help, information about
additional resources, and system information.
Online Help You can access the context-sensitive online Help by clicking the question-mark icon on any
ColdFusion Administrator page. The online Help has procedural and brief overview content for the ColdFusion
Administrator page that you are viewing. This information appears in a new browser window and contains
standard Contents, Index, and Search tabs.
System Information Click System Information to see information about the ColdFusion server, including version
number, serial number, and JVM details.
Resources Click Resources to display the Resources page, which provides links to the Getting Started experience,
example applications, product information, technical support and training, additional installers, product updates,
community resources, and information about security.
Server Settings section
9
The Server Settings section lets you manage client and memory variables, mappings, charting, and archiving. You
also configure e-mail and Java settings in this section.
The Server Settings section contains the following pages:
• Settings page
• Caching page
• Client Variables page
• Memory Variables page
• Mappings page
• Mail page
• Charting page
• Font Management page
• Java and JVM page
• ColdFusion Archives page
CHAPTER 3
10
Using the ColdFusion Administrator
• Settings Summary page
Settings page
The Settings page of the ColdFusion Administrator contains configuration options that you can set or enable to
manage ColdFusion. These options can significantly affect server performance. The following table describes the
options:
Option Description
Timeout Requests After
(Seconds)
Enable Per App Settings Lets developers programmatically define ColdFusion settings such as mappings
Use UUID For cftoken Specify whether to use a universally unique identifier (UUID), rather than a
Enable HTTP Status Codes Configures ColdFusion to set a status code of 500 Internal Server Error for an
Enable Whitespace Management
Disable CFC Type Check Turns off verifying the CFC type when calling methods with CFCs as arguments.
Disable Access To Internal ColdFusion Java Components
Watch Configuration Files For
Changes (Check Every n
Seconds)
Prevents unusually lengthy requests from using up server resources. Enter a limit
to the time that ColdFusion waits before terminating a request. Requests that take
longer than the time-out period are terminated.
and debugging per application.
random number, for a cftoken.
unhandled error. Disable this option to configure ColdFusion to set a status code
of 200 OK for everything, including unhandled errors.
Compresses repeating sequences of spaces, tabs, and carriage returns and linefeeds. Compressing whitespace can significantly compact the output of a ColdFusion page.
This option also disables verifying an object that implements the right inter face.
Although enabling this option can improve your application's performance,
enable it only on a production server when you are not making changes to your
application.
Prevents CFML code from accessing and creating Java objects that are part of the
internal ColdFusion implementation. This prevents a non-authenticated CFML
template from reading or modifying administration and configuration information for this server.
Sets ColdFusion to monitor its configuration files and automatically reload them
if they change. This action is required if you deploy ColdFusion in a Websphere ND
vertical cluster, because multiple instances of ColdFusion share the same configuration files. Most installations should not enable this feature.
Enable Global Script Protection Protects Form, URL, CGI, and Cookie scope variables from cross-site scripting
attacks. Select this option if your application does not contain this type of protection logic.
Option Description
Configuring and Administering ColdFusion
ADOBE COLDFUSION 8
11
Default CFFORM ScriptSrc
Directory
Missing Template Handler Specify a page to execute when ColdFusion cannot find a requested page. This
Site-Wide Error Handler Specify a page to execute when ColdFusion encounters an error while processing
Maximum Size Of Post Data Limits the amount of data that can be posted to the server in a single request.
RequeSt Throttle Threshold Requests smaller than the specified limit are neither queued nor counted as part
Request Throttle Memory Limits total memory size for the throttle. If sufficient tot al memory is not available,
Specify the default path (relative to the web root) to the directory that contains
the cfform.js file. Developers reference this file in the ScriptSrc attribute of the
cfform tag.
In a hosted environment, you might need to move the cfform.js file to a directory
other than CFIDE.
specification is relative to the web root.
Note: If the user is running Microsoft Internet Explorer with "Show Friendly HT TP
error messages" enabled in advanced settings (the default), Internet Explorer will
only display this page if it contains more than 512 bytes.
a request. This specification is relative to the web root. When you define a sitewide error handler or missing template handler, ColdFusion does not log pagenot-found errors and exceptions.
Note: If the user is running Internet Explorer with Show Friendly HTTP Error
Messages enabled in Advanced Settings (the default), Internet Explorer only
displays this page if it contains more than 512 bytes.
ColdFusion rejects single requests larger than the specified limit.
of the total memory. Requests larger than the specified limit are counted as part
of total memory and are queued if the request throttle-memory size is exceeded.
ColdFusion queues requests until enough memory is free.
Request Tuning page
The Request Tuning page of the Administrator contains configuration options that you use to specify the number
of different types of requests and threads that ColdFusion can handle simultaneously.
CHAPTER 3
12
Using the ColdFusion Administrator
Option Description
Maximum Number Of Simultaneous Template Requests
Maximum Number Of Simultaneous Flash Remoting Requests
Maximum Number Of Simultaneous Web Service Requests
Maximum Number Of Simultaneous CFC Function Requests
Maximum Number Of Simultaneous Report Threads
Maximum Number Of Threads
Available For CFTHREAD
Timeout Requests Waiting In
Queue After n Seconds
Request Queue Timeout Page Specify a relative path to an HTML page to send to clients when a template
Maximum Number Of Running
JRun Threads
The number of CFML page requests that can be processed concurrently. Use this
setting to increase overall system performance for heavy-load applications.
Requests beyond the specified limit are queued.
The number of Adobe Flash® Remoting requests that can be processed concurrently.
The number of Web Service requests that can be processed concurrently.
The number of ColdFusion Component methods that can be processed concurrently through HTTP. This does not affect starting CFC methods from CFML, only
methods requested through an HTTP request.
The maximum number of ColdFusion reports that can be processed concurrently.
CFTHREAD that runs concurrently. Threads that CFTHREAD creates in excess of
this are queued.
If a request has waited in the queue for this long, time out the request. This value
should be at least as long as the Request Timeout setting (currently 60 seconds).
request times out before getting a chance to run. For example
"/CFIDE/timeout.html.” This page cannot contain CFML. If a page is not specified
here, clients will receive a 500 Request Timeout error if their request does not get
a chance to run.
Maximum number of JRun handler threads that will run concurrently. This is the
number of request threads that the underlying JRun J2EE application server will
run at the same time. This includes any non-ColdFusion requests such as JSP or
HTML pages served through JRun.
Maximum Number Of Queued
JRun Threads
Maximum number of requests that JRun will accept at any one time. This is the
number of requests that the underlying JRun J2EE application server will accept
at the same time.
Caching page
The Caching page of the Administrator contains configuration options that you can set or enable to cache
templates, queries, and data sources. These options can significantly affect server performance. The following
table describes the settings:
Option Description
Configuring and Administering ColdFusion
ADOBE COLDFUSION 8
13
Maximum Number Of Cached
Tem pl at es
Trusted Cache Use cached templates without checking whether they changed. For sites that are
Save Class Files Saves to disk the class files that the ColdFusion bytecode compiler generates.
Cache Web Server Paths Caches ColdFusion page paths for a single server. Clear this option if ColdFusion
Maximum Number Of Cached
Queries
Clear Template Cache Now Empties the template cache. ColdFusion reloads templates into memory the nex t
Enter a value that specifies the number of templates that ColdFusion caches. For
best performance, set this to a value that is large enough to contain your application’s commonly accessed ColdFusion pages, yet small enough to avoid excessive
reloading. You can experiment with a range of values on your development
server; a suitable starting point is one page per MB of Java Virtual Machine (JVM)
size.
not updated frequently, using this option minimizes file system overhead.
During the development phase, it is typically faster if you disable this option.
connects to a web server with multiple websites or multiple virtual websites.
Enter a value to limit the maximum number of cached queries that the server
maintains. Cached queries allow retrieval of result sets from memory rather than
through a database transaction. Because queries reside in memory, and query
result set sizes differ, you must provide a limit for the number of cached queries.
You enable cached queries with the cachedwithin or cachedafter attributes
of the cfquery tag. When the maximum number of cached queries is reached,
the oldest query is dropped from the cache and replaced with the specified quer y.
If you set the maximum number of cached queries to 0, query caching is unlimited.
time they are requested and recompiles them if they have been modified.
Client Variables page
Client variables let you store user information and preferences between sessions. Using information from client
variables, you can customize page content for individual users.
You enable client variable default settings in ColdFusion on the Client Variables page of the Administrator.
ColdFusion lets you store client variables in the following ways:
❖ In database tables
Note: If your data source uses one of the JDBC drivers bundled with ColdFusion 8, ColdFusion can automatically
create the necessary tables. If your data source uses the ODBC Socket or a third-party JDBC driver, you must
manually create the necessary CDATA and CGLOBAL database tables.
• As cookies in users’ web browsers
CHAPTER 3
14
Using the ColdFusion Administrator
• In the operating system registry
Important: Adobe recommends that you do not store client variables in the registry because it can critically degrade
performance of the server. If you do use the registry to store client variables, you must allocate sufficient memory and
disk space.
To override settings specified in the Client Variables page, use the Application.cfc file or the
cfapplication tag.
For more information, see the ColdFusion Developer’s Guide.
The following table compares the client variable storage options:
Storage type Advantages Disadvantages
Data source • Can use existing data source
• Portable: not tied to the ho st system or
operating system
Browser cookies • Simple implementation
• Good performance
• Can be set to expire automatically
• Client-side control
System registry • Simple implementation
• Good performance
• Registry can be exported easily to
other systems
• Server-side control
• Requires database transaction to read/write
variables
• More complex to implement
• Users can configure browsers to disallow
cookies
• Cookie data is limited to 4 KB
• Netscape Navigator allows only 20 cookies
from one host; ColdFusion uses three cookies
to store read-only data, leaving only 17
cookies available
• Possible restriction of the registry’s maximum
size limit in Windows in the Control Panel
• Integrated with the host system: not practical
for clustered servers
• Not available for UNIX
Migrating client variable data
To migrate your client variable data to another data source, you should know the structure of the database tables
that store this information. Client variables stored externally use two simple database tables, like those shown in
the following tables:
Configuring and Administering ColdFusion
ADOBE COLDFUSION 8
CDATA Table
Column Data type
cfid CHAR(64), TEXT, VARCHAR, or equivalent
app CHAR(64), TEXT, VARCHAR, or equivalent
data MEMO, LONGTEXT, LONG VARCHAR, or equivalent
CGLOBAL Table
Column Data type
cfid CHAR(64), TEXT, VARCHAR, or equivalent
data MEMO, LONGTEXT, LONG VARCHAR, or equivalent
lvisit TIMESTAMP, DATETIME, DATE, or equivalent
Creating client variable tables
Use the following sample ColdFusion page as a model for creating client variable database tables in your own
database. However, keep in mind that not all databases support the same column data type names. For the proper
data type, see your database documentation.
15
Note: The ColdFusion Administrator can create client variable tables for data sources that use one of the bundled
JDBC drivers. For more information, see the online help.
Sample table creation page
<!---- Create the Client variable storage tables in a datasource.
This example applies to Microsoft Access databases. --->
<cfquery name="data1" datasource="#DSN#">
CREATE TABLE CDATA
(
cfid char(20),
app char(64),
data memo
)
</cfquery>
<cfquery name="data2" datasource="#DSN#">
CHAPTER 3
16
Using the ColdFusion Administrator
CREATE UNIQUE INDEX id1
ON CDATA (cfid,app)
</cfquery>
<cfquery name="global1" datasource="#DSN#">
CREATE TABLE CGLOBAL
(
cfid char(20),
data memo,
lvisit date
)
</cfquery>
<cfquery name="global2" datasource="#DSN#">
CREATE INDEX id2
ON CGLOBAL (cfid)
</cfquery>
<cfquery name="global2" datasource="#DSN#">
CREATE INDEX id3
ON CGLOBAL (lvisit)
</cfquery>
Memory Variables page
Use the Memory Variables page of the ColdFusion Administrator to enable application and session variables
server-wide. By default, application and session variables are enabled when you install ColdFusion. If you disable
either type of variable in the Memory Variables page, you cannot use them in a ColdFusion application.
You can specify maximum and default time-out values for session and application variables. Unless you define a
time-out value in an Application.cfc or Application.cfm file, application variables expire in two days. Session
variables expire when user sessions end. To change these behaviors, enter new default and maximum time-out
values on the Memory Variables page of the Administrator.
Note: Time-out values that you specify for application variables override the time-out values set in the Application.cfc
or Application.cfm file.
You can also specify whether to use J2EE session variables. When you enable the J2EE session variables,
ColdFusion creates an identifier for each session and does not use the CFToken or CFID cookie value. For more
information, see the ColdFusion Developer’s Guide.
Configuring and Administering ColdFusion
ADOBE COLDFUSION 8
Note: When using J2EE sessions, ensure that the session time out, specified in the WEB-INF/web.xml session-
timeout
than any
element, is longer than the session time out that you specify in the ColdFusion Administrator, and longer
sessiontimeout attribute specified in a cfapplication tag.
Mappings page
Use the Mappings page of the ColdFusion Administrator to add, update, and delete logical aliases for paths to
directories on your server. ColdFusion mappings apply only to pages that ColdFusion processes with the
cfinclude and cfmodule tags. If you save CFML pages outside of the web_root directory (or whatever directory
is mapped to "/"), you must add a mapping to the location of those files on your server.
Assume that the "/" mapping on your server points to C:\coldfusion8\wwwroot, but that all of your ColdFusion
header pages reside in C:\2002\newpages\headers. For ColdFusion to find your header pages, you must add a
mapping in the ColdFusion Administrator that points to C:\2002\newpages\headers (for example, add a mapping
for /headers that points to C:\2002\newpages\headers). In the ColdFusion pages located in
C:\coldfusion8\wwwroot, you reference these header pages using /headers in your
tags.
Note: ColdFusion mappings are different from web server virtual directories. For information on creating a virtual
directory to access a given directory using a URL in your web browser, consult your web server’s documentation.
cfinclude and cfmodule
17
Mail page
Use the Mail page of the ColdFusion Administrator to specify a mail server to send automated e-mail messages.
ColdFusion supports the Simple Mail Transfer Protocol (SMTP) for sending e-mail messages and the Post Office
Pr oto col ( POP) for ret ri evin g e-m ail m ess ages from you r mai l s erve r. To u se e- mail mess agin g in yo ur C oldFusio n
applications, you must have access to an SMTP server and a POP account.
The ColdFusion Enterprise Edition supports mail-server failover, as well as additional mail delivery options.
The ColdFusion implementation of SMTP mail uses a spooled architecture. This means that when a
is processed in an application page, the messages generated might not be sent immediately. If ColdFusion is
extremely busy or has a large queue, delivery could occur after some delay.
Note: For more information about the
cfmail tag, see “Sending SMTP e-mail with the cfmail tag” on page 1420 in
“Sending and Receiving E-Mail” on page 1417 in the ColdFusion Developer’s Guide.
Mail Server Settings area
The following table describes basic mail server settings:
cfmail tag
CHAPTER 3
18
Using the ColdFusion Administrator
Option Description
Mail Server Enter a valid mail server for sending dynamic SMTP mail messages in the text box.
Username Enter the username for the mail server, if required.
Password Enter the password for the mail server, if required.
Verify Mail Server Connection
Server Port Enter the number of the port on which the mail ser ver is running. Contact your server
Backup Mail Servers (Enterprise Edition only)
Maintain Connection To Mail
Server
(Enterprise Edition only)
Connection Timeout
(seconds)
You can enter an Internet address, such as mail.company.com, or the IP address of the
mail server, such as 127.0.0.1.
Verifies that ColdFusion can connect to your specified mail server after you submit
this form.
Whether or not you use this option, send a test message to verify that your mail
server connection works.
administrator if you are unsure of the appropriate port number.
Enter zero or more backup servers for sending SMTP mail messages. You can enter an
Internet address, such as mail.company.com, or the IP address of the mail server, such
as 127.0.0.1. Separate multiple servers with a comma.
If the mail server requires authentication, prepend the mail ser ver with the username
and password, as follows: username:password@mailserveraddress
To use a port number other than the default (25), specify mailserveraddress:port-
number
Keeps mail server connections open after sending a mail message. Enabling this
option can enhance performance when delivering multiple messages.
Enter the number of seconds that ColdFusion should wait for a response from the
mail server before timing out.
Enable SSL Socket Connections To Mail Server
Enable TLS Connection To
Mail Server
Enables SSL encryption on the connections to the mail server.
Enables Transport Level Security (TLS) on the connection to the mail server.
Mail Spool Settings area
The following table describes mail server spool settings:
Option Description
Configuring and Administering ColdFusion
ADOBE COLDFUSION 8
19
Spool Interval (Seconds) Enter the interval, in seconds, at which you want the mail server to process spooled
Mail Delivery Threads
(Enterprise Edition only)
Spool Mail Messages For
Delivery To
(Memory spooling available
for Enterprise Edition only)
Maximum Number Of
Messages Spooled To
Memory
(Enterprise Edition only)
mail.
Enter the maximum number of simultaneous threads used to deliver spooled mail.
Routes outgoing mail messages to the mail spooler. If you disable this option, ColdFusion delivers outgoing mail messages immediately. In ColdFusion Enterprise
Edition, you can spool messages to disk (slower, but messages persist across shutdowns) or to memory (faster, but messages do not persist).
You can override this setting in the cfmail tag.
Enter the maximum number of messages that spool to memory before switching to
disk spooling.
Mail Logging Settings area
Select preferences for handling mail logs, as described in the following table:
Option Description
Error Log Severity From the drop-down list box, select the type of SMTP-related error message to write
to a log file. The options are the following:
• Debug (contains Information, Warning, and Error)
• Information (contains Warning and Error)
• Warning (contains Error)
• Error
Log All Mail Messages Sent
By ColdFusion
Saves to a log file the To, From, and Subject fields of all e-mail messages.
ColdFusion writes sent-mail and mail-error logs to the following directories:
• \coldfusion8\logs (Windows server configuration)
• /opt/coldfusion8/log (Solaris and Linux server configuration)
• cf_webapp_root/WEB-INF/cfusion/logs (multiserver and J2EE configurations, all platforms)
The following table describes the e-mail log files:
CHAPTER 3
20
Using the ColdFusion Administrator
Log Description
mailsent.log Records sent e-mail messages.
mail.log Records general e-mail errors.
Mail Character Set Settings area
Select preferences for the default mail character set, as described in the following table:
Option Description
Default CFMail CharSet From the drop-down list box, select the default character set that the cfmail tag
uses. The default value is UTF-8. If the majority of your e-mail clients use a specific
character set, you can use this setting to switch to that locale-specific character set.
For example, Japanese mail is typically sent using the ISO-2022-JP character set.
Charting page
Th e Co ldFus ion charti ng and graphi ng s erve r le ts you produ ce h igh ly c ust omizable bus ine ss g raphi cs, in a var iety
of formats, using the
cfquery tag. Use the Charting page in the Administrator to control characteristics of the
server.
The following table describes the caching and thread settings for the ColdFusion charting and graphing server:
Option Description
Cache Type Set the cache type. Charts can be cached either in memory or to disk. Memory
Maximum Number Of
Cached Images
Max Number Of Charting
Threads
Disk Cache Location When caching to disk, specify the directory in which to store the generated charts.
caching is faster, but more memory intensive.
Specify the maximum number of charts to store in the cache. After the cache is ful l, if
you generate a new chart, ColdFusion discards the oldest chart in the cache.
Specify the maximum number of chart requests that can be processed concurrently.
The minimum number is 1 and the maximum is 5. (Higher numbers are more
memory-intensive.)
Font Management page
The Font Management page lets you review and define fonts for use with Adobe® FlashPaper™ and Acrobat® PDF
output formats. ColdFusion generates FlashPaper and PDF output through the
cfreport tag, when used to call a report created with the ColdFusion Report Builder.
cfdocument tag and through the
Configuring and Administering ColdFusion
ADOBE COLDFUSION 8
ColdFusion automatically registers Acrobat built-in fonts and fonts located in typical font locations (such as the
Windows\fonts directory). However, if your server has additional fonts installed in nonstandard locations, you
must register them with the ColdFusion Administrator so that the
cfdocument and cfreport tags can lo cate and
render PDF and FlashPaper reports.
This page contains the following sections:
Register New Font with ColdFusion Lets you browse to a directory that contains fonts, or select a specific font.
User Defined Fonts Displays the fonts that have been registered explicitly.
Current System Fonts Displays fonts stored in platform-specific system font directories.
For more information on font management, see the ColdFusion Administrator online Help. For more information
on reporting in ColdFusion, see “Creating Reports and Documents for Printing” on page 1075 in the ColdFusion
Developer’s Guide.
Java and JVM page
The Java and JVM page lets you specify the following settings, which enable ColdFusion to work with Java:
Option Description
21
Java Virtual Machine Path The absolute file path to the location of the Java Virtual Machine (JVM) root directory.
Minimum JVM Heap Size The JVM initial heap size.
Maximum JVM Heap Size The JVM maximum heap size. The default value is 512 MB.
ColdFusion Class Path The file paths to the directories that contain the JAR files that ColdFusion uses.
JVM Arguments The arguments to the JVM. Use a space to separate multiple entries (for example, -
The default is cf_root/runtime/jre.
Specify either the fully qualified name of a directory that contains your JAR files or a
fully qualified JAR filename. Use a comma to separate multiple entries.
Xint -Xincgc).
Note: This page is available in the server configuration only.
Before ColdFusion saves your changes, it saves a copy of the current cf_root/runtime/bin/jvm.config file as
jvm.bak. If your changes prevent ColdFusion from restarting, use the jvm.bak file to restore your system. For more
information, see the online help.
CHAPTER 3
22
Using the ColdFusion Administrator
Settings Summary page
The Settings Summary page shows all ColdFusion configuration settings. Click a group name to open that group’s
Administrator section, where you can edit settings. This page is not enabled in the Standard Edition.
Data & Services section
The Data & Services section of the Administrator is the interface for ColdFusion, data sources, and Verity search
and indexing features. The following table describes some common tasks that you can perform in the Data &
Services section of the Administrator:
Task Description
Create and manage JDBC
data sources
Create and maintain Verity
collections
Define mappings for web
services
Specify settings to integrate
with Adobe® Flex™ applications
The Data Sources page lets you establish, edit, and delete JDBC data source connections for ColdFusion. For more information, see “Data Source Management” on
page 47.
The Verity Collections page lets you create and dele te Verity collections and perform
maintenance operations on collections that you create. For more information, see
“Verity Collections page” on page 23.
The Web Services page lets you produce and consume remote application functionality over the Internet. For more information, see “Web Services page” on page 24.
The Flex Integration page lets you specify which Flex integration features to enable
and which IP addresses can perform data service operations. For more information,
see “Flex Integration page” on page 24.
The Data & Services section contains the following pages:
• Data Sources page
• Verity Collections page
• Verity K2 Server page
• Web S e rv ic e s pa g e
• Flex Integration page
Configuring and Administering ColdFusion
ADOBE COLDFUSION 8
Data Sources page
The Data Sources page lets you create, edit, and delete JDBC data sources. Before you can use a database in a
ColdFusion application, you must register the data source in the ColdFusion Administrator. For more information, see “Data Source Management” on page 47.
Verity Collections page
ColdFusion includes Verity, which provides indexing and searching technology to create, populate, and manage
collections of indexed data that are optimized for fast and efficient site searches.
A collection is a logical group of documents and metadata about the documents. The metadata includes word
indexes, an internal documents table of document field information, and logical pointers to the document files.
For more information about building search interfaces, see “Building a Search Interface” on page 665 in the
ColdFusion Developer’s Guide.
ColdFusion lets you manage your collections from the Administrator. You can index, optimize, purge, or delete
Verity collections that are connected to ColdFusion. You use the icons in the Actions column to perform the
following actions:
Action Description
23
Index Analyzes the files in a collection and assembles metadata and pointers to the files.
Optimize Reclaims space left by deleted and changed files by consolidating collection indexes for
Purge Deletes all documents in a collection, but not the collection itself. Leaves the collection
Delete Deletes a collection.
faster searching. You should optimize collections regularly.
directory structure intact.
Ver ity Se arch Se rv er mu st b e runn ing. If t his p age i s una ble to re trie ve col lect ions , ens ure that Veri ty Se arch Ser ver
is running. For more information, see “Collections and the ColdFusion Verity architecture” on page 143.
Verity K2 Server page
You can install Verity on a different host computer from the computer that ColdFusion is running on. If you do
so, you can configure the host that ColdFusion will use when it performs search operations. If you have purchased
the Verity product, you may need to use advanced settings to configure the aliases and ports of the services that
ColdFusion uses. You should not need to change these values if you are running with the ColdFusion installed
version of Verity.
CHAPTER 3
24
Using the ColdFusion Administrator
Web Services page
You can use web services to produce and consume remote application functionality over the Internet. The
ColdFusion Administrator lets you register web services so that you do not have to specify the entire Web Services
Description Language (WSDL) URL when you reference the web service. The first time you reference a web
service, ColdFusion automatically registers it in the Administrator.
When you register a web service, you can shorten your code and change a web service’s URL without editing your
code. For more information, see “Using Web Services” on page 1291 in the ColdFusion Developer’s Guide.
Flex Integration page
Use this page to specify which Flex integration features to enable and which IP addresses can perform data-service
operations. If you enable Adobe LiveCycle Data Services ES support, but do not specify any IP addresses, only
processes on the local computer can connect to the LiveCycle Data Services ES server in ColdFusion.
Option Description
Enable Flash
Remoting Support
Enable Remote LiveCycle Data Management Access
Server Identity Specifies the ColdFusion server on which you want to enable Flex Data Management
Enable RMI Over SSL
For Data Management
Select IP Addresses
Where LiveCycle
Data Services Are
Running
Specifies whether to enable Flash clients to connect to this ColdFusion server and invoke
methods in ColdFusion components (CFCs).
Specifies whether to enable a LiveCycle Data Ser vices ES server to connect to this ColdFusion
server and invoke methods in CFCs to fill, sync, get, or count records in a result set used in a
Flex application. Enable this option only if you are running LiveCycle Data Services ES
remotely.
Support.
To encrypt communication between ColdFusion and Flex, enable Secure Sockets Layer (SSL).
Specifies which LiveCycle Data Services ES servers can connect to the LiveCycle Data
Services ES support in ColdFusion. If you do not specify a list of allowed IP addresses, only
processes on the local computer can connect to the LiveCycle Data Services ES support in
ColdFusion
To use SSL, create a keystore file. The keystore is a self-signed certificate. (You do not need a certificate signed by
a Certificate Authority, although if you do use one, you do not need to configure Flex as indicated in the following
steps.) The information in the keystore is encrypted and can be accessed only with the password that you specify.
To create the keystore, use the Java keytool utility, which is included in the Java Runtime Environment (JRE).
Loading...