Zaktualizuj Apigee Edge w wersji 4.51.00, 4.52.00 lub 4.52.01 do wersji 4.52.02

Apigee obsługuje uaktualnianie Edge for Private Cloud bezpośrednio z wersji 4.51.00, 4.52.00 lub 4.52.01 do wersji 4.52.02. Na tej stronie znajdziesz informacje o tym, jak przeprowadzić takie uaktualnienia.

Kto może przeprowadzić aktualizację

Osoba uruchamiająca aktualizację powinna być tą samą osobą, która pierwotnie zainstalowała Edge, lub osobą działającą jako root.

Po zainstalowaniu modułów RPM Edge każdy może je skonfigurować.

Które komponenty należy zaktualizować

Musisz zaktualizować wszystkie komponenty Edge. Edge nie obsługuje konfiguracji zawierającej komponenty z różnych wersji.

Aktualizacja wymagań wstępnych

Przed uaktualnieniem Apigee Edge sprawdź, czy spełniasz te wymagania wstępne:

  • Utwórz kopię zapasową wszystkich węzłów
    Ze względów bezpieczeństwa przed aktualizacją zalecamy utworzenie pełnej kopii zapasowej wszystkich węzłów. Aby utworzyć kopię zapasową, skorzystaj z procedury odpowiedniej dla Twojej bieżącej wersji przeglądarki Edge.

    Dzięki temu masz 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.

  • Sprawdzanie, czy przeglądarka Edge jest uruchomiona
    Sprawdź, czy przeglądarka Edge jest uruchomiona podczas procesu aktualizacji, używając tego polecenia:
    /opt/apigee/apigee-service/bin/apigee-all status
  • Upewnij się, że strategia kompresji Cassandra to LeveledCompactionStrategy
    W zależności od bieżącej wersji wprowadź niezbędne zmiany w strategii kompresji Cassandra. Wykonaj te czynności, a potem wróć do głównej procedury przekształcania:

Specjalne kroki do wykonania przed uaktualnieniem

Aby przejść na Edge for Private Cloud 4.52.02, wykonaj określone czynności związane z uaktualnieniem niektórych programów. Wymagane czynności zależą od bieżącej wersji. W tabeli poniżej znajdziesz różne programy, które wymagają dodatkowych czynności. Postępuj zgodnie z dokładnymi instrukcjami dotyczącymi każdego z nich. Po wykonaniu niezbędnych czynności wrócisz do głównej procedury uaktualniania, aby kontynuować proces.

Obecna wersja Oprogramowanie, które wymaga specjalnych czynności w celu uaktualnienia do wersji 4.52.02
4.52.01 Cassandra
4.52.00 Zookeeper, Cassandra, Qpid
4.51.00 Zookeeper, Postgres, Cassandra, Qpid

Po wykonaniu odpowiednich czynności w zależności od wersji przejdź do głównej procedury uaktualniania.

Automatyczne propagowanie ustawień obiektu

Jeśli ustawisz jakieś właściwości, edytując pliki .properties w folderze /opt/apigee/customer/application, te wartości zostaną zachowane po aktualizacji.

Przechodzenie na Zookeeper 3.8.3

Edge for Private Cloud w wersji 4.52.02 nie zawiera uaktualnienia Zookeeper. Jeśli jednak przechodzisz na nowszą wersję z wersji starszej niż 4.52.01, musisz wykonać czynności związane z uaktualnieniem Zookeeper opisanymi poniżej.

  • Jeśli przechodzisz z wersji Edge for Private Cloud 4.51.00 lub 4.52.00, zapoznaj się z czynnościami opisanymi w artykule Wymagane przejście na Zookeeper 3.8.3, aby zaktualizować Zookeeper.
  • Jeśli przechodzisz z wersji Edge for Private Cloud 4.52.01, prawdopodobnie korzystasz już z wersji Zookeeper 3.8.3 i nie musisz wykonywać żadnych specjalnych czynności, aby zaktualizować Zookeeper.

Przechodzenie na Postgres 14

  • Jeśli przechodzisz z wersji Edge for Private Cloud 4.51.00 na 4.52.02, musisz wykonać czynności związane z uaktualnieniem Postgresa, mimo że wersja Edge for Private Cloud 4.52.02 nie zawiera uaktualnienia Postgresa. Przejście z wersji Edge for Private Cloud 4.51.00 na 4.52.02 wymaga wykonania dodatkowych czynności związanych z aktualizacją Postgresa. Zapoznaj się z sekcją Wymagany upgrade do Postgres 14.
  • Jeśli przechodzisz z Edge for Private Cloud 4.52.00 lub 4.52.01 na 4.52.02, nie musisz wykonywać żadnych dodatkowych czynności związanych z migracją Postgres.

Przejście na wersję Cassandra 3.11.16

Wersja Apigee Edge for Private Cloud 4.52.02 zawiera uaktualnienie Cassandra do wersji 3.11.16. Cassandra jest kluczowym komponentem Apigee, a ta aktualizacja obejmuje też aktualizacje oprogramowania sterownika w różnych komponentach środowiska uruchomieniowego i zarządzania, które służą do wysyłania zapytań do Cassandra i zapisywania danych w tej usłudze.

Ponieważ jest to poważna aktualizacja, w celu zapewnienia optymalnej wydajności w nowszych wersjach konieczne było wprowadzenie pewnych zmian w modelu danych Apigee w Cassandra. Chociaż zmiany są minimalne, proces uaktualniania powoduje przerwanie działania niektórych interfejsów API zarządzania. Dokładne informacje o interfejsach API zarządzania, które są ogólnie przerywane, znajdziesz w odpowiednich sekcjach poniżej.

Proces uaktualnienia powoduje również przerwanie większej liczby przepływów proxy w czasie wykonywania i interfejsów API do zarządzania w centrum danych, które jest uaktualniane. Aby zminimalizować takie zakłócenia, bardzo ważne jest, aby odseparować ruch związany z czasem wykonywania i zarządzaniem od centrum danych, które jest aktualizowane. Aby dowiedzieć się więcej, przeczytaj sekcje dotyczące pojedynczego centrum danych i wielu centrów danych.

Portal dla deweloperów – dokumentacja interfejsów API

Portal dla programistów Drupal w Apigee oferuje różne funkcje do dokumentowania interfejsów API. Zalecamy przejście na korzystanie z portalu dla programistów opartego na Drupalu 7, ale jeśli nadal używasz tego portalu i jego funkcji SmartDocs, dotyczy Cię dokument Korzystanie z interfejsów API SmartDocs. Jeśli używasz nowszych wersji portalu dla programistów, ta aktualizacja nie wpłynie na Twoją dokumentację interfejsu API.

Gdy uaktualnisz Apigee do wersji 4.52.02, modele interfejsu API utworzone za pomocą funkcji SmartDocs na portalu dewelopera Drupala 7 nie zostaną automatycznie przeniesione do nowszej wersji. Każdy model należy wyeksportować ręcznie na portalu dewelopera i ponownie zaimportować po zakończeniu aktualizacji.

Terminologia użyta poniżej

Czas wykonywania: czas wykonywania obejmuje obsługę ruchu w czasie wykonywania przez serwer proxy. Obejmuje on wszystkie operacje wykonywane przez routery i procesory wiadomości w celu efektywnego przetwarzania żądania interfejsu API w czasie działania w przypadku istniejących serwerów proxy. Nie obejmuje to jednak wdrażania nowych serwerów proxy ani nowych wersji serwerów proxy.

Zarządzanie: zarządzanie obejmuje administrowanie systemem Apigee Edge. Dotyczy to między innymi wdrożeń, modyfikacji aplikacji, produktów, serwerów docelowych, repozytoriów kluczy itp. Zakres ten obejmuje wszystkie interfejsy API do zarządzania (oraz ich klientów, takich jak interfejs Apigee i portal dla deweloperów).

Podczas tej aktualizacji ruch w czasie wykonywania i ruch zarządzający są ograniczane w regionie lub centrum danych (DC), w którym jest wykonywana aktualizacja. Niezależnie od aktualizowanego centrum danych, zmiany te mają wpływ na niektóre interfejsy API zarządzania we wszystkich centrach danych. Wpływ jest opisywany po każdym kroku.

Na każdym z podanych niżej kroków opisujemy stan środowiska uruchomienia i zarządzania na poszczególnych etapach procedury uaktualniania.

Uaktualnianie strategii

Wiele centrów danych

Uaktualnienie musi być przeprowadzane w jednym centrum danych naraz, aby zapewnić ciągłość ruchu i uniknąć przestojów. Przed uaktualnieniem centrum danych ruch powinien zostać przekierowany do innych działających centrów danych.

Pojedyncze centrum danych

W przypadku konfiguracji z jednym centrum danych procedura uaktualniania będzie miała znaczący wpływ na ruch w czasie wykonywania i niektóre interfejsy API do zarządzania. W przypadku konfiguracji z jednym centrum danych dostępne są te opcje.

  • Rozszerz klaster Edge for Private Cloud do tymczasowego centrum danych, dodając centrum danych obok istniejącego, aby obsłużyć ruch podczas uaktualniania, a następnie wycofaj jedno z centrów danych po zakończeniu procesu uaktualniania.
  • Jeśli nie możesz rozszerzyć się na kolejne centrum danych, przygotuj się na przerwę w działaniu i zaplanuj uaktualnienie na okresy o mniejszym natężeniu ruchu, aby zminimalizować wpływ na interfejsy API do zarządzania i ruch w czasie wykonywania.

Zalecamy rozszerzenie o dodatkowe centrum danych, aby uniknąć wpływu na ruch w czasie wykonywania i interfejsy API do zarządzania. W trakcie uaktualniania centrum danych mogą wystąpić problemy dotyczące m.in. tych obszarów:

  • Odświeżanie tokenów OAuth przez interfejsy API w czasie wykonywania
  • Interfejsy API w czasie wykonywania korzystające z zasady dostępu do obiektów
  • Interfejsy API do zarządzania zawierające aplikacje programistów
  • Interfejsy API do zarządzania służące do wyświetlania produktów

Opisane powyżej konsekwencje dotyczą również interfejsów API do zarządzania, które nie będą działać we wszystkich centrach danych, dopóki nie zostaną zaktualizowane. Te interfejsy API do zarządzania są wymienione w sekcjach opisanych w dalszej części tego artykułu.

Wycofanie – ogólne informacje

  • Wpływ przywracania

    Przywrócenie wersji Cassandra 3.11.x do 2.1.x wpływa zarówno na czas wykonywania, jak i ruch zarządzający w centrum danych (DC), w którym wykonywane jest cofnięcie. Ponadto w przypadku niektórych interfejsów API do zarządzania może dochodzić do przerw w działaniu we wszystkich centrach danych, niezależnie od tego, które z nich jest obecnie przywracane.

  • Stosowanie podejścia polegającego na przywróceniu zmian w przypadku płatności bezpośrednio u operatora

    Aby zachować ciągłość działania usługi i uniknąć przestojów, przywracanie należy wykonać w pojedynczych centrach danych. Przed rozpoczęciem cofania zmian w określonym centrum danych upewnij się, że ruch aplikacji jest przekierowywany do innego w pełni działającego centrum danych.

  • Wycofywanie częściowo uaktualnionego klastra

    Jeśli co najmniej 1 centrum danych nadal działa prawidłowo w starszej wersji Cassandra (2.1.22), inne ulepszone centra danych można przywrócić do poprzedniej wersji, wykonując odtworzenie z pełnoprawnego obrazu Cassandra 2.1.X.

  • Przywrócenie zmian na poziomie klastra

    Jeśli cały klaster Cassandra został ulepszony, a Ty chcesz cofnąć zmiany, musisz to zrobić, korzystając z kopii zapasowych lub zrzutów maszyn wirtualnych. To podejście jest skomplikowane i prawdopodobnie spowoduje tymczasowy przestój lub utratę danych.

  • Ważne informacje przed uaktualnieniem

    Przed przeprowadzeniem aktualizacji zapoznaj się z procedurami przywracania. Podczas przejścia na nowszą wersję należy wziąć pod uwagę niuanse odzyskiwania, aby mieć pewność, że dostępne są odpowiednie ścieżki odzyskiwania.

Cofania zmian w klastrach z jednym centrum danych

Uaktualnianie Cassandra z wersji 2.1.x do 3.11.x może znacząco wpłynąć na ruch w czasie wykonywania i niektóre interfejsy API do zarządzania. Te skutki mają również zastosowanie podczas cofania zmian i mogą spowodować przestój lub utratę danych.

W przypadku zadań produkcyjnych zdecydowanie zalecamy zarezerwowanie nowego centrum danych przed uaktualnieniem. Dzięki temu możesz bezpieczniej cofnąć zmiany bez utraty danych lub zakłócenia ruchu w interfejsie API. Po zakończeniu uaktualniania możesz wycofać dodatkowe centrum danych.

Jeśli dodanie nowego centrum danych nie jest możliwe, ale nadal potrzebna jest możliwość przywrócenia, przed uaktualnieniem upewnij się, że przed uaktualnieniem zostały utworzone wiarygodne kopie zapasowe. Przywracanie Cassandra 2.1.x z kopii zapasowych jest możliwe, ale może wiązać się z przestojami w działaniu usługi i potencjalną utratą danych.

Przywracanie klastrów z wieloma centrami danych

Przywracanie wielu centrów danych odbywa się w ramach poszczególnych centrów danych. W ramach tego podejścia ruch z centrum danych, które jest wycofywane, jest przekierowywany do innych działających centrów danych, co zapewnia kontrolowany i odizolowany proces wycofywania w przypadku Cassandra, serwera zarządzaniawęzłów środowiska uruchomieniowego, aby uniknąć przerw w ruchu.

Więcej informacji znajdziesz w sekcji Cofanie aktualizacji Cassandra 3.11.16.

Krok 0. Stan początkowy

  • Komponenty Zookeeper, Postgres i LDAP zostały już uaktualnione do wersji 4.52.02. klaster Edge for a private cloud jest stabilny i działa, Jeśli wymagane jest przywrócenie, klaster zostanie przywrócony do tego stanu.
  • Cassandra w Apigee z wersją 2.1.22.
  • Komponenty Edge:
    • Serwer zarządzania komunikujący się z Cassandra za pomocą starszego protokołu Thrift.
    • Serwery w czasie wykonywania (przetwarzacze i routery wiadomości) komunikujące się z Cassandra za pomocą starszego protokołu Thrift.
Stan środowiska wykonawczego na tym etapie Stan zarządzania na tym etapie
Środowisko wykonawcze w pełni funkcjonalne zarządzanie w pełni funkcjonalne,

Krok 1. Przygotuj się do uaktualnienia

Te czynności są dodatkiem do standardowych plików, które zwykle tworzysz, np. standardowego pliku konfiguracyjnego Apigee, który umożliwia uaktualnianie komponentów.

  1. Zmień ustawienia Cassandra, aby używać strategii LeveledCompactionStrategy.
  2. Tworzenie kopii zapasowej Cassandra za pomocą Apigee.
  3. Zrób migawki maszyn wirtualnych węzłów Cassandra (jeśli to możliwe).
  4. Utwórz plik konfiguracji uaktualnienia Cassandra na każdym węźle Cassandra pod adresem /opt/apigee/apigee-cassandra/cass_upgrade.conf z treścią:
    # IP Address of node
    HOSTIP=10.0.0.1
    
    # Username for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
    CASS_USERNAME=<cassuser>
    
    # Password for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
    CASS_PASSWORD=<casspass>
    
    # Port for connecting to Cassandra via thrift. Optional. Defaults to 9160 if skipped.
    CASS_PORT=9160
    
    # Port for connecting to Cassandra via CQL. Optional. Defaults to 9042 if skipped.
    CASS_CQL_PORT=9042
    
    # Directory to be used by Cassandra upgrade scripts. Optional. Defaults to /tmp/cass_upgrade_scripts if skipped.
    # Note that if upgrade is successful, this directory is deleted via root user - so provide a directory accordingly.
    CASS_TMP_DIR=/tmp/cass_upgrade_scripts
        
    Jeśli nie można utworzyć pliku na serwerze /opt/apigee/apigee-cassandra/cass_upgrade.conf, utwórz plik /opt/silent.conf z tą samą zawartością na każdym węźle Cassandra.
  5. Jeśli korzystasz z funkcji SmartDocs w portalu deweloperskim Drupal 7 firmy Apigee, wyeksportuj wszystkie modele, pobierając je w formacie JSON z interfejsu portalu deweloperskiego. Po zaktualizowaniu serwerów zarządzania należy ponownie zaimportować te modele do Apigee.
  6. Upewnij się, że porty 9160 i 9042 są dostępne ze wszystkich komponentów usługi CDN do węzłów Cassandra, jeśli nie są dostępne. Więcej informacji znajdziesz w wymaganiach dotyczących portów.

Krok 2. Przekierowywanie ruchu z pierwszego centrum danych

  1. Zablokuj przychodzący ruch dotyczący czasu wykonywania i zarządzania z pierwszego centrum danych.
  2. Przekierowywanie całego ruchu w czasie wykonywania i interfejsów API do zarządzania do innych funkcjonalnych centrów danych.
  3. Sprawdź, czy ruch dotyczący czasu wykonywania i zarządzania jest obsługiwany przez inne centra danych.

Krok 3. Zaktualizuj wszystkie węzły Cassandra w pierwszym centrum danych

  1. Zaktualizuj wszystkie węzły Cassandra w centrum danych 1. Uruchom te polecenia na każdym węźle po kolei:
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. Po zaktualizowaniu węzła uruchom na nim to polecenie, aby przeprowadzić weryfikację:
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
    Wynik będzie wyglądał mniej więcej tak:
    Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified
  3. Po zakończeniu aktualizacji uruchom to polecenie post_upgrade na każdym węźle Cassandra po kolei:
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
Stan środowiska wykonawczego na tym etapie Stan zarządzania na tym etapie
  • Ruch w środowisku wykonawczym jest blokowany w centrum danych, które jest ulepszane
  • Runtime w pełni działa w innych centrach danych

Krok 4. Zaktualizuj wszystkie węzły zarządzania w pierwszym centrum danych

Zaktualizuj wszystkie węzły zarządzania w centrum danych:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Stan środowiska wykonawczego na tym etapie Stan zarządzania na tym etapie
  • Ruch w środowisku wykonawczym jest blokowany w centrum danych, które jest ulepszane
  • Środowisko wykonawcze w pełni funkcjonalne

Krok 5. Zaktualizuj wszystkie węzły środowiska uruchomieniowego w pierwszym centrum danych

Zaktualizuj po kolei wszystkie węzły Routera i przetwarzacza wiadomości w danym centrum danych:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Stan środowiska wykonawczego na tym etapie Stan zarządzania na tym etapie
  • Ruch w środowisku wykonawczym jest blokowany w centrum danych, które jest ulepszane
  • Runtime w pełni działa w innych centrach danych

Krok 6. Przekierowywanie ruchu z powrotem do pierwszego centrum danych

  • Gdy pierwsze centrum danych zostanie zaktualizowane o Cassandra, komponenty środowiska uruchomieniowego i serwer zarządzania, ponownie włącz ruch w środowisku uruchomieniowym i zarządzania do pierwszego centrum danych.
  • Upewnij się, że ruch w czasie wykonywania i zarządzania jest przesyłany do wszystkich węzłów.

Krok 7. Zaktualizuj inne centra danych

Powtarzaj czynności od kroku 1 do kroku 6 w przypadku pozostałych centrów danych, po kolei przekierowując ruch z tych centrów, aktualizując oprogramowanie Apigee i ponownie włączając ruch w tych centrach.

Krok 8. Ponownie uruchom krok uaktualnienia we wszystkich węzłach zarządzania

Ponownie uruchom to polecenie uaktualnienia we wszystkich węzłach zarządzania w różnych centrach danych:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

Krok 9. [Opcjonalnie] Importuj dokumenty inteligentne, które zostały wcześniej wyeksportowane

Po uaktualnieniu wszystkich serwerów zarządzania możesz importować modele inteligentnych dokumentów wyeksportowane w kroku 1. Możesz to zrobić później.

Musisz to zrobić tylko wtedy, gdy korzystasz z portalu dewelopera opartego na Drupalu 7 i używasz funkcji smartdocs.

Stan środowiska wykonawczego na tym etapie Stan zarządzania na tym etapie
Środowisko wykonawcze w pełni funkcjonalne zarządzanie w pełni funkcjonalne,

Krok 10. Usuń nieużywane tabele

Aby usunąć stare nieużywane tabele z klastra Cassandra, uruchom to polecenie: Dopóki nie wykonasz tej operacji, nie będzie można korzystać z niektórych funkcji Cassandra (np. konfigurowania nowego uwierzytelniania – stare mechanizmy uwierzytelniania będą nadal działać). To polecenie można wykonać tylko na jednym węźle w klastrze.

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile

Krok 11. Zaktualizuj wszystkie pozostałe komponenty Edge i inne komponenty do wersji Private Cloud 4.52.02

W każdym regionie uaktualnij pojedynczo wszystkie pozostałe węzły edge-qpid-serveredge-postgres-server.

Jeśli na tym etapie przechodzisz na nowszą wersję z wersji starszych niż Edge for Private Cloud 4.52.01, wykonaj dodatkowe czynności dotyczące uaktualnienia Qpid i Postgres,a następnie uaktualnij pozostałe komponenty zgodnie z tymi instrukcjami.

Przejście na Qpid J-Broker

Chociaż Edge for Private Cloud w wersji 4.52.02 nie zawiera uaktualnienia do Qpid, jeśli przechodzisz na nowszą wersję z wersji starszych niż 4.52.01, musisz wykonać czynności związane z uaktualnieniem QPID.

  • Jeśli przechodzisz z wersji Edge for Private Cloud 4.51.00 lub 4.52.00 na 4.52.02, musisz wykonać dodatkowe czynności związane z uaktualnieniem Qpid. Jeśli przechodzisz z wersji 4.51.00 lub 4.52.00 na 4.52.02, zapoznaj się z sekcją Uaktualnianie Qpid.
  • Jeśli przechodzisz z Edge for Private Cloud 4.52.01 na 4.52.02, musisz już używać najnowszej wersji Qpid Broker. Nie musisz wykonywać dodatkowych czynności związanych z aktualizacją Qpid.

Nowy interfejs Edge

W tej sekcji znajdziesz informacje dotyczące interfejsu Edge. Więcej informacji znajdziesz w artykule Nowy interfejs Edge w Private Cloud.

Instalowanie interfejsu Edge

Po zakończeniu początkowej instalacji Apigee zaleca zainstalowanie interfejsu Edge, który jest ulepszonym interfejsem użytkownika przeznaczonym dla deweloperów i administratorów Apigee Edge for Private Cloud.

Pamiętaj, że interfejs Edge wymaga wyłączenia uwierzytelniania podstawowego i używania IDP, takiego jak SAML lub LDAP.

Więcej informacji znajdziesz w artykule Instalowanie nowego interfejsu Edge.

Aktualizacja interfejsu Edge

Aby zaktualizować komponent interfejsu Edge, rozważ użycie wersji Edge dla chmury prywatnej, z której korzystasz:

Aktualizacja dotycząca mTLS w Apigee

Aby zaktualizować Apigee mTLS , wykonaj te czynności:

Cofanie aktualizacji

W przypadku niepowodzenia aktualizacji możesz spróbować rozwiązać problem, a następnie ponownie wykonać polecenie update.sh. Możesz uruchomić aktualizację kilka razy, a on będzie kontynuować od miejsca, w którym ostatnio się zatrzymał.

Jeśli błąd wymaga przywrócenia poprzedniej wersji, szczegółowe instrukcje znajdziesz w artykule Przywracanie wersji 4.52.00.

Informacje o logowaniu

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

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

Jeśli osoba uruchamiająca narzędzie update.sh nie ma dostępu do tego katalogu, dziennik zostanie zapisany w katalogu /tmp jako plik o nazwie update_username.log.

Jeśli nie masz dostępu do /tmp, narzędzie update.sh nie zadziała.

Aktualizacja bez przestojów

Aktualizacja bez przestojów (krocząca) umożliwia zaktualizowanie instalacji przeglądarki Edge bez wyłączania jej.

Aktualizacja bez przestojów jest możliwa tylko w konfiguracji z 5 lub większą liczbą węzłów.

Kluczem do aktualizacji bez przestojów jest usuwanie pojedynczych routerów z systemu równoważenia obciążenia. Następnie zaktualizuj Router i wszystkie inne komponenty na tym samym komputerze i dodaj Router z powrotem do równoważnika obciążenia.

  1. Zaktualizuj maszyny w prawidłowej kolejności dla danej instalacji, zgodnie z opisem w sekcji Kolejność aktualizacji maszyn.
  2. Gdy nadejdzie czas aktualizacji routerów, wybierz dowolny router i spraw, aby był niedostępny w sposób opisany w sekcji Włączanie i wyłączanie możliwości nawiązania połączenia z serwerem (procesorem wiadomości lub routerem).
  3. Zaktualizuj wybrany router i wszystkie inne komponenty Edge na tym samym komputerze. Wszystkie konfiguracje krawędzi pokazują przełącznik i procesor wiadomości na tym samym węźle.
  4. Spraw, aby router był ponownie dostępny.
  5. Powtórz kroki 2–4 w przypadku pozostałych routerów.
  6. Kontynuuj aktualizację pozostałych maszyn w instalacji.

Przed i po aktualizacji wykonaj te czynności:

Używanie pliku konfiguracji w trybie bez dźwięku

Musisz przekazać do polecenia update plik konfiguracji w trybie cichym. Plik konfiguracji w trybie cichy powinien być tym samym plikiem, którego użyto do zainstalowania Edge w wersji 4.50.00 lub 4.51.00.

Aktualizacja do wersji 4.52.02 na węźle z zewnętrznym połączeniem internetowym

Aby zaktualizować komponenty Edge w węźle:

  1. Jeśli są obecne, wyłącz wszystkie zadania cron skonfigurowane do wykonywania operacji naprawy w Cassandra do czasu zakończenia aktualizacji.
  2. Zaloguj się na węźle jako użytkownik root, aby zainstalować interfejsy RPM Edge.
  3. Zainstaluj yum-utils i yum-plugin-priorities:
    sudo yum install yum-utils
    sudo yum install yum-plugin-priorities
  4. Wyłącz SELinux zgodnie z instrukcjami podanymi w artykule Install the Edge apige-setup utility (w języku angielskim).
  5. Jeśli instalujesz na Oracle 7.x, uruchom to polecenie:
    sudo yum-config-manager --enable ol7_optional_latest
  6. Jeśli instalujesz na AWS, wykonaj te polecenia yum-configure-manager:
    yum update rh-amazon-rhui-client.noarch
    sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  7. Jeśli używasz obecnie przeglądarki Edge w wersji 4.51.00:

    1. Pobierz plik bootstrap_4.52.02.sh w Edge do folderu /tmp/bootstrap_4.52.02.sh:
      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
    2. Zainstaluj narzędzie Edge 4.52.02 apigee-service i odpowiednie zależności, wykonując to polecenie:
      sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

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

      Domyślnie instalator sprawdza, czy masz zainstalowaną wersję Java 1.8. Jeśli tego nie zrobisz, instalator zainstaluje go za Ciebie.

      Aby określić sposób instalowania Java, użyj opcji JAVA_FIX. Argument JAVA_FIX przyjmuje te wartości:

      • I: zainstaluj OpenJDK 1.8 (domyślnie).
      • C: kontynuuj bez instalowania Javy.
      • Q: Zrezygnuj. W tym przypadku musisz samodzielnie zainstalować Javę.
    3. Aby zaktualizować narzędzie apigee-setup, użyj polecenia apigee-service, jak pokazano w tym przykładzie:
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    4. Zaktualizuj narzędzie apigee-validate na serwerze zarządzania, jak pokazano w tym przykładzie:
      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    5. Zaktualizuj narzędzie apigee-provision na serwerze zarządzania, jak pokazano w tym przykładzie:
      /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
    6. Uruchom na swoich węzłach narzędzie update, wykonując to polecenie:
      /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

      Zrób to w kolejności opisanej w sekcji Kolejność aktualizacji maszyny.

      Gdzie:

      • component to komponent Edge, który chcesz zaktualizować. Możliwe wartości:
        • cs: Cassandra
        • edge: wszystkie komponenty Edge oprócz interfejsu Edge: serwer zarządzania, procesor wiadomości, router, serwer Qpid, serwer Postgres.
        • ldap: OpenLDAP
        • ps: postgresql
        • qpid: qpidd
        • sso: logowanie jednokrotne Apigee (jeśli masz zainstalowane SSO)
        • ue: nowy interfejs Edge
        • ui: klasyczny interfejs Edge
        • zk: Dozorca w zoo
      • configFile to ten sam plik konfiguracji, którego użyto do zdefiniowania komponentów Edge podczas instalacji wersji 4.50.00 lub 4.51.00.

      Możesz uruchomić update.sh dla wszystkich komponentów, ustawiając wartość parametru component na „all” (wszystko), ale tylko wtedy, gdy masz profil instalacji Edge all-in-one (AIO). Na przykład:

      /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
    7. Uruchom ponownie komponenty interfejsu Edge na wszystkich węzłach, na których są one używane, jeśli nie zostało to jeszcze zrobione:
      /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
    8. Przetestuj aktualizację, uruchamiając na serwerze zarządzania narzędzie apigee-validate zgodnie z opisem w sekcji Testowanie instalacji.

Jeśli później zdecydujesz się cofnąć aktualizację, wykonaj procedurę opisaną w artykule Cofanie aktualizacji 4.52.02.

Aktualizacja do wersji 4.52.02 z repozytorium lokalnego

Jeśli Twoje węzły peryferyjne znajdują się za zaporą sieciową lub nie mają dostępu do repozytorium Apigee przez Internet, możesz przeprowadzić aktualizację z repozytorium lokalnego lub z lustrzanego repozytorium Apigee.#heading

Po utworzeniu lokalnego repozytorium Edge możesz zaktualizować Edge z lokalnego repozytorium na 2 sposoby:

  • Utwórz plik .tar repozytorium, skopiuj go do węzła, a potem zaktualizuj Edge z pliku .tar.
  • Zainstaluj serwer WWW na węźle z repozytorium lokalnym, aby inne węzły mogły uzyskać 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.52.02:

  1. Utwórz lokalne repozytorium 4.52.02 zgodnie z instrukcjami podanymi w artykule „Tworzenie lokalnego repozytorium Apigee” na stronie Zainstaluj narzędzie do konfiguracji apigee na platformie Edge.
  2. Aby zainstalować apige-service z pliku .tar:
    1. Na węźle z repozytorium lokalnym użyj tego polecenia, aby spakować repozytorium lokalne do pojedynczego pliku .tar o nazwie /opt/apigee/data/apigee-mirror/apigee-4.52.02.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 na przykład skopiować plik do katalogu /tmp w nowym węźle.
    3. Na nowym węźle rozpakuj plik do katalogu /tmp:
      tar -xzf apigee-4.52.02.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 apigee-service i zależne od niego komponenty z poziomu /tmp/repos:
      sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Pamiętaj, że w tym poleceniu musisz podać ścieżkę do katalogu repozytorium.

  3. Aby zainstalować apige-service przy użyciu serwera WWW Nginx:
    1. Skonfiguruj serwer WWW Nginx zgodnie z opisem w sekcji „Install from the repo using the Nginx webserver” (Instalowanie z repozytorium za pomocą serwera WWW Nginx) w artykule Install the Edge apigee-setup utility (Instalowanie narzędzia apigee-setup).
    2. Na węźle zdalnym pobierz plik bootstrap_4.52.02.sh Edge do folderu /tmp/bootstrap_4.52.02.sh:
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh

      Gdzie uName:pWord to nazwa użytkownika i hasło ustawione wcześniej dla repozytorium, a remoteRepo to adres IP lub nazwa DNS węzła repozytorium.

    3. Na węźle zdalnym zainstaluj narzędzie apigee-setup i zależne od niego komponenty:
      sudo bash /tmp/bootstrap_4.52.02.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      gdzie uName:pWord to nazwa użytkownika i hasło do repozytorium.

  4. Aby zaktualizować narzędzie apigee-setup, użyj polecenia apigee-service, jak pokazano w tym przykładzie:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update 
  5. Zaktualizuj narzędzie apigee-validate na serwerze zarządzania, jak pokazano w tym przykładzie:
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. Zaktualizuj narzędzie apigee-provision na serwerze zarządzania, jak pokazano w tym przykładzie:
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. Uruchom narzędzie update na węzłach w kolejności opisanej w sekcji Kolejność aktualizacji maszyny:
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    Gdzie:

    • component to komponent Edge, który chcesz zaktualizować. Zwykle aktualizujesz te komponenty:
      • cs: Cassandra
      • edge: wszystkie komponenty Edge o wyjątkiem interfejsu Edge: serwer zarządzania, procesor wiadomości, router, serwer Qpid, serwer Postgres.
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: logowanie jednokrotne Apigee (jeśli masz zainstalowane SSO)
      • ue Nowy interfejs Edge
      • ui: klasyczny interfejs Edge
      • zk: Dozorca w zoo
    • configFile to ten sam plik konfiguracji, którego użyto do zdefiniowania komponentów Edge podczas instalacji wersji 4.50.00 lub 4.51.00.

    Możesz uruchomić update.sh dla wszystkich komponentów, ustawiając wartość parametru component na „all” (wszystko), ale tylko wtedy, gdy masz profil instalacji Edge all-in-one (AIO). Na przykład:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
  8. Ponownie uruchom komponenty interfejsu na wszystkich węzłach, na których są one używane, jeśli nie zrobiono tego jeszcze wcześniej:
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. Przetestuj aktualizację, uruchamiając na serwerze zarządzania narzędzie apigee-validate zgodnie z opisem w sekcji Testowanie instalacji.

Jeśli później zdecydujesz się cofnąć aktualizację, skorzystaj z procedury opisanej w artykule Cofanie aktualizacji 4.52.02.

Kolejność aktualizacji maszyny – uaktualnienie z wersji 4.51.00 (lub) 4.52.00 (lub) 4.52.01

Kolejność aktualizowania maszyn w instalacji Edge jest ważna:

  • Przed uaktualnieniem pozostałych komponentów musisz zaktualizować wszystkie węzły ZooKeeper w centrach danych. Jeśli przechodzisz z wersji Edge Private Cloud 4.51.00 lub 4.52.00, musisz też wykonać dodatkowe czynności, aby uaktualnić zookeepera.
  • Musisz zaktualizować Postgres we wszystkich centrach danych. Jeśli przechodzisz z wersji Edge Private Cloud 4.51.00, musisz też wykonać dodatkowe czynności, aby uaktualnić postgres.
  • Musisz zaktualizować węzły LDAP we wszystkich centrach danych.
  • Musisz zaktualizować wszystkie węzły Cassandra, serwera zarządzającego, procesora wiadomości i przekaźnika pojedynczo w każdym centrum danych, aż do momentu uaktualnienia wszystkich centrów danych.
  • Musisz zaktualizować komponenty edge-qpid-serveredge-postgres-server we wszystkich centrach danych.
  • Musisz uaktualnić węzły Qpid we wszystkich centrach danych. Jeśli przechodzisz z wersji Edge Private Cloud 4.51.00 lub 4.52.00, musisz też wykonać dodatkowe czynności, aby uaktualnić Qpid.
  • Aktualizacja interfejsu Edge i nowego interfejsu Edge, węzły SSO we wszystkich centrach danych.
  • Nie ma osobnego kroku do zaktualizowania sekcji Zarabianie. Jest on aktualizowany, gdy podasz opcję -c edge.

Samodzielna licencja na 1 węzeł

Aby uaktualnić konfigurację samodzielną z 1 węzłem do wersji 4.52.02:
  1. Aktualizacja wszystkich komponentów:
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. (jeśli masz zainstalowaną aplikację apigee-adminapi) zaktualizuj narzędzie apigee-adminapi:
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

Samodzielna licencja na 2 węzły

W przypadku samodzielnej instalacji z 2 węzłami zaktualizuj te komponenty:

Aby zobaczyć listę topologii Edge i numerów węzłów, otwórz stronę Topologie instalacji.

  1. Zaktualizuj Zookeepera na maszynie 1:
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. Zaktualizuj Postgres na maszynie 2:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Zaktualizuj LDAP na maszynie 1:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Zaktualizuj system Cassandra na maszynie 1:
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  5. Zaktualizuj komponenty Edge na maszynie 1 i 2:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Zmień Qpid na maszynie 2:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Zaktualizuj interfejs na maszynie 1:
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. (jeśli zainstalowano apigee-adminapi) Zaktualizowano narzędzie apigee-adminapi na komputerze 1:
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (jeśli masz zainstalowane logowanie jednokrotne Apigee) zaktualizuj logowanie jednokrotne Apigee na komputerze 1:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Gdzie sso_config_file to plik konfiguracji utworzony podczas instalowania logowania jednokrotnego.

  10. Zrestartuj komponent interfejsu Edge na komputerze 1:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Uaktualnienie 5 węzłów

W przypadku instalacji z 5 węzłami zaktualizuj te komponenty:

Aby zobaczyć listę topologii Edge i numerów węzłów, otwórz stronę Topologie instalacji.

  1. Zaktualizuj ZooKeeper na maszynach 1, 2 i 3:
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. Zaktualizuj Postgresa na maszynie 4:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Zaktualizuj Postgres na maszynie 5:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Zaktualizuj LDAP na maszynie 1:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Zaktualizuj Cassandra na maszynach 1, 2 i 3:
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. Zaktualizuj komponenty Edge na maszynach 1, 2, 3, 4, 5:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Zaktualizuj Qpid na maszynie 4:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Aktualizacja Qpid na maszynie 5:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  9. Zaktualizuj interfejs Edge:
    • Klasyczny interfejs: jeśli używasz klasycznego interfejsu, zaktualizuj komponent ui na maszynie 1, jak pokazano w tym przykładzie:
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    • Nowe środowisko Edge: jeśli zainstalowano nowe środowisko Edge, zaktualizuj komponent ue na odpowiednim urządzeniu (niekoniecznie na urządzeniu 1):
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  10. (jeśli zainstalowano apigee-adminapi) Zaktualizowano narzędzie apigee-adminapi na komputerze 1:
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  11. (jeśli masz zainstalowane logowanie jednokrotne Apigee) zaktualizuj logowanie jednokrotne Apigee na komputerze 1:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Gdzie sso_config_file to plik konfiguracji utworzony podczas instalacji logowania jednokrotnego.

  12. Ponownie uruchom komponent interfejsu:
    • Klasyczny interfejs: jeśli używasz klasycznego interfejsu, uruchom ponownie komponent edge-ui na maszynie 1, jak pokazano w tym przykładzie:
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Nowy interfejs Edge: jeśli zainstalowano nowy interfejs Edge, uruchom ponownie komponent edge-management-ui na odpowiednim urządzeniu (niekoniecznie na urządzeniu 1):
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Uaktualnienie klastra 9-węzłowego

W przypadku instalacji z 9 węzłami w klastrze zaktualizuj te komponenty:

Aby zobaczyć listę topologii Edge i numerów węzłów, otwórz stronę Topologie instalacji.

  1. Zaktualizuj ZooKeepera na maszynach 1, 2 i 3:
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. Zaktualizuj Postgresa na maszynie 8:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Zaktualizuj Postgres na maszynie 9:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Zaktualizuj LDAP na maszynie 1:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Zaktualizuj Cassandra na maszynach 1, 2 i 3:
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. Zaktualizuj komponenty Edge na maszynach 1, 4, 5, 6, 7, 8 i 9 w tej kolejności:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Zaktualizuj Qpid na maszynach 6 i 7:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Zaktualizuj nowy interfejs (ue) lub klasyczny interfejs (ui) na komputerze 1:
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  9. (jeśli zainstalowano apigee-adminapi) Zaktualizuj narzędzie apigee-adminapi na komputerze 1:
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (jeśli masz zainstalowane logowanie jednokrotne Apigee) zaktualizuj logowanie jednokrotne Apigee na komputerze 1:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Gdzie sso_config_file to plik konfiguracji utworzony podczas instalacji logowania jednokrotnego.

  11. Ponownie uruchom komponent interfejsu:
    • Klasyczny interfejs: jeśli używasz klasycznego interfejsu, uruchom ponownie komponent edge-ui na maszynie 1, jak pokazano w tym przykładzie:
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Nowy interfejs Edge: jeśli zainstalowano nowy interfejs Edge, uruchom ponownie komponent edge-management-ui na odpowiednim urządzeniu (niekoniecznie na urządzeniu1):
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Uaktualnienie klastra 13-węzłowego

W przypadku instalacji z 13 węzłami zaktualizuj te komponenty:

Aby zobaczyć listę topologii Edge i numerów węzłów, otwórz stronę Topologie instalacji.

  1. Zaktualizuj ZooKeeper na maszynach 1, 2 i 3:
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. Zaktualizuj Postgresa na maszynie 8:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Zaktualizuj Postgres na maszynie 9:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Zaktualizuj LDAP na maszynach 4 i 5:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Zaktualizuj Cassandra na maszynach 1, 2 i 3:
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. Zaktualizuj komponenty Edge na maszynach 6, 7, 10, 11, 12, 13, 8 i 9 w podanej kolejności:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Zaktualizuj Qpid na maszynach 12 i 13:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Zaktualizuj nowy interfejs (ue) lub klasyczny interfejs (ui) na maszynach 6 i 7:
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  9. (Jeśli zainstalowano apigee-adminapi) Zaktualizowano narzędzie apigee-adminapi na maszynach 6 i 7:
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (jeśli masz zainstalowane logowanie jednokrotne Apigee) zaktualizuj logowanie jednokrotne Apigee na maszynach 6 i 7:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Gdzie sso_config_file to plik konfiguracji utworzony podczas instalacji logowania jednokrotnego.

  11. Ponownie uruchom komponent interfejsu:
    • Klasyczny interfejs użytkownika: jeśli używasz klasycznego interfejsu użytkownika, ponownie uruchom komponent edge-ui na maszynach 6 i 7, jak pokazano w tym przykładzie:
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Nowy interfejs Edge: jeśli zainstalowano nowy interfejs Edge, uruchom ponownie komponent edge-management-ui na maszynach 6 i 7:
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Uaktualnienie klastra 12-węzłowego

W przypadku instalacji z 12 węzłami zaktualizuj te komponenty:

Aby zobaczyć listę topologii Edge i numerów węzłów, otwórz stronę Topologie instalacji.

  1. Zaktualizuj ZooKeeper na maszynach 1,2,3,7,8,9 w obu centrach danych:

    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. Zaktualizuj Postgres na maszynach 6,12 w obu centrach danych:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Zaktualizuj LDAP na maszynach 1,7 w obu centrach danych:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Zablokuj ruch w DC-1 i upewnij się, że cały ruch jest przekierowywany do innego regionu DC-2.

  5. Aktualizacja Cassandra na maszynach 1, 2 i 3 w DC-1:
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. Zaktualizuj serwer zarządzania na maszynie 1 w domenie kontrolera domen DC-1:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Aktualizacja routera i procesora wiadomości na maszynach 2 i 3 w DC-1:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. Odblokuj ruch w regionie DC-1 i sprawdź jego poprawność, a następnie przejdź do regionu DC-2, blokując ruch w regionie DC-2 i przekierowując go do regionu DC-1.
  9. Zaktualizuj Cassandra na maszynach 7,8,9 w DC-2:
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  10. Zaktualizuj serwer zarządzania na maszynie 7 w DC-2:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. Aktualizacja routera, procesora wiadomości na maszynie 8,9 w DC-2:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. Odblokuj ruch w DC-2. Teraz ruch będzie obsługiwany przez oba centra danych.
  13. Ponownie uruchom polecenie update na wszystkich serwerach zarządzania w maszynach wirtualnych DC na maszynach 1 i 7:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  14. Zaktualizuj edge-qpid-server i edge-postgres-server na maszynach 4,5,6,10,11,12 w obu centrach danych:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  15. Zaktualizuj Qpid na maszynach 4,5,10,11 w obu centrach danych:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  16. Zaktualizuj nowy interfejs użytkownika (ue) lub klasyczny interfejs użytkownika (ui) w obu centrach danych:
    /opt/apigee/apigee-setup/bin/update.sh -c  [ui|ue] -f configFile
  17. (jeśli masz zainstalowany interfejs apigee-adminapi) Zaktualizuj interfejs apigee-adminapi w obu centrach danych:
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  18. (jeśli masz zainstalowane logowanie jednokrotne Apigee) Zaktualizuj węzły logowania jednokrotnego Apigee w obu centrach danych:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
  19. Ponownie uruchom nowy interfejs Edge (edge-management-ui) lub klasyczny interfejs Edge (edge-ui) w obu centrach danych:
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart