Cette page a été traduite par l'API Cloud Translation.

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

Une installation Edge classique consiste en des 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:

Désactivez SELinux sur le nœud ou définissez-le en mode permissif. Pour en savoir plus, consultez la section Installer l'utilitaire de configuration Edge de Apigee.
Choisissez si vous souhaitez activer l'authentification Cassandra.
Décidez si vous souhaitez configurer la réplication en attente principale 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 page 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.52.01.sh dans /tmp/bootstrap_4.52.01.sh.
- Installez l'utilitaire et les dépendances Edge apigee-service.
- Installez l'utilitaire et les dépendances Edge apigee-setup.
  Pour plus d'informations, consultez la section Installer l'utilitaire de configuration Edge de Apigee.
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 la section 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 qui vous permettent de créer et de gérer des organisations Edge.
Pour en savoir plus, consultez Intégrer une organisation.
Redémarrez le composant d'interface utilisateur classique sur chaque nœud une fois l'installation terminée, comme indiqué dans l'exemple suivant :
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
(Recommandé) Une fois l'installation initiale terminée, Apigee vous recommande d'installer la nouvelle interface utilisateur Edge (dont le nom du composant est edge-management-ui), qui est une interface utilisateur améliorée pour les développeurs et les administrateurs d'Apigee Edge for Private Cloud.

Pour plus d'informations, voir Installer la nouvelle interface utilisateur Edge.

Une fois l'installation terminée, consultez cette liste d'actions post-installation courantes.

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. 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. 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 le rôle root.

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

apigee-service :
- Commandes apigee-service: install, uninstall, update.
- apigee-all: install, uninstall, update.
setup.sh pour installer les composants Edge (sauf si vous avez déjà utilisé "apigee-service install" pour installer les RPM requis. Ensuite, un accès root ou un accès sudo complet sera effectué si cela n'est pas nécessaire.)
update.sh pour mettre à jour les composants Edge

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

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

apigee-service, y compris :
- apigee-service telles que start, stop, restart, configure.
- apigee-all telles que start, stop, restart, configure.

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

REMARQUE:Vous ne pouvez effectuer cette étape qu'après avoir exécuté le fichier bootstrap_4.52.01.sh pour créer 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 à ajouter:

installUser        ALL=(apigee)      NOPASSWD: ALL

Où installUser est le nom d'utilisateur de la personne travaillant 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.

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

Créez le fichier dans un éditeur, comme n'importe quel utilisateur.
chown le propriétaire du fichier en "apigee:apigee" ou, si vous avez changé 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 le plus simple d'effectuer l'intégralité du processus d'installation Edge en tant qu'utilisateur racine ou par un utilisateur disposant d'un accès sudo complet, ce n'est pas toujours possible. À la place, vous pouvez séparer le processus en tâches effectuées par root et en tâches effectuées par un utilisateur disposant d'un accès sudo complet à l'utilisateur "apigee".

Tâches effectuées par l'utilisateur racine :
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'utilisateur "apigee".
2. Configurez un utilisateur pour qu'il dispose d'un accès sudo complet à l'utilisateur "apigee", comme décrit dans la section Créer un utilisateur avec 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 en périphérie 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-ui, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server.
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 avez installés sur le nœud. Pour obtenir la liste complète, consultez la section Installer des composants Edge sur un nœud.
  Par exemple, pour terminer l'installation de ZooKeeper et Cassandra, exécutez 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 d'installation

Vous devez transmettre à l'utilitaire apigee-setup un fichier de configuration contenant les informations sur l'installation Edge. La seule condition requise pour 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 exécutez l'chown dans "apigee:apigee".

Toutes les informations du fichier de configuration sont requises à 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 dans 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é plusieurs fois en cas de défaillance, 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 d'interface utilisateur Edge sur chaque nœud sur lequel il s'exécute.

Installation Internet ou non 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 et les dépendances en périphérie.
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 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 sur le 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 publiquement.

Pour créer le dépôt Apigee interne, vous avez besoin d'un nœud avec un accès Internet externe pour pouvoir 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 rendre ce nœud accessible aux nœuds périphériques pour l'installation.

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

L'utilisation d'un dépôt local, ou mis en miroir, permet notamment d'installer Edge sur les nœuds sans connexion Internet externe, comme décrit dans la section précédente.

Remarque:Toutefois, l'utilisation d'un dépôt local présente un autre avantage, même pour les nœuds avec une connexion Internet externe. 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 des RPM Edge pour une version spécifique d'Edge, vous devez créer un dépôt local pour cette version. Vous pouvez ensuite utiliser ce dépôt local pour effectuer des installations pour n'importe quelle version d'Edge.

Par exemple, vous devez d'abord utiliser 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 dépôt local. En 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 mis en miroir à partir des derniers RPM Edge ou d'une version spécifique d'Edge. Après avoir créé le dépôt, vous pouvez également le mettre à jour pour ajouter les RPM des différentes versions Edge. Pour plus d'informations, consultez la section Installer l'utilitaire de configuration Edge de Apigee.

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 ne sont pas sous le contrôle d'Apigee et peuvent être modifiées à 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 dotée 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. Le seul moyen de vous assurer 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 du répertoire /opt/apigee.

Dans ce guide et dans le guide d'utilisation 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 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 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 suivant:

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

Les tableaux suivants indiquent l'emplacement des fichiers journaux:

Composant	Emplacement
Serveur de gestion	`/opt/apigee/var/log/edge-management-server`
Routeur	`/opt/apigee/var/log/edge-router` Le routeur périphérique 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	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 Apigee Postgres	`/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 d'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 répond aux exigences en matière de processeur et de mémoire pour le composant installé. La valeur par défaut est "n" pour désactiver la vérification.