Converts a fileset to a bytestream format and places it in a file
Synopsis
fts dump -fileset {name | ID} {-time {date | 0} | -version number} [-server machine]
[-file filename] [-cell cellname] [{-noauth | -localauth}] [-verbose] [-help]
Options
-fileset {name | ID}
Specifies the complete name or fileset ID number of the fileset to be dumped. The read-write, read-only, or backup version of the fileset
can be dumped. Append the .readonly or .backup extension to the name of the fileset to dump the read-only or backup version instead of the read/write version.
-time {date | 0}
Specifies a full or incremental dump. Three values are legal:
0 (zero)
A 0 (zero) value causes a full dump of the current version of the fileset.
mm/dd/yy
A month/day/year value causes an incremental dump from 12:00 a.m. (00:00) on the indicated date (for example, 1/23/90 or 10/16/92).
Only files with modification time stamps equal to or later than the specified date and time are dumped.
mm/dd/yy hh:mm
An exact date and time value causes an incremental dump from the specified time on the indicated date. Only files with modification
time stamps equal to or later than the specified date and time are dumped. The time must be in 24-hour format (for example, 20:30 for 8:30 p.m.). The date format is the same as for a date
alone. Surround the entire argument with " " (double quotes) because it contains a space (for example, "1/23/90 22:30" or "10/16/92 3:45").
Use this option to perform a full dump or to perform an incremental dump of only those files in the fileset modified since a specific date or date and time. Use this option or use -version.
-version number
Specifies an incremental dump based on the indicated fileset version number. Each DCE LFS fileset has a version number. Each file in the fileset
records the version number that was current when the file was last modified. If this option is specified, only those files with version numbers equal to or greater than the specified version number
are dumped. (A DCE LFS fileset's version number is recorded in its fileset header; it has the same format as a fileset ID number. Use the fts lsheader or fts lsft command to
display a fileset's current version number.)
Use this option or use -time. Use this option only with DCE LFS filesets.
-server machine
Names the File Server machine that houses the version of the fileset to be dumped. Specify the File Server machine using the machine's DCE pathname,
the machine's host name, or the machine's IP address.
This option is useful for dumping a particular read-only replica of a DCE LFS fileset for which multiple replicas exist. If you include the .readonly extension with the name of a fileset specified with the -fileset option, or if you specify the ID number of the read-only version of a fileset with the -fileset option, you can use the -server option to indicate the machine that houses the specific replica to be dumped. If you omit the -server option in these cases, the command dumps the replica that resides at the fileset's oldest read-only site (the replica at the site that has been defined for the longest time).
This option is always unnecessary if the read/write or backup version of a fileset is to be dumped.
-file filename
Specifies the complete pathname of the file to which the dump is to be written. If a complete pathname is not specified, the file is written to the
current working directory. If this option is omitted, the data is sent to standard output (stdout).
-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 dump command converts the contents of the indicated fileset to a bytestream format. It puts the converted contents into the file specified with the
-file option. If this option is omitted, the dumped data is sent to stdout. Both non-LFS and read-write, read-only, and backup DCE LFS filesets can be dumped.
The command's options can be used to perform the following types of dumps:
· A value of 0 (zero) specified with the -time option causes a full dump of the fileset.
· A date specified with the -time option causes an incremental dump of all files modified since 12:00 a.m. (00:00) on that date.
· A date and time specified with the -time option cause an incremental dump of all files modified since that date and time.
· A version number specified with -version causes an incremental dump of all files in the fileset with version numbers equal to or greater than the specified version number.
Dumping a fileset does not affect its status in the Fileset Location Database (FLDB) or at the site from which it is dumped. However, it does make the fileset inaccessible for the duration of the dump operation. For this reason, it is customary to dump the backup version of a fileset to prevent the read-write version from being inaccessible for an extended time.
If a read-only replica of a DCE LFS fileset is to be dumped and multiple replicas of the fileset exist, the -server option can be used to name the File Server machine that houses the specific replica to be dumped. Indicating a specific replica can be useful if network or hardware problems caused only some of a fileset's replicas to be updated. It can be especially useful for restoring the read/write version of a fileset that was lost before all of its replicas were updated: You can dump and restore a specific replica that was updated before the read/write version was lost. (By default, all replicas of the same fileset are always identical; to determine whether all replicas of a fileset are the same, use the fts lsft command to display information about specific replicas.)
The fts restore command can be used to restore a fileset dumped with the fts dump command. You can use the fts restore command to restore a dump file to any type of fileset (DCE LFS or non-LFS), regardless of the type of fileset from which it was created. Thus, you can dump and restore data between DCE LFS and non-LFS filesets, as well as between different types of non-LFS filesets. (See the documentation for the fts restore command for more information about dumping and restoring filesets between different types of file systems.)
You cannot restore a fileset dumped in one cell to a site in another cell.
Privilege Required
The issuer must be listed in the admin.ft file on the machine on which the fileset is stored. In addition, the issuer must have the write, execute,
and insert permissions on the directory in which the dump file is to reside.
Examples
The following command executes a full dump of the fileset user.terry into the file named /tmp/terry.dump:
$ fts dump user.terry -time 0 /tmp/terry.dump
The following command executes an incremental dump of the fileset user.smith into the file named /tmp/smith.013191.dump. Only those files in the fileset with modification time stamps equal to or later than 6:00 p.m. on 31 January 1991 are included in the dump.
$ fts dump user.smith -time "1/31/91 18:00" /tmp/smith.013191.dump
Related Information
Commands: fts lsft(8dfs)