Snapdiffchangelogdir

The snapdiffchangelogdir option defines the location where the client stores persistent change logs that are used for snapshot differential backup operations.

Important: If you previously used snapshot differential backups with a backup-archive client that is older than Version 8.1.2, the first snapshot differential backup that you run with the V8.1.2 or later client will be a full progressive incremental backup. To avoid this full progressive incremental backup, move the existing change log files from the old location specified by the stagingdirectory option to the new location specified by the snapdiffchangelogdir option before you run the first snapshot differential backup.

For example, run the following copy command: Linux operating systems

cp -R /tmp/TSM/TsmSnapDiff /opt/tivoli/tsm/client/ba/TsmSnapDiff

xcopy C:\Users\Bob\AppData\Local\Temp\TSM\TsmSnapDiff 
"C:\Program Files\Tivoli\TSM\baclient\TsmSnapDiff" /s /y

The change log files have the following naming patterns: Linux operating systems

.../TSM/TsmSnapDiff/.TsmSnapdiffChangeLogs/NetAppFiler/
SnapdiffChangeLog__VolumeName__.tsmDB
.../TSM/TsmSnapDiff/.TsmSnapdiffChangeLogs/NetAppFiler/
SnapdiffChangeLog__VolumeName__.tsmDB.Lock

...\TSM\TsmSnapDiff\.TsmSnapdiffChangeLogs\NetAppFiler\
SnapdiffChangeLog__VolumeName__.tsmDB
...\TSM\TsmSnapDiff\.TsmSnapdiffChangeLogs\NetAppFiler\
SnapdiffChangeLog__VolumeName__.tsmDB.Lock

where:

NetAppFiler is the host name or IP address of the storage virtual machine (SVM) from the cluster management server or the 7-mode file server.
VolumeName is the volume that you want to protect.

Supported Clients

Linux operating systems This option is valid for Linux x86_64 clients. This option can also be defined on the server.

Windows operating systems This option is valid for all Windows clients. This option can also be defined on the server.

Options File

Linux operating systems Place this option in the client options file (dsm.opt). When snapdiffchangelogdir is specified on the command line, it overrides the values that are specified in the options file. You can set this option on the General tab of the Preferences editor.

Windows operating systems Place this option in the client options file (dsm.opt). When snapdiffchangelogdir is specified on the command line, it overrides the values that are specified in the options file. You can set this option on the General tab of the Preferences editor.

Syntax

Parameters

path

Specifies the directory path where the client stores persistent change logs for snapshot differential backup operations. If you do not specify the snapdiffchangelogdir option, the client uses the directory where the client is installed. The default installation directory is: Linux operating systems

/opt/tivoli/tsm/client/ba

C:\Program Files\Tivoli\TSM\baclient

The exact name of the change log file is in the following format: Linux operating systems

snapdiff_change_log_dir/TsmSnapDiff/.TsmSnapdiffChangeLogs/NetAppFiler/
SnapdiffChangeLog__VolumeName__.tsmDB

snapdiff_change_log_dir\TsmSnapDiff\.TsmSnapdiffChangeLogs\NetAppFiler\
SnapdiffChangeLog__VolumeName__.tsmDB

where:

snapdiff_change_log_dir is the name of the directory for storing the snapshot differential change logs, as specified by the snapdiffchangelogdir option.
NetAppFiler is the host name or IP address of the storage virtual machine (SVM) from the cluster management server or the 7-mode file server.
VolumeName is the volume that you want to protect.

A lock file is also created to prevent the change log file from being updated by different snapshot differential backups that are running at the same time.

In Uniform Naming Convention (UNC) format, the path must contain a drive letter. In the following UNC format example, the path contains the drive letter:

\\computer7\C$\tsmdata

Examples

Options file:: snapdiffchangelogdir /tmp/tsmdata; snapdiffchangelogdir c:\tsmdata
Command line:: -snapdiffchangelogd=/tmp/tsmdata; -snapdiffchangelogd="c:\tsmdata"