Enablededupcache

Use the enablededupcache option to specify whether you want to use a cache during client-side data deduplication. Using a local cache can reduce network traffic between the Tivoli® Storage Manager server and the client.

When you perform a backup or archive operation with the data deduplication cache enabled, the specification of data extents that are backed up or archived are saved to the cache database. The next time you run a backup or archive, the client queries the data deduplication cache and identifies the extents of data that have been previously saved to the server. Data extents that are identical to data extents on the server are not resent to the server.

If the server and the cache are not synchronized, the cache is removed and a new one is created.

Only one process can access the distributed data deduplication cache at a time. Concurrent backup instances on a workstation, that use the same server and storage pool, must either use unique node names or unique cache specifications. In this way, all the instances can use a local cache and optimize the client-side data deduplication.

Supported Clients

This option is valid for all clients. The Tivoli Storage Manager client API also supports this option.

Options File

AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsPlace this option in the system-options file (dsm.sys) within a server stanza. You can set this option on the Deduplication > Enable Deduplication Cache check box of the Preferences editor. The option can be set in the client option set on the Tivoli Storage Manager server.

Windows operating systemsPlace this option in the client options file (dsm.opt). You can set this option on the Deduplication > Enable Deduplication Cache check box of the Preferences editor. The option can be set in the client option set on Tivoli Storage Manager server.

Syntax

Read syntax diagramSkip visual syntax diagram
                     .-Yes*-.   
>>-ENABLEDEDUPCache--+------+----------------------------------><
                     '-No---'   

Parameters

Yes
Specifies that you want to enable data deduplication cache. If data deduplication is not enabled, this setting is not valid. Yes is the default for the Tivoli Storage Manager client. No is the default for the Tivoli Storage Manager API.
No
Specifies that you do not want to enable data deduplication cache.

Examples

Options file:
enablededupcache no
Command line:
-enablededupcache=no

This option is valid only on the initial command line. It is not valid in interactive mode.