Milko ($Id: README,v 1.14 1999/07/14 20:51:23 assar Exp $)
=====

* Parts

  fs		- FileServer
  vldb		- Volume Location DataBase-server
  pts		- ProTection-Server
  appl/sked	- maintaining volumes the hard way

  lib/dpart     - partition parsing and handling
  lib/mdir	- directory handling (unused ?)
  lib/svol	- simple (stupid) volume
  lib/vld	- volume,voldb<->afs interfrace
  lib/voldb	- file and directory vnode db
  lib/vstatus	- the volume-node

* Installation

 1. Create a /vicepa in whatever way

 2. If you have kerberos.

    This text assumes kth-krb.

    Get a srvtab for afs@YOUR.REALM, or if you want to use a "subcell"
    use afs.your.subcell@YOUR.REALM, where your.subcell is the instance.
    Put the srvtab i $PREFIX/etc/srvtab (really $sysconfdir).

    datan:~$ /usr/athena/sbin/ksrvutil -p lha.admin -f /usr/arla/etc/srvtab get
    Name [rcmd]: afs
    Instance [datan]: ''
    Realm [MY.REALM]: 
    Is this correct? (y,n) [y]:
    Add more keys (y,n) [n]:
    Password for lha.admin@MY.REALM:
    Added afs@MY.REALM
    Old keyfile in /usr/arla/etc/srvtab.old.

    Add your "afs admin instance" to the $PREFIX/etc/superuserlist
    file. This can be whatever you like, but has been in most cases
    .admin (or .root depending on local religion).

    Get you "afs admin instance".

    datan:~$ kauth lha.root
    lha.root@MY.REALM's Password:

 3. CellServDB and ThisCell

    Add you cell to $PREFIX/etc/CellServDB and make it the default
    cell by adding to to $PREFIX/etc/ThisCell.

 4. Start vldb-server.

    It will create a databasefile (vl_database) if missing.
    
    datan:~/obj/arla/milko/vldb# gdb -q vldbserver
    (gdb) r
    Starting program: /home/lha/obj/milko/vldb/vldbserver
    Database not found, creating a new.
    Milko vldbserver 0.26 started

 5. Add root.afs to vldb

    You have to use arla's vos.

    datan:~$ vos createentry -id root.afs -host localhost \
    -fsserver localhost -part /vicepa -rw 3

    (vldbserver outputs junk)

 6. Create volume root.afs on disk

    datan:~obj/milko/appl/sked# ./sked volcreate /vicepa 3 root.afs
    volume 3 created successfully

 7. Start fileserver

    datan:~obj/milko/fs# gdb -q fileserver
    (gdb) r
    Starting program: /home/lha/obj/milko/fs/fileserver
    fileserver booting
    fileserver started, serving data

 8. bosserver

    After running make install you can use $PREFIX/libexec/bosserver
    to start both the vlserver and fileserver.

 9. run-tests

    Run run-tests in tests/,   WORKDIR=/afs ./run-tests -milko -all

 10. Now what ?

    Find bugs, and report them to <arla-drinkers@stacken.kth.se>.

* Profiling

  If you want profiling information, add -pg (gcc) to CFLAGS, LDFLAGS and
  recompile.

  When you feel you're done, send the fileserver a USR1 and look for the
  gprof.out in /vicepa.
