Puede ser de gran ayuda utilizar el recurso de anotaciones de configuración al intentar depurar el entorno iSCSI. Gracias a esta información, podrá resolver numerosos errores de configuración. El escenario de error más habitual es cuando cfgmgr -vl ics0 se completa satisfactoriamente, pero no crea hdisks, o crea menos hdisks que los que cabía esperar. Existen varios errores de configuración habituales que pueden provocar este escenario. Las anotaciones de configuración (archivo cfglog) permiten determinar cuál de los errores más habituales es el que se ha producido.
Para visualizar los datos de anotaciones de configuración que se hayan capturado, puede ejecutar el mandato:
alog -o -t cfg
Para visualizar información sobre la configuración del archivo de anotaciones (por ejemplo, para conocer la ubicación del archivo de anotaciones), ejecute:
alog -L -t cfg
Si las anotaciones de configuración no están habilitadas, se pueden habilitar de la siguiente manera:
export CFGLOG="" echo "Create cfglog" | alog -t cfg
Una buena metodología de depuración consiste en ejecutar:
rmdev -Rl ics<x> rm /usr/adm/ras/cfglog echo "Create cfglog" | alog -t cfg cfgmgr -l ics<x> alog -o -t cfg
Algunos errores habituales harán que falle la apertura del controlador de dispositivo del protocolo iSCSI. En este caso, el archivo cfglog contendrá un mensaje como el siguiente, siendo XX un número de error procedente de errno.h
apertura de /dev/iscsi0 ha devuelto XX", siendo XX un número de error procedente de errno.h.
El valor devuelto por la apertura puede indicar lo que ha fallado. Los valores habituales que un error de configuración puede provocar son 69 (ENETDOWN) y 70 (ENETUNREACH).
El código de retorno 69 indica que el enlace conectado al adaptador iSCSI ha quedado físicamente fuera de servicio. Mire a ver si el cable está bien conectado.
El código de retorno 70 indica que el enlace funciona, pero el adaptador no ha podido obtener una dirección de cliente del protocolo DHCP. Si el atributo host_addr del adaptador no se ha establecido igual a una dirección IP válida, el adaptador intentará adquirir una dirección IP de un servidor DHCP. Si no hay ningún servidor DHCP que proporcione una dirección IP, la apertura fallará con el código de retorno 70.
Después de una apertura satisfactoria, el método de configuración intentará iniciar el dispositivo. La función ioctl SCIOLSTART, si falla, impedirá el descubrimiento de hdisks. Una anomalía de SCIOLSTART se anotará en el archivo de anotaciones de configuración anotaciones de configuración de la siguiente manera:
SCIOLSTART failed, errno = E, status_class = C, status_detail = D
Si los valores de C o D correspondientes a Clase de estado y Detalles de estado son distintos de cero, ello indica que el inicio de sesión iSCSI ha fallado. Clase de estado y Detalles de estado son valores devueltos en la respuesta de inicio de sesión iSCSI. El significado de los valores de Clase de estado y Detalles de estado viene documentado en la petición de comentarios RFC 3270 de iSCSI.
La función ioctl SCIOLSTART también puede fallar antes de intentar el inicio de sesión iSCSI. Si los valores de Clase de estado y Detalles de estado son cero, pero el valor de Número de error (errno) es distinto de cero, la función ioctl falló antes de que se produjera el inicio de sesión.
Dos valores de número de error habituales devueltos por la función ioctl SCIOLSTART son 73 (ECONNRESET) y 81 (EHOSTUNREACH).
El número de error 73 indica que la dirección IP del destino rehusó la conexión TCP que intentó establecer el adaptador iSCSI. Una causa posible es que se haya especificado un número de puerto TCP equivocado en el archivo de configuración /etc/iscsi/targetshwx.
El número de error 81 indica que el adaptador iSCSI no ha obtenido respuesta de la dirección IP del destino. Dicho de otra manera, el adaptador iSCSI no puede hacer ping a la dirección IP del destino.