Skip to main content

vserver services name-service netgroup status

Contributors
Suggest changes
PDFs

Display local netgroup definitions status

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

Description

The vserver services name-service netgroup status command displays the status of local netgroup definitions across a cluster. This enables you to verify that netgroup definitions are consistent across all nodes that back a Vserver into which netgroup definitions have been loaded.

The command displays the following information:

  • Vserver name

  • Node name

  • Load time for netgroup definitions

  • Hash value of the netgroup definitions

  • Hash value of the netgroup-by-host database

  • File size of the netgroup definitions 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 ] (privilege: advanced) }

If you specify the -instance parameter, the command displays detailed information about all fields.

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

If you specify this parameter, the command displays the netgroup status only for the specified Vserver.

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

If you specify this parameter, the command displays the netgroup status only for the specified node.

[-timestamp <MM/DD/YYYY HH:MM:SS>] - Load Time (privilege: advanced)

If you specify this parameter, the command displays the status only for the netgroup definitions that were loaded at the specified time. Specify time in the format MM/DD/YYYY HH:MM:SS. Note that the load time stamps for identical definitions are different on different nodes, because each node downloads the definitions from the URI individually.

[-hashvalue <text>] - Hash Value (privilege: advanced)

If you specify this parameter, command displays the status only for the netgroup definitions that have the specified hash value. Note that the primary purpose of the command is to verify that the definitions on all nodes have the same hash value, so querying on a specific hash value is not useful in most cases.

[-hashvalue-byhost <text>] - Hash Value Byhost (privilege: advanced)

If you specify this parameter, the command displays the status only for the netgroup definitions that have the specified hash value for netgroup-by-host database. Note that the primary purpose of the command is to verify that the definitions on all nodes have the same hash value for netgroup-by-host database.

[-filesize {<integer>[KB|MB|GB|TB|PB]}] - File Size (privilege: advanced)

If you specify this parameter, the command displays the status only for the netgroup definitions that have the specified file size. Note that the primary purpose of the command is to verify that the definitions on all nodes have the same file size, so querying on a specific file size is not useful in most cases.

Examples

The following example displays the netgroup definition status for all Vservers:

cluster1::*> vserver services name-service netgroup status
Vserver   Node     Load Time           Hash Value                       Hash Value By-Host               File Size
--------- -------  ------------------- -------------------------------- -------------------------------- ----------
vs1
          node1    9/20/2008 16:04:55  e6cb38ec1396a280c0d2b77e3a84eda2 913a182a72aa1872495be398ebb2cd23 1.00KB
          node2    9/20/2008 16:04:53  e6cb38ec1396a280c0d2b77e3a84eda2 913a182a72aa1872495be398ebb2cd23 1.00KB
vs2
          node1    9/20/2008 16:06:26  c0d2b77e3a84eda2e6cb38ec1396a280 009321eddb45611e95d9f7f277ec0621 2.3MB
          node2    9/20/2008 16:06:27  c0d2b77e3a84eda2e6cb38ec1396a280 009321eddb45611e95d9f7f277ec0621 2.3MB
4 entries were displayed.