MyFavMirrors/moonfire-nvr
1
0
Fork 0
mirror of https://github.com/scottlamb/moonfire-nvr.git synced 2025-04-27 05:44:44 -04:00
Code Issues Packages Projects Releases Wiki Activity

increase disk space slack recommendation

Browse Source 
As discussed in #84 and #116.
This commit is contained in:
Scott Lamb 2021-04-01 09:39:14 -07:00
parent a434b42672
commit 96255efd3e
1 changed files with 18 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
guide/install.md
View File

@ -151,13 +151,13 @@ $ nvr config 2>debug-log
In the user interface, In the user interface,
1. add your sample file dir(s) under "Directories and retention". 1. add your sample file dir(s) under "Directories and retention".
If you used a dedicated hard drive, use the directory you precreated If you used a dedicated hard drive, use the directory you precreated
(eg `/media/nvr/sample`). Otherwise, try (eg `/media/nvr/sample`). Otherwise, try
`/var/lib/moonfire-nvr/sample`. Moonfire NVR will create the directory as `/var/lib/moonfire-nvr/sample`. Moonfire NVR will create the directory as
long as it has the required permissions on the parent directory. long as it has the required permissions on the parent directory.
2. add cameras under "Cameras and streams". 2. add cameras under "Cameras and streams".
* See the [wiki](https://github.com/scottlamb/moonfire-nvr/wiki) for notes * See the [wiki](https://github.com/scottlamb/moonfire-nvr/wiki) for notes
about specific camera models. about specific camera models.
@ -182,22 +182,24 @@ In the user interface,
many cameras and when you record both the "main" and "sub" streams of many cameras and when you record both the "main" and "sub" streams of
each camera. each camera.
3. Assign disk space to your cameras back in "Directories and retention". 3. Assign disk space to your cameras back in "Directories and retention".
Leave a little slack (at least 100 MB per camera) between the total limit Leave a little slack between the total limit and the filesystem capacity,
and the filesystem capacity, even if you store nothing else on the disk. even if you store nothing else on the disk. 1 GiB per camera should be
There are several reasons this is needed: plenty. This is needed for a few reasons:
* The limit currently controls fully-written files only. There will be up * Up to `max(120, flush_if_sec)` seconds of video can be written before
to two minutes of video per camera of additional video. being counted toward the usage because the recording doesn't count until
* The rotation happens after the limit is exceeded, not proactively. it's fully written, and old recordings can't be deleted until the
* Moonfire NVR currently doesn't account for the unused space in the final next database flush. So a 8 Mbps video stream with `flush_if_sec=300`
filesystem block at the end of each file. will take up to (8 Mbps * 300 sec / 8 bits/byte) = 300 MB ~= 286 MiB
* Moonfire NVR doesn't account for the space used for directory listings. of extra disk space.
* If a file is open when it is deleted (such as if a HTTP client is * If a file is open when it is deleted (such as if a HTTP client is
downloading it), it stays around until the file is closed. Moonfire NVR downloading it), it stays around until the file is closed. Moonfire NVR
currently doesn't account for this. currently doesn't account for this.
* Smaller factors: deletion isn't instantaneous, and directories
themselves take up some disk space.
4. Add a user for yourself (and optionally others) under "Users". You'll need 4. Add a user for yourself (and optionally others) under "Users". You'll need
this to access the web UI once you enable authentication. this to access the web UI once you enable authentication.
## Starting it up ## Starting it up