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 configFileoù 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/myConfigRemarques 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 :
- En tant qu'utilisateur racine, créez le fichier /opt/apigee/etc/edge-router.d/RUN_USER.sh.
- 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. - Enregistrez le fichier.
- 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 - 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 |
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 |
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 |
|
LDAP_TYPE |
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 :
|
|
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_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 |
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
- 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 - Testez l'installation comme décrit dans Tester l'installation.
- 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.
- Installez la passerelle autonome et le nœud 1
> /opt/apigee/apigee-setup/bin/setup.sh -p sa -f configFile - Installez Analytics sur le nœud 2 :
> /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile - Testez l'installation comme décrit dans Tester l'installation.
- 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.
- Installez le cluster Datastore sur les nœuds 1, 2 et 3 :
> /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile - Installez Management Server sur le nœud 1 :
> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile - 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 - Installez Analytics sur les nœuds 4 et 5 :
> /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile - Testez l'installation comme décrit dans Tester l'installation.
- 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.
- 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 - Installez le serveur de gestion Apigee sur le nœud 1 :
> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile - 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 - Installez le serveur Qpid Apigee Analytics sur les nœuds 6 et 7 :
> /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile - Installez le serveur Postgres Apigee Analytics sur les nœuds 8 et 9 :
> /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile - Testez l'installation comme décrit dans Tester l'installation.
- 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.
- 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 - Installez OpenLDAP sur les nœuds 4 et 5 :
> /opt/apigee/apigee-setup/bin/setup.sh -p ld -f configFile - Installez le serveur de gestion Apigee sur les nœuds 6 et 7 :
> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile - Installez le serveur Postgres Apigee Analytics sur les nœuds 8 et 9 :
> /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile - 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 - 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 - Testez l'installation comme décrit dans Tester l'installation.
- 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.
- 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 - 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 - 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 - 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 - Installez le serveur Postgres Apigee Analytics sur les nœuds 6 et 12 :
> /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile - Testez l'installation comme décrit dans Tester l'installation.
- 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 |