Zaktualizuj Apigee Edge do wersji 4.19.06 lub 4.50.00 do 4.51.00

Z tej sekcji dowiesz się, jak uaktualnić Apigee Edge z wersji 4.19.06 lub 4.50.00 do wersji 4.51.00.

Kto może przeprowadzić aktualizację

Osoba uruchamiająca aktualizację powinna być tą samą osobą, która pierwotnie zainstalowała Edge, lub użytkownikiem z uprawnieniami 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.

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.

Wymagana aktualizacja do Postgres 10.17

Ta wersja przeglądarki Edge zawiera uaktualnienie do wersji Postgres 10.17. W ramach tej aktualizacji wszystkie dane Postgres są przenoszone do wersji Postgres 10.17.

Większość produkcyjnych systemów Edge korzysta z 2 węzłów Postgresa skonfigurowanych pod kątem replikacji typu master-standby. Podczas procesu aktualizacji, gdy węzły Postgres są niedostępne, dane analityczne są nadal zapisywane na węzłach Qpid. Gdy węzły Postgres zostaną zaktualizowane i znów będą dostępne online, dane analityczne zostaną przesłane do węzłów Postgres.

Sposób wykonania aktualizacji Postgres zależy od sposobu konfiguracji przechowywania danych dla węzłów Postgres:

  • Jeśli używasz lokalnego magazynu danych dla węzłów PostgreSQL, musisz zainstalować nowy węzeł zapasowy PostgreSQL na czas uaktualniania. Po zakończeniu uaktualnienia możesz wycofać z użycia nowy węzeł zapasowy Postgres.

    Dodatkowy węzeł zapasowy PostgreSQL jest wymagany, jeśli z jakiegokolwiek powodu musisz cofnąć aktualizację. Jeśli trzeba cofnąć aktualizację, nowy węzeł PostgreSQL stanie się głównym węzłem PostgreSQL po cofnięciu. Dlatego podczas instalowania nowego węzła zapasowego Postgres powinien on znajdować się na węźle, który spełnia wszystkie wymagania sprzętowe serwera Postgres określone w wymaganiach instalacyjnych Edge.

    W topologiach Edge z 1 lub 2 węzłami, które są używane do prototypowania i testowania, masz tylko 1 węzeł Postgres. Możesz aktualizować te węzły Postgres bezpośrednio bez tworzenia nowego węzła Postgres.

  • Jeśli używasz sieciowej pamięci masowej dla węzłów Postgres, zgodnie z zaleceniami Apigee, nie musisz instalować nowego węzła Postgres. W opisanych poniżej procedurach możesz pominąć czynności związane z instalacją i późniejszym wycofaniem nowego węzła zapasowego Postgres.

    Zanim rozpoczniesz proces aktualizacji, zrób zrzut sieciowy magazynu danych używanego przez Postgresa. Jeśli podczas aktualizacji wystąpią błędy i będzie trzeba cofnąć zmiany, możesz przywrócić węzeł Postgres z tego migawka.

Instalowanie nowego węzła zapasowego Postgres

Ta procedura tworzy serwer zapasowy Postgres na nowym węźle. Upewnij się, że instalujesz nowy serwer zapasowy Postgres dla dotychczasowej wersji Edge (4.19.06 lub 4.50.00), a nie wersji 4.51.00.

Aby przeprowadzić instalację, użyj tego samego pliku konfiguracji, którego użyto do zainstalowania bieżącej wersji Edge.

Aby utworzyć nowy węzeł zapasowy Postgres:

  1. Na bieżącym hoście głównym Postgres otwórz plik /opt/apigee/customer/application/postgresql.properties, aby ustawić ten token. Jeśli plik nie istnieje, utwórz go: 
    conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust

    Gdzie existing_standby_ip to adres IP obecnego serwera zastępczego Postgres, a new_standby_ip to adres IP nowego węzła zastępczego.

  2. Uruchom ponownie apigee-postgresql na serwerze głównym Postgres: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. Sprawdź, czy nowy węzeł zapasowy został dodany, wyświetlając plik /opt/apigee/apigee-postgresql/conf/pg_hba.conf na węźle głównym. W tym pliku powinny się wyświetlić te wiersze: 
    host replication apigee existing_standby_ip/32 trust
host replication apigee new_standby_ip/32 trust
  4. Zainstaluj nowy serwer zapasowy Postgres:
    1. Edytuj plik konfiguracji, którego użyto do zainstalowania bieżącej wersji Edge, aby określić: 
      # IP address of the current master:
PG_MASTER=192.168.56.103
# IP address of the new standby node
PG_STANDBY=192.168.56.102
    2. Wyłącz SELinux zgodnie z instrukcjami podanymi w artykule Instalowanie narzędzia apigee-setup w Edge.
    3. Wykonaj jedną z tych czynności w zależności od tego, z której wersji Edge przechodzisz na nowszą:
      • Jeśli przechodzisz z Edge 4.19.06, pobierz plik Edge bootstrap_4.19.06.sh do folderu /tmp/bootstrap_4.19.06.sh : 
        curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh

        Następnie zainstaluj narzędzie apigee-service i zależne od niego komponenty: 

        sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord

      • Jeśli przechodzisz z Edge 4.50.00, pobierz plik Edge bootstrap_4.50.00.sh do folderu /tmp/bootstrap_4.50.00.sh : 
        curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh

        Następnie zainstaluj narzędzie apigee-service i zależne od niego komponenty: 

        sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord

    4. Aby zainstalować narzędzie apigee-setup, użyj narzędzia apigee-service: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    5. Zainstaluj Postgres: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    6. Na nowym węźle zapasowym uruchom to polecenie: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Sprawdź, czy jest to tryb gotowości.

Przeprowadzanie uaktualnienia na miejscu bazy danych Postgres

Aby przeprowadzić uaktualnienie na miejscu do wersji Postgres 10.17, wykonaj te czynności:

  1. Zaktualizuj postgres na hoście mastera. 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  2. Uruchom polecenie konfiguracji na hoście głównym: 
    apigee-service apigee-postgresql setup -f /opt/silent.conf
  3. Uruchom polecenie konfiguracji na hoście głównym: 
    apigee-service apigee-postgresql configure
  4. Ponownie uruchom hosta głównego: 
    apigee-service apigee-postgresql restart
  5. Skonfiguruj go jako główny: 
    apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf
  6. Upewnij się, że host master został uruchomiony: 
    apigee-service apigee-postgresql wait_for_ready
  7. Zatrzymanie trybu czuwania: 
    apigee-service apigee-postgresql stop
  8. Uaktualnij stan gotowości.

    Uwaga: jeśli ten krok się nie powiedzie lub wygeneruje błąd, możesz go zignorować. update.sh spróbuje uruchomić serwer zapasowy z nieprawidłową konfiguracją. Jeśli instalacja Postgres została zaktualizowana do wersji 10.17, błąd można zignorować.

    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  9. Upewnij się, że tryb gotowości jest zatrzymany: 
    apigee-service apigee-postgresql stop
  10. Usuń starą konfigurację trybu gotowości: 
    rm -rf /opt/apigee/data/apigee-postgresql/
  11. Skonfiguruj replikację na serwerze zapasowym: 
    apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf

Po wykonaniu tej procedury tryb gotowości zostanie uruchomiony.

Wycofywanie węzła Postgres

Po zakończeniu aktualizacji wycofaj nowy węzeł zapasowy:

  1. Upewnij się, że usługa Postgres jest uruchomiona: 
    /opt/apigee/apigee-service/bin/apigee-all status

    Jeśli usługa Postgres nie działa, uruchom ją: 

    /opt/apigee/apigee-service/bin/apigee-all start

  2. Aby uzyskać identyfikator UUID nowego węzła zapasowego, uruchom na nim to polecenie curl: 
    curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

    Na końcu danych wyjściowych powinien pojawić się identyfikator UUID węzła w formie: 

    "type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"

  3. Zatrzymaj nowy węzeł zapasowy, wykonując to polecenie na nowym węźle zapasowym: 
    /opt/apigee/apigee-service/bin/apigee-all stop
  4. Na głównym węźle Postgres edytuj plik /opt/apigee/customer/application/postgresql.properties, aby usunąć nowy węzeł zapasowy z pliku conf_pg_hba_replication.connection: 
    conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
  5. Uruchom ponownie apigee-postgresql na hoście głównym Postgres: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  6. Sprawdź, czy nowy węzeł zapasowy został usunięty, wyświetlając plik /opt/apigee/apigee-postgresql/conf/pg_hba.conf na węźle głównym. W tym pliku powinien pojawić się tylko ten wiersz: 
    host replication apigee existing_standby_ip/32 trust
  7. Usuń identyfikator UUID węzła zapasowego z ZooKeepera, wykonując to wywołanie interfejsu API zarządzania Edge na węźle serwera zarządzania: 
    curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

Aktualizacja wymagań wstępnych

Przed uaktualnieniem Apigee Edge spełnij 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 działa
    Sprawdź, czy przeglądarka Edge działa podczas procesu aktualizacji, używając tego polecenia: 
    /opt/apigee/apigee-service/bin/apigee-all status

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.19.06 lub 4.50.00 na 4.51.00 (z nową wersją interfejsu Edge już zainstalowaną): skorzystaj z instrukcji aktualizacji w tej sekcji dotyczących komponentu edge-management-ui.

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ć 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.51.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:

Używanie pliku konfiguracji w trybie bez obrazu

Musisz przekazać poleceniemu update plik konfiguracji w trybie cichym. Plik konfiguracji w trybie cichy powinien być taki sam jak plik użyty do zainstalowania Edge w wersji 4.19.06 lub 4.50.00.

Aktualizacja do wersji 4.51.00 na węźle z zewnętrznym połączeniem z internetem

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. Pobierz plik bootstrap_4.51.00.sh Edge 4.51.00 do folderu /tmp/bootstrap_4.51.00.sh: 
    curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
  8. Zainstaluj narzędzie Edge 4.51.00 apigee-service i zależne od niego komponenty, wykonując to polecenie: 
    sudo bash /tmp/bootstrap_4.51.00.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ę.
  9. Aby zaktualizować narzędzie apigee-setup, użyj narzędzia apigee-service, jak pokazano w tym przykładzie: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  10. 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
  11. 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
  12. Uruchom na 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.19.06 lub 4.50.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
  13. Ponownie uruchom komponent interfejsu Edge na wszystkich węzłach, na których jest on uruchomiony: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  14. 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.51.00.

Aktualizacja do wersji 4.51.00 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.51.00:

  1. Utwórz lokalne repozytorium 4.51.00 zgodnie z instrukcjami podanymi w sekcji „Tworzenie lokalnego repozytorium Apigee” na stronie Instalowanie narzędzia apigee-setup w Edge.
  2. Aby zainstalować apige-service z pliku .tar:
    1. Na węźle z lokalnym repozytorium użyj tego polecenia, aby spakować lokalne repozytorium do pojedynczego pliku tar o nazwie /opt/apigee/data/apigee-mirror/apigee-4.51.00.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. W nowym węźle rozpakuj plik do katalogu /tmp: 
      tar -xzf apigee-4.51.00.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 pakiety z Edge:/tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.51.00.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 instrukcjami podanymi 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 interfejsu API Edge za pomocą narzędzia apigee-setup).
    2. Na węźle zdalnym pobierz plik Edge bootstrap_4.51.00.sh do folderu /tmp/bootstrap_4.51.00.sh: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.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.51.00.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 narzędzia 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órego użyto do zdefiniowania komponentów Edge podczas instalacji wersji 4.19.06 lub 4.50.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: 
    /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.51.00.

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ą 1-węzłową do wersji 4.51.00:

  1. Zaktualizuj wszystkie komponenty: 
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. (jeśli masz zainstalowaną aplikację apigee-adminapi) Zaktualizowano 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 Qpid i Postgres na maszynie 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  3. Zaktualizuj LDAP na maszynie 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Zaktualizuj komponenty Edge na maszynach 2 i 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. Zaktualizuj interfejs na maszynie 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  6. (Jeśli zainstalowano apigee-adminapi) Zaktualizowano narzędzie apigee-adminapi na komputerze 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  7. (Jeśli masz zainstalowane logowanie jednokrotne Apigee) Zaktualizuj logowanie jednokrotne Apigee na maszynie 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.

  8. Ponownie uruchom komponent interfejsu Edge na maszynie 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 Qpid i Postgres na maszynie 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
  3. Zaktualizuj Qpid i Postgres na maszynie 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid, 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 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
    • Nowy interfejs Edge: jeśli zainstalowano nowy interfejs Edge, zaktualizuj komponent ue na odpowiednim urządzeniu (nie musi to być urządzenie 1): 
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  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 maszynie 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. Ponownie uruchom interfejs:
    • Klasyczny interfejs: jeśli używasz klasycznego interfejsu, zrestartuj 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 składnik 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 Cassandra i ZooKeeper na maszynach 1, 2 i 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Zaktualizuj Qpid na maszynach 6 i 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Aktualizacja Postgresa na maszynie 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Aktualizacja Postgresa na maszynie 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. Zaktualizuj LDAP na maszynie 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Zaktualizuj komponenty Edge na maszynach 6, 7, 8, 9, 1, 4 i 5 w tej kolejności: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  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 maszynie 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:
    • Klasyczny interfejs: jeśli używasz klasycznego interfejsu, zrestartuj 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 składnik 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 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 Qpid na maszynach 12 i 13: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Aktualizacja Postgresa na maszynie 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Aktualizacja Postgresa na maszynie 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. Zaktualizuj LDAP na maszynach 4 i 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. 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
  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. Na 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 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
  3. 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
  4. 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
  5. 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
  6. Zaktualizuj nowy interfejs (ue) lub klasyczny interfejs (ui):
    1. Maszyn 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. Maszyn 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

      3. 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. qpidd, 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. Interfejs Edge (klasyczny lub nowy)
  7. apigee-adminapi
  8. Logowanie jednokrotne Apigee

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