Installer l'utilitaire de configuration Apigee Edge

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 sur le mode permissif avant de pouvoir installer l'utilitaire Edge apigee-setup ou tout composant Edge. Si nécessaire, après avoir installé Edge, vous pouvez réactiver SELinux.

  • 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 que vous utilisez dépend de votre version de Red Hat Enterprise Linux (RHEL), Rocky Linux ou Oracle Linux :

    • Pour RHEL 8.x, Rocky Linux 8.x ou Oracle Linux 8.x : 
      wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
sudo rpm -ivh epel-release-latest-8.noarch.rpm
    • Pour RHEL 9.x, Rocky Linux 9.x ou Oracle Linux 9.x : 
      wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
sudo rpm -ivh epel-release-latest-9.noarch.rpm

    Prérequis pour RHEL 8/Rocky 8/Oracle 8

    Si vous installez Edge sur un serveur exécutant Red Hat Enterprise Linux (RHEL) 8, Rocky 8 ou Oracle 8, procédez comme suit avant d'effectuer l'installation :

    1. Activez les packages supplémentaires pour Enterprise Linux (EPEL) : 
      sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
    2. Désactivez Postgres et Nginx : 
      sudo dnf module disable postgresql
sudo dnf module disable nginx

    Prérequis pour RHEL 9/Rocky 9/Oracle 9

    Si vous installez Edge sur un serveur exécutant Red Hat Enterprise Linux (RHEL) 9, Rocky 9 ou Oracle 9, procédez comme suit avant d'effectuer l'installation :

    1. Activez les packages supplémentaires pour Enterprise Linux (EPEL) : 
      sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
    2. Désactivez Postgres et Nginx : 
      sudo dnf module disable postgresql
sudo dnf module disable nginx

    Pour connaître les modifications préalables à l'installation de PostgreSQL et LDAP, consultez respectivement Prérequis pour la base de données PostgreSQL et Modifications préalables à l'installation de SymasLDAP 2.6.10.

    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 :

    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 username:password pour le site FTP Apigee, vous pouvez utiliser ces identifiants.
    2. Connectez-vous à votre nœud en tant qu'utilisateur racine pour installer les RPM Edge.
    3. Désactivez SELinux.
    4. Activez le dépôt EPEL.
    5. Si vous effectuez l'installation sur RHEL 9/Rocky 9/Oracle 9, suivez les étapes de la section Prérequis pour RHEL 9/Rocky 9/Oracle 9.
    6. Téléchargez le fichier Edge bootstrap_4.54.00.sh dans /tmp/bootstrap_4.54.00.sh : 
      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
    7. Installez l'utilitaire et les dépendances apigee-service d'Edge : 
      sudo bash /tmp/bootstrap_4.54.00.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.

      Apigee Edge pour Private Cloud 4.54.00 nécessite une double compatibilité Java, avec Java 17 et Java 21 installés sur le nœud. Vous devez installer Java 17 et Java 21 avant d'exécuter le script d'amorçage. Le programme d'installation vérifie uniquement que les deux versions du JDK sont installées. Il n'installe pas Java automatiquement.

      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*'
    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 Installer des composants Edge sur un nœud.

    Dépannage

    Lorsque vous tentez d'effectuer l'installation sur un nœud disposant d'une connexion Internet externe, vous pouvez rencontrer une ou plusieurs des erreurs suivantes :

    Cannot open: https://username@software.apigee.com/apigee-repo-4.53.00.rpm

bootstrap.sh: Error: Repo configuration failed

error: package package_name is not installed

    Le tableau suivant liste quelques solutions possibles pour ces erreurs :

    Type d'erreur Solution possible
    Le mot de passe contient des caractères non valides N'utilisez pas de caractères spéciaux dans votre mot de passe Apigee.
    Problèmes de connectivité

    Testez votre connectivité réseau en exécutant la commande ncat suivante :

    nc -v software.apigee.com 443

    Un message semblable au suivant s'affiche :

    Connection to software.apigee.com 443 port [tcp/https] succeeded!

    Si nc n'est pas installé, vous pouvez exécuter la commande telnet suivante :

    telnet software.apigee.com 443

    Si les commandes aboutissent, vous pouvez utiliser CTRL+C pour interrompre la connexion ouverte.

    Si l'une des commandes échoue, cela signifie que votre connectivité réseau est limitée ou inexistante. Contactez votre administrateur réseau.
    Identifiants incorrects

    Assurez-vous que votre nom d'utilisateur et votre mot de passe sont corrects.

    Par exemple, vérifiez si vous obtenez une erreur lorsque vous essayez d'utiliser la commande suivante avec votre nom d'utilisateur et votre mot de passe Apigee :

    curl -i -u username:password https://software.apigee.com/apigee-repo.rpm
    Problèmes de proxy Votre configuration locale utilise un proxy HTTP de sortie et vous n'avez pas étendu la même configuration au gestionnaire de paquets yum. Vérifiez vos variables d'environnement : 
    echo $http_proxy
echo $https_proxy

    Pour un proxy HTTP de sortie, vous devez utiliser l'une des options suivantes :

    • Ajoutez une configuration de proxy HTTP dans /etc/yum.conf.
    • Ajouter une configuration de proxy HTTP global dans /etc/environment

    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 à Internet leur est interdit d'une autre manière, vous devez créer plusieurs dépôts, ou miroirs, contenant les fichiers dont vous aurez besoin lors de l'installation. Ces miroirs doivent ensuite être accessibles à tous les nœuds. Une fois créés, les nœuds peuvent accéder à ces miroirs locaux pour installer Edge.

    Le processus d'installation d'Apigee Edge pour les nœuds sans connexion Internet nécessite l'accès aux dépôts locaux suivants :

    Créer un dépôt Apigee local

    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.

    Après avoir créé un dépôt Apigee 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 Apigee local et comment le mettre à jour.

    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 et d'un mot de passe pour le site FTP Apigee, vous pouvez utiliser ces identifiants.
    2. Connectez-vous à votre nœud en tant qu'utilisateur racine pour installer les RPM Edge.
    3. Désactivez SELinux comme décrit ci-dessus.
    4. Téléchargez le fichier Edge bootstrap_4.54.00.sh dans /tmp/bootstrap_4.54.00.sh : 
      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
    5. Installez l'utilitaire apigee-service d'Edge et ses dépendances : 
      sudo bash /tmp/bootstrap_4.54.00.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.

    6. Installez l'utilitaire apigee-mirror sur le nœud : 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
    7. 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 pour ne télécharger que les derniers RPM.

    8. (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.54.00.sh à partir du dépôt local pour installer l'utilitaire apigee-service : 
        sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.54.00.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.

    Installer à partir du fichier .tar

    Pour installer à partir du fichier .tar :

    1. Sur le nœud contenant 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.54.00.tar.gz : 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. 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.
    3. Sur le nouveau nœud, désactivez SELinux comme décrit ci-dessus.
    4. Sur le nouveau nœud, assurez-vous de pouvoir accéder au dépôt de l'utilitaire Yum local et au dépôt EPEL.
    5. Vérifiez que tous les dépôts Internet externes sont désactivés (ce qui devrait être le cas, car vous effectuez l'installation sur une machine sans accès à Internet) : 
      sudo yum repolist

      Tous les dépôts externes doivent être désactivés, mais le dépôt Apigee local et vos dépôts internes doivent être activés.

    6. Utilisez apigee-service pour installer l'utilitaire apigee-setup : 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    7. 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 à partir du dépôt à l'aide du serveur Web Nginx

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

    1. Installez le serveur Web Nginx sur le nœud du 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. 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
    3. 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
    4. Sur le nouveau nœud, assurez-vous que le dépôt EPEL est activé localement.
    5. Sur le nouveau nœud, vérifiez votre version de libdb4 comme décrit ci-dessus.
    6. Sur le nœud distant, installez l'utilitaire apigee-service Edge et les dépendances : 
      sudo bash /tmp/bootstrap_4.54.00.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.

    7. Sur le nœud distant, utilisez apigee-service pour installer l'utilitaire apigee-setup : 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    8. 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.54.00.sh, puis effectuer une nouvelle synchronisation.

    Pour mettre à jour le dépôt :

    1. Téléchargez le fichier bootstrap_4.54.00.sh d'Edge dans /tmp/bootstrap_4.54.00.sh : 
      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
    2. Exécutez le fichier Edge bootstrap_4.54.00.sh : 
      sudo bash/tmp/bootstrap_4.54.00.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.

    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 cloner 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