Renaming Volumes

You can use the vos rename command to rename a volume. For example, it is appropriate to rename a user's home volume if you use the user. username convention for user volume names and you change the username. (For complete instructions for changing usernames, see Changing Usernames.)

The vos rename command accepts only read/write volume names, but automatically changes the names of the associated read-only and backup volumes. As directed in the following instructions, you need to replace the volume's current mount point with a new one that reflects the name change.

To rename a volume

  1. Verify that you are listed in the /usr/afs/etc/UserList file. If necessary, issue the bos listusers command, which is fully described in To display the users in the UserList file.

       % bos listusers <machine name>
    
  2. Verify that you have the a( administer), d( delete), and i( insert) access permissions for the directory in which you are replacing the volume's mount point. If necessary, issue the fs listacl command, which is fully described in Displaying ACLs.

       % fs listacl [<dir/file path>]
    

    Members of the system:administrators group always implicitly have the a( administer) and by default also the l( lookup) permission on every ACL and can use the fs setacl command to grant other rights as necessary.

  3. Issue the vos rename command to rename the volume.

       % vos rename <old volume name> <new volume name>
    

    where

    ren

    Is the shortest acceptable abbreviation of rename.

    old volume name

    Is the current name of a read/write volume.

    new volume name

    Is the new name for the volume. It cannot be more than 22 characters in length.

    If there is no Volume Location Database (VLDB) entry for the specified current volume name, the command fails with the following error message:

       vos: Could not find entry for volume old_volume_name.
    
  4. Issue the fs rmmount command to remove the mount point that refers to the volume's old name. Complete instructions appear in To remove a mount point.

       % fs rmmount <directory>
    
  5. Issue the fs mkmount to create a mount point that indicates the volume's new name. Complete instructions appear in To create a regular or read/write mount point.

       % fs mkmount <directory> <volume name> [-rw]