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

Edge pour Private Cloud version 4.17.01

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 devez installer et configurer 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:

  • 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.
  • Décidez si vous souhaitez activer l'authentification Cassandra.
  • Décidez si vous souhaitez configurer la réplication maître-nœud de secours pour Postgres.
  • 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 la section Configurer la réplication maître-autonome pour Postgres.
  • Sur chaque nœud de la topologie sélectionnée, installez l'utilitaire Edge apigee-setup :
    • Téléchargez le fichier bootstrap_4.17.01.sh d'Edge dans /tmp/bootstrap_4.17.01.sh.
    • Installez l'utilitaire apigee-service Edge et ses dépendances.
    • Installez l'utilitaire Edge apigee-setup et ses dépendances.

      Pour en savoir plus, consultez Installer l'utilitaire apigee-setup pour Edge.
  • 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.
  • 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.

Personnes autorisées à effectuer l'installation

Les fichiers de distribution d'Apigee Edge sont installés en tant qu'ensemble d'RPM et de dépendances. Pour installer, désinstaller et mettre à jour Edge, les commandes Edge doivent être exécutées par l'utilisateur racine ou par un utilisateur disposant 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 disposer 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). puis un accès root ou sudo complet si ce n'est pas nécessaire.)
  • Script update.sh pour mettre à jour les composants Edge

En outre, l'installateur d'Edge crée un utilisateur nommé "apigee" sur votre système. De nombreuses commandes Edge appellent sudo pour s'exécuter en tant qu'utilisateur "apigee".

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

  • Commandes d'utilitaire apigee-service, y compris :
    • Commandes apigee-service telles que start, stop, restart, configure.
    • Les commandes apigee-all telles que start, stop, restart, configure.

Pour configurer un utilisateur afin qu'il dispose d'un accès sudo complet à l'utilisateur "apigee", modifiez le fichier sudoers pour ajouter:

installUser        ALL=(apigee)      NOPASSWD: ALL

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

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 les fichiers de configuration.

Lorsque vous créez un fichier de configuration, vous pouvez définir son propriétaire sur "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. Définissez le propriétaire du fichier sur "apigee:apigee" ou, si vous avez remplacé l'utilisateur "apigee" par l'utilisateur qui exécute le service Edge, définissez le propriétaire du fichier sur l'utilisateur qui exécute le service Edge.

Emplacement des fichiers de configuration d'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 répertoire /usr/local/var ou /usr/local/share sur le nœud et attribuez-lui le propriétaire "apigee:apigee".

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

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

Gérer une défaillance de l'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. 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 avec une connexion Internet externe accèdent au dépôt Apigee pour installer les RPM et les dépendances Edge.
  • Nœuds sans connexion Internet externe

    Les nœuds sans connexion Internet externe peuvent accéder à une version miroir du dépôt Apigee que vous avez configuré 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 du réseau interne.

    Remarque: Apigee n'héberge pas toutes les dépendances tierces dans nos dépôts publics. Vous devez télécharger et installer ces dépendances à partir de dépôts accessibles au public.

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

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

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

Toutefois, l'utilisation d'un dépôt local présente un autre avantage, même pour les nœuds disposant d'une connexion Internet externe. Lorsque vous installez Edge à partir du dépôt public d'Apigee, vous installez toujours les derniers RPM Edge. Par conséquent, si vous souhaitez télécharger et stocker des RPM Edge pour une version spécifique d'Edge, vous devez créer un dépôt local pour cette version d'Edge. Vous pouvez ensuite utiliser ce dépôt local pour effectuer des installations pour n'importe quelle 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, vous réinstallez Edge à partir du dépôt local. En l'installant à partir du dépôt local, vous garantissez que vos environnements de développement et de production correspondent.

Un dépôt en miroir est très flexible. Par exemple, vous pouvez créer un dépôt en miroir à partir des derniers RPM Edge ou d'une version spécifique d'Edge. Une fois le dépôt créé, vous pouvez également le mettre à jour pour ajouter des RPM à partir de différentes versions d'Edge. Pour en savoir plus, consultez Installer l'utilitaire apigee-setup Edge.

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 pouvant avoir sa propre chaîne de dépendances d'installation. Un grand nombre de ces dépendances sont définies par des composants tiers qui échappent au contrôle d'Apigee et peuvent être modifiées à tout moment. Par conséquent, la documentation ne liste pas le numéro de version explicite de chaque dépendance.

Si vous effectuez une installation sur une machine avec 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. Le seul moyen de garantir que toutes les dépendances sont incluses dans votre dépôt local est de tenter une installation, d'identifier les dépendances manquantes et de les copier dans le dépôt local jusqu'à ce que l'installation aboutisse.

Commandes Yum courantes

Les outils d'installation Edge pour Linux utilisent 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
    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é comme suit:

<inst_root>/apigee

L'installation utilise la structure de système de fichiers suivante pour déployer Apigee Edge pour le cloud privé.

Fichiers journaux

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

Les fichiers journaux de chaque composant se trouvent 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

<inst_root>/apigee/var/log/edge-management-server

Routeur

&lt;inst_root&gt;/apigee/var/log/edge-router

Processeur de messages

&lt;inst_root&gt;/apigee/var/log/edge-message-processor

Serveur Qpid Apigee

<inst_root>/apigee/var/log/edge-qpid-server

Serveur Postgres Apigee

<inst_root>/apigee/var/log/edge-postgres-server

Interface utilisateur Edge

<inst_root>/apigee/var/log/edge-ui

ZooKeeper

<inst_root>/apigee/var/log/apigee-zookeeper

OpenLDAP

<inst_root>/apigee/var/log/apigee-openldap

Cassandra

<inst_root>/apigee/var/log/apigee-cassandra

Qpidd

<inst_root>/apigee/var/log/apigee-qpidd

Base de données PostgreSQL

<inst_root>/apigee/var/log/apigee-postgresql

Données

Composants

Emplacement

Serveur de gestion

&lt;data_root&gt;/apigee/data/edge-management-server

Routeur

<data_root>/apigee/data/edge-router

Processeur de messages

<data_root>/apigee/data/edge-message-processor

Agent Qpid Apigee

&lt;data_root&gt;/apigee/data/edge-qpid-server

Agent Apigee Postgres

<data_root>/apigee/data/edge-postgres-server

ZooKeeper

<data_root>/apigee/data/apigee-zookeeper

OpenLDAP

<data_root>/apigee/data/apigee-openldap

Cassandra

&lt;data_root&gt;/apigee/data/apigee-cassandra/data

Qpidd

<data_root>/apigee/data/apigee-qpid/data

Base de données PostgreSQL

&lt;data_root&gt;/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.

Configurer les composants Edge après l'installation

Pour configurer Edge après l'installation, vous devez utiliser 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. Les modifications apportées aux fichiers .properties nécessitent de redémarrer le composant Edge concerné.

Les fichiers .properties se trouvent dans 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 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.

Pour en savoir plus sur la configuration d'Edge, consultez Configurer Edge.

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 l'état de tous les composants Edge sur le nœud:

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

Utilisez l'utilitaire apigee-service pour contrôler et configurer des composants individuels. L'utilitaire apigee-service se présente sous 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é de:

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

La liste complète des actions pour un composant dépend du composant lui-même, mais tous les composants acceptent les actions suivantes:

  • démarrer, arrêter, redémarrer
  • état, version
  • sauvegarde, restauration
  • installer, désinstaller