1vice-setup(8) System Manager's Manual vice-setup(8)
2
6 vice-setup - setup a Coda server
7
10 Vice-setup
11
13 Vice-setup is the user front-end to a family of scripts designed to
14 setup a Coda server based on question-answer responses. This avoids an
15 otherwise tedious and error-prone-manual method. The most critical
16 question asked for the vice-setup family of scripts to work properly
17 is:
18 Is this the master server, aka the SCM machine? (y/n)
20 Answering ``yes'' to this question causes the following sequence of
23 scripts to be called from within vice-setup:
24 · vice-setup-scm
26 · vice-setup-user
28 · vice-setup-rvm
30 · vice-setup-srvdir
32 where as answering ``no'' causes only the following scripts to run from
34 vice-setup:
35 · vice-setup-rvm
37 · vice-setup-srvdir
39
41 Vice-setup
42 is designed to be called directly by the administrator to setup
43 a server. It performs the following tasks common to both SCM and
44 non-SCM servers:
45 · Creates the directories, /vice,/vice/{backup,db,srv,vol}
48 and, /vice/vol/remote if they do not already exist.
49 · Creates and sets up the authentication files needed for
51 interserver and interclient communication.
52 · Creates and sets up, /vice/db/files, which are a set of
54 common Coda files distributed from the SCM via, update‐
55 clnt, and updatesrv.
56 · Adds Coda port numbers to, /etc/services if not already
58 present.
59 · Sets up the Coda server to start at system startup if so
61 indicated.
62 · Records the hostname in, /vice/hostname.
64 Vice-setup-scm
67 This script is only run if ``yes'' is given as an answer to the
68 SCM question.
69 · Prompts for a Coda server ID in the range of 0-255, and
72 creates the file, /vice/db/servers, with this informa‐
73 tion.
74 · Creates, /vice/db/scm, with the hostname of the SCM
76 machine being setup.
77 · Creates, /vice/db/VSGDB, with the root volume number
79 ``E0000100''.
80 · Prompts for the name of the root volume and stores this
82 information in, /vice/db/ROOTVOLUME.
83 Vice-setup-user
86 This script is only run by, vice-setup, when the machine is des‐
87 ignated as the SCM.
88 · This sets up the System:Administrator group and Coda user
90 ``admin'' then initializes, /vice/db/vice.pdb.
91 · Creates, /vice/db/passwd.coda, needed to setup the ini‐
93 tial password system.
94 · Creates, /vice/db/auth.pw.
96 Vice-setup-rvm
98 · Prompts for the RVM_LOG device.
100 · Prompts for the size of the RVM_LOG device.
102 · Prompts for the RVM_DATA device.
104 · Prompts for the RVM_DATA size based on default values.
106 These values must be typed exactly right to be accepted.
107 For example, 22M must be typed exactly as, "22M".
108 · Initializes the RVM_LOG and RVM_DATA devices based on the
110 values given for RVM initialization.
111 · Creates, /vice/srv.conf, with the values given for RVM.
113 Vice-setup-srvdir
115 This script sets up the data storage area for a Coda service.
116 · Prompts for the location a data storage area (default is,
118 /vicepa).
119 · Creates the empty file, /vicepa/FTREEDB, which must exist
121 in order for, makeftree, to function.
122 · Creates, /vice/db/vicetab.
124 · Initializes the data storage area with, makeftree.
126 For a detailed explanation of each question asked by the scripts,
129 please see the chapter, ``Installing a Coda Server'' in the Coda Man‐
130 ual.
131
133 Many of the highlights are:
134 · Vice-setup-scm: does not actually create the ROOTVOLUME it
136 prompts for. It only sets up the accounting files that point
137 the server(s) to the root volume. The actual volume must be
138 created after the server is started for the first time with,
139 createvol_rep.
140 · Vice-setup-rvm: will not warn you if run a second time after
142 setting up an otherwise working server. This essentially causes
143 all data stored on the Coda server in question to be wiped out.
144 · Vice-setup-user: there is no flexibility in setting up an admin‐
146 istrative user called anything other than ``admin''.
147 · Vice-setup-user: there is a security hole in, initpw, that could
149 allow unauthorized Coda ``admin'' access and/or denial of ser‐
150 vice if an unauthorized user gains root access to the SCM.
151 · Vice-setup-user: a user ``admin'' with a uid of 500 must exist
153 on each client that needs to have admin access to Coda. There
154 is no practical way to test for this. The hardcoding of uid 500
155 may cause additional trouble at some sites.
156 · Vice-setup-rvm: will add entries to, /vice/srv.conf, each time
158 it is run without removing the previous contents. If more than
159 one line of server information is present in, srv.conf, a ``mul‐
160 tiple instance error'' is returned by, srv, because multiple
161 lines in, srv.conf, are treated as a single set of command line
162 arguments to srv. Essentially, the resulting error is made suf‐
163 ficiently out of context and is difficult to detect.
164 · Vice-setup: does not determine the host IP address.
166 · Error messages returned by the scripts or the programs called
168 from within the scripts do not jump out and bark at you.
169 Instead, errors are easily missed while running the scripts and
170 these errors tend to come back and bite you later.
171 · If a non-SCM server is being setup, you still must respond with
173 tokens to, vice-setup, when asked. However, the response must
174 be identical to the SCM or the ticket files must be copied from
175 the SCM manually for interserver communication to work cor‐
176 rectly.
177 · auth2, updateclnt and updatesrv must be started manually on a
179 non-SCM to suck down the real versions of these files from the
180 actual SCM. This error in logic can be misleading.
181 · On non-SCM Servers, the following files on the SCM must be
183 edited or copied from the SCM manually before running: vice-set‐
184 up:
185 /vice/db/services
187 /vice/db/hosts
189 to complete the setup of a non-SCM server.
191
194 /vice/db/vicetab: the Vice Table Configuration file for srv.
195 /vice/vol/VolumeList: volumeList of the server.
197 /vice/db/scm: the SCM hostname.
199 /vice/hostname: the host's hostname.
201 /vice/srv.conf: the srv configuration file.
203 /vice/db/services
205 /vice/db/ROOTVOLUME
207 /vice/db/VSGDB
209 /vice/db/vice.pfc
211 /vice/db/vice.pdb
213 And many more files are touched by these scripts than are listed here.
215
217 srv (8), rvmutl (8), rdsinit (8), auth2 (8), authmom (8), updatemon
218 (8), updatesrv (8), updateclnt (8), startserver (8), srv.conf (8), cre‐
219 atevol_rep (8), pwd2pdb (8), initpw (8), makeftree (8), vicetab (5)
220 Coda Manual: ``Installing A Coda Server''
222 The RVM Manual
224
226 Henry M. Pierce, 1998, created
227 vice-setup(8)