Utilisez les commandes esxcli pour ajouter une règle de réclamation de gestion multivoie PSA à l'ensemble de règles de réclamation sur le système. Pour activer la nouvelle règle de réclamation, définissez d'abord la règle puis chargez-la sur votre système.

Avant de commencer

Installez vCLI ou déployez la machine virtuelle vSphere Management Assistant (vMA). Reportez-vous à la section Démarrage avec vSphere Command-Line Interfaces. Pour le dépannage, exécutez les commandes esxcli dans ESXi Shell.

Pourquoi et quand exécuter cette tâche

Ajoutez une nouvelle règle de réclamation PSA lorsque, par exemple, vous chargez un nouveau plug-in de gestion multivoie (MPP) et devez définir les chemins que ce module doit réclamer. Il se peut que vous deviez créer une règle de réclamation si vous ajoutez de nouveaux chemins et souhaitez que le MPP existant les réclame.

ATTENTION :

Lors de la création des nouvelles règles de réclamation, prenez soin d'éviter toutes situations où les différents chemins physiques sur la même LUN sont réclamés par différents MPP. Sauf dans le cas où le MPP correspond à MASK_PATH MPP, cette configuration entraîne des problèmes de performances.

Dans la procédure, --server=server_name spécifie le serveur cible. Le serveur cible spécifié vous invite à saisir un nom de serveur et un mot de passe. D'autres options de connexion, telles qu'un fichier de configuration ou de session, sont prises en charge. Pour obtenir la liste des options de connexion, reportez-vous à la rubrique Démarrage avec vSphere Command-Line Interfaces.

Procédure

  1. Pour définir une nouvelle règle de réclamation, exécutez la commande suivante :

    esxcli --server=server_name storage core claimrule add

    La commande accepte les options suivantes :

    Option

    Description

    -A|--adapter=<str>

    Indiquez l'adaptateur des chemins à utiliser pour cette opération.

    -u|--autoassign

    Le système affecte automatiquement un ID de règle.

    -C|--channel=<long>

    Indiquez le canal des chemins à utiliser pour cette opération.

    -c|--claimrule-class=<str>

    Indiquez la classe des règles de réclamation à utiliser pour cette opération.

    Les valeurs valides sont : MP, Filtre, VAAI.

    -d|--device=<str>

    Indiquez l'Uid du périphérique à utiliser pour cette opération.

    -D|--driver=<str>

    Indiquez le pilote des chemins à utiliser pour cette opération.

    -f|--force

    Forcez les règles de réclamation à ignorer les vérifications de validité et à installer la règle.

    --if-unset=<str>

    Exécutez cette commande si cette variable d'utilisateur avancé n'est pas définie sur la valeur 1.

    -i|--iqn=<str>

    Indiquez le Nom Qualifié iSCSI pour la cible à utiliser dans cette opération.

    -L|--lun=<long>

    Indiquez la LUN des chemins à utiliser pour cette opération.

    -M|--model=<str>

    Indiquez le modèle des chemins à utiliser pour cette opération.

    -P|--plugin=<str>

    Indiquez le plugin PSA à utiliser pour cette opération. (requis)

    -r|--rule=<long>

    Indiquez l'ID de la règle à utiliser pour cette opération.

    -T|--target=<long>

    Indiquez la cible des chemins à utiliser pour cette opération.

    -R|--transport=<str>

    Indiquez le transport des chemins à utiliser pour cette opération.

    Les valeurs valides sont : block, fc, iscsi, iscsivendor, ide, sas, sata, usb, parallel, unknown.

    -t|--type=<str>

    Indiquez le type de correspondances utilisé pour la réclamation/non réclamation ou pour claimrule.

    Les valeurs valides sont : fournisseur, emplacement, pilote, transport, périphérique, cible. (requis)

    -V|--vendor=<str>

    Indiquez le fournisseur des chemins à utiliser dans cette opération.

    --wwnn=<str>

    Indiquez le numéro de nœud WWNN pour la cible à utiliser dans cette opération.

    --wwpn=<str>

    Indiquez le numéro de port WWPN pour la cible à utiliser dans cette opération.

  2. Pour charger la nouvelle règle de réclamation sur votre système, exécutez la commande suivante :

    esxcli --server=server_name storage core claimrule load

    Cette commande charge toutes les nouvelles règles de réclamation gestion multivoie à partir du fichier de configuration de votre système.

Définition des règles de réclamation de gestion multivoie

Dans l'exemple suivante, vous ajoutez et chargez la règle N°500 pour réclamer tous les chemins comportant la chaîne du modèle NewMod et la chaîne du fournisseur NewVend pour le plug-in NMP.

# esxcli --server=server_name storage core claimrule add -r 500 -t vendor -V NewVend -M NewMod -P NMP

# esxcli --server=server_name storage core claimrule load

Après avoir exécuté la commande esxcli --server=server_name storage core claimrule list, vous pouvez voir apparaître la nouvelle liste de réclamations sur la liste.

Remarque :

Les deux lignes de la règle de réclamation (celle de la classe runtime et celle de la classe file) indiquent que la nouvelle règle de réclamation a été chargée sur le système et qu'elle est active.

Rule Class  Rule   Class    Type       Plugin     Matches
MP          0      runtime  transport  NMP        transport=usb
MP          1      runtime  transport  NMP        transport=sata
MP          2      runtime  transport  NMP        transport=ide
MP          3      runtime  transport  NMP        transport=block
MP          4      runtime  transport  NMP        transport=unknown
MP          101    runtime  vendor     MASK_PATH  vendor=DELL model=Universal Xport
MP          101    file     vendor     MASK_PATH  vendor=DELL model=Universal Xport
MP          500    runtime  vendor     NMP        vendor=NewVend model=NewMod    
MP          500    file     vendor     NMP        vendor=NewVend model=NewMod