Removes a replication site and read-only DCE LFS fileset
Synopsis
fts rmsite -fileset {name | ID} -server machine -aggregate name [-cell cellname]
[{-noauth |
-localauth}] [-verbose] [-help]
Options
-fileset {name | ID}
Specifies the complete name or fileset ID number of the read/write fileset for which a replication site and the read-only fileset stored
at that site are to be removed.
-server machine
Specifies the File Server machine to be removed as a replication site. Specify the File Server machine using the machine's DCE path name, 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 to be removed as a replication site. These identifiers are specified in the
first, second, and fourth fields of the entry for the aggregate in the dcelocal/var/dfs/dfstab file. If the aggregate is not currently exported or has been detached, you must
specify the aggregate ID.
-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 rmsite command removes a replication site currently defined for the read/write DCE LFS fileset specified with the -fileset option. The
-server and -aggregate options are used to specify the replication site to be removed. The command performs the following actions:
· It removes the definition of the replication site from the Fileset Location Database (FLDB) entry for the fileset.
· It decrements the number of fileset entries recorded as residing on the File Server machine specified with -server in the FLDB entry for the server.
· If the indicated fileset uses Release Replication and the specified site is on the same File Server machine as the read/write fileset, the command removes the replica (if it exists); see Cautions for more information. For any other replica, the command instructs the Replication Server at the site to remove the replica.
Other replication sites of the read/write fileset are not affected. If the command is used to remove a fileset's last replication site, the status flag for the read-only version in the fileset's FLDB entry is set to invalid. If it is used to remove the last existing version of a fileset, the fileset's entire FLDB entry is removed.
Before you use the fts delete command to remove the read/write (and backup) version of a fileset, use the fts rmsite command to remove the fileset's replication sites. If Release Replication was used for the fileset, use the fts rmsite command to remove the replication site (and replica) stored on the same File Server machine as the read/write fileset as well.
If the aggregate on which the replication site is defined is not currently exported or has been detached with the dfsexport command, you must specify the aggregate ID of the aggregate; otherwise, the fts rmsite command cannot remove the replication site. If the aggregate is not exported or has been detached, the Replication Server on the File Server machine on which the aggregate resides stops trying to maintain the replica at the site once the fts rmsite command is issued, and it removes the replica from the site once the aggregate is again exported.
Replication sites are added with the fts addsite command. The replication type for a read/write fileset is set or changed with the fts setrepinfo command.
Privilege Required
The issuer must be listed in the admin.fl files on all Fileset Database machines or own the server entry for each machine that houses a version of
the fileset for which the replication site and replica are to be removed. The issuer must also be listed in the admin.ft file on the machine specified by -server if the following
are true:
· Release Replication is used for the fileset.
· The replication site on the same File Server machine as the read/write fileset is to be removed (in which case -server names the File Server machine on which the read/write fileset resides).
· A replica actually exists at the specified replication site.
Cautions
If you use Release Replication and you remove the read-only fileset that is on the same File Server machine as the read/write source, all other read-only filesets
become unavailable upon the expiration of the fileset's FailAge parameter. The FailAge parameter is set using the fts setrepinfo command.
Examples
The following command removes the replication site on the aggregate /dev/lv01 of the File Server machine fs5 from the FLDB entry for the fileset named
rs_aix32.bin. A replica of rs_aix32.bin that resides at the site is also removed.
$ fts rmsite rs_aix32.bin /.../abc.com/hosts/fs5 /dev/lv01
Related Information
Commands: fts addsite(8dfs)
Files: dfstab(4dfs)