Partager via


LoginToTarget

La méthode LoginToTarget indique à un pilote miniport qui gère un initiateur HBA de se connecter à un portail cible.

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.

Session de connexion Description

Découverte

Une session de découverte est utilisée exclusivement pour les opérations SendTargets .

Informationnel

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 d’unité logique ni ne les expose en tant qu’appareils locaux. Les applications de gestion peuvent interroger ces lun distants en établissant une session d’information et en appelant des routines de bibliothèque en mode utilisateur iSCSI, telles que SendScsiInquiry, SendScsiReportLuns et SendScsiReadCapacity.

Données

Une session de données est une session complète. Le pilote miniport qui lance la session doit signaler les numéros d’unités logiques sur la cible au pilote de port, afin que le pilote de port les énumère et charge les pilotes appropriés. Les logiciels peuvent accéder à ces appareils distants comme s’il s’agissait d’appareils locaux.

Démarrage

Une session de démarrage est une session complète dans laquelle le numéro d’unité logique iSCSI est utilisé comme périphérique de démarrage.

L’identificateur (ID) que la méthode LoginToTarget affecte à la session doit rester constant pendant toute la durée de vie d’une session. Même si des déconnexions asynchrones ou des événements réseau interrompent 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 suivre les instructions suivantes lorsqu’ils rétablissent des sessions de données et d’information :

Tentatives de reconnexion périodiques
Le pilote miniport doit tenter régulièrement de se reconnecter (des intervalles de 5 secondes sont recommandés) jusqu’à ce qu’une ouverture de session aboutisse ou que le pilote miniport reçoive une demande de déconnexion.

Latence de suppression de l’appareil
Le pilote miniport ne doit pas supprimer immédiatement les unités logiques de la cible de la pile de périphériques 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 LUNS INVESTIGATION et RAPPORT et les demandes de file d’attente que le pilote miniport doit envoyer à la cible distante pour 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 de périphériques locale. En introduisant la latence de 60 secondes lors de la suppression des appareils de la pile des 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 obliger le pilote miniport à mettre en file d’attente un grand nombre de demandes, et ces requêtes peuvent potentiellement consommer une quantité inacceptable de ressources système. Le temps de latence exact doit être configurable.

La méthode WMI LoginToTarget appartient à la classe WMI MSiSCSI_Operations.

Pour obtenir une explication de l’algorithme utilisé par la bibliothèque de mode utilisateur iSCSI pour établir un journal, consultez LoginIScsiTarget.