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

Edge pour Private Cloud version 4.17.05

Une installation Edge typique se compose de composants Edge distribués 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 :

• Désactivez SELinux sur le nœud ou définissez-le en mode permissif. Consultez la section Installer l'utilitaire de configuration Edge apigee pour plus encore.
• Décidez si vous souhaitez activer l'authentification Cassandra.
• Décidez si vous souhaitez configurer une réplication maître en secours pour Postgres.
• 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. Pour en savoir plus, consultez la section Topologies d'installation.
• Sur chaque nœud de la topologie sélectionnée, installez l'utilitaire Edge apigee-setup :
  • Téléchargez le fichier Edge bootstrap_4.17.05.sh pour /tmp/bootstrap_4.17.05.sh.
  • Installez l'utilitaire Edge apigee-service et les dépendances.
  • Installez l'utilitaire apigee-setup et les dépendances Edge.
    
    Voir Installer la configuration Edge d'Apigee utilitaire pour en savoir plus.
• Utilisez la configuration apigee-setup. pour installer un ou plusieurs composants Edge sur chaque nœud, en fonction de la configuration la topologie actuelle.
  Consultez Installer des composants Edge sur un nœud sur un nœud.
• Sur le nœud du serveur de gestion, utilisez l'utilitaire de configuration apigee 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.

Personnes autorisées à 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 complet à sudo, cela signifie que l'utilisateur dispose d'un accès sudo pour effectuer les mêmes opérations que root.

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, désinstalle, update.
  • Commandes apigee-all: install, désinstalle, update.
• setup.sh pour installer les composants Edge (à moins que vous n'ayez déjà utilisé "apigee-service install" à installer les RPM requis. Ensuite, un accès root 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 sur votre système, nommé "apigee". Nombreuses commandes Edge invoquez sudo pour l'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 d'utilitaire apigee-service, y compris :
  • 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 à « apigee » utilisez la commande "visudo" pour Modifiez le fichier sudoers pour l'ajouter:

installUser        ALL=(apigee)      NOPASSWD: ALL

où installUser correspond au nom d'utilisateur de la personne qui travaille Périphérie.

Définition des autorisations sur de configuration

Tous les fichiers ou ressources utilisés par les commandes Edge doivent être accessibles à l'utilisateur "apigee". 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 le propriétaire du fichier vers "apigee:apigee" ou, si vous avez modifié l'utilisateur exécutant du service "Apigee" utilisateur, chown le fichier à l'utilisateur qui exécute Edge Google Cloud.

Séparation Tâches d'installation en périphérie 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:
   1. Téléchargez et exécutez le fichier bootstrap_4.17.05.sh:
      &gt; curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
      &gt; sudo bash /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord
      
      Cette étape installe l'utilitaire apigee-service et crée le "apigee" utilisateur.
   2. Configurer un utilisateur pour qu'il dispose d'un accès sudo complet à "apigee" l'utilisateur comme décrit ci-dessus.
   3. Installez l'utilitaire apigee-setup :
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
   4. Utilisez l'utilitaire apigee-setup pour installer RPM périphériques sur le nœud:
      &gt; /opt/apigee/apigee-service/bin/apigee-service compName installation
      
      Les RPM Edge que vous installez sur le nœud dépendent de votre topologie. La liste des options disponibles comprend: apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, Edge-ui, serveur de gestion de périphérie, interface utilisateur périphérique, routeur de périphérie, 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 ayant un accès sudo complet à « apigee » l'utilisateur termine le processus de configuration:
   1. Utilisez le fichier setup.sh. pour terminer la configuration des composants Edge sur le nœud. La forme dépend des composants que vous avez installés 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 : Commande:
      &gt; /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:
      &gt; /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile

Emplacement de la configuration d'installation fichiers

Vous devez transmettre un fichier de configuration à l'utilitaire apigee-setup qui contient les des informations sur l'installation d'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 répertoire /usr/local/var ou Annuaire /usr/local/share sur le nœud et l'exporter vers "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 à le saisir. via la ligne de commande.

Consultez la section Installer des composants Edge sur un nœud pour en savoir plus. plus encore.

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. L'installateur est conçu pour être exécuté à plusieurs reprises en cas de défaillance, ou si vous souhaitez modifier ou mettre à jour un composant après l'installation.

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.

L'utilisation d'un dépôt Edge local pour maintenir 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.

Cependant, l'utilisation d'un dépôt local présente un autre avantage, même pour les nœuds disposant d'un de votre connexion Internet. Lorsque vous installez Edge à partir du dépôt public Apigee, vous installez toujours les derniers RPM Edge. Par conséquent, si vous souhaitez télécharger et stocker les RPM Edge d'Edge, vous devez créer un dépôt local pour cette version. Vous pouvez ensuite l'utiliser dépôt local pour effectuer des installations pour toute version d'Edge.

Par exemple, vous utilisez d'abord le dépôt local pour installer un environnement de développement Edge. Ensuite, lorsque vous êtes prêt à passer à un environnement de production, installez à nouveau Edge à partir du serveur repo. En l'installant à partir du dépôt local, vous garantissez que vos applications de développement les environnements correspondants.

Un dépôt en miroir est très flexible. Par exemple, vous pouvez créer un dépôt miroir à partir des derniers RPM Edge ou d'une version spécifique d'Edge. Après avoir créé le dépôt, vous pouvez aussi mettez-le à jour pour ajouter les RPM des différentes versions Edge. Consultez la section Installer l'utilitaire de configuration Edge apigee pour plus encore.

Résoudre les dépendances d'installation RPM

Les fichiers de distribution Apigee Edge sont installés en tant qu'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 é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 nomComposant
  Par 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é en tant que:

/opt/apigee

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

Fichiers journaux

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

Les fichiers journaux de chaque composant sont contenus dans le répertoire /opt/apigee/var/log. 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:

Composants	Emplacement
Serveur de gestion	/opt/apigee/var/log/edge-management-server
Routeur	/opt/apigee/var/log/edge-router Le routeur Edge est mis en œuvre à 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 Qpid Apigee	/opt/apigee/var/log/edge-qpid-server
Serveur Apigee Postgres	/opt/apigee/var/log/edge-postgres-server
Interface utilisateur périphérique	/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
Qpidd	/opt/apigee/var/log/apigee-qpidd
Base de données PostgreSQL	/opt/apigee/var/log/apigee-postgresql

Données

Composants	Emplacement
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

Tâches post-installation

Une fois l'installation terminée, vous pouvez effectuer d'autres actions sur les composants Edge.

Configuration de Edge composants après installation

Pour configurer Edge après l'installation, utilisez une combinaison de fichiers .properties et d'utilitaires Edge. Par exemple, pour configurer TLS/SSL dans l'interface utilisateur Edge, vous devez modifier les fichiers .properties pour définir les propriétés nécessaires. Pour modifier le fichier .properties, vous devez : redémarrez le composant Edge concerné.

Les fichiers .properties se trouvent dans le le répertoire /opt/apigee/customer/application. Chaque composant possède son propre fichier .properties dans ce répertoire. Par exemple, router.properties et management-server.properties.

Pour définir la propriété d'un composant, modifiez le fichier .properties correspondant, puis redémarrez le système le composant:

> /opt/apigee/apigee-service/bin/apigee-service component restart

Exemple :

> /opt/apigee/apigee-service/bin/apigee-service edge-router restart

Lorsque vous mettez à jour Edge, les fichiers .properties du répertoire /opt/apigee/customer/application sont lus. Cela signifie que la mise à jour conserve toutes les propriétés que vous avez définies sur le composant.

Voir Comment configurer Edge pour plus d'informations sur Configuration périphérique

Appeler des commandes sur les composants Edge

Edge installe des utilitaires de gestion sous /opt/apigee/apigee-service/bin que vous pouvez utiliser pour gérer une installation Edge. Par exemple, vous pouvez utiliser l'utilitaire apigee-all pour démarrer, arrêter, redémarrer, ou déterminer le statut de tous les composants Edge sur le nœud:

/opt/apigee/apigee-service/bin/apigee-all stop|start|restart|status|version

Utiliser l'utilitaire apigee-service pour contrôler et configurer des composants individuels. L'utilitaire apigee-service a la forme suivante:

/opt/apigee/apigee-service/bin/apigee-service component action

Par exemple, pour redémarrer le routeur Edge:

/opt/apigee/apigee-service/bin/apigee-service edge-router restart

Vous pouvez déterminer la liste des composants installés sur le nœud en examinant le répertoire /opt/apigee. Ce répertoire contient un sous-répertoire pour chaque composant Edge installé sur le nœud. Chaque sous-répertoire est précédé par:

• apigee : un tiers composant utilisé par Edge. Par exemple, apigee-cassandra.
• edge : un composant Edge d'Apigee. Par exemple, edge-management-server.
• edge-mint : un rapport . Exemple : edge-mint-management-server.
• baas : composant API BaaS. Exemple : baas-usergrid.

La liste complète des actions disponibles pour un composant dépend de celui-ci, mais sont compatibles avec les actions suivantes:

• démarrer, arrêter, redémarrer
• état, version
• sauvegarder, restaurer
• installer, désinstaller