Memoryefficientbackup

The memoryefficientbackup option specifies the memory-conserving algorithm to use for processing full file space backups.

One method backs up one directory at a time, using less memory. The other method uses much less memory, but requires more disk space.

Use the memoryefficientbackup option with the incremental command when your workstation is memory constrained. You can also use this option as a parameter to the include.fs option in order to select the algorithm Tivoli® Storage Manager uses on a per-filespace basis.

Windows operating systemsUse memoryefficientbackup=diskcachemethod for any file space that has too many files for Tivoli Storage Manager to complete the incremental backup with either the default setting, memoryefficientbackup=no, or with memoryefficientbackup=yes. The disk cache file created by the initial disk cache incremental backup can require up to 5 GB of disk space for each million files or directories being backed up.

AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsUse memoryefficientbackup=diskcachemethod for any file space that has too many files for Tivoli Storage Manager to complete the incremental backup with either the default setting, memoryefficientbackup=no, or with memoryefficientbackup=yes.

Mac OS X operating systemsAIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsThe actual amount of disk space required for the disk cache file created by disk cache incremental backups depends on the number of files and directories included in the backup and on the average path length of the files and directories to be backed up. For UNIX and Linux estimate 1 byte per character in the path name. For Mac OS X, estimate 4 bytes per character in the path name. For example, if there are 1 000 000 files and directories to be backed up and the average path length is 200 characters, then the database occupies approximately 200 MB for UNIX and Linux, and 800 MB for Mac OS X clients. Another way to estimate for planning purposes is to multiply the number of files and directories by the length of the longest path to establish a maximum database size.

Windows operating systemsThe actual amount of disk space required for the disk cache file created by disk cache incremental backups depends on the number of files and directories included in the backup and on the average path length of the files and directories to be backed up. Estimate 2 bytes per character in the path name. For example, if there are 1 000 000 files and directories to be backed up and the average path length is 200 characters, then the database occupies approximately 400 MB. Another way to estimate for planning purposes is to multiply the number of files and directories by the length of the longest path to establish a maximum database size.

AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsA second disk cache file is created for the list of migrated files when backing up an HSM managed file system. The combined disk cache files, created by disk cache incremental backups and HSM managed file system backups, can require above 400 MB of disk space for each million files being backed up. The disk cache file can become very large. Large file support must be enabled on the file system that is being used for the disk cache file.

Supported Clients

This option is valid for all clients. The server can also define this option.

Options File

AIX operating systemsHP-UX operating systemsLinux operating systemsOracle Solaris operating systemsMac OS X operating systemsThis option is allowed in dsm.opt and within a server stanza in dsm.sys, but the value in dsm.opt is ignored if it also appears in dsm.sys. You can also place this option on the initial command line. In interactive mode, this option can be used with the incremental command. You can also set this option on the Performance Tuning tab in the Preferences editor, and selecting the Use memory-saving algorithm check box.

Windows operating systemsPlace this option in the client user-options file (dsm.opt), or on the initial command line. You can also set this option on the Performance Tuning tab in the Preferences editor, and selecting the Use memory-saving algorithm check box.

Syntax

Read syntax diagramSkip visual syntax diagram
                          .-No--------------.   
>>-MEMORYEFficientbackup--+-----------------+------------------><
                          +-Yes-------------+   
                          '-DISKCACHEMethod-'   

Parameters

No
Your client node uses the faster, more memory-intensive method when processing incremental backups. This is the default.
Yes
Your client node uses the method that requires less memory when processing incremental backups.
Diskcachemethod
Your client node uses the method that requires much less memory but more disk space when processing incremental backups for full file systems.

Examples

Options file:

memoryefficientbackup yes
memoryefficientbackup diskcachem

Command line:
-memoryef=no