Skip to main content

vserver services name-service unix-group file status

Contributors
Suggest changes

Display local Unix Groups file status

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

Description

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

The command displays the following information:

  • Vserver name

  • Node name

  • Load time for the UNIX group file

  • Hash value of the UNIX group file

  • Hash value of the UNIX group database file

  • Hash value of the UNIX group byuser database file

  • File size of the UNIX group 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 ] }

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 UNIX group status only for the specified Vserver.

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

If you specify this parameter, the command displays the UNIX group 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 UNIX group file 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 files are different on different nodes, because each node downloads the definitions from the source URI individually.

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

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

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

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

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

If you specify this parameter, the command displays the status only for the UNIX group files that have the specified hash value for the UNIX group byuser database. Note that the primary purpose of the command is to verify that the files on all nodes have the same hash value for UNIX group 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 UNIX group files that have the specified file size. Note that the primary purpose of the command is to verify that the files 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 UNIX group file status for all Vservers:

cluster1::*> vserver services name-service unix-group file status -instance
Vserver: vs1
                Node: node1
           Load Time: 8/9/2016 19:56:25
          Hash Value: 835c7f530fb76f96c3bca00e380d36b7
       Hash Value DB: e6cb38ec1396a280c0d2b77e3a84eda2
Hash Value byuser DB: 913a182a72aa1872495be398ebb2cd23
           File Size: 58B
Vserver: vs2
                Node: node1
           Load Time: 8/9/2016 20:15:40
          Hash Value: c0d2b77e3a84eda2e6cb38ec1396a280
       Hash Value DB: 009321eddb45611e95d9f7f277ec0621
Hash Value byuser DB: 659321eddb45611e95d9f7f277ec0621
           File Size: 2.3MB
2 entries were displayed.