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 interfejsów Edge RPM może je skonfigurować dowolna osoba.

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 Kopie zapasowe i przywracanie.

• 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

• Sprawdź, czy strategia kompresji Cassandra jest ustawiona na 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:
  • Jeśli przechodzisz z wersji 4.51.00, zapoznaj się z dokumentem Strategia kompresji Cassandra w wersji 4.51.00.
  • Jeśli przechodzisz z wersji 4.52.00, zapoznaj się z dokumentem Strategia kompresji Cassandra w wersji 4.52.00.
  • Jeśli przechodzisz z wersji 4.52.01, zapoznaj się z dokumentem Strategia kompresji Cassandra w wersji 4.52.01.

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 oprogramowanie, które wymaga dodatkowych czynności. Postępuj zgodnie ze szczegółowymi instrukcjami dotyczącymi każdego z nich. Po wykonaniu niezbędnych czynności wrócisz do głównej procedury uaktualniania, aby kontynuować proces.

Po wykonaniu odpowiednich czynności w zależności od wersji wrócisz 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 podczas aktualizacji.

Wymagane uaktualnienie do wersji 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, konieczne było wprowadzenie pewnych zmian w modelu danych Apigee w Cassandra, aby zapewnić optymalną wydajność w nowszych wersjach. Chociaż zmiany są minimalne, proces uaktualniania zakłóca działanie niektórych interfejsów API do zarządzania, co wpływa zarówno na interfejs Apigee, jak i portal dla deweloperów. W poniższym dokumencie określono, które interfejsy API nie będą działać, oraz opisano kroki, które należy wykonać podczas uaktualniania, kiedy zaczyna się i kończy przerwa w działaniu. Podczas aktualizacji nie powinno dojść do przerw w ruchu.

Wycofanie zmian na wysokim poziomie

Uaktualniaj Cassandra po jednym węźle naraz. Gdy tylko węzeł zostanie zaktualizowany, niektóre zmiany schematu zaczną obowiązywać, ale nie będzie można ich cofnąć bezpośrednio. Dokładnie przeczytaj sekcję dotyczącą cofania zmian, ponieważ w zależności od tego, jak duży obszar klastra został uaktualniony, możesz stosować różne techniki.

Jeśli musisz cofnąć uaktualnienie po uaktualnieniu całego klastra Cassandra, jedyną opcją jest przywrócenie kopii zapasowych. Przygotuj się do tego i zapoznaj się z przywracaniem kopii zapasowej Cassandra. Jeśli możesz przywrócić zrzuty na poziomie maszyny wirtualnej szybciej niż kopie zapasowe Apigee, użyj zrzutów maszyn wirtualnych, aby przywrócić maszyny wirtualne Cassandra do wcześniejszego stanu.

Więcej informacji znajdziesz w sekcji Cofnięcie aktualizacji Cassandra 3.11.16.

Dokumentowanie interfejsów API w portalu dla deweloperów

Portal dla programistów Drupal w Apigee oferuje różne funkcje do dokumentowania interfejsów API. Zalecamy przejście z używania portalu dla programistów opartego na Drupalu 7, ale jeśli nadal z niego korzystasz i używasz w nim 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. Musisz ręcznie wyeksportować każdy model za pomocą portalu dla deweloperów i ponownie go zaimportować po zakończeniu przekształcania.

Terminologia używana w następnych sekcjach

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 skutecznego przetwarzania żądania interfejsu API w czasie wykonywania dla 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 administrację systemu 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).

Na każdym z podanych niżej kroków opisujemy stan środowiska uruchomienia i zarządzania na poszczególnych etapach procedury uaktualniania. Pamiętaj, że podczas uaktualniania nie ma to wpływu na ruch w czasie wykonywania. Wystąpiły jednak zakłócenia w działaniu niewielkiego podzbioru interfejsów API do zarządzania i funkcji portalu dla deweloperów.

Krok 0. Stan początkowy

1. Cassandra w Apigee z wersją 2.1.22.
2. Komponenty Edge for Private Cloud 4.52.02:
• 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.

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

• 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.
• Upewnij się, że porty 9160 i 9042 są dostępne z wszystkich komponentów Edge for Private Cloud 4.52.02 do węzłów Cassandra (jeśli nie są już dostępne). Więcej informacji znajdziesz w wymaganiach dotyczących portów.

Krok 2. Zaktualizuj wszystkie węzły Cassandra

1. Zaktualizuj wszystkie węzły Cassandra we wszystkich regionach pojedynczo. Uruchom na każdym węźle te polecenia:

   /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

3. Powyższe polecenie zwróci coś takiego:

   Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified

Krok 3. Zaktualizuj wszystkie węzły zarządzania

Zaktualizuj wszystkie węzły zarządzania we wszystkich regionach pojedynczo:

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

Krok 3a. [Opcjonalnie] Zaimportuj wcześniej wyeksportowane dokumenty SmartDocs

Gdy wszystkie serwery zarządzania zostaną zaktualizowane, możesz zaimportować modele SmartDocs wyeksportowane w kroku 1. Możesz to zrobić również później.

Krok 4. Zaktualizuj wszystkie węzły środowiska wykonawczego

Zaktualizuj po kolei wszystkie węzły Routera i przetwarzacza wiadomości we wszystkich regionach:

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

Krok 5. Zaktualizuj wszystkie pozostałe komponenty Edge for Private Cloud 4.52.02

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

Jeśli na tym etapie przechodzisz z wersji starszych niż Edge for Private Cloud 4.52.01 i wykonujesz dodatkowe czynności dotyczące uaktualniania Qpid lub Postgres, wykonaj odpowiednie czynności, aby uaktualnić te usługi.

Krok 6. Co zrobić po uaktualnieniu

Po zakończeniu aktualizacji uruchom to polecenie na każdym węźle Cassandra po kolei:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade

Aby usunąć stare nieużywane tabele z klastra Cassandra, uruchom to polecenie: Dopóki nie uruchomisz tego polecenia, nie będziesz mieć dostępu do niektórych funkcji Cassandra (np. do konfigurowania nowego uwierzytelniania – stare mechanizmy uwierzytelniania będą nadal działać). To polecenie można wykonać tylko na 1 węźle w klastrze:

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

Jeśli nie zostało to jeszcze zrobione, wykonaj krok 3a.

Wymagane uaktualnienie do Zookeeper 3.8.3

Chociaż wersja Edge for Private Cloud 4.52.02 nie zawiera uaktualnienia do Zookeeper, jeśli przechodzisz z wersji starszej niż 4.52.01, musisz wykonać czynności związane z uaktualnieniem Zookeeper.

• Jeśli przechodzisz z wersji Edge for Private Cloud 4.51.00 lub 4.52.00, postępuj zgodnie z instrukcjami 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.

Wymaga uaktualnienia do 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ć dodatkowych czynności związanych z uaktualnieniem Postgres.

Wymagane uaktualnienie do Qpid J-Broker

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

• Jeśli przechodzisz z Edge for Private Cloud 4.51.00 lub 4.52.00 na 4.52.02, musisz wykonać dodatkowe czynności związane z przejściem na 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 w wersji 4.52.01 na wersję 4.52.02, prawdopodobnie korzystasz już z najnowszej wersji Qpid Broker i nie musisz wykonywać dodatkowych czynności związanych z uaktualnieniem 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, sprawdź, z której wersji Edge for Private Cloud chcesz przejść:

• Z wersji 4.51.00 na 4.52.00 (przy zainstalowanym nowym interfejsie Edge): skorzystaj z instrukcji uaktualniania w tej sekcji dotyczących komponentu edge-management-ui.

Aktualizacja dotycząca mTLS w Apigee

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

• Odinstaluj mTLS Apigee.
• Ponownie zainstaluj interfejs Apigee mTLS.

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ć ją od miejsca, w którym została przerwana.

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 z 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 dana osoba nie ma dostępu do /tmp, narzędzie update.sh nie dział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 pojedynczo każdego routera z systemu równoważenia obciążenia. Następnie zaktualizuj Router i wszystkie inne komponenty na tym samym urządzeniu, a potem ponownie dodaj Router do systemu równoważenia obciążenia.

1. Zaktualizuj maszyny w prawidłowej kolejności dla danej instalacji, zgodnie z opisem w artykule 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 dotarcia do serwera (procesora wiadomości lub routera).
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:

• W kompleksowym węźle Router i Message Processor:
  • Przed aktualizacją:
    1. Uniemożliwić dostęp do routera.
    2. Uniemożliwić dostęp do usługi Message Processor.
  • Po aktualizacji wykonaj te czynności:
    1. Upewnij się, że usługa Message Processor jest dostępna.
    2. Upewnij się, że router jest dostępny.
• Na węzłach z jednym routerem:
  • Przed aktualizacją uniemożliw dostęp do routera.
  • Po aktualizacji sprawdź, czy router jest dostępny.
• W węzłach przetwarzania pojedynczych wiadomości:
  • Przed aktualizacją ustaw przetwarzanie wiadomości na niedostępne.
  • Po aktualizacji sprawdź, czy można uzyskać dostęp do usługi Message Processor.

Używanie pliku konfiguracji w trybie bez obrazu

Musisz przekazać poleceniemu 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 wykonania 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 apigee-setup utility (instalowanie narzędzia apige-setup w Edge).
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 z 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 obsługi instalacji 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: interfejs klasycznej wersji Edge
        • zk: opiekun 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 komponent interfejsu Edge na wszystkich węzłach, na których działa, jeśli nie zostało to zrobione wcześniej:

      /opt/apigee/apigee-service/bin/apigee-service 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 wersji 4.52.02.

Aktualizacja do wersji 4.52.02 z repozytorium lokalnego

Jeśli Twoje węzły Edge są za zaporą ogniową lub w inny sposób nie mają dostępu do repozytorium Apigee przez Internet, możesz przeprowadzić aktualizację z repozytorium lokalnego lub z lustra repozytorium Apigee.

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-setup na serwerze 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 maszyn:

   /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 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: interfejs klasycznej wersji Edge
     • zk: opiekun w zoo
   • configFile to ten sam plik konfiguracji, który został użyty 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 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ę, wykonaj procedurę opisaną w artykule Cofanie wersji 4.52.02.

Kolejność aktualizacji maszynowych

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

• Przed zaktualizowaniem innych węzłów musisz zaktualizować wszystkie węzły Cassandra i ZooKeeper.
• W przypadku maszyny z wieloma komponentami Edge (serwer Management, Message Processor, Router, serwer QPID, ale nie serwer Postgres) użyj opcji -c edge, aby zaktualizować je wszystkie jednocześnie.
• Jeśli krok określa, że należy go wykonać na wielu maszynach, wykonaj go w określonej kolejności.
• Nie ma osobnego kroku, który pozwoliłby zaktualizować sekcję Zarabianie. Jest on aktualizowany, gdy określisz 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 Cassandra i ZooKeeper na maszynie 1:

   /opt/apigee/apigee-setup/bin/update.sh -c cs,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. Aktualizacja komponentów Edge na maszynach 2 i 1:

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

5. Zmień Qpid na maszynie 2:

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

6. Zaktualizuj interfejs na maszynie 1:

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

7. (jeśli zainstalowano apigee-adminapi) Zaktualizowano narzędzie apigee-adminapi na komputerze 1:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

8. (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.

9. 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 Cassandra i ZooKeeper na maszynach 1, 2 i 3:

   /opt/apigee/apigee-setup/bin/update.sh -c cs,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 komponenty Edge na maszynach 4, 5, 1, 2, 3:

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

6. Zaktualizuj Qpid na maszynie 4:

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

7. Aktualizacja Qpid na maszynie 5:

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

8. 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 masz zainstalowane 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

9. (jeśli zainstalowano apigee-adminapi) Zaktualizowano 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 interfejs:
    • Klasyczny interfejs użytkownika: jeśli używasz klasycznego interfejsu użytkownika, ponownie uruchom 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 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 Cassandra i ZooKeeper na maszynach 1, 2 i 3:

   /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

2. Zaktualizuj Postgresa na maszynie 8:

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

3. Zaktualizuj Postgresa 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 komponenty Edge na maszynach 6, 7, 8, 9, 1, 4 i 5 w podanej kolejności:

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

6. Zaktualizuj Qpid na maszynach 6 i 7:

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

7. Zaktualizuj nowy interfejs (ue) lub klasyczny interfejs (ui) na komputerze 1:

   /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

8. (jeśli zainstalowano apigee-adminapi) Zaktualizuj 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 instalacji logowania jednokrotnego.

10. Ponownie uruchom interfejs:
    • Klasyczne interfejs użytkownika: jeśli używasz klasycznego interfejsu użytkownika, 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 Cassandra i ZooKeeper na maszynach 1, 2 i 3:

   /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

2. Zaktualizuj Postgresa na maszynie 8:

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

3. Zaktualizuj Postgresa 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 komponenty Edge na maszynach 12, 13, 8, 9, 6, 7, 10 i 11 w podanej kolejności:

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

6. Zaktualizuj Qpid na maszynach 12 i 13:

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

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

8. (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

9. (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.

10. Ponownie uruchom interfejs:
    • 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 Cassandra i ZooKeeper:
   1. W maszynach 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 Postgres:
   1. Maszyna 6 w centrum danych 1

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

   2. Maszyna 12 w centrum danych 2

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

3. Zaktualizuj LDAP:
   1. Maszyna 1 w centrum danych 1

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

   2. Maszyna 7 w centrum danych 2

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

4. Aktualizowanie komponentów 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

5. Zaktualizuj qpidd:
   1. Maszyny 4 i 5 w centrum danych 1
      1. Aktualizacja qpidd na maszynie 4:

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

      2. Aktualizacja qpidd na maszynie 5:

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

   2. Maszyny 10 i 11 w centrum danych 2
      1. Aktualizacja qpidd na maszynie 10:

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

      2. Aktualizacja qpidd na maszynie 11:

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

6. Zaktualizuj nowy interfejs (ue) lub klasyczny interfejs (ui):
   1. Maszyna 1 w centrum danych 1:

      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

   2. Maszyna 7 w centrum danych 2:

      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

7. (jeśli masz zainstalowaną aplikację apigee-adminapi) Zaktualizuj narzędzie apigee-adminapi:
   1. Maszyna 1 w centrum danych 1:

      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

   2. Maszyna 7 w centrum danych 2:

      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

8. (Jeśli masz zainstalowane logowanie jednokrotne Apigee) Zaktualizuj logowanie jednokrotne Apigee:
   1. Maszyna 1 w centrum danych 1:

      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   2. Maszyna 7 w centrum danych 2:

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

9. Ponownie uruchom interfejs nowego Edge (edge-management-ui) lub klasycznego Edge (edge-ui) na maszynach 1 i 7:

   /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

Konfiguracja niestandardowa

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

1. ZooKeeper
2. Cassandra
3. ps
4. LDAP
5. Edge, czyli profil „-c edge” na wszystkich węzłach w kolejności: węzły z serwerem Qpid, serwer Postgres Edge, serwer Management, przetwarzacz wiadomości i router.
6. qpidd
7. Interfejs Edge (klasyczny lub nowy)
8. apigee-adminapi
9. Logowanie jednokrotne Apigee

Po zakończeniu aktualizacji uruchom ponownie komponent interfejsu użytkownika Edge na wszystkich maszynach, na których jest on uruchomiony.