MACROMEDIA COLDFUSION 5 - INSTALING AND CONFIGURING SERVER User Manual

COLDFUSION®MX 7Configuring and Administering ColdFusion MX

100 Chapter 7: Using Multiple Server Instances8.(Optional) Click the Register Remote Instance button to define existing remote server instances so th

Defining remote server instances to the ColdFusion MX Administrator 10122.(Optional) Store the application’s ColdFusion files in your external web ser

102 Chapter 7: Using Multiple Server Instances

PART IIAdministering VerityThis part describes the Verity search tools and utilities that you can use for configuring the Verity K2 Server search engi

105CHAPTER 8Introducing Verity and Verity ToolsThis chapter provides an overview of the advanced Verity features included in Macromedia ColdFusion MX

106 Chapter 8: Introducing Verity and Verity ToolsServer configuration Through the -Xmx argument to the java.args parameter in the cf_root/runtime/b

About the Verity utilities 107About Verity Spider (vspider)Verity Spider (vspider) lets you index web-based and file system documents throughout your

108 Chapter 8: Introducing Verity and Verity Tools

109CHAPTER 9Indexing Collections with Verity SpiderThis chapter contains basic Verity Spider information and explains how to index documents on your w

11CHAPTER 1 Administering ColdFusion MXThis chapter presents an overview of Macromedia ColdFusion MX 7 configuration and administration tasks. Althoug

110 Chapter 9: Indexing Collections with Verity SpiderWeb standard supportVerity Spider supports key web standards used by Internet and intranet site

About Verity Spider syntax 111Efficient DNS lookupsVerity Spider minimizes DNS lookups, which means great improvements to spidering throughput. If spi

112 Chapter 9: Indexing Collections with Verity SpiderThere are dependencies for other options, depending on the nature of the indexing task. The fol

About Verity Spider syntax 113If an indexing task halts, you can rerun the task as-is. The persistent store for the specified collection is read, and

114 Chapter 9: Indexing Collections with Verity SpiderCore optionsThe following sections describe the Verity Spider core options.-cmdfileSyntax: -cmd

Processing options 115-styleSyntax: -style pathSpecifies the path to the style files to use when creating a new collection. If the -style option is no

116 Chapter 9: Indexing Collections with Verity Spider-maxindmemSyntax: -maxindmem kilobytesSpecifies the maximum amount of memory, in kilobytes, use

Processing options 117-nodupdetectTyp e : Web crawling onlyDisables checksum-based detection of duplicates when indexing websites. URL-based duplicate

118 Chapter 9: Indexing Collections with Verity Spider-preferredTyp e : Web crawling onlySyntax: -preferred exp_1 [exp_n] ...Specifies a list of host

Processing options 119Due to the use of special characters, which represent the bulk insert file (BIF), you must run Verity Spider with a command file

12 Chapter 1: Administering ColdFusion MXIf your ColdFusion MX Administrator is on a remote computer, use the Domain Name Services (DNS) name or Inte

120 Chapter 9: Indexing Collections with Verity SpiderIf a halt occurs during indexing, the chunk of documents specified by the -submitsize option is

Networking options 121-delayTyp e : Web crawling onlySyntax: -delay num_millisecondsSpecifies the minimum time between HTTP requests, in milliseconds.

122 Chapter 9: Indexing Collections with Verity Spider-noproxyTyp e : Web crawling onlySyntax: -noproxy name_1 [name_n] ...Used in conjunction with t

Path and URL options 123-retryTyp e : Web crawling onlySyntax: -retry num_retriesSpecifies the number of times that Verity Spider should attempt to ac

124 Chapter 9: Indexing Collections with Verity SpiderExampleThe following is a URL without parameters:http://server.com/cgi-bin/program?If you inclu

Path and URL options 125-httpsTyp e : Web crawling onlyLets you index SSL-enabled websites.Note: You must have the Verity SSL Option Pack installed to

126 Chapter 9: Indexing Collections with Verity Spider-noroboType: Web crawling onlySpecifies to ignore any robots.txt files encountered. The robots.

Path and URL options 127If you specify the following:-refreshtime 1 day 6 hoursOnly those documents that were last indexed at least 30 hours and 1 sec

128 Chapter 9: Indexing Collections with Verity SpiderContent optionsThe following sections describe the Verity Spider content options.-casesenMakes

Content options 129In Windows, include double-quotation marks around the argument to protect the special characters, such as the asterisk (*). On UNIX

13CHAPTER 2Using the ColdFusion MX AdministratorThis chapter explains the basic administration tasks, following the structure of the Macromedia ColdFu

130 Chapter 9: Indexing Collections with Verity SpiderSee also -regexp.-indincludeSyntax: -indinclude exp_1 [exp_n] ...Specifies that only those file

Content options 131In Windows, include double-quotation marks around the argument to protect the special characters, such as the asterisk (*). On UNIX

132 Chapter 9: Indexing Collections with Verity SpiderSpecifies that Verity Spider follow and parse links, but not index, any HTML document that cont

Content options 133Lets you use a text file to map custom meta tags to valid HTTP header fields. If you use backslashes, you must double them so that

134 Chapter 9: Indexing Collections with Verity Spider-mimeincludeSyntax: -mimeinclude mime_1 [mime_n] ...Specifies MIME types to be included.In Wind

Locale options 135Example 1To skip all HTML documents that contain the word "personnel" in the Title element, use the following:-skip title

136 Chapter 9: Indexing Collections with Verity Spider-msgdbSyntax: -msgdb pathSpecifies the path to the ind.msg message database file. If Verity Spi

Maintenance options 137Choose one of the following arguments to determine which message types are logged:Maintenance optionsThe following sections des

138 Chapter 9: Indexing Collections with Verity Spider-purgeDeletes document tables and index files in the collection, and cleans up the collection&a

Setting MIME types 139You can also use multiple instances of the MIME type criteria, each with a single parameter value, where quotation marks are nec

14 Chapter 2: Using the ColdFusion MX AdministratorInitial administration tasksImmediately after you install ColdFusion MX, you might have to perform

140 Chapter 9: Indexing Collections with Verity SpiderOn either platform, you must include single-quotation marks for values that include wildcard ch

141CHAPTER 10Using Verity UtilitiesThis chapter provides information about using Verity utilities to configure, maintain, and troubleshoot Verity coll

142 Chapter 10: Using Verity UtilitiesLocation of Verity utilitiesThe Verity command-line utilities are located in the following directories:Server a

Using the mkvdk utility 143The log file contains the following fields:• Date• Time• Level• Code• Component• DescriptionYou can use the log file to vie

144 Chapter 10: Using Verity UtilitiesCreating a collectionCreating a collection with the mkvdk utility involves setting up a collection directory st

Using the mkvdk utility 145General processing optionsThe mkvdk utility provides a variety of general processing options, which the following table des

146 Chapter 10: Using Verity UtilitiesExamples: processing documentsThe following examples show the commands for processing documents.Using the defau

Using the mkvdk utility 147Bulk inserting or deletingThe following command specifies bulk insertion of a list of documents:mkvdk -collection coll -bul

148 Chapter 10: Using Verity UtilitiesMessage optionsThe mkvdk utility provides a variety of messaging options, as described in the following table:D

Using the mkvdk utility 149Bulk submit optionsThe mkvdk utility provides a variety of bulk submit options, as described in the following table:Using b

Server Settings section 15Getting Started Experience Click the Getting Started link to open the Getting Started Experience, which provides descriptio

150 Chapter 10: Using Verity UtilitiesCollection maintenance optionsThe mkvdk utility provides a variety of collection maintenance options, as descri

Using the mkvdk utility 151Deleting a collectionTo delete a collection, use the appropriate command for your operating system. For example, to remove

152 Chapter 10: Using Verity UtilitiesAbout squeezing deleted documentsWhen a document is deleted from a collection, its space is not recovered. It i

Using the rck2 utility 153The VDB optimization option optimizes the packing of a collection’s VDBs. When VDBs are built during normal indexing operati

154 Chapter 10: Using Verity UtilitiesThe rck2 command optionsThe following table describes rck2 command options:Using the rcvdk utilityUsing the Ver

Using the rcvdk utility 155When you start the rcvdk utility with no arguments, you get the following message, followed by the rcvdk prompt:Type '

156 Chapter 10: Using Verity UtilitiesIn the message returned for the preceding search, the rcvdk utility indicates that 18 documents matched the que

Using the rcvdk utility 157The following table describes each of the default fields:Displaying more fieldsYou can tell the rcvdk utility to display ce

158 Chapter 10: Using Verity Utilities14: Supported Field Types15:16: Recognized Document Types17: Custom Zone Definitions18: The KeyView Filter KitR

Using the didump utility 159acronym 5 1 2acronyms 4 1 1actual 4 1 1administrator 3

16 Chapter 2: Using the ColdFusion MX AdministratorCaching pageThe Caching page of the Administrator contains configuration options that you can set

160 Chapter 10: Using Verity UtilitiesSize The number of bytes used by the Verity engine to store information about the zone.Doc The number of uniq

Using the browse utility 161The browse utility executable, which starts the browse utility application, is located in the platform/bin directory. For

162 Chapter 10: Using Verity Utilities61 Title_OF FIX-unsg ( 4) = 248162 Title_SZ FIX-unsg ( 2) = 15You can eliminate the int

Using the merge utility 163The merge utility reads srcCollection and splits it into roughly equal pieces, using the filenames given for newCollection1

164 Chapter 10: Using Verity Utilities

165INDEXAAddHandler directive 67administration, initial tasks 14Administrator APIabout 39enabling access through sandbox security 36Apacheapplicat

166 IndexColdFusion mappingsJ2EE archive 82ColdFusion MX Administratorabout 11Caching Settings page 16CF Admin Password page 35CFX Tags page 33Ch

Index 167Debugging IP Addresses page, ColdFusion MX Administrator 29Debugging Settings page, ColdFusion MX Administrator 26didump utilityexecutable

168 IndexJRun Management Console (JMC)cluster creation 99creating server instances 93starting and stopping JRun 93JRun serverscreating 93custom jv

Index 169multiserver configurationapplication isolation 94clustering 99defining server instances 93multiple server instances 91MySQL, connecting t

Server Settings section 17Client Variables pageClient variables let you store user information and preferences between sessions. Using information fro

170 IndexSimple Mail Transfer Protocol (SMTP) mail server 20sourceless distribution 82, 83ssl property 72sticky sessions 100Sun ONE Web Serverabo

18 Chapter 2: Using the ColdFusion MX AdministratorThe following table compares the client variable storage options:Migrating client variable dataTo

Server Settings section 19Sample table creation page<!---- Create the Client variable storage tables in a datasource. This example applies to Micro

Trademarks1 Step RoboPDF, ActiveEdit, ActiveTest, Authorware, Blue Sky Software, Blue Sky, Breeze, Breezo, Captivate, Central, ColdFusion, Contribute,

20 Chapter 2: Using the ColdFusion MX AdministratorYou can also specify whether to use J2EE session variables. When you enable the J2EE session varia

Server Settings section 21Mail Server Settings areaThe following table describes basic mail server settings:Mail Spool Settings areaThe following tabl

22 Chapter 2: Using the ColdFusion MX AdministratorMail Logging Settings areaSelect preferences for handling mail logs, as described in the following

Server Settings section 23Charting Settings pageThe ColdFusion charting and graphing engine lets you produce highly customizable business graphics, in

24 Chapter 2: Using the ColdFusion MX AdministratorJava and JVM Settings pageThe Java and JVM Settings page lets you specify the following settings,

Data & Services section 25The Data & Services section contains the following pages:• Data Sources page• Verity Collect ions page• Verity K2 Se

26 Chapter 2: Using the ColdFusion MX AdministratorVerity K2 Server pageYou can install Verity on a different host computer from the one ColdFusion M

Debugging & Logging section 27The Debugging Settings page provides the following debugging options:* Restart ColdFusion MX after changing this set

28 Chapter 2: Using the ColdFusion MX AdministratorUsing the cfstat utilityThe cfstat command-line utility provides real-time performance metrics for

Debugging & Logging section 29Before you use the cfstat utility, ensure that you selected the Enable Performance Monitoring check box in the ColdF

3CONTENTSINTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7PART I: Administering C

30 Chapter 2: Using the ColdFusion MX AdministratorLogging Settings pageYou use the Logging Settings page of the Administrator to change ColdFusion M

Debugging & Logging section 31Scheduled Tasks pageYou use the Scheduled Tasks page to schedule the execution of local and remote web pages, to gen

32 Chapter 2: Using the ColdFusion MX AdministratorSystem probes are available in ColdFusion MX Enterprise Edition only.Code Compatibility Analyzer p

Extensions section 33CFX Tags pageBefore you can use a CFX tag in ColdFusion applications, you must register it. You use the CFX Tags page to register

34 Chapter 2: Using the ColdFusion MX AdministratorColdFusion includes the vbjorb.properties file, which contains the following properties that confi

Security section 35Gateway Instances pageThe Gateway Instances page lets you configure ColdFusion event gateway instances to direct events from variou

36 Chapter 2: Using the ColdFusion MX AdministratorRDS Password pageYou use the RDS Password page to enable and disable password-restricted RDS acces

Enterprise Manager section 37• Verity collections• Scheduled tasks• Event gateway instances• Java applets• CFX tags• Archive to do listsAfter you arch

38 Chapter 2: Using the ColdFusion MX AdministratorInstance Manager pageThe Instance Manager page lets you view the local and remote JRun servers tha

Administrator API 39Administrator APIYou can perform most ColdFusion MX Administrator tasks programmatically using the Administrator API. The Administ

4 ContentsCHAPTER 4: Web Server Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65About web servers in ColdFusion MX. . .

40 Chapter 2: Using the ColdFusion MX AdministratorTo use the Administrator API:1.Instantiate administrator.cfc:<cfscript>// Login is always re

Administrator API 41storedProc = true,alter = false,grant = true,select = true,update = true,create = true,delete = true,drop = false,revoke = false )

42 Chapter 2: Using the ColdFusion MX Administrator//Create a DSN.myObj.setMSSQL(argumentCollection=stDSN);</cfscript><!--- Optionally dump

43CHAPTER 3Data Source ManagementA data source is a complete database configuration that uses a JDBC driver to communicate with a specific database. I

44 Chapter 3: Data Source ManagementAbout JDBCJDBC is a Java Application Programming Interface (API) that you use to execute SQL statements. JDBC ena

Adding data sources 45Supplied driversThe following table lists the database drivers supplied with ColdFusion MX and where you can find more informati

46 Chapter 3: Data Source ManagementAdding data sources in the AdministratorYou use the ColdFusion MX Administrator to quickly add a data source for

Connecting to DB2 Universal Database 47Guidelines for data sourcesWhen you add data sources to ColdFusion MX, keep the following guidelines in mind:•

48 Chapter 3: Data Source ManagementConnection StringA field that passes database-specific parameters, such as login credentials, to the data source.

Connecting to Informix 49Connecting to InformixTo see a list of Informix versions that ColdFusion MX supports, go to www.macromedia.com/go/sysreqscf.

Contents 5CHAPTER 10: Using Verity Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141Overview of Verity utilities .

50 Chapter 3: Data Source ManagementConnecting to Microsoft AccessUse the settings in the following table to connect ColdFusion MX to Microsoft Acces

Connecting to Microsoft Access 51Description (Optional) A description for this connection.Page Timeout The number of milliseconds before a request for

52 Chapter 3: Data Source ManagementConnecting to Microsoft Access with UnicodeUse the settings in the following table to connect ColdFusion MX to Mi

Connecting to Microsoft SQL Server 53Note: This driver uses the Microsoft Jet list of reserved words, including the word Last. For a complete list, se

54 Chapter 3: Data Source ManagementSelect Method Determines whether server cursors are used for SQL queries.• The Direct method provides more effici

Connecting to Microsoft SQL Server 55Settings for the Northwind sample databaseSQL Server ships with a sample database named Northwind. Establishing a

56 Chapter 3: Data Source Management• You are running a connection-limited version of SQL Server and the request exceeds the limit for TCP/IP connect

Connecting to ODBC Socket 57Connecting to ODBC SocketUse the settings in the following table to connect ColdFusion MX to ODBC Socket data sources (thi

58 Chapter 3: Data Source ManagementPassword The password that ColdFusion MX passes to the JDBC driver to connect to the data source if a ColdFusion

Connecting to Oracle 59Connecting to OracleTo see a list of Oracle versions that ColdFusion MX supports, go to www.macromedia.com/go/sysreqscf. Use th

6 Contents

60 Chapter 3: Data Source ManagementConnecting to other data sourcesUse the settings in the following table to connect ColdFusion MX to data sources

Connecting to other data sources 61For example, you can use the Other Data Sources option to define a data source for DB2 OS/390 or iSeries, using the

62 Chapter 3: Data Source Management• On subsequent connections, specify LocationName, CollectionId, and sendStringParametersAsUnicode, as the follow

Connecting to JNDI data sources 63Connecting to JNDI data sourcesUse the settings in the following table to connect ColdFusion MX to JNDI data sources

64 Chapter 3: Data Source ManagementNote: The ColdFusion MX Administrator does not display the JNDI data source option when running in the server con

65CHAPTER 4Web Server ManagementYou can connect Macromedia ColdFusion MX to the built-in web server and to external web servers, such as Apache, IIS,

66 Chapter 4: Web Server ManagementUsing the built-in web serverThe ColdFusion MX server configuration is built on top of JRun, which includes the JR

Using an external web server 67• If you want the built-in web server to serve pages from a different web root directory, define a virtual mapping in t

68 Chapter 4: Web Server ManagementWeb server configurationColdFusion MX uses the Web Server Configuration Tool to configure an external web server w

Web server configuration 699.(Optional) The web server connector does not serve static content (such as HTML files and images) from the built-in web s

INTRODUCTIONConfiguring and Administering ColdFusion MX is intended for anyone who needs to configure and manage their ColdFusion development environm

70 Chapter 4: Web Server ManagementUsing the batch files and shell scriptsThe ColdFusion MX server configuration includes batch files and shell scrip

Web server configuration 71Command-line interface examplesThis section provides examples of multiple use-cases for different web servers:• Configure a

72 Chapter 4: Web Server ManagementThe following table describes the web server connector properties in the web server configuration files. The web s

Web server configuration 73Apache configuration fileThe following is a typical httpd.conf file for an installation of ColdFusion MX on the same comput

74 Chapter 4: Web Server ManagementNameTrans fn="document-root" root="$docroot"PathCheck fn="nt-uri-clean"PathCheck fn=

Multihoming 75Multihoming configuration tasks include the following:Enabling access to the ColdFusion MX Administrator If any of the applications und

76 Chapter 4: Web Server ManagementApacheWhen you use Apache, you modify the apache_root/conf/httpd.conf file to create virtual hosts and run the Web

Multihoming 77Sun ONE Web Server, iPlanet, and NetscapeWhen you use Sun ONE Web Server version 6, you use the Server Administrator to create virtual s

78 Chapter 4: Web Server Management

79CHAPTER 5Deploying ColdFusion ApplicationsThis chapter describes the archive and deployment options available in Macromedia ColdFusion MX 7.Contents

8 Introduction: Viewing online documentationAll ColdFusion MX documentation is available online in HTML and Adobe Acrobat Portable Document Format (P

80 Chapter 5: Deploying ColdFusion ApplicationsPerform the following steps when you archive and deploy site information:1.Create the archive definiti

Packaging applications in J2EE archive files 81Application packagingThe J2EE Archive feature lets you quickly create an archive file that a J2EE admin

82 Chapter 5: Deploying ColdFusion ApplicationsDeployment considerationsOnce the archive file is created, you deploy using standard ColdFusion MX J2E

Using the cfcompile utility 83The following table describes these parameters:Sourceless distributionYou can use the cfcompile utility with the -deploy

84 Chapter 5: Deploying ColdFusion Applications

85CHAPTER 6Administering SecurityThis chapter describes configuration options for Macromedia ColdFusion MX security. You can secure a number of Macrom

86 Chapter 6: Administering SecurityThe Security area in the Administrator lets you do the following tasks:• Configure password protection for the Co

Using sandbox security 87To use sandbox security in the multiserver and J2EE editions, the application server must be running a security manager (java

88 Chapter 6: Administering SecurityFor more information, see the Administrator online Help.Note: When you run ColdFusion MX in the J2EE configuratio

Using sandbox security 89Configuring a sandboxBefore you begin security sandbox configuration, analyze your application and its usage to determine the

PART IAdministering ColdFusion MX 7This part describes how to manage the ColdFusion environment, including using the ColdFusion MX Administrator, conn

90 Chapter 6: Administering Security12.In the Secured Files and Directories list, verify that the file path is correct.The character after the backsl

91CHAPTER 7Using Multiple Server InstancesWhen you install Macromedia ColdFusion MX 7 Enterprise Edition using the multiserver configuration, you can

92 Chapter 7: Using Multiple Server InstancesAbout multiple server instancesThe ColdFusion MX Administrator lets you create server instances and clus

Defining additional server instances 93Defining additional server instancesThe multiserver configuration is a customized installation of JRun. JRun su

94 Chapter 7: Using Multiple Server InstancesEnabling application isolationYou can create separate server instances, each with its own ColdFusion app

Enabling application isolation 95To use multiple server instances for application isolation:1.Create a separate server instance using the instructions

96 Chapter 7: Using Multiple Server InstancesConfiguring application isolation in ApacheWhen you use multiple virtual hosts with multiple server inst

Enabling application isolation 97 #JRunConfig ProxyRetryInterval <number of seconds to wait before trying to reconnect to unreachable clustered

98 Chapter 7: Using Multiple Server InstancesNameVirtualHost 127.0.0.1<VirtualHost 127.0.0.1> ServerAdmin [email protected] DocumentRoot &

Enabling clustering for load balancing and failover 99Enabling clustering for load balancing and failoverLoad balancing is an enterprise-level feature