Part II. Managing File Server Machines

Table of Contents

3. Administering Server Machines
Summary of Instructions
Local Disk Files on a Server Machine
Binaries in the /usr/afs/bin Directory
Common Configuration Files in the /usr/afs/etc Directory
Local Configuration Files in the /usr/afs/local Directory
Replicated Database Files in the /usr/afs/db Directory
Log Files in the /usr/afs/logs Directory
Volume Headers on Server Partitions
The Four Roles for File Server Machines
Simple File Server Machines
Database Server Machines
Binary Distribution Machines
The System Control Machine
To locate database server machines
To locate the system control machine
To locate the binary distribution machine for a system type
Interpreting the Output from the bos status Command
Administering Database Server Machines
Replicating the OpenAFS Administrative Databases
Backing Up and Restoring the Administrative Databases
To back up the administrative databases
To restore an administrative database
Installing Server Process Software
Installing New Binaries
To install new server binaries
Reverting to the Previous Version of Binaries
To revert to the previous version of binaries
Displaying Binary Version Dates
To display binary version dates
Removing Obsolete Binary Files
To remove obsolete binaries
Displaying A Binary File's Build Level
To display an AFS binary's build level
Maintaining the Server CellServDB File
Distributing the Server CellServDB File
To display a cell's database server machines
To add a database server machine to the CellServDB file
To remove a database server machine from the CellServDB file
Managing Authentication and Authorization Requirements
Authentication versus Authorization
Controlling Authorization Checking on a Server Machine
To disable authorization checking on a server machine
To enable authorization checking on a server machine
Bypassing Mutual Authentication for an Individual Command
To bypass mutual authentication for bos, kas, pts, and vos commands
To bypass mutual authentication for fs commands
Adding or Removing Disks and Partitions
To add and mount a new disk to house AFS volumes
To unmount and remove a disk housing AFS volumes
Managing Server IP Addresses and VLDB Server Entries
To create or edit the server NetInfo file
To create or edit the server NetRestrict file
To display all server entries from the VLDB
To remove obsolete server entries from the VLDB
To change a server machine's IP addresses
Rebooting a Server Machine
To reboot a file server machine from its console
To reboot a file server machine remotely
4. Monitoring and Controlling Server Processes
Summary of Instructions
Brief Descriptions of the AFS Server Processes
The bosserver Process: the Basic OverSeer Server
The buserver Process: the Backup Server
The fs Collection of Processes: the File Server, Volume Server and Salvager
The kaserver Process: the Authentication Server
The ptserver Process: the Protection Server
The upserver and upclient Processes: the Update Server
The vlserver Process: the Volume Location Server
Controlling and Checking Process Status
The Information in the BosConfig File
How the BOS Server Uses the Information in the BosConfig File
About Starting and Stopping the Database Server Processes
About Starting and Stopping the Update Server
Displaying Process Status and Information from the BosConfig File
To display the status of server processes and their BosConfig entries
Creating and Removing Processes
To create and start a new process
To stop a process and remove it from the BosConfig file
Stopping and Starting Processes Permanently
To stop a process by changing its status to NotRun
To start processes by changing their status flags to Run
Stopping and Starting Processes Temporarily
To stop processes temporarily
To start all stopped processes that have status flag Run in the BosConfig file
To start specific processes
Stopping and Immediately Restarting Processes
To stop and restart all processes including the BOS Server
To stop and immediately restart all processes except the BOS Server
To stop and immediately restart specific processes
Setting the BOS Server's Restart Times
To display the BOS Server restart times
To set the general or binary restart time
Displaying Server Process Log Files
To examine a server process log file
5. Managing Volumes
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
6. Configuring the AFS Backup System
Summary of Instructions
Introduction to Backup System Features
Volume Sets and Volume Entries
Dumps and Dump Sets
Dump Hierarchies, Dump Levels and Expiration Dates
Dump Names and Tape Names
Tape Labels, Dump Labels, and EOF Markers
Tape Coordinator Machines, Port Offsets, and Backup Data Files
The Backup Database and Backup Server Process
Interfaces to the Backup System
Overview of Backup System Configuration
Configuring the tapeconfig File
To run the fms command on a noncompressing tape device
Granting Administrative Privilege to Backup Operators
Configuring Tape Coordinator Machines and Tape Devices
To configure a Tape Coordinator machine
To configure an additional Tape Coordinator on an existing Tape Coordinator machine
To unconfigure a Tape Coordinator
To display the list of configured Tape Coordinators
Defining and Displaying Volume Sets and Volume Entries
To create a volume set
To add a volume entry to a volume set
To display volume sets and volume entries
To delete a volume set
To delete a volume entry from a volume set
Defining and Displaying the Dump Hierarchy
Creating a Tape Recycling Schedule
Archiving Tapes
Defining Expiration Dates
To add a dump level to the dump hierarchy
To change a dump level's expiration date
To delete a dump level from the dump hierarchy
To display the dump hierarchy
Writing and Reading Tape Labels
Recording a Name on the Label
Recording a Capacity on the Label
To label a tape
To read the label on a tape
Automating and Increasing the Efficiency of the Backup Process
Creating a Device Configuration File
Invoking a Device's Tape Mounting and Unmounting Routines
Eliminating the Search or Prompt for the Initial Tape
Enabling Default Responses to Error Conditions
Eliminating the AFS Tape Name Check
Setting the Memory Buffer Size to Promote Tape Streaming
Dumping Data to a Backup Data File
To configure a backup data file
7. Backing Up and Restoring AFS Data
Summary of Instructions
Using the Backup System's Interfaces
Performing Backup Operations as the Local Superuser Root or in a Foreign Cell
Using Interactive and Regular Command Mode
To enter interactive mode
To exit interactive mode
To display pending or running jobs in interactive mode
To cancel operations in interactive mode
Starting and Stopping the Tape Coordinator Process
To start a Tape Coordinator process
To stop a Tape Coordinator process
To check the status of a Tape Coordinator process
Backing Up Data
Making Backup Operations More Efficient
How Your Configuration Choices Influence the Dump Process
Appending Dumps to an Existing Dump Set
Scheduling Dumps
To create a dump
Displaying Backup Dump Records
To display dump records
To display a volume's dump history
To scan the contents of a tape
Restoring and Recovering Data
Making Restore Operations More Efficient
Using the backup volrestore Command
To restore volumes with the backup volrestore command
Using the backup diskrestore Command
To restore a partition with the backup diskrestore command
Using the backup volsetrestore Command
To restore a group of volumes with the backup volsetrestore command
Maintaining the Backup Database
Backing Up and Restoring the Backup Database
Checking for and Repairing Corruption in the Backup Database
To verify the integrity of the Backup Database
To repair corruption in the Backup Database
Removing Obsolete Records from the Backup Database
To delete dump records from the Backup Database
8. Monitoring and Auditing AFS Performance
Summary of Instructions
Using the scout Program
System Requirements
Using the -basename argument to Specify a Domain Name
The Layout of the scout Display
Highlighting Significant Statistics
Resizing the scout Display
To start the scout program
To stop the scout program
Example Commands and Displays
Using the fstrace Command Suite
About the fstrace Command Suite
Requirements for Using the fstrace Command Suite
Using fstrace Commands Effectively
Activating the Trace Log
To configure the trace log
To set the event set
Displaying the State of a Trace Log or Event Set
To display the state of an event set
To display the log size
Dumping and Clearing the Trace Log
To dump the contents of a trace log
To clear the contents of a trace log
Examples of fstrace Commands
Using the afsmonitor Program
Requirements for running the afsmonitor program
The afsmonitor Output Screens
The System Overview Screen
The File Servers Screen
The Cache Managers Screen
Configuring the afsmonitor Program
Writing afsmonitor Statistics to a File
To start the afsmonitor Program
To stop the afsmonitor program
The xstat Data Collection Facility
The libxstat Libraries
Example xstat Commands
Auditing AFS Events on AIX File Servers
Configuring AFS Auditing on AIX File Servers
To enable AFS auditing
To disable AFS auditing
9. Managing Server Encryption Keys
Summary of Instructions
About Server Encryption Keys
Keys and Mutual Authentication: A Review
Maintaining AFS Server Encryption Keys
Displaying Server Encryption Keys
To display the KeyFile file
To display the afs key from the Authentication Database
Adding Server Encryption Keys
To add a new server encryption key
Removing Server Encryption Keys
To remove a key from the KeyFile file
Handling Server Encryption Key Emergencies
Prevent Mutual Authentication
Disable Authorization Checking by Hand
Work Quickly on Each Machine
Work at the Console
Change Individual KeyFile Files
Two Component Procedures
To create a new server encryption key in emergencies