Installez manuellement le connecteur dans AWS
Un connecteur est un logiciel NetApp exécuté sur votre réseau cloud ou sur site, qui vous permet d'utiliser toutes les fonctionnalités et services BlueXP . L'une des options d'installation disponibles consiste à installer manuellement le logiciel Connector sur un hôte Linux s'exécutant dans AWS. Pour installer manuellement le connecteur sur votre propre hôte Linux, vous devez vérifier la configuration requise pour l'hôte, configurer le réseau, préparer les autorisations AWS, installer le connecteur, puis fournir les autorisations que vous avez préparées.
-
Vous devriez avoir un "Compréhension des connecteurs".
-
Vous devriez passer en revue "Limitations du connecteur".
Étape 1 : vérifiez la configuration requise pour l'hôte
Le logiciel du connecteur doit être exécuté sur un hôte qui répond à des exigences spécifiques du système d'exploitation, de la RAM, des ports, etc.
- Hôte dédié
-
Le connecteur n'est pas pris en charge sur un hôte partagé avec d'autres applications. L'hôte doit être un hôte dédié.
- Hyperviseur
-
Un hyperviseur bare Metal ou hébergé certifié pour exécuter un système d'exploitation pris en charge est requis.
- exigences relatives au système d'exploitation et aux conteneurs
-
BlueXP prend en charge le connecteur avec les systèmes d'exploitation suivants lors de l'utilisation de BlueXP en mode standard ou en mode restreint. Un outil d'orchestration de conteneurs est nécessaire avant d'installer le connecteur.
Système d'exploitation Versions de OS prises en charge Versions de connecteur prises en charge Outil de conteneur requis SELinux Red Hat Enterprise Linux
9.1 à 9.4
8.6 à 8.10
3.9.40 ou ultérieure avec BlueXP en mode standard ou restreint
Podman version 4.6.1 ou 4.9.4
Pris en charge en mode d'application ou en mode d'autorisation 1
Ubuntu
24,04 LTS
3.9.45 ou ultérieure avec BlueXP en mode standard ou restreint
Moteur Docker 26.0.0
Non pris en charge
Remarques :
-
La gestion des systèmes Cloud Volumes ONTAP n'est pas prise en charge par les connecteurs sur lesquels SELinux est activé sur le système d'exploitation.
-
Le connecteur est pris en charge sur les versions en anglais de ces systèmes d'exploitation.
-
Pour RHEL, l'hôte doit être enregistré auprès de Red Hat Subscription Management. S'il n'est pas enregistré, l'hôte ne peut pas accéder aux référentiels pour mettre à jour les logiciels tiers requis lors de l'installation du connecteur.
-
- CPU
-
8 cœurs ou 8 CPU virtuels
- RAM
-
32 GO
- Type d'instance AWS EC2
-
Type d'instance qui répond aux exigences relatives au CPU et à la RAM indiquées ci-dessus. Nous recommandons t3.2xlarge.
- Paire de clés
-
Lorsque vous créez le connecteur, vous devez sélectionner une paire de clés EC2 à utiliser avec l'instance.
- Limite de sauts de réponse lors de l'utilisation d'IMDSv2
-
Si IMDSv2 est activé sur l'instance EC2 (il s'agit du paramètre par défaut pour les nouvelles instances EC2), vous devez définir la limite de saut de réponse PUT sur l'instance sur 3. Si vous ne modifiez pas la limite sur l'instance EC2, une erreur d'initialisation de l'interface utilisateur s'affiche lorsque vous essayez de configurer le connecteur.
- Espace disque dans /opt
-
100 Gio d'espace doit être disponible
BlueXP utilise
/opt
pour installer le/opt/application/netapp
répertoire et son contenu. - Espace disque dans /var
-
20 Gio d'espace doit être disponible
BlueXP requiert cet espace dans
/var
Car l'architecture de Docker ou Podman est conçue pour créer les conteneurs dans ce répertoire. Plus précisément, ils créeront des conteneurs dans le/var/lib/containers/storage
répertoire. Les montages externes ou les liens symboliques ne fonctionnent pas pour cet espace.
Étape 2 : installez Podman ou Docker Engine
Selon votre système d'exploitation, Podman ou Docker Engine est requis avant d'installer le connecteur.
-
Podman est requis pour Red Hat Enterprise Linux 8 et 9.
-
Docker Engine est requis pour Ubuntu.
Procédez comme suit pour installer Podman et le configurer pour répondre aux exigences suivantes :
-
Le service podman.socket doit être activé et démarré
-
python3 doit être installé
-
Le package podman-compose version 1.0.6 doit être installé
-
Podman-compose doit être ajouté à la variable d'environnement PATH
-
Retirez le package podman-docker s'il est installé sur l'hôte.
dnf remove podman-docker rm /var/run/docker.sock
-
Installez Podman.
Podman est disponible dans les référentiels Red Hat Enterprise Linux officiels.
Pour Red Hat Enterprise Linux 9 :
sudo dnf install podman-2:<version>
Où <version> est la version prise en charge de Podman que vous installez. Affichez les versions de Podman prises en charge par BlueXP .
Pour Red Hat Enterprise Linux 8 :
sudo dnf install podman-3:<version>
Où <version> est la version prise en charge de Podman que vous installez. Affichez les versions de Podman prises en charge par BlueXP .
-
Activez et démarrez le service podman.socket.
sudo systemctl enable --now podman.socket
-
Monter python3.
sudo dnf install python3
-
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 à partir du référentiel Extra Packages for Enterprise Linux (EPEL).
Pour Red Hat Enterprise Linux 9 :
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
Pour Red Hat Enterprise Linux 8 :
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
-
Installez le paquet podman-compose 1.0.6.
sudo dnf install podman-compose-1.0.6
À l'aide du 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 lesecure_path
sur l'hôte.
Suivez la documentation de Docker pour installer Docker Engine.
-
"Voir les instructions d'installation de Docker"
Veillez à suivre les étapes d'installation d'une version spécifique de Docker Engine. L'installation de la dernière version installe une version de Docker que BlueXP ne prend pas en charge.
-
Vérifiez que Docker est activé et exécuté.
sudo systemctl enable docker && sudo systemctl start docker
Étape 3 : configuration du réseau
Assurez-vous que l'emplacement réseau où vous prévoyez d'installer le connecteur prend en charge les exigences suivantes. En répondant à ces exigences, il peut gérer les ressources et les processus dans votre environnement de cloud hybride.
- Connexions aux réseaux cibles
-
Un connecteur nécessite une connexion réseau à l'emplacement où vous prévoyez de créer et de gérer des environnements de travail. Par exemple, le réseau sur lequel vous prévoyez de créer des systèmes Cloud Volumes ONTAP ou un système de stockage dans votre environnement sur site.
- Accès Internet sortant
-
L'emplacement réseau où vous déployez le connecteur doit disposer d'une connexion Internet sortante pour contacter des points finaux spécifiques.
- Noeuds finaux contactés depuis les ordinateurs lors de l'utilisation de la console Web BlueXP
-
Les ordinateurs qui accèdent à la console BlueXP à partir d'un navigateur Web doivent avoir la possibilité de contacter plusieurs noeuds finaux. Vous devez utiliser la console BlueXP pour configurer le connecteur et pour l'utilisation quotidienne de BlueXP .
- Points finaux contactés lors de l'installation manuelle
-
Lorsque vous installez manuellement le connecteur sur votre propre hôte Linux, le programme d'installation du connecteur nécessite l'accès aux URL suivantes pendant le processus d'installation :
-
https://support.netapp.com
-
https://mysupport.netapp.com
-
https://signin.b2c.NetApp.com (ce noeud final est l'URL CNAME pour https://mysupport.NetApp.com)
-
https://cloudmanager.cloud.netapp.com/tenancy
-
https://stream.cloudmanager.cloud.netapp.com
-
https://production-artifacts.cloudmanager.cloud.netapp.com
-
https://*.blob.core.windows.net
-
https://cloudmanagerinfraprod.azurecr.io
L'hôte peut essayer de mettre à jour les packages du système d'exploitation lors de l'installation. L'hôte peut contacter différents sites de mise en miroir pour ces packages OS.
-
- Points d'extrémité contactés depuis le connecteur
-
Le connecteur nécessite un accès Internet sortant pour contacter les terminaux suivants afin de gérer les ressources et les processus au sein de votre environnement de cloud public pour les opérations quotidiennes.
Notez que les points finaux répertoriés ci-dessous sont tous des entrées CNAME.
Terminaux Objectif Services AWS (amazonaws.com):
-
CloudFormation
-
Cloud de calcul élastique (EC2)
-
Gestion des identités et des accès
-
Service de gestion des clés (KMS)
-
Service de jetons de sécurité (STS)
-
Service de stockage simple (S3)
Pour gérer les ressources dans AWS. Le terminal exact dépend de la région AWS que vous utilisez. "Pour plus d'informations, consultez la documentation AWS"
https://support.netapp.com
https://mysupport.netapp.comPour obtenir des informations sur les licences et envoyer des messages AutoSupport au support NetApp.
https://*.api.bluexp.netapp.com
https://api.bluexp.netapp.com
https://*.cloudmanager.cloud.netapp.com
https://cloudmanager.cloud.netapp.com
https://netapp-cloud-account.auth0.com
Pour fournir des fonctions et des services SaaS dans BlueXP.
Notez que le connecteur est actuellement en contact avec « cloudmanager.cloud.netapp.com", mais il commencera à contacter « api.bluexp.netapp.com" dans une prochaine version.
https://*.blob.core.windows.net
https://cloudmanagerinfraprod.azurecr.io
Pour mettre à niveau le connecteur et ses composants Docker.
-
- Serveur proxy
-
Si votre entreprise nécessite le déploiement d'un serveur proxy pour tout le trafic Internet sortant, procurez-vous les informations suivantes sur votre proxy HTTP ou HTTPS. Vous devrez fournir ces informations pendant l'installation. Notez que BlueXP ne prend pas en charge les serveurs proxy transparents.
-
Adresse IP
-
Informations d'identification
-
Certificat HTTPS
-
- Ports
-
Il n'y a pas de trafic entrant vers le connecteur, sauf si vous l'initiez ou si le connecteur est utilisé comme proxy pour envoyer des messages AutoSupport de Cloud Volumes ONTAP au support NetApp.
-
HTTP (80) et HTTPS (443) permettent d'accéder à l'interface utilisateur locale que vous utiliserez dans de rares circonstances.
-
SSH (22) n'est nécessaire que si vous devez vous connecter à l'hôte pour le dépannage.
-
Les connexions entrantes via le port 3128 sont requises si vous déployez des systèmes Cloud Volumes ONTAP dans un sous-réseau où aucune connexion Internet sortante n'est disponible.
Si les systèmes Cloud Volumes ONTAP ne disposent pas d'une connexion Internet sortante pour envoyer des messages AutoSupport, BlueXP les configure automatiquement pour qu'ils utilisent un serveur proxy inclus avec le connecteur. La seule condition est de s'assurer que le groupe de sécurité du connecteur autorise les connexions entrantes sur le port 3128. Vous devrez ouvrir ce port après le déploiement du connecteur.
-
- Activez le protocole NTP
-
Si vous prévoyez d'utiliser la classification BlueXP pour analyser vos sources de données d'entreprise, vous devez activer un service NTP (Network Time Protocol) sur le système de connecteur BlueXP et le système de classification BlueXP afin que l'heure soit synchronisée entre les systèmes. "En savoir plus sur la classification BlueXP"
Étape 4 : configurer les autorisations
Vous devez fournir des autorisations AWS à BlueXP via l'une des options suivantes :
-
Option 1 : créez des règles IAM et associez-les à un rôle IAM que vous pouvez associer à l'instance EC2.
-
Option 2 : fournissez à BlueXP la clé d'accès AWS pour un utilisateur IAM qui dispose des autorisations requises.
Suivez les étapes pour préparer les autorisations pour BlueXP.
-
Connectez-vous à la console AWS et accédez au service IAM.
-
Création d'une règle :
-
Sélectionnez stratégies > Créer une stratégie.
-
Sélectionnez JSON et copiez et collez le contenu du "Politique IAM pour le connecteur".
-
Terminez les étapes restantes pour créer la stratégie.
Selon les services BlueXP que vous prévoyez d'utiliser, il peut être nécessaire de créer une seconde règle. Pour les régions standard, les autorisations sont réparties entre deux règles. Deux règles sont requises en raison d'une taille maximale de caractères pour les stratégies gérées dans AWS. "En savoir plus sur les règles IAM pour le connecteur".
-
-
Créer un rôle IAM :
-
Sélectionnez rôles > Créer un rôle.
-
Sélectionnez AWS service > EC2.
-
Ajoutez des autorisations en joignant la stratégie que vous venez de créer.
-
Terminez les étapes restantes pour créer le rôle.
-
Vous disposez désormais d'un rôle IAM que vous pouvez associer à l'instance EC2 après avoir installé le connecteur.
-
Connectez-vous à la console AWS et accédez au service IAM.
-
Création d'une règle :
-
Sélectionnez stratégies > Créer une stratégie.
-
Sélectionnez JSON et copiez et collez le contenu du "Politique IAM pour le connecteur".
-
Terminez les étapes restantes pour créer la stratégie.
Selon les services BlueXP que vous prévoyez d'utiliser, il peut être nécessaire de créer une seconde règle.
Pour les régions standard, les autorisations sont réparties entre deux règles. Deux règles sont requises en raison d'une taille maximale de caractères pour les stratégies gérées dans AWS. "En savoir plus sur les règles IAM pour le connecteur".
-
-
Associer les règles à un utilisateur IAM.
-
Assurez-vous que l'utilisateur dispose d'une clé d'accès que vous pouvez ajouter à BlueXP après l'installation du connecteur.
Vous disposez désormais d'un utilisateur IAM qui dispose des autorisations requises et d'une clé d'accès que vous pouvez fournir à BlueXP.
Étape 5 : installez le connecteur
Une fois la configuration requise terminée, vous pouvez installer manuellement le logiciel sur votre propre hôte Linux.
Vous devez disposer des éléments suivants :
-
Privilèges root pour installer le connecteur.
-
Détails sur un serveur proxy, si un proxy est requis pour accéder à Internet à partir du connecteur.
Vous avez la possibilité de configurer un serveur proxy après l'installation, mais cela nécessite de redémarrer le connecteur.
Notez que BlueXP ne prend pas en charge les serveurs proxy transparents.
-
Un certificat signé par une autorité de certification, si le serveur proxy utilise HTTPS ou si le proxy est un proxy interceptant.
Le programme d'installation disponible sur le site du support NetApp peut être une version antérieure. Après l'installation, le connecteur se met automatiquement à jour si une nouvelle version est disponible.
-
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 échouera.
-
Téléchargez le logiciel du connecteur à partir du "Site de support NetApp", Puis copiez-le sur l'hôte Linux.
Vous devez télécharger le programme d'installation du connecteur « en ligne » destiné à être utilisé sur votre réseau ou dans le cloud. Un programme d'installation séparé « hors ligne » est disponible pour le connecteur, mais il n'est pris en charge que pour les déploiements en mode privé.
-
Attribuez des autorisations pour exécuter le script.
chmod +x BlueXP-Connector-Cloud-<version>
Où <version> est la version du connecteur que vous avez téléchargé.
-
Exécutez le script d'installation.
./BlueXP-Connector-Cloud-<version> --proxy <HTTP or HTTPS proxy server> --cacert <path and file name of a CA-signed certificate>
Les paramètres --proxy et --cacert sont facultatifs. Si vous disposez d'un serveur proxy, vous devez entrer les paramètres comme indiqué. Le programme d'installation ne vous invite pas à fournir des informations sur un proxy.
Voici un exemple de commande utilisant les deux paramètres facultatifs :
./BlueXP-Connector-Cloud-v3.9.40--proxy https://user:password@10.0.0.30:8080/ --cacert /tmp/cacert/certificate.cer
--proxy configure le connecteur pour utiliser un serveur proxy HTTP ou HTTPS à l'aide de l'un des formats suivants :
-
http://address:port
-
http://user-name:password@address:port
-
http://domain-name%92user-name:password@address:port
-
https://address:port
-
https://user-name:password@address:port
-
https://domain-name%92user-name:password@address: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.
-
BlueXP ne prend pas en charge les noms d'utilisateur ou les mots de passe qui incluent 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éajoutant avec une barre oblique inverse : & ou !
Par exemple :
http://bxpproxyuser:netapp1\!@address:3128
-
--cacert spécifie un certificat signé par une autorité de certification à utiliser pour l'accès HTTPS entre le connecteur et le serveur proxy. Ce paramètre est requis uniquement si vous spécifiez un serveur proxy HTTPS ou si le proxy est un proxy interceptant.
-
-
Attendez la fin de l'installation.
À la fin de l'installation, le service connecteur (ocm) redémarre deux fois si vous avez spécifié un serveur proxy.
-
Ouvrez un navigateur Web à partir d'un hôte connecté à la machine virtuelle Connector et entrez l'URL suivante :
-
Une fois connecté, configurez le connecteur :
-
Spécifiez l'organisation BlueXP à associer au connecteur.
-
Entrez un nom pour le système.
-
Sous exécutez-vous dans un environnement sécurisé ? maintenez le mode restreint désactivé.
Vous devez désactiver le mode restreint, car ces étapes décrivent l'utilisation de BlueXP en mode standard. Vous devez activer le mode restreint uniquement si vous disposez d'un environnement sécurisé et souhaitez déconnecter ce compte des services back-end BlueXP. Si c'est le cas, "Suivez les étapes pour démarrer avec BlueXP en mode restreint".
-
Sélectionnez commençons.
-
Le connecteur est maintenant installé et configuré avec votre organisation BlueXP .
Si vous avez des compartiments Amazon S3 dans le même compte AWS que vous avez créé le connecteur, un environnement de travail Amazon S3 s'affiche automatiquement sur le canevas BlueXP. "Découvrez comment gérer des compartiments S3 à partir de BlueXP"
Étape 6 : fournissez des autorisations à BlueXP
Maintenant que vous avez installé le connecteur, vous devez fournir à BlueXP les autorisations AWS que vous avez précédemment configurées. Si vous disposez des autorisations requises, BlueXP peut gérer vos données et votre infrastructure de stockage dans AWS.
Reliez le rôle IAM que vous avez créé précédemment à l'instance Connector EC2.
-
Accédez à la console Amazon EC2.
-
Sélectionnez instances.
-
Sélectionnez l'instance de connecteur.
-
Sélectionnez actions > sécurité > Modifier le rôle IAM.
-
Sélectionnez le rôle IAM et sélectionnez mettre à jour le rôle IAM.
BlueXP dispose désormais des autorisations dont il a besoin pour effectuer des actions dans AWS en votre nom.
Accédez au "Console BlueXP" Pour commencer à utiliser le connecteur avec BlueXP.
Fournissez à BlueXP la clé d'accès AWS pour un utilisateur IAM qui dispose des autorisations requises.
-
Assurez-vous que le bon connecteur est actuellement sélectionné dans BlueXP.
-
Dans le coin supérieur droit de la console BlueXP, sélectionnez l'icône Paramètres, puis sélectionnez informations d'identification.
-
Sélectionnez Ajouter des informations d'identification et suivez les étapes de l'assistant.
-
Emplacement des informations d'identification : sélectionnez Amazon Web Services > connecteur.
-
Définir les informations d'identification : saisissez une clé d'accès AWS et une clé secrète.
-
Abonnement Marketplace : associez un abonnement Marketplace à ces identifiants en vous abonnant maintenant ou en sélectionnant un abonnement existant.
-
Révision : confirmez les détails des nouvelles informations d'identification et sélectionnez Ajouter.
-
BlueXP dispose désormais des autorisations dont il a besoin pour effectuer des actions dans AWS en votre nom.
Accédez au "Console BlueXP" Pour commencer à utiliser le connecteur avec BlueXP.