problem in ARLA FreeBSD installation instructions

[Todd A. Rannow]

We had a problem starting up arla on a FreeBSD 2.2.8 system because the
instructions in the INSTALL file are inaccurate.

For FreeBSD the INSTALL file says:

>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
FreeBSD
  
Do like in {Net|Open} except for doing the modload you can just do:

  mkdir /lkm
  cp /usr/arla/bin/xfs_mod.o /lkm/xfs_mod.o
  
And mount_xfs vill load the filesystem into the kernel.
<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

The {Net|Open} instructions referred to above are:

>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
{Net|Open}BSD:

  modload -e xfs_mod -o /var/tmp/symbols -p /usr/arla/bin/xfs_makedev
                                              /usr/arla/bin/xfs_mod.o
  mkdir /afs
  /usr/arla/bin/mount_xfs /dev/xfs0 /afs
  /usr/arla/bin/arlad
<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<

What I did to start arla:

/lkm/xfs_mod.o already existed on our FreeBSD system, so I skipped those
steps.  The instructions (above) for FreeBSD seem to say I should skip
the modload, so I skipped that step.  The next step is "mkdir /afs", and
that worked fine.  Now here comes the problem.

The next step, "/usr/arla/bin/mount_xfs /dev/xfs0 /afs", does not work 
because /dev/xfs0 does not exist.

Though the instructions say, "except for doing the modload," at this
point we decided to try it anyhow.  It worked and created the /dev/xfs0!

Then we did the remaining steps and everything worked fine.


Summary

The instructions in the INSTALL file for FreeBSD are wrong if this is a
first time start up of arla.  The modload must be done the first time
so that the /dev/xfs0 will be created.

-------------
Todd Rannow     Systems Software          email:  rannow at networkcs.com
Network Computing Services, Inc.          phone:  (612) 337-3529