README

                      mysqlfs - MySQL FileSystem

$Id: README 55 2009-07-12 22:23:33Z chickenandporn $

MySQLfs is a FUSE filesystem driver which stores files in a MySQL database.

* Requirements

  - mysql-client libraries 5.0 or later
  - mysql-server 5.0 or later
  - fuse 2.5 or later
  - autotools 

* Build

  If compiling from version-control, use "autoreconf -vfi" first.

  For both version-control and tarball version run:
  $ ./configure
  $ make

* Usage

1. Create database and account
   mysql> CREATE DATABASE mysqlfs;
   mysql> GRANT SELECT, INSERT, UPDATE, DELETE ON mysqlfs.* TO mysqlfs@"%" IDENTIFIED BY 'password';
   mysql> FLUSH PRIVILEGES;

   (note FAQ: Errors #1 "Access Denied For User" below)

2. Create tables
   $ mysql -uroot -p mysqlfs < schema.sql

   (note FAQ: Errors #2 "Can't Create/Write to File" below)

3. Mount database as a filesystem
   $ mkdir fs
   $ ./mysqlfs -ohost=localhost -ouser=user -opassword=pass -odatabase=mysqlfs fs

4. Instead of setting connection options on the command line
   you may create a [mysqlfs] section in your ~/.my.cnf file and
   set the parameters there.

* Options

  -ohost=<hostname>
    MySQL server host

  -ouser=<username>
    MySQL username

  -opassword=<password>
    MySQL password

  -odatabase=<db>
    MySQL database name

* FAQ: ERRORS

1. Access Denied For User 'mysql'@'localhost'

   ie: (using the example GRANT above) 
   $ ./mysqlfs -ohost=localhost -ouser=mysqlfs -opassword=password -odatabase=mysqlfs fs

   2009-06-14 00:59:29 89956 ERROR: mysql_real_connect(): Access denied for user 'mysqlfs'@'localhost' (using password: YES)
   2009-06-14 00:59:29 89956 ERROR: mysql_real_connect(): Access denied for user 'mysqlfs'@'localhost' (using password: YES)
   2009-06-14 00:59:29 89956 Failed to connect MySQL server.
   2009-06-14 00:59:29 89956 Error: pool_init() failed

   MySQL is sticky sometimes with access; on MacOSX, I had to specifically allow localhost:

   mysql> GRANT SELECT, INSERT, UPDATE, DELETE ON mysqlfs.* TO mysqlfs@"localhost" IDENTIFIED BY 'password';

   $ sudo /usr/local/mysql/bin/mysqladmin reload

   Remember, also, that 'localhost' and '127.0.0.1' may appear differently.  Check also your /etc/hosts entry, some
   systems define 127.0.0.1 as their uname() which causes problems doing PTRs against it, expecting 'localhost'
   but getting 'myhostname'


2. Can't Create/Write to File (while building database)

   ie: (using the "Create tables" step #2 above)
   $ sudo /usr/local/mysql/bin/mysql mysqlfs < schema.sql
   ERROR 1 (HY000) at line 23: Can't create/write to file '/usr/local/mysql/data/mysqlfs/data_blocks.MYI' (Errcode: 13)

   On MacOSX with http://dev.mysql.com/get/Downloads/MySQL-5.1/mysql-5.1.35-osx10.5-x86.dmg ,
   rather than "CREATE DATABASE mysqlfs", I had to use:

   $ sudo /usr/local/mysql/bin/mysqladmin create mysqlfs && sudo chown _mysql /usr/local/mysql/data/mysqlfs

   The grant/flush commands worked fine after that.  In my usage, I'm "sudo" which can affect the output, so the
   error might have been mine alone.  I'm commenting here in case someone else sees it.


Copyright (C) 2006 Tsukasa Hamano <code@cuspy.org>
Copyright (C) 2006 Michal Ludvig <michal@logix.cz>