← volver

iSCSI con targetcli y multipath en Linux: LUNs, CHAP y failover

Por · · [Admin-Sistemas] · lectura estimada: ~4 min

El almacenamiento bloque sobre Ethernet ha dejado de ser un recurso de laboratorio para convertirse en una pieza habitual en clústeres, hipervisores y bases de datos autoalojadas. iSCSI permite transportar comandos SCSI sobre TCP/IP y, con las herramientas correctas, ofrece un nivel de control que muchos administradores de sistemas aprecian: sesiones auditables, autenticación por CHAP y rutas redundantes que sobreviven a la caída de un switch o de una NIC. En este artículo revisamos cómo montar un target funcional con targetcli, cómo protegerlo con CHAP y cómo configurar multipath en el iniciador para obtener failover real.

Preparación del target: LUNs con targetcli

El paquete targetcli (parte de targetcli-fb o python3-rtslib según la distribución) expone una shell interactiva sobre el subsistema LIO del kernel. Antes de crear nada conviene comprobar que el módulo está cargado:

modprobe iscsi_target_mod
targetcli ls

La estructura jerárquica de LIO es clara: backstores (el origen real del dato), iscsi (el portal de red y los targets), acls (los iniciadores autorizados) y luns (la asignación concreta). Supongamos que disponemos de un volumen lógico /dev/vg_data/lv_iscsi de 200 GB y queremos exportarlo.

targetcli /backstores/block create name=disk01 dev=/dev/vg_data/lv_iscsi
targetcli /iscsi create iqn.2024-05.local.example:storage.target01
targetcli /iscsi/iqn.2024-05.local.example:storage.target01/tpg1/luns create /backstores/block/disk01
targetcli /iscsi/iqn.2024-05.local.example:storage.target01/tpg1/portals create 10.0.10.10
targetcli saveconfig

El portal debe apuntar a la IP por la que el iniciador alcanzará el target; si el servidor tiene varias interfaces, se pueden crear varios portales en el mismo TPG. La creación del portal también abre el puerto 3260/tcp, que conviene permitir explícitamente en el firewall:

firewall-cmd --permanent --add-port=3260/tcp
firewall-cmd --reload

ACLs y autenticación CHAP

Sin ACL, cualquier iniciador que descubra el target podrá intentar conectarse. Lo mínimo es declarar el IQN del cliente:

targetcli /iscsi/iqn.2024-05.local.example:storage.target01/tpg1/acls create iqn.2024-05.local.example:client01

CHAP añade una capa de autenticación por usuario y contraseña. LIO soporta CHAP unidireccional (el iniciador se autentica) y mutuo (ambos lados). Para un entorno de producción, el mutuo es preferible porque evita que un target falsificado engañe al iniciador. En el target se configura así:

targetcli /iscsi/iqn.2024-05.local.example:storage.target01/tpg1 set attribute authentication=1
targetcli /iscsi/iqn.2024-05.local.example:storage.target01/tpg1 set attribute generate_node_acls=0
targetcli /iscsi/iqn.2024-05.local.example:storage.target01/tpg1/acls/iqn.2024-05.local.example:client01 set auth userid=initiator_user
targetcli /iscsi/iqn.2024-05.local.example:storage.target01/tpg1/acls/iqn.2024-05.local.example:client01 set auth password=SecretoIniciador123
targetcli /iscsi/iqn.2024-05.local.example:storage.target01/tpg1 set auth userid=target_user
targetcli /iscsi/iqn.2024-05.local.example:storage.target01/tpg1 set auth password=SecretoTarget456

Las contraseñas CHAP deben tener entre 12 y 16 caracteres según la RFC 3720; valores más cortos son rechazados por muchos iniciadores. Además, nunca deben reutilizarse entre targets.

Iniciador: descubrimiento, login y multipath

En el cliente instalamos open-iscsi y device-mapper-multipath. El IQN del iniciador se define en /etc/iscsi/initiatorname.iscsi y debe coincidir con el de la ACL. El archivo /etc/iscsi/iscsid.conf alberga las credenciales CHAP:

node.session.auth.authmethod = CHAP
node.session.auth.username = initiator_user
node.session.auth.password = SecretoIniciador123
node.session.auth.username_in = target_user
node.session.auth.password_in = SecretoTarget456

Con dos rutas de red hacia el target (por ejemplo, 10.0.10.10 y 10.0.20.10), lanzamos el descubrimiento dos veces y hacemos login:

iscsiadm -m discovery -t sendtargets -p 10.0.10.10
iscsiadm -m discovery -t sendtargets -p 10.0.20.10
iscsiadm -m node -T iqn.2024-05.local.example:storage.target01 -l

Si todo va bien, veremos dos dispositivos /dev/sdX distintos apuntando al mismo LUN. Aquí es donde entra multipathd. Primero generamos una configuración base y activamos el servicio:

mpathconf --enable --with_multipathd y
systemctl enable --now multipathd

En /etc/multipath.conf definimos una sección defaults con la política de path grouping y el algoritmo de selección. Para failover activo/pasivo, service-time 0 o round-robin 0 son habituales:

defaults {
    user_friendly_names yes
    path_grouping_policy failover
    path_selector "service-time 0"
    path_checker tur
    failback immediate
    no_path_retry 5
}
blacklist {
    devnode "^sda$"
}

Tras recargar, multipath -ll mostrará un único dispositivo /dev/mapper/mpathX con dos paths agrupados. El detalle importante es que ambos paths pertenecen al mismo WWID; si aparecen como dispositivos separados, el target está exponiendo LUNs distintos o falta información en la ACL.

Failover y recuperación

Para probar el failover basta con bajar una interfaz:

ip link set enp1s0 down
multipath -ll

El estado del path debería pasar a failed y el tráfico seguirá por el path restante. Cuando la interfaz vuelva, failback immediate reactivará el grupo preferente. Algunos administradores prefieren failback 30 para evitar oscilaciones cuando la red es inestable.

Un error frecuente es olvidar el udev y los permisos: el dispositivo mpathX debe ser accesible por el usuario que ejecuta la aplicación (por ejemplo, oracle o postgres). Se resuelve con reglas en /etc/udev/rules.d/ o vía multipath.conf con la sección multipaths.

Consideraciones finales

iSCSI con LIO es maduro, pero exige disciplina: revisar dmesg y journalctl -u iscsid tras cada cambio, guardar la configuración con targetcli saveconfig y monitorizar /sys/class/iscsi_session ayuda a detectar timeouts. CHAP no sustituye a una VLAN dedicada ni a IPsec, pero eleva notablemente el umbral de entrada. Y multipath, bien configurado, convierte una SAN modesta en una plataforma capaz de sobrevivir a fallos de switch sin que la aplicación note más que un breve retardo.

comentarios(0)

$ dejar comentario

סHola! Soy SylonBot. Si te pierdes en el artículo, pregúntame 👋
☕ invítame a un café Si el contenido te fue útil · via PayPal