Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Installer l'utilitaire de configuration Apigee Edge

Edge for Private Cloud v4.18.01

Pour installer Edge sur un nœud, vous devez d'abord installer l'utilitaire apigee-setup d'Edge. Si vous vous trouvez dans un environnement où vos nœuds ne disposent pas d'une connexion Internet externe, vous devez également installer une copie locale du dépôt Apigee.

Répertoire d'installation par défaut : /opt/apigee

Edge installe tous les fichiers dans le répertoire /opt/apigee. Vous ne pouvez pas modifier ce répertoire. Toutefois, si vous le souhaitez, vous pouvez créer un lien symbolique pour mapper /opt/apigee vers un autre emplacement. Pour en savoir plus, consultez Conditions d'installation.

Prérequis : désactiver SELinux

Vous devez désactiver SELinux ou le définir en mode permissif avant de pouvoir installer l'utilitaire apigee-setup d'Edge ou tout composant Edge. Si nécessaire, après avoir installé Edge, vous pouvez réactiver SELinux.

Pour définir temporairement SELinux en mode permissif, exécutez la commande suivante :
1. Sur un système d'exploitation Linux 6.x :
  sudo echo 0 > /selinux/enforce
  
  Pour réactiver SELinux après l'installation d'Edge :
  sudo echo 1 > /selinux/enforce
2. Sur un système d'exploitation Linux 7.x :
  sudo setenforce 0
  
  Pour réactiver SELinux après l'installation d'Edge :
  sudo setenforce 1
Pour désactiver définitivement SELinux ou le définir en mode permissif :
1. Ouvrez /etc/sysconfig/selinux dans un éditeur.
2. Définissez SELINUX=disabled ou SELINUX=permissive.
3. Enregistrez vos modifications.
4. Redémarrez le nœud.
5. Si nécessaire, réactivez SELinux après l'installation d'Edge en répétant cette procédure pour définir SELINUX=enabled.

Prérequis : Activer le dépôt EPEL

Vous devez activer les packages supplémentaires pour Enterprise Linux (ou EPEL) pour installer ou mettre à jour Edge, ou pour créer un dépôt local. La commande à utiliser dépend de votre version de RedHat/CentOS :

Pour RedHat/CentOS/Oracle 7.x :
> wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; sudo rpm -ivh epel-release-latest-7.noarch.rpm
Pour RedHat/CentOS/Oracle 6.x :
> wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; sudo rpm -ivh epel-release-latest-6.noarch.rpm

Prérequis : Vérifier la version de la bibliothèque libdb4 sur RedHat 7.4 et CentOS 7.4

Sur RedHat 7.4 et CentOS 7.4, vérifiez la version des RPM libdb4 avant l'installation. Edge nécessite la version 4.8, et certaines versions de RedHat 7.4 et CentOS 7.4 sont fournies avec une version ultérieure. Si vous disposez d'une version ultérieure, désinstallez-la. Le programme d'installation d'Edge installera ensuite la version 4.8.

Vous pouvez utiliser la commande suivante pour vérifier votre version :

> rpm -qa | grep libdb4

Si vous constatez que la version du RPM libdb4 est ultérieure à la version 4.8, désinstallez-la.

Installer l'utilitaire apigee-setup d'Edge sur un nœud disposant d'une connexion Internet externe

Pour installer Edge sur un nœud disposant d'une connexion Internet externe :

Obtenez auprès d'Apigee le nom d'utilisateur et le mot de passe que vous utilisez pour accéder au dépôt Apigee. Si vous disposez déjà d'un nom d'utilisateur et d'un mot de passe pour le site FTP Apigee, vous pouvez utiliser ces identifiants.
Connectez-vous à votre nœud en tant qu'utilisateur racine pour installer les RPM Edge.
Remarque : Bien que l'installation des RPM nécessite un accès racine, vous pouvez configurer Edge sans accès racine.
Installez yum-utils et yum-plugin-priorities :
> sudo yum install yum-utils
> sudo yum install yum-plugin-priorities
Désactivez SELinux comme décrit ci-dessus.
Activez le dépôt EPEL comme décrit ci-dessus.
Vérifiez votre version de libdb4 comme décrit ci-dessus.
Si vous effectuez l'installation sur Oracle 7.x,exécutez la commande suivante :
> sudo yum-config-manager --enable ol7_optional_latest
Si vous effectuez l'installation sur AWS, exécutez les commandes yum-configure-manager suivantes :
> yum update rh-amazon-rhui-client.noarch
> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
Téléchargez le fichier Edge bootstrap_4.18.01.sh dans /tmp/bootstrap_4.18.01.sh :
> curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
Installez l'utilitaire et les dépendances du service apigee-service Edge :
> sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

où uName:pWord sont le nom d'utilisateur et le mot de passe que vous avez reçus d'Apigee. Si vous omettez pWord, vous serez invité à le saisir.

Par défaut, le programme d'installation vérifie que Java 1.8 est installé. Si ce n'est pas le cas, il l'installe pour vous. Utilisez l'option JAVA_FIX pour spécifier comment gérer l'installation de Java. JAVA_FIX accepte les valeurs suivantes :

I = Installer OpenJDK 1.8 (par défaut)
C = Continuer sans installer Java
Q = Quitter. Pour cette option, vous devez installer Java vous-même.

L'installation de l'utilitaire apigee-service crée le fichier /etc/yum.repos.d/apigee.repo qui définit le dépôt Apigee. Pour afficher le fichier de définition, utilisez la commande :
> cat /etc/yum.repos.d/apigee.repo

Pour afficher le contenu du dépôt, utilisez la commande :
> sudo yum -v repolist 'apigee*'
Utilisez apigee-service pour installer l'utilitaire apigee-setup :
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
Utilisez apigee-setup pour installer et configurer les composants Edge sur le nœud. Pour en savoir plus, consultez Installer des composants Edge sur un nœud.

Installer l'utilitaire apigee-setup d'Edge sur un nœud sans connexion Internet externe

Si vos nœuds Edge se trouvent derrière un pare-feu ou si l'accès au dépôt Apigee via Internet est interdit, vous devez créer un dépôt local ou un miroir du dépôt Apigee. Ce miroir doit ensuite être accessible à tous les nœuds. Une fois créés, les nœuds peuvent accéder à ce miroir local pour installer Edge.

Pour créer le dépôt Apigee interne, vous devez disposer 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 le rendre accessible aux nœuds Edge pour l'installation.

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

Après avoir créé un dépôt Edge local, vous devrez peut-être le mettre à jour ultérieurement avec les derniers fichiers de version Edge. Les sections suivantes expliquent comment créer un dépôt local et comment le mettre à jour.

Créer un dépôt Apigee local

Pour créer un dépôt Apigee local :

Obtenez auprès d'Apigee le nom d'utilisateur et le mot de passe que vous utilisez pour accéder au dépôt Apigee. Si vous disposez déjà d'un nom d'utilisateur et d'un mot de passe pour le site FTP Apigee, vous pouvez utiliser ces identifiants.
Connectez-vous à votre nœud en tant qu'utilisateur racine pour installer les RPM Edge.
Remarque : Bien que l'installation RPM nécessite un accès racine, vous pouvez configurer Edge sans accès racine.
Désactivez SELinux comme décrit ci-dessus.
Téléchargez le fichier Edge bootstrap_4.18.01.sh dans /tmp/bootstrap_4.18.01.sh :
> curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
Installez l'utilitaire et les dépendances du service apigee-service Edge :
> sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

où uName:pWord sont le nom d'utilisateur et le mot de passe que vous avez reçus d'Apigee. Si vous omettez pWord, vous serez invité à le saisir.
Installez l'utilitaire apigee-mirror sur le nœud :
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install

Remarque : Si vous mettez à jour un dépôt existant vers la version 4.18.01, il vous suffit de mettre à jour apigee-mirror :
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
Utilisez l'utilitaire apigee-mirror pour synchroniser le dépôt Apigee avec le répertoire /opt/apigee/data/apigee-mirror/repos/.

Pour réduire la taille du dépôt, incluez l'option --only-new-rpms pour ne télécharger que les derniers RPM. Vous avez besoin d'environ 1,6 Go d'espace disque pour le téléchargement :
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

Si vous souhaitez télécharger l'intégralité du dépôt, y compris les anciens RPM, omettez --only-new-rpms. Vous avez besoin d'environ 6 Go d'espace disque pour le téléchargement complet :
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

Vous disposez maintenant d'une copie locale du dépôt Apigee. La section suivante explique comment installer l'utilitaire Edge apigee-setup à partir du dépôt local.
(Facultatif) Si vous souhaitez installer Edge à partir du dépôt local sur le même nœud que celui qui héberge le dépôt local, vous devez d'abord exécuter les commandes suivantes :
1. Exécutez bootstrap_4.18.01.sh à partir du dépôt local pour installer l'utilitaire apigee-service :
  > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
2. Utilisez apigee-service pour installer l'utilitaire apigee-setup :
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
3. Utilisez apigee-setup pour installer et configurer les composants Edge sur le nœud. Pour en savoir plus, consultez Installer des composants Edge sur un nœud.

Installer apigee-setup sur un nœud distant à partir du dépôt local

Deux options s'offrent à vous pour installer Edge à partir du dépôt local. Vous avez deux possibilités :

Créez un fichier .tar du dépôt, copiez-le sur un nœud, puis installez Edge à partir du fichier .tar.
Installez un serveur Web sur le nœud avec le dépôt local afin que les autres nœuds puissent y accéder. Apigee fournit le serveur Web Nginx, mais vous pouvez utiliser votre propre serveur Web.

Installez à partir du fichier .tar :

Sur le nœud avec le dépôt local, utilisez la commande suivante pour empaqueter le dépôt local dans un seul fichier .tar nommé /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz :
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
Copiez le fichier .tar sur le nœud sur lequel vous souhaitez installer Edge. Par exemple, copiez-le dans le répertoire /tmp du nouveau nœud.
Sur le nouveau nœud, désactivez SELinux comme décrit ci-dessus.
Sur le nouveau nœud, activez le dépôt EPEL comme décrit ci-dessus.
Sur le nouveau nœud, assurez-vous d'avoir désactivé tous les dépôts Internet externes. Lorsque vous exécutez la commande suivante, tous les dépôts externes doivent s'afficher comme désactivés, mais le dépôt Apigee local et tous vos dépôts internes doivent être activés :
> sudo yum repolist
Sur le nouveau nœud, installez yum-utils et yum-plugin-priorities :
> sudo yum install yum-utils
> sudo yum install yum-plugin-priorities
Sur le nouveau nœud, vérifiez votre version de libdb4 comme décrit ci-dessus.
Si vous effectuez l'installation sur Oracle 7.x,exécutez la commande suivante :
> sudo yum-config-manager --enable ol7_optional_latest
Si vous effectuez l'installation sur AWS, exécutez la commande yum-configure-manager suivante :
> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
Sur le nouveau nœud, décompressez le fichier dans le répertoire /tmp :
> tar -xzf apigee-4.18.01.tar.gz

Cette commande crée un répertoire nommé repos dans le répertoire contenant le fichier .tar. Par exemple, /tmp/repos.
Installez l'utilitaire apigee-service d'Edge et les dépendances à partir de /tmp/repos :
> sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

Notez que vous incluez le chemin d'accès au répertoire des dépôts dans cette commande.
Utilisez apigee-service pour installer l'utilitaire apigee-setup :
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
Utilisez apigee-setup pour installer et configurer les composants Edge sur le nœud. Pour en savoir plus, consultez Installer des composants Edge sur un nœud.

Installez l'agent à partir du dépôt à l'aide du serveur Web Nginx :

Installez le serveur Web Nginx sur le nœud du dépôt :
> opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
Par défaut, Nginx est configuré pour utiliser localhost comme nom de serveur et le port 3939. Pour modifier ces valeurs :
1. Ouvrez /opt/apigee/customer/application/mirror.properties dans un éditeur. Créez le fichier s'il n'existe pas.
2. Définissez les valeurs suivantes si nécessaire :
  conf_apigee_mirror_listen_port=3939
  conf_apigee_mirror_server_name=localhost
3. Redémarrez Nginx :
  ?> /opt/nginx/scripts/apigee-nginx restart
Par défaut, le dépôt nécessite un nom d'utilisateur et un mot de passe : admin:admin. Pour modifier ces identifiants, définissez les variables d'environnement suivantes :
MIRROR_USERNAME=uName
MIRROR_PASSWORD=pWord
Sur le nouveau nœud, installez yum-utils et yum-plugin-priorities :
> sudo yum install yum-utils
> sudo yum install yum-plugin-priorities
Sur le nouveau nœud, désactivez SELinux comme décrit ci-dessus.
Sur le nouveau nœud, activez le dépôt EPEL comme décrit ci-dessus.
Sur le nouveau nœud, vérifiez votre version de libdb4 comme décrit ci-dessus.
Sur le nœud distant, téléchargez le fichier Edge bootstrap_4.18.01.sh vers /tmp/bootstrap_4.18.01.sh :
> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh

où uName:pWord sont le nom d'utilisateur et le mot de passe que vous avez définis ci-dessus pour le dépôt, et remoteRepo est l'adresse IP ou le nom DNS du nœud du dépôt.
Sur le nœud distant, installez l'utilitaire apigee-service d'Edge et ses dépendances :
> sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

où uName:pWord sont le nom d'utilisateur et le mot de passe du dépôt.
Sur le nœud distant, utilisez apigee-service pour installer l'utilitaire apigee-setup :
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
Utilisez apigee-setup pour installer et configurer les composants Edge sur le nœud distant. Pour en savoir plus, consultez Installer des composants Edge sur un nœud.

Mettre à jour un dépôt Apigee local

Pour mettre à jour le dépôt, vous devez télécharger le dernier fichier bootstrap_4.18.01.sh, puis effectuer une nouvelle synchronisation :

Téléchargez le fichier bootstrap_4.18.01.sh d'Edge dans /tmp/bootstrap_4.18.01.sh :
> curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
Exécutez le fichier Edge bootstrap_4.18.01.sh :
> sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

où uName:pWord sont le nom d'utilisateur et le mot de passe que vous avez reçus d'Apigee. Si vous omettez pWord, vous serez invité à le saisir.
Mettez à jour apigee-mirror :
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
Effectuez la synchronisation :
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
Si vous souhaitez l'intégralité du dépôt :
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

Nettoyer un dépôt Apigee local

Le nettoyage du dépôt local supprime /opt/apigee/data/apigee-mirror et /var/tmp/yum-apigee-*.

Pour nettoyer le dépôt local, utilisez :

> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean

Ajouter ou mettre à jour Edge 4.16.0x/4.17.0x dans un dépôt 4.18.01

Si vous devez gérer des installations pour Edge 4.16.0x ou 4.17.0x dans un dépôt 4.18.01, vous pouvez gérer un dépôt contenant toutes les versions. À partir de ce dépôt, vous pouvez ensuite installer n'importe quelle version d'Edge.

Pour ajouter 4.16.0x/4.17.0x à un dépôt 4.18.01 :

Assurez-vous d'avoir installé la version 4.18.01 de l'utilitaire apigee-mirror :
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version

Vous devriez obtenir un résultat au format ci-dessous, où xyz est le numéro de version :
apigee-mirror-4.18.01-0.0.xyz
Utilisez l'utilitaire apigee-mirror pour télécharger Edge 4.16.0x/4.17.0x dans votre dépôt. Notez que vous devez ajouter la version souhaitée en préfixe de la commande :
> apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

Utilisez cette même commande pour mettre à jour ultérieurement les dépôts 4.16.0x/4.17.0x en spécifiant les numéros de version requis.
Examinez le répertoire /opt/apigee/data/apigee-mirror/repos pour voir la structure du fichier :
> ls /opt/apigee/data/apigee-mirror/repos

Les fichiers et répertoires suivants doivent s'afficher :
apigee apigee-repo-1.0-6.x86_64.rpm bootstrap_4.16.01.sh bootstrap_4.16.05.shbootstrap_4.17.01.sh bootstrap_4.17.05.sh bootstrap_4.17.09.sh bootstrap_4.18.01.sh thirdparty

Notez que vous disposez d'un fichier d'amorçage pour toutes les versions d'Edge. Le répertoire apigee contient également des répertoires distincts pour chaque version d'Edge.
Pour empaqueter le dépôt dans un fichier .tar, exécutez la commande suivante :
> apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

Cette commande empaquette tous les dépôts 4.17.0x et 4.16.0x dans le même fichier .tar. Vous ne pouvez pas empaqueter une partie seulement du dépôt.

Pour installer Edge à partir du dépôt local ou du fichier .tar, veillez à exécuter le fichier d'amorçage approprié à l'aide de l'une des commandes suivantes. Cet exemple installe Edge 4.17.01 :

Si vous effectuez l'installation à partir d'un fichier .tar, exécutez le fichier d'amorçage approprié à partir du dépôt :
> sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

Pour terminer l'installation, suivez les étapes restantes de la section "Installer à partir du fichier .tar" ci-dessus.
Si vous effectuez l'installation à l'aide du serveur Web Nginx, téléchargez, puis exécutez le fichier d'amorçage approprié à partir du dépôt :
> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
> sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

Pour terminer l'installation, suivez les étapes restantes de la section "Installer à partir du dépôt à l'aide du serveur Web Nginx" ci-dessus.