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)

       createvol_rep - create read-write replicated volume

       createvol_rep <volume-name> <vsgaddr> <partition-name> [rep group id]

       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,  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.

       To create a replicated volume "coda.rep" on 3 sites foo, bar and   gorp

       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.

       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.

              contains information on replicated volumes

              name of volume created at each site is appended to it

              is  used to describe the replicated volumes in(1,8) terms of its non-
              replicated members.

              is used to translate the VSG address to replication sites

              is used to check if(3,n) volume exists

              is used to assign a group id to the replicated volume

SEE ALSO (8), volutil (8), createvol (8)

       Puneet Kumar, 1990, Created


References for this manual (incoming links)