"Fossies" - the Fresh Open Source Software Archive

Member "apache-zookeeper-3.8.1/zookeeper-contrib/zookeeper-contrib-zkfuse/README.txt" (25 Jan 2023, 2247 Bytes) of package /linux/misc/apache-zookeeper-3.8.1.tar.gz:

    1 Original authors of zkfuse are Swee Lim & Bartlomiej M Niechwiej of Yahoo.
    2 '
    3 ZooKeeper FUSE (File System in Userspace)
    4 =========================================
    5 
    6 Pre-requisites
    7 --------------
    8 1. Linux system with 2.6.X kernel.
    9 2. Fuse (Filesystem in Userspace) must be installed on the build node. 
   10 3. Development build libraries:
   11   a. fuse
   12   b. log4cxx
   13   c. pthread
   14   d. boost
   15 
   16 Build instructions
   17 ------------------
   18 1. cd into this directory
   19 2. autoreconf -if
   20 3. ./configure
   21 4. make
   22 5. zkfuse binary is under the src directory
   23 
   24 Testing Zkfuse
   25 --------------
   26 1. Depending on permission on /dev/fuse, you may need to sudo -u root.
   27    * If /dev/fuse has permissions 0600, then you have to run Zkfuse as root.
   28    * If /dev/fuse has permissions 0666, then you can run Zkfuse as any user.
   29 2. Create or find a mount point that you have "rwx" permission. 
   30    * e.g. mkdir -p /tmp/zkfuse
   31 3. Run Zkfuse as follows:
   32    zkfuse -z <hostspec> -m /tmp/zkfuse -d
   33    -z specifies ZooKeeper address(es) <host>:<port>
   34    -m specifies the mount point
   35    -d specifies the debug mode.
   36    For additional command line options, try "zkfuse -h".
   37 
   38 FAQ
   39 ---
   40 Q. How to fix "warning: macro `AM_PATH_CPPUNIT' not found in library"?
   41 A. * install cppunit (src or pkg) on build machine
   42 
   43 Q. Why can't Zkfuse cannot write to current directory?
   44 A. * If Zkfuse is running as root on a NFS mounted file system, it will not
   45      have root permissions because root user is mapped to another user by
   46      NFS admin.
   47    * If you run Zkfuse as root, it is a good idea to run Zkfuse from a
   48      directory that you have write access to. This will allow core files
   49      to be saved.
   50 
   51 Q. Why Zkfuse cannot mount?
   52 A. * Check that the mount point exists and you have "rwx" permissions.
   53    * Check that previous mounts have been umounted. If Zkfuse does not 
   54      exit cleanly, its mount point may have to be umounted manually. 
   55      If you cannot umount manually, make sure that there no files is open 
   56      within the mount point.
   57 
   58 Q. Why does Zkfuse complain about logging at startup?
   59 A. * Zkfuse uses log4cxx for logging. It is looking for log4cxx.properties
   60      file to obtain its logging configuration.
   61    * There is an example log4cxx.properties file in the Zkfuse source 
   62      directory.
   63