Coda File System User and System Administrators Manual

M. Satyanarayanan


Maria R. Ebling


Joshua Raiff


Peter J. Braam


Jan Harkes


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
Further Reading
1. Getting Started
What is Coda?
Getting clued in with the Coda terminology.
Organization of the client
The kernel module and the cache manager
Server organization
Coda File Protection
Disconnected Operation
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
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
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
Advanced Troubleshooting
Troubleshooting on Windows 95
Common problems
8. Volume Administration
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
A. Quick Reference
B. System Configuration Files