Creates a server entry in the FLDB
Synopsis
fts crserverentry -server machine -principal name [-quota entries]
[-owner group] [-cell
cellname] [{-noauth | -localauth}] [-verbose] [-help]
Options
-server machine
Specifies the server machine for which an entry is to be created in the Fileset Location Database (FLDB). Specify the File Server machine using the
machine's DCE path name, the machine's host name, or the machine's IP address.
-principal name
Specifies the abbreviation for the DFS server principal to be registered in the FLDB for the machine (for example, hosts/hostname).
The machine's principal name in the Registry Database must match this name.
-quota entries
Sets a limit on the number of fileset entries (read-write, read-only, and backup) in the FLDB that can be associated with the specified -server.
If this option is omitted, a value of 0 (zero) is used, meaning an unlimited number of fileset entries can be associated with the specified File Server machine.
-owner group
-owner group specifies the name of the group that is the owner of the server entry. A group can be specified by a full or abbreviated
group name (for example, /.../cellname/group_name or just group_name). Foreign groups cannot own a local server entry. If this option is omitted, no
group owns the server entry (the value <nil> is reported as the owner).
-cell cellname
Specifies the cell in whose FLDB the server entry is to be created. 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 crserverentry command creates a server entry in the FLDB for the server machine specified with -server. You must issue this command for a
server machine before issuing any other fts commands involving that machine (for example, before creating filesets on the machine with the fts create command, before adding the
machine as a replication site with the fts addsite command, before moving filesets to the machine with the fts move command, and so on).
The -quota option is used to limit the number of filesets (read-write, read-only, and backup) that can reside on the specified File Server machine. When a fileset entry in the FLDB is defined to reference the File Server machine as the site of a fileset version, the FL Server increments the number of fileset entries recorded as residing on the server in its server entry. The FL Server creates no more than the specified -quota of fileset entries on the server machine.
The following commands update the number of fileset entries recorded for a File Server machine in its server entry: The fts create, fts crfldbentry, fts addsite, fts restore, fts clone, and fts clonesys commands increment the number of fileset entries recorded for the server; the fts delete, fts delfldbentry, and fts rmsite commands decrement the number of fileset entries recorded; the fts move command decrements and increments the number of fileset entries recorded on the source and destination machines, respectively; and the fts syncfldb and fts syncserv commands can update the number of fileset entries recorded, as necessary.
The -owner option is used to specify a group of administrators who can administer entries in the FLDB for all of the filesets on the specified File Server machine. The same group can be given ownership of all server entries for the File Server machines in the domain where the specified machine resides. Members of the group can then manipulate the FLDB entries for all of the filesets in the domain where the File Server machine resides. This way, the administrators in the group need not be included on the admin.fl list for the entire cell, which would allow them to modify all of the fileset entries in the FLDB in that cell.
Use the fts lsserverentry command to display the current values from the FLDB for a server entry. Use the fts edserverentry command to change the current values in the FLDB for a server entry. Use the fts delserverentry command to remove a server entry from the FLDB.
Privilege Required
The issuer must be listed in the admin.fl files on all Fileset Database machines.
Examples
The following example adds a server entry to the FLDB for a server machine named fs1. The abbreviated DFS server principal of the machine is specified with
the -principal option as hosts/fs1. Because they are omitted, the -quota and -owner options receive the default values of 0 (zero) and the empty group ID
(displayed as <nil>), respectively.
$ fts crserverentry /.../abc.com/hosts/fs1 hosts/fs1
Related Information
Commands: fts delserverentry(8dfs)