Skip to content

Commit

Permalink
Merge pull request #379 from trapexit/docs
Browse files Browse the repository at this point in the history
add info on inodes running out to faq on filled drives
  • Loading branch information
trapexit committed Mar 13, 2017
2 parents b7269e9 + cf2cb54 commit 38e5815
Showing 1 changed file with 6 additions and 2 deletions.
8 changes: 6 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -457,9 +457,13 @@ Yes. It will be represented immediately in the pool as the policies perscribe.

#### Why do I get an "out of space" error even though the system says there's lots of space left?

Please reread the sections above about policies, path preserving, and the **moveonenospc** option.
First make sure you've read the sections above about policies, path preserving, and the **moveonenospc** option.

Remember that mergerfs is simply presenting a logical merging of the contents of the pooled drives. The reported free space is the aggregate space available *not* the contiguous space available. If the writing of a file fills a drive and **moveonenospc** is disabled it will return an ENOSPC error.
Remember that mergerfs is simply presenting a logical merging of the contents of the pooled drives. The reported free space is the aggregate space available **not** the contiguous space available. MergerFS does not split files across drives. If the writing of a file fills a drive and **moveonenospc** is disabled it will return an ENOSPC error.

If **moveonenospc** is enabled but there exists no drives with enough space for the file and the data to be written (or the drive happened to fill up as the file was being moved) it will error indicating there isn't enough space.

It is also possible that the filesystem selected has run out of inodes. Use `df -i` to list the total and available inodes per filesystem. In the future it might be worth considering the number of inodes available when making placement decisions in order to minimize this situation.

#### Can mergerfs mounts be exported over NFS?

Expand Down

0 comments on commit 38e5815

Please sign in to comment.