createvol_rep(8)

1createvol_rep(8)            System Manager's Manual           createvol_rep(8)
2
3
4

NAME

6       createvol_rep - create read-write replicated volume
7
8

SYNOPSIS

10       createvol_rep  <volume-name>  <server>[/<partition>]  [<server>[/parti‐
11       tion]]... [<volume-id>]
12

DESCRIPTION

14       createvol_rep is a front end to volutil create_rep and is used to  cre‐
15       ate  a  Coda read/write replicated volume. The invoker must specify the
16       volume name (<volume-name>), and the  server(s)  on  which  the  volume
17       should  be  created.  (<server>[/<partition>]),  the  partition name is
18       required when the server manages more than one data partition.  Finally
19       an replicated <volume-id> can be specified.
20
21       createvol_rep     first    checks    in     /vice/vol/AllVolumes    and
22       /vice/vol/VRList to see if the volume name already exists.  If not,  it
23       uses the volutil create_rep command to create the volume at each of the
24       replication sites.  It then rebuilds  the  Volume  Location  Data  Base
25       (VLDB) and the Volume Replication Data Base (VRDB).
26
27       The optional replicated <volume-id> specifies the "replicated" volumeid
28       of  the  volume  being  created.   By  default,  the   volume   id   in
29       /vice/vol/maxgroupid  is used.  Each time it is used it is also updated
30       by adding 1 to it.
31
32       After the replicas are created at each replication site, a new VLDB  is
33       built  automatically  using  bldvldb.sh(8),  and the Volume Replication
34       List in /vice/vol/VRList is updated.  The VRList contains one line  for
35       each  replicated  volume.   Each  line  specifies the replicated volume
36       name, replicated volume id, number of replication sites, and the  local
37       volume  id at each replication site.  This file is now used to create a
38       new Volume Replication Data Base (VRDB)  using  the  "volutil  makevrdb
39       /vice/vol/VRList" command.
40

EXAMPLES

42       To  create a replicated volume "coda.rep" on 3 sites foo, bar and  gorp
43       use:
44
45       createvol_rep coda.rep foo bar gorp
46
47       To assign a predetermined replicated volume id, use
48
49       createvol_rep coda.rep foo bar gorp 7F000003
50
51       where "7F000003" is the replicated volume id.
52

DIAGNOSTICS

54       This command must be issued at the System Control Machine (SCM).  Also,
55       it  must  be invoked with effective user id of root.  This command does
56       not check for return codes from the volutil  create_rep  command.   The
57       invoker  must  check  /vice/vol/VRList and /vice/vol/VolumeList at each
58       replication site to see if the volume was created.
59

FILES

61       /vice/vol/VRList
62              contains information on replicated volumes
63
64
65
66       /vice/vol/VolumeList
67              name of volume created at each site is appended to it
68
69
70
71       /vice/db/VRDB
72              is used to describe the replicated volumes in terms of its  non-
73              replicated members.
74
75
76
77       /vice/vol/AllVolumes
78              is used to check if volume exists
79
80
81
82       /vice/vol/maxgroupid
83              is used to assign a volume id to the replicated volume
84
85

AUTHOR

90       Puneet Kumar, 1990, Created
91
92                                                              createvol_rep(8)