Installer des composants Edge sur un nœud

Après avoir installé l'utilitaire Edge apigee-setup sur un nœud, utilisez l'utilitaire apigee-setup pour installer un ou plusieurs composants Edge sur le nœud.

L'utilitaire apigee-setup utilise une commande au format suivant :

/opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

Où component correspond au composant Edge à installer et configFile au fichier de configuration silencieux contenant les informations d'installation. Le fichier de configuration doit être accessible ou lisible par l'utilisateur "apigee". Par exemple, vous pouvez créer un répertoire pour les fichiers, les placer dans le répertoire /usr/local ou /usr/local/share, ou n'importe où ailleurs sur le nœud accessible par l'utilisateur "apigee".

Par exemple, pour installer le serveur Edge Management :

/opt/apigee/apigee-setup/bin/setup.sh -p ms -f /usr/local/myConfig

Pour savoir comment installer l'apigee-setup Edge, consultez Installer l'utilitaire apigee-setup Edge.

Remarques concernant l'installation

Lorsque vous écrivez votre fichier de configuration, tenez compte des options suivantes.

Configurer la réplication maître-standby Postgres

Par défaut, Edge installe tous les nœuds Postgres en mode maître. Toutefois, dans les systèmes de production comportant plusieurs nœuds Postgres, vous devez les configurer pour qu'ils utilisent la réplication maître-veille. Ainsi, si le nœud maître échoue, le nœud de secours peut continuer à traiter le trafic.

Vous pouvez activer et configurer la réplication maître-veille au moment de l'installation à l'aide des propriétés du fichier de configuration silencieux. Vous pouvez également activer la réplication maître-veille après l'installation. Pour en savoir plus, consultez Configurer la réplication maître/veille pour Postgres.

Considérations concernant symasldap 2.6.7 pour RHEL 9.X/Rocky 9.X/Oracle 9.X

L'installation sur site nécessite SymasLDAP 2.6.7, qui est inclus dans le dépôt apigee-thirdparty-opdk. Pour faciliter l'installation, veuillez supprimer la bibliothèque symasldap-compat.

Pour les installations à 13 hôtes et celles à 12 hôtes avec deux centres de données, la réplication SymasLDAP est requise, car plusieurs nœuds hébergent SymasLDAP.

Activer l'authentification Cassandra

Par défaut, Cassandra s'installe sans authentification activée. Cela signifie que tout le monde peut accéder à Cassandra. Vous pouvez activer l'authentification après avoir installé Edge ou pendant le processus d'installation.

Pour en savoir plus, consultez Activer l'authentification Cassandra.

Utiliser un port protégé lors de la création d'un hôte virtuel

Si vous souhaitez créer un hôte virtuel qui lie le routeur à un port protégé, tel qu'un numéro de port inférieur à 1000, vous devez configurer le routeur pour qu'il s'exécute en tant qu'utilisateur ayant accès à ces ports. Par défaut, le routeur s'exécute en tant qu'utilisateur "apigee", qui n'a pas accès aux ports privilégiés.

Pour savoir comment configurer un hôte virtuel et un routeur afin d'accéder aux ports inférieurs à 1000, consultez Configurer un hôte virtuel.

Nouvelles exigences introduites par apigee-qpidd-4.52.01-X.X.X

À partir de la version 4.52.01, de nouvelles exigences ont été introduites lors de l'installation. Il nécessite l'inclusion des propriétés QPID_MGMT_USERNAME et QPID_MGMT_PASSWORD lors de l'installation. Assurez-vous que ces propriétés sont ajoutées avec les valeurs appropriées dans le fichier de configuration pour faciliter l'installation.

Installer la nouvelle interface utilisateur Edge

Une fois l'installation initiale terminée, Apigee vous recommande d'installer la nouvelle interface utilisateur Edge, qui est une interface utilisateur améliorée pour les développeurs et les administrateurs d'Apigee Edge pour le cloud privé. (L'UI classique est installée par défaut.)

Notez que l'UI Edge exige que vous désactiviez l'authentification de base et que vous utilisiez un IDP tel que SAML ou LDAP.

Pour en savoir plus, consultez Installer la nouvelle interface utilisateur Edge.

Spécifier les composants à installer

Le tableau suivant liste les options que vous transmettez à l'option -p de l'utilitaire apigee-service pour spécifier les composants à installer sur le nœud :

Composant Description

c

Installez uniquement Cassandra.
zk installer uniquement ZooKeeper.

ds

Installez ZooKeeper et Cassandra.

ld

Installez uniquement SymasLDAP.

mt

Installez Edge Management Server, qui installe également SymasLDAP.

Si vous définissez USE_LDAP_REMOTE_HOST=y dans le fichier de configuration, l'installation de SymasLDAP est ignorée et le serveur de gestion utilise SymasLDAP installé sur un autre nœud.

ms

Installez le serveur de gestion Edge, qui installe également l'UI Edge et SymasLDAP.

Si vous définissez USE_LDAP_REMOTE_HOST=y dans le fichier de configuration, l'installation de SymasLDAP est ignorée et le serveur de gestion utilise SymasLDAP installé sur un autre nœud.

r

Installez uniquement Edge Router.

mp

Installez uniquement le processeur de messages Edge.

rmp

Installez Edge Router et Message Processor.

ui

Installez l'interface utilisateur Edge.

qs

Installez uniquement le serveur Qpid.

ps

Installez uniquement le serveur Postgres.
pdb Installez uniquement la base de données Postgres. Cette option n'est utilisée que lors de l'installation du portail de services pour les développeurs Apigee (ou simplement le portail). Consultez Installer le portail.

sax

Installez les composants d'analyse, à savoir Qpid et Postgres.

Utilisez cette option uniquement pour le développement et les tests, et non pour la production.
sso Installez le module Apigee SSO.

mo

Installez la monétisation.

sa

Installez Edge en mode autonome, c'est-à-dire Cassandra, ZooKeeper, le serveur de gestion, SymasLDAP, l'UI Edge, le routeur et le processeur de messages. Cette option omet les composants d'analyse Edge : Qpid et Postgres.

Utilisez cette option uniquement pour le développement et les tests, et non pour la production.

aio

Installez tous les composants sur un seul nœud.

Utilisez cette option uniquement pour le développement et les tests, et non pour la production.
dp

Installez le portail.

Créer un fichier de configuration

Le fichier de configuration contient toutes les informations nécessaires à l'installation d'Edge. Vous pouvez souvent utiliser le même fichier de configuration pour installer tous les composants d'une installation Edge.

Toutefois, vous devrez utiliser des fichiers de configuration différents ou modifier votre fichier de configuration si :

  • Vous installez plusieurs serveurs SymasLDAP et devez configurer la réplication dans le cadre d'une installation à 13 nœuds. Chaque fichier nécessite des valeurs différentes pour LDAP_SID et LDAP_PEER.
  • Vous créez plusieurs centres de données dans le cadre d'une installation à 12 nœuds. Chaque centre de données nécessite des paramètres différents pour des propriétés telles que ZK_CLIENT_HOSTS et CASS_HOSTS.

Chaque topologie d'installation décrite ci-dessous présente un exemple de fichier de configuration pour cette topologie. Pour obtenir une documentation de référence complète sur le fichier de configuration, consultez Documentation de référence sur le fichier de configuration Edge.

Tester la configuration système requise sans exécuter d'installation

Edge pour le cloud privé est compatible avec la propriété ENABLE_SYSTEM_CHECK=y pour vérifier les exigences en matière de processeur et de mémoire sur une machine lors d'une installation. Toutefois, dans les versions précédentes d'Edge, cette vérification nécessitait d'effectuer l'installation.

Vous pouvez désormais utiliser l'indicateur "-t" pour effectuer cette vérification sans avoir à effectuer d'installation. Par exemple, pour vérifier la configuration système requise pour une installation "aio" sans effectuer l'installation, utilisez la commande suivante :

/opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile -t

Cette commande affiche à l'écran les éventuelles erreurs liées à la configuration système requise.

Consultez Conditions requises pour l'installation pour obtenir la liste des exigences système pour tous les composants Edge.

Fichiers journaux d'installation

Par défaut, l'utilitaire setup.sh écrit les informations de journal concernant l'installation dans :

/opt/apigee/var/log/apigee-setup/setup.log

Si l'utilisateur exécutant l'utilitaire setup.sh n'a pas accès à ce répertoire, il écrit le journal dans le répertoire /tmp sous le nom de fichier setup_username.log.

Si l'utilisateur n'a pas accès à /tmp, l'utilitaire setup.sh échoue.

Installer les composants Edge

Cette section explique comment installer les composants Edge pour les différentes topologies. L'ordre d'installation des composants dépend de la topologie souhaitée.

Tous les exemples d'installation ci-dessous supposent que vous installez :

  • L'authentification Cassandra est désactivée (par défaut). Pour en savoir plus, consultez Activer l'authentification Cassandra.
  • Avec la réplication maître/veille Postgres désactivée (par défaut). Pour en savoir plus, consultez Configurer la réplication maître-veille pour Postgres.
  • Processeur de messages et routeur sur le même nœud. Si vous installez les processeurs de messages et les routeurs sur des nœuds différents, installez d'abord tous les processeurs de messages, puis tous les routeurs.

Prérequis

Avant de pouvoir installer les composants Edge, vous devez :

  • Consultez les exigences d'installation pour connaître les conditions préalables et la liste des fichiers à obtenir avant de procéder à l'installation. Veillez à consulter les exigences avant de commencer le processus d'installation.
  • Désactivez SELinux ou définissez-le sur le mode permissif. Pour en savoir plus, consultez Installer l'utilitaire Edge apigee-setup.

Installation tout-en-un

  1. Installez tous les composants sur un seul nœud à l'aide de la commande suivante : 
    /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
  2. Redémarrez le composant de l'UI classique une fois l'installation terminée : 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    Cela s'applique à l'UI classique, et non à la nouvelle UI Edge dont le nom de composant est edge-management-ui.

  3. Testez l'installation comme décrit dans Tester l'installation.
  4. Intégrez votre organisation comme décrit dans Intégrer une organisation.

Cliquez ici pour regarder une vidéo sur l'installation tout-en-un d'Edge.

Vous trouverez ci-dessous un fichier de configuration silencieux pour cette topologie. Pour obtenir une documentation de référence complète sur le fichier de configuration, consultez Documentation de référence sur le fichier de configuration Edge.

# With SMTP
IP1=IP_or_DNS_name_of_Node_1
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
# Admin password must be at least 8 characters long and contain one uppercase
# letter, one lowercase letter, and one digit or special character
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
LDAP_TYPE=1
APIGEE_LDAPPW=LDAP_PASSWORD
MP_POD=gateway
REGION=dc-1
ZK_HOSTS="$IP1"
ZK_CLIENT_HOSTS="$IP1"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1"
# Default is postgres
PG_PWD=postgres
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234

Installation autonome à deux nœuds

Pour obtenir la liste des topologies Edge et des numéros de nœuds, consultez Topologies d'installation.

  1. Installer la passerelle autonome et le nœud 1 
    /opt/apigee/apigee-setup/bin/setup.sh -p sa -f configFile
  2. Installez Analytics sur le nœud 2 : 
    /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile
  3. Redémarrez le composant de l'UI classique sur le nœud 1 : 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    Cela s'applique à l'UI classique, et non à la nouvelle UI Edge dont le nom de composant est edge-management-ui.

  4. Testez l'installation comme décrit dans Tester l'installation.
  5. Intégrez votre organisation comme décrit dans Intégrer une organisation.

Vous trouverez ci-dessous un fichier de configuration silencieux pour cette topologie. Pour obtenir une documentation de référence complète sur le fichier de configuration, consultez Documentation de référence sur le fichier de configuration Edge.

# With SMTP
IP1=IP_of_Node_1
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
LDAP_TYPE=1
APIGEE_LDAPPW=LDAP_PASSWORD
MP_POD=gateway
REGION=dc-1
ZK_HOSTS="$IP1"
ZK_CLIENT_HOSTS="$IP1"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1"
# Default is postgres
PG_PWD=postgres
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234

Installation à cinq nœuds

Pour obtenir la liste des topologies Edge et des numéros de nœuds, consultez Topologies d'installation.

  1. Installez le cluster Datastore sur les nœuds 1, 2 et 3 : 
    /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Installez le serveur de gestion sur le nœud 1 : 
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. Installez le routeur et le processeur de messages sur les nœuds 2 et 3 : 
    /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. Installez Analytics sur les nœuds 4 et 5 : 
    /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile
  5. Redémarrez le composant de l'UI classique sur le nœud 1 : 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    Cela s'applique à l'UI classique, et non à la nouvelle UI Edge dont le nom de composant est edge-management-ui.

  6. Testez l'installation comme décrit dans Tester l'installation.
  7. Intégrez votre organisation comme décrit dans Intégrer une organisation.

Vous trouverez ci-dessous un fichier de configuration silencieux pour cette topologie. Pour obtenir une documentation de référence complète sur le fichier de configuration, consultez Documentation de référence sur le fichier de configuration Edge.

# With SMTP
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP4=IP_of_Node_4
IP5=IP_of_Node_5
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=1
APIGEE_LDAPPW=LDAP_PASSWORD
MP_POD=gateway
REGION=dc-1
ZK_HOSTS="$IP1 $IP2 $IP3"
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1 $IP2 $IP3"
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP4
PG_STANDBY=$IP5
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234

Installation en cluster à neuf nœuds

Pour obtenir la liste des topologies Edge et des numéros de nœuds, consultez Topologies d'installation.

  1. Installez le nœud de cluster Datastore sur les nœuds 1, 2 et 3 : 
    /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Installez le serveur de gestion Apigee sur le nœud 1 : 
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. Installez le routeur et le processeur de messages sur les nœuds 4 et 5 : 
    /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. Installez le serveur Qpid Apigee Analytics sur les nœuds 6 et 7 : 
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. Installez le serveur Postgres Apigee Analytics sur les nœuds 8 et 9 : 
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. Redémarrez le composant de l'UI classique sur le nœud 1 : 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    Cela s'applique à l'UI classique, et non à la nouvelle UI Edge, dont le nom de composant est edge-management-ui.

  7. Testez l'installation comme décrit dans Tester l'installation.
  8. Intégrez votre organisation comme décrit dans Intégrer une organisation.

Vous trouverez ci-dessous un fichier de configuration silencieux pour cette topologie. Pour obtenir une documentation de référence complète sur le fichier de configuration, consultez Documentation de référence sur le fichier de configuration Edge.

# With SMTP
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP8=IP_of_Node_8
IP9=IP_of_Node_9
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt 
MSIP=$IP1 
USE_LDAP_REMOTE_HOST=n 
LDAP_TYPE=1
APIGEE_LDAPPW=LDAP_PASSWORD
MP_POD=gateway
REGION=dc-1 
ZK_HOSTS="$IP1 $IP2 $IP3" 
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" 
# Must use IP addresses for CASS_HOSTS, not DNS names.
# Optionally use Cassandra racks
CASS_HOSTS="$IP1 $IP2 $IP3" 
# Default is postgres
PG_PWD=postgres
SKIP_SMTP=n
PG_MASTER=$IP8
PG_STANDBY=$IP9
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234

Installation en cluster à 13 nœuds

Cette section décrit l'ordre d'installation d'un cluster à 13 nœuds. Pour obtenir la liste des topologies Edge et des numéros de nœuds, consultez Topologies d'installation.

L'ordre d'installation d'un cluster de 13 nœuds est le suivant :

  1. Installez le nœud de cluster Datastore sur les nœuds 1, 2 et 3 : 
    /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Installez SymasLDAP sur les nœuds 4 et 5 : 
    /opt/apigee/apigee-setup/bin/setup.sh -p ld -f configFile
  3. Installez le serveur de gestion Apigee sur les nœuds 6 et 7 : 
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  4. Installez le serveur Postgres Apigee Analytics sur les nœuds 8 et 9 : 
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  5. Installez le routeur et le processeur de messages sur les nœuds 10 et 11 : 
    /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  6. Installez le serveur Qpid Apigee Analytics sur les nœuds 12 et 13 : 
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  7. Redémarrez le composant de l'UI classique sur les nœuds 6 et 7 : 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    Cela s'applique à l'UI classique, et non à la nouvelle UI Edge dont le nom de composant est edge-management-ui.

  8. Testez l'installation comme décrit dans Tester l'installation.
  9. Intégrez votre organisation comme décrit dans Intégrer une organisation.

Vous trouverez ci-dessous un exemple de fichier de configuration silencieux pour cette topologie. Pour obtenir une documentation de référence complète sur le fichier de configuration, consultez Documentation de référence sur le fichier de configuration Edge.

# For all nodes except IP4 and IP5
# (which are the SymasLDAP nodes)
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP4=IP_of_Node_4
IP5=IP_of_Node_5
IP6=IP_of_Node_6
IP7=IP_of_Node_7
IP8=IP_of_Node_8
IP9=IP_of_Node_9
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
# Management Server on IP6 only
MSIP=$IP6
USE_LDAP_REMOTE_HOST=y
LDAP_HOST=$IP4
LDAP_PORT=10389
# Management Server on IP7 only
# MSIP=$IP7
# USE_LDAP_REMOTE_HOST=y
# LDAP_HOST=$IP5
# LDAP_PORT=10389
# Use the same password for both SymasLDAP nodes
APIGEE_LDAPPW=LDAP_PASSWORD 
MP_POD=gateway
REGION=dc-1
ZK_HOSTS="$IP1 $IP2 $IP3"
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"
# Must use IP addresses for CASS_HOSTS, not DNS names.
# Optionally use Cassandra racks
CASS_HOSTS="$IP1 $IP2 $IP3"
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP8
PG_STANDBY=$IP9
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234
 
# For SymasLDAP nodes only (IP4 and IP5)
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP4=IP_of_Node_4
IP5=IP_of_Node_5
IP6=IP_of_Node_6
IP7=IP_of_Node_7
IP8=IP_of_Node_8
IP9=IP_of_Node_9
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD

# For the SymasLDAP Server on IP4 only
MSIP=$IP6
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP5

# For the SymasLDAP Server on IP5 only
# MSIP=$IP7
# USE_LDAP_REMOTE_HOST=n
# LDAP_TYPE=2
# LDAP_SID=2
# LDAP_PEER=$IP4
# Set same password for both SymasLDAPs.
APIGEE_LDAPPW=LDAP_PASSWORD

Installation en cluster à 12 nœuds

Avant d'installer Edge sur une topologie en cluster à 12 nœuds (deux centres de données), vous devez comprendre comment définir les propriétés ZooKeeper et Cassandra dans le fichier de configuration silencieux.

  • ZooKeeper

    Pour la propriété ZK_HOSTS des deux centres de données, spécifiez les adresses IP ou les noms DNS de tous les nœuds ZooKeeper des deux centres de données, dans le même ordre, et marquez les nœuds avec le modificateur :observer. Les nœuds sans modificateur :observer sont appelés "votants". Votre configuration doit comporter un nombre impair de "votants".

    Dans cette topologie, l'hôte ZooKeeper sur l'hôte 9 est l'observateur :

    Pour la propriété ZK_CLIENT_HOSTS de chaque centre de données, spécifiez les adresses IP ou les noms DNS des nœuds ZooKeeper du centre de données uniquement, dans le même ordre, pour tous les nœuds ZooKeeper du centre de données. Dans l'exemple de fichier de configuration ci-dessous, le nœud 9 est associé au modificateur :observer. Vous disposez ainsi de cinq électeurs : les nœuds 1, 2, 3, 7 et 8.

  • Cassandra

    Tous les centres de données doivent comporter le même nombre de nœuds Cassandra.

    Pour CASS_HOSTS pour chaque centre de données, assurez-vous de spécifier toutes les adresses IP Cassandra (et non les noms DNS) pour les deux centres de données. Pour le centre de données 1, listez d'abord les nœuds Cassandra de ce centre de données. Pour le centre de données 2, listez d'abord les nœuds Cassandra de ce centre de données. Répertoriez les nœuds Cassandra dans le même ordre pour tous les nœuds Cassandra du centre de données.

    Tous les nœuds Cassandra doivent avoir le suffixe ":d,r". Par exemple, ip:1,1 = centre de données 1 et rack/zone de disponibilité 1 ; et ip:2,1 = centre de données 2 et rack/zone de disponibilité 1.

    Par exemple : "192.168.124.201:1,1 192.168.124.202:1,1 192.168.124.203:1,1 192.168.124.204:2,1 192.168.124.205:2,1 192.168.124.206:2,1"

    Le premier nœud du rack/de la zone de disponibilité 1 de chaque centre de données sera utilisé comme serveur de seed.

    Dans ce modèle de déploiement, la configuration de Cassandra se présente comme suit :

Pour obtenir la liste des topologies Edge et des numéros de nœuds, consultez Topologies d'installation.

  1. Installez le nœud de cluster Datastore sur les nœuds 1, 2, 3, 7, 8 et 9 : 
    /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Installez le serveur de gestion Apigee avec la réplication SymasLDAP sur les nœuds 1 et 7 : 
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. Installez le routeur et le processeur de messages sur les nœuds 2, 3, 8 et 9 : 
    /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. Installez le serveur Qpid Apigee Analytics sur les nœuds 4, 5, 10 et 11 : 
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. Installez le serveur Postgres Apigee Analytics sur les nœuds 6 et 12 : 
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. Redémarrez le composant de l'UI classique sur les nœuds 1 et 7 : 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    Cela s'applique à l'UI classique, et non à la nouvelle UI Edge dont le nom de composant est edge-management-ui.

  7. Testez l'installation comme décrit dans Tester l'installation.
  8. Intégrez votre organisation comme décrit dans Intégrer une organisation.

Vous trouverez ci-dessous un fichier de configuration silencieux pour cette topologie. Pour obtenir une documentation de référence complète sur le fichier de configuration, consultez Documentation de référence sur le fichier de configuration Edge.

  • Configure SymasLDAP avec la réplication sur deux nœuds SymasLDAP.
  • Spécifie le modificateur :observer sur un nœud ZooKeeper. Dans une installation à centre de données unique, omettez ce modificateur.
# Datacenter 1
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP6=IP_of_Node_6
IP7=IP_of_Node_7
IP8=IP_of_Node_8
IP9=IP_of_Node_9
IP12=IP_of_Node_12
HOSTIP=$(hostname -i)
MSIP=$IP1
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP7
APIGEE_LDAPPW=LDAP_PASSWORD
MP_POD=gateway-1
REGION=dc-1
ZK_HOSTS="$IP1 $IP2 $IP3 $IP7 $IP8 $IP9:observer"
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"
# Must use IP addresses for CASS_HOSTS, not DNS names.
# Optionally use Cassandra racks
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1 $IP7:2,1 $IP8:2,1 $IP9:2,1"
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP6
PG_STANDBY=$IP12
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234
 
# Datacenter 2
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP6=IP_of_Node_6
IP7=IP_of_Node_7
IP8=IP_of_Node_8
IP9=IP_of_Node_9
IP12=IP_of_Node_12
HOSTIP=$(hostname -i)
MSIP=$IP7
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=2
LDAP_PEER=$IP1
APIGEE_LDAPPW=LDAP_PASSWORD
MP_POD=gateway-2
REGION=dc-2
ZK_HOSTS="$IP1 $IP2 $IP3 $IP7 $IP8 $IP9:observer"
ZK_CLIENT_HOSTS="$IP7 $IP8 $IP9"
# Must use IP addresses for CASS_HOSTS, not DNS names.
# Optionally use Cassandra racks
CASS_HOSTS="$IP7:2,1 $IP8:2,1 $IP9:2,1 $IP1:1,1 $IP2:1,1 $IP3:1,1"
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP6
PG_STANDBY=$IP12
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234