ONTAP 9.12.1 commands

50←PDF
  • ONTAP 9.12.1 commands(CA08871-263en.pdf)
  • volume file fingerprint dump

    Display fingerprint of a file

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

    Description

    The volume file fingerprint dump command displays the following information given the -session-id of the fingerprint operation:

    • Vserver:

    The Vserver on which the file exists.
    * Session-ID:

    A unique identifier for the fingerprint operation. This session-id is returned when the fingerprint operation is started on a file. The session-id of the fingerprint operation can be used to get the progress of an ongoing fingerprint operation as well as the complete fingerprint output for the file once the operation is completed.
    * Volume:

    The name of the volume on which the file resides.
    * Path:

    The absolute path of the file on which the fingerprint is calculated. The value begins with /vol/<volumename>.
    * Data Fingerprint:

    The digest value of data of the file. The fingerprint is base64 encoded. This field is not included if the scope is metadata-only .
    * Metadata Fingerprint:

    The digest value of metadata of the file. The metadata fingerprint is calculated for file size, file ctime, file mtime, file crtime, file retention time, file uid, file gid, and file type. The fingerprint is base64 encoded. This field is not included if the scope is data-only .
    * Fingerprint Algorithm:

    The digest algorithm which is used for the fingerprint computation. Fingerprint is computed using md5 or sha-256 digest algorithm.
    * Fingerprint Scope:

    The scope of the file which is used for the fingerprint computation. Fingerprint is computed over data-only , metadata-only , or data-and-metadata .
    * Fingerprint Start Time:

    The start time of the fingerprint computation in seconds since 1 January 1970 00:00:00 in GMT timezone.
    * Formatted Fingerprint Start Time:

    The start time of the fingerprint computation in a human-readable format <day> <month> <day of month> <hour>:<min>:<sec><year> in GMT timezone.
    * Fingerprint Version:

    The version of the fingerprint output format.
    * SnapLock License:

    The status of the SnapLock license.
    * Vserver UUID:

    A universal unique identifier for the Vserver on which the file exists.
    * Volume MSID:

    The mirror set identifier of the volume where the file resides.
    * Volume DSID:

    The data set identifier of the volume where the file resides.
    * Hostname:

    The name of the storage system where the fingerprint operation is performed.
    * Filer ID:

    The NVRAM identifier of the storage system.
    * Volume Containing Aggregate:

    The name of the aggregate in which the volume resides.
    * Aggregate ID:

    A universal unique identifier for the aggregate containing the volume.
    * SnapLock System ComplianceClock:

    The System ComplianceClock time in seconds since 1 January 1970 00:00:00 in GMT timezone if it is initialized.
    * Formatted SnapLock System ComplianceClock:

    The System ComplianceClock time in a human-readable format <day> <month> <day of month> <hour>:<min>:<sec><year> in GMT timezone if it is initialized.
    * Volume SnapLock Type:

    The type of the SnapLock volume. This value is only given for SnapLock volumes. Possible values are compliance and enterprise .
    * Volume ComplianceClock:

    The volume ComplianceClock time in seconds since 1 January 1970 00:00:00 in GMT timezone. This has a value only for SnapLock volumes.
    * Formatted Volume ComplianceClock:

    The volume ComplianceClock time in a human-readable format <day> <month> <day of month> <hour>:<min>:<sec><year> in GMT timezone. This has a value only for SnapLock volumes.
    * Volume Expiry Date:

    The expiry date of the SnapLock volume in seconds since 1 January 1970 00:00:00 in GMT timezone. The volume expiry date can be in wraparound format.
    * Is Volume Expiry Date Wraparound:

    The value is true if the volume expiry date is in wraparound format. The wraparound format indicates that dates after 19 January 2038 are mapped from 1 January 1970 through 31 December 2002 to 19 January 2038 through 19 January 2071.
    * Formatted Volume Expiry Date:

    The expiry date of the SnapLock volume in a human-readable format <day> <month> <day of month> <hour>:<min>:<sec><year> in GMT timezone. The volume expiry date can be in wraparound format.
    * Filesystem ID:

    The filesystem identifier of the volume on which the file resides.
    * File ID:

    A unique number within the filesystem identifying the file.
    * File Type:

    The type of the file. Possible values include: worm , worm_appendable , worm_active_log , worm_log , and regular .
    * File Size:

    The size of the file in bytes.
    * Creation Time:

    The creation time of the file in seconds since 1 January 1970 00:00:00 in GMT timezone.
    * Formatted Creation Time:

    The creation time of the file in a human-readable format <day> <month> <day of month> <hour>:<min>:<sec><year> in GMT timezone.
    * Modification Time:

    The last modification time of the file in seconds since 1 January 1970 00:00:00 in GMT timezone.
    * Formatted Modification Time:

    The last modification time of the file in a human-readable format <day> <month> <day of month> <hour>:<min>:<sec><year> in GMT timezone.
    * Changed Time:

    The last changed time of the file attributes in seconds since 1 January 1970 00:00:00 in GMT timezone. Time is taken from the system clock for regular files and from the volume ComplianceClock for WORM files when they are committed. The changed time can be in wraparound format.
    * Is Changed Time Wraparound:

    The value is true if the last changed time of the file attributes is in wraparound format. The wraparound format indicates that dates after 19 January 2038 are mapped from 1 January 1970 through 31 December 2002 to 19 January 2038 through 19 January 2071.
    * Formatted Changed Time:

    The last changed time of the file attributes in a human-readable format <day> <month> <day of month> <hour>:<min>:<sec><year> in GMT timezone. The changed time can be in wraparound format.
    * Retention Time:

    The retention time of the files committed to WORM on SnapLock volumes in seconds since 1 January 1970 00:00:00 in GMT timezone. The retention time can be in wraparound format.
    * Is Retention Time Wraparound:

    The value is true if the retention time of the file is in wraparound format. The wraparound format indicates that dates after 19 January 2038 are mapped from 1 January 1970 through 31 December 2002 to 19 January 2038 through 19 January 2071.
    * Formatted Retention Time:

    The retention time of the files protected by SnapLock in a human-readable format <day> <month> <day of month> <hour>:<min>:<sec><year> in GMT timezone. The retention time can be in wraparound format.
    * Access Time:

    The last access time of the regular files on SnapLock volumes and files on non-SnapLock volumes attributes in seconds since 1 January 1970 00:00:00 in GMT timezone.
    * Formatted Access Time:

    The last access time of the regular files on SnapLock volumes and files on non-SnapLock volumes attributes in a human-readable format <day> <month> <day of month> <hour>:<min>:<sec><year> in GMT timezone.
    * Owner ID:

    The integer identifier of the owner of the file.
    * Group ID:

    The integer identifier of the group owning the file.
    * Owner SID:

    The security identifier of the owner of the file when it has NTFS security style.
    * Fingerprint End Time:

    The end time of the fingerprint computation in seconds since 1 January 1970 00:00:00 in GMT timezone.
    * Formatted Fingerprint End Time:

    The end time of the fingerprint computation in a human-readable format <day> <month> <day of month> <hour>:<min>:<sec><year> in GMT timezone.
    * Litigation Count:

    The number of litigations on the file.

    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.

    -session-id <integer> - Session ID of Fingerprint Operation

    Specifies the session-id of the fingerprint operation whose output is to be displayed. It is a unique identifier for the fingerprint operation. This session-id is returned when the fingerprint operation is started on a file.

    Examples

    The following example displays the fingerprint information of the fingerprint session identified by session-id 17039367 :

    cluster1::> volume file fingerprint dump -session-id 17039367
    Vserver:vs1
                                    Session-ID:17039367
                                        Volume:nfs_slc
                                          Path:/vol/nfs_slc/worm
                              Data Fingerprint:MOFJVevxNSJm3C/4Bn5oEEYH51CrudOzZYK4r5Cfy1g=
                          Metadata Fingerprint:8iMjqJXiNcqgXT5XuRhLiEwIrJEihDmwS0hrexnjgmc=
                         Fingerprint Algorithm:SHA256
                             Fingerprint Scope:data-and-metadata
                        Fingerprint Start Time:1460612586
              Formatted Fingerprint Start Time:Thu Apr 14 05:43:06 GMT 2016
                           Fingerprint Version:3
                              SnapLock License:available
                                  Vserver UUID:acf7ae64-00d6-11e6-a027-0050569c55ae
                                   Volume MSID:2152884007
                                   Volume DSID:1028
                                      Hostname:cluster1
                                      Filer ID:5f18eda2-00b0-11e6-914e-6fb45e537b8d
                   Volume Containing Aggregate:slc_aggr
                                  Aggregate ID:c84634aa-c757-4b98-8f07-eefe32565f67
               SnapLock System ComplianceClock:1460610635
     Formatted SnapLock System ComplianceClock:Thu Apr 14 05:10:35 GMT 2016
                          Volume SnapLock Type:compliance
                        Volume ComplianceClock:1460610635
              Formatted Volume ComplianceClock:Thu Apr 14 05:10:35 GMT 2016
                            Volume Expiry Date:1465880998
              Is Volume Expiry Date Wraparound:false
                  Formatted Volume Expiry Date:Tue Jun 14 05:09:58 GMT 2016
                                 Filesystem ID:1028
                                       File ID:96
                                     File Type:worm
                                     File Size:1048576
                                 Creation Time:1460612515
                       Formatted Creation Time:Thu Apr 14 05:41:55 GMT 2016
                             Modification Time:1460612515
                   Formatted Modification Time:Thu Apr 14 05:41:55 GMT 2016
                                  Changed Time:1460610598
                    Is Changed Time Wraparound:false
                        Formatted Changed Time:Thu Apr 14 05:09:58 GMT 2016
                                Retention Time:1465880998
                  Is Retention Time Wraparound:false
                      Formatted Retention Time:Tue Jun 14 05:09:58 GMT 2016
                                   Access Time:-
                         Formatted Access Time:-
                                      Owner ID:0
                                      Group ID:0
                                     Owner SID:-
                          Fingerprint End Time:1460612586
                Formatted Fingerprint End Time:Thu Apr 14 05:43:06 GMT 2016
                              Litigation Count:0
    Top of Page