Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
The LoginToTarget method instructs a miniport driver that manages an HBA initiator to log on to a target portal.
Los controladores de miniport que implementan la clase WMI de MSiSCSI_Operations deben admitir este método.
El controlador de miniport debe exponer información sobre la sesión que crea a través de la clase WMI de MSiSCSI_InitiatorSessionInfo.
En la tabla siguiente se describen los tipos de sesiones de inicio de sesión que los iniciadores pueden establecer.
| Login session | Description |
|---|---|
Discovery |
A discovery session is used exclusively for SendTargets operations. |
Informational |
Una sesión informativa permite al iniciador consultar el destino para obtener información, pero el iniciador no notifica números de unidad lógica (LUN) en el destino al administrador de Plug and Play (PnP); El controlador de puerto de almacenamiento no enumera los LUN ni los expone como dispositivos locales. Management applications can query these remote LUNs by establishing an informational session and calling iSCSI user-mode library routines, such as SendScsiInquiry, SendScsiReportLuns, and SendScsiReadCapacity. |
Data |
Una sesión de datos es una sesión completa. El controlador de miniporte que inicia la sesión debe notificar los LUN en el destino al controlador de puerto, por lo que el controlador de puerto los enumerará y cargará los controladores adecuados. El software puede acceder a estos dispositivos remotos como si fueran dispositivos locales. |
Boot |
Una sesión de arranque es una sesión completa en la que se usa el LUN iSCSI como dispositivo de arranque. |
The identifier (ID) that the LoginToTarget method assigns to the session must remain constant for the lifetime of a session. Incluso si los eventos de red o logoffs asincrónicos interrumpen la conexión con el destino y obligan al controlador de miniporte a volver a conectarse, el controlador de miniporte debe seguir usando el mismo identificador de sesión.
Los controladores de miniporte deben usar las siguientes directrices cuando restablezcan los datos y las sesiones informativas:
Intentos de reconexión periódicos
El controlador de minipuerto debe intentar volver a conectarse periódicamente (se recomiendan intervalos de 5 segundos) hasta que un inicio de sesión se realice correctamente o el controlador de miniporte reciba una solicitud de cierre de sesión.
Latencia de eliminación de dispositivos
El controlador de miniport no debe quitar inmediatamente las unidades lógicas del destino de la pila de dispositivos del sistema operativo local. En su lugar, el controlador de miniporte debe usar datos almacenados en caché local para procesar las solicitudes INQUIRY y REPORT LUNS y las solicitudes de cola que el controlador de miniporte debe enviar al destino remoto para su procesamiento.
Si el controlador de minipuerto no puede restablecer una sesión con el destino después de aproximadamente 60 segundos, debe quitar las unidades lógicas del destino de la pila de dispositivos local. Al introducir la latencia de 60 segundos en la eliminación de dispositivos de la pila de dispositivos, el controlador de miniporte puede evitar interrumpir innecesariamente el trabajo de las aplicaciones locales que acceden a los datos en el destino remoto. Sin embargo, una latencia de más de 60 segundos podría requerir que el controlador de miniporte poner en cola un gran número de solicitudes, y estas solicitudes podrían consumir potencialmente una cantidad inaceptable de recursos del sistema. El tiempo de latencia exacto debe ser configurable.
The LoginToTarget WMI method belongs to the MSiSCSI_Operations WMI class.
For an explanation of the algorithm that the iSCSI user-mode library uses to establish a log, see LoginIScsiTarget.