gentoo-overlay/app-crypt/cfs/files

-*- mode: outline -*-



* Configuration on Gentoo



Before starting CFS, you will need to setup NFS.



Add an export line to your /etc/exports configuration.  Such that an

empty directory with no permissions is exported to localhost with

read/write access.  This directory is known as the "null export"

directory.  Portage has installed such a directory for you at

/var/lib/cfs/.cfsfs, thus your /etc/exports line would look like this:



    /var/lib/cfs/.cfsfs localhost(rw,sync)



Add an entry to /etc/fstab which mounts the null export share to the

"crypt root" mount point.  By default, Portage has installed such a

mount point for you at /var/cfs, thus your /etc/fstab entry will look

like this:



    localhost:/var/lib/cfs/.cfsfs  /var/cfs  nfs  port=3049,intr,nfsvers=2 0 0



At this point, you may restart NFS:



    /etc/init.d/nfs restart

    /etc/init.d/nfsmount restart



Alternatively you can run the following commands:



    exportfs -rv

    mount -oport=3049,intr,nfsvers=2 localhost:/var/lib/cfs/.cfsfs /var/cfs



Finally, start the CFS daemon:



    /etc/init.d/cfs start



* Differences between the Gentoo port and Debian port



Differences in the Gentoo port include:



    - No automatic manipulation of user configuration files such as

      /etc/exports or /etc/fstab.  It is the user's responsibility to

      update those files.



    - cfs_*mount.sh included in Debian are not used.  The user must

      manually add entries to /etc/fstab however the Gentoo RC system

      will take care of automatically mounting/unmounting NFS and

      starting CFS in the right order.