createvol_rep(8) createvol_rep(8) NAME createvol_rep - create read-write replicated volume SYNOPSIS createvol_rep <volume-name> <vsgaddr> <partition-name> [rep group id] DESCRIPTION createvol_rep is a front end to volutil createvol_rep and is used to create a Coda read(2,n,1 builtins)/write(1,2) replicated volume. The invoker must specify the volume name (<volume-name>), the replication sites via a Volume Server Group address (<vsgaddr>), the partition on which the volume should be created (<partition-name>), and an optional Group Id. createvol_rep first checks in(1,8) /vice/vol/AllVolumes and /vice/vol/VRList to see if(3,n) the volume name already exists. If not, it uses the volutil create_rep command to create the volume at each of the replication sites. It then builds the Volume Location Data Base (VLDB) and the Volume Replication Data Base (VRDB). The replication sites are determined from the <vsgaddr> and the /vice/db/VSGDB file. The Rep Group Id specifies the "replicated" vol- umeid of the volume being created. By default, the group id in(1,8) /vice/vol/maxgroupid is used. Each time(1,2,n) it is used it is also updated by adding 1 to it. After the replicas are created at each replication site, a new VLDB is built automatically using bldvldb.sh(8), and the Volume Replication List in(1,8) /vice/vol/VRList is updated. The VRList contains one line for each replicated volume. Each line specifies the replicated volume name, group id, number of replication sites, local volume id at each replication site and the VSG address. This file(1,n) is now used to create a new Volume Replication Data Base (VRDB) using the "volutil makevrdb /vice/vol/VRList" command. EXAMPLES To create a replicated volume "coda.rep" on 3 sites foo, bar and gorp use: createvol_rep coda.rep E0000107 /vicapa where /vice/db/VSGDB has an entry "E0000107 foo bar gorp" in(1,8) it. To assign a predetermined Group Id, use createvol_rep coda.rep E0000107 /vicepa 7F000003 where "7F000003" is the Group Id. DIAGNOSTICS This command must be issued at the System Control Machine (SCM). Also, it must be invoked with effective user id of root. This command does not check for return codes from the volutil create_rep command. The invoker must check /vice/vol/VRList and /vice/vol/VolumeList at each replication site to see if(3,n) the volume was created. FILES /vice/vol/VRList contains information on replicated volumes /vice/vol/VolumeList name of volume created at each site is appended to it /vice/db/VRDB is used to describe the replicated volumes in(1,8) terms of its non- replicated members. /vice/db/VSGDB is used to translate the VSG address to replication sites /vice/vol/AllVolumes is used to check if(3,n) volume exists /vice/vol/maxgroupid is used to assign a group id to the replicated volume SEE ALSO bldvldb.sh (8), volutil (8), createvol (8) AUTHOR Puneet Kumar, 1990, Created createvol_rep(8)