Removes a DCE LFS fileset from its site without updating the FLDB
Synopsis
fts zap -ftid ID -server machine -aggregate name [-cell cellname] [{-noauth | -localauth}]
[-verbose] [-help]
Options
-ftid ID
Specifies the fileset ID number of the fileset to remove; a fileset name is not a valid argument.
-server machine
Names the File Server machine from which to remove the fileset. Specify the File Server machine using the machine's DCE pathname, the machine's host
name, or the machine's IP address.
-aggregate name
Specifies the device name, aggregate name, or aggregate ID of the aggregate on -server from which to remove the fileset. These identifiers are
specified in the first, second, and fourth fields of the entry for the aggregate in the dcelocal/var/dfs/dfstab file.
-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 zap command removes the DCE LFS fileset with the fileset ID number specified by -ftid from the site defined by -server and
-aggregate. It neither changes the corresponding Fileset Location Database (FLDB) entry for the fileset nor decrements the number of fileset entries recorded in the server entry in the FLDB
for the specified File Server machine.
This command is useful in situations in which it is important to delete a fileset but, for some reason, the FLDB is unreachable (for example, the FL Server is unavailable). The issuer can remove information about the deleted fileset from the FLDB by running the fts syncserv and fts syncfldb commands. The issuer can also reconcile the FLDB with the fts rmsite command (which removes site information about a read-only version from a fileset's FLDB entry), the fts delete command (which removes site information about the read-write or backup version from a fileset's FLDB entry), or the fts delfldbentry command (which removes the entire entry for a fileset from the FLDB). (The fts zap command can also be used to remove normally temporary "clone" filesets that can sometimes be left after an interrupted fts move operation.)
If the DCE LFS fileset to be removed is also mounted locally (as a file system on its File Server machine), you must remove its local mount point before you delete it. The fts zap command cannot be used to delete a fileset that is mounted locally.
Privilege Required
The issuer must be listed in the admin.ft file on the machine specified by -server.
Cautions
Do not use this command as the standard way to remove a fileset. It can make the FLDB inconsistent with the filesets on File Server machines. Use the fts
delete command to remove the fileset entry from the FLDB at the same time that the fileset is removed.
Examples
The following command removes the fileset with fileset ID 0,,36870988 from /dev/lv01 on fs6, without recording the change in the FLDB:
$ fts zap 0,,36870988 /.../abc.com/hosts/fs6 /dev/lv01
Related Information
Commands: fts delete(8dfs)
Files: dfstab(4dfs)