Wycofywanie Apigee Edge 4.52.02

Jeśli podczas aktualizacji do wersji Edge 4.52.02 wystąpi błąd, możesz cofnąć komponent, który go spowodował, a następnie spróbować ponownie przeprowadzić aktualizację.

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

  • Wersja 4.52.01
  • Wersja 4.52.00
  • Wersja 4.51.00

Przywracanie wersji wiąże się z przywróceniem wszystkich komponentów, które zostały ulepszone. Dodatkowo w zależności od wersji, z której korzystasz, przed przywróceniem niektórych komponentów oprogramowania może być konieczne wykonanie specjalnych czynności. W tabeli poniżej wymieniono różne komponenty oprogramowania, w przypadku których może być konieczne wykonanie specjalnych czynności podczas przywracania:

Przywróć do wersji Specjalne uwagi dotyczące oprogramowania
4.52.01 Cassandra
4.52.00 Zookeeper, Cassandra, Qpid
4.51.00 Zookeeper, Postgres, Cassandra, Qpid

Możesz wykonać wycofanie w 2 sytuacjach:

  1. Przywróć poprzednią wersję główną lub podrzędną. na przykład z 4.52.02 na 4.52.00.
  2. Przywrócić poprzednią wersję poprawki w ramach tej samej wersji. Na przykład z 4.52.00.02 na 4.52.00.01.

Więcej informacji znajdziesz w artykule Proces publikowania Apigee Edge.

Kolejność wycofywania

Przywracanie komponentów powinno odbywać się w odwrotnej kolejności ich uaktualniania, z tym wyjątkiem, że serwery zarządzania powinny zostać przywrócone po Cassandra. Cassandra, komponenty środowiska uruchomieniowego i serwer zarządzający powinny zostać cofnięte za pomocą podejścia polegającego na cofaniu zmian w poszczególnych centrach danych, tymczasowo przekierowując ruch do działających centrów danych.

Typowa kolejność odzyskiwania wersji w przypadku Private Cloud 4.52.02 będzie wyglądać tak:

Pojedyncze centrum danych

W przypadku konfiguracji z jednym centrum danych procedura cofania będzie miała znaczny wpływ na ruch w czasie wykonywania i na niektóre interfejsy API do zarządzania.

  1. Przywracanie Qpid i innych komponentów związanych z statystykami
  2. Przywracanie routerów i procesorów wiadomości
  3. Przywracanie Cassandra
  4. Serwer zarządzania w przypadku przywracania
  5. Przywracanie Postgres i Zookeeper

Wiele centrów danych

W przypadku konfiguracji z wieloma centrami danych należy stosować odzyskiwanie w poszczególnych centrach danych, tymczasowo przekierowując ruch do działających centrów danych. Zapewnia to ciągłość ruchu, zapobiega przestojam i umożliwia kontrolowany proces cofania zmian w przypadku Cassandra, serwera zarządzania i węzłów wykonawczych.

  1. Przywróć Qpid i inne komponenty związane z usługą Analytics we wszystkich centrach danych.
  2. Blokowanie ruchu w pierwszym centrum danych i przekierowywanie go do innych centrów danych.
  3. Przywróć Routery i Przetwarzacze wiadomości w pierwszym centrum danych.
  4. Przywróć Cassandra w pierwszym centrum danych.
  5. Przywróć serwer zarządzania w pierwszym centrum danych.
  6. Odblokuj ruch w pierwszym centrum danych i wykonuj kroki 2–6, aż do ostatniego centrum danych, w którym zostaną cofnięte węzły Runtime, Cassandra i serwer Management.
  7. Przywróć Postgres, Zookeeper i LDAP we wszystkich centrach danych.

Aby to zilustrować, załóżmy, że uaktualniono cały klaster Cassandra, wszystkie serwery zarządzające i kilka procesorów wiadomości w czasie wykonywania (RMP) z wersji 4.52.01 do 4.52.02 i trzeba cofnąć zmiany. W takim przypadku należy wykonać cofnięcie zmian w taki sposób:

  1. Zablokuj ruch w pierwszym centrum danych (data center) i przekieruj go do innych aktywnych centrów danych, aby zapewnić ciągłość działania usługi.
  2. Przywróć routery i przetwarzacze wiadomości w pierwszym centrum danych.
  3. Przywróć Cassandra w pierwszym centrum danych, przywracając dane z kopii zapasowej lub zrzutu maszyny wirtualnej.
  4. Przywróć serwer zarządzania w pierwszym centrum danych.
  5. Odblokuj ruch do pierwszego centrum danych.
  6. Powtórz kroki 1–5 w przypadku każdego pozostałego centrum danych, aż wszystkie węzły Runtime, Cassandra i serwery zarządzania zostaną cofnięte.

Kto może cofnąć zmiany

Użytkownik wykonujący wycofanie powinien być tym samym użytkownikiem, który pierwotnie zaktualizował Edge, lub użytkownikiem działającym jako root.

Domyślnie komponenty Edge działają jako użytkownik „apigee”. W niektórych przypadkach komponenty Edge mogą być uruchamiane jako różne użytkownicy. Jeśli na przykład Router musi mieć dostęp do portów uprzywilejowanych, takich jak porty poniżej 1000, musisz uruchomić Router jako root lub jako użytkownik z dostępem do tych portów. Możesz też uruchomić jeden komponent jako jeden użytkownik, a inny jako inny użytkownik.

Komponenty z wspólnym kodem

Te komponenty Edge korzystają z wspólnego kodu. Dlatego aby cofnąć zmiany w dowolnym z tych komponentów na węźle, musisz cofnąć zmiany we wszystkich komponentach na tym węźle.

  • edge-management-server (serwer zarządzania)
  • edge-message-processor (procesor komunikatów)
  • edge-router (Router)
  • edge-postgres-server (serwer Postgres)
  • edge-qpid-server (Qpid Server)

Jeśli na przykład masz na węźle zainstalowane serwer zarządzania, router i przetwarzacz wiadomości, aby cofnąć zmiany w jednym z nich, musisz cofnąć zmiany we wszystkich trzech.

Wycofanie zmian w Cassandra

Gdy w przypadku konkretnego węzła Cassandra zostanie przeprowadzona duża aktualizacja Cassandra, Cassandra zmodyfikuje schemat danych przechowywanych na węźle, co uniemożliwi bezpośrednie przywrócenie. Można to zrobić na 2 sposoby. Użyjesz jednej z tych metod na podstawie stanu wersji, którą wycofujesz.

Metody wycofywania zmian

Scenariusze przywracania

Edge for Private Cloud w wersji 4.52.02 zawiera uaktualnienie Cassandra i sterownika używanego przez procesor wiadomości i serwer zarządzania do łączenia się z Cassandra. W związku z tym uaktualnienia i cofania tych 3 komponentów są ze sobą ściśle powiązane. Tabela poniżej zawiera przykłady ogólnych scenariuszy przywracania tych 3 komponentów. W przypadku innych komponentów należy postępować zgodnie z sekcją Kolejność wycofywania.

W tej sekcji opisujemy różne scenariusze przywracania oraz zalecaną metodę, która powinna być stosowana na podstawie opisanych powyżej metod.

Scenariusz Strategia przywracania
Jedno centrum danych, niektóre węzły Cassandra zostały uaktualnione przywracanie kopii zapasowej,
Jedno centrum danych, wszystkie węzły Cassandra zaktualizowane przywracanie kopii zapasowej,
Jedno centrum danych, wszystkie węzły (Cassandra, serwer zarządzający i węzły środowiska uruchomieniowego) zostały uaktualnione
Wiele centrów danych, niektóre lub wszystkie węzły Cassandra w pierwszym centrum danych zaktualizowane Odtworzenie z dotychczasowego centrum danych
Wiele centrów danych, wszystkie węzły Cassandra, serwer zarządzający i węzły Runtime w pierwszym centrum danych zaktualizowane

Operację tę należy wykonać w jednym centrum danych naraz.
W kilku centrach danych ulepszane są niektóre lub wszystkie węzły Cassandra w ostatnim centrum danych.
Wiele centr danych, wszystkie węzły Cassandra, serwer zarządzający i węzły środowiska wykonawczego ulepszone we wszystkich centrach danych.

Należy to wykonać w przypadku jednego centrum danych naraz.

Podczas przywracania systemu Cassandra należy wziąć pod uwagę te kwestie:

  1. Cofnięcie komponentów czasu wykonywania lub zarządzania

    Jeśli chcesz przywrócić komponenty, takie jak Edge Management Server lub Edge Message Processor, do poprzedniej wersji Edge Private Cloud w dowolnym centrum danych (DC), upewnij się, że w tym samym czasie przywrócisz też Cassandra w tym konkretnym centrum danych. Jest to konieczne, aby zapobiec problemom z zarządzaniem i ruchu w czasie działania.

  2. Cofnij zmiany za pomocą kopii zapasowych

    Kopie zapasowe utworzone z Cassandra 3.11.x są niezgodne z kopiami utworzonymi z Cassandra 2.1.x. Aby umożliwić przywrócenie za pomocą kopii zapasowej, przed uaktualnieniem upewnij się, że kopie zapasowe Cassandra 2.1.x zostały utworzone.

  3. Odłączenie centrum danych na potrzeby przywracania

    Aby uniknąć przestojów, sprawdź, czy ruch jest przekierowywany do w pełni funkcjonalnych centrów danych i czy jest blokowany w centrum danych, w którym odbywa się cofanie zmian.

Przywracanie Cassandra za pomocą funkcji odbudowy

Wymagania wstępne

  1. Używasz klastra Edge for Private Cloud w wersji 4.51.00, 4.52.00 lub 4.52.01 w wielu centrach danych.
  2. Przechodzisz uaktualnienie Cassandra z wersji 2.1.X na 3.11.X i napotykasz problemy podczas uaktualniania
  3. W klastrze masz co najmniej 1 w pełni funkcjonalne centrum danych, które nadal korzysta ze starszej wersji Cassandra (Cassandra 2.1.X).

Najważniejsze kroki

  1. Wybierz jedno centrum danych (częściowo lub całkowicie ulepszone), które chcesz cofnąć. przekierować cały ruch aplikacji z tego centrum danych do innego, w pełni funkcjonalnego centrum danych;
  2. Jeśli router i przetwarzacz wiadomości zostały zaktualizowane, cofnij wszystkie węzły routera i przetwarzacza wiadomości w centrum danych pojedynczo.
  3. Zatrzymaj Cassandra na jednym węźle, odinstaluj go i usuń wszystkie powiązane dane.
  4. Zainstaluj bootstrap poprzedniej wersji i skonfiguruj Cassandra w wersji 2.1.x na oczyszczonym węźle.
  5. Odbuduj węzeł z dotychczasowego działającego centrum danych, w którym nadal działa Cassandra 2.1.x.
  6. Wykonaj czynności opisane w punktach 3–5 w przypadku każdego pozostałego węzła Cassandra w centrum danych (po jednym węźle na raz).
  7. Ponownie uruchom konfigurację serwera zarządzania w centrum danych.
  8. Przeprowadź testy, aby zweryfikować przywrócenie. Po weryfikacji przekieruj ruch aplikacji z powrotem do przywróconego centrum danych.
  9. Powtórz podane wyżej czynności w przypadku pozostałych centrów danych, w których konieczne jest cofnięcie zmian.

Szczegółowe instrukcje wymazywania i używania istniejących węzłów w klastrze do odtworzenia węzła:

Zacznij od węzła, który chcesz cofnąć.

  1. Zanim przejdziesz do kolejnych kroków, sprawdź, czy ruch jest przekierowywany do w pełni funkcjonalnych centrów danych.
  2. Jeśli router i przetwarzanie wiadomości zostały zaktualizowane, cofnij wszystkie węzły routera i przetwarzania wiadomości do poprzedniej wersji w centrum danych, po jednym.
  3. Zatrzymaj system Cassandra na węźle: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
  4. Odinstaluj oprogramowanie Cassandra z węzła: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
  5. Usuwanie katalogu danych z węzła: 
    rm -rf /opt/apigee/data/apigee-cassandra

  6. Pobierz i uruchom bootstrap starszej wersji Edge for Private Cloud, do której chcesz przywrócić:

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

  7. Pobierz bootstrap 4.52.01: 
    curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
  8. Uruchom bootstrap 4.52.01: 
    sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
  9. Zainstaluj oprogramowanie Cassandra na węźle: 
    apigee-service apigee-cassandra install
  10. Dodaj do pliku /opt/apigee/apigee-cassandra/source/conf/cassandra-env.sh tę właściwość. 
    JVM_OPTS="$JVM_OPTS -Dcassandra.replace_address=<cass_ip-address>"

    Przykład: 

    JVM_OPTS="$JVM_OPTS -Dcassandra.replace_address=10.0.0.1"

  11. Skonfiguruj system Cassandra na węźle: 
    /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
  12. Po uruchomieniu serwera Cassandra usuń z pliku /opt/apigee/apigee-cassandra/source/conf/cassandra-env.sh powyższy plik CWC.
  13. Ponownie uruchom węzeł Cassandra 
    apigee-service apigee-cassandra restart
  14. Wykonaj ponowne tworzenie węzła, podając nazwę funkcjonalnego centrum danych: 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild -h <node-IP> <functional-dc>

    Przykład: 

    /opt/apigee/apigee-cassandra/bin/nodetool rebuild -h 10.0.0.1 dc-2

  15. Powtórz te czynności w przypadku każdego węzła, który chcesz cofnąć w danym centrum danych, po jednym naraz.

Gdy wszystkie węzły Cassandra w centrum danych zostaną przywrócone i odtworzone.

  1. W centrum danych, w którym chcesz cofnąć zmiany, uruchom konfigurację dowolnego węzła serwera zarządzania. Upewnij się, że serwer zarządzania pochodzi z cofniętej wersji. Jeśli nie, zroluj zmiany na serwerze zarządzania.

    2. Przywracanie serwera zarządzania do starszej wersji

  2. Zatrzymaj serwer zarządzania: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
  3. Jeśli korzystasz z zarabiania, odinstaluj też zarabianie: 
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. Odinstaluj edge-gateway i apigee-cassandra-client: 
    /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
     
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra-client uninstall
  5. Pobierz i uruchom bootstrap starszej wersji. Aby na przykład pobrać i uruchomić bootstrap 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’
     
    sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord

    6. Konfiguracja serwera zarządzania

  6. Uruchom konfigurację jednego węzła serwera zarządzania: 
    /opt/apigee/apigee-setup/bin/setup.sh -p mt -f configFile
  7. Po wykonaniu powyższych czynności przekieruj ruch z powrotem do przywróconego centrum danych.

Optymalizacja po odtworzeniu

W wymienionych wyżej krokach podczas odtwarzania wszystkie dane w węźle są przesyłane strumieniowo z zdalnego centrum danych. Możesz zoptymalizować ten proces, wykonując naprawę po przesłaniu wszystkich replik do lokalnego centrum danych. Zapobiega to przesyłaniu strumieniowemu danych między centrami danych i powinno być szybsze niż odtwarzanie wszystkich węzłów z odległego centrum danych.

Przykład: załóżmy, że masz 6 węzłów Cassandra w lokalnym centrum danych. Domyślnie współczynnik replikacji Apigee wynosi 3, więc każdy węzeł ma 50% danych. W takim przypadku możesz odtworzyć węzły 1 i 4, wykonując opisaną powyżej procedurę. W przypadku węzłów 2, 3, 5 i 6 wykonaj podane niżej czynności, aby przywrócić kopię zapasową i przeprowadzić naprawę.

  1. Aby odtworzyć kopie zapasowe w lokalnym centrum danych, wykonaj czynności opisane powyżej.
  2. W przypadku pozostałych węzłów wykonaj po kolei czynności opisane poniżej.
  3. Przywróć kopię zapasową utworzoną na tym węźle (uwaga: ta kopia zapasowa prawdopodobnie będzie zawierać nieaktualne dane, ponieważ została utworzona przed rozpoczęciem uaktualniania Cassandra): 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backup_file

    Jeśli masz zrzut węzła maszyny wirtualnej, możesz przywrócić zrzut zamiast kopii zapasowej Cassandra.

  4. Po przywróceniu kopii zapasowej uruchom usługę Cassandra na węźle: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start
  5. Wykonaj naprawę węzła, aby najnowsze dane mogły być przesyłane strumieniowo z istniejącego centrum danych: 
    /opt/apigee/apigee-cassandra/bin/nodetool -h <node-IP> repair -dc <local-dc-name>

    Przykład: 

    /opt/apigee/apigee-cassandra/bin/nodetool -h 10.0.0.1 repair -dc dc-1

  6. Powtórz wszystkie kroki opisane w kroku 2 w przypadku każdego węzła, który chcesz naprawić.

Przywracanie Cassandra za pomocą kopii zapasowej lub zrzutu maszyny wirtualnej

Ta procedura jest jedyną dostępną, jeśli uaktualniono cały klaster Cassandra i chcesz cofnąć zmiany. Ponadto kopie zapasowe Apigee są tworzone dla poszczególnych węzłów. Nie można przywrócić kopii zapasowej z jednego węzła do drugiego. Kopie zapasowe Cassandra zawierają informacje o metadanych węzła (np. adres IP, pozycja pierścienia itp.).

Wymagania wstępne

  1. W ostatnim centrum danych trwa uaktualnianie Cassandra z wersji 2.1.X do 3.11.X i występują problemy.
  2. Masz kopie zapasowe węzła przed uaktualnieniem, które chcesz cofnąć. Kopie zapasowe zostały utworzone przed próbą uaktualnienia z wersji 2.1.X do 3.11.X.

Najważniejsze kroki

  1. Wybierz centrum danych (częściowo lub całkowicie ulepszone), aby przywrócić poprzednią wersję. Przekieruj cały ruch z tego centrum danych do innego, w pełni funkcjonalnego centrum danych.
  2. Jeśli router i przetwarzacz wiadomości zostały zaktualizowane, cofnij wszystkie węzły routera i przetwarzacza wiadomości w centrum danych pojedynczo.
  3. Zatrzymaj Cassandra na jednym węźle, odinstaluj go i usuń wszystkie powiązane dane.
  4. Zainstaluj bootstrap poprzedniej wersji i skonfiguruj Cassandra w wersji 2.1.x na oczyszczonym węźle.
  5. Zatrzymaj węzeł Cassandra i usuń wszystkie powiązane dane.
  6. Przywróć węzeł Cassandra z kopii zapasowej utworzonej przed uaktualnieniem.
  7. Powtórz kroki 3–6 w przypadku pozostałych węzłów Cassandra w danym centrum danych (po jednym węźle na raz).
  8. Ponownie uruchom konfigurację serwera zarządzania w centrum danych.
  9. Przeprowadź testy, aby zweryfikować przywrócenie. Po weryfikacji przekieruj ruch w czasie wykonywania z powrotem do przywróconego centrum danych.
  10. Powtórz podane wyżej czynności w przypadku pozostałych centrów danych, w których konieczne jest cofnięcie zmian.
  11. (Opcjonalnie) Wykonaj polecenie naprawy we wszystkich węzłach Cassandra we wszystkich centrach danych, jeśli występują między nimi niezgodności danych.

Szczegółowy opis odzyskiwania Cassandra za pomocą kopii zapasowych lub migawki maszyny wirtualnej

Zacznij od 1 węzła Cassandra w klastrze

  1. Zanim przejdziesz do kolejnych kroków, sprawdź, czy ruch jest przekierowywany do w pełni funkcjonalnych centrów danych.
  2. Jeśli router i przetwarzacz wiadomości zostały zaktualizowane, cofnij wszystkie węzły routera i przetwarzacza wiadomości do poprzedniej wersji w centrum danych, po jednym.
  3. Zatrzymaj system Cassandra na węźle: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
  4. Odinstaluj oprogramowanie Cassandra z węzła: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
  5. Usuwanie katalogu danych z węzła: 
    rm -rf /opt/apigee/data/apigee-cassandra

  6. Pobierz i uruchom bootstrap starszej wersji Edge for Private Cloud, do której chcesz przywrócić:

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

  7. Pobierz bootstrap 4.52.01: 
    curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
  8. Uruchom bootstrap 4.52.01: 
    sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
  9. Skonfiguruj system Cassandra na węźle: 
    /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
  10. Zatrzymaj system Cassandra na węźle: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
  11. Usuń katalog danych na węźle: 
    rm -rf /opt/apigee/data/apigee-cassandra/data
  12. Przywracanie kopii zapasowej: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backup_file
  13. Uruchomienie usługi Cassandra na węźle 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start
  14. Powtórz te czynności na każdym węźle Cassandra po kolei.
  15. W centrum danych, w którym chcesz cofnąć zmiany, uruchom konfigurację dowolnego węzła serwera zarządzania. Upewnij się, że serwer zarządzania pochodzi z cofniętej wersji. Jeśli nie, zroluj zmiany na serwerze zarządzania.
  16. Po wykonaniu powyższych czynności przekieruj ruch z powrotem do przywróconego centrum danych.
  17. (Opcjonalnie) Wykonaj polecenie naprawy we wszystkich węzłach Cassandra we wszystkich centrach danych, jeśli występują między nimi niezgodności danych. 
    /opt/apigee/apigee-cassandra/bin/nodetool -h <node-IP> repair -pr

Cofanie aktualizacji Zookeeper 3.8.3

Jeśli wracasz do wersji 4.52.00 lub 4.51.00, przed przywróceniem Zookeepera musisz wykonać kilka specjalnych czynności. Te czynności są opisane w sekcji Cofanie.

Jeśli chcesz przywrócić wersję 4.52.01, przywróć Zookeepera tak, jak przywraca się dowolne oprogramowanie. Więcej informacji znajdziesz w sekcji Przywróć poprzednią główną lub podrzędną wersję Zookeepera.

Przywracanie Qpid

Jeśli przywracasz wersję 4.52.00 lub 4.51.00, przed przywróceniem Qpid musisz wykonać kilka specjalnych czynności. Te czynności są opisane w sekcji Cofanie.

Jeśli wracasz do wersji 4.52.01, cofnij Qpid tak, jak cofasz inne oprogramowanie zgodnie z instrukcjami w artykule Cofanie do poprzedniej wersji głównej lub podrzędnej.

Cofanie aktualizacji Postgres 10.17

Jeśli wracasz do wersji 4.51.00, przed przywróceniem Postgresa musisz wykonać kilka specjalnych czynności. Te czynności są opisane w sekcji Cofanie.

Jeśli wracasz do wersji 4.52.01 lub 4.52.00, cofnij Postgres tak, jak cofasz dowolne oprogramowanie, zgodnie z sekcją Cofanie do poprzedniej głównej lub mniejszej wersji poniżej.

Przywróć poprzednią wersję główną lub podrzędną.

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

  1. Pobierz plik bootstrap.sh dla wersji, do której chcesz przywrócić:

    • Aby przywrócić wersję 4.51.00, pobierz bootstrap_4.51.00.sh
  2. Zatrzymaj komponent, aby cofnąć zmiany:
    1. Aby cofnąć dowolny z komponentów z kodem wspólnym w węźle, musisz je wszystkie zatrzymać, jak pokazano w tym 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 cofnąć dowolny inny komponent w węźle, zatrzymaj tylko ten komponent: 
      /opt/apigee/apigee-service/bin/apigee-service component stop
  3. Jeśli chcesz przywrócić poprzednią wersję funkcji Monetyzacja, odinstaluj ją ze wszystkich węzłów serwera zarządzania i procesora wiadomości: 
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. Odinstaluj komponent, aby cofnąć zmiany na węźle:
    1. Aby wycofać dowolny z komponentów z kodem wspólnym w węźle, musisz odinstalować wszystkie, odinstalowując grupę komponentów edge-gateway i apigee-cassandra-client, jak pokazano w tym przykładzie: 
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
       
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra-client uninstall
    2. Aby cofnąć inny komponent w węźle, odinstaluj tylko ten komponent, jak pokazano w tym przykładzie: 
      /opt/apigee/apigee-service/bin/apigee-service component uninstall

      Gdzie component to nazwa komponentu.

    3. Aby przywrócić Edge Router, musisz usunąć zawartość pliku /opt/nginx/conf.d, a także odinstalować grupę komponentów edge-gateway: 
      cd /opt/nginx/conf.d
rm -rf *
  5. Odinstaluj wersję apigee-setup 4.52.02: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. Zainstaluj wersję 4.51.00 narzędzia apigee-service i jego zależności. W tym przykładzie instalowana jest wersja 4.51.00 pakietu apigee-service: 
    sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

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

    Jeśli pojawi się błąd, upewnij się, że plik bootstrap.sh został pobrany w kroku 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 to instalowany komponent, a configFile to plik konfiguracji starszej wersji.

  9. Jeśli cofasz Qpid, opróżnij iptables: 
    sudo iptables -F
  10. Powtórz tę procedurę dla każdego węzła, który hostuje komponent, który chcesz cofnąć.

Przywróć poprzednią wersję poprawki

Aby przywrócić komponent do określonej wersji poprawki, wykonaj te czynności na każdym węźle, na którym jest on hostowany:

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

    gdzie component_version to wersja komponentu i łatki do zainstalowania. Przykład:

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

    Jeśli korzystasz z repozytorium internetowego Apigee, możesz określić dostępne wersje komponentów za pomocą tego polecenia: 

    yum --showduplicates list component

    Na przykład:

    yum --showduplicates list edge-ui
  2. Aby zainstalować komponent, użyj apigee-setup: 
    /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

    Na przykład:

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

    Pamiętaj, że podczas instalacji musisz podać tylko nazwę komponentu, a nie jego wersję.

  3. Powtórz tę procedurę dla każdego węzła, który hostuje komponent, który chcesz cofnąć.

Przywracanie mTLS

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

  1. Zatrzymanie Apigee: 
    apigee-all stop
  2. Zatrzymanie mTLS: 
    apigee-service apigee-mtls uninstall
  3. Ponowna instalacja mTLS: 
    apigee-service apigee-mtls install
apigee-service apigee-mtls setup -f /opt/silent.conf