Using MPCLAIM
Gestion du multipath intégré en ligne de commande
Comment utiliser MPCLAIM :
Utilis‚ pour n'importe laquelle des tƒches suivantesÿ:
- Afficher les ID mat‚riels du stockage sur le systŠme.
- R‚clamations/annulations de r‚clamation MSDSM pour la prise en charge MPIO des p‚riph‚riques accept‚s.
- Afficher la configuration MPIO actuelle.
- Afficher/D‚finir la strat‚gie d'‚quilibrage de charge pour un p‚riph‚rique, parmi
ceux ayant un ID sp‚cifique ou pour tous les p‚riph‚riques demand‚s par le MSDSM.
Afficher le stockage disponible/pris en charge par le MSDSMÿ:
mpclaim query_switch
query_switch Affiche tous les stockages de type entreprise (ex,
Fibre, iSCSI, SAS) ou la liste des p‚riph‚riques pris en
charge par le MSDSM.
-e Interroge les stockages d'entreprise connect‚s et les affiche
comme chaŒnes id de produit vendeur.
-h Affiche les stockages pris en charge par le MSDSM.
Utilisation des r‚clamations/annulations de r‚clamationÿ:
mpclaim reboot_opt claim_switch device_switch device_hwid(s)
reboot_opt Indique si le red‚marrage est automatique
-r red‚marrage automatique (si n‚cessaire) sans invite.
-n suppression de la demande de red‚marrage (l'appelant devra peut-ˆtre red‚marrer).
claim_switch Ajouter ou supprimer la prise en charge des chemins d'accŠs multiples (par contr“le du
MSDSM).
-i Ajouter la prise en charge des chemins d'accŠs multiples pour les p‚riph‚riques.
-u Supprimer la prise en charge des chemins d'accŠs multiples pour les p‚riph‚riques.
device_switch Appliquer les options ci-dessus … tous les p‚riph‚riques ou … ceux qui sont accept‚s.
-d Les paramŠtres aprŠs cette option indiquent les ID mat‚riels
des p‚riph‚riques.
-a Fonctionne sur tous les p‚riph‚riques applicables.
-c Fonctionne uniquement sur tous les p‚riph‚riques compatibles SPC3 (applicable uniquement aux
r‚clamations. Avec -u, il sera trait‚ comme -a.)
device_hwid ID mat‚riels des p‚riph‚riques … rendre compatibles MPIO, en tant que chaŒnes de
vendeur8produit16, d‚limit‚es par un espace. (Utiliser une chaŒne vide
avec l'option -a.)
Utilisation de la configuration de l'affichageÿ:
mpclaim config_option nomfichier
config_option Indique si des informations de base ou d‚taill‚es sont affich‚es.
-b Affiche des informations de base en premier.
-v Affiche des informations d‚taill‚es sur la configuration actuelle.
filename Nom du fichier de sortie de la configuration.
Afficher/modifier l'utilisation de la strat‚gie d'‚quilibrage de chargeÿ:
paramŠtres apply_to de l'op‚ration mpclaim
operation Indique si les paramŠtres de strat‚gie doivent ˆtre d‚finis.
-s Affiche le paramŠtre d'‚quilibrage de charge.
-l D‚finit le paramŠtre d'‚quilibrage de charge.
apply_to Indique si la commande s'applique … un p‚riph‚rique sp‚cifique,
avec un ID mat‚riel sp‚cifique ou revendiqu‚s par le MSDSM.
-d L'op‚ration s'applique … un p‚riph‚rique sp‚cifique.
-m L'op‚ration s'applique … tous les p‚riph‚riques contr“l‚s par le MSDSM pour
lesquels une strat‚gie n'a pas d‚j… ‚t‚ explicitement d‚finie.
-t L'op‚ration s'applique … tous les p‚riph‚riques contr“l‚s par le MSDSM avec un
ID mat‚riel correspondant pour lesquels une strat‚gie n'a pas d‚j… ‚t‚
explicitement d‚finie.
paramŠtres Si vous utilisez le commutateur d'op‚ration '-s'ÿ:
Le seul paramŠtre significatif que vous puissiez fournir est un num‚ro de disque MPIO
lorsque vous utilisez le commutateur apply_to '-d'. Dans ce cas,
les informations sp‚cifiques au disque seront affich‚es. Si vous ne fournissez pas
de num‚ro de disque, tous les disques MPIO seront affich‚s avec
uniquement des informations de base sur chacun.
Lorsque vous consultez des informations sur un disque en particulier, un ast‚risque
plac‚ devant le chemin affich‚ indique le chemin de restauration
automatique pr‚f‚r‚ lorsque la strat‚gie d'‚quilibrage de charge est Basculement uniquement. Un
ast‚risque plac‚ devant le groupe de ports cibles indique
qu'il s'agit du groupe de ports cibles pr‚f‚r‚.
Si vous utilisez le commutateur d'op‚ration '-l'ÿ:
Les paramŠtres de strat‚gie d'‚quilibrage de charge valides sontÿ:
0 = Supprimer la strat‚gie
1 = Basculement uniquement
2 = Tourniquet
3 = Tourniquet avec sous-ensemble
4 = Longueur minimale de la file d'attente
5 = Chemins d'accŠs mesur‚s
6 = Plus petits blocs
7 = Sp‚cifique au vendeur
Avec le commutateur apply_to '-t', le format de paramŠtre est le suivantÿ:
IDMat‚riel Strat‚giequilibrageCharge
Les ID mat‚riels peuvent ˆtre obtenus … l'aide du commutateur '-e' comme
indiqu‚ pr‚c‚demment.
La strat‚gie peut ˆtre choisie parmi n'importe lequel des num‚ros pr‚c‚dents … l'exception des strat‚gies
Tourniquet avec sous-ensemble et Chemins d'accŠs mesur‚s car
des informations de chemin sp‚cifiques doivent leur ˆtre d‚finies.
Cependant, si vous choisissez la strat‚gie Tourniquet, tous les disques compatibles ALUA
seront automatiquement d‚finis sur
Tourniquet avec sous-ensemble.
Avec le commutateur apply_to '-m', vous ne devez sp‚cifier qu'un
des num‚ros de strat‚gie ci-dessus. Notez que vous ne pouvez pas sp‚cifier les
strat‚gies sur Tourniquet avec sous-ensemble et Chemins d'accŠs mesur‚s car
des informations de chemin sp‚cifiques doivent leur ˆtre d‚finies.
Cependant, si vous choisissez la strat‚gie Tourniquet, tous les disques compatibles ALUA
seront automatiquement d‚finis sur la strat‚gie Tourniquet
avec sous-ensemble.
Avec le commutateur apply_to '-d', le format de base est le suivantÿ:
Num‚roDisqueMPIO Strat‚giequilibrageCharge
En fonction de la strat‚gie s‚lectionn‚e, vous devrez peut-ˆtre sp‚cifier
des paramŠtres suppl‚mentaires.
Pour la strat‚gie Basculement uniquement, il est possible de ne sp‚cifier que
le chemin Actif/optimis‚. Tous les autres chemins seront d‚finis
sur l'‚tat Actif/non optimis‚ ou Veille, sauf si leur ‚tat de chemin
est d‚j… explicitement d‚fini. Dans l'‚ventualit‚ o— la strat‚gie actuelle est
d‚j… d‚finie sur Basculement uniquement, le chemin
Actif/optimis‚ doit ˆtre explicitement d‚fini par
un ‚tat Non actif/optimis‚ et l'Id de chemin qui doit ˆtre maintenant
modifi‚ en Actif/optimis‚. Le format est le suivantÿ:
IDChemin tat Poids Pr‚f‚r‚
tat doit ˆtre sp‚cifi‚ de la fa‡on suivanteÿ:
0 = Actif/optimis‚
1 = Actif/non optimis‚
2 = Veille
3 = Non disponible
Poids est ignor‚ pour cette strat‚gie.
Pr‚f‚r‚ doit ˆtre sp‚cifi‚ de la fa‡on suivanteÿ:
0 = Faux
1 = Vrai
Pour la strat‚gie Tourniquet avec sous-ensemble, il est possible de ne sp‚cifier que
les chemins Non actif/optimis‚. Les chemins non sp‚cifi‚s
seront d‚finis sur Actif/optimis‚ ou sur l'‚tat Actif/optimis‚ du groupe
de ports cibles correspondant. Le format est le suivantÿ:
IDChemin tat Poids Pr‚f‚r‚
tat doit ˆtre sp‚cifi‚ comme indiqu‚ ci-dessus.
Poids est ignor‚ pour cette strat‚gie.
Pr‚f‚r‚ est ignor‚ pour cette strat‚gie.
Pour Chemins d'accŠs mesur‚s, les ‚tats de chemin doivent ˆtre d‚finis sur
Actif/optimis‚ ou sur l'‚tat du groupe de ports cibles correspondant
et les mesures de chemin d‚finies par d‚faut sur 0 pour les chemins
dont les mesures n'ont pas ‚t‚ explicitement d‚finies.
Le format est le suivantÿ:
IDChemin tat Poids Pr‚f‚r‚
tat doit ˆtre sp‚cifi‚ comme indiqu‚ ci-dessus.
Poids doit ˆtre sp‚cifi‚ comme un entier positif.
Pr‚f‚r‚ est ignor‚ pour cette strat‚gie.
Pour Longueur minimale de la file d'attente et Plus petits blocs, les ‚tats de chemin doivent
ˆtre d‚finis sur Actif/optimis‚ ou l'‚tat du groupe
de ports cibles correspondant.
Pour un disque donn‚ revendiqu‚ par le MSDSM, les niveaux de strat‚gie d'‚quilibrage de charge se pr‚sentent
dans l'ordre suivantÿ:
1. La strat‚gie explicitement d‚finie pour le disque (via '-l -d'
ou l'application du panneau de configuration MPIO .
2. La strat‚gie d‚finie pour l'Id mat‚riel du disque (via '-l -t').
3. La strat‚gie du MSDSM (via '-l -m').
4. Tourniquet si le disque est non-ALUA, Tourniquet avec sous-ensemble dans les autres cas.
En cons‚quence, si aucune strat‚gie n'est explicitement d‚finie pour le disque lui-mˆme, ni pour
l'ID mat‚riel du disque, mais qu'une strat‚gie … l'‚chelle du MSDSM est d‚finie, le disque
utilisera la strat‚gie d'‚quilibrage de charge … l'‚chelle du MSDSM. Toutefois, si une strat‚gie est d‚finie pour
l'ID mat‚riel du disque, cette strat‚gie sera utilis‚e mˆme si une strat‚gie … l'‚chelle du MSDSM
a ‚t‚ d‚finie.
Exemplesÿ:
Pour d‚finir le paramŠtre MPIO du disque2 comme Basculement uniquement avec l'ID de chemin 0000000077030000 d‚fini sur
Actif/Optimis‚ et ‚tant le chemin d'accŠs pr‚f‚r‚ pour la restauration automatiqueÿ:
mpclaim -l -d 2 1 0000000077030000 0 0 1
Lorsque Basculement uniquement est d‚j… d‚fini sur MPIO Disque3 et l'Id de chemin
0000000077030000 est d‚fini sur Actif/optimis‚, pour d‚finir l'Id de chemin
0000000077030000 sur Veille et l'Id de chemin 0000000077030001 sur
Actif/optimis‚ÿ:
mpclaim -l -d 3 1 0000000077030000 2 0 0 0000000077030001 0 0 0
Pour d‚finir le paramŠtre MPIO du Disque1 comme Tourniquet avec sous-ensemble avec l'ID de chemin
0000000077030000 d‚fini sur Actif/Optimis‚ et l'ID de chemin 0000000077030001 d‚fini sur l'‚tat
Veilleÿ:
mpclaim -l -d 1 3 0000000077030000 0 0 0 0000000077030001 2 0 0
Pour d‚finir le paramŠtre MPIO du Disque4 comme Chemins d'accŠs mesur‚s avec l'ID de chemin 0000000077030000 d‚fini sur
Actif/Optimis‚ et un poids de chemin ‚gal … 25ÿ:
mpclaim -l -d 4 5 0000000077030000 0 25 0
Pour effacer la strat‚gie d'‚quilibrage de charge au niveau des LUN pour le MPIO Disque1ÿ:
mpclaim -l -d 1 0
Pour afficher des informations d‚taill‚es pour le paramŠtre MPIO Disque5ÿ:
mpclaim -s -d 5
Lors de l'affichage ou de la d‚finition de strat‚gies d'‚quilibrage de charge avec le commutateur ®ÿ-dÿ¯
le num‚ro de disque MPIO est utilis‚ pour adresser le disque. Pour mapper les num‚ros de disque MPIO
aux num‚ros systŠme, utilisezÿ:
mpclaim -s -d
Pour d‚finir la strat‚gie d'‚quilibrage de charge par d‚faut de tous les LUN contr“l‚s par le MSDSM sur
Longueur minimale de la file d'attenteÿ:
mpclaim -l -m 4
Pour d‚finir la strat‚gie d'‚quilibrage de charge par d‚faut de tous les LUN correspondant … l'ID mat‚riel
IDProduitIDVendeur sur Plus petits blocsÿ:
mpclaim -l -t IDProduitIDVendeur 6
Pour supprimer les strat‚gies d'‚quilibrage de charge … l'‚chelle de la cibleÿactuellement d‚finiesÿ:
mpclaim -s -t
Exemple de résultat via MPCLAIM
================================================================================
Premier résultat (pas de disque géré):
--------------------------------------
Instantané de stockage MPIO sur Vendredi, 24 Janvier 2014, à 16:56:26.712
DSM enregistrés : 1
================
+--------------------------------|-------------------|----|----|----|---|-----+
|DSM Name | Version |PRP | RC | RI |PVP| PVE |
|--------------------------------|-------------------|----|----|----|---|-----|
|Microsoft DSM |006.0003.09600.16384|0020|0003|0001|030| Faux|
+--------------------------------|-------------------|----|----|----|---|-----+
Microsoft DSM
=============
MPIO Disk0 : 01 chemins d’accès, Tourniquet, ALUA non pris en charge
SN : 606E8010D23E05304A4600013
Stratégies d’équilibrage de charge prises en charge : FOO DD RRWS LQD WP LB
ID de chemin d’accès État Adresse SCSI Poids
---------------------------------------------------------------------------
0000000077030000 Actif/optimisé 003|000|000|000 0
Carte : Carte QLogic Fibre Channel... (B|D|F: 010|000|000)
Contrôleur : 46616B65436F6E74726F6C6C6572 (État : Actif)
Stratégie d’équilibrage de charge par défaut à l’échelle du MSDSM: N\A
Aucune stratégie d’équilibrage de charge par défaut au niveau cible n’a été définie.
================================================================================