Installer des composants Edge sur un nœud

Après avoir installé l'utilitaire apigee-setup Edge 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 est le composant Edge à installer et configFile est le 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 de gestion Edge:

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

Pour plus d'informations sur l'installation d'Edge apigee-setup, consultez la section Installer l'utilitaire de configuration Edge d'Apigee.

Considérations concernant l'installation

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

Configurer une réplication Postgres en veille

Par défaut, Edge installe tous les nœuds Postgres en mode maître. Toutefois, dans les systèmes de production avec plusieurs nœuds Postgres, vous devez les configurer pour qu'ils utilisent la réplication maître-nœud de secours afin que, en cas de défaillance du nœud maître, le nœud de secours puisse continuer à gérer le trafic du serveur.

Vous pouvez activer et configurer la réplication maître-standby 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-slave après l'installation. Pour en savoir plus, consultez la section Configurer la réplication de secours pour Postgres.

Considérations concernant openldap 2.4 sur RHEL 9.X/Rocky 9.X/Oracle 9.X

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

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

Activer l'authentification Cassandra

Par défaut, Cassandra installe l'application sans authentification activée. Cela signifie que n'importe qui 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é, par exemple des numéros de port inférieurs à 1 000, 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 pour accéder aux ports inférieurs à 1 000, consultez la section 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 Private Cloud. (L'interface utilisateur classique est installée par défaut.)

Notez que l'interface utilisateur Edge nécessite 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 d'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 installez uniquement ZooKeeper.

ds

Installez ZooKeeper et Cassandra.

ld

Installez OpenLDAP uniquement.

mt

Installez Edge Management Server, qui installe également OpenLDAP.

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

ms

Installer Edge Management Server, qui installe également Edge UI et OpenLDAP.

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

r

Installez uniquement le routeur Edge.

mp

Installez uniquement le processeur de messages Edge.

rmp

Installez le routeur Edge et le processeur de messages.

ui

Installez l'interface utilisateur Edge.

qs

Installez Qpid Server uniquement.

ps

Installez uniquement le serveur Postgres.
pdb Installer la base de données Postgres uniquement : utilisée uniquement lors de l'installation du portail Apigee Developer Services (ou simplement, du portail). Consultez la section 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 SSO Apigee.

mo

Install Monetization

sa

Installez Edge de manière autonome, c'est-à-dire Cassandra, ZooKeeper, le serveur de gestion, OpenLDAP, l'interface utilisateur Edge, le routeur et le processeur de messages. Cette option exclut 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 pour installer 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 OpenLDAP 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 est accompagnée d'un exemple de fichier de configuration. Pour obtenir la documentation de référence complète sur le fichier de configuration, consultez la section Documentation de référence sur le fichier de configuration Edge.

Tester les exigences système 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. Cependant, dans les versions précédentes d'Edge, cette vérification nécessitait d'effectuer réellement l'installation.

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

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

Cette commande affiche à l'écran toutes les erreurs liées aux exigences système.

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

Fichiers journaux d'installation

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

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

Si l'utilisateur qui exécute l'utilitaire setup.sh n'a pas accès à ce répertoire, le journal est écrit dans le répertoire /tmp sous la forme d'un fichier nommé 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 des composants Edge pour les différentes topologies. L'ordre d'installation des composants est basé sur la topologie souhaitée.

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

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

Prérequis

Avant de pouvoir installer des composants Edge, vous devez:

  • Consultez la configuration requise pour connaître les conditions préalables et la liste des fichiers requis avant de poursuivre l'installation. Assurez-vous d'avoir consulté les conditions requises avant de commencer le processus d'installation.
  • Désactivez SELinux ou définissez-le sur le mode permissif. Pour en savoir plus, consultez la section Installer l'utilitaire de configuration Edge Apigee.

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 d'interface utilisateur classique une fois l'installation terminée: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

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

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

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

Vous trouverez ci-dessous un fichier de configuration silencieux pour cette topologie. Pour obtenir la documentation de référence complète sur le fichier de configuration, consultez la section 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 et des numéros de nœuds Edge, consultez la section 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'interface utilisateur classique, et non à la nouvelle interface utilisateur Edge dont le nom de composant est edge-management-ui.

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

Vous trouverez ci-dessous un fichier de configuration silencieux pour cette topologie. Pour obtenir la documentation de référence complète sur le fichier de configuration, consultez la 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 la section 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'interface utilisateur classique, et non à la nouvelle interface utilisateur Edge dont le nom de composant est edge-management-ui.

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

Vous trouverez ci-dessous un fichier de configuration silencieuse pour cette topologie. Pour obtenir la documentation de référence complète sur le fichier de configuration, consultez la section 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 et des numéros de nœuds Edge, consultez la section 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 d'Apigee Analytics sur les nœuds 6 et 7: 
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. Installez Apigee Analytics Postgres Server 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'interface utilisateur classique, et non à la nouvelle interface utilisateur Edge, dont le nom de composant est edge-management-ui.

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

Vous trouverez ci-dessous un fichier de configuration silencieux pour cette topologie. Pour une référence complète sur le fichier de configuration, consultez la 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 et des numéros de nœuds Edge, consultez la section Topologies d'installation.

L'ordre d'installation pour un cluster à 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 OpenLDAP sur les nœuds 4 et 5: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ld -f configFile
  3. Installez Apigee Management Server 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 Apigee Analytics Qpid Server 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'interface utilisateur classique, et non à la nouvelle interface utilisateur Edge dont le nom de composant est edge-management-ui.

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

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

# For all nodes except IP4 and IP5
# (which are the OpenLDAP 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 OpenLDAP 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 OpenLDAP 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 OpenLDAP Server on IP4 only
MSIP=$IP6
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP5

# For the OpenLDAP 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 OpenLDAPs.
APIGEE_LDAPPW=LDAP_PASSWORD

Installation en cluster à 12 nœuds

Avant d'installer Edge sur une topologie de cluster à 12 nœuds (deux centres de données), vous devez savoir 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 tous les nœuds avec le modificateur :observer. Les nœuds sans le modificateur :observer sont appelés "électeurs". Votre configuration doit comporter un nombre impair de "électeurs".

    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 uniquement des nœuds ZooKeeper du centre de données, 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 tagué avec le modificateur :observer afin que vous disposiez de cinq électeurs: les nœuds 1, 2, 3, 7 et 8.

  • Cassandra

    Tous les centres de données doivent disposer du 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, commencez par répertorier 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 comporter 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 référence.

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

Pour obtenir la liste des topologies et des numéros de nœuds Edge, consultez la section 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 OpenLDAP 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 Apigee Analytics Qpid Server 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'interface utilisateur classique, et non à la nouvelle interface utilisateur Edge dont le nom de composant est edge-management-ui.

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

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

  • Il configure OpenLDAP avec une réplication sur deux nœuds OpenLDAP.
  • Spécifie le modificateur :observer sur un nœud ZooKeeper. Pour une installation dans un seul centre de données, 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