Skip to main content

vserver nfs storepool show

Contributors
Suggest changes

Display storepool information for currently connected NFSv4 clients

Availability: This command is available to cluster administrators at the advanced privilege level.

Description

The vserver nfs storepool show command shows the number of storepool resources consumed. A storepool is a pool of resoures used by NFSv4 clients. The command output depends on the parameter or parameters specified with the command. If no parameters are specified, the command displays the following storepool information about all the connected clients:

  • Node on which the storepool resource is located

  • Vserver name

  • Data ip address

  • Client ip address

  • Protocol (nfs4, nfs4.1, or nfs4.2)

  • Session trunking status (true or false)

  • Owner count

  • Open state count

  • Delegation state count

  • Lock state count

  • Bad State Count

  • Stale State Count

To display detailed information about a single instance, run the command with the -instance parameter. The detailed view provides all of the information in the previous list and the following additional information:

  • Layout state count

  • Copy state count

  • Client identifier

Parameters

{ [-fields <fieldname>,…​]

This specifies the fields that need to be displayed. The fields Vserver, node, data-lif-ip, client-ip and protocol are the default fields (see example).

| [-instance ] }

If this parameter is specified, the command displays information about all entries.

[-node {<nodename>|local}] - Node Name (privilege: advanced)

If this parameter is specified, the command displays information only about clients with the specified node.

[-vserver <vserver>] - Vserver (privilege: advanced)

If this parameter is specified, the command displays information only about clients with the specified Vserver.

[-data-lif-ip <IP Address>] - Data LIF IP Address (privilege: advanced)

If this parameter is specified, the command displays information only about clients with the specified data LIF.

[-client-ip <IP Address>] - Client IP Address (privilege: advanced)

If this parameter is specified, the command displays information only about clients with the specified client IP.

[-protocol <Nfs4 Storepool Client Access Protocol>] - Protocol Version (privilege: advanced)

If this parameter is specified, the command displays information only about clients with the specified protocol.

[-trunking-status {true|false}] - Trunking Status (privilege: advanced)

If this parameter is specified, the command displays information only about clients with the specified trunking status.

[-owner-count <integer>] - Allocated Owner Count (privilege: advanced)

If this parameter is specified, the command displays information only about clients with a matching number of owner counts.

[-open-state-count <integer>] - Allocated OpenState Count (privilege: advanced)

If this parameter is specified, the command displays information only about clients with a matching number of open state counts.

[-deleg-state-count <integer>] - Allocated DelegState Count (privilege: advanced)

If this parameter is specified, the command displays information only about clients with a matching number of delegation state counts.

[-lock-state-count <integer>] - Allocated LockState Count (privilege: advanced)

If this parameter is specified, the command displays information only about clients with a matching number of lock state counts.

[-layout-state-count <integer>] - Allocated LayoutState Count (privilege: advanced)

If this parameter is specified, the command displays information only about clients with a matching number of layout state counts.

[-copy-state-count <integer>] - Allocated CopyState Count (privilege: advanced)

If this parameter is specified, the command displays information only about clients with a matching number of copy state counts.

[-client-id <integer>] - Unique Client Identifier (privilege: advanced)

If this parameter is specified, the command displays information only about clients with the specified client id.

[-exhausted-object {owner|open|lock|delegation}] - Exhausted Object List (privilege: advanced)

If this parameter is specified, the command displays information only about clients with the specified exhausted object.

[-is-exhausted {true|false}] - Is Storepool Exhausted? (privilege: advanced)

If this parameter is specified, the command displays information only about clients with the specified exhausted status.

[-bad-seqid-state-count <integer>] - Bad Sequential ID State Count (privilege: advanced)

If this parameter is specified, the command displays information only about clients with a matching number of bad sequential ID state counts.

[-stale-stateid-count <integer>] - Stale State ID Count (privilege: advanced)

If this parameter is specified, the command displays information only about clients with a matching number of stale state ID counts.

Examples

The following example displays the storepool information of NFSv4 clients.

cluster1::*> vserver nfs storepool show
     Node: node1
  Vserver: vs1
  Data-Ip: 10.0.1.1
Client-Ip       Protocol  IsTrunked OwnerCount OpenCount  DelegCount LockCount
--------------  --------- --------- ---------- ---------- ---------- ---------
10.0.2.1        nfs4.1    true      2          1          0          4
10.0.2.2        nfs4.2    true      2          1          0          4
2 entries were displayed.

cluster1::*> vserver nfs storepool show -instance
                    Node Name: node1
                      Vserver: vs1
          Data LIF IP Address: 10.0.1.1
            Client IP Address: 10.0.2.1
             Protocol Version: nfs4.1
              Trunking Status: true
        Allocated Owner Count: 2
    Allocated OpenState Count: 1
   Allocated DelegState Count: 0
    Allocated LockState Count: 4
  Allocated LayoutState Count: 0
    Allocated CopyState Count: 0
     Unique Client Identifier: 16962161483653840897
        Exhausted Object List: -
     Is Storepool Exhausted? : false
Bad Sequential ID State Count: 0
   Stale State ID Count: 0
Node Name: node1
                      Vserver: vs1
          Data LIF IP Address: 10.0.1.1
            Client IP Address: 10.0.2.2
             Protocol Version: nfs4.2
              Trunking Status: true
        Allocated Owner Count: 2
    Allocated OpenState Count: 1
   Allocated DelegState Count: 0
    Allocated LockState Count: 4
  Allocated LayoutState Count: 0
    Allocated CopyState Count: 0
     Unique Client Identifier: 16962161483653840897
        Exhausted Object List: -
     Is Storepool Exhausted? : false
Bad Sequential ID State Count: 0
         Stale State ID Count: 0

2 entries were displayed.