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.

64 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. A 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 filesystems be removed from the pool without affecting them?
  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 filesystems be moved to another pool?
  18. Yes. See the previous question's answer.
  19. ## Can filesystems be part of multiple pools?
  20. Yes.
  21. ## How do I migrate data into or out of the pool when adding/removing filesystems?
  22. You don't need to. See the previous question's answer.
  23. ## How do I remove a filesystem but keep the data in the pool?
  24. Nothing special needs to be done. Remove the branch from mergerfs'
  25. config and copy (rsync) the data from the removed filesystem into the
  26. pool. The same as if it were you transfering data from one filesystem
  27. to another.
  28. If you wish to continue using the pool while performing the transfer
  29. simply create a temporary pool without the filesystem in question and
  30. then copy the data. It would probably be a good idea to set the branch
  31. to `RO` prior to doing this to ensure no new content is written to the
  32. filesystem while performing the copy.
  33. ## Can filesystems be written to directly? Outside of mergerfs while pooled?
  34. Yes, however, it's not recommended to use the same file from within the
  35. pool and from without at the same time (particularly
  36. writing). Especially if using caching of any kind (cache.files,
  37. cache.entry, cache.attr, cache.negative_entry, cache.symlinks,
  38. cache.readdir, etc.) as there could be a conflict between cached data
  39. and not.