Cómo asignar un volumen mediante iSCSI y eliminar la asignación

Cuándo usar este procedimiento

Cuando se ha creado un volumen, pero el host todavía no puede verlo. La asignación es el último paso de la secuencia: agrega el volumen al destino del VDC con el número de LUN seleccionado y limita su visibilidad a un grupo de iniciadores. Antes de este paso, el volumen existe y consume cuota, pero nadie puede acceder a él.

La operación inversa es la desasignación. Elimina el LUN del destino, pero deja el volumen en su lugar: no se elimina ningún dato. La desasignación es necesaria cuando hay que conservar el volumen, pero bloquear o cambiar el acceso a él. Cuando se elimina un volumen asignado, vStack Center elimina la asignación automáticamente.

Requisitos previos

• La función Unified Storage está habilitada en las opciones del clúster.
• Hay un destino iSCSI configurado para el VDC; consulte "Cómo configurar un destino iSCSI y la protección con contraseña CHAP".
• Existe un grupo de portales en el pool del almacenamiento del VDC; consulte "Grupos de iniciadores y de portales".
• El volumen se ha creado y todavía no está asignado: su Status en la lista Volumes es Unmapped (consulte "Volúmenes del VDC").
• El privilegio Map vDC Volume para asignar y Unmap vDC Volume para desasignar; ambos están disponibles para el rol Cluster master y para un administrador de VDC dentro de su VDC.
• Versión de vStack Center: 3.0.4.

Paso 1. Seleccione un número de LUN y un grupo de iniciadores

El número de LUN es único dentro del destino y está en el rango 0..255. El formulario de asignación propone automáticamente un número disponible; los números ya en uso se muestran en el campo LUN ID, en Properties, en las páginas de los volúmenes asignados de este VDC.

Utilice un grupo de iniciadores existente o cree uno durante la asignación: ambas opciones están disponibles en la misma fila de selección del formulario.

Qué necesita	Qué seleccionar en el formulario	Cuándo resulta útil
Exportar el volumen a hosts ya definidos en un grupo	Un grupo existente de la lista Initiator Group	El grupo se reutiliza; su composición se edita por separado en su página
Crear un grupo para este volumen de inmediato	Create y complete la composición en el mismo lugar	La primera asignación en un VDC; evita ir a otra pantalla

Paso 2. Asigne el volumen

1. Abra la tarjeta del VDC → pestaña Storage → subpestaña Volumes y haga clic en el nombre del volumen.
2. En la sección Initiator Group Mapping, haga clic en Map volume.
3. Complete el formulario:

Campo	Qué especificar
Protocol	iSCSI; la opción NVMe no está disponible en esta versión y aparece marcada como Coming soon
LUN ID	Un número disponible en 0..255; el campo ya viene completado con un valor sugerido
Initiator Group	Un grupo existente o Create; en ese caso, complete Group name, Allowed Initiators (IQN) y Authorized networks

4. Confirme la asignación.

En el formulario no se selecciona un grupo de portales: se utiliza el grupo vinculado al pool del almacenamiento del VDC.

El formulario espera a que finalice toda la operación, no solo a que sea aceptada. Durante esta espera, el controlador del pool ejecuta una secuencia de pasos en un orden deliberado:

1. Se crea el grupo de iniciadores, si se solicitó su creación.
2. Se crea la asociación "destino — grupo de portales — grupo de iniciadores", si todavía no existe.
3. El volumen se agrega al destino como LUN.
4. La visibilidad del LUN se limita a este grupo de iniciadores.

El enmascaramiento va al final porque la máscara se aplica a un LUN que ya se ha agregado. El volumen se considera asignado solo después de que todos los pasos se completen correctamente: hasta que la secuencia finaliza, su Status sigue siendo Unmapped. Si no se puede aplicar la máscara, el LUN agregado se elimina mediante un paso compensatorio: no queda ninguna asignación parcial.

Paso 3. Compruebe el aislamiento

La máscara limita la visibilidad del LUN a un grupo de iniciadores: los demás grupos del mismo destino no pueden ver este volumen. Un volumen se exporta exactamente a un grupo: no puede asignarse a un segundo grupo.

De ello se deduce un enfoque práctico: para ampliar el conjunto de hosts, agregue IQN al grupo ya asociado en lugar de desasignar el volumen. En la página del volumen, utilice el botón Edit group members de la sección Initiator Group Mapping. Los cambios afectan al volumen de inmediato.

precaución

Un grupo de iniciadores es un recurso compartido: editar la composición mediante Edit group members afecta a todos los volúmenes asignados a este grupo.

No se puede cambiar el grupo de un volumen asignado en una sola operación. Para cambiar el grupo, utilice Unmap y, a continuación, Map volume con otro grupo.

Paso 4. Elimine la asignación

1. Abra la página del volumen.
2. En la sección Initiator Group Mapping, haga clic en Unmap.
3. Confirme la desasignación en el cuadro de diálogo.

La secuencia de desasignación es el reflejo de la asignación y consta de dos pasos: primero se elimina la máscara del LUN y después el propio LUN. Este orden es obligatorio: la máscara no se elimina automáticamente con el LUN, e invertir el orden dejaría una asociación huérfana. Si el controlador indica que no tiene el LUN o la máscara, esto se considera correcto: los registros se borran y la discrepancia se resuelve.

El grupo de iniciadores, el destino y la asociación "destino — grupo de portales — grupo de iniciadores" se conservan tras la desasignación. La asociación se reutiliza en la siguiente asignación, por lo que volver a conectar el mismo volumen requiere menos trabajo que la primera conexión.

Verifique el resultado

Permanezca en la página del volumen.

Resultado esperado después del paso 2: el encabezado muestra Mapped; Properties contiene ahora Protocol, LUN ID con el número especificado y Target con un enlace a la página del destino. La sección Initiator Group Mapping muestra el nombre del grupo y las subtarjetas Initiators y Authorized networks.

Resultado esperado después del paso 4: el encabezado muestra Unmapped, la sección de asignación muestra "Volume is not mapped" y el botón Map volume, y Protocol en Properties es None.

El indicador del iniciador en la subtarjeta Initiators refleja una comparación de la composición del grupo con el controlador: Disconnected 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
"iSCSI is not configured for VDC" (-45032)	El VDC no tiene destino, por lo que no hay dónde agregar el LUN	Configure iSCSI en la subpestaña Overview de la pestaña Storage
"Unknown portal group" (-45010)	No se encontró el grupo de portales o no está en el pool del almacenamiento de este VDC	Compruebe el pool del grupo en la sección Unified Storage → Protocols → iSCSI del clúster, en la columna Pool
"LUN ID … is already in use on target …" (-45029)	Otro volumen del mismo destino utiliza el número; el mensaje muestra el destino y el número	Especifique un número disponible en el rango 0..255; los números ya en uso se muestran en Properties de los volúmenes asignados
"Volume is already mapped" (-45027)	El volumen ya está asignado, y un volumen se exporta exactamente a un grupo	Amplíe la composición del grupo asociado mediante Edit group members en lugar de crear una segunda asignación
"Volume is not mapped" (-45028)	No hay nada que desasignar: el volumen no está asignado	Compruebe el Status del volumen en la lista Volumes; probablemente la desasignación ya se ha completado
"Unknown volume" (-45026)	El volumen no existe, pertenece a otro VDC o el controlador todavía no lo ha confirmado	Actualice la lista Volumes; la misma respuesta cubre los tres casos: el volumen de otro VDC no se revela
"Unknown initiator group" (-45022)	El grupo seleccionado no existe o pertenece a otro VDC	Seleccione un grupo de la tabla Initiator Groups de su VDC
"Initiator group already exists" (-45023)	El nombre del nuevo grupo ya está en uso en este VDC	Especifique otro Group name o seleccione un grupo existente
"Invalid initiator group parameters" (-45025)	La composición del nuevo grupo no superó la validación	Compruebe el nombre, el formato del IQN y el formato CIDR
"Invalid volume map parameters" (-45031)	El conjunto de parámetros no corresponde al protocolo	Compruebe que LUN ID esté en 0..255 y que se haya seleccionado exactamente un grupo: un grupo existente o uno nuevo con una lista de iniciadores no vacía
"Volume map protocol is out of scope: nvme" (-45030)	El protocolo NVMe no se admite en esta versión	La asignación solo está disponible mediante iSCSI; no existe solución alternativa
"Storage is not enabled for VDC" (-45013)	El almacenamiento del VDC no está habilitado	Habilite el almacenamiento en la pestaña Storage
El controlador del pool no respondió o rechazó la operación (-45020, -45021)	El pool no está disponible o rechazó un paso de la secuencia	Durante la asignación, el volumen permanece sin asignar; durante la desasignación, se conserva el registro de la asignación; compruebe la disponibilidad del pool y vuelva a intentarlo
Desasignación rechazada con un mensaje de la plataforma	El controlador rechazó la eliminación de la máscara o del LUN y transmitió el motivo sin cambios	Se conserva el registro de la asignación y el volumen sigue asignado; investigue la causa en el pool
"Unified Storage feature is disabled" (-45001)	La función Unified Storage está deshabilitada en las opciones del clúster	El administrador del clúster debe habilitarla; mientras la función esté deshabilitada, se rechazan las operaciones de almacenamiento
"Access denied" (-403)	Falta el privilegio Map vDC Volume o Unmap vDC Volume, o está abierto otro VDC	Trabaje dentro de su VDC; la respuesta no revela si existe otro VDC

Véase también

• Volúmenes del VDC: creación de volúmenes, la tarjeta y la eliminación.
• Grupos de iniciadores y de portales: las reglas de acceso en las que se basa la asignación.
• Almacenamiento del VDC: modelo y arquitectura: invariantes de la asignación y separación del acceso.

Métodos de la API

Operaciones de la API tratadas en esta página: vdc-volume-map, vdc-volume-unmap, vdc-list-volumes, vdc-volume-get, iscsi-initiator-group-set; consulte la referencia de la API.