Utilisez les commandes esxcli pour ajouter une règle de réclamation de gestion multivoie PSA à l'ensemble de stratégies 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.

Exemples d'ajout d'une règle de réclamation PSA :
  • Vous chargez un nouveau MPP tiers et vous devez définir les chemins que ce module réclame.
  • Vous devez activer le HPP natif.
Avertissement : Vous ne pouvez pas créer de règles pour lesquelles deux plug-ins différents réclament des chemins d'accès vers le même périphérique. Vos tentatives de création de ces règles de réclamation échouent avec un message d'avertissement dans le fichier vmkernel.log.

Conditions préalables

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

Procédure

  1. Pour définir une nouvelle règle de réclamation, utilisez la commande suivante :
    esxcli storage core claimrule add

    La commande accepte les options suivantes :

    Option Description
    -A|--adapter=<adapter> Adaptateur des chemins d'accès à utiliser. Valide uniquement si --type est location.
    -u|--autoassign Permet d'ajouter une règle de réclamation selon ses caractéristiques. Le numéro de règle n'est pas nécessaire.
    -C|--channel=<channel> Canal des chemins d'accès à utiliser. Valide uniquement si --type est location.
    -c|--claimrule-class=<cl> Classe des règles de réclamation à utiliser pour cette opération. Vous pouvez spécifier MP (par défaut), Filter ou VAAI.

    Pour configurer l'accélération matérielle pour une nouvelle baie, ajoutez deux règles de réclamation, une pour le filtre VAAI et une autre pour le plug-in VAAI. Reportez-vous à Ajout de règles de réclamation d'accélération matérielle pour obtenir des instructions détaillées.

    -d|--device=<device_uid> UID du périphérique. Valide uniquement lorsque --type est device.
    -D|--driver=<driver> Pilote pour l'adaptateur HBA des chemins d'accès à utiliser. Valide uniquement si --type est driver.
    -f|--force Forcez les règles de réclamation à ignorer les vérifications de validité et à installer la règle.
    --force-reserved Remplacez la protection des plages d'ID de règle réservées.

    Les règles de réclamation réservées sont les règles dont l'ID est inférieur à 100. Vous pouvez les utiliser pour réattribuer les périphériques locaux aux plug-ins spécifiques (par exemple, le périphérique NVMe au HPP).

    --if-unset=<str> Exécutez cette commande si cette variable d'utilisateur avancé n'est pas définie sur la valeur 1.
    -i|--iqn=<iscsi_name> Nom complet iSCSI de la cible. Valide uniquement lorsque --type est target.
    -L|--lun=<lun_id> LUN des chemins d'accès. Valide uniquement si --type est location.

    L'ID de LUN ne doit pas être supérieur à la valeur de l'option de configuration avancée /Disk/MaxLUN.

    -M|--model=<model> Modèle des chemins d'accès à utiliser. Valide uniquement si --type est vendor.

    Les valeurs valides sont les valeurs de la chaîne de modèle à partir de la chaîne SCSI INQUIRY. Exécutez vicfg-scsidevs <conn_options> -l sur chaque périphérique pour afficher les valeurs de la chaîne de modèle.

    -P|--plugin=<plugin> Plug-in PSA à utiliser. Les valeurs sont NMP, MASK_PATH ou HPP. Des développeurs tiers peuvent également fournir leurs propres plug-ins PSA. Requis.
    -r|--rule=<rule_ID> ID de règle à utiliser. L'ID de règle indique l'ordre dans lequel la règle de réclamation doit être évaluée. Les règles de réclamation définies par l'utilisateur sont évaluées dans l'ordre numérique à partir de 101.

    Vous pouvez exécuter esxcli storage core claimrule list pour déterminer les ID de règle disponibles.

    -T|--target=<target> Cible des chemins d'accès à utiliser. Valide uniquement si --type est location.
    -R|--transport=<transport>

    Transport des chemins d'accès à utiliser. Valide uniquement si --type est transport. Les valeurs suivantes sont prises en charge.

    • block — Stockage des blocs
    • fc — Fibre Channel
    • iscsivendor — iSCSI
    • iscsi — Actuellement inutilisé
    • ide — Stockage IDE
    • sas — Stockage SAS
    • sata — Stockage SATA
    • usb — Stockage USB
    • parallel — Parallèle
    • fcoe — FCoE
    • unknown
    -t|--type=<type> Type de correspondance à utiliser pour l'opération. Les valeurs valides sont les suivantes : Requis.
    • vendor
    • location
    • driver
    • transport
    • device
    • target
    -V|--vendor=<vendor> Fournisseur des chemins d'accès à utiliser. Valide uniquement si --type est vendor.

    Les valeurs valides sont les valeurs de la chaîne de fournisseur à partir de la chaîne SCSI INQUIRY. Exécutez vicfg-scsidevs <conn_options> -l sur chaque périphérique pour afficher les valeurs de la chaîne de fournisseur.

    --wwnn=<wwnn> Numéro de nœud mondial (WWNN) pour la cible.
    --wwpn=<wwpn> Numéro de port mondial (WWPN) pour la cible.
    -a|--xcopy-use-array-values Utilisez les valeurs indiquées par la baie pour construire la commande XCOPY à envoyer à la baie de stockage. Cela s'applique aux règles de réclamation VAAI uniquement.
    -s|--xcopy-use-multi-segs Utilisez plusieurs segments lors de l'émission d'une demande XCOPY. Valide uniquement si --xcopy-use-array-values est spécifié.
    -m|--xcopy-max-transfer-size Taille maximale en Mo de transfert de données lorsque vous utilisez une taille de transfert différente de celle indiquée par la baie. Valide uniquement si --xcopy-use-array-values est spécifié.
    -k|--xcopy-max-transfer-size-kib Taille maximale en Kio de transfert pour les commandes XCOPY lorsque vous utilisez une taille de transfert différente de celle indiquée par la baie. Valide uniquement si --xcopy-use-array-values est spécifié.
  2. Pour charger la nouvelle règle de réclamation sur votre système, utilisez la commande suivante :
    esxcli storage core claimrule load
    Cette commande charge toutes les nouvelles règles de réclamation de gestion multivoie à partir du fichier de configuration esx.conf dans le noyau VMkernel. La commande ne se compose d'aucune option.
  3. Pour appliquer des règles de réclamation qui sont chargées, utilisez la commande suivante :
    esxcli storage core claimrule run

    La commande accepte les options suivantes :

    Option Description
    -A|--adapter=<adapter> Si --type est location, il s'agit du nom de l'adaptateur HBA pour les chemins d'accès sur lesquels les règles de réclamation doivent être exécutées. Pour exécuter des règles de réclamation sur les chemins d'accès pour tous les adaptateurs, omettez cette option.
    -C|--channel=<channel> Si --type est location, il s'agit de la valeur du numéro de canal SCSI pour les chemins d'accès sur lesquels les règles de réclamation doivent être exécutées. Pour exécuter des règles de réclamation sur les chemins d'accès pour tout numéro de canal, omettez cette option.
    -c|--claimrule-class=<cl> Classe des règles de réclamation à utiliser pour cette opération.
    -d|--device=<device_uid> UID du périphérique.
    -L|--lun=<lun_id> Si --type est location, il s'agit de la valeur du LUN SCSI pour les chemins d'accès sur lesquels les règles de réclamation doivent être exécutées. Pour exécuter des règles de réclamation sur les chemins d'accès pour tout LUN, omettez cette option.
    -p|--path=<path_uid> Si --type est path, cette option indique l'identifiant de chemin d'accès unique (UID) ou le nom d'exécution d'un chemin d'accès sur lequel les règles de réclamation doivent être exécutées.
    -T|--target=<target> Si --type est location, il s'agit de la valeur du numéro cible SCSI pour les chemins d'accès sur lesquels les règles de réclamation doivent être exécutées. Pour exécuter des règles de réclamation sur les chemins d'accès pour tout numéro cible, omettez cette option.
    -t|--type=<location|path|all> Type de réclamation à effectuer. Par défaut, utilise all, ce qui signifie que des règles de réclamation s'exécutent sans restriction pour les chemins d'accès ou les adresses SCSI spécifiques. Les valeurs valides sont location, path et all.
    -w|--wait Vous ne pouvez utiliser cette option que si vous utilisez également --type all.

    Si cette option est incluse, la réclamation attend que le réglage des chemins d'accès soit effectué avant l'exécution de l'opération de réclamation. Dans ce cas, le système ne démarre le processus de réclamation que lorsqu'il est probable que tous les chemins d'accès au système sont apparus.

    Lorsque le processus de réclamation est démarré, la commande ne renvoie rien jusqu'à ce que l'enregistrement du périphérique soit effectué.

    Si vous ajoutez ou supprimez des chemins d'accès au cours du processus de réclamation ou de détection, cette option peut ne pas fonctionner correctement.

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

Dans l'exemple suivant, vous ajoutez et chargez la règle #500. La règle réclame tous les chemins avec la chaîne de modèle NewMod et la chaîne de fournisseur NewVend pour le plug-in NMP.

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

# esxcli storage core claimrule load

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

La sortie suivante indique que la règle de réclamation 500 a été chargée dans le système et est active.
Rule Class  Rule   Class    Type       Plugin     Matches
...         ...    ...      ...        ...        ...
MP          500    runtime  vendor     NMP        vendor=NewVend model=NewMod  
MP          500    file     vendor     NMP        vendor=NewVend model=NewMod