Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
The LoginToTarget method instructs a miniport driver that manages an HBA initiator to log on to a target portal.
Les pilotes miniport qui implémentent la classe WMI MSiSCSI_Operations doivent prendre en charge cette méthode.
Le pilote miniport doit exposer des informations sur la session qu’il crée via la classe WMI MSiSCSI_InitiatorSessionInfo.
Le tableau suivant décrit les types de sessions d’ouverture de session que les initiateurs peuvent établir.
| Login session | Description |
|---|---|
Discovery |
A discovery session is used exclusively for SendTargets operations. |
Informational |
Une session d’information permet à l’initiateur d’interroger la cible pour obtenir des informations, mais l’initiateur ne signale pas les numéros d’unité logique (LUN) sur la cible au gestionnaire Plug-and-Play (PnP) ; le pilote de port de stockage n’énumère pas les NUMÉROS logiques ni ne les expose en tant qu’appareils locaux. 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 |
Une session de données est une session complète. Le pilote miniport qui lance la session doit signaler les numéros d’unité logique sur la cible au pilote de port, de sorte que le pilote de port les énumère et charge les pilotes appropriés. Les logiciels peuvent accéder à ces appareils distants comme s’ils étaient des appareils locaux. |
Boot |
Une session de démarrage est une session complète dans laquelle l’unité logique iSCSI est utilisée comme appareil de démarrage. |
The identifier (ID) that the LoginToTarget method assigns to the session must remain constant for the lifetime of a session. Même si les déconnexions asynchrones ou les événements réseau coupent la connexion à la cible et forcent le pilote miniport à se reconnecter, le pilote miniport doit continuer à utiliser le même ID de session.
Les pilotes miniport doivent utiliser les instructions suivantes lorsqu’ils rétablissent les données et les sessions d’information :
Tentatives de reconnexion périodiques
Le pilote miniport doit tenter régulièrement de se reconnecter (intervalles de 5 secondes sont recommandés) jusqu’à ce qu’une ouverture de session réussisse ou que le pilote miniport reçoive une demande de déconnexion.
Latence de suppression de l’appareil
Le pilote miniport ne doit pas immédiatement supprimer les unités logiques de la pile d’appareils du système d’exploitation local. Au lieu de cela, le pilote miniport doit utiliser des données mises en cache localement pour traiter les requêtes d’enquête et de numéro d’unité logique de rapport et les demandes de file d’attente que le pilote miniport doit envoyer à la cible distante pour le traitement.
Si le pilote miniport ne parvient pas à rétablir une session avec la cible après environ 60 secondes, il doit supprimer les unités logiques de la cible de la pile d’appareils local. En introduisant la latence de 60 secondes dans la suppression des appareils de la pile d’appareils, le pilote miniport peut éviter d’interrompre inutilement le travail des applications locales qui accèdent aux données sur la cible distante. Toutefois, une latence de plus de 60 secondes peut nécessiter le pilote miniport pour mettre en file d’attente un grand nombre de requêtes, et ces requêtes peuvent potentiellement consommer une quantité inacceptable de ressources système. Le temps de latence exact doit être 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.