Creates a backup version of a read/write DCE LFS fileset
Synopsis
fts clone -fileset {name | ID} [-cell cellname] [{-noauth | -localauth}] [-verbose] [-help]
Options
-fileset {name | ID}
Specifies the complete name or fileset ID number of the read/write source fileset.
-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
This command creates a backup version, or clone, of the indicated read/write DCE LFS fileset. It names the new backup version by adding a .backup extension
to the name of the read/write source fileset. It places the backup version at the same site (File Server machine and aggregate) as the read/write version. The fts clone command
cannot backup non-LFS filesets.
If no backup version exists, the command changes the status flag for the backup version in the fileset's entry in the Fileset Location Database (FLDB) to valid. It also increments the number of fileset entries recorded as residing on the File Server machine in the FLDB entry for the server.
If a backup version already exists, the new clone replaces it. The status flag for the backup version remains valid, and the number of fileset entries recorded in the File Server machine's FLDB entry remains unchanged.
Privilege Required
The issuer must be listed in the admin.ft file on the machine on which the read/write copy of the fileset is stored. The issuer must also 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 resides.
Examples
The following command creates a backup version of the fileset user.smith:
$ fts clone user.smith
Related Information
Commands: fts clonesys(8dfs)