From 4fdec024de2f10053d4615db9d532f41e69068b6 Mon Sep 17 00:00:00 2001 From: Sebastian Vater Date: Mon, 27 Oct 2025 16:39:23 +0100 Subject: Fixed documentation for iSCSI rootfs with dracut in README.md. --- README.md | 8 ++++---- 1 file 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) " ``` -- cgit v1.2.3-55-g7522