Edge pour Private Cloud version 4.16.05
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.
Création d'un lien symbolique à partir de /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.
Avant de créer le lien symbolique, vous devez d'abord créer un utilisateur et un groupe nommé "apigee". C'est le même groupe et le même utilisateur créé par le programme d’installation Edge.
Pour créer le lien symbolique, procédez comme suit avant de télécharger le fichier bootstrap_4.16.05.sh. Vous devez effectuer toutes ces étapes en mode root:
- Créer l'environnement "apigee" utilisateur et groupe:
> groupadd -r apigee
> useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Utilisateur de la plate-forme Apigee" Apigee - Créez un lien symbolique de /opt/apigee vers l'installation souhaitée.
racine:
> ln -ts /srv/myInstallDir /opt/apigee
où /srv/myInstallDir est l'emplacement souhaité du périphérique . - Modifier la propriété de la racine d’installation et du lien symbolique sur « apigee » utilisateur:
> chown -h apigee:apigee /srv/myInstallDir /opt/apigee
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:
echo 0 > /selinux/enforce
Pour réactiver SELinux après avoir installé Edge:
echo 1 > /selinux/enforce - Sur un système d'exploitation Linux 7.x:
setenforce 0
Pour réactiver SELinux après avoir installé Edge:
setenforce 1
- Sur un système d'exploitation Linux 6.x:
- Pour désactiver SELinux définitivement ou le définir en mode permissif:
<ph type="x-smartling-placeholder">
- </ph>
- Ouvrez /etc/sysconfig/selinux dans une éditeur.
- Définissez SELINUX=disabled ou SELINUX=permissive
- Enregistrez vos modifications.
- Redémarrez le nœud.
- Si nécessaire, réactivez SELinux après l'installation de Edge en répétant cette procédure pour définissez SELINUX=enabled.
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.
- Téléchargez le fichier Edge bootstrap_4.16.05.sh dans /tmp/bootstrap_4.16.05.sh:
> curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh - Installez l'utilitaire Edge apigee-service et les dépendances:
> sudo bash /tmp/bootstrap_4.16.05.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*" - 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.
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.
- Téléchargez le fichier Edge bootstrap_4.16.05.sh dans /tmp/bootstrap_4.16.05.sh:
> curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh - Installez l'utilitaire Edge apigee-service et les dépendances:
> sudo bash /tmp/bootstrap_4.16.05.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 installer - 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">
- </ph>
- Exécutez bootstrap_4.16.05.sh à partir du
pour installer l'utilitaire apigee-service:
> sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos - 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.
- Exécutez bootstrap_4.16.05.sh à partir du
pour installer l'utilitaire apigee-service:
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
Fichier .tar unique nommé /opt/apigee/data/apigee-mirror/apigee-4.16.05.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.16.05.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.16.05.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">
- </ph>
- Ouvrez /opt/apigee/customer/application/mirror.properties dans un éditeur. S'il n'existe pas, créez le fichier.
- Si nécessaire, définissez les valeurs suivantes:
conf_apigee_mirror_listen_port=3939
conf_apigee_mirror_server_name=localhost - 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.16.05.sh sur /tmp/bootstrap_4.16.05.sh:
> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.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.16.05.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. - 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.16.05.sh le plus récent, puis effectuer une nouvelle synchroniser:
- Téléchargez le fichier Edge bootstrap_4.16.05.sh dans /tmp/bootstrap_4.16.05.sh:
> curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh - 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 dans un dépôt 4.16.05
Si vous devez gérer des installations à la fois pour Edge 4.16.05 et 4.16.01, vous pouvez gérer une qui contient les deux versions. Depuis ce dépôt, vous pouvez installer Edge 4.16.05 et 4.16.01.
Pour ajouter 4.16.01 à un dépôt 4.15.05:
- Assurez-vous d'avoir installé la version 4.16.05 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.16.05-0.0.xyz - Utiliser le miroir apigee-mirror
pour télécharger Edge 4.16.01 dans votre dépôt. Notez que vous ajoutez le préfixe
apigeereleasever=4.16.01:
> apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service synchronisation apigee-mirror --only-new-rpms
Utilisez la même commande pour mettre à jour ultérieurement le dépôt 4.16.01. - 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 tierce
Notez que vous disposez d'un fichier d'amorçage pour les deux 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.16.05 et 4.16.01 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.