Wycofywanie Apigee Edge 4.52.02

Jeśli podczas aktualizowania do wersji Edge 4.52.02 wystąpi błąd, możesz przywrócić który spowodował błąd, a następnie spróbuj ponownie przeprowadzić aktualizację.

Możesz przywrócić Edge 4.52.02 do tych głównych wersji:

  • Wersja 4.52.01
  • Wersja 4.52.00
  • Wersja 4.51.00

Wycofanie wersji obejmuje wycofanie wszystkich komponentów, które mogły zostać uaktualnione. Poza tym, w zależności od tego, od której wersji pochodzisz, przed przywróceniem niektórych komponentów oprogramowania musisz wziąć pod uwagę specjalne kwestie. W tabeli poniżej znajdziesz listę różnych programów, w przypadku których mogą być wymagane specjalne czynności podczas przywracania wcześniejszej wersji:

Przywróć wersję Szczególne uwagi w przypadku oprogramowania
4.52.01 Cassandra
4.52.00 Cassandra, Zookeeper, Qpid
4.51.00 Cassandra, Zookeeper, Qpid, Postgres

Istnieją 2 sytuacje, w których możesz chcieć przywrócić poprzednią wersję aplikacji:

  1. Przywracanie poprzedniej wersji głównej lub podrzędnej Na przykład z od 4.52.02 do 4.52.00.
  2. Przywróć poprzednią wersję poprawki wersji. Na przykład od 4.52.00.02 do 4.52.00.01.

Więcej informacji znajdziesz w artykule o wersji Apigee Edge .

Kolejność przywracania

Przywracanie komponentów należy wykonywać w odwrotnej kolejności, w której zostały uaktualnione, z wyjątkiem sytuacji, gdy serwery zarządzania są wycofywane po systemie Cassandra.

Ogólna kolejność przywracania Private Cloud w wersji 4.52.02 będzie wyglądać tak:

  1. Wycofaj zmiany w postgres, Qpid i inne komponenty związane z analityką
  2. Przywróć routery i procesory wiadomości
  3. Przywrócona Cassandra, Zookeeper
  4. Serwer zarządzania wycofaniem zmian

Załóżmy na przykład, że uaktualnisz cały klaster Cassandra, wszystkie serwery zarządzania i kilka platform RMP do wersji 4.52.02 z wersji 4.52.01 i chcesz je przywrócić. W takim przypadku:

  1. Wycofaj wszystkie RMP pojedynczo
  2. Przywróć cały klaster Cassandra za pomocą kopii zapasowych
  3. Wycofaj po kolei węzły serwera zarządzania brzegiem

Kto może przywrócić poprzednią wersję aplikacji

Użytkownik wykonujący przywrócenie poprzedniej wersji powinien być tym samym użytkownikiem, który pierwotnie zaktualizował Edge lub z wykorzystaniem roota.

Domyślnie komponenty Edge działają jako „apigee” użytkownika. W niektórych przypadkach możesz używać Edge jako różnych użytkowników. Jeśli na przykład router musi mieć dostęp do portów z podwyższonymi uprawnieniami, takich jak poniżej 1000, musisz uruchomić router jako użytkownik root lub użytkownik z dostępem do tych porty. Możesz też uruchomić jeden komponent jako jeden użytkownik, a drugi jako inny użytkownik.

Komponenty ze wspólnym kodem

Poniższe komponenty Edge mają wspólny kod. Dlatego, aby wycofać dowolną tych komponentów w węźle, musisz wycofać wszystkie te komponenty, które znajdują się w tym węźle.

  • edge-management-server (serwer zarządzania)
  • edge-message-processor (system przetwarzania wiadomości)
  • edge-router (router)
  • edge-postgres-server (serwer Postgres)
  • edge-qpid-server (serwer Qpid)

Jeśli na przykład na serwerze zarządzania, routerze i procesorze wiadomości i wycofać dowolną z nich.

Przywracanie systemu Cassandra

Po uaktualnieniu systemu Cassandra w konkretnym węźle Cassandra modyfikuje on schemat danych przechowywanych w tym węźle, przez co bezpośrednie wycofanie jest niemożliwe. Istnieją 2 metody przywracania. Użyjesz jednej z tych metodologii w zależności od stanu uaktualnienia, z którego wycofujesz zmiany.

Metodologie przywracania

Wyczyść i użyj istniejących węzłów w klastrze, aby odbudować węzeł

Tę procedurę można wykonać, jeśli masz w klastrze co najmniej 1 w pełni funkcjonalne centrum danych ze starszą wersją systemu Cassandra (Cassandra 2.1.22). Jeśli cały klaster Cassandra został uaktualniony i chcesz przywrócić poprzednią wersję, musisz wykonać czynności opisane w artykule Czyszczenie i przywracanie kopii zapasowej lub zrzut maszyny wirtualnej.

Kroki przywracania

  1. Zacznij od węzła, który chcesz przywrócić:
    • Zatrzymaj Cassandra w węźle: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
    • Odinstaluj oprogramowanie Cassandra z węzła: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
    • Usuń katalog danych z węzła: 
      rm -rf /opt/apigee/data/apigee-cassandra
    • Pobierz i uruchom wczytywanie starszej wersji Edge dla Private Cloud, do której chcesz przywrócić poprzednią wersję.

    Przykład: aby przywrócić wersję 4.52.01,

    • Pobierz pobieranie w wersji 4.52.01: 
      curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
    • Uruchom wczytywanie w wersji 4.52.01: 
      sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord

    • Skonfiguruj Cassandra w węźle: 
      /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
    • Przeprowadź odbudowę na węźle, podając nazwę działającego centrum danych: 
      /opt/apigee/apigee-cassandra/bin/nodetool rebuild -h <node-IP> <functional-dc>
    • Powtórz powyższe kroki w każdym węźle, który chcesz przywrócić, pojedynczo.
  2. Po wycofaniu i zrekompilowaniu wszystkich węzłów:
    • Uruchom konfigurację dowolnego węzła serwera zarządzania. Sprawdź, czy serwer zarządzania pochodzi ze starszej wersji. Jeśli nie, przywróć poprzednią wersję serwera zarządzania.
    • Zatrzymaj serwer zarządzania: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
    • Jeśli korzystasz z funkcji zarabiania, odinstaluj też funkcję zarabiania: 
      /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
    • Odinstaluj serwer zarządzania: 
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
    • Pobierz i uruchom wczytywanie starszej wersji. Na przykład wykonaj poniższe czynności, aby pobrać i wykonać wczytywanie wersji 4.52.01: 
      curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
      sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
    • Uruchom konfigurację jednego węzła serwera zarządzania: 
      /opt/apigee/apigee-setup/bin/setup.sh -p mt -f configFile

Optymalizacja po odtworzeniu

W powyższych krokach wszystkie dane w węźle są przesyłane strumieniowo ze zdalnego centrum danych podczas odbudowy. Możesz zoptymalizować ten proces przez naprawę po przesłaniu wszystkich replik do lokalnego centrum danych. Pozwala to uniknąć strumieniowania między kontrolerami DC i powinno być szybsze niż odbudowywanie wszystkich węzłów ze zdalnego kontrolera DC.

Przykład: załóżmy, że w lokalnym centrum danych jest 6 węzłów Cassandra. Domyślnie współczynnik replikacji Apigee wynosi 3, więc każdy węzeł posiada 50% danych. W takim przypadku możesz ponownie utworzyć węzły 1 i 4, wykonując powyższą procedurę. W przypadku węzłów 2, 3, 5 i 6 wykonaj poniższe czynności, aby przywrócić kopię zapasową i uruchomić naprawę.

  1. Wykonaj procedurę od kroku 6 zgodnie z dokumentacją, aby odbudować repliki w lokalnym centrum danych.
  2. W przypadku pozostałych węzłów wykonaj czynności opisane poniżej w przypadku każdego pozostałego węzła pojedynczo.
    • Przywróć kopię zapasową wykonaną w tym węźle (uwaga: ta kopia zapasowa prawdopodobnie zawiera nieaktualne dane, ponieważ kopia zapasowa została utworzona przed rozpoczęciem uaktualniania systemu Cassandra): 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backup_file
    • Jeśli masz zrzut maszyny wirtualnej węzła, możesz go przywrócić zamiast przywracania kopii zapasowej Cassandra.
    • Po przywróceniu kopii zapasowej uruchom usługę Cassandra w węźle: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start
    • Napraw węzeł, aby umożliwić strumieniowe przesyłanie najnowszych danych z istniejącego centrum danych: 
      /opt/apigee/apigee-cassandra/bin/nodetool -h <node-IP> repair -dc <local-dc-name>
    • Powtórz kroki 3–6 na każdym węźle, który chcesz naprawić.
.

Wymazywanie i przywracanie kopii zapasowej/zrzutu maszyny wirtualnej

Ta procedura jest jedyna dostępna, jeśli cały klaster Cassandra został uaktualniony i chcesz przywrócić poprzednią wersję.

Dodatkowo kopie zapasowe Apigee zależą od węzła. Nie można przywrócić kopii zapasowej utworzonej z jednego węzła do innego. Kopie zapasowe Cassandra zawierają informacje o metadanych węzła (takie jak adres IP, pozycja dzwonienia itp.).

  1. Zacznij od 1 węzła Cassandra w klastrze:
    • Zatrzymaj usługę Cassandra w węźle: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
    • Odinstaluj oprogramowanie Cassandra z węzła: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
    • Usuń katalog danych z węzła: 
      rm -rf /opt/apigee/data/apigee-cassandra
    • Pobierz i uruchom ładowanie starszej wersji Edge dla Private Cloud, do której chcesz przywrócić poprzednią wersję.

    Przykład: aby przywrócić wersję 4.52.01

    • Pobierz pobieranie w wersji 4.52.01: 
      curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
    • Uruchom wczytywanie w wersji 4.52.01: 
      sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord

    • Skonfiguruj Cassandra w węźle: 
      /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
    • Przywróć kopię zapasową w węźle, wykonując procedurę opisaną w sekcji Przywracanie z kopii zapasowej.
    • Zatrzymaj Cassandra w węźle: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
    • Usuń katalog danych: 
      rm -rf /opt/apigee/data/apigee-cassandra/data
    • Przywróć kopię zapasową: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backup_file
    • Uruchom usługę Cassandra w węźle: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start
    • Powtórz kroki w każdym węźle Cassandra po jednym naraz.
    • Wykonuj naprawę w węzłach pojedynczo: 
      /opt/apigee/apigee-cassandra/bin/nodetool -h <node-IP> repair -pr
.

Cofnij aktualizację Zookeeper 3.8.3

Jeśli przywracasz aplikację Zookeeper do wersji 4.52.00 lub 4.51.00, musisz wykonać kilka dodatkowych czynności. Te kroki są wymienione w sekcji Przywracanie.

Jeśli wracasz do wersji 4.52.01, przywróć Zookeeper w taki sposób, w jaki przywracasz oprogramowanie, zgodnie z opisem w sekcji Przywracanie poprzedniej wersji głównej lub podrzędnej poniżej.

Wycofanie zapytania

Jeśli wracasz do wersji 4.52.00 lub 4.51.00, zanim wycofasz Qpid, musisz wykonać pewne czynności specjalne. Te kroki są wymienione w sekcji Przywracanie.

Jeśli wracasz do wersji 4.52.01, wycofuj Qpid tak samo jak w przypadku przywracania dowolnego oprogramowania wymienionego w sekcji Przywracanie poprzedniej wersji głównej lub podrzędnej

Cofanie aktualizacji Postgres 10.17

Jeśli przywracasz wersję 4.51.00, przed przywróceniem Postgres musisz wykonać kilka dodatkowych czynności. Te kroki są wymienione w sekcji Przywracanie.

Jeśli wracasz do wersji 4.52.01 lub 4.52.00, wycofuj Postgres w taki sam sposób, jak w przypadku wycofywania oprogramowania, co zostało opisane w sekcji Przywracanie poprzedniej wersji głównej lub podrzędnej poniżej.

Przywracanie poprzedniej wersji głównej lub podrzędnej

Aby przywrócić poprzednią wersję główną lub podrzędną, wykonaj te czynności na każdym węźle, który hostuje składnik:

  1. Pobierz plik bootstrap.sh dla wersji, którą chcesz zastosować plecy:

    • Aby przywrócić wersję 4.51.00, pobierz bootstrap_4.51.00.sh: 
      curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
  2. Zatrzymaj komponent do wycofania:
    1. Aby wycofać dowolny z komponentów ze wspólnym kodem w musisz zatrzymać je wszystkie, jak pokazano w poniższym przykładzie: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
 /opt/apigee/apigee-service/bin/apigee-service edge-router stop
 /opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
 /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
 /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Aby przywrócić poprzednią wersję dowolnego komponentu innego w węźle, zatrzymaj tylko ten komponent: 
      • /opt/apigee/apigee-service/bin/apigee-service component stop
  3. Jeśli chcesz przywrócić zarabianie, odinstaluj tę funkcję z serwera zarządzania i wiadomości Węzły procesora: 
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. Odinstaluj komponent, aby przywrócić poprzednią wersję w węźle:
    1. Aby wycofać dowolny z komponentów ze wspólnym kodem w węzła, musisz je wszystkie odinstalować, odinstalowując komponent edge-gateway jak w tym przykładzie: 
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
    2. Aby przywrócić dowolny inny komponent w węźle, odinstaluj tylko ten komponent, ponieważ następujący przykład: 
      /opt/apigee/apigee-service/bin/apigee-service component uninstall

      Gdzie component to nazwa komponentu.

    3. Aby przywrócić router brzegowy, musisz usunąć zawartość /opt/nginx/conf.d, oprócz odinstalowania Grupa komponentów edge-gateway: 
      cd /opt/nginx/conf.d
 rm -rf *
  5. Odinstaluj wersję 4.52.02 aplikacji apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. Zainstaluj wersję 4.51.00 aplikacji apigee-service i ich zależnościami. Poniższy przykład instaluje wersję 4.51.00 apigee-service: 
    sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

    Gdzie uName i pWord to otrzymana nazwa użytkownika i hasło z Apigee. Jeśli pominiesz pWord, pojawi się prośba o jego podanie.

    Jeśli pojawi się błąd, sprawdź, czy w kroku został pobrany plik bootstrap.sh. 1.

  7. Zainstaluj apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  8. Zainstaluj starszą wersję komponentu: 
    /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

    Gdzie component jest komponentem do zainstalowania, a configFile to komponent i konfigurację starszej wersji.

  9. Jeśli wycofujesz zmiany Qpid, opróżnij pliki iptables: 
    sudo iptables -F
  10. Powtórz ten proces dla każdego węzła hostującego wycofywany komponent.

Przywracanie poprzedniej wersji poprawki

Aby wycofać komponent do określonej wersji poprawki, w każdym węźle wykonaj te czynności który hostuje komponent:

  1. Pobierz konkretną wersję komponentu: 
    /opt/apigee/apigee-service/bin/apigee-service component_version install

    Gdzie component_version to wersja komponentu i poprawka do zainstalowania. Dla: przykład:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.51.05-0.0.3749 install

    Jeśli korzystasz z repozytorium online Apigee, możesz określić dostępny komponent za pomocą tego polecenia: 

    yum --showduplicates list comp

    Na przykład:

    yum --showduplicates list edge-ui
  2. Użyj narzędzia apigee-setup, aby zainstalować komponent: 
    /opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile

    Na przykład:

    /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile

    Pamiętaj, że podczas instalacji podajesz tylko nazwę komponentu, a nie wersję.

  3. Powtórz ten proces dla każdego węzła hostującego wycofywany komponent.

Wycofaj mTLS

Aby wycofać aktualizację mTLS, na wszystkich hostach wykonaj te czynności:

  1. Zatrzymaj Apigee: 
    apigee-all stop
  2. Zatrzymaj mTLS: 
    apigee-service apigee-mtls uninstall
  3. Ponownie zainstaluj mTLS: 
    apigee-service apigee-mtls install
apigee-service apigee-mtls setup -f /opt/silent.conf