cPanel & WHM no longer develops or updates EasyApache 3. We deprecated EasyApache 3 on December 31, 2018. We removed support for EasyApache 3 in cPanel & WHM version 78.
Apache Module: DistCache - EasyApache - cPanel Documentation
Page tree
Skip to end of metadata
Go to start of metadata

Overview

The distcache Apache module implements distributed session caching.

Usage

Use the distcache Apache module to allow a cluster of secure web servers to share a single network-based session cache.

Warnings:

  • The last update from the developers of the distcache Apache module was in 2004.
  • The distcache Apache module is only available for CentOS version 5.x.

How to install or uninstall distcache

The EasyApache profiles do not provide the distcache Apache module by default.

To install or uninstall the distcache Apache module, perform the following steps:

  1. Install the required files. For more information, read our Apache Module: DistCache - Requirements documentation.
  2. Run EasyApache in WHM's EasyApache 3 interface (Home >> Software >> EasyApache 3).

    Note:

    To access EasyApache from the command line interface, run the /scripts/easyapache script as the root user.
  3. Select the profile that you wish to modify.

  4. Click the  icon that corresponds to your selection.

  5. Click Next Step in the Apache Version stage.
  6. Click Next Step in the PHP Version stage.
  7. Click Exhaustive Options List in the Short Options List stage.
  8. Perform one of the following actions in the Exhaustive Options List stage:
    • To install the distcache Apache module, select the Distcache option.
    • To uninstall the distcache Apache module, deselect the Distcache option.
  9. Click Save and Build.

How to enable or disable the module in a custom EasyApache profile file

The following table contains the module information that EasyApache stores in the profile file for the module:

EasyApache module namedistcache
EasyApache Profile EntryApache: optmods: Distcache

To enable or disable the distcache Apache module in a custom EasyApache profile file, set the Apache: optmods: Distcache profile entry to one of the following values:

  • 1 - This value enables the module.
  • 0 - This value disables the module.

Requirements

CentOS 5.5

The distcache Apache module is only available for CentOS version 5.x. If your server does not have CentOS version 5.x and you select the Distcache option in EasyApache, EasyApache will not include the distcache Apache module in your build.

distcache-devel

The distcache Apache module requires the distcache-devel package. The distcache-devel package is managed by your operating system.

Download and install the distcache-devel package from the distcache project Files website.

Important:

If EasyApache does not find the /usr/include/distcache/dc_client.h file on your server, EasyApache will disable the distcache module.

Compatibility

This module has no known compatibility issues.

History

DateEasyApache versionActionDetails
2/11/20143.24.11Doc updateRemoved Apache 1.3 and 2.0
1/31/20133.18.0Doc updateUpdate for Apache 2.4
7/15/20113.4.2EA updateFixed case 51431: Remove distcache from the build if the package is not installed

Related documentation

For more information on EasyApache, read our EasyApache documentation.

Vendor documentation

The following text is an excerpt from the distcache project website:

Distributed session caching tools and APIs, primarily for SSL/TLS servers though perhaps useful for other (non-SSL/TLS) circumstances. Also includes a self-contained network abstraction library (libnal), and the sslswamp SSL/TLS benchmark/test utility.

For more information on the distcache Apache module, click the following link:

Apache versionDocumentation
2.2 or 2.4The distcache project