| Administering ColdFusion MX |
|
|
Basic ColdFusion MX Administration |
|
| Administering ColdFusion MX |
|
|
Basic ColdFusion MX Administration |
|
The Server Settings section lets you manage client and memory variables, mappings, charting, and archiving. You also configure mail and Java settings in this section.
The Settings page of the ColdFusion Administrator contains configuration options that you can set or enable to manage ColdFusion MX. These options can significantly affect server performance. The following table describes the settings:
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:
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 MX on the Client Variables page of the Administrator. ColdFusion MX lets you store client variables in the following ways:
If your data source uses a bundled JDBC driver, 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. For more information, see Developing ColdFusion MX Applications with CFML.
Caution: Macromedia 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.
You can override settings specified in the Client Variables page using the attributes of the cfapplication tag. For more information, see Developing ColdFusion MX Applications with CFML
The following table compares these storage options:
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 small database tables, like those shown in the following tables:
| 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 |
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.
Tip: The ColdFusion Administrator can create client variable tables for data sources that use bundled JDBC drivers. For more information, see the online Help.
<!---- 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#">
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>
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 MX. 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 in two days. Session variables expire when user sessions end. To change these behaviors, enter new default and maximum timeout values on the Memory Variables page of the Administrator.
Note: Timeout values that you specify for application variables override the timeout values set in Application.cfm.
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 Developing ColdFusion MX Applications with CFML.
You 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 processed by ColdFusion MX with the cfinclude and cfmodule tags. If you save CFML pages outside of the web_root (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:\CFusionMX\wwwroot, but all your ColdFusion header pages reside in c:\2002\newpages\headers. In order for ColdFusion MX 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:\CFusionMX\wwwroot, you reference these header pages using /headers in your cfinclude and cfmodule 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, please consult your web server's documentation.
You use the Mail Server page of the ColdFusion Administrator to specify a mail server to send automated e-mail messages. ColdFusion MX supports the Simple Mail Transfer Protocol (SMTP) for sending e-mail messages and the Post Office Protocol (POP) for retrieving e-mail messages from your mail server. To use e-mail messaging in your ColdFusion applications, you must have access to an SMTP server and/or a POP account.
The ColdFusion implementation of SMTP mail uses a spooled architecture. This means that when a cfmail tag 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 Developing ColdFusion MX Applications with CFML.
Select preferences for handling mail logs, as described in the following table:
Select preferences for handling mail logs, as described in the following table:
ColdFusion MX writes sent mail and mail error logs to either of the following directories:
The following table describes the e-mail log files:
| Log |
Description |
|---|---|
| mailsent.log |
Records sent e-mail messages |
| mail.log |
Records general e-mail errors |
The ColdFusion charting and graphing engine lets you produce highly customizable business graphics, in a variety of formats, using the cfchart tag. You use the Charting page in the Administrator to control characteristics of the engine.
The following table describes the caching and thread settings for the ColdFusion charting and graphing engine:
The Java and JVM Settings page lets you specify the following settings, which enable ColdFusion MX to work with Java:
Before ColdFusion saves your changes, it saves a copy of the current jvm.config file as jvm.bak. If you r changes prevent ColdFusion from restarting, use jvm.bak to restore your system. For more information, see the online Help.
The Archives and Deployment page includes tools that let you archive and deploy ColdFusion applications, configuration settings, data source information, and other types of information to back up your files quickly and easily. The complete list of archivable information includes the following:
After you archive the information, you can use the Administrator to deploy your web applications to the same ColdFusion MX server or to a ColdFusion MX server running on a different computer. Additionally, you can use these features to deploy and receive any ColdFusion archive file electronically.
The Archive Settings page in the Administrator lets you configure various archive system settings that apply to all archive and deploy operations. For more inforamtion, see the online Help.
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.