Creates backup versions of all indicated read/write DCE LFS filesets
Synopsis
fts clonesys [-prefix string] [-server machine] [-aggregate name] [-cell cellname]
[{-noauth | -localauth}] [-verbose] [-help]
Options
-prefix string
Specifies a character string of any length. Every fileset with a name matching this string is cloned. Include field separators (such as periods) if
appropriate. This option can be combined with -server, -aggregate, or both. Omit all three options to back up all filesets in the local cell.
-server machine
Specifies the File Server machine where the read/write source filesets are stored. Specify the File Server machine using the machine's DCE path name,
the machine's host name, or the machine's IP address. This option can be combined with -prefix, -aggregate, or both. Omit all three options to back up all filesets in the local
cell.
-aggregate name
Specifies the device name, aggregate name, or aggregate ID of the aggregate on -server where the read/write source filesets are stored. These
identifiers are specified in the first, second, and fourth fields of the entry for the aggregate in the dcelocal/var/dfs/dfstab file. This option can be combined with
-server, -prefix, or both. Omit all three options to back up all filesets in the local cell. The -server option must be specified if this option is 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 clonesys command creates a backup version, or clone, of each indicated read/write DCE LFS fileset. It names each backup version by adding a
.backup extension to the name of its read/write source fileset. It places each backup version at the same site (File Server machine and aggregate) as its read/write version. The
fts clonesys command cannot backup non-LFS filesets.
If no backup version of a fileset 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 of a fileset 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.
The fts clonesys command returns a 0 if all DCE LFS filesets were successfully backed up, regardless of whether back ups of any non-LFS filesets were attempted. The command returns a 1 if one or more DCE LFS filesets could not be backed up or if only backups of non-LFS filesets were attempted.
By combining the -prefix, -server, and -aggregate options, you can create backup copies of different subsets of read/write filesets. To back up
· All filesets in the local cell, specify no options
· All filesets in the local cell with a name beginning with the same character string (for example, sys. or user.), specify the string with the -prefix option
· All filesets on a File Server machine, specify the machine's name with the -server option
· Filesets on a specific aggregate on a File Server machine, specify both the -server and -aggregate options
· Filesets with a certain prefix on a specific File Server machine, specify both the -prefix and -server options
· Filesets with a certain prefix on a specific aggregate on a File Server machine, specify the -prefix, -server, and -aggregate options
Use the fts clone command to back up a single read/write DCE LFS fileset.
Privilege Required
The issuer must be listed in the admin.ft files on all machines on which read/write versions of the filesets are 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 any fileset to be backed up resides.
Output
If the fts clonesys command fails to back up either one or more DCE LFS filesets or one or more non-LFS filesets, the command displays the following output:
Total FLDB entries that were successfully backed up:
x (y failed; z wrong aggr type)
The variable x indicates the number of DCE LFS filesets that were successfully backed up. The variable y indicates the number of DCE LFS filesets that could not be backed up. The variable z indicates the number of non-LFS filesets that the command attempted to back up, but could not because of the command's inability to back up non-LFS filesets.
Examples
The following example creates a backup version of each fileset in the local cell whose name begins with the prefix user.:
$ fts clonesys -prefix user.
Related Information
Commands: fts clone(8dfs)
Files: dfstab(4dfs)