Cómo administrar grupos de iniciadores y grupos de portales

Cuándo usar este procedimiento

Cuando necesite definir quién se conecta al almacenamiento del VDC y a través de qué direcciones. Los dos grupos responden a dos preguntas distintas. Un grupo de iniciadores define "quién está autorizado": una lista de IQN de hosts y las redes desde las que se les permite conectarse. Un grupo de portales define "dónde escucha el destino": un conjunto de pares "dirección + puerto TCP" en el pool.

La diferencia se refleja tanto en el ámbito de pertenencia como en el lugar donde los grupos aparecen en la interfaz. Un grupo de iniciadores pertenece a un VDC: el administrador del VDC lo administra en la pestaña Storage. Un grupo de portales pertenece a un pool y afecta a todos los VDC de ese pool, por lo que se encuentra en la sección Unified Storage del clúster. Solo el rol Cluster master puede crear y eliminar grupos de portales. Un administrador de VDC también puede leer la composición de los grupos de portales en todos los pools del clúster.

Ambos grupos son necesarios antes de asignar el primer volumen. La asignación en sí se describe en "Conexión de volúmenes mediante iSCSI".

Requisitos previos

• La función Unified Storage está habilitada en las opciones del clúster.
• El almacenamiento del VDC está habilitado: los grupos de iniciadores residen dentro del almacenamiento.
• Para crear y eliminar grupos de portales: el rol Cluster master con los privilegios iSCSI Create Portal Group (13004) e iSCSI Delete Portal Group (13005).
• Para leer grupos de portales: los privilegios iSCSI View Portal Group (13006) e iSCSI List Portal Groups (13007); estos también se otorgan a un administrador de VDC en todo el clúster.
• Para los grupos de iniciadores: un privilegio del dominio Unified Storage con ámbito en su VDC.
• Se conocen los IQN de los hosts iniciadores y las redes desde las que se conectan.
• Versión de vStack Center: 3.0.4.

Grupos de iniciadores

Paso 1. Cree un grupo

1. Abra la tarjeta del VDC → pestaña Storage → subpestaña iSCSI.
2. Encima de la tabla Initiator Groups, haga clic en Create IG.
3. En la ventana Create Initiator Group, complete los campos:

Campo	Qué especificar
Group name	De 1 a 63 caracteres: letras latinas minúsculas, dígitos, puntos y guiones; único dentro del VDC
Allowed Initiators (IQN)	Una lista de IQN de hosts; agregue cada fila con el enlace Add; los IQN pueden tener hasta 223 caracteres
Authorized networks	Una lista de redes en notación CIDR desde las que se permiten conexiones

4. Confirme la creación.

El pool no se especifica en el formulario: se toma del almacenamiento del VDC. El grupo no tiene un estado intermedio de "creación": aparece en la tabla solo después de que el controlador lo confirma. Si el grupo está en la lista, el controlador lo conoce.

Paso 2. Consulte los grupos del VDC

La tabla Initiator Groups de la subpestaña iSCSI muestra los grupos de este VDC de forma resumida: Name, Allowed Initiators, Authorized Networks, Status. Las columnas de composición contienen recuentos: el número de iniciadores y de redes del grupo.

La página del grupo muestra la composición completa: haga clic en una fila de la tabla. La página tiene dos tablas, Allowed Initiators (IQN) y Authorized Networks, cada una con su propia paginación y su botón Add.

Paso 3. Cambie la composición del grupo

1. Abra la página del grupo.
2. Para los iniciadores: Add agrega filas; el menú de la fila ofrece Edit y Delete.
3. Para las redes: utilice las mismas acciones en la tabla Authorized Networks.
4. Para cambiar el nombre del grupo: Actions → Edit Group name.

La plataforma aplica la nueva composición completa, no una diferencia: el controlador realiza el cambio recreando el grupo con el mismo identificador. Los cambios afectan de inmediato a los volúmenes exportados a este grupo: no es necesario desasignar y volver a asignar los volúmenes.

precaución

Un grupo de iniciadores es un recurso compartido. Editar su composición afecta a todos los volúmenes asignados a este grupo, no solo al volumen desde cuya página llegó.

Si la composición no ha cambiado, no se llama al controlador: si se especifica un nombre, solo cambia el nombre. Si el controlador rechaza el paso de recreación, se conserva la composición anterior.

Paso 4. Elimine un grupo

1. En la página del grupo, abra Actions → Delete.
2. Confirme la eliminación.

No se puede eliminar un grupo asociado a un destino: la plataforma indica cuántos destinos lo están utilizando. La asociación "destino — grupo de portales — grupo de iniciadores" se crea cuando se asigna el primer volumen y a partir de entonces existe de forma independiente. El botón Unmap elimina la asignación del volumen, pero no afecta a la asociación, por lo que el grupo sigue en uso después de eliminar todas las asignaciones. Solo se libera cuando se elimina el VDC. Si el controlador indica que no tiene ese grupo, la eliminación también se considera correcta. Los registros se borran.

Grupos de portales

Paso 5. Cree un grupo de portales

1. En el árbol del clúster, abra Unified Storage → pestaña Protocols → selector iSCSI.
2. En la lista Portal groups, haga clic en Create portal group.
3. Complete el formulario:

Campo	Qué especificar
Name	De 1 a 256 caracteres
Pool	Un pool del clúster; el pool seleccionado determina a qué VDC puede servir el grupo
Portals	Un bloque repetible con al menos una fila: IP address (IPv4) y Port en el rango 1000–65535, con el valor predeterminado 3260. El enlace Add agrega una fila

4. Haga clic en Create.

No es necesario crear los portales de antemano: un portal no es un objeto independiente; solo existe como una fila de la composición del grupo. Los pares "dirección + puerto" duplicados se consolidan en uno, y los pares que el clúster ya conoce se reutilizan.

El grupo es inmutable: la plataforma no admite editar la composición de un grupo existente. Para cambiar el conjunto de direcciones, cree un grupo nuevo y traslade las asignaciones a él.

precaución

Un grupo de portales pertenece a un pool, no a un VDC. Todos los VDC cuyo almacenamiento reside en este pool pueden verlo y utilizarlo, por lo que cambiar el conjunto de direcciones es una operación a nivel de clúster.

Paso 6. Consulte los grupos de portales

La lista Portal groups muestra tres columnas: Name, Pool y Portals, que indica el número de portales del grupo. En los grupos creados antes de que se introdujeran las asociaciones con pools, la columna Pool está vacía: se trata de registros heredados, no de un error. La lista admite búsqueda, ordenación por columna, paginación y exportación a CSV.

Haga clic en el nombre de un grupo: su tarjeta de solo lectura se abre a la derecha, con Name, Pool y una tabla Portals con las columnas IP address y Port. Por el mismo motivo, la tarjeta no tiene campos de entrada ni botones para editar la composición: la composición del grupo es inmutable. La acción Delete portal group se encuentra en la parte inferior de la tarjeta.

La sección solo es visible para el rol Cluster master: sin privilegios de visión general del clúster, el nodo Unified Storage no aparece en el árbol en absoluto.

Paso 7. Elimine un grupo de portales

La eliminación puede iniciarse en dos lugares: con el icono de papelera en la fila de la lista o con la acción Delete portal group de la tarjeta. Ambos abren el mismo cuadro de diálogo de confirmación con el nombre del grupo.

Una vez que el controlador lo confirma, la composición del grupo, el propio grupo y los portales que no pertenecen a otros grupos se eliminan de los registros. Los clientes que utilizaban estas direcciones pierden de inmediato el descubrimiento de rutas; por ello, el cuadro de diálogo de confirmación advierte sobre esto.

Un grupo heredado sin pool se elimina solo de la base de datos: en este caso no se llama al controlador y la respuesta es inmediata.

Verifique el resultado

Después de los pasos 1–4, abra la página del grupo de iniciadores. Resultado esperado: la tabla Allowed Initiators (IQN) contiene exactamente los IQN especificados en su última edición, y Authorized Networks contiene las redes especificadas.

Después de los pasos 5–7, actualice la lista Portal groups. Resultado esperado tras la creación: la lista contiene una fila con el nombre de su grupo, la columna Pool completada y un recuento distinto de cero en la columna Portals. Resultado esperado tras la eliminación: la fila ya no está en la lista.

Una comprobación adicional para los volúmenes asignados es la subtarjeta Initiators de la página del volumen: Disconnected para un iniciador significa que la entrada existe en los registros de vStack Center, pero no en el controlador.

Solución de problemas

Qué ve	Por qué	Qué hacer
"Portal group not found. Refresh the list." (-45010)	El grupo ya no existe: la lista mostrada está desactualizada	Actualice la lista Portal groups. Al asignar un volumen, el mismo código significa algo distinto: el grupo existe, pero está en otro pool, no en el pool del almacenamiento del VDC
"Portal group … is in use by a target and cannot be deleted." (-45016)	El grupo está asociado a un destino; la eliminación no llega al controlador	Elimine las asignaciones que utilizan este destino o conserve el grupo: la asociación "destino — grupo de portales" se crea una vez y se reutiliza
"Unknown initiator group" (-45022)	El grupo no existe o pertenece a otro VDC	Compruebe el grupo en la tabla Initiator Groups de su VDC; la misma respuesta cubre ambos casos: el grupo de otro VDC no se revela
"Initiator group already exists" (-45023)	El nombre del grupo ya está en uso en este VDC	Especifique otro Group name: los nombres son únicos dentro del VDC, no del clúster
"Initiator group is in use by … target(s)" (-45024)	El grupo está asociado a un destino; el mensaje muestra el número de destinos que lo utilizan	El botón Unmap elimina la asignación del volumen, pero no elimina la asociación. El grupo solo se libera cuando se elimina el VDC, así que déjelo en su lugar hasta entonces
"Invalid initiator group parameters" (-45025)	La composición no superó la validación	Introduzca al menos un iniciador y una red, y compruebe el formato del IQN, el formato CIDR y el nombre del grupo
"Storage is not enabled for VDC" (-45013)	Los grupos de iniciadores residen en el almacenamiento del VDC, que no existe	Habilite el almacenamiento en la pestaña Storage
Pool no encontrado (-45002)	El pool seleccionado no existe o no tiene nombre	Vuelva a seleccionar el pool; los estados de los pools se describen en la sección "Pools de almacenamiento"
El formulario no acepta los valores (-32602)	Un valor no se puede interpretar: un nombre vacío o demasiado largo, ninguna fila de portal o una dirección IPv4 no válida	Compruebe los campos según las reglas del paso 5; el formulario marca un par "dirección + puerto" duplicado en la segunda fila coincidente
El controlador del pool no respondió o rechazó la operación (-45020, -45021)	El pool no está disponible o rechazó el paso de recreación del grupo; la composición no ha cambiado	Compruebe la disponibilidad del pool y vuelva a intentar la operación
Rechazo con un mensaje de la plataforma	El controlador devolvió su propio motivo; por ejemplo, que ya tiene un grupo con este número	El grupo no aparece en la lista y no queda ninguna discrepancia entre los registros y el controlador; resuelva la causa y vuelva a intentarlo
"Access denied" (-403)	Crear y eliminar grupos de portales solo está disponible para el rol Cluster master; para los grupos de iniciadores, falta un privilegio o el VDC está fuera de su ámbito	Inicie sesión con un rol de nivel de clúster o trabaje dentro de su VDC; este rechazo no impide leer los grupos de portales

Véase también

• Conexión de volúmenes mediante iSCSI: donde ambos grupos se utilizan conjuntamente.
• Cómo configurar un destino iSCSI y la protección con contraseña CHAP: el punto de acceso con el que se asocian los grupos.
• Almacenamiento del VDC: modelo y arquitectura: ámbitos de pertenencia de las entidades e invariantes.

Métodos de la API

Operaciones de la API tratadas en esta página: iscsi-initiator-group-create, iscsi-initiator-group-list, iscsi-initiator-group-get, iscsi-initiator-group-set, iscsi-initiator-group-delete, iscsi-portal-group-create, iscsi-portal-group-list, iscsi-portal-group-get, iscsi-portal-group-delete; consulte la referencia de la API.