summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorSebastian Vater2025-10-27 16:39:23 +0100
committerSebastian Vater2025-10-27 16:39:23 +0100
commit4fdec024de2f10053d4615db9d532f41e69068b6 (patch)
tree4e47fa15fce3f31d3ecd5eeaf1d258b8eb42c516
parentAdded documentation for iSCSI rootfs with dracut in README.md. (diff)
downloaddnbd3-4fdec024de2f10053d4615db9d532f41e69068b6.tar.gz
dnbd3-4fdec024de2f10053d4615db9d532f41e69068b6.tar.xz
dnbd3-4fdec024de2f10053d4615db9d532f41e69068b6.zip
Fixed documentation for iSCSI rootfs with dracut in README.md.
-rw-r--r--README.md8
1 files changed, 4 insertions, 4 deletions
diff --git a/README.md b/README.md
index 7ccbe14..fe829b8 100644
--- a/README.md
+++ b/README.md
@@ -699,13 +699,13 @@ apt-get install dracut \
Since the _iSCSI_ server now supports discovery, no `dracut` scripts have to be adapted. However, at least with _Ubuntu_, the _initramfs_ requires additional runtime binaries and scripts in order to work, therefore the missing files have to be added via `dracut` configuration files in `/etc/dracut.conf.d`. In order to add all missing files for _open-iscsi_, create a file named `iscsi.conf` in the previously mentioned directory:
-```ini
+```shell
add_dracutmodules+=" iscsi network "
install_items+=" $(find /etc/iscsi /usr/lib/open-iscsi | while read -r FILE; do echo -n "$FILE "; done) "
hostonly="no"
```
-`open-iscsi` has its own configuration in `/etc/iscsi` and in order to work properly with _initramfs_, at least the files `initiatorname.iscsi` and `iscsid.conf`, as well as an empty directory `nodes` have to be integrated into _initramfs_. The default content of those two files is sufficient but it is strongly recommended to at least change the _iSCSI_ initiator _IQN_ name in `initiatorname.iscsi`. If manual _target nodes_ have to be added, do so before updating the _initramfs_, so the required directories and files in `/etc/iscsi` get added as well.
+`open-iscsi` has its own configuration in `/etc/iscsi` and in order to work properly with _initramfs_, at least the files `initiatorname.iscsi` and `iscsid.conf`, as well as an empty directory `nodes` have to be integrated into _initramfs_. The default contents of those two files is sufficient but it is strongly recommended to at least change the _iSCSI_ initiator _IQN_ name in `initiatorname.iscsi`. If manual _target nodes_ have to be added, do so before updating the _initramfs_, so the required directories and files in `/etc/iscsi` get added as well.
Since _iSCSI_ discovery currently only shows currently logged in public _DNBD3_ images, a login into the image used for _rootfs_ should be automatically done on startup, which can be achieved with:
```shell
@@ -716,13 +716,13 @@ This ensures that a login occurs before the actual _iSCSI_ discovery occurs.
Since _DNBD3_ does not have write support, the rootfs needs an `overlayfs` which can be added using the `dracut` builtin plugin `overlay-root`. To do so, create a file `overlay-root.conf` in `/etc/dracut.conf.d` with the following contents:
-```ini
+```shell
add_dracutmodules+=" overlay-root "
```
Last, but not least, `multipath` has to be added to `dracut`, which is done by creating `multipath.conf` in `/etc/dracut.conf.d`, containing:
-```ini
+```shell
add_dracutmodules+=" multipath "
install_items+=" $(find /etc/multipath.conf /etc/multipath /lib/multipath | while read -r FILE; do echo -n "$FILE "; done) "
```