Skip to main content

vserver services ndmp restartable-backup show

Contributors
Suggest changes
PDFs

Display NDMP restartable backup contexts

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description

The vserver services ndmp restartable-backup show command lists the NDMP restartbale backup contexts present in the cluster. By default it lists the following details about the context:

  • Vserver Name

  • Context Identifier

  • Is Cleanup Pending?

A combination of parameters can be optionally supplied so as to list only those contexts which match specific conditions. A short description of each of the parameter is provided in the parameters section.

Parameters

{ [-fields <fieldname>,…​]

If you specify the -fields <fieldname>, …​ parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.

| [-instance ] }

If you specify the -instance parameter, the command displays detailed information about all fields.

[-vserver <Vserver Name>] - Vserver

If this parameter is specified, the command displays NDMP restartable backup contexts that match the specified Vserver.

[-context-id <UUID>] - Context Identifier

If this parameter is specified, the command displays NDMP restartable backup contexts where the value for -context-id matches the specified input value.

This parameter specifies the UUID of NDMP restartable backup contexts.

[-volume <volume name>] - Volume Name

If this parameter is specified, the command displays NDMP restartable backup contexts where the value for volume matches the specified input value.

This parameter specifies the volume path information

[-is-cleanup-pending {true|false}] - Is Cleanup Pending?

If this parameter is specified, the command displays NDMP restartable backup contexts where the value for -is-cleanup-pending matches the specified input value.

This parameter indicates whether the context is being deleted.

[-engine-type <text>] - Backup Engine Type

If this parameter is specified, the command displays NDMP restartable backup contexts where the value for engine-type matches the specified input value.

This parameter specifies the backup engine type.

[-auto-snapshot {true|false}] - Is Snapshot Copy Auto-created?

If this parameter is specified, the command displays NDMP restartable backup contexts where the value for auto-snapshot matches the specified input value.

This parameter indicates if the Snapshot copy was created by DUMP engine.

[-no-acls {true|false}] - Is NO_ACLS Set? (privilege: advanced)

If this parameter is specified, the command displays NDMP restartable backup contexts where the value for no-acls matches the specified input value.

This parameter specifies if NO_ACLS environment variable is set.

[-dump-path <text>] - Dump Path

If this parameter is specified, the command displays NDMP restartable backup contexts where the value for dumppath matches the specified input value.

This parameter represents the correspoding local volume path which is being backed up.

[-backup-level <integer>] - Incremental Backup Level ID

If this parameter is specified, the command displays NDMP restartable backup contexts where the value for backup-level matches the specified input value.

This parameter specifies the backup level.

[-dump-date <integer>] - Dump Date (privilege: advanced)

If this parameter is specified, the command displays NDMP restartable backup contexts where the value for dumpdate matches the specified input value.

This parameter specifies the dumpdate value in epoch.

[-base-date <integer>] - Base Date (privilege: advanced)

If this parameter is specified, the command displays NDMP restartable backup contexts where the value for basedate matches the specified input value.

This parameter specifies the basedate value in epoch.

[-update-dump-dates {true|false}] - Dump Dates Require Update? (privilege: advanced)

If this parameter is specified, the command displays NDMP restartable backup contexts where the value for update-dumpdates matches the specified input value.

This parameter indicates if dumpdates needs to be updated.

[-dump-name <text>] - Dump Name

If this parameter is specified, the command displays NDMP restartable backup contexts where the value for dumpname matches the specified input value.

This parameter indicates the name for the dump instance.

[-all-non-qtree {true|false}] - Is NON_QUOTA_QTREE Set? (privilege: advanced)

If this parameter is specified, the command displays NDMP restartable backup contexts where the value for all-non-qtree matches the specified input value.

This parameter indicates if NON_QUOTA_TREE environment variable is set.

[-print-options <integer>] - Backup Log Level (privilege: advanced)

If this parameter is specified, the command displays NDMP restartable backup contexts where the value for print-options matches the specified input value.

This parameter specifies the logging level during dump.

[-last-update <integer>] - Context Last Updated Time

If this parameter is specified, the command displays NDMP restartable backup contexts where the value for last-update matches the specified input value.

This parameter specifies the last time(in epoch) when the context was modified.

[-has-offset-map {true|false}] - Has Offset Map?

If this parameter is specified, the command displays NDMP restartable backup contexts where the value for has-offset-map matches the specified input value.

This parameter indicates if offset map is present in the backup image.

[-offset-verify {true|false}] - Offset Verify

If this parameter is specified, the command displays NDMP restartable backup contexts where the value for offset-verify matches the specified input value.

This parameter indicates if offset map is successfully verified during backup.

[-ndmp-env-keys <text>,…​] - NDMP Environment Keys (privilege: advanced)

If this parameter is specified, the command displays NDMP restartable backup contexts where the value for ndmpenvkeys matches the specified input value.

This parameter represents the list of NDMP environment variables set during backup.

[-ndmp-env-values <text>,…​] - NDMP Environment Values (privilege: advanced)

If this parameter is specified, the command displays NDMP restartable backup contexts where the value for ndmpenvvalues matches the specified input value.

This parameter represents the values set for the NDMP environment variables.

[-ndmp-env-count <integer>] - Count of NDMP Environment Variables (privilege: advanced)

If this parameter is specified, the command displays NDMP restartable backup contexts where the value for ndmpenvcount matches the specified input value.

This parameter represents the number of NDMP enviroment variables set during backup.

[-is-restartable {true|false}] - Is Context Restartable?

If this parameter is specified, the command displays NDMP restartable backup contexts where the value for is-restartable matches the specified input value.

This parameter indicates if the NDMP restartable backup context is restartable.

[-is-busy {true|false}] - Is Context Busy?

If this parameter is specified, the command displays NDMP restartable backup contexts where the value for is-busy matches the specified input value.

This parameter indicates if the NDMP restartable backup context is busy.

[-multi-subtree {true|false}] - Is MULTI_SUBTREE_NAMES Set? (privilege: advanced)

If this parameter is specified, the command displays NDMP restartable backup contexts where the value for multi-subtree matches the specified input value.

This parameter indicates if the NDMP environment variable MULTI_SUBTREE_NAMES is set.

[-logical-find {true|false}] - Is LOGICAL_FIND Set? (privilege: advanced)

If this parameter is specified, the command displays NDMP restartable backup contexts where the value for logical-find matches the specified input value.

This parameter indicates if the NDMP environment variable LOGICAL_FIND is set.

[-exclude-list <text>] - Is EXCLUDE Set? (privilege: advanced)

If this parameter is specified, the command displays NDMP restartable backup contexts where the value for exclude-list matches the specified input value.

This parameter represents the value of the the NDMP environment variable EXCLUDE.

[-restart-pass <integer>] - Restart Pass

If this parameter is specified, the command displays NDMP restartable backup contexts where the value for restart-pass matches the specified input value.

This parameter specifies the dump phase from which to restart.

[-backup-results <integer>] - Status of Backup

If this parameter is specified, the command displays NDMP restartable backup contexts where the value for backup-results matches the specified input value.

This parameter specifies the status of the backup.

[-snap-name <text>] - Snapshot Copy Name

If this parameter is specified, the command displays NDMP restartable backup contexts where the value for snap-name matches the specified input value.

This parameter specifies the name of the Snapshot copy.

[-is-dp-vol {true|false}] - Is DP Volume? (privilege: advanced)

If this parameter is specified, the command displays NDMP restartable backup contexts where the value for is-dp-vol matches the specified input value.

This parameter indicates if the volume specified in the NDMP restartable context is of type DP.

[-context-status <integer>] - State of the Context

If this parameter is specified, the command displays NDMP restartable backup contexts where the value for context-status matches the specified input value.

This parameter specifies the state of the NDMP restartable context.

[-is-fg-vol {true|false}] - Is FlexGroup Volume?

If this parameter is specified, the command displays NDMP restartable backup contexts where the value for is-fg-vol matches the specified input value.

This parameter indicates if the volume specified in the NDMP restartable context is a FlexGroup volume or not.

[-is-64bit-atime-backup {true|false}] - Is 64bit Atime Backup? (privilege: advanced)

If this parameter is specified, the command displays NDMP restartable backup contexts where the value for is-64bit-atime-backup matches the specified input value.

This parameter indicates if the backup specified in the NDMP restartable context is a 64bit atime backup or not.

Examples

The following example displays all the NDMP restartable contexts on the cluster:

cluster1::> vserver services ndmp restartable-backup show
Vserver     Context Identifier                   Is Cleanup Pending?
----------- ------------------------------------ ---------------
vserver1    53a6760e-d245-11e5-a33b-005056bb2685 false
vserver2    68902360-d245-11e5-a33b-005056bb2685 true
vserver2    d7b74e0d-d24c-11e5-a33b-005056bb2685 false
3 entries were displayed.

The following example shows how to display only the contexts belonging to Vserver vserver2:

cluster1::> vserver services ndmp restartable-backup show -vserver vserver2
Vserver     Context Identifier                   Is Cleanup Pending?
----------- ------------------------------------ ---------------
vserver2    68902360-d245-11e5-a33b-005056bb2685 true
vserver2    d7b74e0d-d24c-11e5-a33b-005056bb2685 false
2 entries were displayed.