Manage client variables

If you want to manage client variables using an external data source, before using that source you have to configure it as a data source. For details, see the appropriate Configure data sources topic.

 

Next, enable it on the Client Variables page by doing the following steps:

  1. In the ColdFusion Administrator navigation frame, click Server>Client Variables. The Client Variable page appears.

  2. From the drop-down list at the top of the page, select the name of the data source that you want to use for storing client variables.

  3. Click Add Client Variable Store. The Add/Edit Client Store page for your data source appears. 

  4. On the Add/Edit Client Store page, select the options you want for your data source as described in the following table. If you do not want to make any changes, you can return to the Client Variables screen using one of the arrows provided on the page.

 

Option

Description

Default

Purge data for clients that remain unvisited for [n] days

Ordinarily, client data is not preserved indefinitely. Enable this option to periodically purge client data that has not been accessed in a specified number of days, and enter a number.

 

Note: If a cluster of ColdFusion servers uses this data source, be sure that only one server is configured to purge client data.

Enabled; 90

Disable global client variable updates

By default, ColdFusion updates client variables for every page request. Use this option if you do not want ColdFusion to perform these updates.

 

When updates are disabled, ColdFusion only updates global client variables when they are first created and when they are updated. Disabling updates helps improve the performance of your application pages.

Disabled

Create Client database tables

Use this option only when you configure the current data source for the first time. ColdFusion creates the tables necessary for client variables. If the current source has already been configured, disable this option. Otherwise, ColdFusion generates an SQL error because it tries to create tables that already exist.

Enabled

 

  1. Click Submit Changes when you finish with the Add/Edit Client Store page to return to the Client Variables page.

  2. In the Client Variable Storage Mechanism table, click one of the available options to store client variables. Registry is the default selection at installation.


     

  3. Click Apply to save your settings.

Related topics