mirrors/ceph-csi
1
0
Fork 0
mirror of https://github.com/ceph/ceph-csi.git synced 2024-11-26 16:20:28 +00:00
Code Issues Packages Projects Releases Wiki Activity

doc: update the rbd-nbd doc with log strategies options

Browse Source 
Signed-off-by: Prasanna Kumar Kalever <prasanna.kalever@redhat.com>
This commit is contained in:
Prasanna Kumar Kalever 2021-09-02 00:42:00 +05:30 committed by mergify[bot]
parent c9cc36d8db
commit 22bb31df19
1 changed files with 27 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
docs/rbd-nbd.md
View File

@ -31,16 +31,26 @@ in the StorageClass.
### Configuring logging path ### Configuring logging path
If you are using the default rbd nodeplugin daemonset and StorageClass If you are using the default rbd nodePlugin DaemonSet and StorageClass
templates then `cephLogDir` will be `/var/log/ceph`, this directory will be templates then `cephLogDir` will be `/var/log/ceph`, this directory will be
a host-path and the default log file path will be a host-path and the default log file path will be
`/var/log/ceph/rbd-nbd-<volID>.log`. rbd-nbd creates a log file per volume `/var/log/ceph/rbd-nbd-<volID>.log`. rbd-nbd creates a log file per volume
under the `cephLogDir` path on NodeStage(map) and removed the same on under the `cephLogDir` path on NodeStage(map) and removed the same on
the respective NodeUnstage(unmap). the respective NodeUnstage(unmap).
In case if you need a customized log path, you should do below: - There are different strategies to maintain the logs
- `remove`: delete log file on unmap/detach (default behaviour)
- `compress`: compress the log file to gzip on unmap/detach, in case there
exists a `.gz` file from previous map/unmap of the same volume, then
override the previous log with new log.
- `preserve`: preserve the log file in text format
- Edit the daemonset templates to change the ceph log directory host-path You can tweak the log strategies through `cephLogStrategy` option from the
storageclass yaml
- In case if you need a customized log path, you should do below:
- Edit the DaemonSet templates to change the ceph log directory host-path
- If you are using helm charts, then you can use key `cephLogDirHostPath` - If you are using helm charts, then you can use key `cephLogDirHostPath`
``` ```
@ -61,8 +71,8 @@ In case if you need a customized log path, you should do below:
- On uninstall make sure to delete `cephLogDir` on host manually to freeup - On uninstall make sure to delete `cephLogDir` on host manually to freeup
some space just in case if there are any uncleaned log files. some space just in case if there are any uncleaned log files.
- In case if you do not need the rbd-nbd logging to persistent, then just - In case if you do not need the rbd-nbd logging to persistent at all, then
update the StorageClass for `cephLogDir` to use a non-persistent path. simply update the StorageClass for `cephLogDir` to use a non-persistent path.
## Status ## Status