You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

53 lines
2.1 KiB

  1. # Usage and Functionality
  2. ## Can mergerfs be used with filesystems which already have data / are in use?
  3. Yes. mergerfs is really just a proxy and does **NOT** interfere with
  4. the normal form or function of the filesystems / mounts / paths it
  5. manages. It is just another userland application that is acting as a
  6. man-in-the-middle. It can't do anything that any other random piece of
  7. software can't do.
  8. mergerfs is **not** a traditional filesystem that takes control over
  9. the underlying block device. mergerfs is **not** RAID. It does **not**
  10. manipulate the data that passes through it. It does **not** shard data
  11. across filesystems. It merely shards some **behavior** and aggregates
  12. others.
  13. ## Can drives/filesystems be removed from the pool at will?
  14. Yes. See previous question's answer.
  15. ## Can mergerfs be removed without affecting the data?
  16. Yes. See the previous question's answer.
  17. ## Can drives/filesystems be moved to another pool?
  18. Yes. See the previous question's answer.
  19. ## How do I migrate data into or out of the pool when adding/removing drives/filesystems?
  20. You don't need to. See the previous question's answer.
  21. ## How do I remove a drive/filesystem but keep the data in the pool?
  22. Nothing special needs to be done. Remove the branch from mergerfs'
  23. config and copy (rsync) the data from the removed filesystem into the
  24. pool. Effectively the same as if it were you transfering data from one
  25. filesystem to another.
  26. If you wish to continue using the pool while performing the transfer
  27. simply create another, temporary pool without the filesystem in
  28. question and then copy the data. It would probably be a good idea to
  29. set the branch to `RO` prior to doing this to ensure no new content is
  30. written to the filesystem while performing the copy.
  31. ## Can filesystems be written to directly? Outside of mergerfs while pooled?
  32. Yes, however, it's not recommended to use the same file from within the
  33. pool and from without at the same time (particularly
  34. writing). Especially if using caching of any kind (cache.files,
  35. cache.entry, cache.attr, cache.negative_entry, cache.symlinks,
  36. cache.readdir, etc.) as there could be a conflict between cached data
  37. and not.