Настройка блочного доступа по iSCSI для Linux¶

Настройка iSCSI для Linux¶

Перед началом настройки iSCSI на сервере Linux убедитесь, что созданы:

• Минимум один IP–ресурс (VIP), который будет использоваться как iSCSI–портал

• Минимум один iSCSI–таргет

• Минимум один LUN

Для настройки iSCSI на сервере Linux выполните следующие действия:

1. Подключитесь к серверу, для которого будет выполняться настройка

2. Установите пакет open–iscsi (Debian)

$ sudo apt-get update
$ sudo apt-get install open-iscsi

3. После установки пакета откройте файл /etc/iscsi/initiatorname.iscsi и скопируйте IQN инициатора

   

4. Перейдите в веб–интерфейс управления СХД АЭРОДИСК ENGINE

5. Откройте «Блочный доступ» >> «iSCSI», вкладка «Группы» и нажмите «Создать группу»

   

6. В открывшемся окне задайте имя группы, выберите таргет и укажите IQN инициатора (из /etc/iscsi/initiatorname.iscsi), затем нажмите «Подтвердить»

   

7. Перейдите на вкладку «Маппинг» и нажмите «Создать маппинг»

   

8. В окне создания маппинга выберите созданную группу и нужный логический том (LUN), затем подтвердите создание

   

9. Выполните обнаружение iSCSI-таргета через iSCSI-портал

sudo iscsiadm -m discovery -t st -p <VIP_IP>:3260

После успешного выполнения discovery open–iscsi создаст служебные каталоги в /etc/iscsi:

• nodes – записи для обнаруженных узлов (подкаталоги для каждого IQN)

• send_targets – данные, полученные через SendTargets (подкаталоги для каждой цели/портала)

10. Для подключения LUN выполните логин к таргету

sudo iscsiadm -m node -T <IQN_TARGET> -l

11. Убедитесь, что новое блочное устройство появилось в системе

Настройка iSCSI завершена.

Отключение iSCSI и удаление записей¶

Перед отключением iSCSI убедитесь, что файловые системы на LUN размонтированы и том не используется приложениями.

1. Проверьте активные iSCSI-сессии и найдите нужный таргет (IQN) и портал:

   sudo iscsiadm -m session
   

   

2. Выполните logout (рекомендуется указывать конкретный портал)

   sudo iscsiadm -m node -T <IQN_TARGET> -p <PORTAL_IP>:3260 -u
   

   

3. Удалите node–запись, чтобы инициатор не пытался подключаться автоматически и чтобы очистить конфигурацию таргета

   sudo iscsiadm -m node -T <IQN_TARGET> -p <PORTAL_IP>:3260 -o delete
   

   

4. Проверьте, что сессий и записей не осталось

   sudo iscsiadm -m session
   sudo iscsiadm -m node
   

   

Автоподключение после перезагрузки¶

По умолчанию многие узлы iSCSI сохраняются с параметром node.startup = manual, из‑за чего после перезагрузки системы iSCSI–сессии не поднимаются автоматически и требуется ручное подключение.

Чтобы включить автологин для нужного таргета (IQN), установите node.startup = automatic для каждой записи таргет+портал (если у таргета несколько порталов – повторите команду для каждого)

1. Включить автологин для таргета

   sudo iscsiadm -m node -T <IQN_TARGET> -p <IP_PORTAL>:3260 --op=update -n node.startup -v automatic
   

   

2. Проверьте текущее значение

   sudo iscsiadm -m node -T <IQN_TARGET> -p <IP_PORTAL>:3260 -o show | grep -E 'node.startup'
   

   

3. Включите службы iSCSI в автозапуск и проверьте статус

   Для автологина при старте системы должны быть включены сервисы iscsid и open–iscsi.

   sudo systemctl enable iscsid
   sudo systemctl enable open-iscsi
   sudo systemctl is-enabled iscsid open-iscsi
   

   

4. Перезагрузите сервер и проверьте, что сессии поднялись автоматически

   sudo reboot
   sudo iscsiadm -m session
   

   

CHAP–аутентификация¶

Если на iSCSI–таргете включена CHAP–аутентификация, задайте параметры CHAP на Linux–сервере до выполнения discovery.

В open–iscsi параметры CHAP можно задать глобально в /etc/iscsi/iscsid.conf (будут применяться по умолчанию), либо точечно для конкретного таргета через iscsiadm -m node --op update

$ sudo iscsiadm -m node -T <IQN_TARGET> -p <PORTAL_IP>:3260 --op update -n node.session.auth.authmethod -v CHAP
sudo iscsiadm -m node -T <IQN_TARGET> -p <PORTAL_IP>:3260 --op update -n node.session.auth.username -v <CHAP_USERNAME>
sudo iscsiadm -m node -T <IQN_TARGET> -p <PORTAL_IP>:3260 --op update -n node.session.auth.password -v <CHAP_PASSWORD>

echo hello

Multipath¶

Multipath повышает отказоустойчивость доступа к LUN: если один из путей ввода‑вывода (кабель, коммутатор, сетевой интерфейс или порт контроллера) становится недоступен, multipath автоматически переключает операции ввода‑вывода, на альтернативный путь, и работа с томом продолжается.

sudo apt-get update
sudo apt-get install multipath-tools

Дополнительные настройки для iSCSI¶

Если при переключении групп RDG и DDP логический том перестал отображаться в системе или начал работать некорректно, можно попробовать применить одну из следующий рекомендаций.

Если инициатор работает с СХД только по iSCSI и другие логические тома с СХД (не AERODISK) подключены без мультипасинга, нужно просто удалить пакет мультипасинга из системы.

Прописать в /etc/multipath.conf в секции defaults два параметра:

• dev_loss_tmo 120;

• fast_io_fail_tmo 120.

Указать конкретные параметры в /etc/multipath.conf для iSCSI томов с СХД AERODISK. В примере для тома - DG01-LUN01 с wwid – 23635376233356466.

defaults {
    user_friendly_names no
    find_multipaths yes
}

blacklist {
    devnode "^sd*"
}

blacklist_exceptions {
    devnode "sd[e-z]*"
    wwid "23635376233356466"
}

devices {
    device {
        vendor "AERODISK"
        product "DG01-LUN01"
        no_path_retry queue
        dev_loss_tmo 120
        fast_io_fail_tmo 120
    }
}

После этого в файле /etc/multipath/wwids указать ID тома – /23635376233356466/

Если wwid у логического тома нет (проверить можно, выполнив udevadm info /dev/sdX, где Х – имя тома), то нужно дополнительно сделать правило для udev:

ACTION=="add", KERNEL=="sd*" PROGRAM="scsi_id -g -v -d $env{DEVNAME} -p 0x83" ENV{ID_WWN}="0x%c"

После этого логический том нужно монтировать как /dev/mapper/23635376233356466