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

Installer l'utilitaire de configuration Apigee Edge

Edge pour Private Cloud version 4.17.01

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 pour mapper /opt/apigee sur 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">
1. Sur un système d'exploitation Linux 6.x:
  echo 0 > /selinux/enforce
  
  Pour réactiver SELinux après avoir installé Edge:
  echo 1 > /selinux/enforce
2. Sur un système d'exploitation Linux 7.x:
  setenforce 0
  
  Pour réactiver SELinux après avoir installé Edge:
  setenforce 1
Pour désactiver SELinux définitivement ou le définir en mode permissif: <ph type="x-smartling-placeholder">
1. Ouvrez /etc/sysconfig/selinux dans une é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 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. La commande à utiliser dépend sur votre version de RedHat/CentOS:

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

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

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

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.
Connectez-vous à votre nœud en tant qu'utilisateur racine pour installer les RPM Edge
Remarque: Bien que l'installation de RPM nécessite un accès root, vous pouvez effectuer sans accès racine.
Désactivez SELinux comme décrit ci-dessus.
Activez le dépôt EPEL comme décrit ci-dessus.
Téléchargez le fichier Edge bootstrap_4.17.01.sh dans /tmp/bootstrap_4.17.01.sh:
> curl https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
Installez l'utilitaire Edge apigee-service et les dépendances:
> sudo bash /tmp/bootstrap_4.17.01.sh apigeeuser=uName apigeepassword=pWord

où uName:pWord correspond au nom d'utilisateur et au 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:
> chat /etc/yum.repos.d/apigee.repo

Pour afficher le contenu du dépôt, utilisez la commande suivante:
> sudo yum -v repolist "apigee*"
(CentOS-6.x et RedHat-6.x uniquement) Sur tous les nœuds Qpid, exécutez la commande suivante pour vous assurer de télécharger la bonne version de Qpid:
> yum installer apigee-qpidd --disablerepo=epel
Utilisez apigee-service pour installer l'utilitaire apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup installer
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.

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 dans le dépôt Apigee sur Internet, vous devez alors créer un dépôt local du dépôt Apigee. Ce miroir doit alors être accessible à tous les nœuds. Une fois créés, les nœuds peut ensuite 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 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.

Remarque: Apigee n'héberge pas toutes les dépendances tierces dans ses des dépôts. Vous devez télécharger et installer ces dépendances des dépôts.

Après avoir créé un dépôt Edge local, vous devrez peut-être le mettre à jour ultérieurement avec la dernière 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:

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.
Connectez-vous à votre nœud RedHat ou CentOS en tant qu'utilisateur racine pour installer les RPM Edge.
Remarque: Bien que l'installation de RPM nécessite un accès root, vous pouvez effectuer sans accès racine.
Vérifiez que vous disposez de la dernière version de yum-utils:
> mettre à jour sudo yum yum-utils
Désactivez SELinux comme décrit ci-dessus.
Activez le dépôt EPEL comme décrit ci-dessus.
Téléchargez le fichier Edge bootstrap_4.17.01.sh dans /tmp/bootstrap_4.17.01.sh:
> curl https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
(CentOS-6.x et RedHat-6.x uniquement) Exécutez la commande suivante pour vous assurer que vous téléchargez la bonne version de Qpid:
> yum installer apigee-qpidd --disablerepo=epel
Installez l'utilitaire Edge apigee-service et les dépendances:
> sudo bash /tmp/bootstrap_4.17.01.sh apigeeuser=uName apigeepassword=pWord

où uName:pWord correspond au nom d'utilisateur et au mot de passe que vous avez reçus Apigee. Si vous omettez pWord, vous serez invité à le faire.
Installez 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.17.01, il vous suffit de mettre à jour apigee-mirror:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror mise à jour
Utiliser le miroir 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 afin de ne télécharger que les dernières et les 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 Go d'espace disque pour le téléchargement complet:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror synchronisation

Vous disposez maintenant d'une copie locale du dépôt Apigee. La section suivante explique comment installer l'utilitaire Edge apigee-setup depuis au dépôt local.
(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">
1. Exécutez bootstrap_4.17.01.sh à partir du pour installer l'utilitaire apigee-service:
  > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
2. Utilisez apigee-service pour installez apigee-setup utilitaire:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup installer
3. 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.

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.

Effectuez l'installation à partir du fichier .tar:

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.17.01.tar.gz:

> /opt/apigee/apigee-service/bin/apigee-service package apigee-mirror
Copiez le fichier .tar sur le nœud sur lequel vous souhaitez installer Edge. Vous pouvez, par exemple, le copier /tmp sur le nouveau d'un nœud.
Sur le nouveau nœud, désactivez SELinux comme décrit ci-dessus.
Sur le nouveau nœud, décompressez le fichier dans le répertoire /tmp:
> tar -xzf apigee-4.17.01.tar.gz

Cette commande crée un répertoire, dans le répertoire contenant le fichier .tar. Exemple : /tmp/repos.
Installez l'utilitaire Edge apigee-service et les dépendances à partir de /tmp/repos:
> sudo bash /tmp/repos/bootstrap_4.17.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".
Utilisez apigee-service pour installez apigee-setup utilitaire:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup installer
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.

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

Installez le serveur Web Nginx sur le nœud de 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. À modifier ces valeurs <ph type="x-smartling-placeholder">
1. Ouvrez /opt/apigee/customer/application/mirror.properties dans un éditeur. S'il n'existe pas, créez le fichier.
2. Si nécessaire, définissez les valeurs suivantes:
  conf_apigee_mirror_listen_port=3939
  conf_apigee_mirror_server_name=localhost
3. Redémarrez Nginx:
  > /opt/nginx/scripts/apigee-nginx redémarrage
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
Sur le nouveau nœud, désactivez SELinux comme décrit ci-dessus.
Sur le nœud distant, téléchargez le fichier Edge bootstrap_4.17.01.sh sur /tmp/bootstrap_4.17.01.sh:
> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh

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

où uName:pWord correspond au nom d'utilisateur du dépôt et mot de passe.
Sur le nœud distant, utilisez apigee-service pour installer l'utilitaire apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup installer
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.17.01.sh le plus récent, puis effectuer une nouvelle synchroniser:

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

où uName:pWord correspond au nom d'utilisateur et au mot de passe que vous provenant d'Apigee. Si vous omettez pWord, vous serez invité à saisissez-le.
Mettez à jour apigee-mirror:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror mise à jour
Effectuez la synchronisation:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror synchronisation --only-new-rpms
Si vous souhaitez télécharger l'intégralité du dépôt:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror synchronisation

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.01/4.16.05/4.16.09 dans un dépôt 4.17.01

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

Pour ajouter 4.16.0x à un dépôt 4.17.01:

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

Vous devriez obtenir un résultat au format ci-dessous, où xyz correspond à la compilation numéro:
apigee-mirror-4.17.01-0.0.xyz
Utiliser le miroir apigee-mirror pour télécharger Edge 4.16.01/4.16.05/4.16.09 dans votre dépôt. Notez la façon dont vous préfixez avec apigeereleasever=4.16.01 ou apigeereleasever=4.16.05:
> apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service synchronisation apigee-mirror --only-new-rpms

Utilisez cette même commande pour mettre à jour ultérieurement les dépôts 4.16.05/4.16.09 en spécifiant les les numéros de version.
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 tierce

Notez la façon dont vous disposez d’un fichier d’amorçage pour toutes les versions d’Edge. Le répertoire apigee contient également des pour chaque version d'Edge.
Pour empaqueter le dépôt dans un fichier .tar, utilisez la commande suivante:
> apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service Package apigee-mirror

Cette commande regroupe les dépôts 4.17.01 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:

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.16.0X.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.16.0X.sh -o /tmp/bootstrap_4.16.0X.sh
> sudo bash /tmp/bootstrap_4.16.0X.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.