Renaming Filesets

You can use the fts rename command to change the name of the read/write version of any DCE LFS or non-LFS fileset. When you change the name of a fileset's read/write version, the names of the read-only and backup versions of the fileset are automatically changed accordingly. When you change the name of a fileset, you must also replace any mount points that reference versions of the fileset by the old name with mount points that indicate the new name.

To rename a fileset, do the following:

1. Verify that you have the necessary privileges. You must be included in the admin.ft file on the machine on which the read/write fileset resides, and you must be included in the admin.fl file on each Fileset Database machine or own the server entry for each machine on which a version of the fileset resides. If necessary, issue the bos lsadmin command to verify the members of an administrative list.

2. Verify that you have the w (write), x (execute), i (insert), and d (delete) ACL permissions for the directory in which you need to replace the mount point. If necessary, issue the dcecp acl show command to list the permissions for the directory.

3. Issue the fts rename command to rename the fileset:

$ fts rename -oldname oldname -newname newname

The -oldname oldname option is the current name of the read/write fileset.

The -newname newname option is the new name of the fileset. The new name can be no longer than 102 characters. (See Making Filesets and Aggregates Available for more information on fileset naming conventions.)

4. Issue the fts delmount command to remove the mount point that indicates the fileset's old name:

$ fts delmount -dir directory_name...

The -dir directory_name option is the name of each mount point you want to remove.

5. Issue the fts crmount command to create a new mount point that indicates the fileset's new name:

$ fts crmount -dir directory_name -fileset {name | ID}

The -dir directory_name option is the location for the root directory of the fileset; the specified location must not already exist. However, the parent directory of the mount point must exist in the DCE namespace. Include a complete path name unless you want to mount the fileset in the current working directory.

The -fileset name or ID option is the name or ID number of the fileset to be mounted. Use the name you specified with the fts rename command in the earlier step.