Dell EMC Avamar for Windows Servers 19.7 User Guide

PDF

Windows File System plug-in backup options

Plug-in options enable you to control backup functionality that is specific to the Avamar Plug-in for the Windows File System. You can specify plug-in options for on-demand and scheduled backups.

The following table lists options that are available for the Windows File System plug-in when you perform an on-demand backup or when you configure a dataset for scheduled backups.

Table 1. Windows File System plug-in backup options
Option	Description
Back up Natively Attached Virtual Hard Disks	Backs up natively attached virtual hard disks.
Perform a Windows Optimized Backup of a Windows Deduplicated volume	Specifies whether to back up files in either optimized or unoptimized state on Windows deduplicated volumes on Windows Server 2019, 2016, or 2012. If you back up files in an optimized state, then you can restore the files in either an optimized or unoptimized state. You can only restore files from a Windows deduplicated volume to the original location or to another Windows Server 2019, 2016, or 2012 computer with Windows deduplicated volumes.
Store backup on Data Domain system	To store the backup on a Data Domain system instead of the Avamar server, select the checkbox and then select the Data Domain system from the list. NOTE To enable this option, add a Data Domain system to the Avamar configuration. The Avamar and Data Domain System Integration Guide provides instructions.
Encryption method to Data Domain system	Specifies the encryption method for data transfer between the client and the Data Domain system during the backup.
Backup label	Assigns this descriptive label to the backup.
Logging Options
List backup contents	Specifies how much information about the backup contents to include in the log files. Select one of the following values: No file listing List file names List files and dates
Informational message level	Specifies how many informational messages to include in the log files. Select one of the following values: No informationals — Suppress all informational messages but include errors and warnings. Some informationals — Include some informational messages. Many informationals — Include additional status information. All informationals — Include all informational messages, errors, and warnings.
Report advanced statistics	Includes advanced timing and deduplication statistics in the log files.
Enable debugging messages	Writes maximum information to the log files. The backup process generates very large log files.
File System Traversal
Do not traverse any mounts	Prevents traversal of mount points during the backup.
Traverse fixed-disk mounts	The backup traverses only fixed-disk file system mount points.
Traverse fixed-disk and remote network mounts	The backup traverses both fixed-disk and NFS network mount points.
File System Traversal Overrides
Force traversal of specified file system type(s)	Specifies the file system types to traverse during the backup. Use a comma-separated list to specify multiple file system types, for example, nfs, ext2, jfs, xfs.
Force non-traversal of specified file system type(s)	Specifies the file system types that the backup does not traverse. Use a comma-separated list to specify multiple file system types, for example, nfs, ext2, jfs, xfs.
Pre-Script
Run user-defined script at beginning of backup	Runs a script at the beginning of the backup. The script must be located in the C:\Program Files\avs\etc\scripts folder and must have a .bat, .js, or .vbs file name extension.
Abort backup if script fails	Stops the backup if the script returns a non-zero status code.
Script After Freeze
Run user-defined script after volumes have been frozen	Runs a script after volumes have been frozen. The script must be located in the C:\Program Files\avs\etc\scripts folder and must have a .bat, .js, or .vbs file name extension.
Abort backup if script fails	Stops the backup if the script returns a non-zero status code.
Post-script
Run user-defined script at end of backup	Runs a script at the end of the backup. The script must be located in the C:\Program Files\avs\etc\scripts folder and must have a .bat, .js, or .vbs file name extension.
Exit process with script failure exitcode	If selected, avtar exits with the exit code of the script instead of a standard avtar exit code.
Volume Freezing Options
Method to freeze volumes	Uses one of the following values: Best Microsoft VSS OTM None
OTM freezewait: File activity quiescent time	OTM only: Number of seconds that volumes must be quiescent to establish a freeze.
OTM freezetimeout: Maximum time to wait when trying to freeze volume(s)	OTM only: Maximum number of seconds to wait for volumes to freeze.
OTM freezecachesize: Size in MBs of OTM transaction cache	OTM only: Size of the disk transaction cache. A negative value is a fraction of used disk space. For example, -50 is 1/50th or 2% of used disk space.
OTM freezecachedir: Folder to use for the OTM transaction cache	OTM only: Pathname of the folder for the OTM transaction cache. The default pathname is C:\Program Files\avs\var.
Freeze exclude devices	Comma-separated list of devices to exclude from volume freezing, for example, \Device\mydevice\*.
Freeze exclude volumes	Comma-separated list of volume names to exclude from freezing, for example, C:.
Client Cache Options
Check client-side caches and report inconsistencies	Performs a validation check of the client-side cache with the Avamar server instead of a backup.
Check and repair client-side caches	Performs a validation check and repairs inconsistences with the client-side cache instead of performing a backup.
Maximum client file cache size (MBs)	Specifies the maximum client file cache size in MB. A negative value indicates a fraction of RAM. For example, -8 specifies that no more than 1/8th of the physical RAM will be allocated to the client file cache.
Maximum client hash cache size (MBs)	Specifies the maximum client hash cache size in MB. A negative value indicates a fraction of RAM. For example, -8 specifies that no more than 1/8th of the physical RAM will be allocated to the client hash cache.
Advanced Options
Client-side flag file	Specifies the pathname of an option file on the client that contains additional option settings.
Network rate throttle (Mbps)	Reduces network usage to a rate in megabits/second, for example, 0 = unrestricted, 50% of a T1 = 0.772.
Directly connect to all server nodes	Establishes multiple connections to the server, which can improve backup performance in certain circumstances.
Use Last Access Time to detect ACL-only changes	Forces a rescan of any files in which the Access Time changed since the previous backup.
Run as user name	Specifies the username for running the plug-in on the client you are backing up.
Quota limit per backup
Hard limit size (MBs)	Specify the hard limit size of a backup. If the size of the backup source exceeds the hard limit, the backup fails.
Soft limit size (MBs)	Specify the soft limit size of a backup. If the size of the backup source exceeds the soft limit, the backup succeeds with a warning. If you specify both the soft and hard limit size, ensure that the soft limit size is smaller than the hard limit size.