Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

nsdb-nces(8)

Name

nsdb-list, nsdb-nces, nsdb-resolve-fsn - FedFS observability utilities

Synopsis

nsdb-nces [-l nsdb] [-r port]
nsdb-list [-l nsdb] [-r port] [-e nce]
nsdb-resolve-fsn [-l nsdb] [-r port] fsn

Description

The tools described here permit observability into FedFS data stored in FedFS NSDBs (LDAP servers which store FedFS information).

nsdb-nces will list the naming contexts on the LDAP server that contains FedFS data, and the relative distinguished name of the FedFS container.

The nsdb-list command will list all FedFS data stored in the LDAP server, showing FedFS fileset names (FSNs) and all fileset locations (FSLs) for each.

nsdb-resolve-fsn will show the FSLs that correspond to the passed FSN.

Examples

The following options are supported:

–l nsdb

Specify the LDAP server implementing the NSDB.

–r port

Specify the port on which the LDAP server implementing the NSDB is listening.

–e nce

Specify the distinguished name of the container of FedFS information on the LDAP server implementing the NSDB; this will often be a single unambiguous location and need not be specified.

Examples

Example 1 Using the NSDB Tools

The following sequence of commands illustrates the use of all of the NSDB tools.

# nsdb-nces
Host: nsdb.cthon.org:389
  namingContext 'dc=cthon,dc=org' is a FedFS NCE, DIT starts at ''

# nsdb-list
NSDB: nsdb.cthon.org:389, dc=cthon,dc=org
  FSN UUID: 7cc0bf04-5459-11e1-8083-80093d11d889
    FSL UUID: 7cc33c02-5459-11e1-8084-00093d11d889 = filer-a:/tmp
  FSN UUID: db48f160-5858-11e1-b459-80093d11d889
    FSL UUID: db4998c2-5858-11e1-b45a-00093d11d889 = filer-j:/tmp

# nsdb-resolve-fsn 7cc0bf04-5459-11e1-8083-80093d11d889
For FSN UUID 7cc0bf04-5459-11e1-8083-80093d11d889
  FSL UUID: 7cc33c02-5459-11e1-8084-00093d11d889
    Location: filer-a:/tmp

Exit Status

0

Successful completion.

>0

An error occurred.

Attributes

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
service/file-system/nfs
Interface Stability
Committed

See Also

attributes(7), fedfs(7), nfsref(8), nsdbparams(8)