QUERY DAMAGED (Query damaged data in a directory-container or cloud-container storage pool)

Use this command to display information about damaged data extents in a directory-container or cloud-container storage pool. Use this command together with the AUDIT CONTAINER command to determine a recovery method for the damaged data.

Privilege class

Any administrator can issue this command.

Syntax


>>-Query DAMaged--pool_name------------------------------------->

   .-Type--=--Status---------------.   
>--+-------------------------------+---------------------------><
   '-Type--=--+-INVentory--------+-'   
              +-Node--| A |------+     
              '-CONTAiner--| A |-'     

A (Additional filter by node name)

|--+------------------------+-----------------------------------|
   '-Nodename--=--node_name-'

Parameters

pool_name (Required)

Specifies the name of the directory-container or cloud storage pool.

Type

Specifies the type of information to display. This parameter is optional. Specify one of the following values:

Status: Specifies that information is displayed about damaged data extents. For cloud storage pools, orphaned extents are also displayed. This is the default.
Node: Specifies that information about the number of damaged files per node is displayed.
INVentory: Specifies that inventory information for each damaged file is displayed.
CONTAiner: Specifies that the containers that contain damaged data extents or cloud orphaned extents are displayed. For directory-container storage pools, storage pool directories are also displayed.

Nodename

Specifies that damaged file information for a single node is displayed.

Example: Display status information about damaged or orphaned data extents

Display information about the status of damaged data extents that are stored in a container.

query damaged pool1 type=status

Storage Pool     Non-Deduplicated  Deduplicated   Cloud Orphaned  
Name             Extent Count      Extent Count   Extent Count    
---------------  -------------     ----------     -------------
POOL1                  58                145

For cloud storage pools, the number of orphaned extents is also displayed.

Storage Pool     Non-Deduplicated  Deduplicated   Cloud Orphaned   
Name             Extent Count      Extent Count   Extent Count  
---------------  -------------     ----------     -------------
POOL1                  65                238           18

Example: Display information about a damaged file for a node type

Display information about damaged files that are stored in a node.

query damaged pool1 type=node

Node Name      Number of        
               Damaged Files     
-------------  -----------------
POOL1                  37

Example: Display information about a damaged file for an inventory type

Display information about damaged files that are stored in an inventory.

query damaged pool2 type=inventory

       Client's Name for File: /data/files/10.out
                    Node Name: NODE1
               Filespace Name: /data/space
                        State: Active
               Insertion time: 01/19/2015 16:01:35
                    Object ID: 2073

Example: Display information about a damaged file for a container type

Display information about damaged files that are stored in a container.

query damaged pool3 type=container

         Directory ID: 1
            Directory: /abc/space/container1
            Container: /abc/space/container1/00/0000000000000022.dcf
                State: Damaged

For cloud storage pools, only the name of the container is displayed.

         Directory ID: 
            Directory: 
            Container: 1000-6a3278bc34f0e4118a850090fa3dcb48
                State:

Field descriptions

Client's Name for File: The name of the file.
Cloud Orphaned Extent Count: The number of orphaned extents in a cloud storage pool. Extents are considered orphaned if they do not have a corresponding database entry.

Container: The name of the container.

Dedup Data Extent Count: The number of damaged extents in the storage pool for deduplicated data.
Directory: The name of the storage pool directory.
Directory ID: The identification number of the storage pool directory.

Filespace Name: The name of file space.

Insertion time: The date and time that the object was stored on the server.

Node Name: The name of the node.
Non-dedup Data Extent Count: The number of damaged extents in the storage pool for data that is not deduplicated, such as metadata and client-encrypted data.

Number of Damaged Files: The number of damaged files per node.

Object ID: The identification number of the object.

State

The state of the data in the inventory or container. The field can contain one of the following values:

Active: The version of the file in the inventory is active. There can be only one active version of the file in the inventory.
Inactive: The version of the file in the inventory is inactive. There can be multiple inactive versions of the file in the inventory.
Valid: There is damaged data in the container. The container is accessible and can be reused.
Damaged: There is damaged data in the container. The container is inaccessible and cannot be reused.

Table 1. Commands related to QUERY DAMAGED
Command	Description
AUDIT CONTAINER	Audit a directory-container storage pool.
QUERY CONTAINER	Displays information about a container.