Go to main content
Oracle® ZFS Storage Appliance Administration Guide, Release OS8.6.x

Exit Print View

Updated: September 2016
 
 

NDMP Properties and Logs

The NDMP service configuration consists of the following properties and logs:

Table 65  NDMP Properties
Property
Description
Version
The version of NDMP that your DMA supports.
TCP port (v4 only)
The NDMP default connection port is 10000. NDMPv3 always uses this port. NDMPv4 allows a different port if needed.
Ignore metadata-only changes
Directs the system to backup only files in which content has changed, ignoring files for which only metadata, such as permissions or ownership, has changed. This option only applies to incremental "tar" and "dump" backups and is disabled by default.
Target restore pool(s)
When you perform a full restore using "tar" or "dump", the system re-creates datasets if there is no share mounted at the target. Because the NDMP protocol specifies only the mount point, the system chooses a pool in which to recreate projects and shares. On a system with multiple pools, this property lets you specify one or more pools. Multiple pools only need to be specified in a cluster with active pools on each head. You must ensure that this list is kept in sync with any storage configuration changes. If none of the pools exist or are online, the system will select a default pool at random.
Allow token-based backup
Enables or disables token-based method for ZFS backup. This property is off by default.
ZFS rollback before restore (v4 only)
Only applies to backups with type "zfs". Determines whether when restoring an incremental backup the system rolls back the target project and share to the snapshot used as the base for the incremental restore. If the project and shares are rolled back, then any changes made since that snapshot will be lost. This setting is normally controlled by the DMA via the "ZFS_FORCE" environment variable, but this property can be used to override the DMA setting to always rollback these data sets or never roll them back. For details, see NDMP Incremental Backups. Not rolling them back will cause the restore to fail unless they have already been manually rolled back. This property is intended for use with DMAs that do not allow administrators to configure custom environment variables like ZFS_FORCE.
Allow direct access recovery
Enables the system to locate files by position rather than by sequential search during restore operations. Enabling this option reduces the time it takes to recover a small number of files from many tapes. You must specify this option at backup time in order to be able to recover individual files later.
Restore absolute paths (v3 only)
Specifies that when a file is restored, the complete absolute path to that file is also restored (instead of just the file itself). This option is disabled by default.
Share creation on restore
Configures the restore operation to create a new share based on the backup type:
  • All - Allows all backup types to create a new share on restore

  • Tar_Dump - Allows backup types "tar" and "dump" to create a new share on restore

  • ZFS - Allows backup type "zfs" to create a new share on restore

  • None - No backup type can create a new share on restore

DMA tape mode (for locally attached drives)
Specifies whether the DMA expects System V or BSD semantics. The default is System V, which is recommended for most DMAs. This option is only applicable for locally attached tape drives exported via NDMP. Consult your DMA documentation for which mode your DMA expects. Changing this option only changes which devices are exported when the DMA scans for devices, so you will need to reconfigure the tape devices in your DMA after changing this setting.
DMA username and password
Used to authenticate the DMA. The system uses MD5 for user authentication
Table 66  NDMP Logs
Log
Description
system-ndmpd:default
NDMP service log