Unlocks an entry in the FLDB
Synopsis
fts unlock -fileset {name | ID} [-cell cellname] [{-noauth | -localauth}] [-verbose] [-help]
Options
-fileset {name | ID}
Specifies the complete name or fileset ID number of the fileset whose entry in the Fileset Location Database (FLDB) is to be unlocked.
-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 unlock command releases the lock on the FLDB entry for the fileset indicated by -fileset. Use the fts unlockfldb command to
unlock multiple filesets at one time.
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 on which a version of the
fileset to be unlocked resides.
Cautions
Do not issue this command under normal circumstances. It is useful only if the FLDB entry for a fileset is locked but there is no reason to suspect
inconsistency within the fileset or between it 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 the FLDB entry for the fileset named user.terry:
$ fts unlock user.terry
Related Information
Commands: fts lock(8dfs)