Moves a read/write DCE LFS fileset to another site
Synopsis
fts move -fileset {name | ID} -fromserver source_machine
-fromaggregate source_name -toserver
dest_machine -toaggregate dest_name
[-cell cellname] [{-noauth | -localauth}] [-verbose] [-help]
Options
-fileset {name | ID}
Specifies the complete name or the fileset ID number of the read/write fileset to be moved.
-fromserver source_machine
Names the File Server machine on which the fileset currently resides. Specify the File Server machine by its DCE pathname, its host name, or
its IP address.
-fromaggregate source_name
Specifies the device name, aggregate name, or aggregate ID of the aggregate on which the fileset currently resides. These identifiers are
specified in the first, second, and fourth fields of the entry for the aggregate in the dcelocal/var/dfs/dfstab file.
-toserver dest_machine
Names the File Server machine to which the fileset is to be moved. Specify the File Server machine by its DCE pathname, its host name, or its IP
address.
-toaggregate dest_name
Specifies the device name, aggregate name, or aggregate ID of the aggregate to which the fileset is to be moved. These identifiers are specified
in the first, second, and fourth fields of the entry for the aggregate in the 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 move command moves the indicated read/write DCE LFS fileset from its current site (specified with the -fromserver and
-fromaggregate options) to the destination site (specified with the -toserver and -toaggregate options). The command decrements the number of fileset entries recorded as
residing on the machine indicated with the -fromserver option in the Fileset Location Database (FLDB) entry for the machine, and it increments the number of fileset entries recorded as
residing on the machine specified with the -toserver option in the FLDB entry for that machine. It also automatically removes the backup version of the fileset, if it exists, from the
current site. To create a new backup version at the destination site, use the fts clone command.
It is not possible to move a read-only or backup fileset. For read-only filesets, the corresponding action is to create a new replication site with the fts addsite command and remove an existing one with the fts rmsite command. Because the backup version of a read/write fileset is automatically deleted when its read/write source is moved, a backup fileset can be moved only by moving its read/write source fileset and issuing the fts clone command to create a new backup version.
Furthermore, it is not possible to move a fileset from a site in one cell to a site in another cell. Filesets can be moved only between two sites in the same cell. The filesets are assumed to reside in the local cell of the issuer unless the name of a foreign cell is specified with the -cell option.
A DCE LFS fileset that is mounted locally (as a file system on its File Server machine) cannot be moved to a different File Server machine. It can be moved only to a different aggregate on the same File Server machine. If the command is used to move a DCE LFS fileset that is locally mounted, its -fromserver and -toserver options must name the same File Server machine; otherwise, the command fails. (To move a locally mounted fileset to a different machine, remove its local mount point before issuing this command.)
In addition, because the backup version of a fileset is removed when its read/write version is moved, you cannot move a fileset (not even to another aggregate on the same File Server machine) if its backup version is mounted locally. You must remove the backup version's local mount point before moving the fileset.
Privilege Required
The issuer must be listed in the admin.ft files on both the source and destination machines. The issuer must also be listed in the admin.fl
files on all Fileset Database machines or own the server entries for the source machine, the destination machine, and any machines on which replicas of the fileset reside. In addition, the source
machine (-fromserver) must be listed in the admin.ft file on the destination machine (-toserver).
Examples
The following command moves the fileset user.smith from /dev/lv01 on fs3 to /dev/lv02 on fs7:
$ fts move user.smith /.../abc.com/hosts/fs3 /dev/lv01 /.../abc.com/hosts/fs7 /dev/lv02
Related Information
Commands: fts addsite(8dfs)
Files: dfstab(4dfs)