When using the fts commands to create, manipulate, or delete filesets, you can often add the -verbose option to receive detailed information from the fts program about its actions as it executes the command. This can be particularly helpful if an operation fails for a reason you do not understand. The amount of additional information produced by the -verbose option varies for different commands.
The following options and arguments are common to many of the commands described in this topic. If an option or argument is not described with a command in the text, a description of it appears here. (See Part 2 of this guide and reference for complete details about each command.)
· The -fileset name option is the complete name (for example, user.sandy) or ID number (for example, 0,,34692) of the fileset to be used in the command.
· The -server machine option is the File Server machine to be used in the command. Unless otherwise indicated, you can use any of the following to specify the File Server machine:
- The machine's DCE path name (for example, /.../abc.com/hosts/fs1)
- The machine's host name (for example, fs1.abc.com or fs1)
- The machine's IP address (for example, 11.22.33.44)
· The -aggregate name option is the device name (for example, /dev/lv01), aggregate name (for example, lfs1 or /usr), or aggregate ID (for example, 3 or 12) of the aggregate or partition to be used in the command. These identifiers are specified in the first, second, and fourth fields of the entry for the aggregate or partition in the dcelocal/var/dfs/dfstab file.
· The -cell cellname option specifies the cell with respect to which the command is to be run (for example, abc.com). The default is the local cell of the issuer of the command.
· The -noauth option directs the fts program to use the unprivileged identity nobody as the identity of the issuer of the command. If DFS authorization checking has been disabled with the bos setauth command, the identity nobody has the necessary privileges to perform any operation. (See Using Administrative Lists and Keytab Files for information about disabling DFS authorization checking.) If you use this option, do not use the -localauth option.
· The -localauth option directs the fts program to use the DFS server principal of the machine on which the command is issued as the identity of the issuer. Each DFS server machine has a DFS server principal stored in the Registry Database. A DFS server principal is a unique, fully qualified principal name that ends with the string dfs-server (for example, /.../abc.com/hosts/fs1/dfs-server). Do not confuse a machine's DFS server principal with its unique self identity. (See Exporting Aggregates and Partitions for information about DFS server principals.)
Use the -localauth option only if the command is issued from a DFS server machine. 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.
The -cell, -noauth, and -localauth options are always optional.