Unlocks all specified locked entries in the FLDB
Synopsis
fts unlockfldb [-server machine] [-aggregate name] [-cell cellname]
[{-noauth | -localauth}]
[-verbose] [-help]
Options
-server machine
Names the File Server machine whose filesets are to have their Fileset Location Database (FLDB) entries unlocked. Specify the File Server machine using
the machine's DCE pathname, the machine's host name, or the machine's IP address. Use this option with -aggregate to unlock the entries for the filesets on a specific aggregate on
-server. Omit both this option and -aggregate to unlock all of the entries in the FLDB.
-aggregate name
Specifies the device name, aggregate name, or aggregate ID of an aggregate or partition on -server on which the filesets whose FLDB entries are
to be unlocked reside. These identifiers are specified in the first, second, and fourth fields of the entry for the aggregate or partition in the dcelocal/var/dfs/dfstab file. The
-server option must be specified with this option. Omit both this option and -server to unlock all of the entries in the FLDB.
-cell cellname
Specifies the cell where the command is to be run. The default is the local cell of the issuer of the command.
-noauth
Directs fts to use the unprivileged identity nobody as the identity of the issuer of the command. If you use this option, do not use the
-localauth option.
-localauth
Directs fts to use the DFS server principal name of the machine on which the command is issued as the identity of the issuer. Use this option only if the
command is issued from a DFS server machine (a machine that has a DFS server principal in the local Registry Database). You must be logged into the server machine as root for this option to
work. If you use this option, do not use the -noauth option.
-verbose
Directs fts to provide detailed information about its actions as it executes the command.
-help
Prints the online help for this command. All other valid options specified with this option are ignored.
Description
The fts unlockfldb command releases the locks on the FLDB entries indicated by the combination of options specified. To unlock
· All entries in the FLDB, specify no options
· All entries that mention a File Server machine in a site definition, specify the name of the File Server machine with -server
· All entries that mention a specific site, specify both -server and -aggregate
· A single fileset, use the fts unlock command instead
Privilege Required
The issuer must be listed in the admin.fl files on all Fileset Database machines or own the server entry for each machine that houses a version of
any fileset to be unlocked.
Cautions
Do not issue this command under normal circumstances. It is useful only if FLDB entries for filesets at a certain site are locked, but there is no reason to
suspect inconsistency within the filesets or between the filesets and the FLDB. Note that it is possible to list information from locked FLDB entries, even though they cannot be manipulated in other
ways.
Examples
The following command unlocks all locked entries in the FLDB:
$ fts unlockfldb
Related Information
Commands: fts lock(8dfs)
Files: dfstab(4dfs)