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

Une installation Edge typique se compose 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 le 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 en mode permissif. Voir Installez l'utilitaire de configuration Edge apigee pour plus encore.
  2. Indiquez si vous souhaitez activer l'authentification Cassandra.
  3. Décidez si vous souhaitez configurer une réplication maître en secours pour Postgres.
  4. Sélectionnez votre configuration Edge dans la liste des topologies recommandées. Par exemple : peut installer Edge sur un seul nœud à des fins de test, ou sur 13 nœuds pour la production. Voir Topologies d'installation.
  5. Sur chaque nœud de la topologie sélectionnée, installez l'utilitaire Edge apigee-setup: <ph type="x-smartling-placeholder">
      </ph>
    • Téléchargez le fichier Edge bootstrap_4.52.01.sh sur /tmp/bootstrap_4.52.01.sh
    • Installez l'utilitaire Edge apigee-service et les dépendances.
    • Installez l'utilitaire Edge apigee-setup et les dépendances.

      Voir Installer Edge apigee-setup utilitaire.

  6. Utilisez l'utilitaire apigee-setup pour installer un ou plusieurs composants Edge sur chaque 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 Edge pour les entreprises.

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

  8. Redémarrez le composant d'interface utilisateur classique sur chaque nœud une fois l'installation terminée. comme le montre l'exemple suivant:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  9. (Recommandé) Une fois l'installation initiale terminée, Apigee recommande d'installer la nouvelle interface utilisateur Edge (dont le nom de composant est edge-management-ui), qui est une interface utilisateur améliorée pour les développeurs et les administrateurs d'Apigee Edge pour Private Cloud.

    Pour en savoir plus, consultez Installer la nouvelle interface utilisateur Edge.

Une fois l'installation terminée, consultez cette liste les plus courantes après l'installation.

Qui peut effectuer l'installation ?

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

Tout utilisateur qui souhaite exécuter les commandes ou scripts suivants doit être un utilisateur racine ou un utilisateur avec un accès sudo complet:

  • Utilitaire apigee-service: <ph type="x-smartling-placeholder">
      </ph>
    • Commandes apigee-service: install, uninstall, update.
    • Commandes apigee-all: install, uninstall, update.
  • setup.sh pour installer les composants Edge (à moins que vous n'ayez déjà utilisé "apigee-service install" pour installer les RPM requis. Puis, « root » ou « sudo un accès s'il 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 sur votre système, nommé "apigee". Nombreuses commandes Edge invoquer sudo pour s'exécuter en tant que "apigee" utilisateur.

Tout utilisateur qui souhaite exécuter toutes les autres commandes que celles présentées ci-dessus doit disposer de un accès sudo complet à « apigee » utilisateur. Voici quelques-unes de ces commandes:

  • Commandes utilitaires apigee-service, y compris: <ph type="x-smartling-placeholder">
      </ph>
    • Commandes apigee-service telles que start, stop, restart, configure.
    • Commandes apigee-all telles que start, stop, restart, configure.

Créer un utilisateur avec un accès sudo complet à "apigee" utilisateur

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

installUser        ALL=(apigee)      NOPASSWD: ALL

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 au "apigee" utilisateur. Ce inclut le fichier de licence Edge et tous les fichiers de configuration.

Lors de la création d'un fichier de configuration, vous pouvez remplacer son propriétaire par "apigee:apigee" pour vous assurer il est accessible aux commandes Edge:

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

Séparation des tâches d'installation Edge entre les utilisateurs racine et non racine

Bien qu'il soit plus simple d'effectuer l'intégralité du processus d'installation Edge en mode root ou par un utilisateur qui dispose d'un accès sudo complet, ce qui n'est pas toujours possible. À la place, vous pouvez séparer en tâches effectuées par la racine et tâches effectuées par un utilisateur avec un accès sudo complet à « apigee » utilisateur.

  1. Tâches effectuées par l'utilisateur racine: <ph type="x-smartling-placeholder">
      </ph>
    1. Téléchargez et exécutez le fichier bootstrap_4.52.01.sh:
      curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
      sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord

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

    2. Configurer un utilisateur pour qu'il dispose d'un accès sudo complet à "apigee" l'utilisateur, comme décrit dans Créer un utilisateur avec un accès sudo complet à "apigee" utilisateur.
    3. Installez l'utilitaire apigee-setup :
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    4. Utilisez l'utilitaire apigee-setup pour installer Edge RPM 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 incluent: apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-management-server, edge-ui, 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 à le "apigee" l'utilisateur termine le processus de configuration: <ph type="x-smartling-placeholder">
      </ph>
    1. Utilisez l'utilitaire setup.sh pour terminer la configuration de Edge composants sur le nœud. La forme de la commande dépend des composants que vous installé sur le nœud. Pour obtenir la liste complète, consultez Installez les composants Edge sur un nœud.

      Par exemple, pour terminer l'installation de ZooKeeper et Cassandra, utilisez le code suivant : :

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

      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 d'installation

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

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

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

Gérer une défaillance de l'installation

en cas d'échec de l'installation d'un composant Edge, vous pouvez essayer de corriger le problème, puis exécutez à nouveau le programme d’installation. Le programme d'installation est conçu pour être exécuté de façon répétée en cas de défaillance, ou si vous souhaitez par la suite modifier ou mettre à jour un composant l'installation.

Après l'installation ou la mise à niveau, veillez à redémarrer le composant Edge UI sur chaque nœud sur lequel qu'il est en cours d'exécution.

Installation via Internet ou autre

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 Edge RPM et dépendances.

  • Nœuds sans connexion Internet externe

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

    Pour créer le dépôt Apigee interne, vous devez disposer d'un nœud avec un réseau Internet externe pour pouvoir télécharger les RPM et les dépendances Edge. Une fois que vous avez créé interne, vous pouvez le déplacer vers un autre nœud ou le rendre accessible à Edge pour l'installation.

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

L'une des raisons d'utiliser un référentiel 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.

<ph type="x-smartling-placeholder">

Résoudre les dépendances d'installation RPM

Les fichiers de distribution Apigee Edge sont installés sous la forme d'un ensemble de fichiers RPM, chacun d'eux pouvant avoir sa propre chaîne de dépendances d'installation. Nombre de ces dépendances sont définies par des échappent au contrôle d'Apigee et peuvent être modifiés à tout moment. Par conséquent, le 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 depuis un nœud sans Internet vous configurez généralement un dépôt interne contenant toutes les dépendances nécessaires. Le seul moyen pour garantir que toutes les dépendances sont incluses dans votre dépôt local est de tenter une installation, identifier les dépendances manquantes et les copier dans le dépôt local jusqu'à ce que l'installation réussit.

Commandes Yum courantes

Les outils d'installation Edge pour Linux utilisent Yum pour installer et mettre à jour les composants. Vous pourriez devez 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 noté comme suit:

/opt/apigee

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

Fichiers journaux

Dans le fichier journal de apigee-setup et du script setup.sh sont écrits /tmp/setup-root.log

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

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

Les tableaux suivants indiquent l'emplacement des fichiers journaux:

Composant Lieu

Serveur de gestion

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

Routeur

/opt/apigee/var/log/edge-router

Le routeur Edge est implémenté à l'aide de Nginx. Pour obtenir des journaux supplémentaires, consultez les pages suivantes:

/opt/apigee/var/log/edge-router/nginx
/opt/nginx/logs

Processeur de messages

/opt/apigee/var/log/edge-message-processor

Serveur Apigee Qpid

/opt/apigee/var/log/edge-qpid-server
Serveur Apigee Postgres /opt/apigee/var/log/edge-postgres-server
Interface utilisateur classique (pas la nouvelle interface utilisateur Edge, dont le nom de composant est edge-management-ui). /opt/apigee/var/log/edge-ui
ZooKeeper /opt/apigee/var/log/apigee-zookeeper
OpenLDAP /opt/apigee/var/log/apigee-openldap
Cassandra /opt/apigee/var/log/apigee-cassandra/system.log
QPIDD /opt/apigee/var/log/apigee-qpidd
Base de données PostgreSQL /opt/apigee/var/log/apigee-postgresql
apigee-monit /opt/apigee/var/log/apigee-monit

Données

Composant Lieu
Serveur de gestion /opt/apigee/data/edge-management-server
Routeur /opt/apigee/data/edge-router
Processeur de messages /opt/apigee/data/edge-message-processor
Agent Apigee Qpid /opt/apigee/data/edge-qpid-server
Agent Postgres Apigee /opt/apigee/data/edge-postgres-server
ZooKeeper /opt/apigee/data/apigee-zookeeper
OpenLDAP /opt/apigee/data/apigee-openldap
Cassandra /opt/apigee/data/apigee-cassandra/data
QPIDD /opt/apigee/data/apigee-qpid/data
Base de données PostgreSQL /opt/apigee/data/apigee-postgres/pgdata
apigee-monit /opt/apigee/data/apigee-monit

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

Le fichier de configuration de l'installation Edge prend en charge 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 respecte le CPU et la mémoire requise pour le composant installé. La valeur par défaut est "n" pour désactiver vérifier.