---
title: Configuring uncached attributes and entries
description: Configure uncached attributes and entries.
component: pingdirectory
version: 11.0
page_id: pingdirectory:pingdirectory_server_administration_guide:pd_ds_config_uncached_attrs_entries
canonical_url: https://docs.pingidentity.com/pingdirectory/11.0/pingdirectory_server_administration_guide/pd_ds_config_uncached_attrs_entries.html
revdate: September 13, 2023
section_ids:
  about-this-task: About this task
  steps: Steps
  example: Example:
  example-2: Example:
  example-3: Example:
  example-4: Example:
---

# Configuring uncached attributes and entries

Configure uncached attributes and entries.

## About this task

The following procedure assumes that the `uncached-id2entry-cache-mode` property is set to the default value, `cache-keys-only`. For more information on the `uncached-id2entry` cache modes, see the PingDirectory Server Configuration Reference.

## Steps

1. Run `dsconfig` to uncache entries that match the criteria.

   ### Example:

   ```shell
   $ bin/dsconfig create-uncached-entry-criteria \
     --criteria-name "Fully Uncached l=austin" --type filter-based \
     --set enabled:true --set "filter:(l=austin)"
   ```

   The filter uncaches all entries that have its location set to "austin", such as `l=austin`.

2. Run `dsconfig` to uncache attributes that match the criteria.

   The `--type simple` option indicates that the simple uncached attribute criteria be used to specify the attribute-type that should be uncached. For those entries that are fully stored in the `uncached-id2entry` database container, the uncached attribute is ignored.

   ### Example:

   In this example, the attribute-type criteria that should be uncached is `jpegPhoto`.

   ```shell
   $ bin/dsconfig create-uncached-attribute-criteria \
     --criteria-name "Uncached jpegPhoto" --type simple \
     --set enabled:true --set attribute-type:jpegPhoto
   ```

3. Set the uncached properties for the `userRoot` backend.

   ### Example:

   ```shell
   $ bin/dsconfig set-backend-prop \
     --backend-name userRoot \
     --set "uncached-entry-criteria:Fully Uncached l=austin" \
     --set "uncached-attribute-criteria:Uncached jpegPhoto"
   ```

4. Run the `re-encode-entries` tool to initiate a task that causes a local DB `userRoot` backend to re-encode all or a specified subset of the entries that it contains.

   The tool does not alter the entries themselves but provides a useful mechanism for applying significant changes to the way that entries are stored in the backend.

   ### Example:

   The following example initiates a task that re-encodes all fully-cached entries in the `userRoot` backend, rate-limited to no more than 100 entries per second.

   ```shell
   $ bin/re-encode-entries --hostname directory.example.com --port 389 \
     --bindDN uid=admin,dc=example,dc=com --bindPassword password \
     --backendID userRoot --skipFullyUncachedEntries \
     --skipPartiallyUncachedEntries --ratePerSecond 100
   ```