3 fsconfig \- configuring a file server
59 file server's configuration has not been set,
60 or by explicit request early in the server's initialization (see
62 the server enters `config mode'. The commands described here
63 apply only in that mode. They establish configuration constants
64 that are typically valid for the life of the server, and therefore
65 need be run only once. If the non-volatile RAM on the server
66 gets erased, it will be necessary to recreate the configuration.
70 is an IP address in the form
74 is a text string without white space.
80 Defines a SCSI disk on target (unit) id
82 controller (host adapter)
84 and LUN (logical unit number)
86 A single number specifies a target, while two numbers specify
88 with the missing numbers defaulting to zero.
89 Any one of the numbers may be replaced by
91 to represent the values
101 is the concatenation of SCSI targets 1 through 4.
107 but for IDE or ATA disks,
108 and the controllers must be specified in
115 Instead of specifying
122 and specify a target of
123 .IB controller-number *2
130 (second IDE controller, master drive).
136 but for SATA drives connected to Marvell
137 88SX[56]0[48][01] controllers.
138 There is no need to specify the controllers in
140 as they are autodiscovered.
141 Hot-swapping drives is not currently supported.
142 Similar target naming rules apply as for IDE controllers.
143 However the controller-number is multiplied by the number of
144 drives the controller supports rather than 2.
149 (second controller, second drive),
150 if the first controller supports 8 drives.
157 but leaving a single block at the beginning for a label
162 is really of interest,
163 and refers to a side of a WORM disc.
164 These are only really relevant when used as
171 A pseudo-device formed from the concatenation of the
173 in the list. The devices are
175 blank- or comma-separated.
178 A pseudo-device formed from the block-wise interleaving of the
180 in the list. The size of the result is the number of devices times
181 the size of the smallest device.
184 A pseudo-device formed from the mirroring of the first
186 in the list onto all the others.
187 The size of the result is the size of the smallest device.
188 One might think of this as RAID 1,
193 though neither includes any fancy recovery mechanisms.
194 Each block is written to all the devices,
195 starting with the rightmost in the list and working leftward.
196 A block is read from the first device that provides it without error,
197 starting with the leftmost in the list and working rightward.
199 .BI p device . n1 . n2
200 A partition starting at
202 from the beginning of
206 of the size of the device.
209 if it contains periods.
212 A pseudo-device that contains the byte-swapped contents of
214 Since the file server writes integers to disk in its native byte order,
215 it can be necessary to use this device to read file systems written
216 by processors of the other byte order.
218 .BR j (\f2device1\ device2\f1...)\f2device3
220 is the SCSI juke box interface.
223 are the SCSI drives in the jukebox and
225 represents the demountable platters in the juke box.
228 A pseudo-WORM disk: blocks on
230 can be written only once and may not be read unless written.
233 A cached WORM. The first
235 is the cache, the second the WORM.
238 (Letter o) The read-only (dump) file system
239 of the most-recently defined cached WORM file system.
243 command sets the textual name of the server as known in
244 the network databases.
246 The configuration information is stored in block zero on a
247 device whose device string is written in non-volatile RAM.
252 commands identify the
254 on which the information is recorded.
257 command also erases any previous configuration.
261 command configures a file system on
266 is used as the specifier in
268 messages to connect to that file system.
271 is the one attached to if the specifier is null; see
274 The rest of the configuration commands record IP addresses:
275 the file server's address
279 the local authentication server's
281 the local subnet mask
283 and the address of a system running an SNTP server
287 If the server has more than one network interface,
288 a digit may be appended to the keywords
293 to indicate the interface number;
295 .SS "One-time actions"
299 command initializes the named file system. It overwrites
300 any previous file system on the same device
301 and creates an empty root directory
307 the file server, until the next reboot,
313 that change the owner and group of files,
314 to enable initializing a fresh file system from a
322 must be a cached WORM.
324 clears the associated magnetic cache and initializes the file
325 system, effectively resetting its contents to the last dump.
328 turns off all permission checking; use with caution.
331 disables all writing to all devices.
332 This is useful for trying dangerous experiments.
335 disables authentication.
341 will copy a file system named
347 It knows how to read a fake worm file system.
358 will cause the server to
362 The various configuration commands only record what to do; they write
363 no data to disk. The command
365 exits config mode and begins running the file server proper.
366 The server will then perform whatever I/O is required to establish
369 Initialize a file server
371 with a single file system interleaved between SCSI targets 3 and 4.
380 Initialize a file server
382 with a single disk on target 0 partitioned as a cached pseudo-WORM
383 file system with the cache on the third quarter of the drive
384 and the pseudo-WORM on the interleave of the first, second, and
390 filsys main cp(w0)50.25f[p(w0)0.25p(w0)25.25p(w0)75.25]
395 A complete and complex example:
396 initialize a file server
398 with a single SCSI disk on target 0 for a scratch file system,
399 a cached WORM file system with cache disk on target 2 and
400 an optical-disc jukebox on targets 4 (robotics) and 5 (one optical drive),
401 and another cached WORM file system with cache disk on target 3
402 and another optical-disc jukebox on a second SCSI bus at targets 3 and 4.
403 Both jukeboxes contain 16 slots of optical discs.
404 It has two Ethernet interfaces and can reach an SNTP server on the first one.
409 filsys main cw2j(w4w5)(l<0-31>)
411 filsys hp40fx cw3j(w1.<3-4>.0)(l<0-31>)
428 .BR /sys/src/fs/port/config.c
431 ``The Plan 9 File Server''.