Installer des composants Edge sur un nœud

Après avoir installé l'utilitaire Edge apigee-setup sur un nœud, utilisez le 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 "apigee" utilisateur. Pour exemple, vous pouvez créer un nouveau répertoire pour les fichiers, les placer dans le répertoire /usr/local ou /usr/local/share, ou n'importe où sur le nœud accessible par l'"apigee" utilisateur.

Par exemple, pour installer Edge Management Server:

/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 Installez l'utilitaire de configuration Edge Apigee.

Considérations concernant l'installation

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

Configurer la réplication maître-nœud de disponibilité

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 utiliser la réplication de secours En cas de défaillance du nœud maître, le nœud de secours peut continuer à acheminer le trafic du serveur.

Vous pouvez activer et configurer la réplication maître en mode veille au moment de l'installation en utilisant les propriétés de le fichier de configuration silencieuse. Vous pouvez également activer la réplication maître-slave après l'installation. Pour reportez-vous à la section Configurer le mode la réplication pour Postgres.

Activer Cassandra authentification

Par défaut, Cassandra s'installe 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 la page Activer Cassandra authentification.

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 que 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. Les propriétés QPID_MGMT_USERNAME et QPID_MGMT_PASSWORD doivent être incluses lors de la l'installation. Assurez-vous que ces propriétés sont ajoutées avec les valeurs appropriées dans le fichier de configuration pour faciliter la réussite l'installation.

Installer la nouvelle interface utilisateur d'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'UI 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 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 apigee-service pour spécifier les composants à installer sur le nœud:

Composant Description

c

Installez Cassandra uniquement.
zk installer ZooKeeper uniquement.

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 OpenLDAP est ignorée et que le serveur de gestion utilise OpenLDAP installé sur un nœud différent.

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, le protocole OpenLDAP l’installation est ignorée et le serveur de gestion utilise OpenLDAP installé sur une autre d'un nœud.

r

Installez Edge Router uniquement.

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 uniquement le serveur Qpid.

ps

Installez uniquement le serveur Postgres.
pdb Installez la base de données Postgres uniquement. Elle n'est utilisée que lors de l'installation du portail de services dédiés aux 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 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 ignore les composants d'analyse Edge : Qpid et Postgres.

N'utilisez cette option que pour le développement et les tests, et non pour la production.

aio

Installez tous les composants sur un seul nœud.

N'utilisez cette option que 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 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 présente un exemple de fichier de configuration 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.

Tester la configuration système requise sans exécuter une 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 que vous procédiez réellement à l’installation.

Vous pouvez maintenant utiliser "-t" pour effectuer cette vérification sans avoir à faire une installation. Par exemple : pour vérifier la configuration système requise pour une "aio" sans avoir à effectuer l'installation, utilisez la 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 exécutant l'utilitaire setup.sh n'a pas accès à ce répertoire, il écrit le journal 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 est défaillant.

Installer les composants Edge

Cette section explique comment installer des 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 :

  • Avec l'authentification Cassandra désactivée (par défaut). Pour en savoir plus, consultez Activer l'authentification Cassandra.
  • Avec la réplication en mode maître Postgres désactivée (par défaut) Pour en savoir plus, consultez la section Configurer la réplication en mode maître Postgres pour en savoir plus.
  • 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, les routeurs Cloud Router.

Prérequis

Avant de pouvoir installer des composants Edge, vous devez :

  • Consultez la configuration requise pour prérequis et une liste des fichiers requis avant de poursuivre l'installation. Assurez-vous d'avoir lu les exigences avant de commencer l'installation processus.
  • Désactivez SELinux ou définissez-le sur le mode permissif. Pour en savoir plus, consultez Installer l'utilitaire apigee-setup Edge.

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=pass1234

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 l'article Intégrer un organisation.

Vous trouverez ci-dessous un fichier de configuration silencieuse pour cette topologie. Pour en savoir plus sur le fichier de configuration, voir Référence du 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=pass1234

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 l'article Intégrer un organisation.

Vous trouverez ci-dessous un fichier de configuration silencieux pour cette topologie. Pour en savoir plus sur le fichier de configuration, voir Référence du 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=pass1234

Installation en cluster à neuf nœuds

Consultez la section Topologies d'installation pour obtenir la liste des et les numéros de nœuds.

  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 Apigee Management Server 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 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 d'interface utilisateur 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 l'article Intégrer un 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
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=pass1234

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 d'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 Qpid d'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 d'interface utilisateur 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 l'article Intégrer un organisation.

Vous trouverez ci-dessous un exemple de fichier de configuration silencieux pour cette topologie. Pour en savoir plus, sur le fichier de configuration, consultez la 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=pass1234
 
# 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". Vous devez avoir un nombre impair d'"votants" dans votre configuration.

    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 uniquement les adresses IP ou les noms DNS 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 avoir le même nombre de nœuds Cassandra.

    Dans le champ CASS_HOSTS de chaque centre de données, veillez à spécifier toutes les adresses IP Cassandra (et non 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, commencez par répertorier les nœuds Cassandra de ce centre de données. Lister 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 un 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.

    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 Apigee Analytics Postgres sur les nœuds 6 et 12: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. Redémarrez le composant d'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=pass1234
 
# 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=pass1234