Skip to main content

vserver services name-service unix-user file status

Contributors
Suggest changes
PDFs

Display local Unix Users file status

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

Description

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

The command displays the following information:

  • Vserver name

  • Node name

  • Load time for the UNIX user file

  • Hash value of the UNIX user file

  • Hash value of the UNIX user database file

  • File size of the UNIX user 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 UNIX user status only for the specified Vserver.

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

If you specify this parameter, the command displays the UNIX user 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 user 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 user 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 <text>] - Hash Value DB (privilege: advanced)

If you specify this parameter, the command displays the status only for the UNIX user files that have the specified hash value for the UNIX user 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 user 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 user 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 user file status for all Vservers:

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