mirror of
https://git.openafs.org/openafs.git
synced 2025-01-31 05:27:44 +00:00
45a69b6113
The vos convertROtoRW command converts a RO volume into a RW volume. Unfortunately, the RO volume is not checked out from the fileserver during this process. As a result, accesses to the volume being converted can leave volume objects in an inconsistent state. Moreover, consider the following scenario: 1. Create a volume on host_b and add replicas on host_a and host_b. $ vos create host_b a vol_1 $ vos addsite host_b a vol_1 $ vos addiste host_a a vol_1 2. Mount the volume: $ fs mkmount /afs/.mycell/vol_1 vol_1 $ vos release vol_1 $ vos release root.cell 3. Shutdown dafs on host_b: $ bos shutdown host_b dafs 4. Remove RO reference to host_b from the vldb: $ vos remsite host_b a vol_1 5. Attach the RO copy by touching it: $ fs flushall $ ls /afs/mycell/vol_1 6. Convert RO copy to RW: $ vos convertROtoRW host_a a vol_1 Notice that FSYNC_com_VolDone fails silently (FSYNC_BAD_STATE), leaving the volume object for the RO copy set as VOL_STATE_ATTACHED (on success, this volume should be set as VOL_STATE_DELETED). 7. Add replica on host_a: $ vos addsite host_a a vol_1 8. Wait until the "inUse" flag of the RO entry is cleared (or force this to happen by attaching multiple volumes). 9. Release the volume: $ vos release vol_1 Failed to start transaction on volume 536870922 Volume not attached, does not exist, or not on line Error in vos release command. Volume not attached, does not exist, or not on line Notice that this happens because we cannot mark an attached volume as destroyed (FSYNC_com_VolDone). To avoid the problem mentioned above and to prevent accesses to the volume being converted, take the RO volume offline before converting it to RW. Change-Id: Ifd342e1f420dc42e5da49242a7aa70db7d97a884 Reviewed-on: https://gerrit.openafs.org/14340 Reviewed-by: Andrew Deason <adeason@sinenomine.net> Reviewed-by: Benjamin Kaduk <kaduk@mit.edu> Tested-by: BuildBot <buildbot@rampaginggeek.com>
Guide to the OpenAFS source tree
This is a guide to the various directories in the OpenAFS source code tree.
Some directories contain source code for components of the OpenAFS system,
while other directories are used by the build system to build libraries, kernel
modules, and program variations. See the Makefile at the top of the project
tree for build order and inter-dependencies.
RPC interface definitions (IDL)
The following directory contains interface definitions (IDL) files for the OpenAFS file server and cache manager.
| directory | description |
|---|---|
| fsint | File server and cache manager RPC interface definitions |
Cache Managers
The following directories contain the source code of OpenAFS cache manager and related programs.
| directory | description |
|---|---|
| afs | The OpenAFS cache manager as a kernel-module for unix-like systems |
| afsd | The afsd user-space program to start the cache manager on unix-like systems |
| aklog | The Kerberos 5 login programs: aklog, asetkey, akeyconvert |
| sys | NFS translator local and remote system call interfaces |
| venus | The fs program and other cache manager related utilities |
| WINNT | The OpenAFS cache manager and installer for MS Windows |
| export | Symbol exports for AIX kernel module |
Servers
The following directories contain the source code of the OpenAFS servers and administrative command suites.
| directory | description |
|---|---|
| bozo | The basic overseer server and bos command suite |
| ptserver | The protection server and pts command suite |
| update | The update server and client for maintaining server software and configuration (deprecated) |
| viced | The file server |
| vlserver | The volume location server |
| volser | The volume server and vos command suite |
Backup system
The following directories contain the source code of the OpenAFS backup system.
| directory | description |
|---|---|
| bubasics | Backup related RPC interface definitions |
| bucoord | Backup coordinator and support library |
| budb | Backup database server buserver |
| butc | Backup tape coordinator, and read_tape restoration client |
| butm | Backup tape manager library |
bu_utils |
Backup utilities to estimate tape capacity and file mark sizes |
| tsm41 | Tivoli storage manager support |
Rx subsystem
The following directories contain the source code of the Rx subsystem. Rx provides Remote Procedure Calls (RPC) over UDP/IP in user-space and kernel-mode, and includes an XDR implementation to encode and decode binary data.
| directory | description |
|---|---|
| rx | The Rx library for kernel and user-space |
| rxdebug | Debugging tool for rx |
| rxgen | The rxgen program to generate AFS RPC stubs from IDL (i.e., *.xg) |
| rxgk | Rxgk security class for rx |
| rxkad | Kerberos security module for rx |
| rxosd | Rx object storage device extensions IDL files |
| rxstat | Rx statistics package |
Libraries
The following directories contain the source code for the various libraries used by OpenAFS.
| directory | description |
|---|---|
| opr | General purpose library for user-space and headers for kernel mode |
| audit | The libaudit event auditing support library |
| auth | The libauth library to manage key and cell configuration files |
| cmd | The libcmd library to parse command line arguments |
| comerr | The com_err library to provide error table lookup |
| dir | Modules to lookup, add, and remove entries in directory objects |
| gtx | A curses-based graphics library for terminal-based programs |
| kopenafs | The libkopenafs library for setting up stand-alone setpag() function for Heimdal/KTH libkafs |
| libacl | The libacl library for access control lists |
| libadmin | The libadmin administration API |
| libafscp | The libafscp library; client operations without a cache manager |
| libafsrpc | The libafsrpc library; basic rx functionality for programs which do not require authentication |
| libafsauthent | The libafsauthent library; for AFS-aware utilities |
| procmgmt | Process management library |
| ubik | Ubik replicated database library |
| usd | User-space device input/output library |
| util | Utility library (deprecated in favor of opr) |
| vol | Volume library for managing volumes on-disk |
Utilities
The following directories contain source code for utilities and libraries for OpenAFS administrators.
| directory | description |
|---|---|
| afsmonitor | Terminal-based file server and cache manager monitoring tool |
| fsprobe | File Server probe library and program |
| scout | Terminal-based file server monitoring tool |
| tools | Contributed configuration and maintenance tools |
| xstat | Command line tools and libraries for gathering file server and cache manager statistics |
Other
| directory | description |
|---|---|
| external | Contains imported code which is maintained in other open source projects |
| platform | Code for platform-specific programs and build specs. |
Build system
The following directories are build directories or contain components for the build system.
| directory | description |
|---|---|
| cf | OpenAFS specific M4 macros for autoconf |
| config | Build system OS-specific configuration |
| crypto | libhcrypto library build directory |
| dviced | Demand Attach File Server (DAFS) build directory |
| dvolser | Demand Attach Volume Server build directory |
| finale | Final stage build directory; includes translate_et which translates error codes to descriptive messages |
| libafs | OpenAFS kernel modules build directory |
| libuafs | OpenAFS user-space cache manager build directory |
| packaging | Contributed packaging files for various platforms |
| roken | Build directory for libroken, a set of os-independent functions |
| tbudb | Pthreaded Backup Server (budb) build directory |
| tbutc | Pthreaded Backup Tape Coordinator (butc) build directory |
| tptserver | Pthreaded Protection Server (ptserver) build directory |
| tsalvaged | Pthreaded Salvage Server build directory; Used by Demand Attach File Server |
| tubik | Pthreaded ubik build directory |
| tvlserver | Pthreaded Volume Location vlserver build directory |
| tvolser | Pthreaded Volume Server build directory |
Not Maintained
The following directories contain code of obsolete components which are no longer actively maintained.
| directory | description |
|---|---|
| afsinstall | Installation scripts and notes from IBM AFS |
| afsweb | Authenticated AFS access for older versions of Apache |
| JAVA | Java API library for OpenAFS development |
| kauth | Obsolete Kerberos-4 server (kaserver) and related programs |
| log | Obsolete programs to show and forget Kerberos-4 tokens |
| lwp | Lightweight user-level non-preemptive cooperative threading library |
| pam | Pluggable authentication modules (PAM) for kauth authentication |
| tests | Legacy test scripts; new unit tests should be added to the top level tests directory |
| uss | Tool for managing users; limited to kauth |
| vfsck | OpenAFS specific fsck for obsolete inode-based file server partitions |