Next Previous Contents

# Coda File System
User and System Administrators Manual

## M. Satyanarayanan, Maria R. Ebling, Joshua Raiff, Peter J. Braam

v1.1, 20 August 1997

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.

## 1. Preface

- 1.1 Further Reading
- 1.2 Acknowledgements
- 1.3 Reading List

## 2. Getting Started

- 2.1 Authentication
- 2.2 Coda File Protection
- 2.3 Disconnected Operation
- 2.4 Hoarding
- 2.5 Repairing Conflicts

## 3. Common Scenarios

- 3.1 Constructing a hoardfile
- 3.2 Hoarding for a Weekend
- 3.3 Reintegrating After a Disconnected Session
- 3.4 Dealing With a Flaky Network
- 3.5 Reintegrating Over the Phone Line
- 3.6 Repairing an Inconsistent Directory

## 4. Troubleshooting

- 4.1 File System Full

## 5. System Overview

- 5.1 Machines
- 5.2 Processes
- 5.3 Data Location
- 5.4 File System Consistency

## 6. Configuring Kernels for use with Coda

- 6.1 VFS Interface
- 6.2 Configuring a Linux kernel
- 6.3 Configuring a FreeBSD kernel
- 6.4 Configuring a NetBSD kernel

## 7. Installing a Coda Server

- 7.1 Introduction
- 7.2 Obtaining Coda
- 7.3 Installing and Configuring A Coda Server
- 7.4 Underneath vice-setup
- 7.5 Starting the File Server

## 8. Installing and Configuring a Coda Client

- 8.1 Installing and Configuring the Coda Client Binaries and Documentation
- 8.2 Upgrading from a previous Release
- 8.3 Configuration Changes made by venus-setup
- 8.4 Where Data and Configuration Information is Stored

## 9. Running Coda

- 9.1 Server
- 9.2 Client

## 10. System Administration: Volumes

- 10.1 Description
- 10.2 Creating a Volume
- 10.3 Mounting a Volume
- 10.4 Deleting a Volume
- 10.5 Restoring a Volume
- 10.6 Read-only Replication of a Volume
- 10.7 Building the VLDB
- 10.8 Building the VRDB
- 10.9 Building the VSGDB
- 10.10 Ensuring Volume Consistency after Server Crashes
- 10.11 Getting Volume Information

## 11. System Administration: Users

- 11.1 Adding users
- 11.2 Monitoring Auth Server Activity

## 12. The Backup System

- 12.1 Introduction: Design of the Coda Backup Subsystem
- 12.2 Installing a Coda Backup Coordinator Machine
- 12.3 Incremental Dumps
- 12.4 Tape files
- 12.5 Restoring a backup clone
- 12.6 Backup Scripts

## 13. Reinitializing Coda Servers after a Disaster

- 13.1 Obtaining Backup Dump Files
- 13.2 Reinitializing RVM on the Servers
- 13.3 Recreate the Backed Up Volumes
- 13.4 Restore the Backup Clones
- 13.5 Mount the Recreated Volumes
- 13.6 Populate the New Volumes
- 13.7 Unmount the Volumes
- 13.8 Flush Client Caches
- 13.9 Test the system

## 14. Coda Source Layout

- 14.1 The Big Picture
- 14.2 Layout of Source Code
- 14.3 Module Dependencies
- 14.4 Building a Release
- 14.5 Making Incremental Changes
- 14.6 Promoting Releases
- 14.7 Copyright Notices
- 14.8 Using RCS for Revision Control
- 14.9 Coding Tips

## Appendix

## 15. Quick Reference

## 16. System Files

## 17. Common Problems and Suggestions

## 18. Example Configuration Files

- 18.1 /vice/db/user.coda
- 18.2 /vice/db/groups.coda
- 18.3 /vice/db/servers
- 18.4 /.rhosts

## 19. Unix Manual Pages

- 19.1 cfs(1)
- 19.2 clog(1)
- 19.3 cmon(1)
- 19.4 cpasswd(1)
- 19.5 ctokens(1)
- 19.6 cunlog(1)
- 19.7 filcon(1)
- 19.8 hoard(1)
- 19.9 mvdb(1)
- 19.10 repair(1)
- 19.11 spy(1)
- 19.12 venussetup(1)
- 19.13 vicesetup(1)
- 19.14 volmunge(1)
- 19.15 histo(3)
- 19.16 timing(3)
- 19.17 backuplogs(5)
- 19.18 dumpfile(5)
- 19.19 dumplist(5)
- 19.20 groups.coda(5)
- 19.21 maxgrpid(5)
- 19.22 mcstagen(5)
- 19.23 mcstgrps(5)
- 19.24 servers(5)
- 19.25 user.coda(5)
- 19.26 passwd.coda(5)
- 19.27 vicetab(5)
- 19.28 volulist(5)
- 19.29 vrdb(5)
- 19.30 vrlist(5)
- 19.31 vsgdb(5)
- 19.32 vstab(5)
- 19.33 au(8)
- 19.34 auth2(8)
- 19.35 backup(8)
- 19.36 bldvldb(8)
- 19.37 crvol(8)
- 19.38 crvolrep(8)
- 19.39 initpw(8)
- 19.40 makeftree(8)
- 19.41 merge(8)
- 19.42 norton(8)
- 19.43 pcfgen(8)
- 19.44 prgvol(8)
- 19.45 prgvolre(8)
- 19.46 pwd2pdb(8)
- 19.47 readdump(8)
- 19.48 codasrv(8)
- 19.49 startserver(8)
- 19.50 updtclnt(8)
- 19.51 updtsrv(8)
- 19.52 venus(8)
- 19.53 volutil(8)
- 19.54 vutil(8)

Next Previous Contents