fts create(8dfs)

Synopsis

fts create -ftname name -server machine -aggregate name [-cell cellname]
[{-noauth | -localauth}] [-verbose] [-help]

Options

-ftname name
Specifies a name for the read/write 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. This length does not include the .readonly or .backup extension, which is added automatically when a read-only or backup version of the fileset is created. Note that the .readonly and .backup extensions are reserved for use with read-only and backup filesets, so you cannot specify a fileset name that ends with either of these extensions.

-server machine
Names the File Server machine on which to create the new read/write fileset. A server entry for the machine must already exist. Specify the File Server machine using the machine's DCE path name, 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 where the read/write fileset is to be stored. These identifiers are specified in the first, second, and fourth fields of the entry for the aggregate in the dcelocal/var/dfs/dfstab file.

-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 create command creates a read/write DCE LFS fileset, names it as specified by -ftname, and places it at the site specified by -server and -aggregate. The FL Server creates an entry for the fileset in the Fileset Location Database (FLDB) and allocates the fileset a unique ID number, which is recorded in both the fileset's FLDB entry and its fileset header. It also sets the status flag recorded for the read/write site in the fileset's FLDB entry to valid and 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.

The FL Server also allocates and stores in the entry for the fileset in the FLDB the fileset ID numbers for the read-only and backup versions of the fileset that can be created later. It does not create these types of filesets or place anything at a read-only or backup site, so the status flags for the read-only and backup versions are set to invalid.

If this command succeeds, the fileset is available for use. It must be mounted in the file system with the fts crmount command for its contents to be visible in the global namespace. The command creates an empty root directory in the fileset, which becomes visible when the fileset is mounted. It records null ACLs as the default for use by the directory. (Although, due to the interaction between ACLs and UNIX mode bits, the directory has a set of implicit initial ACLs granting permissions to different users and groups.)

When a cell is initially configured, the fts create command is used to create the cell's main read/write fileset, root.dfs. Although root.dfs can be a non-LFS fileset, it must be a DCE LFS fileset if functionality such as replication is to be available in the cell. Part 1 of the OSF DCE DFS Administration Guide and Reference provides information about configuring the root fileset to support replication.

Privilege Required
The issuer must be listed in the admin.ft file on the machine specified by -server. The issuer must also 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 command creates the read/write fileset user.pat. The fileset is created on the aggregate /dev/lv01 on the File Server machine fs4.

$ fts create user.pat /.../abc.com/hosts/fs4 /dev/lv01

Related Information
Commands: fts crfldbentry(8dfs)

fts crmount(8dfs)

Files: dfstab(4dfs)