Instalowanie komponentów Edge w węźle

Edge for Private Cloud wer. 4.16.09

Po zainstalowaniu w węźle narzędzia Edge apigee-setup zainstaluj w węźle co najmniej 1 komponent Edge za pomocą narzędzia apigee-setup.

Narzędzie apigee-setup korzysta z polecenia w formacie:

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

gdzie component to komponent Edge do zainstalowania, a configFile to dyskretny plik konfiguracji zawierający informacje o instalacji. Plik konfiguracji musi być dostępny i czytelny dla użytkownika „apigee”. Możesz na przykład utworzyć nowy katalog na pliki i umieścić je w katalogu /usr/local lub /usr/local/share albo w dowolnym innym miejscu w węźle dostępnym dla użytkownika „apigee”.

Aby na przykład zainstalować serwer zarządzania brzegowymi:

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

Uwagi o instalacji

Podczas tworzenia pliku konfiguracyjnego weź pod uwagę poniższe opcje.

Konfigurowanie replikacji gotowości instancji głównej Postgres

Domyślnie Edge instaluje wszystkie węzły Postgres w trybie głównym. Jednak w systemach produkcyjnych z wieloma węzłami Postgres trzeba skonfigurować je w taki sposób, aby używały replikacji rezerwowej instancji głównej, aby w przypadku awarii węzła głównego mógł on nadal obsługiwać ruch.

Możesz włączyć i skonfigurować replikację gotowości mastera podczas instalacji, używając właściwości w cichym pliku konfiguracyjnym. Możesz też włączyć replikację gotowości mastera po instalacji. Więcej informacji znajdziesz w artykule o konfigurowaniu funkcji Master-Standby Replication dla Postgres.

Włączam uwierzytelnianie Cassandra

Domyślnie aplikacja Cassandra instaluje się bez włączonego uwierzytelniania. Oznacza to, że każdy może uzyskać dostęp do Cassandra. Uwierzytelnianie możesz włączyć po zainstalowaniu Edge lub podczas instalacji.

Możesz włączyć uwierzytelnianie Cassandra jako czas instalacji, używając właściwości w cichym pliku konfiguracyjnym. Możesz też włączyć ją po instalacji.

Więcej informacji znajdziesz w artykule o włączaniu uwierzytelniania Cassandra.

Wiązanie routera z chronionym portem

Jeśli chcesz powiązać router z zabezpieczonym portem, na przykład z numerami mniejszymi niż 1024, musisz skonfigurować router tak, aby działał jako użytkownik z dostępem do tych portów. Domyślnie router działa jako użytkownik „apigee”, który nie ma dostępu do portów z podwyższonymi uprawnieniami.

Aby uruchomić router jako inny użytkownik:

  1. Jako użytkownik root utwórz plik /opt/apigee/etc/edge-router.d/RUN_USER.sh.
  2. Dodaj do pliku ten wpis:
    RUN_USER=root
    Jeśli nie chcesz uruchamiać routera jako root, określ użytkownika z dostępem do tego portu.
  3. Zapisz plik.
  4. Jeśli wskazano użytkownika innego niż root, zmień właściciela pliku na tego użytkownika:
    > chown USER:USER /opt/apigee/etc/edge-router.d/RUN_USER.sh
  5. Ponownie uruchom router:
    > /opt/apigee/apigee-service/bin/apigee-service Edge-router restart

Wskazywanie komponentów do zainstalowania

W tabeli poniżej znajdziesz opcje przekazywane do opcji -p narzędzia apigee-service w celu określenia, które komponenty mają zostać zainstalowane w węźle:

Komponent

Opis

z

Zainstaluj tylko Cassandra.

zk zainstaluj tylko ZooKeeper.

ds

Zainstaluj ZooKeeper i Cassandra.

ld

Zainstaluj tylko OpenLDAP.

ms

Zainstaluj serwer zarządzania Edge, który instaluje też interfejs Edge i OpenLDAP.

Jeśli w pliku konfiguracyjnym ustawisz wartość USE_LDAP_REMOTE_HOST=y, instalacja OpenLDAP zostanie pominięta, a serwer zarządzania będzie używać katalogu OpenLDAP zainstalowanego w innym węźle.

r

Zainstaluj tylko router brzegowy.

mp

Zainstaluj tylko procesor wiadomości Edge.

RMP

Zainstaluj router brzegowy i procesor wiadomości.

ui

Zainstaluj interfejs Edge.

qs

Zainstaluj tylko serwer Qpid.

ps

Zainstaluj tylko serwer Postgres.

saksofon

Zainstaluj komponenty analityki, czyli Qpid i Postgres.

Tej opcji możesz używać tylko na potrzeby programowania i testowania, a nie wersji produkcyjnej.

miesiąc

Zainstaluj funkcję zarabiania.

sa

Zainstaluj samodzielną wersję Edge, czyli Cassandra, ZooKeeper, Management Server, OpenLDAP, interfejs Edge, Router i procesor wiadomości. Ta opcja powoduje pominięcie komponentów analityki Edge: Qpid i Postgres.

Tej opcji możesz używać tylko na potrzeby programowania i testowania, a nie wersji produkcyjnej.

Aio

Zainstaluj wszystkie komponenty w jednym węźle.

Tej opcji możesz używać tylko na potrzeby programowania i testowania, a nie wersji produkcyjnej.

Tworzenie pliku konfiguracji

Plik konfiguracji zawiera wszystkie informacje niezbędne do zainstalowania Edge. Często można użyć tego samego pliku konfiguracji do zainstalowania wszystkich komponentów w instalacji Edge.

Musisz jednak użyć innych plików konfiguracji lub zmodyfikować plik konfiguracji, jeśli:

  • Instalujesz wiele serwerów OpenLDAP i w ramach instalacji z 13 węzłami musisz skonfigurować replikację. Każdy plik wymaga innych wartości dla LDAP_SID i LDAP_PEER.
  • W ramach instalacji składającej się z 12 węzłów tworzysz wiele centrów danych. Każde centrum danych wymaga innych ustawień dla usług takich jak ZK_CLIENT_HOSTS i CASS_HOSTS.

Przykładowy plik konfiguracji

Poniżej znajdziesz przykład kompletnego cichego pliku konfiguracji dla instalacji Edge z 9 węzłami. Zmodyfikuj ten plik odpowiednio do swojej konfiguracji. Aby dołączyć ten plik, użyj opcji -f do pliku setup.sh. Poniżej znajdziesz też przykładowe pliki konfiguracji dla każdej topologii brzegowej.

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

Tabela poniżej zawiera dodatkowe informacje o tych właściwościach:

Właściwość

Uwaga

Nazwy IP/DNS

Do określania adresu IP węzła nie używaj mapowania nazwy hosta na 127.0.0.1 ani adresu IP 127.0.0.1.

ADMIN_EMAIL
APIGEE_ADMINPW

Hasło administratora systemu musi składać się z co najmniej 8 znaków i zawierać 1 wielką literę, 1 małą literę, 1 cyfrę lub 1 znak specjalny. Jeśli pominiesz hasło, pojawi się prośba o jego podanie.

LICENSE_FILE

Lokalizacja pliku licencji, do której musi mieć dostęp użytkownik „apigee”. Na przykład zapisz go w katalogu /tmp, a kod chmod 777 w pliku. Plik zostanie skopiowany do katalogu instalacji Edge.

USE_LDAP_REMOTE_HOST
LDAP_HOST
LDAP_PORT

Jeśli USE_LDAP_REMOTE_HOST ma wartość n, Edge automatycznie zainstaluje OpenLDAP podczas instalacji serwera zarządzania.

Ustaw wartość USE_LDAP_REMOTE_HOST na y, jeśli łączysz się ze zdalnym serwerem LDAP. OpenLDAP nie jest zainstalowany z serwerem zarządzania.

Jeśli łączysz się ze zdalnym serwerem OpenLDAP, użyj LDAP_HOST
i LDAP_PORT do określenia adresu IP lub nazwy DNS i numeru portu hosta.

LDAP_TYPE
LDAP_SID
LDAP_PEER

Ustaw LDAP_TYPE=1 dla OpenLDAP bez replikacji. LDAP_TYPE=2 odpowiada OpenLDAP z replikacją.

Jeśli topologia Edge używa jednego serwera OpenLDAP, podaj 1. Jeśli instalacja Edge używa wielu węzłów OpenLDAP, na przykład w instalacji produkcyjnej z 13 węzłami, podaj 2.

Jeśli włączysz replikację, ustaw te właściwości:

  • LDAP_SID=1 – unikalny identyfikator tego serwera LDAP. Każdy węzeł LDAP używa innego identyfikatora. Na przykład ustaw wartość 2 w przypadku peera LDAP.
  • LDAP_PEER=10.0.0.1 – nazwa IP lub DNS połączenia peera LDAP.

BIND_ON_ALL_INTERFACES

Jeśli ma wartość „y”, oznacza to powiązanie routera/procesora wiadomości (nasłuchiwanie) wszystkich interfejsów (adresów IP). Jeśli ma wartość „n”, to powiązanie routera/procesora wiadomości (nasłuchiwanie) określonego interfejsu, adres IP zwrócony przez polecenie „nazwa hosta -i”).

MP_POD

Podaj nazwę poda procesora wiadomości i routera. Domyślną nazwą jest brama.

REGION

Nazwa regionu. Zgodnie z konwencją nazwy mają zwykle postać dc-#, gdzie # odpowiada liczbie całkowitej. Na przykład dc-1, dc-2 itp. Możesz używać dc-1, chyba że zainstalujesz oprogramowanie w środowisku z wieloma centrami danych.

W przypadku instalacji z wieloma centrami danych wartość to dc-1 lub dc-2 itd., w zależności od instalowanego centrum danych. Nie ograniczasz się jednak do korzystania z samych nazw w formie dc-#. Regionu możesz użyć dowolnej nazwy.

ZK_HOSTS

Adresy IP lub nazwy DNS węzłów ZooKeeper. Adresy IP lub nazwy DNS muszą być wymienione w tej samej kolejności we wszystkich węzłach ZooKeeper.

W środowisku z wieloma centrami danych wymień wszystkie węzły ZooKeeper z obu centrów danych.

Określ modyfikator „:observer” w węzłach ZooKeeper tylko podczas tworzenia wielu centrów danych w sposób opisany w przypadku instalacji obejmującej 12 hostów. Pomiń ten modyfikator przy pojedynczej instalacji centrum danych. Więcej informacji znajdziesz w artykule o instalacji klastrowej na 12 hostach.

ZK_CLIENT_HOSTS

Adresy IP lub nazwy DNS węzłów ZooKeeper używanych przez to centrum danych. Adresy IP lub nazwy DNS muszą być wymienione w tej samej kolejności we wszystkich węzłach ZooKeeper.

W pojedynczej instalacji centrum danych są to te same węzły, które określono w ZK_HOSTS.

W środowisku z wieloma centrami danych wymień w tym centrum danych tylko węzły ZooKeeper. Więcej informacji znajdziesz w artykule o instalacji klastrowej na 12 hostach.

CASS_HOSTS

Adresy IP (nie nazwy DNS) węzłów Cassandra. Pierwsze 2 węzły będą używane jako serwery wyjściowe. We wszystkich węzłach Cassandra adresy IP muszą być wymienione w tej samej kolejności.

Węzły Cassandra mogą mieć opcjonalny sufiks „:dc,ra”, który określa centrum danych i stojak węzła Cassandra. Określ ten modyfikator tylko podczas tworzenia wielu centrów danych, jak opisano w instalacji z 12 hostami. Pomiń ten modyfikator przy pojedynczej instalacji centrum danych.

Na przykład „192.168.124.201:1,1 = centrum danych 1 i strefa stojaka/dostępności 1 oraz „192.168.124.204:2,1 = centrum danych 2 i strefa stojaka/dostępności 1.

Aby rozwiązać problemy z zaporą sieciową w środowisku z wieloma centrami danych, CASS_HOSTS musi być uporządkowany w taki sposób (jak w przykładzie powyżej), tak aby węzły bieżącego centrum danych były umieszczone na początku. Więcej informacji znajdziesz w artykule o instalacji klastrowej na 12 hostach.

CASS_AUTH
CASS_USERNAME

CASS_PASSWORD

Jeśli włączysz uwierzytelnianie Cassandra (CASS_AUTH=y), umożliwisz przekazywanie nazwy użytkownika i hasła Cassandra, korzystając z tych właściwości.

PG_MASTER

PG_STANDBY

Ustaw, aby włączyć replikację gotowości instancji głównej Postgres w formacie:

PG_MASTER=IPorDNSofNewMaster

PG_STANDBY=IPorDNSofOldMaster

SKIP_SMTP
SMTPHOST
SMTPUSER
SMTPPASSWORD
SMTPSSL
SMTPPORT

Skonfiguruj SMTP, aby przeglądarka Edge mogła wysyłać e-maile w przypadku utraconego hasła i innych powiadomień.

Jeśli dane logowania użytkownika SMTP nie są wymagane, pomiń wartości SMTPUSER i SMTPPASSWORD.

Kolejność instalacji komponentów

Kolejność instalacji komponentów zależy od żądanej topologii.

W poniższym przykładzie instalacji założono, że przeprowadzasz instalację:

  • Z wyłączonym uwierzytelnianiem Cassandra (domyślnie). Więcej informacji znajdziesz w artykule Włączanie uwierzytelniania Cassandra.
  • Z wyłączoną replikacją gotowości do tworzenia instancji głównej Postgres (domyślnie). Więcej informacji znajdziesz w artykule Konfigurowanie replikacji master-Standby dla Postgres.
  • Procesor wiadomości i router w tym samym węźle. Jeśli zainstalujesz procesory wiadomości i routery w różnych węzłach, najpierw zainstaluj wszystkie procesory wiadomości, a następnie wszystkie routery.

Pliki dziennika instalacji

Domyślnie narzędzie setup.sh zapisuje informacje dziennika o instalacji w:

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

Jeśli użytkownik uruchamiający narzędzie setup.sh nie ma dostępu do tego katalogu, zapisuje dziennik w katalogu setup.sh jako plik o nazwie setup.sh.

Jeśli użytkownik nie ma dostępu do pliku /tmp, działanie narzędzia setup.sh nie powiedzie się.

Kompleksowa instalacja

  1. Zainstaluj wszystkie komponenty w jednym węźle, używając polecenia:
    > /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
  2. Przetestuj instalację, wykonując czynności opisane w sekcji Testowanie instalacji.
  3. Zarejestruj organizację w sposób opisany w artykule Rejestrowanie organizacji.

Poniżej znajduje się dyskretny plik konfiguracji tej topologii:

# 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

Instalacja samodzielna na 2 hostach

Listę topologii brzegowych i numerów węzłów znajdziesz w sekcji Topologie instalacji.

  1. Zainstaluj samodzielną bramę i węzeł 1
    > /opt/apigee/apigee-setup/bin/setup.sh -p sa -f configFile
  2. Zainstaluj Analytics w węźle 2:
    > /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile
  3. Przetestuj instalację, wykonując czynności opisane w sekcji Testowanie instalacji.
  4. Zarejestruj organizację w sposób opisany w artykule Rejestrowanie organizacji.

Poniżej znajduje się dyskretny plik konfiguracji tej topologii:

# 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

Instalacja klastrowa z 5 hostami

Listę topologii brzegowych i numerów węzłów znajdziesz w sekcji Topologie instalacji.

  1. Zainstaluj klaster Datastore w węzłach 1, 2 i 3:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Zainstaluj serwer zarządzania w węźle 1:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. Zainstaluj router i procesor wiadomości w węzłach 2 i 3:
    > /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. Zainstaluj Analytics w węzłach 4 i 5:
    > /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile
  5. Przetestuj instalację, wykonując czynności opisane w sekcji Testowanie instalacji.
  6. Zarejestruj organizację w sposób opisany w artykule Rejestrowanie organizacji.

Poniżej znajduje się dyskretny plik konfiguracji tej topologii:

# 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

Instalacja klastrowa z 9 hostami

Listę topologii brzegowych i numerów węzłów znajdziesz w sekcji Topologie instalacji.

  1. Zainstaluj węzeł klastra Datastore w węzłach 1, 2 i 3:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Zainstaluj serwer Apigee Management Server w węźle 1:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. Zainstaluj router i procesor wiadomości w węzłach 4 i 5:
    > /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. Zainstaluj serwer Apigee Analytics Qpid w węzłach 6 i 7:
    > /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. Zainstaluj serwer Apigee Analytics Postgres w węzłach 8 i 9:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. Przetestuj instalację, wykonując czynności opisane w sekcji Testowanie instalacji.
  7. Zarejestruj organizację w sposób opisany w artykule Rejestrowanie organizacji.

Poniżej znajduje się dyskretny plik konfiguracji tej topologii:

# 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

Instalacja klastrowa z 13 hostami

Listę topologii brzegowych i numerów węzłów znajdziesz w sekcji Topologie instalacji.

  1. Zainstaluj węzeł klastra Datastore w węzłach 1, 2 i 3:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Zainstaluj OpenLDAP w węzłach 4 i 5:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ld -f configFile
  3. Zainstaluj serwer Apigee Management Server w węzłach 6 i 7:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  4. Zainstaluj serwer Apigee Analytics Postgres w węzłach 8 i 9:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  5. Zainstaluj router i procesor wiadomości w węzłach 10 i 11:
    > /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  6. Zainstaluj serwer Qpid Apigee Analytics w węzłach 12 i 13:
    > /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  7. Przetestuj instalację, wykonując czynności opisane w sekcji Testowanie instalacji.
  8. Zarejestruj organizację w sposób opisany w artykule Rejestrowanie organizacji.

Poniżej znajduje się dyskretny plik konfiguracji tej topologii:

# 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 

Instalacja klastrowa z 12 hostami

Zanim zainstalujesz Edge w topologii klastrowanej a12 (dwóch centrów danych), musisz wiedzieć, jak ustawić właściwości ZooKeeper i Cassandra w pliku konfiguracji cichego pliku.

  • ZooKeeper

    W przypadku właściwości ZK_HOSTS obu centrów danych podaj adresy IP lub nazwy DNS wszystkich węzłów ZooKeeper z obu centrów danych w tej samej kolejności oraz oznacz wszystkie węzły modyfikatorem „:observer”. Węzły bez modyfikatora „:observer” są nazywane „głosami”. W konfiguracji musisz mieć nieparzystą liczbę „głosów”.

    W tej topologii host ZooKeeper na hoście 9 jest obserwatorem:

    W przypadku właściwości ZK_CLIENT_HOSTS dla każdego centrum danych podaj adresy IP lub nazwy DNS tylko węzłów ZooKeeper w centrum danych, w tej samej kolejności, dla wszystkich węzłów ZooKeeper w centrum danych. W przykładowym pliku konfiguracji pokazanym poniżej węzeł 9 jest oznaczony modyfikatorem „:observer”, aby mieć 5 głosów: węzły 1, 2, 3, 7 i 8.
  • Cassandra
    Wszystkie centra danych muszą mieć taką samą liczbę węzłów Cassandra.

    W przypadku CASS_HOSTS dla każdego centrum danych sprawdź, czy są określone wszystkie adresy IP Cassandra (a nie nazwy DNS) obu centrów danych. W przypadku centrum danych 1 najpierw wymień węzły Cassandra w tym centrum danych. W przypadku centrum danych 2 najpierw wymień węzły Cassandra w tym centrum danych. Wyświetl węzły Cassandra w tej samej kolejności dla wszystkich węzłów Cassandra w centrum danych.

    Wszystkie węzły Cassandra muszą mieć sufiks „:<d>,<r>”, np. „<ip>:1,1 = centrum danych 1 i strefa stojaka/dostępności 1 oraz „<ip>:2,1 = centrum danych 2 i strefa stojaka/dostępności 1”.
    Na przykład: „192.168.124.201:1,1 192.168.124.202:1,1 192.168.124.203:1,1 192.168.124.204.201:1,1 192.168.124.202:1,1 192.168.124.203:1,1 192.168.124.204.201



    W tym modelu wdrożenia konfiguracja Cassandra będzie wyglądać tak:

Listę topologii brzegowych i numerów węzłów znajdziesz w sekcji Topologie instalacji.

  1. Zainstaluj węzeł klastra Datastore w węzłach 1, 2, 3, 7, 8 i 9:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Zainstaluj serwer Apigee Management Server z replikacją OpenLDAP w węzłach 1 i 7:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. Zainstaluj router i procesor wiadomości w węzłach 2, 3, 8 i 9:
    > /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. Zainstaluj serwer Apigee Analytics Qpid w węzłach 4, 5, 10 i 11:
    > /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. Zainstaluj serwer Apigee Analytics Postgres w węzłach 6 i 12:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. Przetestuj instalację, wykonując czynności opisane w sekcji Testowanie instalacji.
  7. Zarejestruj organizację w sposób opisany w artykule Rejestrowanie organizacji.

Poniżej pokazano dyskretny plik konfiguracji tej topologii. Zwróć uwagę na ten plik konfiguracyjny:

  • Konfiguruje protokół OpenLDAP z replikacją w 2 węzłach OpenLDAP.
  • Określa modyfikator „:observer” w jednym węźle ZooKeeper. Pomiń ten modyfikator przy pojedynczej instalacji centrum danych.
# 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