User manual MACROMEDIA COLDFUSION 5 INSTALING AND CONFIGURING SERVER

[. . . ] Installing and Configuring ColdFusion Server ColdFusion Server 5 Macromedia, Inc. Copyright Notice © 2001 Macromedia Inc. This manual, as well as the software described in it, is furnished under license and may be used or copied only in accordance with the terms of such license. The content of this manual is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Macromedia Inc. assumes no responsibility or liability for any errors or inaccuracies that may appear in this book. [. . . ] Click Submit Changes. To enable client variable storage in a data source as the default: 1 2 3 In the Client Variable page, select a data source in the drop-down list. On the Add/Edit Client Store page, select options for the data source, as described in the following table. If you do not want to make changes, return to the Client Variables screen using one of the arrows on the page. Option Description Purge data for Enable this option to periodically purge client data that has not clients that been accessed in a specified number of days, and enter a remain number. unvisited for [n] days Disable global Enable this option to prevent ColdFusion Server from updating client variable client variables for every page request. When updates are updates disabled, ColdFusion Server only updates global client variables when they are created and when they are changed. Create Client database tables Enable this option only when you configure a data source for client variable storage the first time. Otherwise, ColdFusion Server generates an SQL error because it tries to create tables that already exist. 4 Click Submit Changes. 74 Chapter 5 Basic ColdFusion Server Administration Note If a cluster of ColdFusion Servers uses this data source, ensure that only one server is configured to purge client data. Migrating Client Variable Data To migrate your client variable data to another data source, you should know the structure of the database tables used to store this information. Client variables stored externally use two small database tables, like those shown in the following tables: CGLOBAL Table Column cfid data lvisit Data Type char(64) memo date CDATA Table Column cfid app data Data Type char(64) char(64) memo Creating client variable tables Use this example 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. Refer to your database documentation for the proper data type. 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> Client Variables 75 <CFQUERY NAME="data2" DATASOURCE="#DSN#"> 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> 76 Chapter 5 Basic ColdFusion Server Administration Memory Variables You 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 Server. 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 timeout values for session and application variables. Unless you define a timeout value in Application. cfm, application variables expire when you restart ColdFusion Server. Note Timeout values that you specify for application variables override the timeout values set in Application. cfm. Locking 77 Locking You use the Locking page of the ColdFusion Administrator to configure automatic mechanisms to protect shared data from incorrect access and corruption. In addition, the cflock tag provides granular control of simultaneous access to shared data scope variables, including server, application, and session scopes. For more information on the cflock tag, see Developing ColdFusion Applications Single threaded sessions Single threading means that requests from a session occur sequentially. Each request from the same session waits for previous requests to finish before proceeding, thereby preventing multiple requests from simultaneously accessing shared data. Because session requests occur sequentially, single threaded sessions are useful if you do not want to lock session scope variables with the cflock tag. At the same time, if you use frames in your ColdFusion application, each pane loads consecutively. [. . . ] The ClusterCATS Explorer resides at the corporate headquarters behind a firewall with a direct connection to the Internet. You must open and configure the appropriate communication ports on your firewalls to allow server to server communication in a distributed setting and server to client communication. Note You must open both ports on all affected firewalls. These ports include the following: · Port 9123 (for TCP and UDP access) Opening port 9123 on your firewall allows multiple, distributed cluster of servers residing in different locations to communicate with one another across firewalls. · Port 9129 (for TCP and UDP access) Opening port 9129 on a firewall allows the ClusterCATS Explorer to communicate with multiple, distributed clusters of servers across firewalls. Before You Install ColdFusion Server 145 Analyzing Web server content All Web servers, virtual server, or Web sites in the same cluster must have identical content. [. . . ]