Edits a server entry in the FLDB
Synopsis
fts edserverentry -server machine
[{-rmaddr | -addaddr address | -changeaddr address}] [-principal
name]
[-quota entries] [{-owner group | -noowner}] [-cell cellname] [{-noauth |
-localauth}]
[-verbose] [-help]
Options
-server machine
Specifies the server machine whose entry in the Fileset Location Database (FLDB) is to be edited. Specify the File Server machine using the machine's
DCE pathname, the machine's host name, or the machine's IP address. If the -rmaddr, -addaddr, or -changeaddr option is used with the command, specify the network address.
-rmaddr
Removes the address specified with -server from the server entry identified by -server in the FLDB. If the name of the machine rather than one of its
addresses is specified with -server, the command can choose one of the machine's addresses at random to be removed from the FLDB. Because this can have unpredictable results, always specify
an address with -server when using the -rmaddr option. In addition, the command fails if the address to be removed is the only address present for the machine in the FLDB.
If this option is specified, do not specify the -addaddr or -changeaddr option.
-addaddr address
Adds the additional address specified with this option to the server entry specified by -server in the FLDB. A machine can have from one to
four addresses associated with it in the FLDB. The command fails if you attempt to add a fifth address for the machine to the FLDB.
If the name of the machine rather than one of its addresses is specified with -server, the command can choose one of the machine's addresses in the FLDB at random to have the address added to it. Because this can have unpredictable results, always specify an address with -server when using the -addaddr option.
If this option is specified, do not specify the -rmaddr or -changeaddr option.
-changeaddr address
Substitutes the address specified with this option for the address specified by -server in the FLDB. If the name of the machine rather
than one of its addresses is specified with -server, the command can choose one of the machine's addresses at random to be replaced with the address specified with this option. Because this
can produce unpredictable results, always specify an address with -server when using the -changeaddr option.
If this option is specified, do not specify the -rmaddr or -addaddr option.
-principal name
Changes the abbreviation for the DFS server principal that is registered for the machine in the FLDB (for example, hosts/hostname).
The machine's principal name in the Registry Database must match this name. If this option is omitted, the abbreviated DFS server principal currently associated with the server entry remains
unchanged.
-quota entries
Changes the limit on the number of fileset entries (read-write, read-only, and backup) in the FLDB that can be associated with the specified
-server. A value of 0 (zero) allows an unlimited number of fileset entries to be associated with the server. If this option is omitted, the number of fileset entries currently allowed for
the specified File Server machine remains unchanged.
-owner group
Changes the group that is the owner of the server entry. In the entry, the specified group replaces the current owning group, if any. 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). Use this option or use the -noowner option; omit both options to
leave the current owning group unchanged.
-noowner
Specifies that no group is to own the server entry. In the entry, the empty group ID, displayed as <nil>, replaces the group that currently owns the server
entry; the entry is unchanged in this regard if no group presently owns the server entry. Use this option or use the -owner option; omit both options to leave the current owning group
unchanged.
-cell cellname
Specifies the cell in whose FLDB the server entry is to be modified. 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 edserverentry command alters a server entry in the FLDB for the server machine specified with the -server option. Use the -rmaddr
option to remove an address associated with a server from the FLDB. Use the -addaddr option to add a new address for a server to the FLDB, or use the -changeaddr option to change
an address for a server in the FLDB.
The -principal option can be used to change the abbreviated DFS server principal associated with the server entry. The -quota option can be used to alter the number of fileset entries that can be associated with the File Server machine in the FLDB, and the -owner option can be used to assign a new group as the owner of the server entry (or the -noowner option can be used to indicate that no group owns the server entry).
Unless a value associated with a server entry is explicitly modified with this command, its current value in the FLDB remains unchanged. The values associated with a server entry are initially specified when the server entry is created with the fts crserverentry command. The values can then be modified at any time with the fts edserverentry command. Use the fts lsserverentry command to display the current values from 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 command modifies the server entry in the FLDB for a server machine. The command changes the machine's network address from 191.54.206.36, as
specified with the -server option, to 191.54.206.46, as indicated with the -changeaddr option. The command also allows the server to accommodate an unlimited number of
fileset entries by providing a value of 0 (zero) with the -quota option.
$ fts edserverentry 191.54.206.36 -changeaddr 191.54.206.46 -quota 0
Related Information
Commands: fts crserverentry(8dfs)