Multipath I-O Test (LOGO)
Ce test fournit des tests d’E/S multi-chemins pour la compatibilité de la solution de stockage d’un fournisseur avec les solutions de pilotes Microsoft®.
Notes
Le test est spécifiquement conçu pour s’exécuter sur les architectures de processeur x64.
Détails du test
| Spécifications |
|
| Plateformes |
|
| Versions prises en charge |
|
| Durée d’exécution attendue (en minutes) | 180 |
| Catégorie | Développement |
| Délai d’expiration (en minutes) | 10800 |
| Nécessite un redémarrage | false |
| Nécessite une configuration spéciale | false |
| Type | automatique |
Documentation supplémentaire
Les tests de cette zone de fonctionnalités peuvent contenir une documentation supplémentaire, notamment des informations sur les prérequis, l’installation et la résolution des problèmes, que vous trouverez dans les rubriques suivantes :
Exécution du test
Avant d’exécuter le test, effectuez la configuration de test pour le type de tableau de stockage Raid que vous testez. Pour plus d’informations, consultez Vue d’ensemble des tests RAID basés sur le matériel (Storage Array).
En outre, ce test nécessite les logiciels et matériels suivants :
Tableau RAID de stockage matériel qui utilise le module d’appareil microsoft (DSM) ou un DSM tiers qui s’interface à l’architecture principale de Microsoft MPIO
Composants logiciels inclus avec le DSM ou le tableau RAID de stockage matériel en cours de test.
Configuration des E/S multi-chemins
Dépannage
Pour la résolution des problèmes génériques des échecs de test HLK, consultez Résolution des échecs de test Windows HLK.
Pour obtenir des informations générales sur la résolution des problèmes de stockage, consultez Résolution des problèmes de test Device.Storage.
En outre, ce test présente les problèmes connus suivants :
Problème |
Détails |
L’environnement de test MPIO pour un scénario non iSCSI peut ne pas être configuré correctement. |
Lors du test dans un environnement de test MPIO non iSCSI, le test nécessite que l’adaptateur de bus hôte (HBA) avec au moins deux ports (ou au moins deux adaptateurs HBA, si l’adaptateur HBA n’a qu’un seul port) soit connecté à la même cible iSCSI. Les étapes manuelles suivantes peuvent vérifier que l’environnement de test est correctement configuré :
|
Le test ne parvient pas à obtenir l’appareil HBA instance lors de l’installation du filtre. |
Vérifiez que le nom DSM dans la clé de Registre (fichier INF) est identique au nom spécifié dans le DSM lui-même. |
Le test ne parvient pas à obtenir les informations WMI iSCSI lorsqu’il est connecté au périphérique de stockage de test via Fibre Channel et iSCSI lorsque le test s’exécute sur Fibre Channel. |
Nous vous recommandons de ne pas configurer les LUN MPIO qui sont revendiqués par le même DSM sur plusieurs types de bus dans le même environnement de test. |
Le test échoue lorsque des chemins d’accès sont supprimés après que le test a exécuté les cas de test de rebond de lien et de rebond simultané. |
Assurez-vous que l’adaptateur HBA exécute le dernier pilote (celui qui a passé la certification du logo Windows). Lors d’un test dans un environnement de test non iSCSI, le test d’E/S multi-chemin nécessite que le pilote HBA réussisse le test du pilote Plug-and-Play Driver. Si l’adaptateur HBA ne peut pas réussir ce test, remplacez par un autre modèle HBA certifié de HBA et retestez ce problème peut se produire car les chemins MPIO nécessitent beaucoup de temps pour être récupérés. |
Le test échoue lors de l’exécution dans un environnement de démarrage MPIO. |
N’exécutez pas le test dans un environnement de test de démarrage MPIO. |
Le test ne parvient pas à restaurer les sessions iSCSI sur la cible iSCSI. |
Dans l’environnement de test MPIO, s’il existe plusieurs ports (adresses IP) liés à une cible iSCSI, vous devez vous assurer qu’au moins deux sessions iSCSI sont connectées via l’adresse IP pendant le test. Bien que le test d’E/S multi-chemin d’accès autorise l’utilisateur à configurer plusieurs connexions de port à une cible iSCSI, en même temps pour tous les tests liés à iSCSI, l’utilisateur ne peut associer qu’une seule adresse IP pendant le test. |
Le test n’a pas affiché l’interface utilisateur iSCSI |
Tout d’abord, vérifiez que le type de bus LUN sélectionné est iSCSI. Si ce n’est pas le cas, le test d’E/S multi-chemin n’affiche pas l’interface utilisateur iSCSI. Deuxièmement, case activée si le fichier iscsihctconfig.ini est présent au chemin suivant : [WLKClient]\JobsWorkingDir\. Si ce fichier est présent, supprimez-le si vous souhaitez utiliser l’interface utilisateur iSCSI pour entrer manuellement les informations de configuration iSCSI. |
Le test a échoué ou s’est planté. |
Si le test d’E/S multi-chemin n’a pas pu s’exécuter, assurez-vous que l’environnement de test est propre avant de réexécuter le test. Ce problème peut se produire si votre contrôleur contenait initialement kit de logo Windows 1.5 et que vous n’avez pas réinstallé Windows avant d’installer et d’utiliser Windows Logokit 1.6 pour effectuer vos tests de stockage. Si cela s’est produit, réinstallez Windows et redémarrez vos tests. |
Le test échoue avec des erreurs d’opération d’E/S |
Si le test d’E/S multi-chemin a échoué et que le fichier journal contient des erreurs d’opérations d’E/S, vérifiez que vos LUN sont en ligne et initialisés dans le status brut avant d’exécuter le test. Si les LUN sont en ligne et initialisés, essayez de copier ou de lire un fichier à partir d’une LUN avec certains chemins d’accès basculés. |
Si vous avez l’intention d’ouvrir un incident de support, procédez comme suit pour obtenir des informations utiles aux services de support technique :
Fournissez votre package .cpk de soumission. Ce package .cpk doit non seulement inclure le journal t de test d’E/S multi-chemin, mais également inclure des journaux pour le test de conformité SCSI et le test MPIO ALUA.
Capturez des captures d’écran de votre environnement de test. Si le système d’exploitation est Windows 2008 R2 ou version ultérieure, capturez l’écran Capture instantanée de configuration MPIO à partir du Panneau de configuration. Pour l’afficher, cliquez sur Démarrer> Panneau de configuration> Capture instantanée de configurationMPIO>.
Si un incident s’est produit, créez un fichier de vidage. Réexécutez également le test suivant en étapes :
Copiez les fichiers binaires et les fichiers binaires de test sur l’ordinateur de test Windows HLK, notamment : mpiotest.exe, mpioinstallfiltr.exe, iscsiui.exe, devcon.exe, pnpfiltr.sys, pnpdtest.exe et le fichier mpiotest_script_fvt.txt.
Ouvrez une fenêtre d’invite de commande en tant qu’administrateur.
Exécutez l’une des commandes suivantes :
Si le type de bus est iSCSI, exécutez l’outil iscsui.exe et entrez les informations pour créer un fichier iscsihctconfig.ini.
Si le type de bus n’est pas iSCSI, exécutez la commande : mpioinstallfiltr -d <DSM device instance chemin> (par exemple ROOT\MPIO\0001) -i, puis redémarrez l’ordinateur de test. Si cette commande se bloque, copiez tous les fichiers journaux à partir de la console de commandes à l’aide du Bloc-notes.
Exécutez la commande suivante pour le test. Même si le test se bloque, vous pouvez toujours copier tout le journal de la console de commandes vers le bloc-notes.
- Mpiotest.exe -d <d’appareil DSM instance chemin> (par exemple ROOT\MPIO\0001) -s [ScriptName] -logo -isiSCSI [T/F].
Si le type de bus n’est pas iSCSI, exécutez la commande suivante à partir d’une invite de commandes pour désinstaller le pilote de filtre : mpioinstallfiltr -d <DSM device instance path>, (par exemple, ROOT\MPIO\0001) -c et redémarrez l’ordinateur de démarrage du système.
Plus d’informations
Ce test s’applique uniquement aux modules DSM (Device Specific Modules), Microsoft DSM ou un DSM tiers.
Le test comprend les assertions de test de base suivantes, qui sont combinées en quatre cas de test :
Basculement : le transfert de données n’est pas interrompu lorsque certains chemins d’accès sont rompus, mais pas tous.
Restauration automatique : le transfert de données fonctionne normalement lorsque certains chemins d’accès sont restaurés à partir du basculement.
Rebond de lien : pour un environnement MPIO, tous les chemins, à l’exception d’un chemin d’accès, sont rompus. Si ce chemin d’accès est rompu et qu’il est récupéré dans un délai de 15 secondes, le transfert de données peut se poursuivre sans erreur.
Basculement et restauration simultanés, ou « rebond simultané » : le transfert de données n’est pas interrompu lorsque certains chemins basculent et que d’autres chemins échouent simultanément.
Stratégie d’équilibrage de charge : une stratégie différente peut être définie et le transfert de données peut fonctionner correctement avec elle. Pour la stratégie de charge tourniquet et la stratégie de charge tourniquet avec sous-ensemble, le test vérifie si l’efficacité est dégradée.
Les composants de test incluent une application de test autonome, un pilote de filtre d’injection d’erreur, un fichier de configuration de cas de test, un fichier de configuration iSCSI (si le chemin d’accès est créé via une session iSCSI) et le Gestionnaire de test de périphériques (DTM).
Les clients d’une solution de stockage d’entreprise dépendent fortement de la haute disponibilité de ses composants. Dans le stockage, la haute disponibilité est souvent implémentée par redondance. Les E/S multi-chemins (MPIO) sont l’une de ces implémentations pour la couche fabric d’une solution de stockage d’entreprise. Microsoft prend en charge les E/S multi-chemins avec un pilote multi-chemin (mpio.sys) et un module spécifique à l’appareil (msdsm.sys) fourni avec le système d’exploitation Windows Advanced Server dans la période Windows Vista.
Le test fournit des tests d’E/S multi-chemins pour la compatibilité de la solution de stockage d’un fournisseur avec les solutions de pilotes Microsoft. Il se concentre sur les domaines suivants :
Le basculement et la récupération de chemin d’accès ne doivent pas affecter la qualité du transfert des données. L’un des objectifs de la configuration d’un environnement MPIO est d’augmenter la fiabilité du transfert de données. Ce test simule plusieurs scénarios simples qui se produiraient dans le monde réel pour interrompre un chemin d’accès, puis vérifie si l’environnement peut transférer des données normalement.
L’efficacité du transfert de données doit être améliorée, ou du moins pas dégradée, dans un environnement MPIO.
Les appareils de stockage doivent fonctionner normalement selon toutes les stratégies qu’ils déclarent prendre en charge.
Notes
Pour un module spécifique à l’appareil (DSM) qui prend en charge la stratégie du fournisseur (valeur de stratégie est 7), faites de la stratégie du fournisseur la stratégie actuelle avant d’exécuter ce test.
Pour exécuter ce test
Le kit Windows Hardware Lab (Windows HLK) démarre l’application de test autonome, qui récupère les cas de test à exécuter.
Windows HLK récupère les informations de l’environnement de test MPIO pour des tests supplémentaires.
Si un chemin d’accès n’est pas sur iSCSI, le test charge le pilote de filtre pour un instance HBA associé pour des tests supplémentaires.
Si le chemin d’accès est sur iSCSI, fournissez les informations de configuration iSCSI de l’une des manières suivantes :
Entrez les données de configuration dans la fenêtre contextuelle du client de test, qui crée le fichier Iscsihctconfig.ini sous [CHEMIN D’ACCÈS WLK]\JobsWorkingDir\Tasks\[WTTJOBNAME]\. Pour plus d’informations, consultez Test de démarrage iSCSI HBA (LOGO).
Notes
Si votre environnement de test comprend plusieurs cibles, choisissez d’entrer une seule information liée à la cible, notamment IQN, l’adresse IP du portail et le numéro de port. Pour l’adresse IP, si vous avez plusieurs adresses IP, entrez celle utilisée pour connecter cette cible. Pour le test MPIO, vous n’avez pas besoin d’entrer l’ID PnP HBA.
Notes
Si votre iSCSI personnaliser l'environnement chap mutuel, veuillez case activée à la fois case d’option mutuelle et prise en charge de l’case activée chap mutuel.
Les informations de configuration iSCSI d’entrée sont stockées dans le fichier de iscsihctconfig.ini. Pour gagner du temps aux utilisateurs, nous avons placé une copie de ce fichier de configuration sous [WLKClient]\JobsWorkingDir\ sur l’ordinateur de test. Les utilisateurs peuvent ensuite réexécuter le test sur le même client de test pour la même cible de stockage iSCSI sans réinscrire les informations de configuration iSCSI. En outre, avant de tester, les utilisateurs peuvent choisir de créer manuellement le fichier Iscsihctconfig.ini et de le placer sous [WLKClient] \JobsWorkingDir\ sur l’ordinateur de test, qui contient les données de configuration. Utilisez le format suivant :
[Targets] DiskTarget=Target [Target] TargetName=iqn.2001-05.com.equallogic:0-8a0906-7e2dd0401-fd1d03f67f74b96b-10-2411a0920-0 PortalPort=3260 PortalIPAddress=10.10.20.80 CHAPType=None
Définissez la stratégie d’équilibre de charge, qui déclare la prise en charge, simule les scénarios de basculement et de restauration automatique, et effectue des tests. Pour un environnement de test non iSCSI, simulez les scénarios de rebond des liens et de rebond simultané.
Définissez la stratégie Round Robin pour le stockage non-ALUA et le stockage ALUA pour activer la vérification des performances.
L’outil de test se connecte à WTTLogger.
Syntaxe de commande
| Commande | Description |
|---|---|
mpiotest.exe -d « [WDKDeviceID] » -s [ScriptName] -logo -isiSCSI [isiSCSI] |
Exécute le test. |
Notes
Pour obtenir de l’aide en ligne de commande pour ce binaire de test, tapez /h.
Liste de fichiers
| File | Emplacement |
|---|---|
Devcon.exe |
<[testbinroot]>\idw\ |
EDT_Disable_Support.vbs |
<[testbinroot]>\nttest\DriversTest\storage\wdk\mpiotest\ |
EDT_Enable_Support.vbs |
<[testbinroot]>nttest\DriversTest\storage\wdk\mpiotest\ |
Iscsiui.exe |
<[testbinroot]>\nttest\DriversTest\storage\wdk\mpiotest\ |
Mpioinstallfiltr.exe |
<[testbinroot]>\nttest\DriversTest\storage\wdk\mpiotest\ |
Mpiotest.exe |
<[testbinroot]>\nttest\nttest\DriversTest\storage\wdk\ |
Mpiotest_script_fvt.txt |
<[testbinroot]>\nttest\DriversTest\storage\wdk\mpiotest\ |
DevFund_PnPDTest_WLK.dll |
<[testbinroot]>\ |
Utility_Enable_Disable_DriverVerifier.dll |
<[testbinroot]>\ |
Utility_DeviceStatusCheck.wsc |
<[testbinroot]>\ |
Utility_DisableEDTSupport.wsc |
<[testbinroot]>\ |
Utility_EmptyTest.wsc |
<[testbinroot]>\ |
Utility_WdfRelatedVerification.wsc |
<[testbinroot]>\ |
Paramètres
| Nom du paramètre | Description des paramètres |
|---|---|
| LLU_NetAccessOnly | Compte d’utilisateur pour accéder au partage de fichiers de test. |
| LLU_LclAdminUsr | Compte d’utilisateur pour l’exécution du test. |
| ScriptName | Script de test complet |
| WDKDeviceID | Chemin d’instance de l’appareil à tester |
| isiSCSI | Est de type de bus de stockage iSCSI (T/F) |