1bldvldb.sh(8)               System Manager's Manual              bldvldb.sh(8)
2
3
4

NAME

6       bldvldb.sh - build a new Volume Location Data Base (VLDB)
7
8

SYNOPSIS

10       bldvldb.sh
11

DESCRIPTION

13       bldvldb.sh  builds  a  new volume location data base VLDB.  It uses the
14       /vice/db/hosts file to get a list of servers to  use  to  retrieve  the
15       current  list  of  volumes.   It  gets the list from the /vice/vol/Vol‐
16       umeList  file  on   each   server.    It   combines   the   list   into
17       /vice/vol/BigVolumeList  and passes the combined list as a parameter to
18       the volutil makevldb command.  This command  produces  a  new  VLDB  in
19       /vice/db  and updates the files AllVolumes and partitions in /vice/vol.
20       You must have root priveledges to run this command.
21

DIAGNOSTICS

23       This command can only be issued on the System  Control  Machine  (SCM).
24       Bldvldb  uses two mechanisms to get the VolumeList files from the vari‐
25       ous servers in /vice/db/hosts. The first is ftp. In order for  this  to
26       succeed,  there  has  to  be  a  file  called ".anonr" in the directory
27       /vice/vol, which is globally readable and contains a line with the word
28       "VolumeList" in it. If bldvldb.sh is unable to get the file via ftp, it
29       will attempt to use the CMU RFS remote file system. If  neither  mecha‐
30       nism  works, bldvldb.sh will skip over that servers volumes when build‐
31       ing the VLDB.  The databases are propagated via  the  update  protocol.
32       This  takes up to five minutes.  Attempts to access a new volume from a
33       client, prior to the propagation of all the databases to  all  servers,
34       may fail.
35

FILES

37       /vice/vol/AllVolumes
38              is created
39
40
41
42       /vice/db/VLDB
43              is created
44
45
46
47       /vice/vol/VolumeList
48              on each server is used to build the VLDB
49
50
51
52       /vice/db/hosts
53              is a list of the active servers
54
55
56
57       /vice/vol/BigVolumeList
58              is the result of combining /vice/vol/VolumeList from each server
59
60

SEE ALSO

62       update (8), volutil (8)
63

AUTHOR

65       Puneet Kumar, 1990, Created
66
67                                                                 bldvldb.sh(8)