NDMP Properties and Logs
The NDMP service configuration consists of the following properties and logs.
Table 3-27 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 mountpoint, 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 |
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:
|
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 |
The NDMP service events log is available in system-ndmpd:default
.