diff --git a/docs/faq.rst b/docs/faq.rst index d592e88380c..60d4e32f04b 100644 --- a/docs/faq.rst +++ b/docs/faq.rst @@ -109,3 +109,13 @@ for dealing with the time boundary filtering mentioned above. But what happens with filtering when dealing with slices coming from different tables or databases? If the column name is shared, the filter will be applied, it's as simple as that. + +Why does fabmanager or superset freezed/hung/not responding when started (my home directory is NFS mounted)? +----------------------------------------------------------------------------------------- +superset creates and uses an sqlite database at ``~/.superset/superset.db``. Sqlite is known to `don't work well if used on NFS`__ due to broken file locking implementation on NFS. + +__ https://www.sqlite.org/lockingv3.html + +One work around is to create a symlink from ~/.superset to a directory located on a non-NFS partition. + +Another work around is to change where superset stores the sqlite database by adding ``SQLALCHEMY_DATABASE_URI = 'sqlite:////new/localtion/superset.db'`` in superset_config.py (create the file if needed), then adding the directory where superset_config.py lives to PYTHONPATH environment variable (e.g. ``export PYTHONPATH=/opt/logs/sandbox/airbnb/``).