Exemples de commandes EMC PowerPath Powermt
Si votre serveur possède plusieurs cartes FC, il est possible d’utiliser le ‘Load Balancing’ ou le ‘Failover’ pour mieux sécuriser.
Pour cela, il faut installer les couches logicielles d’EMC PowerPath.
Cet outil, représenté par la commande ‘powermt’, aide à gérer les chemins d’accès aux disques.
Dans cet article, quelques exemples pratiques expliquent le fonctionnement de la commande.
powermt display – Affichage des chemins.
La commande ‘powermt display’, sans argument, affiche les différentes cartes disponibles et leur état respectif.
root:/home/root #powermt display
Symmetrix logical device count=0
CLARiiON logical device count=1
Hitachi logical device count=0
HP xp logical device count=0
Ess logical device count=0
Invista logical device count=0
==============================================================================
----- Host Bus Adapters --------- ------ I/O Paths ----- ------ Stats ------
### HW Path Summary Total Dead IO/Sec Q-IOs Errors
==============================================================================
0 fscsi1 optimal 1 0 - 0 0
L’exemple suivant montre 2 cartes connectées au réseau de stockage en conditions optimales de fonctionnement.
Chacune de ces cartes possède 2 chemins.
Cette liste montre également qu’il s’agit d’une baie Clariion, ceci étant indiqué par la ligne “CLARiiON logical device count=1” .
# powermt display
Symmetrix logical device count=0
CLARiiON logical device count=1
Hitachi logical device count=0
Invista logical device count=0
HP xp logical device count=0
Ess logical device count=0
HP HSx logical device count=0
==============================================================================
----- Host Bus Adapters --------- ------ I/O Paths ----- ------ Stats ------
### HW Path Summary Total Dead IO/Sec Q-IOs Errors
==============================================================================
1 qla2xxx optimal 2 0 - 0 0
2 qla2xxx optimal 2 0 - 0 0
1.‘powermt display dev=all’ – Affichage des Luns.
Cette commande est la plus utilisée puisqu’elle affiche à la fois les cartes, mais aussi les disques virtuels et leurs chemins possibles.
# powermt display dev=all
Pseudo name=emcpowera
CLARiiON ID=AAA00000000000 [dev-server]
Logical device ID=1111111111111111111 [LUN 1]
state=alive; policy=CLAROpt; priority=0; queued-IOs=0
Owner: default=SP B, current=SP B Array failover mode: 1
==============================================================================
---------------- Host --------------- - Stor - -- I/O Path - -- Stats ---
### HW Path I/O Paths Interf. Mode State Q-IOs Errors
==============================================================================
1 qla2xxx sdd SP A4 active alive 0 0
1 qla2xxx sde SP B4 active alive 0 0
2 qla2xxx sdf SP A5 active alive 0 0
2 qla2xxx sdg SP B5 active alive 0 0
Pseudo name=emcpowerb
CLARiiON ID=AAA00000000000 [dev-server]
Logical device ID=2111111111111111111 [LUN 2]
state=alive; policy=CLAROpt; priority=0; queued-IOs=0
Owner: default=SP A, current=SP A Array failover mode: 1
==============================================================================
---------------- Host --------------- - Stor - -- I/O Path - -- Stats ---
### HW Path I/O Paths Interf. Mode State Q-IOs Errors
==============================================================================
1 qla2xxx sdh SP A4 active alive 0 0
1 qla2xxx sdi SP B4 active alive 0 0
2 qla2xxx sdj SP A5 active alive 0 0
2 qla2xxx sdk SP B5 active alive 0 0
L’exemple ci-dessus montre une configuration avec 2 disques logiques( emcpowera et emcpowerb), chacun ayant 4 chemins pour parvenir à la baie.
Détail des éléments du rapport :
Pseudo name=emcpowera – Le nom système du disque logique.
CLARiiON ID=AAA00000000000 [dev-server] – Numéro de série de la baie.
Logical device ID=11111111 [LUN 1] – Numéro de LUN.
state=alive; policy=CLAROpt; – Etat de la LUN et mode de gestion des chemins.
Owner: default=SP B, current=SP B – Indique les contrôleurs disques utilisés, par défaut ou au moment de la commande.
2.‘powermt display dev=emcpowera’ – Information d’une LUN.
Il est possible de préciser la LUN que l’on souhaite consulter en précisant son nom avec l’option ‘dev=’.
# powermt display dev=emcpowera
Pseudo name=emcpowera
CLARiiON ID=AAA00000000000 [dev-server]
Logical device ID=1111111111111111111 [LUN 1]
state=alive; policy=CLAROpt; priority=0; queued-IOs=0
Owner: default=SP B, current=SP B Array failover mode: 1
==============================================================================
---------------- Host --------------- - Stor - -- I/O Path - -- Stats ---
### HW Path I/O Paths Interf. Mode State Q-IOs Errors
==============================================================================
1 qla2xxx sdd SP A4 active alive 0 0
1 qla2xxx sde SP B4 active alive 0 0
2 qla2xxx sdf SP A5 active alive 0 0
2 qla2xxx sdg SP B5 active alive 0 0
Si le disque n’est pas disponible, vous aurez un message tel que affiché ci-dessous.
# powermt display dev=emcpowerc
Bad dev value emcpowerc, or not under Powerpath control.
3. ‘powermt check_registration’ – Information sur licence.
Si vous avez perdu la clé de licence utilisée lors de l’installation, il est possible de la récupérer par la commande suivante :
# powermt check_registration
Key AAAA-BBBB-CCCC-DDDD-EEEE-FFFF
Product: PowerPath
Capabilities: All
4.‘powermt display options – Options du PowerPath.
Affiche les options des composants logiciels activés.
# powermt display options
Default storage system class: all
Show CLARiiON LUN names: true
Path Latency Monitor: Off
Path Latency Threshold: 0 Sec.
Storage
System Class Attributes
------------ ----------
Symmetrix periodic autorestore = on
status = managed
CLARiiON periodic autorestore = on
status = managed
Hitachi periodic autorestore = on
status = managed
Invista periodic autorestore = on
status = managed
HP xp periodic autorestore = on
status = managed
Ess periodic autorestore = on
status = managed
HP HSx periodic autorestore = on
status = managed
5.‘powermt display hba_mode’ – Affiche le mode de fonctionnement des cartes.
Commande similaire à la précédente, mais indique également si la carte est disponible ou pas.
# powermt display hba_mode
Symmetrix logical device count=0
CLARiiON logical device count=1
Hitachi logical device count=0
Invista logical device count=0
HP xp logical device count=0
Ess logical device count=0
HP HSx logical device count=0
==============================================================================
----- Host Bus Adapters --------- ------ I/O Paths ----- Stats
### HW Path Summary Total Dead Q-IOs Mode
==============================================================================
1 qla2xxx optimal 2 0 0 Enabled
2 qla2xxx optimal 2 0 0 Enabled
6. ‘powermt display path’ – Affiche l’état des chemins.
Cette commande affiche les chemins disponibles pour le disque donné.
.
# powermt display paths
Symmetrix logical device count=0
==============================================================================
----- Host Bus Adapters --------- ------ Storage System ----- - I/O Paths -
### HW Path ID Interface Total Dead
==============================================================================
CLARiiON logical device count=1
==============================================================================
----- Host Bus Adapters --------- ------ Storage System ----- - I/O Paths -
### HW Path ID Interface Total Dead
==============================================================================
1 qla2xxx AAA00000000000 SP A4 1 0
1 qla2xxx AAA00000000000 SP B4 1 0
2 qla2xxx AAA00000000000 SP A5 1 0
2 qla2xxx AAA00000000000 SP B5 1 0
Hitachi logical device count=0
==============================================================================
----- Host Bus Adapters --------- ------ Storage System ----- - I/O Paths -
### HW Path ID Interface Total Dead
==============================================================================
Invista logical device count=0
==============================================================================
----- Host Bus Adapters --------- ------ Storage System ----- - I/O Paths -
### HW Path ID Interface Total Dead
==============================================================================
HP xp logical device count=0
==============================================================================
----- Host Bus Adapters --------- ------ Storage System ----- - I/O Paths -
### HW Path ID Interface Total Dead
==============================================================================
Ess logical device count=0
==============================================================================
----- Host Bus Adapters --------- ------ Storage System ----- - I/O Paths -
### HW Path ID Interface Total Dead
==============================================================================
HP HSx logical device count=0
==============================================================================
----- Host Bus Adapters --------- ------ Storage System ----- - I/O Paths -
### HW Path ID Interface Total Dead
==============================================================================
7. ‘powermt displays port_mode’ – Affiche le statut des ports.
Affiche le statut d’un port spécifique d’une carte.
Celui-ci pourra être ‘Enabled’ ou pas.
# powermt display port_mode
Storage class = Symmetrix
==============================================================================
----------- Storage System --------------- -- I/O Paths -- --- Stats ---
ID Interface Wt_Q Total Dead Q-IOs Mode
==============================================================================
Storage class = CLARiiON
==============================================================================
----------- Storage System --------------- -- I/O Paths -- --- Stats ---
ID Interface Wt_Q Total Dead Q-IOs Mode
==============================================================================
AAA00000000000 SP A4 256 1 0 0 Enabled
AAA00000000000 SP B4 256 1 0 0 Enabled
AAA00000000000 SP A5 256 1 0 0 Enabled
AAA00000000000 SP B5 256 1 0 0 Enabled
8.‘powermt version’ – Version de PowerPath.
La commande permet d’afficher la version de PowerPath.
# powermt version
EMC powermt for PowerPath (c) Version 5.3 (build 185)
9.‘powermt check’ – Check the I/O Paths
Si des changements ont été effectués sur les cartes ou les chemins, il faut exécuter la commande ‘powermt check’ pour les appliquer.
Par exemple, si vous avez retiré un chemin manuellement, la commande détecte le changement et retire le disque correspondant de la liste.
# powermt check
Warning: storage_system I/O path path_name is dead.
Do you want to remove it (y/n/a/q)?
Note: If you want powermt to automatically remove all dead paths, without any confirmation, execute “powermt check force”.
powermt set mode hba – Forcefully set the mode for a specific HBA
You can change the mode of a specific HBA to either standby or active using this command. Following example, changes HBA #1′s mode from active to standby.
# powermt set mode=standby hba=1
After the above command, you can see the mode for HBA#1 changed to standby, as shown below.
# powermt display dev=all
Pseudo name=emcpowera
CLARiiON ID=AAA00000000000 [dev-server]
Logical device ID=1111111111111111111 [LUN 1]
state=alive; policy=CLAROpt; priority=0; queued-IOs=0
Owner: default=SP B, current=SP B Array failover mode: 1
==============================================================================
---------------- Host --------------- - Stor - -- I/O Path - -- Stats ---
### HW Path I/O Paths Interf. Mode State Q-IOs Errors
==============================================================================
1 qla2xxx sdd SP A4 standby alive 0 0
1 qla2xxx sde SP B4 standby alive 0 0
2 qla2xxx sdf SP A5 active alive 0 0
2 qla2xxx sdg SP B5 active alive 0 0
Note: Si le chemin est ‘unlic’, cela indique que la license n’a pas été renseignée.
Note: Certaines commandes powermt sont réservées pour quelques plateformes système. (Par exemple powermt set port_disable), — Sur AIX et Solaris, seul le ‘Fibre channel’ est supporté. Sur HP-UX, seul iSCSI et Fibre sont supportés. Sur Linux, seul iSCSI (HBAs) et Fibre sont supportés.
10.“powermt remove” – Effacer un chemin.
Cette commande permet d’effacer un chemin ou la definition d’un disque logique entire.
Dans le cadre d’un remplacement de carte ou du remplacement d’un adapteur physique par du virtuel, il est intéressant d’utiliser cette méthode.
L’exemple suivante montre 4 chemins.
# powermt display dev=all
==============================================================================
---------------- Host --------------- - Stor - -- I/O Path - -- Stats ---
### HW Path I/O Paths Interf. Mode State Q-IOs Errors
==============================================================================
1 qla2xxx sdd SP A4 standby alive 0 0
1 qla2xxx sde SP B4 standby alive 0 0
2 qla2xxx sdf SP A5 active alive 0 0
2 qla2xxx sdg SP B5 active alive 0 0
Pour retirer le chemin ‘sdd’, utiliser la commande suivante :
# powermt remove dev=sdd
# powermt display dev=all
==============================================================================
---------------- Host --------------- - Stor - -- I/O Path - -- Stats ---
### HW Path I/O Paths Interf. Mode State Q-IOs Errors
==============================================================================
1 qla2xxx sde SP B4 standby alive 0 0
2 qla2xxx sdf SP A5 active alive 0 0
2 qla2xxx sdg SP B5 active alive 0 0
La commande suivante va tenter d’effacer le disque emcpowera dans la mesure ou celui-ci n’est pas en cours d’utilisation par le système.
Suivant les cas, des incohérences peuvent apparaître si une seule partie des unités de définitions d’un disque est retirée.
# powermt remove dev=emcpowera
11.powermt config – Configure PowerPath
Cette commande configure les unités disques EMC SAN en ajoutant les nouvelles définitions.
Cette commande remet également certaines valeurs par défaut.
Par exemple, write throttling = off, HBA mode = active, CLARiiON policy = CLAROpt, etc.
Les valeurs possibles pour la ‘policy’ EMC SAN LUN sont: Adaptive, BasicFailover, CLAROpt, LeastBlocks, LeastIos, NoRedirect, Request, RoundRobin, StreamIO, ou SymmOpt.
Après la commande ‘powermt config’, si certaines valeurs ne vous plaisent pas, vous devrez les changer manuellement.
# powermt config
powermt restore – Make Dead I/O Path Alive
Si vous avez des chemins inactifs mais que vous avez effectué les corrections nécessaires pour les réactiver, vous pouvez utiliser la commande ‘powermt restore pour revalider l’ensemble.
Quand on lance la commande “powermt restore », il effectue une vérification des chemins d’accès. Si un chemin précédemment actif est en panne, il passera alors ‘inactif’.
Dans certains cas, si vous constatez que le ‘owner’ par défaut et le owner courant d’une LUN n’est pas le meme processeur, il faut executer la commande suivante qui rétablira les meme valeurs.
# powermt restore dev=all
Vous pouvez remplacer la valeur ‘dev’ par ‘class’ dans cette commande.
La valeur de l’option ‘class’ peut avoir les valeurs suivantes, suivant le système :
symm – Symmetrix
clariion - CLARiiON
invista – Invista
ess – IBM ESS
hitachi – Hitachi Lightning TagmaStore
hpxp - HP StorageWorks XP, or EVA series
hphsx – HP StorageWorks EMA, or MA
all – All systems
12.Powermt Save and Load – Gestion des configurations powerpath.
1. powermt save – Sauvegarde la configuration.
Si vous avez changé les configurations de chemins pour certains tests, vous pouvez sauvegarder la configuration en utilisant la commande ‘powermt save’.
# powermt save
Ceci va sauvegarder la configuration courante dans le fichier ‘/etc/powermt.custom’.
Ci-dessous un extrait du fichier :
# cat /etc/powermt.custom
global:version:5.3.0.0.0:4.1.0
path_c:sdd:sdd:qla2xxx:0x111
path_c:sde:sde:qla2xxx:0x111
adapter: 1: 1:qla2xxx:0x111:1:0:111:0:11:0
adapter: 2: 2:qla2xxx:0x111:1:0:111:0:111:0
arrPort_c:04000000:04000000:111:111
mpext_cfg:unused:Mp:0:symm:0:0
...
...
Pour sauvegarder dans un fichier différent, passer l’argument ‘file’ comme affiché ci-dessous :
# powermt save file=/etc/powermt.11-Aug-2012
powermt load – Load a previously saved EMC PowerPath Configuration
Quand vous testez une configuration PowerPath il est possible de revenir à une configuration précédente en utilisant la commande ‘powermt load’.
