Présentation de l'installation d'un périphérique

Une installation Edge type est composée de composants Edge répartis sur plusieurs nœuds. Après avoir installé Edge sur un nœud, vous installez et configurez un ou plusieurs composants Edge sur ce nœud.

Procédure d'installation

L'installation d'Edge sur un nœud est un processus en plusieurs étapes :

1. Désactivez SELinux sur le nœud ou définissez-le sur le mode permissif. Pour en savoir plus, consultez Installer l'utilitaire apigee-setup Edge pour plus.
2. Décidez si vous souhaitez activer l'authentification Cassandra.
3. Décidez si vous souhaitez configurer la réplication maître-veille pour Postgres.
4. Sélectionnez votre configuration Edge dans la liste des topologies recommandées. Par exemple, vous pouvez installer Edge sur un seul nœud pour les tests ou sur 13 nœuds pour la production. Pour en savoir plus, consultez Topologies d'installation.
5. Sur chaque nœud de la topologie sélectionnée, installez l'utilitaire apigee-setup Edge :
   • Téléchargez le fichier Edge bootstrap_4.54.00.sh dans /tmp/bootstrap_4.54.00.sh.
   • Installez l'utilitaire apigee-service Edge et les dépendances.
   • Installez l'utilitaire apigee-setup Edge et les dépendances.

     Pour en savoir plus, consultez Installer l'utilitaire apigee-setup Edge.

6. Utilisez l'utilitaire apigee-setup pour installer un ou plusieurs composants Edge sur chaque nœud en fonction de la topologie sélectionnée.

   Consultez Installer des composants Edge sur un nœud.

7. Sur le nœud du serveur de gestion, utilisez l'utilitaire apigee-setup pour installer apigee-provision, les utilitaires que vous utilisez pour créer et gérer des organisations Edge.

   Pour en savoir plus, consultez Intégrer une organisation.

8. Redémarrez le composant de l'interface utilisateur New Edge sur chaque nœud une fois l'installation terminée, comme illustré dans l'exemple suivant :

   /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

9. Configurez l'authentification et les paramètres facultatifs pour l'interface utilisateur New Edge (dont les noms de composants sont edge-management-ui et edge-management-ui-static).

   Pour en savoir plus, consultez Configurer l'interface utilisateur New Edge.

Une fois l'installation terminée, consultez cette liste d' actions courantes à effectuer après l'installation.

Qui peut effectuer l'installation ?

Les fichiers de distribution Apigee Edge sont installés sous forme d'ensemble de RPM et de dépendances. Pour installer, désinstaller et mettre à jour les RPM Edge, les commandes doivent être exécutées par l'utilisateur racine ou par un utilisateur disposant d'un accès sudo complet. Un accès sudo complet signifie que l'utilisateur dispose d'un accès sudo pour effectuer les mêmes opérations que l'utilisateur racine.

Tout utilisateur souhaitant exécuter les commandes ou scripts suivants doit être l'utilisateur racine ou un utilisateur disposant d'un accès sudo complet :

• Utilitaire apigee-service :
  • Commandes apigee-service : install, uninstall, update.
  • Commandes apigee-all : install, uninstall, update.
• Script setup.sh pour installer les composants Edge (sauf si vous avez déjà utilisé "apigee-service install" pour installer les RPM requis. Dans ce cas, l'accès racine ou sudo complet n'est pas nécessaire.)
• Script update.sh pour mettre à jour les composants Edge

De plus, le programme d'installation Edge crée un nouvel utilisateur nommé "apigee" sur votre système. De nombreuses commandes Edge appellent sudo pour s'exécuter en tant qu'utilisateur "apigee".

Tout utilisateur souhaitant exécuter d'autres commandes que celles présentées ci-dessus doit disposer d'un accès sudo complet à l'utilisateur "apigee". Ces commandes incluent les suivantes :

• Commandes de l'utilitaire apigee-service, y compris les suivantes :
  • Commandes apigee-service telles que start, stop, restart, configure.
  • Commandes apigee-all telles que start, stop, restart, configure.

Créer un utilisateur disposant d'un accès sudo complet à l'utilisateur "apigee"

Pour configurer un utilisateur afin qu'il dispose d'un accès sudo complet à l'utilisateur "apigee", utilisez la commande "visudo" pour modifier le fichier sudoers et ajouter :

installUser        ALL=(apigee)      NOPASSWD: ALL

où installUser est le nom d'utilisateur de la personne qui travaille avec Edge.

Définir des autorisations sur les fichiers de configuration

Tous les fichiers ou ressources utilisés par les commandes Edge doivent être accessibles à l'utilisateur "apigee". Cela inclut le fichier de licence Edge et tous les fichiers de configuration.

Lorsque vous créez un fichier de configuration, vous pouvez modifier son propriétaire en "apigee:apigee" pour vous assurer qu'il est accessible aux commandes Edge :

1. Créez le fichier dans un éditeur en tant qu'utilisateur.
2. chown le propriétaire du fichier sur "apigee:apigee" ou, si vous avez modifié l'utilisateur exécutant le service Edge à partir de l'utilisateur "apigee", chown le fichier à l'utilisateur qui exécute le service Edge.

Séparer les tâches d'installation Edge entre l'utilisateur racine et l'utilisateur non racine

Bien qu'il soit plus simple d'effectuer l'ensemble du processus d'installation Edge en tant qu'utilisateur racine ou par un utilisateur qui dispose d'un accès sudo complet, cela n'est pas toujours possible. Vous pouvez plutôt séparer le processus en tâches effectuées par l'utilisateur racine et en tâches effectuées par un utilisateur disposant d'un accès sudo complet à l'utilisateur « apigee ».

1. Tâches effectuées par l'utilisateur racine :
   1. Téléchargez et exécutez le fichier bootstrap_4.54.00.sh :

      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
      sudo bash /tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord

      Cette étape installe l'utilitaire apigee-service et crée l'utilisateur "apigee" .

   2. Configurez un utilisateur afin qu'il dispose d'un accès sudo complet à l'utilisateur "apigee", comme décrit dans Créer un utilisateur disposant d'un accès sudo complet à l'utilisateur "apigee".
   3. Installez l'utilitaire apigee-setup :

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

   4. Utilisez l'utilitaire apigee-setup pour installer les RPM Edge sur le nœud :

      /opt/apigee/apigee-service/bin/apigee-service compName install

      Les RPM Edge que vous installez sur le nœud dépendent de votre topologie. La liste des composants disponibles inclut : apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-management-server, edge-management-ui, edge-management-ui-static, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server.

2. Une fois que l'utilisateur racine a installé les RPM Edge sur le nœud, l'utilisateur disposant d'un accès sudo complet à l'utilisateur "apigee" termine le processus de configuration:
   1. Utilisez l'utilitaire setup.sh pour terminer la configuration des composants Edge sur le nœud. La forme de la commande dépend des composants que vous installés sur le nœud. Pour obtenir la liste complète, consultez Installer des composants Edge sur un nœud.

      Par exemple, pour terminer l'installation de ZooKeeper et de Cassandra, utilisez la commande suivante :

      /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile

      où configFile est le fichier de configuration Edge.

      Pour effectuer une installation tout-en-un, utilisez la commande suivante :

      /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile

Emplacement des fichiers de configuration de l'installation

Vous devez transmettre un fichier de configuration à l'utilitaire apigee-setup contenant les informations sur l'installation Edge. La seule exigence concernant les installations silencieuses est que le fichier de configuration doit être accessible ou lisible par l'utilisateur "apigee". Par exemple, placez le fichier dans le /usr/local/var ou /usr/local/share répertoire sur le nœud et chown sur "apigee:apigee".

Toutes les informations du fichier de configuration sont obligatoires, à l'exception du mot de passe de l'administrateur système Edge. Si vous omettez le mot de passe, l'utilitaire apigee-setup vous invite à le saisir sur la ligne de commande.

Pour en savoir plus, consultez Installer des composants Edge sur un nœud.

Gérer un échec d'installation

En cas d'échec lors de l'installation d'un composant Edge, vous pouvez essayer de corriger le problème, puis exécuter à nouveau le programme d'installation. Le programme d'installation est conçu pour être exécuté de manière répétée en cas de détection d'un échec ou si vous souhaitez modifier ou mettre à jour un composant après l'installation.

Après l'installation ou la mise à niveau, veillez à redémarrer le composant de l'interface utilisateur New Edge sur chaque nœud sur lequel il s'exécute.

Installation avec ou sans Internet

Pour installer Edge sur un nœud, celui-ci doit pouvoir accéder au dépôt Apigee :

• Nœuds avec une connexion Internet externe

  Les nœuds disposant d'une connexion Internet externe accèdent au dépôt Apigee pour installer les RPM Edge et les dépendances.

• Nœuds sans connexion Internet externe

  Les nœuds sans connexion Internet externe peuvent accéder à une version mise en miroir du dépôt Apigee que vous configurez en interne. Ce dépôt contient tous les RPM Edge, mais vous devez vous assurer que toutes les autres dépendances sont disponibles à partir des dépôts sur le réseau interne.

  Pour créer le dépôt Apigee interne, vous avez besoin d'un nœud disposant d'un accès Internet externe pour pouvoir télécharger les RPM Edge et les dépendances. Une fois le dépôt interne créé, vous pouvez le déplacer vers un autre nœud ou rendre ce nœud accessible aux nœuds Edge pour l'installation.

Utiliser un dépôt Edge local pour gérer votre version Edge

L'une des raisons d'utiliser un dépôt local ou mis en miroir est d'installer Edge sur des nœuds sans connexion Internet externe, comme décrit dans la section précédente.

Résoudre les dépendances d'installation des RPM

Les fichiers de distribution Apigee Edge sont installés sous forme d'ensemble de fichiers RPM, chacun pouvant avoir sa propre chaîne de dépendances d'installation. Nombre de ces dépendances sont définies par des composants tiers qui ne sont pas contrôlés par Apigee et peuvent changer à tout moment. Par conséquent, la documentation ne répertorie pas le numéro de version explicite de chaque dépendance.

Si vous effectuez une installation sur une machine disposant d'un accès à Internet, le nœud peut télécharger les RPM et les dépendances nécessaires. Toutefois, si vous effectuez l'installation à partir d'un nœud sans accès à Internet, vous configurez généralement un dépôt interne contenant toutes les dépendances nécessaires. La seule façon de garantir que toutes les dépendances sont incluses dans votre dépôt local consiste à tenter une installation, à identifier les dépendances manquantes et à les copier dans le dépôt local jusqu'à ce que l'installation réussisse.

Commandes Yum courantes

Les outils d'installation Edge pour Linux s'appuient sur Yum pour installer et mettre à jour les composants. Vous devrez peut-être utiliser plusieurs commandes Yum pour gérer une installation sur un nœud.

• Nettoyez tous les caches Yum :

  sudo yum clean all

• Pour mettre à jour un composant Edge :

  sudo yum update componentName

  Exemple :

  sudo yum update apigee-setup
  sudo yum update edge-management-server

Structure du système de fichiers

Edge installe tous les fichiers dans le répertoire /opt/apigee.

Dans ce guide et dans le guide des opérations Edge, le répertoire d'installation racine est indiqué comme suit :

/opt/apigee

L'installation utilise la structure de système de fichiers suivante pour déployer Apigee Edge for Private Cloud.

Fichiers journaux

Le fichier journal de apigee-setup et du script setup.sh est écrit dans /tmp/setup-root.log.

Les fichiers journaux de chaque composant sont contenus dans le /opt/apigee/var/log répertoire. Chaque composant possède son propre sous-répertoire. Par exemple, les journaux du serveur de gestion se trouvent dans le répertoire :

/opt/apigee/var/log/edge-management-server

Les tableaux suivants indiquent l'emplacement des fichiers journaux :

Données

Activer la vérification du système lors de l'installation

Le fichier de configuration de l'installation Edge accepte la propriété suivante :

ENABLE_SYSTEM_CHECK=y

Si vous définissez cette propriété sur "y", le programme d'installation vérifie que le système répond aux exigences de processeur et de mémoire pour le composant en cours d'installation. La valeur par défaut est "n" pour désactiver la vérification.