MACROMEDIA COLDFUSION 5-ADVANCED ADMINISTRATION Manuale utente

Macromedia® Incorporated

Advanced

ColdFusion

Administration

ColdFusion®5

Thismanual, as well asthe software described in it, is furnished under licenseandmay

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,orotherwise,withoutthepriorwrittenpermissionofMacromedia

Inc.

ColdFusion and HomeSite are U.S. registered trademarks of Macromedia

Inc.macromedia inc.Macromedia, the Macromedia logo, Macromedia Spectra,

ColdFusion logo, and JRun are trademarks of Macromedia, Inc. Java is a trademark of

Sun Microsystems, Inc. Microsoft, Windows, Windows NT, Windows 95, Microsoft

Access, and FoxPro are registered trademarks of Microsoft Corporation. PostScript is

a trademark of Adobe Systems Inc. Solaris is a trademark of Sun Microsystems Inc.

UNIX is a trademark of The Open Group.All other company names, brand names, and

product names are trademarks of their respective holder(s).

Part number: ZCF50MADM

Contents

About This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii

Intended Audience . . . . . . .. . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . xiv

New Features . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . .. . .xiv

Developer Resources . . . . .. . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . xv

About ColdFusion Documentation. . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . xvi

Printed and online documentation set . . . . . . .. . . . . . . . . .. . . . . . .. . . . . . xvi

Viewing online documentation . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . xvii

Getting Answers. . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . xvii

Contacting Macromedia . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . xviii

Part I Data Sources and Tools. . . . . . . . . . . . . . . 1

Chapter 1 Advanced Data Source Management . . . . . . 3

About ColdFusion database drivers . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . . . 4

About OLEDB . . . . . .. . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . .. 4

Aboutnative drivers .. . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . . 9

Using ColdFusion to Create a Data Source (UNIX only). . . . .. . . . . .. . . . . . . . . . 10

Using Connection String Options . . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . . . . .. . . 12

About theconnection string . . . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . 12

Changes totheColdFusion Administrator . . . . . . . . . . .. . . . . . . . . . . . .. . . 13

Changes toCFML tags . .. . . . . . .. . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . . 13

Connecting to DB2 Databases . . .. . . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . 15

Configuring DB2 options (Windows) . . . . . . . . .. . . . . . .. . . . . . . . . . . . .. . . 15

Configuring DB2 options (UNIX) . .. . . . . . .. . . . . .. . . . . . . . . . . . . .. . . . . . 15

Configuring system andservicesfiles (UNIX) . . . . . . . .. . . . . .. . . . . . .. . . 16

Installing and Configuring DB2 Client Enabler (UNIX) . . .. . . . . . . . . . . . . 16

Data source and start scriptsettings for DB2 (UNIX) . . . . .. . . . . . . . . . . . . 18

DB2 binding and privileges for ODBC (UNIX) . . . .. . . . . . .. . . . . . . . . . . . . 19

Executinga DB2 stored procedure (Windows, UNIX) .. . . . . .. . . . . . .. . . 19

iv Contents

Connecting to dBASE/FoxProDatabases.. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . . 21

Configuring dBASE/FoxPro options (Windows) . .. . . . . . . . . . . . . .. . . . . . 21

Configuring dBASE/FoxPro Driver options (UNIX) . . . . . . . . .. . . . . . . . . . 23

Connecting to Excel Databases . . . . . .. . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . . 24

ODBC: Microsoft Excel Driver options . . . . . . .. . . . . . .. . . . . . . . . . . . .. . . 24

ODBC: MERANT ExcelWorkbook Driver options . . . . .. . . . . .. . . . . . . . . . 25

Connecting to Informix Databases . . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . 26

Configuring Informix using ODBC . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . 26

Configuring Informix using the native driver . . . . .. . . . . . .. . . . . . . . . . . . . 27

Connecting to Informix data sources (UNIX) . . . . . . . . . . . .. . . . . . . . . . . . . 27

Connectingto Informix through ODBC/CLI (Windows, UNIX) . . . . . .. . . 29

Connecting to Sybase Databases. . . . .. . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . . 32

ODBC: MERANT Sybase ASE Driveroptions . .. . . . . . .. . . . . .. . . . . . . . . . 32

Native: Sybase 11 Driver options . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . 33

Tips for connecting to SybaseSystem11 (UNIX) . . . . . . . . . . .. . . . . . . . . . 33

Connecting to Text Databases . . . . . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . 35

ODBC: Microsoft Text Driver options (Windows) . . . . . . . .. . . . . . .. . . . . . 35

ODBC: MERANT TextDriver options (UNIX) . . . .. . . . . . .. . . . . . .. . . . . . 35

Connecting to Visual FoxPro Databases. . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . 37

Chapter 2 Administrator Tools . . . . . . . . . . . . . . . . . . . 39

Accessing the Administrator Tools . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . . 40

Features onthe Tools Tab . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . . 41

Logs and Statistics tools . . . . . . .. . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . . 41

SystemMonitoring tools . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . .. . . 45

Archive andDeploytools . . . . . .. . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . . 49

Part II ColdFusion Security . . . . . . . . . . . . . . . . 57

Chapter 3 ColdFusion Security . . . . . . . . . . . . . . . . . . 59

Why Is ColdFusion Security Important?. . . . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . 60

Types of ColdFusion Security . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . .. . . . . . 61

Choosing a Level of ColdFusion Security. . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . 62

Developing applications . . . . . . .. . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . . 63

Deploying applications . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . . 64

Securing theColdFusion Administrator . . .. . . . . . . . . . . . .. . . . . . . . . . . . . 66

To Learn More About Security . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . 67

Contents v

Chapter 4 Configuring Basic Security . . . . . . . . . . . . . 71

About Basic Security. . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . . 72

Installation defaults . . . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . .. . . . . . . . . . 72

Configuring Remote Development Security (RDS) . . . . . . . . .. . . . . .. . . . . . .. . . 73

Securing data sources . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . . 73

ColdFusion Remote Development Services (RDS) . . . . . . . . . . . .. . . . . . . . . . . . . 74

Basic security limitations . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . . 74

Securing ColdFusion fileresources . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . 74

Securing ColdFusion data sources . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . 75

Using a Password to Restrict Access to RDS .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . 76

ColdFusion Studio Password . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . .. . . 76

Removing password-basedaccess control: Windows . . . .. . . . . . .. . . . . . 76

Configuring Basic Runtime Security. . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . 77

Chapter 5 Configuring Advanced Security . . . . . . . . . 79

What is AdvancedSecurity? . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . 80

Advanced Security Basics . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . 81

User directories . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . 81

Resourcetypes . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . 82

Policies . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . . 82

Security contexts . . . .. . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . . 83

Advanced Security Implementations . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . . 84

Securing applications with User security . .. . . . . .. . . . . . .. . . . . . . . . . . . . 84

Securing resources with RDS security . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . 85

Securing applications with a security sandbox . . .. . . . . . . . . .. . . . . . .. . . 85

Securing theColdFusion Administrator . . .. . . . . . . . . . . . .. . . . . . . . . . . . . 86

Creating an Advanced Security Framework .. . . . . . .. . . . . . .. . . . . . . . . . . . .. . . 88

Implementation summary . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . . 88

Setting Up a Security Server . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . . 89

Caching Advanced Security Information. . . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . 91

Defining User Directories . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . 92

Defining a Security Context . . . . . . . . .. . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . . 95

SpecifyingResources to Protect. . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . . 96

ImplementingColdFusion RDSSecurity. . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . 98

Implementing User Security. . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . 99

Implementing Server SandboxSecurity. . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . 100

Securing the ColdFusion Administrator. . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . 102

Viewing a Map of yourSecurity Framework . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 103

vi Contents

An Exampleof ColdFusionStudio Security. . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . 104

EnablingAdvancedSecurity . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . 104

Specifying a User Directory . . . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . 104

Defining a security context . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . 105

Specifying resources toprotect . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . 105

Adding policies . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . 106

Granting accessprivileges . . . . .. . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . 106

Assigning users/groups to policies .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . 107

Enable ColdFusion Studio Security . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . 108

Advanced Security Single Sign-On . . .. . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . 109

Undocumented Tags and Functions. .. . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . 110

Administrative Functions . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . 110

Administrative Tags . . . .. . . . . . .. . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . 111

Part III Advanced Verity Tools. . . . . . . . . . . . . 113

Chapter 6 Configuring Verity K2 Server . . . . . . . . . . 115

Overview . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . 116

Verity operates in two modes . . .. . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . 116

Quick start to K2 Server . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . 116

About K2 Server. . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . .. . . . . 118

Installation details . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . . . . .. . 118

Two Veritymodes nowsupported . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . 118

How ColdFusion determines whichmode to use . . . . . . . .. . . . . . .. . . . . 119

Collections created with ColdFusion . . . . . .. . . . . .. . . . . . . . . . . . . .. . . . . 119

Starting K2 Server . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . 120

Windowsbatch file example . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . 121

Linux andUNIX scripts . . . .. . . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . 121

Stopping K2 Server . . . . . . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . 122

StoppingK2 whenrun as a service . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . . . . 122

StoppingK2 when run as an application . . . . . .. . . . . . .. . . . . .. . . . . . . . . 122

StoppingK2 Server on Linux/UNIX . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . 122

Editing the k2server.ini File. . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . 124

Edit thevdkHome parameter of k2server.ini . .. . . . . . . . . .. . . . . . .. . . . . 124

Edit theColl-n section of k2server.ini . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . 124

k2server.ini file listing . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . 125

k2server.ini Parameter Reference . . . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . 127

Server section . . . . . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . 127

Search threadkeywords . . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . .. . . . . 128

Collection sections . . . . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . 129

Using the rck2 Utility to Search K2 Documents . . . . . . . .. . . . . . .. . . . . . . . . . . . 131

rck2 syntax . . . . . . . . .. . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . 131

rck2 command options . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . 131

Contents vii

Error Messages. . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . 132

Generic error codes .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 132

Usage error codes . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 132

Runtime error codes . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . 132

Data error codes . . . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . 133

Query error codes . . . . . .. . . . . . .. . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . 133

Security error codes . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . 133

Remote Connection error codes . . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . . . . 134

File Handling error codes . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . 134

Dispatch error codes . . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . 134

Warnings . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . 134

TCP/IP error codes . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . 135

Chapter 7 Indexing XML Documents . . . . . . . . . . . . . 137

Indexing Overview . . . . . . .. . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . 138

Implementation summary . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . 138

Style Files. . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . 139

Configuring style files . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . 139

Configuring the style.xml file . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . 139

style.xml command syntax . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . . . . . .. . . . . 141

style.ufl file . . . . . . . . .. . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . 142

style.dft file . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 142

Indexing XMLDocuments . . . . . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . . . . 143

Indexing using mkvdk . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . 143

Searching using rcvdk . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . 143

Chapter 8 Verity Spider . . . . . . . . . . . . . . . . . . . . . . . . 145

Overview . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . 146

SupportsWeb standards . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . 146

Restart capability . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 146

State maintenancethrough a persistent store . . . . . . . . . . .. . . . . . . . . . . . 146

Performance . . . . . . .. . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . 146

Verity Spider Syntax . . . . . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . 148

Overview . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . 148

The Verity Spider command . . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . 148

Using a command file . . . . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . 149

Command-line option reference . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . 149

Core Options . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . 151

Processing Options. . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 153

Networking Options . . . . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . . . . .. . 159

Paths and URLs Options . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . 163

Content Options . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . 168

Locale Options. . . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . 176

viii Contents

LoggingOptions . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . 178

Maintenance Options. . . . .. . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . 180

Setting MIME Types . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . 181

Syntax restrictions . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . 181

MIME types and Web crawling . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . 181

MIME types and file system indexing . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . 182

Indexingunknown MIMEtypes . . . . . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . 182

KnownMIME typesfor file system indexing . . . . . . . . .. . . . . .. . . . . . .. . 183

Chapter 9 Managing Verity Collections with the

mkvdk Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185

Overview of the Verity mkvdk Utility. . . . . . . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 186

mkvdk syntax . . . . . . .. . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . 186

Getting Started withtheVerity mkvdk Utility . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 187

Steps for building acollection . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . 187

Collection setup options . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . .. . 188

General processing options . . . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . 189

Dateformat options . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . .. . . . . 191

Messagingoptions . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . 192

Message types . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . 192

Document processing options . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . . . . .. . 193

Bulk Submit Options . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 194

Using bulk insert and delete . . . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . 194

Collection Maintenance Options. . . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . 195

Examples: Maintaining collections . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . 195

Deleting a Collection . . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . 196

Optimization Keywords . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . 196

About squeezing deleted documents . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . 197

About optimized Verity databases . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . 198

Performance tuning options . . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . 198

Chapter 10 Verity Troubleshooting Utilities . . . . . . . 199

Overview of Verity Utilities . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . 200

Note oncollection types . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . 200

Using the Verity rcvdk Utility . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . 201

Starting rcvdk . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . .. . . . . 201

Attaching to a Collection Using rcvdk. . . . . . .. . . . . . .. . . . . . .. . . . . . . . . . . . .. . 202

Basic searching . . . . .. . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . 202

Viewing Results of thercvdk Utility. . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . 203

Displaying more fields . . . . .. . . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . 204

Contents ix

Using the Verity didump Utility . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . 206

Viewing the wordlist with didump . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . 206

Viewing the zone list with didump . . . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 207

Viewing the zone attribute listwith didump . . . . .. . . . . . . . . . . . . .. . . . . 208

Using the Verity browse Utility. . . . . . .. . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . 209

Using menu options with the browse utility . . . . . . . . .. . . . . . . . . .. . . . . 209

Displaying fields . . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 210

Using the Verity merge Utility. . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . 211

Merging collections using themerge utility . . . . . . . . . .. . . . . .. . . . . . . . . 211

Splitting collections .. . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . 211

Verity VDK Error Messages . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . 213

Generic error codes .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 213

Usage error codes . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 213

Runtime error codes . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . 213

Data error codes . . . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . 214

Query error codes . . . . . .. . . . . . .. . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . 214

Licensing error codes . . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . 215

Security error codes . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . 216

Remote connection error codes . . .. . . . . . .. . . . . .. . . . . . . . . . . . . .. . . . . 216

Filtering error codes .. . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . 216

Dispatch error codes . . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . 216

Warnings . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . 217

Part IV ColdFusion High-Availabilty . . . . . . . . 219

Chapter 11 Scalability and Availability Overview . . . 221

What is Scalability? . . . . . . .. . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . 222

Performance . . . . . . .. . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . 222

Load management . . . . .. . . . . . .. . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . 224

Issues Affecting Successful Scalability Implementations. . . . . . . . . .. . . . . . . . . 225

Designingand coding scalable applications . . . . . . . . .. . . . . . . . . .. . . . . 225

Avoiding common bottlenecks . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . .. . . . . 227

DNS effectson Web site performance and availability . . . . . . . . . .. . . . . 228

Load testing your Web applications . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . 231

What is WebSite Availability? .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . 234

Availability and reliability . . . . . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . 234

Common failures . . . . . . . . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . . . . 235

A Web site availability scenario . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . 236

Failover considerations . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . 237

Techniques for Creating Scalable and Highly AvailableSites . . . . . .. . . . . . . . . 239

What is clustering? . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . 239

Hardware-based clustering solutions .. . . . . . .. . . . . . .. . . . . . . . . . . . .. . 240

Software-based clustering solutions . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . 242

Combining hardware and software clustering solutions . . . . .. . . . . . .. . 244

xContents

Chapter 12 Configuring ColdFusion Clusters . . . . . . 245

Introductionto ClusterCATS Administration . . . . . . . . . .. . . . . . . . . . . . . .. . . . . 246

ClusterCATS Server . . . .. . . . . . .. . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . 246

ClusterCATSExplorer(Windows only) . . . . . . . . . . . . . .. . . . . . . . . . . . .. . 246

ClusterCATSWeb Explorer (UNIX only) . . . . . . . . .. . . . . . .. . . . . . . . . . . . 248

ClusterCATSServerAdministrator . . . . . . . .. . . . . .. . . . . . .. . . . . . . . . . . . 251

btadmin . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . 252

Creating Clusters. . . . .. . . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . 252

Creating clusters in Windows . . . . . . . .. . . . . . . . . .. . . . . . .. . . . . . .. . . . . 252

Creating clusters in UNIX . . . . . .. . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . 261

Removing Clusters . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . 263

Adding ClusterMembers. .. . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . 264

Adding cluster members in Windows . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . 264

Adding cluster members in UNIX . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . 265

Removing Cluster Members . . . . .. . . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . 266

Removing cluster members in Windows . . . . . . . . .. . . . . . . . . .. . . . . . .. . 266

Removing cluster members in UNIX . . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . 267

Server Load Thresholds . . . . . . . . .. . . . . . . . . . . . . .. . . . . . . . . .. . . . . .. . . . . . .. . 268

Configuring load thresholdsin Windows . . . . . . . .. . . . . . . . . . . . . .. . . . . 268

Configuring load thresholdson UNIX . . . . . . . .. . . . . . .. . . . . .. . . . . . .. . 272

Session-Aware Load Balancing. . . . . . .. . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . 276

Enabling session-aware load balancing on Windows . . . . . . .. . . . . . . . . 277

Enabling session-aware load balancing on UNIX . . . . .. . . . . .. . . . . . . . . 278

Configuring ColdFusion probes inWindows . . . . . . . . . . . .. . . . . . . . . . . . 280

Configuring ColdFusion probes in UNIX . . . . . . . . . . . .. . . . . . . . . . . . .. . 285

Load-Balancing Devices . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . 290

Using Cisco LocalDirector . . . . .. . . . . .. . . . . . . . . . . . . .. . . . . . . . . . . . .. . 290

Using third-partyload-balancing devices . . . . . . . .. . . . . . . . . . . . . .. . . . . 294

Administrator Alarm Notifications . . . . . .. . . . . . .. . . . . .. . . . . . . . . . . . . .. . . . . 296

Configuring administrator alarm notifications on Windows . . . . .. . . . . 297

Configuring administrator alarm notifications on UNIX . . . . . . . . . . . .. . 297

Administrator E-mail Options . . . . . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . . .. . . . . 299

Configuring administration e-mail options on Windows . . . . . . . .. . . . . 300

Configuring administration e-mail options on UNIX . . . . .. . . . . . .. . . . . 300

Administrating Security. . . . . . . . .. . . . . . .. . . . . . .. . . . . . . . . . . . .. . . . . . . . . . . . 302

Configuring authenticationon Windows . . . . . . . . . . . .. . . . . . . . . .. . . . . 302

Configuring authenticationon UNIX . . . . . . . . .. . . . . . .. . . . . .. . . . . . . . . 306

Questo manuale è adatto per i seguenti modelli

Indice

Altri manuali MACROMEDIA Software

MACROMEDIA

MACROMEDIA DREAMWEAVER 8 Manuale utente

MACROMEDIA

MACROMEDIA COLDFUSION MX 61 - INSTALLING COLDFUSION MX FOR IBM WEBSPHERE APPLICATION... Manuale utente

MACROMEDIA

MACROMEDIA DREAMWEAVER MX 2004-DREAMWEAVER API Manuale di servizio

MACROMEDIA

MACROMEDIA BREEZE-USING THE BREEZE XML WEB SERVICES Istruzioni per il montaggio

MACROMEDIA

MACROMEDIA BREEZE Guida di riferimento rapido

MACROMEDIA

MACROMEDIA COLFUSION MX 7-CFML Manuale utente

MACROMEDIA

MACROMEDIA FLASH MEDIA SERVER 2-CLIENT-SIDE ACTIONSCRIPT LANGUAGE REFERENCE FOR FLASH MEDIA SERVER... Manuale di servizio

MACROMEDIA

MACROMEDIA FLASH 8-INTRODUCTION TO FLASH LITE 2.X... Manuale di riferimento

MACROMEDIA

MACROMEDIA FREEHAND 10-USING FREEHAND Istruzioni per il montaggio

MACROMEDIA

MACROMEDIA FLASH 8-DEVELOPING FLASH LITE 2.X Manuale utente

MACROMEDIA

MACROMEDIA BREEZE PRESENTER Manuale utente

MACROMEDIA

MACROMEDIA COLDFUSION 4.5-DEVELOPING WEB Manuale utente

MACROMEDIA

MACROMEDIA BREEZE-USING THE MACROMEDIA BREEZE MANAGER Istruzioni per il montaggio

MACROMEDIA

MACROMEDIA DIRECTOR MX 2004-DIRECTOR SCRIPTING Manuale di servizio

MACROMEDIA

MACROMEDIA CONTRIBUTE 3 - USING AND ADMINISTERING... Istruzioni per il montaggio

MACROMEDIA

MACROMEDIA DREAMWEAVER 8-GETTING STARTED WITH... Manuale utente

MACROMEDIA

MACROMEDIA COLDFUSION 4.5- TO CFML Manuale utente

MACROMEDIA

MACROMEDIA FLASH MX 2004-LEARNING FLASH Manuale utente

MACROMEDIA

MACROMEDIA FLASH 8-LEARNING FLASH LITE 1.X ACTIONSCRIPT Manuale utente

MACROMEDIA

MACROMEDIA FLASH MEDIA SERVER 2-SERVER MANAGEMENT ACTIONSCRIPT... Manuale di servizio

MACROMEDIA

MACROMEDIA COLDFUSION MX-CLUSTERCATS Istruzioni per il montaggio

MACROMEDIA

MACROMEDIA COLDFUSION MX 61-DEVELOPING COLDFUSION MX Manuale utente

MACROMEDIA

MACROMEDIA FLASH 8-FLASH Manuale di servizio

MACROMEDIA

MACROMEDIA CONTRIBUTE 3-DEPLOYING CONTRIBUTE Manuale utente

Manuali Software popolari di altre marche

COMPRO

COMPRO COMPROFM Manuale utente

Muratec

Muratec OFFICEBRIDGE ONLINE Manuale utente

Oracle

Oracle Contact Center Anywhere 8.1 Manuale utente

Adobe

Adobe 65007312 - Photoshop Lightroom Manuale

Avaya

Avaya NULL One-X for RIM Blackberry Manuale utente

HP ProLiant BL420c Manuale utente

PS Audio

PS Audio PowerPlay Manuale del proprietario

Brady

Brady LOCKOUT PRO 3.0 Manuale di servizio

Avaya

Avaya Interaction Center Manuale utente

Texas Instruments

Texas Instruments TI-83 Plus Silver Edition Manuale

Novell

Novell GROUPWISE 8 - INTERNET AGENT Manuale utente

Oracle

Oracle Application 9i Manuale utente

Acer

Acer RDM Manuale utente

Canon

Canon Vixia HF21 Manuale utente

Canon

Canon ZR950 Manuale utente

Samsung

Samsung Auto Backup Manuale utente

Polycom

Polycom Vortex EF2201 Istruzioni per l'installazione e il funzionamento

Brocade Communications Systems

Brocade Communications Systems Brocade 8/12c Manuale utente