Seth Woolley's Man Viewer

createvol_rep(8) - createvol_rep - create read-write replicated volume - man 8 createvol_rep

([section] manual, -k keyword, -K [section] search, -f whatis)
man plain no title

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)

References for this manual (incoming links)