Before it can house an exported aggregate or partition, a File Server machine must also have a server entry in the FLDB. The fts crserverentry command is used to register a File Server machine's server entry in the FLDB. The server entry stores information about the machine, such as its network addresses (a server entry can store up to four network addresses), its abbreviated DFS server principal name, the number of fileset entries in the FLDB that can be associated with it, and the group of administrators that "owns" (possesses special administrative privileges for) the server entry.
The -principal option of the fts crserverentry command is used to specify the abbreviated DFS server principal to be registered with a machine's server entry. The abbreviated DFS server principal is of the form hosts/hostname. For example, the DFS server principal /.../abc.com/hosts/fs1/dfs-server would be abbreviated to hosts/fs1 for use with the machine's server entry in the FLDB.
The -quota option of the fts crserverentry command is used to limit the number of filesets (read/write, read-only, and backup) that can reside on a File Server machine. The entry for each fileset in the FLDB defines the File Server machine on which each version of the fileset resides. Each server entry records the total number of filesets that are listed in fileset entries as residing on the File Server machine. No more than the number of filesets that are specified with the -quota option can be recorded in the FLDB as residing on the machine at any given time.
The -owner option of the command is used to specify the group that owns the server entry. Members of this group can administer the FLDB entries for all filesets on the File Server machine. 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. The same group can be given ownership of the server entries for all of the File Server machines in an administrative domain, which is a collection of File Server machines administered by the same system administrators. Members of the group can then manipulate the FLDB entries for all of the filesets in the domain. A foreign group cannot own a server entry.
The following additional commands are also provided for the manipulation of server entries in the FLDB:
· The fts lsserverentry command lets you list current server entries. In a multihomed server environment (where servers have more than one connection), the command lists all of the machine specifications (host names or IP addresses) currently known for that server.
· The fts edserverentry command allows you to edit an existing preference entry. If a server has more than one connection, the additional addresses must be entered through this command. The fts delserverentry command can only specify one connection for a server. You can remove connections from a server entry with the fts edserverentry command.
· The fts delserverentry command lets you remove an existing server entry.
The following topics provide information about the various server entry manipulation commands.
Creating a Server Entry for a Machine
To create a server entry for a File Server machine, do the following:
1. Verify that you have the necessary privilege. You must be included in the admin.fl file on each Fileset Database machine. If necessary, issue the bos lsadmin command to verify the members of an administrative list.
2. Use the fts crserverentry command to create a server entry in the FLDB for the machine:
$ fts crserverentry -server machine -principal name [-quota entries] [-owner group]
The -server machine option specifies the DCE path name, host name, or IP address of the server machine whose entry is to be added to the FLDB. The command fails if a network address in use by another server entry is specified with this option.
The -principal name option is the abbreviated DFS server principal name of the machine to be registered in the FLDB (for example, hosts/hostname). The machine's principal name in the Registry Database must match this name.
The -quota entries option sets a limit on the number of fileset entries (read/write, read-only, and backup) in the FLDB that can be associated with the server. If this option is omitted, the default is 0 (zero), meaning that an unlimited number of fileset entries can be associated with the server.
The -owner group option 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.
Listing Server Entries for Machines
Use the fts lsserverentry command to list either the server entry for a specific File Server machine or all current server entries from the FLDB:
$ fts lsserverentry {-server machine | -all}
The -server machine option specifies the DCE path name, host name, or IP address of the server machine whose entry in the FLDB is to be displayed. Use this option or use the -all option.
The -all option specifies that the entries for all server machines in the FLDB are to be displayed. Use this option or use the -server option.
Editing a Server Entry for a Machine
To edit the server entry for a File Server machine, do the following:
1. Verify that you have the necessary privilege. You must be included in the admin.fl file on each Fileset Database machine. If necessary, issue the bos lsadmin command to verify the members of an administrative list.
2, Use the fts edserverentry command to modify any aspect of an existing server entry in the FLDB. For example, the command can be used to add an additional network address to an existing entry for a machine.
$ fts edserverentry -server machine
[{-rmaddr | -addaddr address | -changeaddr address}]
[-principal name] [-quota entries] [{-owner group | -noowner}]
The -server machine option specifies the DCE path name, host name, or IP address of the server machine whose entry in the FLDB is to be modified. Specify the network address if the -rmaddr, -addaddr, or -changeaddr option is used with the command.
The -rmaddr option removes the network address specified with -server from the FLDB. The command fails if the specified address is the only address present for the machine in the FLDB. If you use this option, do not use the -addaddr or -changeaddr option.
The -addaddr address option adds the additional address specified with this option to the FLDB for the machine specified with -server. A machine can have up to four addresses associated with its entry in the FLDB. If you use this option, do not use the -rmaddr or -changeaddr option.
The -changeaddr address option changes the address in the FLDB specified with -server to the address specified with this option. If you use this option, do not use the -rmaddr or -addaddr option.
The -principal name option changes the abbreviated DFS server principal name of the machine registered in the FLDB (for example, hosts/hostname). The machine's principal name in the Registry Database must match this name. Omit this option to leave the DFS server principal registered for the machine unchanged.
The -quota entries option changes the limit on the number of fileset entries (read/write, read-only, and backup) in the FLDB that can be associated with the server. Omit this option to leave the quota for the number of fileset entries unchanged.
The -owner group option changes the group that is the owner of the server entry. In the entry, the specified group replaces the current owning group, if there is 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. Use this option or use the -noowner option; omit both options to leave the current owning group unchanged.
The -noowner option specifies that no group is to own the server entry. In the entry, the empty group ID, which is 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.
Deleting a Server Entry for a Machine
To remove the server entry for a File Server machine, do the following:
1. Verify that you have the necessary privilege. You must be included in the admin.fl file on each Fileset Database machine. If necessary, issue the bos lsadmin command to verify the members of an administrative list.
2. Use the fts delserverentry command to delete the server entry for a machine from the FLDB. The command fails if the entry in the FLDB for any fileset references the server entry to be removed as the location of the fileset.
$ fts delserverentry -server machine
The -server machine option specifies the DCE path name, host name, or IP address of the server machine whose entry in the FLDB is to be removed. The command fails if a fileset entry references the server entry to be removed.