Synchronizes fileset headers to match their FLDB entries
Synopsis
fts syncserv -server machine [-aggregate name] [-cell cellname] [{-noauth | -localauth}]
[-verbose] [-help]
Options
-server machine
Names the File Server machine for which to check entries in the Fileset Location Database (FLDB). Specify the File Server machine using the machine's
DCE pathname, 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 or partition on -server for which to check FLDB entries. These
identifiers are specified in the first, second, and fourth fields of the entry for the aggregate or partition in the dcelocal/var/dfs/dfstab file. Do not use this option under
normal circumstances; omitting it allows synchronization of all filesets on -server. Use it only when just a single aggregate needs to be synchronized.
-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 syncserv command inspects the FLDB entry of each fileset on a specified File Server machine (or, optionally, a specified aggregate or partition on
that File Server machine). The command then checks that each fileset header is consistent with its FLDB entry. If the command finds an inconsistency between the fileset name found in the fileset
header and the name found in the FLDB entry, the fileset header is renamed to reflect the name in the FLDB entry. If the command encounters a fileset marked as Off-line, but the fileset's
FLDB entry lists it as being valid, the command places the fileset online.
The fts syncserv command checks either all of the filesets on the File Server machine specified with the -server option or only the filesets on the optionally specified partition or aggregate specified with the -aggregate option. The command also checks the reported sites of all copies of an inspected fileset (even though that requires checking filesets on server machines other than -server).
It is recommended that the fts syncfldb command be run on all File Server machines in a cell before the fts syncserv command is run on the File Server machines in the cell. However, nothing prohibits the commands from being executed in the reverse order or independently of each other.
Note that the fts syncserv and fts syncfldb commands cannot restore replication information lost when the entry for a DCE LFS fileset is removed from the FLDB. Replication information must be reconstructed with the fts setrepinfo and fts addsite commands.
Because non-LFS filesets do not have fileset headers, the fts syncserv and fts syncfldb commands have limited effectiveness on non-LFS filesets. For example, because the fts syncserv command cannot destroy a disk partition, it cannot delete a non-LFS fileset, even if it determines that the fileset needs to be deleted. Instead, the fts program displays a warning message reporting the non-LFS fileset that needs to be deleted to restore file system consistency. The proper commands then need to be used to delete the fileset.
Privilege Required
The issuer must be listed in the admin.ft file on each machine that houses a version of any fileset stored at the specified site (-server
and optionally -aggregate). The issuer must also 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
any fileset stored at the specified site.
Examples
The following command synchronizes the FLDB entries of filesets whose site definitions mention fs3, including any copies of the filesets not located on
fs3:
$ fts syncserv /.../abc.com/hosts/fs3
Related Information
Commands: fts addsite(8dfs)
Files: dfstab(4dfs)