ONTAP 9.12.1 commands

50←PDF
  • ONTAP 9.12.1 commands(CA08871-263en.pdf)
  • vserver export-policy netgroup queue show

    Show the Netgroup Processing Queue

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

    Description

    The vserver export-policy netgroup queue show command displays the ongoing processing of the netgroup cache for a node. Entries shown here are not used to evaluate client membership in a netgroup. The following information is displayed per queue entry:

    • Vserver name: The name of the Vserver.

    • Netgroup name: The name of the netgroup.

    • Age of entry in the queue: How long the entry has been in the queue.

    • Queue state: The state of the entry in the queue. There are three possible values:

    • running: The entry is currently being processed.

    • waiting: The entry is waiting to be processed.

    • retrying: The entry is waiting to be reprocessed.

       Note that as the `vserver export-policy netgroup queue show` command is not atomic. Several queue entries might show up in the 'running' state.
      * Number of times retried in the queue: The number of times was the entry was taken off of the netgroup processing queue and added back on it.
      * Total number of hosts in the netgroup: The number of host names retrieved from the name service in mapping the netgroup to a list of hosts.

    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 you specify this parameter, the command displays the netgroup cache information only if the Vserver name matches the specified value.

    [-netgroup <text>] - Name of the Netgroup

    If you specify this parameter, the command displays the netgroup cache information only if the netgroup name matches the specified value.

    [-queue-state {waiting|running|retrying}] - State of Entry in the Queue

    If you specify this parameter, the command displays the netgroup cache information only if the netgroup queue state matches the specified value.

    [-age <[[<hours>:]<minutes>:]<seconds>>] - Age of Entry in the Queue

    If you specify this parameter, the command displays the netgroup cache information only if the age of when the netgroup record was put on the netgroup processing queue matches the specified value.

    [-retries-on-queue <integer>] - Number of Retries on the Queue

    If you specify this parameter, the command displays the netgroup cache information only if, during a refresh, the number of times the netgroup record has been put back on the netgroup processing queue matches the specified value.

    [-total-hosts <integer>] - Total Number of Hosts in the Netgroup

    If you specify this parameter, the command displays the netgroup cache information only if the netgroup record’s count of hosts matches the specified value.

    Examples

    The following example displays the netgroup queue:

    cluster1::> vserver export-policy netgroup queue show
                                           Age on     Total
        Vserver    Netgroup   State         Queue     Hosts
        ---------- ---------- --------- --------- ---------
        testvs1    test-netgr retrying     0:0:47     12441
        testvs1    test       waiting     0:01:35         -
    Top of Page