Aktualizacja Apigee Edge od 4.16.09 do 4.17.01

Edge dla chmury prywatnej w wersji 4.17.01

Które wersje Edge można zaktualizować do wersji 4.17.01?

Za pomocą tej procedury możesz zaktualizować Apigee Edge w wersji 4.16.09.0x do wersji 4.17.01.

Jeśli masz wersję Edge starszą niż 4.16.01, musisz najpierw przejść na wersję 4.16.01.x, a następnie zaktualizować ją do wersji 4.17.01.

Kto może przeprowadzić aktualizację

Użytkownik, który przeprowadza aktualizację, powinien być tym samym użytkownikiem, który pierwotnie zainstalował Edge, lub użytkownikiem z uprawnieniami administratora.

Po zainstalowaniu pakietów RPM Edge każdy użytkownik może je skonfigurować.

Które komponenty musisz zaktualizować

Musisz zaktualizować wszystkie komponenty Edge. Edge nie obsługuje konfiguracji zawierającej komponenty z wielu wersji.

Wymagane uaktualnienie do Qpid 1.35

Ta wersja zawiera wymaganą aktualizację do Qpid 1.35. W ramach aktualizacji węzła Qpid musisz:

  • tymczasowo uniemożliwić routerom i procesorom komunikatów zapisywanie w węźle Qpid przez zablokowanie portu 5672 w węźle Qpid; Aby zablokować ten port w węźle Qpid, możesz użyć tego polecenia:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  • Poczekaj, aż kolejka Qpid zostanie opróżniona z wiadomości, aby mieć pewność, że węzeł Qpid przetworzył wszystkie wiadomości przed aktualizacją. Aby upewnić się, że kolejka wiadomości Qpid jest pusta, użyj tego polecenia:
    > qpid-stat -q
  • Zaktualizuj węzeł Qpid.
  • Odblokuj port 5672 w węźle Qpid, aby umożliwić dostęp z routerów i procesorów komunikatów. Aby odblokować ten port, możesz użyć tego polecenia:
    > sudo iptables -F

    Jeśli używasz iptables do innych reguł, możesz użyć opcji -D, aby cofnąć konkretną zmianę:
    > sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP

Ten proces jest szczegółowo opisany poniżej dla każdej topologii Edge.

Wymagane do włączenia repozytorium EPEL

Aby zainstalować lub zaktualizować Edge, musisz włączyć Extra Packages for Enterprise Linux (EPEL). Polecenie, którego użyjesz, zależy od wersji RedHat/CentOS:

  • RedHat/CentOS 7.x:
    > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm
  • RedHat/CentOS 6.x:
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

Wymagane w przypadku aktualizacji przy użyciu uwierzytelniania zewnętrznego

Możesz zintegrować zewnętrzną usługę katalogową z istniejącą instalacją Apigee Edge Private Cloud. Ta funkcja została zaprojektowana do współpracy z dowolną usługą katalogową obsługującą protokół LDAP, taką jak Active Directory, OpenLDAP i inne. Zewnętrzne rozwiązanie LDAP umożliwia administratorom systemu zarządzanie danymi logowania użytkowników z poziomu scentralizowanej usługi zarządzania katalogami, która jest zewnętrzna w stosunku do systemów takich jak Apigee Edge, które z nich korzystają.

Więcej informacji znajdziesz w artykule Konfiguracja uwierzytelniania zewnętrznego.

Gdy uwierzytelnianie zewnętrzne jest włączone, większość klientów używa pola nazwy konta SAM Active Directory jako nazwy użytkownika do uwierzytelniania, zamiast adresu e-mail, który jest używany przez serwer Edge OpenLDAP.

Jeśli masz integrację z zewnętrzną usługą katalogową, podczas aktualizowania Edge do wersji 4.17.01 dodaj do pliku konfiguracji ten wiersz:

IS_EXTERNAL_AUTH="true"

Ten wiersz konfiguruje Edge tak, aby obsługiwał nazwę konta, a nie adres e-mail, jako nazwę użytkownika.

Automatyczne rozpowszechnianie ustawień usługi

Jeśli ustawiono jakieś właściwości przez edycję plików .properties w /opt/apigee/customer/application, te wartości zostaną zachowane podczas aktualizacji.

Wymagania wstępne dotyczące aktualizacji

Przed uaktualnieniem Apigee Edge spełnij te wymagania wstępne:

  • Utwórz kopię zapasową wszystkich węzłów
    Przed aktualizacją zalecamy ze względów bezpieczeństwa utworzenie pełnej kopii zapasowej wszystkich węzłów. Aby wykonać kopię zapasową, postępuj zgodnie z procedurą dla bieżącej wersji Edge.

    Dzięki temu będziesz mieć plan awaryjny na wypadek, gdyby aktualizacja do nowej wersji nie działała prawidłowo. Więcej informacji o kopiach zapasowych znajdziesz w artykule Tworzenie i przywracanie kopii zapasowych.
  • Upewnij się, że Edge działa
    Upewnij się, że Edge działa podczas procesu aktualizacji, używając polecenia:

    > /opt/apigee/apigee-service/bin/apigee-all status

Postępowanie w przypadku nieudanej aktualizacji

Jeśli aktualizacja się nie powiedzie, możesz spróbować rozwiązać problem, a następnie ponownie uruchomić skrypt update.sh. Możesz uruchomić aktualizację wielokrotnie, a będzie ona kontynuowana od miejsca, w którym została przerwana.

Jeśli błąd wymaga przywrócenia poprzedniej wersji, zapoznaj się z artykułem 4.17.01 Proces przywracania.

Rejestrowanie informacji o aktualizacji

Domyślnie narzędzie update.sh zapisuje informacje dziennika w:

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

Jeśli użytkownik, który uruchamia narzędzie update.sh, nie ma dostępu do tego katalogu, dziennik jest zapisywany w katalogu /tmp jako plik o nazwie update_username.log.

Jeśli użytkownik nie ma dostępu do katalogu /tmp, narzędzie update.sh nie zadziała.

Aktualizacja bez przestojów

Aktualizacja bez przestojów, czyli aktualizacja krocząca, umożliwia aktualizację instalacji Edge bez wyłączania Edge.

Aktualizacja bez przestojów jest możliwa tylko w przypadku konfiguracji z co najmniej 5 węzłami.

Kluczem do uaktualnienia bez przestojów jest usuwanie z systemu równoważenia obciążenia po jednym routerze naraz. Następnie zaktualizuj router i inne komponenty na tej samej maszynie co router, a potem dodaj router z powrotem do systemu równoważenia obciążenia.

  1. Zaktualizuj maszyny w odpowiedniej kolejności, zgodnie z opisem w sekcji „Kolejność aktualizacji maszyn” poniżej.
  2. Gdy nadejdzie czas aktualizacji routerów, wybierz dowolny router i ustaw go jako nieosiągalny, jak opisano w artykule Włączanie i wyłączanie osiągalności serwera (procesora komunikatów lub routera).
  3. Zaktualizuj wybrany router i wszystkie inne komponenty Edge na tym samym komputerze co router. Wszystkie konfiguracje Edge pokazują router i procesor komunikatów w tym samym węźle.
  4. Spraw, aby router był ponownie dostępny.
  5. Powtórz kroki od 2 do 4 w przypadku pozostałych routerów.
  6. Kontynuuj aktualizację pozostałych maszyn w instalacji.

Przed aktualizacją lub po niej wykonaj te czynności:

  • Na węźle połączonego routera i procesora komunikatów:
    • Przed aktualizacją wykonaj te czynności:
      1. Ustaw router jako niedostępny.
      2. Spraw, aby procesor komunikatów był nieosiągalny.
    • Po aktualizacji wykonaj te czynności:
      1. Udostępnij procesor komunikatów.
      2. Ustaw router jako dostępny.
  • Na pojedynczym węźle routera:
    • Przed aktualizacją upewnij się, że router jest niedostępny.
    • Po aktualizacji upewnij się, że router jest dostępny.
  • Na pojedynczym węźle procesora komunikatów:
    • Przed aktualizacją ustaw procesor komunikatów jako nieosiągalny.
    • Po aktualizacji udostępnij procesor komunikatów.

Używanie pliku konfiguracji instalacji dyskretnej

Do polecenia aktualizacji musisz przekazać plik konfiguracji instalacji dyskretnej. Plik konfiguracji instalacji dyskretnej powinien być taki sam jak ten, który został użyty do zainstalowania Edge 4.16.01 lub 4.16.05.

Procedura aktualizacji do wersji 4.17.01 na węźle z zewnętrznym połączeniem internetowym

Aby zaktualizować komponenty Edge na węźle, wykonaj te czynności:

  1. Jeśli istnieją zadania CRON skonfigurowane do wykonywania operacji naprawy w Cassandra, wyłącz je do czasu zakończenia aktualizacji.
  2. Zaloguj się w węźle jako użytkownik root, aby zainstalować pakiety RPM Edge.
    Uwaga: instalacja RPM wymaga dostępu do konta root, ale konfigurację Edge można przeprowadzić bez niego.
  3. Wyłącz SELinux zgodnie z opisem w artykule Instalowanie narzędzia apigee-setup w Edge.
  4. Pobierz plik bootstrap_4.17.01.sh Edge 4.17.01 do /tmp/bootstrap_4.17.01.sh:
    > curl https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
  5. Zainstaluj narzędzie apigee-service Edge 4.17.01 i zależności:
    > sudo bash /tmp/bootstrap_4.17.01.sh apigeeuser=uName apigeepassword=pWord

    gdzie uName:pWord to nazwa użytkownika i hasło otrzymane od Apigee. Jeśli pominiesz parametr pWord, pojawi się prośba o jego podanie.

    Domyślnie instalator sprawdza, czy masz zainstalowaną Javę 1.8. Jeśli nie, zainstaluje ją za Ciebie. Aby określić, jak ma być obsługiwana instalacja Javy, użyj opcji JAVA_FIX. JAVA_FIX przyjmuje te wartości:

    I = zainstaluj OpenJDK 1.8 (domyślnie)
    C = kontynuuj bez instalowania Javy
    Q = zamknij. W przypadku tej opcji musisz samodzielnie zainstalować Javę.
  6. (tylko CentOS-6.x i RedHat-6.x) Na wszystkich węzłach Qpid uruchom to polecenie, aby pobrać prawidłową wersję Qpid:
    > yum install apigee-qpidd --disablerepo=epel
  7. Użyj apigee-service, aby zaktualizować narzędzie apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  8. Zaktualizuj narzędzie apigee-validate na serwerze zarządzania:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  9. Zaktualizuj narzędzie apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  10. Uruchom narzędzie do aktualizacji na węzłach w kolejności opisanej poniżej w sekcji „Kolejność aktualizacji maszyn”:
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    Jedynym wymaganiem dotyczącym pliku konfiguracji jest to, że musi on być dostępny lub możliwy do odczytania przez użytkownika „apigee”.

    Użyj opcji „-c”, aby określić komponent do zaktualizowania. Lista możliwych komponentów obejmuje:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =wszystkie komponenty Edge oprócz interfejsu Edge: serwer zarządzania, procesor komunikatów, router, serwer QPID, serwer Postgres
    ui = interfejs Edge
    all = aktualizacja wszystkich komponentów na komputerze (używaj tylko w przypadku profilu instalacji Edge aio lub profilu instalacji API BaaS asa)
    e = ElasticSearch
    b = stos API BaaS
    p = portal API BaaS
    ebp = ElasticSearch, stos API BaaS i portal API BaaS w tym samym węźle
  11. Przetestuj aktualizację, uruchamiając narzędzie apigee-validate na serwerze zarządzania, zgodnie z opisem w sekcji Testowanie instalacji.

Aby później wycofać aktualizację, wykonaj procedurę opisaną w sekcji 4.16.09 Proces wycofywania.

Procedura aktualizacji do wersji 4.17.01 z lokalnego repozytorium

Jeśli węzły Edge znajdują się za zaporą sieciową lub w inny sposób nie mają dostępu do repozytorium Apigee przez internet, możesz przeprowadzić aktualizację z lokalnego repozytorium lub kopii lustrzanej repozytorium Apigee.

Po utworzeniu lokalnego repozytorium Edge masz 2 opcje aktualizowania Edge z lokalnego repozytorium:

  • Utwórz plik .tar repozytorium, skopiuj go do węzła, a następnie zaktualizuj Edge z pliku .tar.
  • Zainstaluj serwer WWW w węźle z lokalnym repozytorium, aby inne węzły miały do niego dostęp. Apigee udostępnia serwer WWW Nginx, ale możesz też użyć własnego serwera WWW.

Aby zaktualizować z lokalnego repozytorium 4.17.01:

  1. Utwórz lokalne repozytorium 4.17.01 zgodnie z opisem w sekcji „Tworzenie lokalnego repozytorium Apigee” w artykule Instalowanie narzędzia Edge apigee-setup.
    Uwaga: jeśli masz już repozytorium 4.16.09, możesz dodać do niego repozytorium 4.17.01 zgodnie z opisem w sekcji „Aktualizowanie lokalnego repozytorium Apigee” w artykule Instalowanie narzędzia apigee-setup w Edge.
  2. Aby zainstalować apigee-service z pliku .tar:
    1. Na węźle z lokalnym repozytorium użyj tego polecenia, aby spakować lokalne repozytorium do pojedynczego pliku .tar o nazwie /opt/apigee/data/apigee-mirror/apigee-4.17.01.tar.gz:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. Skopiuj plik .tar do węzła, w którym chcesz zaktualizować Edge. Możesz go na przykład skopiować do katalogu /tmp w nowym węźle.
    3. W nowym węźle rozpakuj plik do katalogu /tmp:
      > tar -xzf apigee-4.17.01.tar.gz

      To polecenie tworzy nowy katalog o nazwie repos w katalogu zawierającym plik .tar. Na przykład /tmp/repos.
    4. Zainstaluj narzędzie Edge apigee-service i zależności z katalogu /tmp/repos:
      > sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Zwróć uwagę, że w tym poleceniu podajesz ścieżkę do katalogu repos.
  3. Aby zainstalować apigee-service przy użyciu serwera WWW Nginx:
    1. Skonfiguruj serwer WWW Nginx zgodnie z opisem w sekcji „Instalowanie z repozytorium przy użyciu serwera WWW Nginx” w artykule Instalowanie narzędzia apigee-setup Edge.
    2. Na węźle zdalnym pobierz plik Edge bootstrap_4.17.01.sh do /tmp/bootstrap_4.17.01.sh:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh

      gdzie uName:pWord to nazwa użytkownika i hasło ustawione powyżej dla repozytorium, a remoteRepo to adres IP lub nazwa DNS węzła repozytorium.
    3. Na węźle zdalnym zainstaluj narzędzie Edge apigee-service i zależności:
      > sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      gdzie uName:pWord to nazwa użytkownika i hasło repozytorium.
  4. Użyj apigee-service, aby zaktualizować narzędzie apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. Zaktualizuj narzędzie apigee-validate na serwerze zarządzania.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. Zaktualizuj narzędzie apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. Uruchom narzędzie do aktualizacji na węzłach w kolejności opisanej poniżej w sekcji „Kolejność aktualizacji maszyn”:
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    Jedynym wymaganiem dotyczącym pliku konfiguracji jest to, że musi on być dostępny lub możliwy do odczytania przez użytkownika „apigee”.

    Użyj opcji „-c”, aby określić komponent do zaktualizowania. Lista możliwych komponentów obejmuje:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =wszystkie komponenty Edge oprócz interfejsu Edge: serwer zarządzania, procesor komunikatów, router, serwer QPID, serwer Postgres
    ui = interfejs Edge
    all = aktualizacja wszystkich komponentów na komputerze (używaj tylko w przypadku profilu instalacji Edge aio lub profilu instalacji API BaaS asa)
    e = ElasticSearch
    b = stos API BaaS
    p = portal API BaaS
    ebp = ElasticSearch, stos API BaaS i portal API BaaS w tym samym węźle
  8. Przetestuj aktualizację, uruchamiając narzędzie apigee-validate na serwerze zarządzania, zgodnie z opisem w sekcji Testowanie instalacji.

Aby później wycofać aktualizację, wykonaj procedurę opisaną w sekcji 4.16.09 Proces wycofywania.

Kolejność aktualizacji maszyn

Kolejność aktualizowania maszyn w instalacji Edge jest ważna. Najważniejsze kwestie, które należy wziąć pod uwagę podczas aktualizacji:

  • Zanim zaktualizujesz inne węzły, musisz zaktualizować wszystkie węzły Cassandra i ZooKeeper.
  • W przypadku każdej maszyny z wieloma komponentami Edge (serwer zarządzania, procesor komunikatów, router, serwer QPID, ale nie serwer Postgres) użyj opcji „-c edge”, aby zaktualizować je wszystkie jednocześnie.
  • Jeśli dany krok ma zostać wykonany na wielu maszynach, wykonaj go w określonej kolejności maszyn.
  • Nie ma osobnego kroku do aktualizacji zarabiania. Jest aktualizowany, gdy określisz opcję „-c edge”.
  • (tylko CentOS-6.x i RedHat-6.x) Na wszystkich węzłach Qpid z zewnętrznym połączeniem internetowym upewnij się, że zostało uruchomione poniższe polecenie, aby pobrać prawidłową wersję Qpid, jak pokazano powyżej:
    > yum install apigee-qpidd --disablerepo=epel

W przypadku samodzielnej instalacji na 1 hoście

  1. Zaktualizuj Cassandrę i ZooKeepera:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Ustaw tę regułę iptables:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  3. Sprawdź kolejkę wiadomości Qpid:
    > qpid-stat -q

    Sprawdzaj kolejkę, aż liczba w kolumnie „msg” będzie wynosić 0. Nie możesz uaktualnić Qpid, dopóki nie przetworzy wszystkich wiadomości.
  4. Zaktualizuj qpidd:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Wyczyść iptables:
    > sudo iptables -F
  6. Zaktualizuj postgresql:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  7. Uruchom postgresql:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  8. Zaktualizuj LDAP:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  9. Zaktualizuj pozostałe komponenty Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Zaktualizuj interfejs Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

W przypadku samodzielnej instalacji z 2 hostami

Listę topologii Edge i liczbę węzłów znajdziesz w artykule Topologie instalacji.

  1. Zaktualizuj Cassandrę i ZooKeepera na maszynie 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Ustaw na maszynie 2 tę regułę iptables:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  3. Sprawdź kolejkę komunikatów Qpid na komputerze 2:
    > qpid-stat -q

    Sprawdzaj kolejkę, aż liczba w kolumnie „msg” będzie wynosić 0. Nie możesz uaktualnić Qpid, dopóki nie przetworzy wszystkich wiadomości.
  4. Zaktualizuj qpidd na komputerze 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Wyczyść tabele iptables na maszynie 2:
    > sudo iptables -F
  6. Zaktualizuj postgresql na komputerze 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  7. Uruchom postgresql na komputerze 2:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  8. Zaktualizuj LDAP na komputerze 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  9. Zaktualizuj komponenty Edge na maszynach 2 i 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Zaktualizuj interfejs na komputerze 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

W przypadku instalacji klastrowej z 5 hostami

Listę topologii Edge i liczbę węzłów znajdziesz w artykule Topologie instalacji.

  1. Zaktualizuj Cassandrę i ZooKeepera na maszynach 1, 2 i 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Ustaw tę regułę iptables na maszynie 4:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  3. Sprawdź kolejkę komunikatów Qpid na komputerze 4:
    > qpid-stat -q

    Sprawdzaj kolejkę, aż liczba w kolumnie „msg” będzie wynosić 0. Nie możesz uaktualnić Qpid, dopóki nie przetworzy wszystkich wiadomości.
  4. Zaktualizuj qpidd na maszynie 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Wyczyść tabele iptables na maszynie 4:
    > sudo iptables -F
  6. Powtórz kroki od 2 do 5 na maszynie 5.
  7. Aktualizacja postgresql na maszynie 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -fconfigFile
  8. Uruchom postgresql na maszynie 4:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  9. Powtórz kroki 7 i 8 na komputerze 5.
  10. Zaktualizuj LDAP na komputerze 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. Zaktualizuj komponenty Edge na maszynach 4, 5, 1, 2, 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. Zaktualizuj interfejs na komputerze 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

W przypadku instalacji klastrowej z 9 hostami

Listę topologii Edge i liczbę węzłów znajdziesz w artykule Topologie instalacji.

  1. Zaktualizuj Cassandrę i ZooKeepera na maszynach 1, 2 i 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Ustaw tę regułę iptables na maszynie 6:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  3. Sprawdź kolejkę komunikatów Qpid na maszynie 6:
    > qpid-stat -q

    Sprawdzaj kolejkę, aż liczba w kolumnie „msg” będzie wynosić 0. Nie możesz uaktualnić Qpid, dopóki nie przetworzy wszystkich wiadomości.
  4. Zaktualizuj qpidd na maszynie 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Wyczyść tabele iptables na maszynie 6:
    > sudo iptables -F
  6. Powtórz kroki od 2 do 5 na maszynie 7.
  7. Zaktualizuj postgresql na maszynie 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  8. Uruchom postgresql na komputerze 6:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  9. Powtórz kroki 7 i 8 na maszynie 7.
  10. Zaktualizuj LDAP na komputerze 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. Zaktualizuj komponenty Edge na maszynach 6, 7, 8, 9, 1, 4 i 5 w tej kolejności:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. Zaktualizuj interfejs na komputerze 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

W przypadku instalacji klastrowej z 13 hostami

Listę topologii Edge i liczbę węzłów znajdziesz w artykule Topologie instalacji.

  1. Zaktualizuj Cassandrę i ZooKeepera na maszynach 1, 2 i 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Ustaw tę regułę iptables na maszynie 12:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  3. Sprawdź kolejkę wiadomości Qpid na komputerze 12:
    > qpid-stat -q

    Sprawdzaj kolejkę, aż liczba w kolumnie „msg” będzie wynosić 0. Nie możesz uaktualnić Qpid, dopóki nie przetworzy wszystkich wiadomości.
  4. Aktualizowanie qpidd na komputerze 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. Wyczyść iptables na maszynie 12:
    > sudo iptables -F
  6. Powtórz kroki od 2 do 5 na maszynie 13.
  7. Zaktualizuj postgresql na komputerze 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  8. Uruchom postgresql na maszynie 12:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  9. Powtórz kroki 7 i 8 na maszynie 13.
  10. Zaktualizuj LDAP na komputerach 4 i 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. Zaktualizuj komponenty Edge na maszynach 12, 13, 8, 9, 6, 7, 10 i 11 w tej kolejności:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. Zaktualizuj interfejs na maszynach 6 i 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

W przypadku instalacji klastrowej z 12 hostami

Listę topologii Edge i liczbę węzłów znajdziesz w artykule Topologie instalacji.

  1. Zaktualizuj Cassandrę i ZooKeepera:
    1. Na komputerach 1, 2 i 3 w centrum danych 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. Na maszynach 7, 8 i 9 w centrum danych 2:
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Zaktualizuj qpidd:
    1. Maszyny 4 i 5 w centrum danych 1
      1. Ustaw tę regułę iptables na maszynie 4:
        > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
      2. Sprawdź kolejkę komunikatów Qpid na komputerze 4:
        > qpid-stat -q

        Sprawdzaj kolejkę, aż liczba w kolumnie „msg” będzie wynosić 0. Nie możesz uaktualnić Qpid, dopóki nie przetworzy wszystkich wiadomości.
      3. Zaktualizuj qpidd na komputerze 4:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. Wyczyść tabele iptables na maszynie 4:
        > sudo iptables -F
      5. Powtórz kroki od 1 do 4 na komputerze 5.
    2. Maszyny 10 i 11 w centrum danych 2
      1. Ustaw tę regułę iptables na maszynie 10:
        > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
      2. Sprawdź kolejkę komunikatów Qpid na komputerze 10:
        > qpid-stat -q

        Sprawdzaj kolejkę, aż liczba w kolumnie „msg” będzie wynosić 0. Nie możesz uaktualnić Qpid, dopóki nie przetworzy wszystkich wiadomości.
      3. Zaktualizuj qpidd na komputerze 10:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. Wyczyść tabele iptables na maszynie 10:
        > sudo iptables -F
      5. Powtórz kroki od 1 do 4 na komputerze 11.
  3. Zaktualizuj postgresql:
    1. Maszyna 6 w centrum danych 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
    2. Maszyny 12 w centrum danych 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  4. Zaktualizuj LDAP:
    1. Maszyny 1 w centrum danych 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. Maszyny 7 w centrum danych 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Zaktualizuj komponenty Edge:
    1. Maszyny 4, 5, 6, 1, 2, 3 w centrum danych 1
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. Maszyny 10, 11, 12, 7, 8, 9 w centrum danych 2
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Zaktualizuj interfejs:
    1. Komputer 1 w centrum danych 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    2. Komputer 7 w centrum danych 2:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Instalacja API BaaS na 7 hostach

Przed uruchomieniem procedury uaktualniania musisz dodać do pliku konfiguracji 2 nowe właściwości:

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

Przykładowy pełny plik konfiguracji znajdziesz w artykule Instalacja API BaaS.

Musisz też upewnić się, że port 2551 jest otwarty na wszystkich węzłach Stack, aby umożliwić dostęp ze wszystkich innych węzłów Stack.

Listę topologii Edge i liczbę węzłów znajdziesz w artykule Topologie instalacji.

  1. Zaktualizuj Cassandrę na maszynach 5, 6 i 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. Zaktualizuj ElasticSearch i stos API BaaS na maszynach 1, 2 i 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile

  3. Zaktualizuj portal API BaaS na komputerze 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

W przypadku instalacji API BaaS na 10 hostach

Przed uruchomieniem procedury uaktualniania musisz dodać do pliku konfiguracji 2 nowe właściwości:

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

Przykładowy pełny plik konfiguracji znajdziesz w artykule Instalacja API BaaS.

Musisz też upewnić się, że port 2551 jest otwarty na wszystkich węzłach Stack, aby umożliwić dostęp ze wszystkich innych węzłów Stack.

Listę topologii Edge i liczbę węzłów znajdziesz w artykule Topologie instalacji.

  1. Zaktualizuj Cassandrę na maszynach 8, 9 i 10:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. Zaktualizuj ElasticSearch na maszynach 1, 2 i 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  3. Zaktualizuj stos API BaaS na maszynach 4, 5 i 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  4. Zaktualizuj portal API BaaS na komputerze 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Instalacja niestandardowa

Jeśli masz instalację niestandardową, zaktualizuj komponenty Edge w tej kolejności:

  1. ZooKeeper
  2. Cassandra
  3. qpidd, ps
  4. LDAP
  5. Edge, czyli profil „-c edge” na wszystkich węzłach w kolejności: węzły z serwerem Qpid, serwerem Postgres, serwerem zarządzania, procesorem komunikatów i routerem.
    Uwaga: jeśli na węźle zainstalowano zarówno serwer Qpid, jak i Postgres, wykonaj krok profilu „-c edge”.
  6. Interfejs Edge