Chapter 5. Managing Volumes

Table of Contents

Summary of Instructions
About Volumes
The Three Types of Volumes
How Volumes Improve AFS Efficiency
Volume Information in the VLDB
The Information in Volume Headers
Keeping the VLDB and Volume Headers Synchronized
About Mounting Volumes
About Volume Names
Creating Read/write Volumes
To create (and mount) a read/write volume
About Clones and Cloning
Replicating Volumes (Creating Read-only Volumes)
Using Read-only Volumes Effectively
Replication Scenarios
To replicate a read/write volume (create a read-only volume)
Creating Backup Volumes
Backing Up Multiple Volumes at Once
Automating Creation of Backup Volumes
Making the Contents of Backup Volumes Available to Users
To create and mount a backup volume
To create multiple backup volumes at once
Mounting Volumes
The Rules of Mount Point Traversal
The Three Types of Mount Points
Creating a mount point in a foreign cell
To display a mount point
To create a regular or read/write mount point
To create a cellular mount point
To remove a mount point
To access volumes directly by volume ID
Displaying Information About Volumes
Displaying VLDB Entries
To display VLDB entries
Displaying Volume Headers
To display volume headers
Displaying One Volume's VLDB Entry and Volume Header
To display one volume's VLDB entry and volume header
Displaying the Name or Location of the Volume that Contains a File
Moving Volumes
To move a read/write volume
Synchronizing the VLDB and Volume Headers
To synchronize the VLDB with volume headers
Salvaging Volumes
To salvage volumes
Setting and Displaying Volume Quota and Current Size
To set quota for a single volume
To set maximum quota on one or more volumes
To display percent quota used
To display quota, current size, and other information
To display quota, current size, and more partition information
Removing Volumes and their Mount Points
Other Removal Commands
To remove a volume and unmount it
Dumping and Restoring Volumes
About Dumping Volumes
To dump a volume
About Restoring Volumes
To restore a dump into a new volume and mount it
To restore a dump file, overwriting an existing volume
Renaming Volumes
To rename a volume
Unlocking and Locking VLDB Entries
To lock a VLDB entry
To unlock a single VLDB entry
To unlock multiple VLDB entries

This chapter explains how to manage the volumes stored on file server machines. The volume is the designated unit of administration in AFS, so managing them is a large part of the administrator's duties.

Summary of Instructions

This chapter explains how to perform the following tasks by using the indicated commands:

Create read/write volumevos create
Create read-only volumevos addsite and vos release
Create backup volumevos backup
Create many backup volumes at oncevos backupsys
Examine VLDB entryvos listvldb
Examine volume headervos listvol
Examine both VLDB entry and volume headervos examine
Display volume's namefs listquota or fs examine
Display volume's ID numberfs examine or vos examine or vos listvol
Display partition's size and space availablevos partinfo
Display volume's locationfs whereis or vos examine
Create mount pointfs mkmount
Remove mount pointfs rmmount
Display mount pointfs lsmount
Move read/write volumevos move
Synchronize VLDB with volume headersvos syncvldb and vos syncserv
Set volume quotafs setvol or fs setquota
Display volume quotafs quota or fs listquota or fs examine
Display volume's current sizefs listquota or fs examine
Display list of volumes on a machine/partitionvos listvol
Remove read/write volumevos remove and fs rmmount
Remove read-only volumevos remove
Remove backup volumevos remove and fs rmmount
Remove volume; no VLDB changevos zap
Remove read-only site definitionvos remsite
Remove VLDB entry; no volume changevos delentry
Dump volumevos dump
Restore dumped volumevos restore
Rename volumevos rename, fs rmmount and fs mkmount
Unlock volumevos unlock
Unlock multiple volumesvos unlockvldb
Lock volumevos lock