From a02b1e9e4a9e26ab5250e57b729529b4170d5dec Mon Sep 17 00:00:00 2001 From: Samuel Walladge Date: Mon, 9 Oct 2023 11:17:09 +1030 Subject: [PATCH] Document how multiple devices must be provided osd-devices, bluestore-db, bluestore-wal, and osd-journal accept multiple devices. Note these must be strictly space separated (not newlines), due to how .split(' ') is used. Change-Id: Ic1b883b791fbd1801bbda4d9b9330117d6aea516 --- config.yaml | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/config.yaml b/config.yaml index 22908119..484d53a9 100644 --- a/config.yaml +++ b/config.yaml @@ -58,7 +58,7 @@ options: type: string default: description: | - The devices to format and set up as OSD volumes. + The devices to format and set up as OSD volumes, space separated. . These devices are the range of devices that will be checked for and used across all service units, in addition to any volumes attached @@ -84,8 +84,8 @@ options: type: string default: description: | - The device to use as a shared journal drive for all OSDs on a node. By - default a journal partition will be created on each OSD volume device for + The devices to use as shared journal drives for all OSDs on a node, space separated. + By default a journal partition will be created on each OSD volume device for use by that OSD. The default behaviour is also the fallback for the case where the specified journal device does not exist on a node. . @@ -103,7 +103,8 @@ options: type: string default: description: | - Path to a BlueStore WAL block device or file. Should only be set if using + Path to BlueStore WAL block devices or files, space separated. + Should only be set if using a separate physical device that is faster than the DB device (such as an NVDIMM or faster SSD). Otherwise BlueStore automatically maintains the WAL inside of the DB device. This block device is used as an LVM PV and @@ -113,7 +114,8 @@ options: type: string default: description: | - Path to a BlueStore WAL db block device or file. If you have a separate + Path to BlueStore WAL db block devices or files, space separated. + If you have a separate physical device faster than the block device this will store all of the filesystem metadata (RocksDB) there and also integrates the Write Ahead Log (WAL) unless a further separate bluestore-wal device is configured