Solución de problemas de asociaciones a volúmenes de rendimiento ultraalto

En este tema, se tratan los pasos de solución de problemas que puede realizar y los requisitos para verificar los volúmenes configurados para el nivel de Rendimiento ultraalto, donde el volumen no se puede asociar o la asociación de volumen no tiene activada la función de rutas múltiples.

Solución de fallos de asociación de volumen

El plugin Gestión de volúmenes en bloque es necesario para los volúmenes configurados para Rendimiento ultraalto, asociado mediante el tipo de asociación iSCSI. Si el volumen no se puede asociar a la instancia, es probable que el problema se deba a una configuración incorrecta del plugin Gestión de volúmenes en bloque. Consulte las sugerencias de solución de problemas de esta sección para ver estos problemas.

Error de log de plugin Gestión de volúmenes en bloque: Volume Attachment Not Authorized o Not Found

Si no ha configurado los permisos correctamente para el plugin Gestión de volúmenes en bloque, el volumen no se podrá asociar a la instancia.

Detalles

El volumen no aparecerá como asociado en la consola y verá un mensaje de error NotAuthorizedOrNotFound en el log del plugin Gestión de volúmenes en bloque.

El log del plugin Gestión de volúmenes en bloque se encuentra en:

"/var/log/oracle-cloud-agent/plugins/oci-blockautoconfig/oci-blockautoconfig.log

A continuación, se muestra una entrada del log de errores de ejemplo para este problema:

2021/08/13 09:14:25.864932 compute_client_command.go:255: Updating volume attachment to the state LOGIN_SUCCEEDED ...
2021/08/13 09:14:26.155473 compute_client_command.go:260: Service error:NotAuthorizedOrNotFound.
volume attachment ocid1.volumeattachment.oc1.iad.<volume-attachment_ID> not found.
http status code: 404. Opc request id: <request_ID>

Causa

El plugin Gestión de volúmenes en bloque no tiene permisos suficientes para enviar la notificación de estado de inicio de sesión de iSCSI al servicio.

Resolución

Para configurar permisos para el plugin Gestión de volúmenes en bloque:

  1. Crear grupo dinámico: cree un grupo dinámico con las reglas de coincidencia del siguiente ejemplo de código, para incluir todas las instancias en los compartimentos especificados:

    ANY {instance.compartment.id = 'ocid1.tenancy.oc1..<tenancy_ID>', instance.compartment.id = 'ocid1.compartment.oc1..<compartment_OCID>'
  2. Configurar política para grupo dinámico: configure una política que otorgue permisos al grupo dinámico creado en el paso anterior para permitir que el agente de instancia acceda al servicio Block Volume para recuperar la configuración de asociación:

    Allow dynamic-group InstantAgent to use instances in tenancy
    Allow dynamic-group InstantAgent to use volume-attachments in tenancy

Recursos

Error de log de plugin Gestión de volúmenes en bloque: User Agent Can Not Be Blank

La instancia informática debe tener una dirección IP pública o un gateway de servicio para poder conectarse a los servicios de Oracle; de lo contrario, el volumen no se podrá asociar.

Detalles

El volumen no aparecerá como asociado en la consola y verá un mensaje de error user agent can not be blank en el log del plugin Gestión de volúmenes en bloque.

El log del plugin Gestión de volúmenes en bloque se encuentra en:

"/var/log/oracle-cloud-agent/plugins/oci-blockautoconfig/oci-blockautoconfig.log

A continuación, se muestra una entrada del log de errores de ejemplo para este problema:

2021/10/15 22:16:07.881953 compute_client_command.go:255: Updating volume attachment to the state LOGIN_SUCCEEDED ...
2021/10/15 22:16:07.882185 compute_client_command.go:260: user agent can not be blank
2021/10/15 22:16:07.882204 iscsi_commands_helper.go:302: user agent can not be blank
2021/10/15 22:16:07.882212 iscsi_commands_helper.go:310: user agent can not be blank

Causa

El plugin Gestión de volúmenes en bloque no puede enviar la notificación de estado de conexión de iSCSI al servicio debido a la configuración de red.

Resolución

Si la instancia no tiene una dirección IP pública, configure un gateway de servicio en la red virtual en la nube (VCN). El gateway de servicio permite a la instancia acceder de forma privada a servicios de Oracle sin exponer los datos en la red pública de Internet. A continuación, se muestran notas especiales para configurar el gateway de servicio para el plugin Gestión de volúmenes en bloque:

  • Al crear el gateway de servicio, active la etiqueta de servicio denominada Todos los servicios de <region> en la red de servicios de Oracle.
  • Al configurar el enrutamiento para la subred que contiene la instancia, configure una regla de ruta con Tipo de objetivo configurado en Gateway de servicio y Servicio de destino configurado en Todos los servicios de <region> en la red de servicios de Oracle.

Para obtener instrucciones detalladas, consulte Acceso a los servicios de Oracle: gateway de servicios.

Recursos

La asociación de volumen no está activada para rutas múltiples

Al asociar un volumen configurado para el nivel Rendimiento ultraalto, para lograr el rendimiento óptimo, la asociación de volúmenes debe estar activada para rutas múltiples. El servicio Block Volume intenta activar la asociación para rutas múltiples cuando se está asociando el volumen. Si no se cumplen todos los requisitos, la asociación de volumen no estará activada para rutas múltiples.

Comprobación de si una asociación de volumen está activada para rutas múltiples

Para comprobar si una asociación de volumen está activada para rutas múltiples en la consola, en la página Detalles de volumen:

  1. Abra el menú de navegación y haga clic en Almacenamiento. En Almacenamiento de bloques, haga clic en Los volúmenes en bloque.
  2. Haga clic en el volumen en bloque cuya asociación de volumen desea comprobar.

  3. Haga clic en Instancias asociadas en la sección Recursos.
  4. Compruebe el valor que se muestra en la columna Rutas múltiples.

    • : el volumen está configurado para el nivel Rendimiento ultraalto y la asociación de volumen está activada para rutas múltiples. No es necesario realizar ninguna acción.

    • No: el volumen no está configurado para el nivel Rendimiento ultraalto; no es necesario que el volumen esté activado para rutas múltiples. No es necesario realizar ninguna acción.
    • No con un icono de advertencia: el volumen está configurado para el nivel Rendimiento ultraalto, pero la asociación de volumen no está activada para rutas múltiples. Para lograr un rendimiento óptimo, se debe asegurar de que el volumen esté asociado a una unidad de instancia soportada y de que se han configurado los requisitos necesarios.

Si el volumen está configurado para el nivel Rendimiento ultraalto, pero no para rutas múltiples según sea necesario, la columna Rutas múltiples contendrá No con un triángulo de advertencia, como se muestra para la primera fila de la siguiente captura de pantalla:

Valores de columna de rutas múltiples en la consola.

Para conocer procedimientos adicionales para verificar si un volumen tiene activada la función de rutas múltiples, incluido el uso de la CLI o la API, consulte Comprobación de si una asociación de volumen está activada para rutas múltiples.

Si el volumen no está configurado para rutas múltiples, para solucionar el problema, revise la información que se trata en esta sección y corrija los problemas que surjan.

La instancia debe estar basada en una unidad de computación soportada

Debe asociar un volumen configurado para el nivel Rendimiento ultraalto a una instancia basada en una unidad soportada, configurada para al menos 16 núcleos.

Unidades soportadas para asociaciones ISCSI

Todas las unidades con hardware dedicado actuales soportan asociaciones iSCSI activadas para rutas múltiples. Consulte información adicional en Unidades con hardware dedicado para conocer las características de rendimiento de los volúmenes en bloque asociados a instancias dedicadas.

Las unidades de máquina virtual actuales configuradas para 16 núcleos o más soportan asociaciones activadas para rutas múltiples. Consulte Unidades de máquina virtual para volúmenes asociados a iSCSI para conocer las características de rendimiento de los volúmenes asociados a máquinas virtuales con asociaciones a iSCSI.

Unidades soportadas para asociaciones paravirtualizadas

La unidad VM.Standard.E4.Flex es la única unidad soportada con asociaciones paravirtualizadas para el volumen configurado para Rendimiento ultraalto.

Resolución

Si el volumen no está asociado a una instancia con una configuración de unidad soportada, deberá desasociarlo y asociarlo a una instancia con una configuración de unidad soportada.

También puede editar la instancia existente para que tenga la configuración de unidad correcta, pero se debe asegurar de desasociar y volver a asociar el volumen después de editar la instancia.

Advertencia

Si la instancia tiene menos de 8 OCPU, puede que se produzca un problema, en el que después de editar la instancia para que soporte asociaciones activadas para rutas múltiples, la asociación de volumen sigue sin estar activada para rutas múltiples, incluso después de desasociar y volver a asociar el volumen. En este escenario, debe volver a crear la instancia a partir de una unidad soportada y, a continuación, asociar el volumen a la nueva instancia. Para obtener más información, consulte La asociación de volumen paravirtualizada no está activada para rutas múltiples después de cambiar el tamaño de la instancia.

Recursos

La imagen informática debe soportar asociaciones de rutas múltiples

Debe asociar un volumen configurado para el nivel Rendimiento ultraalto a una instancia que ejecute una imagen que soporte asociaciones de rutas múltiples. Esto incluye imágenes personalizadas.

Imágenes soportadas para asociaciones iSCI

Solo las imágenes de plataforma que ejecuten Oracle Linux o imágenes personalizadas basadas en una imagen de Oracle Linux soportan las asociaciones de rutas múltiples.

Utilice una de las últimas imágenes de plataforma de Oracle Linux, con una versión de Unbreakable Enterprise Kernel (UEK) UEK6U1 o superior.

En el caso de las imágenes personalizadas, la versión de Unbreakable Enterprise Kernel (UEK) también debe ser UEK6U1 o superior. El UEK UEK6U1 está asociado a la versión principal del núcleo 5.4.17-2036, publicada en noviembre de 2020. También debe actualizar la propiedad Storage.Iscsi.MultipathDeviceSupported de la imagen personalizada a true y volver a iniciar la instancia. Para obtener más información, consulte Configuración de capacidades de imagen para imágenes personalizadas

Imágenes soportadas para asociaciones paravirtualizadas

Para las asociaciones activadas para rutas múltiples, la instancia asociada debe ejecutar una de las siguientes imágenes o una imagen personalizada basada en una de estas imágenes:

  • Oracle Linux
  • Ubuntu
  • CentOS
  • Windows
Nota

Las asociaciones activadas para rutas múltiples no están soportadas para instancias de Oracle Autonomous Linux.

Utilice una de las últimas imágenes de plataforma de Oracle Linux, con una versión de Unbreakable Enterprise Kernel (UEK) UEK6U1 o superior.

Recursos

Nueva asociación del volumen

Si ha actualizado la configuración de unidad o la imagen de una instancia a una que soporte asociaciones de rutas múltiples, debe desasociar el volumen de la instancia y, a continuación, volver a asociarlo a la instancia.

Recursos

Generación de un archivo de diagnóstico para asociaciones iSCSI

Para las asociaciones a iSCSI, si ha realizado todos los pasos descritos en este tema y sigue teniendo un problema con la asociación de volúmenes, utilice los pasos descritos en Paso 4: Genere un archivo de diagnóstico para Oracle Cloud Agent para generar un archivo de diagnóstico y ponerse en contacto con los Servicios de Soporte Oracle. Este paso no se aplica a las asociaciones paravirtualizadas.

Recursos

Asociación de volumen notificada incorrectamente como activada para rutas múltiples

En determinados escenarios, una asociación de volumen se muestra como activada para rutas múltiples en la consola, pero en realidad la asociación no está activada para rutas múltiples y el volumen no alcanza el rendimiento esperado para el nivel Rendimiento máximo. Este problema se puede producir al utilizar las herramientas oci-utils y oci-iscsi-config al mismo tiempo para configurar un volumen.

Utilice uno de los siguientes métodos para comprobar si está experimentando este problema.

Opción 1: Utilizar el comando multipath de Linux
Utilice el comando multipath para confirmar si una asociación de volumen está realmente activada para rutas múltiples en una instancia de Linux. Conéctese a la instancia y ejecute el comando multipath con la etiqueta ll, de la siguiente forma:
# multipath -ll
Si la salida del comando no devuelve nada, queda confirmado que la instancia no tiene ninguna asociación activada para rutas múltiples.
Opción 2: Comprobar node.startup
Compruebe los registros de nodo en /var/lib/iscsi/nodes/{IQN} para node.startup, de la siguiente manera:
#cd /var/lib/iscsi/nodes/{IQN}
#grep -Hrn 'node.startup' 
Si node.startup=automatic aparece en alguno de los registros, la asociación de volumen no está activada para rutas múltiples. Todos deben incluir node.startup=manual.

Resolución

Si determina que la asociación no está activada para rutas múltiples, puede resolver este problema con el archivo /etc/fstab. Actualice el archivo /etc/fstab para indicar al servicio systemd que espere hasta que el servicio multipathd esté en ejecución antes de montar el sistema de archivos. Para ello, agregue x-systemd.requires=multipathd.service para el volumen. Por ejemplo:
UUID={$AFFECTED_VOLUME_UUID} /test ext4 defaults,_netdev,nofail,x-systemd.requires=multipathd.service 0 2 

Reinicie la instancia tras actualizar el archivo /etc/fstab.

Para obtener más información sobre el archivo /etc/fstab, consulte Opciones de fstab típicas y Opciones de fstab para volúmenes en bloque con rutas de dispositivo coherentes.