Renames a fileset
Synopsis
fts rename -oldname oldname -newname newname [-cell cellname] [{-noauth | -localauth}]
[-verbose]
[-help]
Options
-oldname oldname
Specifies the current name of the read/write fileset.
-newname newname
Specifies the new 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 that is added automatically when a read-only or backup version of a DCE LFS fileset is created. 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.
-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 rename command changes the name of the read/write fileset specified with -oldname to the name specified with -newname. The names
of the read/write fileset's read-only copies and backup copy, if any, automatically change to match.
After issuing this command, the issuer must correct any mount points that refer to the old fileset name. This is done by removing each old mount point with the fts delmount command and creating a replacement for each with the fts crmount command. (These commands require that the issuer have the necessary file system permissions for the operations.)
Privilege Required
The issuer must be listed in the admin.ft file on the machine on which the read/write fileset resides. The issuer must also be listed in the
admin.fl files on all Fileset Database machines or own the server entry for each machine on which a version of the fileset to be renamed resides.
Examples
The following command changes the incorrect fileset name osf1.bin to the correct fileset name pmax_osf1.bin:
$ fts rename osf1.bin pmax_osf1.bin
Related Information
Commands: fts crmount(8dfs)