Skip to main content

vserver export-policy netgroup queue show

Contributors
Suggest changes

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         -