Listing FLDB Information

The fts lsfldb command is used to display information from entries in the FLDB for both DCE LFS and non-LFS filesets. By combining the command's options in different ways, you can tailor the type of information to be displayed, as follows:

· To display every FLDB entry, do not supply any options.

· To display every FLDB entry that mentions a specific File Server machine as the site of any version of a fileset, specify the machine name with the -server option.

· To display every FLDB entry that mentions a specific aggregate on a specific File Server machine as the site of any version of a fileset, specify both the -server and -aggregate options.

· To display the FLDB entries for filesets with locked entries, use the -locked option alone or with the -server option (and optionally the -aggregate option).

· To display a single FLDB entry, specify the fileset name or ID number with the -fileset option.

To list information about fileset entries in the FLDB, enter the fts lsfldb command with the options described previously:

$ fts lsfldb [-fileset {name | ID}] [-server machine] [-aggregate name] [-locked]

The -locked option lists information only for filesets with locked FLDB entries. Use the -locked option alone or with the -server option (and optionally the -aggregate option), or use the -fileset option to view the FLDB entry for a specific fileset.

Interpreting the Output

The output appears in the following order:

· The fileset's name.

· The fileset IDs of the read/write, read-only, and backup versions of the fileset.

· For each version of a fileset, a status flag of valid or invalid indicates whether it actually exists at some site. For the read-only version, it indicates whether a replication site is defined.

· The minimum and maximum advisory RPC authentication bounds for the fileset. There are two sets of bounds: one governing communications with Cache Managers in the local cell and another governing communications with Cache Managers in foreign cells.

· The number of sites at which a version of the fileset exists.

· An indicator if the FLDB entry is locked. The indicator is omitted if the entry is not locked.

· The replication parameters that are associated with the fileset.

· Information identifying the File Server machines and aggregates (sites) where read/write (RW), read-only (RO), or backup (BK) versions of the fileset reside.

· For a read-only version, the MaxSiteAge defined for that site. For a read/write version, 0:00:00 is displayed because no MaxSiteAge is associated with that version.

· The abbreviated DCE principal name of each File Server machine on which a version of the fileset resides, and the name of the group that owns the server entry for the machine or <nil> if no group owns the server entry.

If the output includes more than one FLDB entry, information about the filesets is displayed in alphabetical order by fileset name. The last line of the output displays the total number of entries that were successfully reported and the total number of entries that were not reported (the number of entries that failed).

Following is an example of the output that this command generates for a single DCE LFS fileset:

$ fts lsfldb user.terry

user.terry

readWriteID 0,,196953 valid

readOnlyID 0,,196594 invalid

backupID 0,,196595 valid

Minimum local protection level: rpc_c_protect_level_none

Maximum local protection level: rpc_c_protect_level_pkt_privacy

Minimum remote protection level: rpc_c_protect_level_none

Maximum remote protection level: rpc_c_protect_level_pkt_privacy

number of sites: 1

Sched repl: maxAge=2:00:00; failAge=1d0:00:00; reclaimWait=18:00:00;

minRepDelay=0:05:00; defaultSiteAge=0:30:00

server flags aggr siteAge principal owner

fs3.abc.com RW,BK lfs1 0:00:00 hosts/fs3 <nil>