Creates a fileset entry in the FLDB
Synopsis
fts crfldbentry -ftname name -server machine -aggrid ID [-cell cellname]
[{-noauth |
-localauth}] [-verbose] [-help]
Options
-ftname name
Specifies a name for the fileset. The name must be unique within the local cell, and it should be indicative of the fileset's contents. The following
characters can be included in the name of a fileset:
· All uppercase and lowercase alphabetic characters (a to z, and A to Z)
· All numerals (0 to 9)
· The . (period)
· The - (dash)
· The _ (underscore)
The name must contain at least one alphabetic character or an _ (underscore) to differentiate it from an ID number. It can be no longer than 102 characters. (Fileset names are restricted to this limit to accommodate the .readonly and .backup extensions that DCE LFS filesets of those types receive. Note that the .readonly and .backup extensions are reserved for use with read-only and backup DCE LFS filesets, so you cannot specify a fileset name that ends with either of these extensions.)
-server machine
Names the File Server machine on which the fileset resides. Specify the File Server machine using the machine's DCE path name, the machine's host
name, or the machine's IP address.
-aggrid ID
Specifies the aggregate ID number to be assigned to the aggregate or partition in the Fileset Location Database (FLDB). The number specified with this
option must also be used as the aggregate ID in the fourth field of the entry for the aggregate or partition in the dcelocal/var/dfs/dfstab file on the machine where the aggregate
or partition resides. The ID number must be a positive integer. If the command is being used to create an FLDB entry for a non-LFS fileset (its typical use), the specified number must not already
be in use in the dfstab file on the specified -server.
-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 crfldbentry command is used to register a fileset in the FLDB. After the fileset is registered, its location can be tracked by the FL Server. The
command is typically used to create FLDB entries for non-LFS filesets.
Use the -ftname option to specify a name for the fileset according to the guidelines presented with the description of the -ftname option. Use the -server option to indicate the File Server machine that houses the aggregate or partition on which the fileset resides. Use the -aggrid option to specify an aggregate ID number to be associated with the aggregate or partition in the FLDB. This same number must be used in the entry for the aggregate or partition in the dfstab file on -server; choose a number that is not already in use in the machine's dfstab file.
The FL Server allocates a unique fileset ID number for the fileset. This number, along with ID numbers allocated for read-only and backup filesets, is returned by the command. When creating an entry for a non-LFS fileset, the ID number allocated for the read-write fileset must be specified in the fifth field of the entry in the dfstab file for the partition on which the fileset resides.
The FL Server also sets the status flag for the read-write version in the fileset's entry to valid. In addition, it increments the number of fileset entries recorded as residing on the specified File Server machine in the FLDB entry for the server. A server entry must exist in the FLDB for the File Server machine before this command is issued.
After issuing this command to register a non-LFS fileset, create an entry for the partition on which the fileset resides in the local dfstab file, export the partition with the dfsexport command, and mount the fileset with the fts crmount command to make the fileset accessible in the DCE namespace. The fts crserverentry command must be used before this command to create a server entry in the FLDB for the machine on which the fileset resides.
Privilege Required
The issuer must be listed in the admin.fl files on all Fileset Database machines or own the server entry for the machine specified by
-server.
Examples
The following example creates an entry in the FLDB for a non-LFS fileset named user.jlw. The fileset is located on the File Server machine named fs3.
The aggregate ID of the partition the fileset resides on is 7.
$ fts crfldbentry user.jlw /.../abc.com/hosts/fs3 7
Related Information
Commands: dfsexport(8dfs)
Files: dfstab(4dfs)