Removes a specified entry from the FLDB
Synopsis
fts delfldbentry {-fileset {name | ID} | -prefix string} [-server machine]
[-aggregate name]
[-cell cellname] [{-noauth | -localauth}] [-verbose] [-help]
Options
-fileset {name | ID}
Specifies the complete name or fileset ID number of a fileset. The entire entry for the fileset is removed from the Fileset Location
Database (FLDB), regardless of whether the read-write, read-only, or backup version of the fileset is specified. Provide this option or use the -prefix option.
-prefix string
Specifies a character string of any length. Every FLDB entry that lists a fileset whose name begins with this exact string is removed (unless
more-restrictive constraints are specified with the -server and optionally -aggregate options). Include field separators such as periods if appropriate. Provide this option
(optionally with -server and -aggregate) or use the -fileset option.
-server machine
Names a File Server machine. If a fileset's name matches the specified -prefix and it is listed as residing on the specified File Server
machine, its entry is removed from the FLDB. Specify the File Server machine using the machine's DCE path name, the machine's host name, or the machine's IP address. If this option is used,
-prefix must be used; -aggregate can also be used. -aggregate can also be used.
-aggregate name
Specifies the device name, aggregate name, or aggregate ID of an aggregate or partition on -server. 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. If a fileset's name matches the specified -prefix and it
resides on the specified aggregate on -server, its entry is removed from the FLDB. If this option is used, -prefix and -server must be used.
-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 delfldbentry command removes the entries for all indicated filesets from the FLDB. Regardless of the version of a fileset (read-write, read-only,
or backup) specified with the command, the fileset's entire entry is removed. The command has no effect on actual filesets on File Server machines, only on their FLDB entries.
The command also decrements the number of fileset entries recorded in server entries, as appropriate. For each version of a fileset whose entry is removed from the FLDB, the number of fileset entries recorded in the server entry for the File Server machine it resides on is reduced by one.
By using the -fileset option alone or combining the -prefix, -server, and -aggregate options in increasingly specific ways, FLDB entries can be removed for varying numbers of filesets. To remove the FLDB entry for
· A single fileset, specify -fileset
· Every fileset whose name begins with a certain character string (for example, sys. or user.), regardless of site, specify -prefix
· Every fileset whose name begins with a certain character string and that is stored on a specific File Server machine, specify -prefix and -server
· Every fileset whose name begins with a certain character string and that is stored on a specific aggregate of a specific File Server machine, specify -prefix, -server, and -aggregate
This command can be used if the issuer is certain that a fileset removal is not recorded in the FLDB and does not want to take the time to synchronize an entire File Server machine. It can also be used to remove the FLDB entry for a non-LFS fileset to be removed from the global namespace. (Use the fts rmsite command to remove an incorrect entry for a read-only site from the FLDB.)
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 whose FLDB entry is to be removed.
Cautions
Do not use this command as the standard way to remove a fileset entry from the FLDB. It can make the FLDB inconsistent with the filesets on server machines. Use the
fts delete command to remove the fileset entry from the FLDB at the same time that the fileset is deleted. Also, because it can be used to remove multiple FLDB entries simultaneously, use
this command carefully.
Examples
The following command removes the FLDB entry for the fileset user.temp:
$ fts delfldbentry user.temp
The following command removes all FLDB entries for filesets whose names begin with test and that are stored on the File Server machine named fs3:
$ fts delfldbentry -prefix test -server /.../abc.com/hosts/fs3
Related Information
Commands: fts clone(8dfs)
Files: dfstab(4dfs)