Installer l'utilitaire de configuration Apigee Edge

Pour installer Edge sur un nœud, vous devez d'abord installer l'utilitaire de configuration Edge Apigee. Si vous êtes dans un dans lequel vos nœuds n'ont pas de connexion Internet externe, vous devez aussi 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 le modifier . Toutefois, si vous le souhaitez, vous pouvez créer un lien symbolique vers lequel mapper /opt/apigee. un autre emplacement. Pour en savoir plus, consultez la section Conditions d'installation.

Conditions préalables: Désactiver SELinux

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

  • Pour définir SELinux temporairement sur le mode permissif, exécutez la commande suivante : : <ph type="x-smartling-placeholder">
      </ph>
    • 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
    • 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 définitivement ou le définir en mode permissif: <ph type="x-smartling-placeholder">
      </ph>
    1. Ouvrez /etc/sysconfig/selinux dans un éditeur.
    2. Définir 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 de Edge en répétant cette procédure pour définissez 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 que vous utilisez dépend de votre version de RedHat/CentOS:

  • Pour Red Hat Enterprise Linux (RHEL) 8.0, consultez la section Conditions préalables pour RHEL 8

  • Pour Red Hat/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 Red Hat/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
  • Pour AWS-2: 
    sudo amazon-linux-extras install epel -y
sudo yum-config-manager --enable epel

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

Sur RedHat 7.4 et CentOS 7.4, vérifiez la version des RPM libdb4 avant de procéder à l'installation. Périphérie nécessite la version 4.8, et certaines versions de RedHat 7.4 et CentOS 7.4 sont livrées avec un version ultérieure. Si vous avez une version ultérieure, désinstallez-la et le programme d’installation Edge puis installez la version 4.8.

Vous pouvez vérifier votre version à l'aide de la commande suivante:

rpm -qa | grep libdb4

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

Conditions préalables pour RHEL 8

Si vous installez Edge sur un serveur exécutant Red Hat Enterprise Linux (RHEL) 8, Suivez la procédure ci-dessous avant de procéder à l'installation:

  1. Activer 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
  3. Installez Python 2: 
    sudo dnf install -y python2

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

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

  1. Procurez-vous 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 l'utiliser identifiants de connexion.
  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.
  5. Activez le dépôt EPEL.
  6. Vérifier votre version sur libdb4.
  7. Si vous effectuez l'installation sur RHEL 8, suivez les étapes décrites dans la section Conditions préalables pour RHEL 8
  8. Si vous effectuez l'installation sur Oracle 7.x, exécutez la commande suivante: 
    sudo yum-config-manager --enable ol7_optional_latest
  9. Si vous effectuez l'installation sur AWS, exécutez la commande suivante : Commandes yum-configure-manager: 
    yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  10. Téléchargez le fichier Edge bootstrap_4.52.01.sh sur /tmp/bootstrap_4.52.01.sh: 
    curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
  11. Installez l'utilitaire Edge apigee-service et les dépendances: 
    sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord

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

    Par défaut, le programme d'installation vérifie que Java 1.8 est bien installé. Si ce n'est pas le cas, l'installe pour vous. Utilisez l'option JAVA_FIX pour spécifier comment gérer 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 suivante:

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

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

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

Dépannage

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

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

bootstrap.sh: Error: Repo configuration failed

error: package package_name is not installed

Le tableau suivant répertorie quelques solutions possibles pour ces erreurs:

Type d'erreur Solution possible
Le mot de passe contient des caractères incorrects 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 à celui-ci doit s'afficher:

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

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

telnet software.apigee.com 443

Si les commandes réussissent, vous pouvez utiliser CTRL+C pour annuler la connexion ouverte.

Si l'une des commandes échoue, cela signifie que votre connectivité réseau est limitée ou inexistante. Vérifier auprès de votre administrateur réseau.
Identifiants incorrects

Vérifiez 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 configuration au gestionnaire de packages yum. Vérifiez vos variables d'environnement: 
echo $http_proxy
echo $https_proxy

Pour un proxy HTTP de sortie, utilisez l'une des options suivantes:

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

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

Si vos nœuds périphériques se trouvent derrière un pare-feu ou s'ils ne sont pas autorisés d'une autre manière à accéder Internet, vous devez créer plusieurs dépôts, ou miroirs, contenant les fichiers que vous pendant l'installation. Ces miroirs doivent alors être accessibles à tous les nœuds. Une fois créés, les nœuds peut ensuite 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 à les 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 réseau Internet externe pour pouvoir télécharger les RPM et les dépendances Edge. Une fois que vous avez créé vous pouvez le déplacer vers un autre nœud ou le rendre accessible aux nœuds périphériques pour l'installation.

Après avoir créé un dépôt Apigee local, vous devrez peut-être le mettre à jour ultérieurement avec la dernière Fichiers de version Edge. Les sections suivantes décrivent comment créer un dépôt Apigee local et comment la mettre à jour.

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

  1. Procurez-vous 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:mot de passe pour le site FTP Apigee, vous pouvez utiliser ces identifiants de connexion.
  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.52.01.sh sur /tmp/bootstrap_4.52.01.sh: 
    curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
  5. Installez l'utilitaire Edge apigee-service et les dépendances: 
    sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord

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

  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 /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 le fichier les derniers RPM.

  8. (Facultatif) Si vous souhaitez installer Edge à partir du dépôt local sur le même qui héberge le dépôt local, vous devez d'abord exécuter les commandes suivantes: <ph type="x-smartling-placeholder">
      </ph>
    1. Exécutez bootstrap_4.52.01.sh à partir du dépôt local pour installer le Utilitaire apigee-service: 
      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.52.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. Voir Installez les composants Edge sur un nœud pour en savoir plus.

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 alors deux possibilités :

  • Créez un fichier .tar du dépôt, copiez le fichier .tar sur un nœud, puis installez Edge à partir de le 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 met à votre disposition le serveur Web Nginx, mais vous pouvez aussi utiliser votre propre serveur serveur Web.

Installer à partir du fichier .tar

Pour effectuer l'installation depuis le 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 Un seul fichier .tar nommé /opt/apigee/data/apigee-mirror/apigee-4.52.01.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. Vous pouvez, par exemple, le copier /tmp sur le 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 que vous pouvez accéder au dépôt d'utilitaire Yum local et à l'EPEL de ce dépôt.
  5. Vérifiez que tous les dépôts Internet externes sont désactivés. que vous installez 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 doit être activé.

  6. Sur le nouveau nœud, installez yum-utils et yum-plugin-priorities à partir de dans votre dépôt local. 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities

    Votre équipe chargée des opérations ou un autre groupe de votre organisation doit configurer un dépôt local pouvoir installer les outils Yum.

  7. Sur le nouveau nœud, vérifiez votre version de libdb4 comme décrit ci-dessus.
  8. Si vous effectuez l'installation sur Oracle 7.x,exécutez la commande suivante: 
    sudo yum-config-manager --enable ol7_optional_latest
  9. Si vous effectuez l'installation sur AWS, exécutez la commande suivante : Commande yum-configure-manager: 
    sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  10. Sur le nouveau nœud, décompressez le fichier dans le répertoire /tmp: 
    tar -xzf apigee-4.52.01.tar.gz

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

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

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

  12. Utilisez apigee-service pour installer l'utilitaire apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  13. Utilisez apigee-setup pour installer et configurer les composants Edge sur le nœud. Voir Installez les composants Edge sur un nœud pour en savoir plus.

Installer à partir du dépôt à l'aide du serveur Web Nginx

Pour effectuer l'installation depuis le 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. À modifiez ces valeurs: <ph type="x-smartling-placeholder">
      </ph>
    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 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 requiert la définition du nom d'utilisateur (nom d'utilisateur: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, 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. Sur le nouveau nœud, assurez-vous que le dépôt EPEL local est activé.
  7. Sur le nouveau nœud, vérifiez votre version de libdb4 comme décrit ci-dessus.
  8. Sur le nœud distant, téléchargez le fichier Edge bootstrap_4.52.01.sh pour /tmp/bootstrap_4.52.01.sh: 
    curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh

    Où 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 où remoteRepo est l'adresse IP ou le nom DNS du nœud de dépôt.

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

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

  10. Sur le nœud distant, utilisez apigee-service pour installer apigee-setup utilitaire: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  11. Utilisez apigee-setup pour installer et configurer les composants Edge sur le nœud distant. Pour en savoir plus, consultez la section 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 fichier bootstrap_4.52.01.sh le plus récent, puis effectuez une nouvelle synchronisation.

Pour mettre à jour le dépôt:

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

    Où uName:pWord correspond au nom d'utilisateur et au 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 afficher 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.52.01

Si vous devez gérer des installations pour Edge 4.16.0x ou 4.17.0x dans un dépôt 4.52.01, vous pouvez de conserver un dépôt contenant toutes les versions. Depuis ce dépôt, vous pouvez installer Périphérie.

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

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

    Vous devriez voir un résultat au format ci-dessous, où xyz correspond au numéro de build:

    apigee-mirror-4.52.01-0.0.xyz
  2. Utiliser le apigee-mirror pour télécharger Edge 4.16.0x/4.17.0x dans votre dépôt. Notez que vous ajoutez le préfixe la version souhaitée: 
    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 les numéros de version.

  3. Examinez le répertoire /opt/apigee/data/apigee-mirror/repos pour voir le fichier. structure: 
    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
bootstrap_4.18.01.sh
bootstrap_4.18.05.sh
bootstrap_4.19.01.sh
thirdparty

    Notez la façon dont vous disposez d’un fichier d’amorçage pour toutes les versions d’Edge. 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 package seulement une partie du dépôt.

Pour installer Edge à partir du dépôt local ou du fichier .tar, assurez-vous simplement d’exécuter le bon bootstrap à 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é depuis le 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é. depuis le 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 de "Serveur Web Nginx" ci-dessus.