Installer l'utilitaire de configuration Apigee Edge

Edge pour Private Cloud version 4.17.09

Pour installer Edge sur un nœud, vous devez d'abord installer l'utilitaire de configuration d'Edge apigee-setup. Si vous vous trouvez dans un environnement où les 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 du 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 à un autre emplacement. Pour en savoir plus, consultez la section Configuration requise pour l'installation.

Conditions préalables: Désactiver SELinux

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

  • Pour définir temporairement SELinux sur le 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 avoir installé 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 avoir installé Edge:

      > sudo setenforce 1
  • Pour désactiver SELinux de façon permanente ou le définir en mode permissif :
    1. Ouvrez /etc/sysconfig/selinux dans un éditeur.
    2. Définir SELINUX=disabled ou SELINUX=permissive
    3. Enregistrez les 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.

Conditions préalables: 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

Conditions préalables: Vérifiez la version de la bibliothèque libdb4 sur RedHat 7.4 et CentOS 7.4

Sous RedHat 7.4 et CentOS 7.4, vérifiez la version des RPM libdb4 avant de procéder à 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.

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

> rpm -qa | grep libdb

Si vous constatez que la version du RPM libdb4 est ultérieure à la version 4.8, utilisez la commande suivante pour remplacer les RPM:

> rpm -Uvh --oldpackage libdb4-cxx-4.8.30-13.el7.x86_64.rpm libdb4-4.8.30-13.el7.x86_64.rpm

Si vous devez télécharger ces RPM, vous pouvez les obtenir à l'adresse suivante:

Installer l'utilitaire de configuration Edge Apigee sur un nœud avec une connexion Internet externe

Pour installer Edge sur un nœud avec une connexion Internet externe:

  1. 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:password pour le site FTP d'Apigee, vous pouvez utiliser ces identifiants.
  2. Connectez-vous à votre nœud en tant qu'utilisateur racine pour installer les RPM Edge.
  3. Installez yum-utils et yum-plugin-priorities :
    > sudo yum install yum-utils
    > sudo yum install yum-plugin-priorities
  4. Désactivez SELinux comme décrit ci-dessus.
  5. Activez le dépôt EPEL comme décrit ci-dessus.
  6. 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
  7. Téléchargez le fichier Edge bootstrap_4.17.09.sh dans /tmp/bootstrap_4.17.09.sh :
    > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
  8. Installez l'utilitaire et les dépendances Edge de Apigee :
    > sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord

    uName:pWord sont le nom d'utilisateur et le mot de passe que vous avez reçus de la part d'Apigee. Si vous omettez pWord, vous êtes invité à le faire.

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

    • I = Installer OpenJDK 1.8 (par défaut)
    • C = Continuer sans installer Java
    • Q = Quitter. Pour utiliser 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 suivante:

    > cat /etc/yum.repos.d/apigee.repo

    Pour afficher le contenu du dépôt, utilisez la commande suivante:

    > sudo yum -v repolist 'apigee*'
  9. Utilisez apigee-service pour installer l'utilitaire apigee-setup :
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  10. Utilisez apigee-setup pour installer et configurer les composants Edge sur le nœud. Pour en savoir plus, consultez la page Installer des composants Edge sur un nœud.

Installer l'utilitaire de configuration Edge Apigee sur un nœud sans connexion Internet externe

Si vos nœuds périphériques sont protégés par un pare-feu ou qu'ils ne sont pas autorisés à accéder au dépôt Apigee sur Internet, 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éé, les nœuds peuvent accéder à ce miroir local pour installer Edge.

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.

Après avoir créé un dépôt Edge local, vous devrez peut-être par la suite le mettre à jour avec les derniers fichiers de la version Edge. Les sections suivantes décrivent 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:

  1. 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:password pour le site FTP d'Apigee, vous pouvez utiliser ces identifiants.
  2. Connectez-vous à votre nœud en tant qu'utilisateur racine pour installer les RPM Edge.
  3. Installez yum-utils et yum-plugin-priorities :
    > sudo yum install yum-utils
    > sudo yum install yum-plugin-priorities
  4. Désactivez SELinux comme décrit ci-dessus.
  5. Activez le dépôt EPEL comme décrit ci-dessus.
  6. 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
  7. Téléchargez le fichier Edge bootstrap_4.17.09.sh dans /tmp/bootstrap_4.17.09.sh :
    > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
  8. Installez l'utilitaire et les dépendances Edge apigee-service :
    > sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord

    uName:pWord sont le nom d'utilisateur et le mot de passe que vous avez reçus de la part d'Apigee. Si vous omettez pWord, vous êtes invité à le faire.

  9. Installez l'utilitaire apigee-mirror sur le nœud :
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
  10. 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 --only-new-rpms afin de ne télécharger que les derniers RPM. Vous avez besoin d'environ 1,6 Go d'espace disque pour effectuer 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 effectuer 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.

  11. (Facultatif) Si vous souhaitez installer Edge à partir du dépôt local sur le même nœud qui héberge le dépôt local, vous devez d'abord exécuter les commandes suivantes :
    1. Exécutez bootstrap_4.17.09.sh à partir du dépôt local pour installer l'utilitaire apigee-service :
      > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.17.09.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 la page Installer des composants Edge sur un nœud.

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

Vous disposez de deux options pour installer Edge à partir du dépôt local. Vous avez alors 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 contenant le dépôt local afin que les autres nœuds puissent y accéder. Apigee met à votre disposition le serveur Web Nginx. Vous pouvez aussi utiliser votre propre serveur Web.

Effectuez l'installation à partir du fichier .tar:

  1. Sur le nœud contenant le dépôt local, exécutez la commande suivante pour empaqueter le dépôt local dans un seul fichier .tar nommé /opt/apigee/data/apigee-mirror/apigee-4.17.09.tar.gz :
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
  2. Copiez le fichier .tar sur le nœud où vous souhaitez installer Edge. Par exemple, copiez-le dans le répertoire /tmp du nouveau nœud.
  3. Installez yum-utils et yum-plugin-priorities :
    > sudo yum install yum-utils
    > sudo yum install yum-plugin-priorities
  4. Sur le nouveau nœud, désactivez SELinux comme décrit ci-dessus.
  5. Activez le dépôt EPEL comme décrit ci-dessus.
  6. Sur le nouveau nœud, décompressez le fichier dans le répertoire /tmp:
    > tar -xzf apigee-4.17.09.tar.gz

    Cette commande crée un répertoire, nommé "dépôt", dans le répertoire contenant le fichier .tar. /tmp/repos. par exemple.

  7. Installez l'utilitaire et les dépendances Edge apigee-service à partir de /tmp/repos :
    > sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Notez que vous avez inclus dans cette commande le chemin d'accès au répertoire des dépôts.

  8. Utilisez apigee-service pour installer l'utilitaire apigee-setup :
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  9. Utilisez apigee-setup pour installer et configurer les composants Edge sur le nœud. Pour en savoir plus, consultez la page Installer des composants Edge sur un nœud.

Effectuez l'installation à partir du dépôt à l'aide du serveur Web Nginx:

  1. Installez le serveur Web Nginx sur le nœud de dépôt :
    > opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
  2. 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. S'il n'existe pas, créez le fichier.
    2. Définissez les valeurs suivantes selon vos besoins :
      conf_apigee_mirror_listen_port=3939
      conf_apigee_mirror_server_name=localhost
    3. Redémarrez Nginx:
      > /opt/nginx/scripts/apigee-nginx restart
  3. Par défaut, le dépôt requiert un nom d'utilisateur:mot de passe de admin:admin. Pour modifier ces identifiants, définissez les variables d'environnement suivantes :
    MIRROR_USERNAME=uName
    MIRROR_PASSWORD=pWord
  4. Installez yum-utils et yum-plugin-priorities :
    > sudo yum install yum-utils > sudo yum install yum-plugin-priorities
  5. Sur le nouveau nœud, désactivez SELinux comme décrit ci-dessus.
  6. Activez le dépôt EPEL comme décrit ci-dessus.
  7. Sur le nœud distant, téléchargez le fichier Edge bootstrap_4.17.09.sh dans /tmp/bootstrap_4.17.09.sh :
    > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh

    uName:pWord correspond au nom d'utilisateur et au mot de passe que vous avez définis ci-dessus pour le dépôt, et remoteRepo à l'adresse IP ou au nom DNS du nœud de dépôt.

  8. Sur le nœud distant, installez l'utilitaire et les dépendances Edge apigee-service :
    > sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName
      apigeepassword=pWord apigeeprotocol=http://

    uName:pWord correspond au nom d'utilisateur et au mot de passe du dépôt.

  9. Sur le nœud distant, utilisez apigee-service pour installer l'utilitaire apigee-setup :
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  10. Utilisez apigee-setup pour installer et configurer les composants Edge sur le nœud distant. Pour en savoir plus, consultez la page 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.17.09.sh, puis effectuer une nouvelle synchronisation:

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

    uName:pWord sont le nom d'utilisateur et le mot de passe que vous avez reçus de la part d'Apigee. Si vous omettez pWord, vous êtes invité à le faire.

  3. Mettez à jour apigee-mirror :
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
  4. Effectuez la synchronisation :
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
  5. Si vous souhaitez télécharger 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, exécutez la commande suivante:

> /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.17.09

Si vous devez gérer des installations pour Edge 4.16.0x ou 4.17.01/4.17.05 dans un dépôt 4.17.09, 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.17.09:

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

    Le résultat devrait s'afficher sous le format ci-dessous, où xyz correspond au numéro de build:

    apigee-mirror-4.17.09-0.0.xyz
  2. Utilisez l'utilitaire apigee-mirror pour télécharger Edge 4.16.0x/4.17.01/4.17/05 dans votre dépôt. Notez que vous ajoutez à la commande le préfixe de version souhaité :
    > 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.05 en spécifiant les numéros de version requis.

  3. Examinez le répertoire /opt/apigee/data/apigee-mirror/repos pour voir la structure des fichiers :
    > 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.sh
    bootstrap_4.17.01.sh
    bootstrap_4.17.05.sh 
    bootstrap_4.17.09.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.

  4. Pour empaqueter le dépôt dans un fichier .tar, utilisez la commande suivante :
    > apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

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

Pour installer Edge à partir du dépôt local ou du fichier .tar, assurez-vous d'exécuter le bon fichier d'amorçage à 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.