Partï¿½II.ï¿½Managing File Server Machines
ï¿½	ï¿½	ï¿½

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