Skip to main content
Active IQ Unified Manager
La version française est une traduction automatique. La version anglaise prévaut sur la française en cas de divergence.

Provisionner des LUN à l'aide d'API

PDF

Vous pouvez provisionner des LUN sur vos machines virtuelles de stockage (SVM) à l'aide des API de provisionnement fournies dans le cadre d' Active IQ Unified Manager. Ce flux de travail de provisionnement détaille les étapes de récupération des clés des SVM, des niveaux de service de performances et des politiques d'efficacité de stockage avant de créer le LUN.

Le diagramme suivant illustre les étapes d’un flux de travail de provisionnement de LUN.

créer des LUN
Remarque

Ce workflow suppose que les clusters ONTAP ont été ajoutés à Unified Manager et que la clé de cluster a été obtenue. Le workflow suppose également que les SVM ont déjà été créés sur les clusters.

  1. Obtenez la clé SVM pour la SVM sur laquelle vous souhaitez créer le LUN, comme décrit dans la rubrique de workflow Vérification des SVM sur les clusters.

  2. Obtenez la clé du niveau de service de performance en exécutant l’API suivante et en récupérant la clé à partir de la réponse.

    Catégorie verbe HTTP Chemin

    fournisseur de stockage

    OBTENIR

    /storage-provider/performance-service-levels
    Remarque

    Vous pouvez récupérer les détails des niveaux de service de performance définis par le système en définissant le system_defined paramètre d'entrée à true . À partir de la sortie, obtenez la clé du niveau de service de performances que vous souhaitez appliquer sur le LUN.

  3. Vous pouvez également obtenir la clé de stratégie d’efficacité de stockage pour la stratégie d’efficacité de stockage que vous souhaitez appliquer sur le LUN en exécutant l’API suivante et en récupérant la clé à partir de la réponse.

    Catégorie verbe HTTP Chemin

    fournisseur de stockage

    OBTENIR

    /storage-provider/storage-efficiency-policies

  4. Déterminez si des groupes initiateurs (igroups) ont été créés pour accorder l'accès à la cible LUN que vous souhaitez créer.

    Catégorie verbe HTTP Chemin

    centre de données

    OBTENIR

    /datacenter/protocols/san/igroups /datacenter/protocols/san/igroups/{key}

    Vous devez saisir la valeur du paramètre pour indiquer le SVM pour lequel le groupe i a autorisé l'accès. De plus, si vous souhaitez interroger un igroup particulier, entrez le nom de l'igroup (clé) comme paramètre d'entrée.

  5. Dans la sortie, si vous pouvez trouver le groupe auquel vous souhaitez accorder l'accès, obtenez la clé. Sinon créez le igroup.

    Catégorie verbe HTTP Chemin

    centre de données

    POSTE

    /datacenter/protocols/san/igroups

    Vous devez saisir les détails du groupe i que vous souhaitez créer, comme paramètres d'entrée. Il s'agit d'un appel synchrone et vous pouvez vérifier la création du groupe i dans la sortie. En cas d'erreur, un message s'affiche pour vous permettre de résoudre le problème et de réexécuter l'API.

  6. Créez le LUN.

    Catégorie verbe HTTP Chemin

    fournisseur de stockage

    POSTE

    /storage-provider/luns

    Pour créer le LUN, assurez-vous d’avoir ajouté les valeurs récupérées comme paramètres d’entrée obligatoires.

    Remarque

    La politique d’efficacité du stockage est un paramètre facultatif pour la création de LUN.

    Exemple de cURL

    Vous devez saisir tous les détails du LUN que vous souhaitez créer, comme paramètres d’entrée.

    La sortie JSON affiche une clé d’objet Job que vous pouvez utiliser pour vérifier le LUN que vous avez créé.

  7. Vérifiez la création du LUN en utilisant la clé d'objet Job renvoyée lors de l'interrogation du Job :

    Catégorie verbe HTTP Chemin

    serveur de gestion

    OBTENIR

    /management-server/jobs/{key}

    À la fin de la réponse, vous voyez la clé du LUN créé.

  8. Vérifiez la création du LUN en exécutant l'API suivante avec la clé renvoyée :

    Catégorie verbe HTTP Chemin

    fournisseur de stockage

    OBTENIR

    /storage-provider/luns/{key}

    Exemple de sortie JSON

    Vous pouvez voir que la méthode POST de /storage-provider/luns appelle en interne toutes les API requises pour chacune des fonctions et crée l'objet. Par exemple, il invoque le /storage-provider/performance-service-levels/ API pour l'attribution du niveau de service de performance sur le LUN.

    == Étapes de dépannage en cas d'échec de création ou de mappage de LUN

Une fois ce workflow terminé, vous constaterez peut-être encore un échec dans la création de votre LUN. Même si le LUN est créé avec succès, le mappage du LUN avec l'igroup peut échouer en raison de l'indisponibilité d'un SAN LIF ou d'un point de terminaison d'accès sur le nœud sur lequel vous créez le LUN. En cas d'échec, vous pouvez voir le message suivant :

The nodes <node_name> and <partner_node_name> have no LIFs configured with the iSCSI or FCP protocol for Vserver <server_name>. Use the access-endpoints API to create a LIF for the LUN.

Suivez ces étapes de dépannage pour contourner cette panne.

  1. Créez un point de terminaison d’accès prenant en charge le protocole ISCSI/FCP sur la SVM sur laquelle vous avez essayé de créer le LUN.

    Catégorie verbe HTTP Chemin

    fournisseur de stockage

    POSTE

    /storage-provider/access-endpoints

    Exemple de cURL

    Vous devez saisir les détails du point de terminaison d’accès que vous souhaitez créer, comme paramètres d’entrée.

    Remarque

    Assurez-vous que dans le paramètre d'entrée, vous avez ajouté l'adresse pour indiquer le nœud d'origine du LUN et l'adresse ha pour indiquer le nœud partenaire du nœud d'origine. Lorsque vous exécutez cette opération, elle crée des points de terminaison d’accès sur le nœud d’origine et sur le nœud partenaire.

  2. Interrogez le travail avec la clé d'objet Job renvoyée dans la sortie JSON pour vérifier qu'il a été exécuté avec succès pour ajouter les points de terminaison d'accès sur le SVM et que les services iSCSI/FCP ont été activés sur le SVM.

    Catégorie verbe HTTP Chemin

    serveur de gestion

    OBTENIR

    /management-server/jobs/{key}

    Exemple de sortie JSON

    À la fin de la sortie, vous pouvez voir la clé des points d’accès créés. Dans la sortie suivante, la valeur « name » : « accessEndpointKey » indique le point de terminaison d'accès créé sur le nœud d'origine du LUN, pour lequel la clé est 9c964258-14ef-11ea-95e2-00a098e32c28. La valeur « name » : « accessEndpointHAKey » indique le point de terminaison d'accès créé sur le nœud partenaire du nœud domestique, pour lequel la clé est 9d347006-14ef-11ea-8760-00a098e3215f.

  3. Modifiez le LUN pour mettre à jour le mappage igroup. Pour plus d'informations sur la modification du flux de travail, consultez « Modification des charges de travail de stockage ».

    Catégorie verbe HTTP Chemin

    fournisseur de stockage

    CORRECTIF

    /storage-provider/lun/{key}

    Dans l'entrée, spécifiez la clé igroup avec laquelle vous souhaitez mettre à jour le mappage LUN, ainsi que la clé LUN.

    Exemple de cURL

    La sortie JSON affiche une clé d’objet Job que vous pouvez utiliser pour vérifier si le mappage est réussi.

  4. Vérifiez le mappage LUN en interrogeant la clé LUN.

    Catégorie verbe HTTP Chemin

    fournisseur de stockage

    OBTENIR

    /storage-provider/luns/{key}

    Exemple de sortie JSON

    Dans la sortie, vous pouvez voir que le LUN a été correctement mappé avec l'igroup (clé d19ec2fa-fec7-11e8-b23d-00a098e32c28) avec lequel il a été initialement provisionné.