Installer des composants Edge sur un nœud

Edge for Private Cloud v. 4.16.09

Après avoir installé l'utilitaire apigee-setup d'Edge sur un nœud, utilisez-le 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ù 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 rédigez votre fichier de configuration, tenez compte des options suivantes.

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

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

Activer l'authentification Cassandra

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

Vous pouvez activer l'authentification Cassandra au moment de l'installation en utilisant des propriétés dans le fichier de configuration silencieux. Vous pouvez également l'activer après l'installation.

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

Lier le routeur à un port protégé

Si vous souhaitez lier le routeur à un port protégé, tel que les 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 en tant qu'utilisateur "apigee", qui n'a pas accès aux ports privilégiés.

Pour exécuter le routeur en tant qu'utilisateur différent :

  1. En tant qu'utilisateur racine, 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 tant qu'utilisateur racine, spécifiez un utilisateur ayant accès au port.
  3. Enregistrez le fichier.
  4. Si vous avez spécifié un utilisateur autre que l'utilisateur racine, 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 uniquement Cassandra.

zk installer uniquement ZooKeeper.

ds

Installez ZooKeeper et Cassandra.

ld

Installez uniquement OpenLDAP.

ms

Installez le serveur de gestion Edge, 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 uniquement Edge Router.

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.

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.

mois

Installez la monétisation.

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

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 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 à neuf nœuds. Modifiez ce fichier si nécessaire pour votre configuration. Utilisez l'option -f de setup.sh pour inclure ce fichier. Vous trouverez également ci-dessous des exemples de fichiers de configuration pour chaque topologie Edge.

# 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 nom d'hôte mappé sur 127.0.0.1 ni d'adresse IP 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 saisir.

LICENSE_FILE

Emplacement du fichier de licence, qui doit être accessible à l'utilisateur "apigee". Par exemple, stockez-le dans le répertoire /tmp et exécutez la commande chmod 777 sur 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 lorsqu'il installe le 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, ainsi que le numéro de port de l'hôte.

LDAP_TYPE
LDAP_SID
LDAP_PEER

Définissez 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, spécifiez 1. Si votre installation Edge utilise plusieurs nœuds OpenLDAP, par exemple 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 un pair LDAP.
  • LDAP_PEER=10.0.0.1 : adresse IP ou nom DNS du pair LDAP.

BIND_ON_ALL_INTERFACES

Si la valeur est "y", le routeur/processeur de messages se lie (écoute) à toutes les interfaces (adresses IP). Si la valeur est définie sur "n", le routeur/processeur de messages se lie (écoute) sur une interface spécifique, l'adresse IP renvoyée par la commande "hostname -i").

MP_POD

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

REGION

Nom de la région. Par convention, les noms se présentent généralement sous la forme dc-#, où # correspond à une valeur entière. Par exemple, dc-1, dc-2, etc. Vous pouvez utiliser dc-1, sauf si vous effectuez l'installation dans un environnement à plusieurs centres de données.

Dans une installation de plusieurs centres de données, la valeur est dc-1, dc-2, etc., selon le centre de données que vous installez. Toutefois, vous n'êtes pas limité à l'utilisation de 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 listés dans le même ordre sur tous les nœuds ZooKeeper.

Dans un environnement à plusieurs centres de données, listez tous les nœuds ZooKeeper des deux centres de données.

Spécifiez le modificateur ":observer" sur les nœuds ZooKeeper uniquement lorsque vous créez plusieurs centres de données, comme décrit dans une installation à 12 hôtes. Dans une installation à un seul centre de données, omettez ce modificateur. Pour en savoir plus, consultez Installation en cluster sur 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 listé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 ceux spécifiés par ZK_HOSTS.

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

CASS_HOSTS

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

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

Par exemple, "192.168.124.201:1,1" correspond au centre de données 1 et au rack/à la zone de disponibilité 1, et "192.168.124.204:2,1" correspond au centre de données 2 et au rack/à la zone de 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 (comme illustré dans l'exemple ci-dessus) à ce que les nœuds du centre de données actuel soient placés au début. Pour en savoir plus, consultez Installation en cluster sur 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 maître-secours Postgres, au format suivant :

PG_MASTER=IPorDNSofNewMaster

IPorDNSofOldMaster

SKIP_SMTP
SMTPHOST
SMTPUSER
SMTPPASSWORD
SMTPSSL
SMTPPORT

Configurez SMTP pour qu'Edge puisse envoyer des e-mails pour les mots de passe perdus et d'autres notifications.

Si les identifiants 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.

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-secours Postgres désactivée (par défaut). Pour en savoir plus, consultez Configurer la réplication maître-serveur 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 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 journalisation 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 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 Tester l'installation.
  3. Intégrez votre organisation comme décrit dans Intégrer une organisation.

Vous trouverez ci-dessous 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 sur deux hôtes

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

  1. Installez 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 Tester l'installation.
  4. Intégrez votre organisation comme décrit dans Intégrer une organisation.

Vous trouverez ci-dessous 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 à 5 hôtes

Consultez la section Topologies d'installation pour obtenir la liste des topologies Edge et des numéros 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 Tester l'installation.
  6. Intégrez votre organisation comme décrit dans Intégrer une organisation.

Vous trouverez ci-dessous un fichier de configuration silencieuse 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 à 9 hôtes

Consultez la section Topologies d'installation pour obtenir la liste des topologies Edge et des 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 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. 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 silencieuse 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 sur 13 hôtes

Consultez la section Topologies d'installation pour obtenir la liste des topologies Edge et des 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 OpenLDAP 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 d'Apigee Analytics 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 Tester l'installation.
  8. Intégrez votre organisation comme décrit dans Intégrer une organisation.

Vous trouverez ci-dessous un fichier de configuration silencieuse 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 sur 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 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 "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, 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 votants : 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.

    Pour CASS_HOSTS pour chaque centre de données, veillez à 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 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".
    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 d'amorçage.

    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 Edge et des numéros 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 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 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. 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 silencieuse pour cette topologie. Notez que ce fichier de configuration :

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