Coda File System User and System Administrators Manual

M. Satyanarayanan

            satya@cs.cmu.edu
          

Maria R. Ebling

            mre@cs.cmu.edu
          

Joshua Raiff

            jraiff@cs.cmu.edu
          

Peter J. Braam

            braam@cs.cmu.edu
          

Jan Harkes

            jaharkes@cs.cmu.edu
          

The Coda File System is a descendant of the Andrew File System. Like AFS, Coda offers location-transparent access to a shared Unix file namespace that is mapped on to a collection of dedicated file servers. But Coda represents a substantial improvement over AFS because it offers considerably higher availability in the face of server and network failures. The improvement in availability is achieved using the complementary techniques of server replication and disconnected operation. Disconnected operation proven especially valuable in supporting portable computers. This document is a reference manual for Coda users and system administrators.


Table of Contents
Preface
Further Reading
Acknowledgments
1. Getting Started
What is Coda?
Getting clued in with the Coda terminology.
Organization of the client
The kernel module and the cache manager
Utilities
Server organization
Authentication
Coda File Protection
Disconnected Operation
Hoarding
Repairing Conflicts
2. Common Scenarios
Constructing a hoardfile
Hoarding for a Weekend
Re-integrating After Disconnection
Dealing With a Flaky Network
Re-integrating Over the Phone Line
Repairing an Inconsistent Directory
Server/Server Conflicts
Local/Global Conflicts
3. System Overview
Machines
Processes
Data Location
4. Obtaining Coda
5. Installing and Configuring a Coda Client
Installing and Configuring the Coda Client Binaries and Documentation
Linux and the BSD's: running venus, the client cache manager
Windows 95: Starting and Configuring a Coda client
Upgrading from a previous Release
Configuration changes made by venus-setup
6. Installing a Coda Server
Introduction
Recoverable Virtual Memory
Server Disk Organization
Installation and Configuration
Installing the Coda Server Binaries and Documentation
Configuring A Coda Server
Exploring replication
Underneath vice-setup
RVM Initialization
Update Monitor
Authentication Database
7. Troubleshooting
Basic Troubleshooting
Client Problems
Server Problems
Disconnections.
Advanced Troubleshooting
Troubleshooting on Windows 95
Common problems
Restrictions
8. Volume Administration
Concepts
Creating a Volume
Mounting a Volume
Deleting a Volume
Dumping and Restoring a Volume
Creating a dump of a replicated volume
Restoring volume dumps
Building the volume databases
Ensuring Volume Consistency after Server Crashes
Getting Volume Information
9. User Administration
Short introduction to pdbtool
Adding a new user
Upgrading existing user.coda and group.coda databases
Upgrading from the coda.pdb/name.pdb databases used in 5.2.0/5.2.2
10. The Backup System
Introduction: Design of the Coda Backup Subsystem
Installing a Coda Backup Coordinator Machine
Incremental Dumps
Tape files
Restoring a backup clone
Backup Scripts
11. Reinitializing Coda Servers after a Disaster
Obtaining Backup Dump Files
Reinitializing the Servers
References
A. Quick Reference
B. System Configuration Files