Installer des composants Edge sur un nœud

Edge pour Private Cloud version 4.16.09

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 sous la forme suivante:

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

component est le composant Edge à installer et configFile est le fichier de configuration silencieuse qui contient les informations d'installation. Le fichier de configuration doit être accessible ou lisible par l'utilisateur « apigee ». Par 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'utilisateur "apigee".

Par exemple, pour installer le serveur de gestion Edge:

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

Remarques concernant l'installation

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

Configurer la réplication en attente maître 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 utiliser la réplication en attente maître afin que, en cas de défaillance du nœud maître, le nœud de secours puisse continuer à diffuser du trafic.

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

Activer l'authentification Cassandra

Par défaut, Cassandra est installé sans activer l'authentification. Cela signifie que tout le monde peut accéder à Cassandra. Vous pouvez activer l'authentification après l'installation d'Edge ou dans le cadre du processus d'installation.

Vous pouvez activer l'authentification Cassandra en tant que date d'installation à l'aide des propriétés du fichier de configuration silencieuse. Vous pouvez également l'activer après l'installation.

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

Associer le routeur à un port protégé

Si vous souhaitez lier le routeur à un port protégé, tel que des numéros de port inférieurs à 1 024, 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 sous le nom d'utilisateur "apigee" qui n'a pas accès aux ports privilégiés.

Pour exécuter le routeur sous un autre nom d'utilisateur:

  1. En mode root, créez le fichier /opt/apigee/etc/edge-router.d/RUN_USER.sh.
  2. Ajoutez l'entrée suivante au fichier:
    RUN_USER=root
    Si vous ne souhaitez pas exécuter le routeur en mode root, spécifiez un utilisateur ayant accès au port.
  3. Enregistrez le fichier.
  4. Si vous avez spécifié un utilisateur autre que root, remplacez le propriétaire du fichier par cet utilisateur:
    > chown USER:USER /opt/apigee/etc/edge-router.d/RUN_USER.sh
  5. Redémarrez le routeur:
    > /opt/apigee/apigee-service/bin/apigee-service Edge-router restart

Spécifier les composants à installer

Le tableau suivant répertorie 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 Cassandra uniquement.

zk n'installez que ZooKeeper.

ds

Installez ZooKeeper et Cassandra.

ld

Installez OpenLDAP uniquement.

ms

Installer Edge Management Server, qui installe également l’interface utilisateur Edge 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 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 le serveur Postgres uniquement.

sax

Installer les composants d'analyse, c'est-à-dire Qpid et Postgres.

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

mois

Installez la monétisation.

sa

Installez Edge autonome, c'est-à-dire Cassandra, ZooKeeper, Management Server, OpenLDAP, l'interface utilisateur 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.

IA

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.

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 devez utiliser des fichiers de configuration différents ou modifier le fichier de configuration dans les cas suivants:

  • 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 les propriétés telles que ZK_CLIENT_HOSTS et CASS_HOSTS.

Exemple de fichier de configuration

Vous trouverez ci-dessous un exemple de fichier de configuration silencieuse complet pour une installation Edge à 9 nœuds. Modifiez ce fichier selon les besoins de votre configuration. Utilisez l'option -f pour setup.sh afin d'inclure ce fichier. Vous trouverez également ci-dessous des exemples de fichiers de configuration pour chaque topologie périphérique.

# IP address or DNS name of nodes.
IP1=192.168.1.1  # Management Server, OpenLDAP, UI, ZooKeeper, Cassandra
IP2=192.168.1.2  # ZooKeeper, Cassandra
IP3=192.168.1.3  # ZooKeeper, Cassandra
IP4=192.168.1.4  # Router, Message Processor
IP5=192.168.1.5  # Router, Message Processor
IP6=192.168.1.6  # Qpid
IP7=192.168.1.7  # Qpid
IP8=192.168.1.8  # Postgres
IP9=192.168.1.9  # Postgres

# Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost.
HOSTIP=$(hostname -i)

# Set Edge sys admin credentials.
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=yourPassword    # If omitted, you are prompted for it.

# Location of Edge license file.
LICENSE_FILE=/tmp/license.txt

# Management Server information.
MSIP=$IP1    # IP or DNS name of Management Server node. 
# Specify the port the Management Server listens on for API calls.
# APIGEE_PORT_HTTP_MS=8080    # Default is 8080.

#
# OpenLDAP information.
#
# Set to y if you are connecting to a remote LDAP server. 
# If n, Edge installs OpenLDAP when it installs the Management Server.
USE_LDAP_REMOTE_HOST=n 

# If connecting to remote OpenLDAP server, specify the IP/DNS name and port.
# LDAP_HOST=$IP1    # IP or DNS name of OpenLDAP node.
# LDAP_PORT=10389   # Default is 10389.
APIGEE_LDAPPW=yourLdapPassword

# Specify OpenLDAP without replication, 1, or with replication, 2.
LDAP_TYPE=1 

# Set only if using replication.
# LDAP_SID=1    # Unique ID for this LDAP server. 
# LDAP_PEER=    # IP or DNS name of LDAP peer.

BIND_ON_ALL_INTERFACES=y 

# The Message Processor and Router pod.
MP_POD=gateway 

# The name of the region, corresponding to the data center name.
REGION=dc-1 # Use dc-1 unless installing in a 
            # multi-data center environment. 

# ZooKeeper information.
# See table below if installing in a multi-data center environment.
ZK_HOSTS="$IP1 $IP2 $IP3"         # IP/DNS names of all ZooKeeper nodes. 
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"  # IP/DNS names of all ZooKeeper nodes.

# Cassandra information.
CASS_CLUSTERNAME=Apigee    # Default name is Apigee.

# IP addresses of the Cassandra hosts separated by spaces.
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1"

# Set to enable Cassandra authentication.
# CASS_AUTH=y    # The default value is n.
# Cassandra uname/pword required if you enabled Cassandra authentication.
# CASS_USERNAME=
# CASS_PASSWORD=

# Use to enable Postgres master-standby replication
# when you have multiple Postgres nodes. 
# PG_MASTER=IPorDNSofNewMaster
# PG_STANDBY=IPorDNSofOldMaster

# SMTP information.
SKIP_SMTP=n       # Skip now and configure later by specifying "y".
SMTPHOST=smtp.gmail.com
SMTPUSER=your@email.com
SMTPPASSWORD=yourEmailPassword
SMTPSSL=y
SMTPPORT=465      # If no SSL, use a different port, such as 25.

Le tableau suivant contient des informations supplémentaires sur ces propriétés:

Propriété

Remarque

Noms IP/DNS

N'utilisez pas de mappage de nom d'hôte avec la plage 127.0.0.1 ni avec une adresse IP de 127.0.0.1 lorsque vous spécifiez l'adresse IP d'un nœud.

ADMIN_EMAIL
APIGEE_ADMINPW

Le mot de passe de l'administrateur système doit comporter au moins huit caractères et contenir une lettre majuscule, une lettre minuscule, un chiffre ou un caractère spécial. Si vous omettez le mot de passe, vous serez invité à le faire.

LICENSE_FILE

Emplacement du fichier de licence, qui doit être accessible à l'utilisateur "apigee". Par exemple, stockez-le dans le répertoire /tmp et chmod 777 dans le fichier. Le fichier est copié dans le répertoire d'installation d'Edge.

USE_LDAP_REMOTE_HOST
LDAP_HOST
LDAP_PORT

Si USE_LDAP_REMOTE_HOST est défini sur "n", Edge installe automatiquement OpenLDAP lors de l'installation du serveur de gestion.

Définissez USE_LDAP_REMOTE_HOST sur "y" si vous vous connectez à un serveur LDAP distant. OpenLDAP n'est pas installé avec le serveur de gestion.

Si vous vous connectez à un serveur OpenLDAP distant, utilisez LDAP_HOST
et LDAP_PORT pour spécifier l'adresse IP ou le nom DNS et le numéro de port de l'hôte.

LDAP_TYPE
LDAP_SID
LDAP_PEER

Définir LDAP_TYPE=1 pour OpenLDAP sans réplication. LDAP_TYPE=2 correspond à OpenLDAP avec réplication.

Si votre topologie Edge utilise un seul serveur OpenLDAP, indiquez 1. Si votre installation Edge utilise plusieurs nœuds OpenLDAP, comme dans une installation de production à 13 nœuds, spécifiez 2.

Si vous activez la réplication, définissez les propriétés suivantes:

  • LDAP_SID=1 : identifiant unique de ce serveur LDAP Chaque nœud LDAP utilise un ID différent. Par exemple, définissez la valeur sur 2 pour l'appairage LDAP.
  • LDAP_PEER=10.0.0.1 : adresse IP ou nom DNS du pair LDAP.

BIND_ON_ALL_INTERFACES

Si cette valeur est définie sur "y", la liaison Routeur/Processeur de message (écoute) sur toutes les interfaces (IP) Si elle est définie sur "n", la liaison routeur/processeur de message (écoute) sur une interface spécifique correspond à l'adresse IP renvoyée par la commande "hostname -i).

MP_POD

Spécifiez le nom du pod de processeur de messages et de routeur. Par défaut, le nom est "passerelle".

RÉGION

Nom de la région. Par convention, les noms prennent généralement la forme dc-#, où # correspond à une valeur entière. (dc-1, dc-2, etc.). Vous pouvez utiliser dc-1, sauf si vous l'installez dans un environnement multicentre de données.

Dans une installation avec plusieurs centres de données, la valeur est dc-1 ou dc-2, etc. selon le centre de données que vous installez. Cependant, vous n'êtes pas obligé d'utiliser des noms au format dc-#. Vous pouvez utiliser n'importe quel nom pour la région.

ZK_HOSTS

Adresses IP ou noms DNS des nœuds ZooKeeper. Les adresses IP ou les noms DNS doivent être répertoriés dans le même ordre sur tous les nœuds ZooKeeper.

Dans un environnement comportant plusieurs centres de données, répertoriez tous les nœuds ZooKeeper des deux centres de données.

Ne spécifiez le modificateur ":observer" sur les nœuds ZooKeeper que lorsque vous créez plusieurs centres de données, comme décrit dans une installation avec 12 hôtes. Dans une installation de centre de données unique, omettez ce modificateur. Pour en savoir plus, consultez la section Installation en cluster à 12 hôtes.

ZK_CLIENT_HOSTS

Adresses IP ou noms DNS des nœuds ZooKeeper utilisés par ce centre de données. Les adresses IP ou les noms DNS doivent être répertoriés dans le même ordre sur tous les nœuds ZooKeeper.

Dans une installation de centre de données unique, il s'agit des mêmes nœuds que spécifié par ZK_HOSTS.

Dans un environnement comportant plusieurs centres de données, répertoriez uniquement les nœuds ZooKeeper de ce centre de données. Pour en savoir plus, consultez la section Installation en cluster à 12 hôtes.

CASS_HOSTS

Adresses IP (et non les noms DNS) des nœuds Cassandra. Les deux premiers nœuds seront utilisés comme serveurs de départ. Les adresses IP doivent être répertoriées dans le même ordre sur tous les nœuds Cassandra.

Les nœuds Cassandra peuvent avoir un suffixe ":dc,ra" facultatif qui spécifie le centre de données et le rack du nœud Cassandra. Spécifiez ce modificateur uniquement lorsque vous créez plusieurs centres de données, comme décrit dans une installation à 12 hôtes. Dans une installation de centre de données unique, omettez ce modificateur.

Par exemple, "192.168.124.201:1,1 = centre de données 1 et zone de rack/disponibilité 1, et "192.168.124.204:2,1 = centre de données 2 et zone de rack/disponibilité 1".

Dans un environnement multicentre de données, pour résoudre les problèmes de pare-feu, les CASS_HOSTS doivent être ordonnés de manière à ce que les nœuds du centre de données actuel soient placés au début (comme illustré ci-dessus). Pour en savoir plus, consultez la section Installation en cluster à 12 hôtes.

CASS_AUTH
CASS_USERNAME

CASS_PASSWORD

Si vous activez l'authentification Cassandra (CASS_AUTH=y), vous pouvez transmettre le nom d'utilisateur et le mot de passe Cassandra à l'aide de ces propriétés.

PG_MASTER

PG_STANDBY

Définissez cette option pour activer la réplication en attente maître Postgres, sous la forme:

PG_MASTER=IPorDNSofNewMaster

PG_STANDBY=IPorDNSofOldMaster

SKIP_SMTP
SMTPHOST
SMTPUSER
SMTPPASSWORD
SMTPSSL
SMTPPORT

Configurez SMTP pour que Edge puisse envoyer des e-mails en cas de perte de mots de passe et d'autres notifications.

Si les identifiants d'un utilisateur SMTP ne sont pas requis, omettez SMTPUSER et SMTPPASSWORD.

Ordre d'installation des composants

L'ordre d'installation des composants dépend de la topologie souhaitée.

Pour tous les exemples d'installation ci-dessous, nous partons du principe que vous êtes en train d'installer:

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

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 qui exécute 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 échoue.

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. Testez l'installation comme décrit dans la section Tester l'installation.
  3. Intégrez votre organisation comme décrit dans la section Intégrer une organisation.

Voici un fichier de configuration silencieux pour cette topologie:

# With SMTP
IP1=IPorDNSnameOfNode
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
LDAP_TYPE=1
APIGEE_LDAPPW=secret
BIND_ON_ALL_INTERFACES=y
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"
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd    
# omit for no password
SMTPSSL=n
SMTPPORT=25

Installation autonome à deux hôtes

Consultez la section Topologies d'installation pour obtenir la liste des topologies en périphérie et des nombres de nœuds.

  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. 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.

Voici un fichier de configuration silencieux pour cette topologie:

# With SMTP
IP1=IPorDNSnameOfNode1
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
LDAP_TYPE=1
APIGEE_LDAPPW=secret
BIND_ON_ALL_INTERFACES=y
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"
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd    
# omit for no password
SMTPSSL=n
SMTPPORT=25

Installation en cluster à cinq hôtes

Consultez la section Topologies d'installation pour obtenir la liste des topologies en périphérie et des nombres de nœuds.

  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 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 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. Testez l'installation comme décrit dans la section Tester l'installation.
  6. Intégrez votre organisation comme décrit dans la section Intégrer une organisation.

Voici un fichier de configuration silencieux pour cette topologie:

# With SMTP
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP4=IPorDNSnameOfNode4
IP5=IPorDNSnameOfNode5
 HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com 
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt 
MSIP=$IP1 
USE_LDAP_REMOTE_HOST=n 
LDAP_TYPE=1
APIGEE_LDAPPW=secret 
BIND_ON_ALL_INTERFACES=y
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" 
PG_MASTER=$IP4
PG_STANDBY=$IP5
SKIP_SMTP=n
SMTPHOST=smtp.example.com 
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd       
# omit for no password 
SMTPSSL=n
SMTPPORT=25

Installation en cluster de neuf hôtes

Consultez la section Topologies d'installation pour obtenir la liste des topologies en périphérie et des nombres 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 Apigee Analytics Qpid sur les nœuds 6 et 7:
    > /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. Installez le serveur Apigee Analytics Postgres sur les nœuds 8 et 9:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  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.

Voici un fichier de configuration silencieux pour cette topologie:

# With SMTP
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com 
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt 
MSIP=$IP1 
USE_LDAP_REMOTE_HOST=n 
LDAP_TYPE=1
APIGEE_LDAPPW=secret 
BIND_ON_ALL_INTERFACES=y
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" 
SKIP_SMTP=n
PG_MASTER=$IP8
PG_STANDBY=$IP9
SMTPHOST=smtp.example.com 
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd       
# omit for no password
SMTPSSL=n
SMTPPORT=25

Installation en cluster à 13 hôtes

Consultez la section Topologies d'installation pour obtenir la liste des topologies en périphérie et des nombres 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 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 Apigee Analytics Postgres 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 sur les nœuds 12 et 13:
    > /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  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.

Voici un fichier de configuration silencieux pour cette topologie:

# For all components except OpenLDAP
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP4=IPorDNSnameOfNode4
IP5=IPorDNSnameOfNode5
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com 
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt 
# First Management Server on IP6
MSIP=$IP6 
USE_LDAP_REMOTE_HOST=y
LDAP_HOST=$IP4
LDAP_PORT=10389
# Second Management Server on IP7
# MSIP=$IP7
# USE_LDAP_REMOTE_HOST=y
# LDAP_HOST=$IP5
# LDAP_PORT=10389
# Same password for both OpenLDAPs.
APIGEE_LDAPPW=secret 
BIND_ON_ALL_INTERFACES=y
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" 
PG_MASTER=$IP8
PG_STANDBY=$IP9
SKIP_SMTP=n
SMTPHOST=smtp.example.com 
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd       
# omit for no password
SMTPSSL=n
SMTPPORT=25
# For OpenLDAP on IP4 and IP5
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP4=IPorDNSnameOfNode4
IP5=IPorDNSnameOfNode5
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com 
APIGEE_ADMINPW=Secret123
# First OpenLDAP Server on IP4
MSIP=$IP6 
USE_LDAP_REMOTE_HOST=n 
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP5
# Second OpenLDAP Server on IP5
# MSIP=$IP7 
# USE_LDAP_REMOTE_HOST=n 
# LDAP_TYPE=2
# LDAP_SID=2
# LDAP_PEER=$IP4
# Set same password for both OpenLDAPs.
APIGEE_LDAPPW=secret 

Installation en cluster à 12 hôtes

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

  • ZooKeeper

    Pour la propriété ZK_HOSTS des deux centres de données, indiquez 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 "voters". Votre configuration doit comporter un nombre impair d'é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 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 ayez cinq votants: 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.

    Pour CASS_HOSTS de chaque centre de données, veillez à spécifier toutes les adresses IP Cassandra (et non les noms DNS) des 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, commencez par indiquer 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 les suffixes suivants : ":<d>,<r>", par exemple "<ip>:1,1 = centre de données 1 et zone de rack/disponibilité 1" et "<ip>:2,1 = centre de données 2" et "zone de rack/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.12



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

Consultez la section Topologies d'installation pour obtenir la liste des topologies en périphérie et des nombres de nœuds.

  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 Apigee Management Server 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 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. 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 silencieux pour cette topologie. Notez que ce fichier de configuration:

  • Configure OpenLDAP avec réplication sur deux nœuds OpenLDAP.
  • Spécifie le modificateur ":observer" sur un nœud ZooKeeper. Dans une installation de centre de données unique, omettez ce modificateur.
# Datacenter 1
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9 
IP12=IPorDNSnameOfNode12
HOSTIP=$(hostname -i)
MSIP=$IP1
ADMIN_EMAIL=opdk@apigee.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP7
APIGEE_LDAPPW=secret
BIND_ON_ALL_INTERFACES=y
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.
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1 $IP7:2,1 $IP8:2,1 $IP9:2,1"
PG_MASTER=$IP6
PG_STANDBY=$IP12
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com 
# omit for no username
SMTPPASSWORD=smtppwd   
# omit for no password
SMTPSSL=n
SMTPPORT=25
# Datacenter 2
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9 
IP12=IPorDNSnameOfNode12
HOSTIP=$(hostname -i)
MSIP=$IP7
ADMIN_EMAIL=opdk@apigee.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=2
LDAP_PEER=$IP1
APIGEE_LDAPPW=secret
BIND_ON_ALL_INTERFACES=y
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.
CASS_HOSTS="$IP7:2,1 $IP8:2,1 $IP9:2,1 $IP1:1,1 $IP2:1,1 $IP3:1,1"
PG_MASTER=$IP6
PG_STANDBY=$IP12
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com 
# omit for no username
SMTPPASSWORD=smtppwd   
# omit for no password
SMTPSSL=n
SMTPPORT=25