Skip to main content
NetApp Console setup and administration
La version française est une traduction automatique. La version anglaise prévaut sur la française en cas de divergence.

Déployez manuellement l’agent NetApp Console en mode restreint

Contributeurs netapp-tonias
PDF

Si vous souhaitez utiliser la NetApp Console avec une connectivité sortante limitée, vous devez déployer manuellement le Console agent en mode restreint.

Si vous ne souhaitez pas utiliser d'abonnement Marketplace ou si vous déployez Google Cloud, vous devez installer manuellement l'agent Console.

Étape 1 : Préparer les autorisations cloud

Avant d'installer l'agent Console, préparez les autorisations du fournisseur de cloud dont il a besoin pour gérer les ressources.

"Apprenez à préparer les autorisations cloud" .

Étape 2 : Activez les API Google Cloud (Google Cloud uniquement)

Si vous installez le Console agent dans Google Cloud, activez les API requises dans votre projet avant l'installation. Ces API sont nécessaires pour certaines fonctionnalités de Cloud Volumes ONTAP.

Étapes

  1. "Activez les API dans votre projet Google Cloud"

    • API Cloud Build (requise pour les déploiements Cloud Volumes ONTAP en mode privé utilisant Infrastructure Manager)

    • API du gestionnaire de déploiement cloud V2

    • API Cloud Infrastructure Manager

    • API de journalisation dans le cloud

    • API du gestionnaire de ressources cloud

    • API Compute Engine

    • API de gestion des identités et des accès (IAM)

    • API du service de gestion des clés cloud (KMS) (requise uniquement si vous prévoyez d'utiliser NetApp Backup and Recovery avec des clés de chiffrement gérées par le client (CMEK))

    • API Cloud Quotas (requise pour les déploiements Cloud Volumes ONTAP utilisant Infrastructure Manager)

Étape 3 : Préparer l’accès au réseau

Autorisez les points de terminaison sortants requis pour le fournisseur de cloud sur lequel vous installez le Console agent.

Points de terminaison du fournisseur de cloud

environnements AWS

Autorisez ces points de terminaison de service AWS à gérer les ressources AWS, y compris FSx for ONTAP.

Points de terminaison But

Services AWS (amazonaws.com) :

  • CloudFormation

  • Cloud de calcul élastique (EC2)

  • Gestion des identités et des accès (IAM)

  • Service de gestion des clés (KMS)

  • Service de jetons de sécurité (STS)

  • Service de stockage simple (S3)

Pour gérer les ressources AWS. Le point de terminaison dépend de votre région AWS. "Consultez la documentation AWS pour plus de détails"

Amazon FSx for NetApp ONTAP :

  • api.workloads.netapp.com

La console Web contacte ce point de terminaison pour interagir avec les API Workload Factory afin de gérer et d'exploiter les charges de travail basées sur FSx pour ONTAP.

Environnements Azure

Autorisez les points de terminaison qui s’appliquent à votre région Azure : public, Government ou China.

Points de terminaison But

  • https://management.azure.com

  • https://login.microsoftonline.com

  • https://blob.core.windows.net

  • https://core.windows.net

Pour gérer les ressources dans les régions publiques Azure.

  • https://management.usgovcloudapi.net

  • https://login.microsoftonline.us

  • https://*.blob.core.usgovcloudapi.net

  • https://core.usgovcloudapi.net

Pour gérer les ressources dans les régions Azure Government.

  • https://management.chinacloudapi.cn

  • https://login.chinacloudapi.cn

  • https://blob.core.chinacloudapi.cn

  • https://core.chinacloudapi.cn

Pour gérer les ressources dans les régions Azure Chine.

Environnements Google Cloud

Autorisez ces points de terminaison de l'API Google Cloud à gérer les ressources de votre projet.

Points de terminaison But

  • https://www.googleapis.com/compute/v1/

  • https://compute.googleapis.com/compute/v1

  • https://cloudresourcemanager.googleapis.com/v1/projects

  • https://www.googleapis.com/compute/beta

  • https://storage.googleapis.com/storage/v1

  • https://www.googleapis.com/storage/v1

  • https://iam.googleapis.com/v1

  • https://cloudkms.googleapis.com/v1

  • https://config.googleapis.com/v1/projects

Pour gérer les ressources dans Google Cloud.

Points de terminaison de NetApp Console

Autorisez les points de terminaison partagés pour NetApp Support, les fonctionnalités de Console, ainsi que le déploiement et les mises à niveau de l’agent Console.

Points de terminaison But

Pour obtenir des informations sur les licences et envoyer des messages AutoSupport au support NetApp.

Pour mettre à jour les informations d'identification du site de support NetApp (NSS) ou pour ajouter de nouvelles informations d'identification NSS à la NetApp Console.

Pour obtenir des informations sur les licences et envoyer des messages AutoSupport au support NetApp, ainsi que pour recevoir les mises à jour logicielles de Cloud Volumes ONTAP.

Pour fournir des fonctionnalités et des services au sein de la NetApp Console.

Pour les régions non gouvernementales, utilisez les points de terminaison suivants :

Pour les régions gouvernementales, utilisez plutôt le point de terminaison suivant :

Pour obtenir les images nécessaires au déploiement et aux mises à niveau de l'agent Console.

Pour l’accès via le navigateur et les autres exigences réseau, consultez "Préparer l'accès réseau pour le mode restreint".

Étape 4 : installer Podman ou Docker Engine

Selon votre système d'exploitation, Podman ou Docker Engine est requis avant l'installation de l'agent.

Exemple 1. Étapes
Podman

Suivez ces étapes pour installer et configurer Podman :

  • Activer et démarrer le service podman.socket

  • Installer Python 3

  • Installez le paquet podman-compose (varie selon la version de Red Hat)

  • Ajoutez podman-compose à la variable d'environnement PATH

  • Si vous utilisez Red Hat Enterprise Linux, vérifiez que votre version Podman utilise Netavark Aardvark DNS au lieu de CNI

Remarque Ajustez le port aardvark-dns (par défaut : 53) après l’installation de l’agent pour éviter les conflits de port DNS. Suivez les instructions pour configurer le port.
Étapes

  1. Supprimez le package podman-docker s'il est installé sur l'hôte.

    dnf remove podman-docker
rm /var/run/docker.sock

  2. Installez Podman.

    Vous pouvez obtenir Podman à partir des référentiels officiels de Red Hat Enterprise Linux.

    1. Pour Red Hat Enterprise Linux 9,6 :

      sudo dnf install podman-5:<version>

      Où <version> est la version prise en charge de Podman que vous installez. Afficher les versions de Podman prises en charge .

    2. Pour Red Hat Enterprise Linux 9.1 à 9.4 :

      sudo dnf install podman-4:<version>

      Où <version> est la version prise en charge de Podman que vous installez. Afficher les versions de Podman prises en charge .

    3. Pour Red Hat Enterprise Linux 8 :

      sudo dnf install podman-4:<version>

      Où <version> est la version prise en charge de Podman que vous installez. Afficher les versions de Podman prises en charge .

  3. Activez et démarrez le service podman.socket.

    sudo systemctl enable --now podman.socket

  4. Installez python3.

    sudo dnf install python3

  5. Installez le package de référentiel EPEL s'il n'est pas déjà disponible sur votre système.

    Cette étape est nécessaire car podman-compose est disponible dans le référentiel Extra Packages for Enterprise Linux (EPEL).

  6. Si vous utilisez Red Hat Enterprise 9 :

    1. Installez le paquetage du dépôt EPEL.

    sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm

    +

    1. Installez le package podman-compose 1.5.0.

      sudo dnf install podman-compose-1.5.0

  7. Si vous utilisez Red Hat Enterprise Linux 8 :

    1. Installez le paquetage du dépôt EPEL.

      sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm

    2. Installez le package podman-compose 1.0.6.

      sudo dnf install podman-compose-1.0.6
      Remarque En utilisant le dnf install la commande répond à l'exigence d'ajout de podman-compose à la variable d'environnement PATH. La commande d'installation ajoute podman-compose à /usr/bin, qui est déjà inclus dans le secure_path option sur l'hôte.

    3. Si vous utilisez Red Hat Enterprise Linux 8, vérifiez que votre version Podman utilise NetAvark avec Aardvark DNS au lieu de CNI.

      1. Vérifiez si votre networkBackend est défini sur CNI en exécutant la commande suivante :

        podman info | grep networkBackend

      2. Si le networkBackend est défini sur CNI , vous devrez le changer en netavark .

      3. Installer netavark et aardvark-dns en utilisant la commande suivante :

        dnf install aardvark-dns netavark

      4. Ouvrez le /etc/containers/containers.conf fichier et modifiez l'option network_backend pour utiliser « netavark » au lieu de « cni ».

        Si /etc/containers/containers.conf n'existe pas, effectuez les modifications de configuration pour /usr/share/containers/containers.conf .

      5. Redémarrez podman.

        systemctl restart podman

      6. Confirmez que networkBackend est désormais modifié en « netavark » à l'aide de la commande suivante :

        podman info | grep networkBackend

  8. Si vous associez cet agent à un système Cloud Volumes ONTAP, envisagez d’augmenter le nombre de threads associés à l’agent afin d’améliorer les performances. "Découvrez comment augmenter la limite de threads du conteneur de l'agent".

Moteur Docker

Suivez la documentation de Docker pour installer Docker Engine.

Étapes

  1. "Afficher les instructions d'installation depuis Docker"

    Suivez les étapes pour installer une version de Docker Engine prise en charge. N'installez pas la dernière version, car elle n'est pas prise en charge par la console.

  2. Vérifiez que Docker est activé et en cours d’exécution.

    sudo systemctl enable docker && sudo systemctl start docker

Étape 5 : Installez manuellement le mode restreint de NetApp Console dans votre environnement cloud (obligatoire pour Google Cloud)

Vous pouvez installer manuellement l'agent Console sur votre propre hôte Linux exécuté sur AWS, Azure ou Google Cloud.

Avant de commencer

Vous devriez avoir les éléments suivants :

  • Privilèges root pour installer l'agent de la console.

  • Détails sur un serveur proxy, si un proxy est requis pour l'accès Internet à partir de l'agent de la console.

    Vous avez la possibilité de configurer un serveur proxy après l'installation, mais cela nécessite le redémarrage de l'agent Console.

  • Un certificat signé par une autorité de certification, si le serveur proxy utilise HTTPS ou si le proxy est un proxy d'interception.

Remarque Vous ne pouvez pas définir de certificat pour un serveur proxy transparent lors de l'installation manuelle de l'agent de console. Si vous devez définir un certificat pour un serveur proxy transparent, vous devez utiliser la console de maintenance après l'installation. En savoir plus sur le"Console de maintenance des agents" .
À propos de cette tâche

Après l'installation, l'agent de la console se met automatiquement à jour si une nouvelle version est disponible.

Étapes

  1. Si les variables système http_proxy ou https_proxy sont définies sur l'hôte, supprimez-les :

    unset http_proxy
unset https_proxy

    Si vous ne supprimez pas ces variables système, l'installation échoue.

  2. Téléchargez le logiciel agent Console puis copiez-le sur l'hôte Linux. Vous pouvez le télécharger soit depuis la NetApp Console , soit depuis le site d'assistance NetApp .

    • NetApp Console : Accédez à Agents > Gestion > Déployer l’agent > Sur site > Installation manuelle.

      Choisissez de télécharger les fichiers d'installation de l'agent ou une URL vers ces fichiers.

    • "Site de support NetApp" (nécessaire si vous n'avez pas déjà accès à la NetApp Console).

      Remarque Téléchargez le programme d'installation de l'agent « online » conçu pour une utilisation sur votre réseau ou dans le cloud. Un programme d'installation « offline » distinct est disponible pour l'agent Console, mais il n'est pris en charge qu'avec les déploiements en mode privé.

    • NetApp Support Site (nécessaire si vous n'avez pas déjà accès à la Console) "Site de support NetApp".

  3. Attribuer des autorisations pour exécuter le script.

    chmod +x NetApp_Console_Agent_Cloud_<version>

    Où <version> est la version de l’agent de console que vous avez téléchargé.

  4. Si vous effectuez l'installation dans un environnement Government Cloud, désactivez les vérifications de configuration."Découvrez comment désactiver les vérifications de configuration pour les installations manuelles."

  5. Exécutez le script d'installation.

    ./NetApp_Console_Agent_Cloud_<version> --proxy <HTTP or HTTPS proxy server> --cacert <path and file name of a CA-signed certificate>

    Vous devrez ajouter les informations de proxy si votre réseau nécessite un proxy pour accéder à Internet. Vous pouvez ajouter un proxy explicite lors de l'installation. Les --proxy et --cacert paramètres sont facultatifs et il ne vous sera pas demandé de les ajouter. Si vous avez un serveur proxy explicite, vous devrez saisir les paramètres comme indiqué.

    Remarque Si vous souhaitez configurer un proxy transparent, vous pouvez le faire après l'installation. "Découvrez la console de maintenance des agents".

    Voici un exemple de configuration d'un serveur proxy explicite avec un certificat signé par une autorité de certification :

    ./NetApp_Console_Agent_Cloud_v4.0.0 --proxy https://user:password@10.0.0.30:8080/ --cacert /tmp/cacert/certificate.cer
./NetApp_Console_Agent_Cloud_v4.0.0 --proxy https://user:password@10.0.0.30:8080/ --cacert /tmp/cacert/certificate.cer

    --proxy configure l'agent de la Console pour utiliser un serveur proxy HTTP ou HTTPS en utilisant l'un des formats suivants :

    • http://adresse:port

    • http://nom-d'utilisateur:mot-de-passe@adresse:port

    • http://nom-de-domaine%92nom-d'utilisateur:mot-de-passe@adresse:port

    • https://adresse:port

    • https://nom-d'utilisateur:mot-de-passe@adresse:port

    • https://nom-de-domaine%92nom-d'utilisateur:mot-de-passe@adresse:port

      Notez ce qui suit :

      • L'utilisateur peut être un utilisateur local ou un utilisateur de domaine.

      • Pour un utilisateur de domaine, vous devez utiliser le code ASCII pour un \ comme indiqué ci-dessus.

      • L'agent Console ne prend pas en charge les noms d'utilisateur ou les mots de passe contenant le caractère @.

      • Si le mot de passe inclut l'un des caractères spéciaux suivants, vous devez échapper ce caractère spécial en le préfixant d'une barre oblique inverse : & ou !

        Par exemple:

    http://bxpproxyuser:netapp1\!@adresse:3128

  6. Si vous avez utilisé Podman, vous devrez ajuster le port aardvark-dns.

    1. Connectez-vous en SSH à la machine virtuelle de l'agent de console.

    2. Ouvrez le fichier podman /usr/share/containers/containers.conf et modifiez le port choisi pour le service DNS Aardvark. Par exemple, changez-le en 54.

      vi /usr/share/containers/containers.conf

      Par exemple:

    # Port to use for dns forwarding daemon with netavark in rootful bridge
# mode and dns enabled.
# Using an alternate port might be useful if other DNS services should
# run on the machine.
#
dns_bind_port = 54

    1. Redémarrez la machine virtuelle de l’agent de console.

Résultat

L'agent de console est maintenant installé. À la fin de l'installation, le service de l'agent de console (occm) redémarre deux fois si vous avez spécifié un serveur proxy.

Quelle est la prochaine étape ?

Configurer la NetApp Console.

Étape 6 : Configurer NetApp Console

Lorsque vous accédez à la console pour la première fois, vous êtes invité à choisir une organisation pour l'agent de la console et devez activer le mode restreint.

Avant de commencer

La personne qui configure l’agent de la console doit se connecter à la console à l’aide d’un identifiant qui n’appartient pas déjà à une organisation de la console.

Si votre compte est associé à une autre organisation, vous devez créer un nouveau compte. Sinon, l'option permettant d'activer le mode restreint n'apparaît pas sur l'écran de configuration.

Étapes

  1. Ouvrez un navigateur Web à partir d’un hôte disposant d’une connexion à l’instance de l’agent de console et entrez l’URL suivante de l’agent de console que vous avez installé.

  2. Inscrivez-vous ou connectez-vous à la NetApp Console.

  3. Une fois connecté, configurez la console :

    1. Entrez un nom pour l’agent de la console.

    2. Saisissez un nom pour une nouvelle organisation de console.

    3. Sélectionnez Exécutez-vous dans un environnement sécurisé ?

    4. Sélectionnez Activer le mode restreint sur ce compte.

      Notez que vous ne pouvez pas modifier ce paramètre une fois le compte créé. Vous ne pouvez pas activer le mode restreint ultérieurement et vous ne pouvez pas le désactiver ultérieurement.

    Si vous avez déployé l'agent de console dans une région gouvernementale, la case à cocher est déjà activée et ne peut pas être modifiée. Cela est dû au fait que le mode restreint est le seul mode pris en charge dans les régions gouvernementales.

    1. Sélectionnez Commençons.

Résultat

L'agent de console est maintenant installé et configuré avec votre organisation de console. Tous les utilisateurs doivent accéder à la console à l’aide de l’adresse IP de l’instance de l’agent de la console.

Quelle est la prochaine étape ?

Fournissez à la console les autorisations que vous avez précédemment configurées.

Étape 7 : Accorder des autorisations à l’agent Console

Si vous avez installé Console agent manuellement, vous devez lui accorder les autorisations que vous avez définies précédemment.

"Apprenez à préparer les autorisations cloud" .

Rôle AWS IAM

Attachez le rôle IAM que vous avez précédemment créé à l’instance EC2 sur laquelle vous avez installé l’agent de console.

Ces étapes s’appliquent uniquement si vous avez installé manuellement l’agent de console dans AWS. Pour les déploiements AWS Marketplace, vous avez déjà associé l’instance de l’agent de console à un rôle IAM qui inclut les autorisations requises.

Étapes

  1. Accédez à la console Amazon EC2.

  2. Sélectionnez Instances.

  3. Sélectionnez l’instance de l’agent de console.

  4. Sélectionnez Actions > Sécurité > Modifier le rôle IAM.

  5. Sélectionnez le rôle IAM et sélectionnez Mettre à jour le rôle IAM.

Clé d'accès AWS

Fournissez à la NetApp Console la clé d’accès AWS pour un utilisateur IAM disposant des autorisations requises.

Étapes

  1. Sélectionnez Administration > Informations d'identification.

  2. Sélectionnez Informations d'identification de l'organisation.

  3. Sélectionnez Ajouter des informations d’identification et suivez les étapes de l’assistant.

    1. Emplacement des informations d'identification : Sélectionnez Amazon Web Services > Agent.

    2. Définir les informations d'identification : saisissez une clé d'accès AWS et une clé secrète.

    3. Abonnement Marketplace : Associez un abonnement Marketplace à ces informations d'identification en vous abonnant maintenant ou en sélectionnant un abonnement existant.

    4. Révision : Confirmez les détails des nouvelles informations d'identification et sélectionnez Ajouter.

Rôle Azure

Accédez au portail Azure et attribuez le rôle personnalisé Azure à la machine virtuelle de l’agent de console pour un ou plusieurs abonnements.

Étapes

  1. Depuis le portail Azure, ouvrez le service Abonnements et sélectionnez votre abonnement.

    Il est important d'attribuer le rôle à partir du service Abonnements car cela spécifie la portée de l'attribution du rôle au niveau de l'abonnement. La scope définit l’ensemble des ressources auxquelles l’accès s’applique. Si vous spécifiez une étendue à un niveau différent (par exemple, au niveau de la machine virtuelle), votre capacité à effectuer des actions à partir de la NetApp Console sera affectée.

    "Documentation Microsoft Azure : Comprendre la portée d'Azure RBAC"

  2. Sélectionnez Contrôle d'accès (IAM) > Ajouter > Ajouter une attribution de rôle.

  3. Dans l’onglet Rôle, sélectionnez le rôle Opérateur de console et sélectionnez Suivant.

    Remarque L'opérateur de console est le nom par défaut fourni dans la politique. Si vous avez choisi un nom différent pour le rôle, sélectionnez plutôt ce nom.

  4. Dans l'onglet Membres, procédez comme suit :

    1. Attribuer l'accès à une identité gérée.

    2. Sélectionnez Sélectionner les membres, sélectionnez l’abonnement dans lequel la machine virtuelle de l’agent de console a été créée, sous Identité gérée, choisissez Machine virtuelle, puis sélectionnez la machine virtuelle de l’agent de console.

    3. Sélectionnez Sélectionner.

    4. Sélectionnez Suivant.

    5. Sélectionnez Réviser + attribuer.

    6. Si vous souhaitez gérer des ressources dans des abonnements Azure supplémentaires, passez à cet abonnement, puis répétez ces étapes.

Principal de service Azure

Fournissez à la NetApp Console les identifiants du principal de service Azure que vous avez configuré précédemment.

Étapes

  1. Sélectionnez Administration > Informations d'identification.

  2. Sélectionnez Ajouter des informations d’identification et suivez les étapes de l’assistant.

    1. Emplacement des informations d'identification : sélectionnez Microsoft Azure > Agent.

    2. Définir les informations d'identification : saisissez les informations sur le principal du service Microsoft Entra qui accorde les autorisations requises :

      • ID de l'application (client)

      • ID du répertoire (locataire)

      • Secret client

    3. Abonnement Marketplace : Associez un abonnement Marketplace à ces informations d'identification en vous abonnant maintenant ou en sélectionnant un abonnement existant.

    4. Révision : Confirmez les détails des nouvelles informations d'identification et sélectionnez Ajouter.

Résultat

La NetApp Console dispose désormais des autorisations nécessaires pour effectuer des actions dans Azure en votre nom.

Compte de service Google Cloud

Associez le compte de service à la machine virtuelle de l’agent de console.

Étapes

  1. Accédez au portail Google Cloud et attribuez le compte de service à l’instance de machine virtuelle de l’agent de la console.

    "Documentation Google Cloud : Modification du compte de service et des étendues d'accès pour une instance"

  2. Si vous souhaitez gérer les ressources d’autres projets, accordez l’accès en ajoutant le compte de service avec le rôle d’agent de console à ce projet. Vous devrez répéter cette étape pour chaque projet.