Share this page

# Versioned Repository Schema caching‌

An OpenText Dimensions CM server pre-caches Versioned Repository Schema (VRS) data into a directory on disk. Pre-caching is automatic when a project, stream, or baseline is accessed for the first time and is sufficiently large to benefit from pre-caching.

The main benefits of data caching are improved performance when:

- Opening, or switching between, projects, streams, and baselines.

- Performing operations such as update, deliver, create baseline, create stream, and merge.

OpenText Dimensions CM administrators can perform initial pre-caching of the name store, project, or baseline structure data for the base database. For details on how to precache VRS data, see System administration.

See also Knowledgebase item S141604.

Configure VRS

To configure VRS, modify the following variables in the dm.cfg server configuration file:

Variable | Description
--- | ---
DISABLE_DM_DBCACHE | VRS data caching is enabled by default. To disable it, set this value to no: `DISABLE_DM_DBCACHE n`
DM_DBCACHE_DIR | Specifies the location of the VRS data cache on the server. Default locations:
Windows | DM_DBCACHE_DIR %installdir%\db_cache_dir\
UNIX | DM_DBCACHE_DIR $installdir/db_cache_dir/
Users who start application server processes (DMAPPSRV) must have read and write permission on the cache directory. A user can be: The pool owner if the listener pool is configured to run in proxy mode. The user group that is allowed to login when proxy mode is not in use (%installdir%/dfs/listener.dat has the parameter -dont_use_proxy).

The following variables are hard-coded and cannot be changed:

Hard-coded variable | Description
--- | ---
    DM_DBCACHE_UPDATE_THRESHOLD 4096
| Specifies the number of new non-cached names/arcs loaded into a private VRS store section that trigger initial pre-caching/updating of an existing store.
    DM_DBCACHE_CLEANUP_INTERVAL 24
| Specifies the interval (in hours) the cache checks if the total file size for a base database exceeds the threshold set by the parameter DM_DBCACHE_MAXSIZE. If the threshold is exceeded, the files that have not been accessed for the longest period are deleted from the cache.
    DM_DBCACHE_MAXSIZE 4096
| Specifies the cache size threshold that triggers a cache cleanup.
    DM_DBCACHE_CLEANUP_THROTTLE 3600
| Idle timeout and client sessions can be very short. To avoid frequent, unnecessary cache cleanups, the default throttle interval controls how often a single application server process can schedule a cache cleanup (3600 seconds/1 hour). When a product is deleted using the DWP command, the application server runs a forced cache cleanup irrespective of the last cache cleanup time or interval.

Back to top

See also:

- Performance
- Advanced optimization

https://admhelp.microfocus.com Dimensions CM 8942
Tips to improve your search results... OpenText™ Dimensions CM Help Center OpenText™ Dimensions CM Help 25.2 All View Local Help Center View Online Help Center Version: