Zaktualizuj Apigee Edge do wersji 4.19.06 lub 4.50.00 do 4.51.00

W tej sekcji opisano, jak przejść z Apigee Edge w wersji 4.19.06 lub 4.50.00 na wersję 4.51.00.

Kto może przeprowadzić aktualizację

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

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

Które komponenty musisz zaktualizować

Musisz zaktualizować wszystkie komponenty Edge. Edge nie obsługuje konfiguracji zawierającej komponenty z wielu wersji.

Automatyczne rozpowszechnianie ustawień usługi

Jeśli ustawiono jakieś właściwości przez edycję plików .properties w /opt/apigee/customer/application, te wartości zostaną zachowane podczas aktualizacji.

Wymagane uaktualnienie do Postgres 10.17

Ta wersja Edge obejmuje uaktualnienie do Postgres 10.17. W ramach tego uaktualnienia wszystkie dane Postgres są przenoszone do Postgres 10.17.

Większość systemów produkcyjnych Edge korzysta z 2 węzłów Postgres skonfigurowanych do replikacji master-standby. Podczas procesu aktualizacji, gdy węzły Postgres są wyłączone, dane analityczne są nadal zapisywane w węzłach Qpid. Po zaktualizowaniu węzłów Postgres i przywróceniu ich do trybu online dane analityczne są przekazywane do węzłów Postgres.

Sposób aktualizacji Postgres zależy od tego, jak skonfigurowano magazyn danych dla węzłów Postgres:

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

    Dodatkowy węzeł rezerwowy Postgres jest wymagany, jeśli z jakiegoś powodu musisz wycofać aktualizację. Jeśli musisz wycofać aktualizację, po wycofaniu nowy węzeł rezerwowy Postgres stanie się węzłem głównym Postgres. Dlatego podczas instalowania nowego węzła rezerwowego Postgres powinien on znajdować się na węźle, który spełnia wszystkie wymagania sprzętowe serwera Postgres, zgodnie z definicją w wymaganiach instalacji Edge.

    W konfiguracji Edge z 1 węzłem i 2 węzłami, czyli topologiach używanych do prototypowania i testowania, masz tylko 1 węzeł Postgres. Możesz zaktualizować te węzły Postgres bezpośrednio, bez konieczności tworzenia nowego węzła Postgres.

  • Jeśli używasz pamięci sieciowej dla węzłów Postgres, zgodnie z zaleceniami Apigee, nie musisz instalować nowego węzła Postgres. W poniższych procedurach możesz pominąć kroki, które określają instalację, a następnie wycofanie nowego węzła rezerwowego Postgres.

    Zanim rozpoczniesz proces aktualizacji, utwórz migawkę sieciową magazynu danych używanego przez Postgres. Jeśli podczas aktualizacji wystąpią błędy i konieczne będzie przywrócenie poprzedniej wersji, możesz przywrócić węzeł Postgres z tego zrzutu.

Instalowanie nowego węzła rezerwowego Postgres

Ta procedura tworzy serwer rezerwowy Postgres na nowym węźle. Pamiętaj, aby zainstalować nowy serwer rezerwowy Postgres dla istniejącej wersji Edge (4.19.06 lub 4.50.00), a nie dla wersji 4.51.00.

Aby przeprowadzić instalację, użyj tego samego pliku konfiguracji, który został użyty do zainstalowania bieżącej wersji Edge.

Aby utworzyć nowy węzeł rezerwowy Postgres:

  1. Na bieżącym serwerze głównym Postgres zmodyfikuj plik /opt/apigee/customer/application/postgresql.properties, aby ustawić ten token. Jeśli ten 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 bieżącego serwera rezerwowego Postgres, a new_standby_ip to adres IP nowego węzła rezerwowego.

  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ł rezerwowy został dodany, wyświetlając plik /opt/apigee/apigee-postgresql/conf/pg_hba.conf na węźle głównym. W pliku powinny znajdować się te wiersze: 
    host replication apigee existing_standby_ip/32 trust
host replication apigee new_standby_ip/32 trust
  4. Zainstaluj nowy serwer rezerwowy Postgres:
    1. Zmodyfikuj plik konfiguracyjny użyty do zainstalowania bieżącej wersji Edge, aby określić te elementy: 
      # 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 opisem w artykule Instalowanie narzędzia Edge apigee-setup.
    3. Wykonaj jedną z tych czynności w zależności od wersji Edge, z której przechodzisz:
      • Jeśli uaktualniasz Edge z wersji 4.19.06, pobierz plik Edge bootstrap_4.19.06.sh do /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 Edge apigee-service i zależności: 

        sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord
      • Jeśli uaktualniasz Edge z wersji 4.50.00, pobierz plik Edge bootstrap_4.50.00.sh do /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 Edge apigee-service i zależności: 

        sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
    4. Użyj apigee-service, aby zainstalować narzędzie apigee-setup: 
      /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 rezerwowym uruchom to polecenie: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Sprawdź, czy jest oznaczony jako zapasowy.

Przeprowadzanie uaktualnienia Postgres na miejscu

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

  1. Uaktualnij Postgres na hoście głównym 
    /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. Sprawdź, czy host główny został uruchomiony: 
    apigee-service apigee-postgresql wait_for_ready
  7. Zatrzymaj tryb gotowości: 
    apigee-service apigee-postgresql stop
  8. Uaktualnij instancję rezerwową.

    Uwaga: jeśli ten krok zakończy się błędem lub niepowodzeniem, możesz go zignorować. update.sh spróbuje uruchomić serwer rezerwowy z nieprawidłową konfiguracją. Jeśli instalacja Postgres zostanie uaktualniona 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 wyłączony: 
    apigee-service apigee-postgresql stop
  10. Usuń starą konfigurację gotowości: 
    rm -rf /opt/apigee/data/apigee-postgresql/
  11. Skonfiguruj replikację na serwerze rezerwowym: 
    apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf

Po wykonaniu tej procedury tryb gotowości uruchomi się prawidłowo.

Wycofanie węzła Postgres

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

  1. Upewnij się, że Postgres działa: 
    /opt/apigee/apigee-service/bin/apigee-all status

    Jeśli Postgres nie jest uruchomiony, uruchom go: 

    /opt/apigee/apigee-service/bin/apigee-all start
  2. Pobierz identyfikator UUID nowego węzła rezerwowego, uruchamiając 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ł rezerwowy, uruchamiając na nim to polecenie: 
    /opt/apigee/apigee-service/bin/apigee-all stop
  4. Na węźle głównym Postgres zmodyfikuj /opt/apigee/customer/application/postgresql.properties, aby usunąć nowy węzeł rezerwowy z conf_pg_hba_replication.connection: 
    conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
  5. Ponownie uruchom apigee-postgresql na serwerze głównym Postgres: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  6. Sprawdź, czy nowy węzeł rezerwowy został usunięty, wyświetlając plik /opt/apigee/apigee-postgresql/conf/pg_hba.conf na węźle głównym. W tym pliku powinien być widoczny tylko ten wiersz: 
    host replication apigee existing_standby_ip/32 trust
  7. Usuń identyfikator UUID węzła rezerwowego z ZooKeeper, wykonując to wywołanie interfejsu Edge Management API w węźle serwera zarządzania: 
    curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

Wymagania wstępne dotyczące aktualizacji

Przed uaktualnieniem Apigee Edge spełnij te wymagania wstępne:

  • Utwórz kopię zapasową wszystkich węzłów
    Przed aktualizacją zalecamy ze względów bezpieczeństwa utworzenie pełnej kopii zapasowej wszystkich węzłów. Aby wykonać kopię zapasową, postępuj zgodnie z procedurą dla bieżącej wersji Edge.

    Dzięki temu będziesz mieć 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 zapasowej.

  • Sprawdzanie, czy Edge działa
    Sprawdź, czy Edge działa podczas procesu aktualizacji, używając polecenia: 
    /opt/apigee/apigee-service/bin/apigee-all status

Nowy interfejs Edge

W tej sekcji znajdziesz uwagi dotyczące interfejsu Edge. Więcej informacji znajdziesz w artykule o nowym interfejsie Edge dla chmury prywatnej.

Instalowanie interfejsu Edge

Po zakończeniu wstępnej instalacji Apigee zaleca zainstalowanie interfejsu Edge, który jest ulepszonym interfejsem użytkownika dla deweloperów i administratorów Apigee Edge dla chmury prywatnej.

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

Więcej informacji znajdziesz w artykule o instalowaniu nowego interfejsu Edge.

Aktualizowanie interfejsu Edge

Aby zaktualizować komponent interfejsu Edge, weź pod uwagę wersję Edge for chmura prywatna, z której przeprowadzasz uaktualnienie:

Aktualizowanie za pomocą Apigee mTLS

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

Cofanie aktualizacji

Jeśli aktualizacja się nie powiedzie, możesz spróbować rozwiązać problem, a następnie ponownie wykonać polecenie update.sh. Możesz uruchomić aktualizację wielokrotnie, a będzie ona kontynuowana 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.

Rejestrowanie informacji o aktualizacji

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

/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 jest zapisywany w katalogu /tmp jako plik o nazwie update_username.log.

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

Aktualizacja bez przestojów

Aktualizacja bez przestojów, czyli aktualizacja krocząca, umożliwia aktualizację instalacji Edge bez wyłączania Edge.

Aktualizacja bez przestojów jest możliwa tylko w przypadku konfiguracji z co najmniej 5 węzłami.

Kluczem do uaktualnienia bez przestojów jest usuwanie z systemu równoważenia obciążenia po jednym routerze naraz. Następnie zaktualizuj router i inne komponenty na tej samej maszynie co router, a potem dodaj router z powrotem do systemu równoważenia obciążenia.

  1. Zaktualizuj maszyny w odpowiedniej kolejności dla swojej instalacji, zgodnie z opisem w sekcji Kolejność aktualizacji maszyn.
  2. Gdy nadejdzie czas na aktualizację routerów, wybierz dowolny router i ustaw go jako nieosiągalny, jak opisano w artykule Włączanie i wyłączanie osiągalności serwera (procesora komunikatów lub routera).
  3. Zaktualizuj wybrany router i wszystkie inne komponenty Edge na tym samym komputerze co router. Wszystkie konfiguracje Edge pokazują router i procesor komunikatów w tym samym węźle.
  4. Spraw, aby router był ponownie dostępny.
  5. Powtórz kroki od 2 do 4 w przypadku pozostałych routerów.
  6. Kontynuuj aktualizację pozostałych maszyn w instalacji.

Przed aktualizacją i po niej wykonaj te czynności:

Używanie pliku konfiguracji instalacji dyskretnej

Do polecenia aktualizacji musisz przekazać plik konfiguracji instalacji dyskretnej. Plik konfiguracji instalacji dyskretnej powinien być taki sam jak ten, który został użyty do zainstalowania Edge 4.19.06 lub 4.50.00.

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

Aby zaktualizować komponenty Edge na węźle, wykonaj te czynności:

  1. Jeśli są skonfigurowane jakieś zadania cron, które mają wykonać operację naprawy w Cassandra, wyłącz je do czasu zakończenia aktualizacji.
  2. Zaloguj się w węźle jako użytkownik root, aby zainstalować pakiety 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 opisem w artykule Instalowanie narzędzia apigee-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, uruchom 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 Edge 4.51.00 bootstrap_4.51.00.sh do /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żności, 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ą Javę 1.8. Jeśli tego nie zrobisz, instalator zainstaluje go za Ciebie.

    Użyj opcji JAVA_FIX, aby określić sposób obsługi instalacji Javy. JAVA_FIX przyjmuje te wartości:

    • I: zainstaluj OpenJDK 1.8 (domyślnie).
    • C: kontynuuj bez instalowania Javy.
    • Q: Zamknij. W przypadku tej opcji musisz samodzielnie zainstalować Javę.
  9. Użyj apigee-service, aby zaktualizować narzędzie apigee-setup, 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 narzędzie update na węzłach, 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 maszyn.

    Gdzie:

    • component to komponent Edge, który chcesz zaktualizować. Możliwe wartości:
      • cs: Cassandra
      • edge: wszystkie komponenty Edge z wyjątkiem interfejsu Edge: serwer zarządzania, procesor komunikatów, router, serwer QPID, serwer Postgres
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: SSO w Apigee (jeśli zainstalowano SSO)
      • ue: nowy interfejs Edge
      • ui: klasyczny interfejs Edge
      • zk: Dozorca w zoo
    • configFile to ten sam plik konfiguracji, który został użyty 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 component na „all”, 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. Jeśli jeszcze nie zostało to zrobione, uruchom ponownie 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 narzędzie apigee-validate na serwerze zarządzania, zgodnie z opisem w sekcji Testowanie instalacji.

Jeśli później zdecydujesz się wycofać aktualizację, wykonaj procedurę opisaną w sekcji Wycofywanie wersji 4.51.00.

Aktualizacja do wersji 4.51.00 z lokalnego repozytorium

Jeśli węzły Edge znajdują się za zaporą sieciową lub w inny sposób nie mają dostępu do repozytorium Apigee przez internet, możesz przeprowadzić aktualizację z lokalnego repozytorium lub kopii lustrzanej repozytorium Apigee.

Po utworzeniu lokalnego repozytorium Edge masz 2 opcje aktualizowania Edge z lokalnego repozytorium:

  • Utwórz plik .tar repozytorium, skopiuj go do węzła, a następnie zaktualizuj Edge z pliku .tar.
  • Zainstaluj serwer WWW w węźle z lokalnym repozytorium, aby inne węzły miały 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 opisem w sekcji „Tworzenie lokalnego repozytorium Apigee” w artykule Instalowanie narzędzia apigee-setup w Edge.
  2. Aby zainstalować apigee-service z pliku .tar:
    1. W 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 go na przykład skopiować do katalogu /tmp w nowym węźle.
    3. Na 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 Edge apigee-service i zależności z /tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.51.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Zwróć uwagę, że w tym poleceniu podajesz ścieżkę do katalogu repozytoriów.

  3. Aby zainstalować apigee-service przy użyciu serwera WWW NGINX:
    1. Skonfiguruj serwer WWW NGINX zgodnie z opisem w sekcji „Instalowanie z repozytorium przy użyciu serwera WWW NGINX” w artykule Instalowanie narzędzia Edge apigee-setup.
    2. Na węźle zdalnym pobierz plik Edge bootstrap_4.51.00.sh do /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. W węźle zdalnym zainstaluj narzędzie Edge apigee-setup i zależności: 
      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. Użyj apigee-service, aby zaktualizować narzędzie apigee-setup, 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 aktualizuje się te komponenty:
      • cs: Cassandra
      • edge: wszystkie komponenty Edge z wyjątkiem interfejsu Edge: serwer zarządzania, procesor komunikatów, router, serwer QPID, serwer Postgres
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: SSO w Apigee (jeśli zainstalowano SSO)
      • ue Nowy interfejs Edge
      • ui: klasyczny interfejs Edge
      • zk: Dozorca w zoo
    • configFile to ten sam plik konfiguracji, który został użyty 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 component na „all”, 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. Jeśli jeszcze nie zostało to zrobione, uruchom ponownie komponenty interfejsu na wszystkich węzłach, na których są uruchomione: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. Przetestuj aktualizację, uruchamiając narzędzie apigee-validate na serwerze zarządzania, zgodnie z opisem w sekcji Testowanie instalacji.

Jeśli później zdecydujesz się wycofać aktualizację, wykonaj procedurę opisaną w sekcji Wycofywanie wersji 4.51.00.

Kolejność aktualizacji maszyn

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

  • Zanim zaktualizujesz inne węzły, musisz zaktualizować wszystkie węzły Cassandra i ZooKeeper.
  • W przypadku każdej maszyny z wieloma komponentami Edge (serwer zarządzania, procesor komunikatów, router, serwer QPID, ale nie serwer Postgres) użyj opcji -c edge, aby zaktualizować je wszystkie jednocześnie.
  • Jeśli krok ma zostać wykonany na wielu maszynach, wykonaj go w określonej kolejności maszyn.
  • Nie ma osobnego kroku do aktualizacji zarabiania. Jest aktualizowany, gdy określisz opcję -c edge.

Samodzielna licencja na 1 węzeł

Aby uaktualnić samodzielną konfigurację z 1 węzłem do wersji 4.51.00:

  1. Zaktualizuj wszystkie komponenty: 
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. (Jeśli masz zainstalowane narzędzie apigee-adminapi) Zaktualizowano narzędzie apigee-adminapi: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

Samodzielna licencja na 2 węzły

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

Listę topologii Edge i numery węzłów znajdziesz w artykule Topologie instalacji.

  1. Zaktualizuj system Cassandra i ZooKeeper na maszynie 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Zaktualizuj Qpid i Postgres na komputerze 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 komputerze 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 SSO w Apigee) Zaktualizuj SSO w 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.

  8. Uruchom ponownie komponent interfejsu Edge na komputerze 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Uaktualnienie 5 węzłów

Zaktualizuj te komponenty w przypadku instalacji 5-węzłowej:

Listę topologii Edge i numery węzłów znajdziesz w artykule Topologie instalacji.

  1. Zaktualizuj system 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 komputerze 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 użytkownika Edge: jeśli masz zainstalowany nowy interfejs użytkownika Edge, zaktualizuj komponent ue na odpowiednim komputerze (może to nie być komputer 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 SSO w Apigee) Zaktualizuj SSO w 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.

  9. Uruchom ponownie komponent interfejsu:
    • Klasyczny interfejs: jeśli używasz klasycznego interfejsu, uruchom ponownie komponent edge-ui na komputerze 1, jak pokazano w tym przykładzie: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Nowy interfejs Edge: jeśli masz zainstalowany nowy interfejs Edge, uruchom ponownie komponent edge-management-ui na odpowiednim komputerze (może to nie być komputer 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Uaktualnienie klastra z 9 węzłami

Zaktualizuj te komponenty w przypadku instalacji klastrowej z 9 węzłami:

Listę topologii Edge i numery węzłów znajdziesz w artykule Topologie instalacji.

  1. Zaktualizuj system 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. Zaktualizuj Postgres na maszynie 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Zaktualizuj Postgres 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 masz zainstalowane narzędzie 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 SSO w Apigee) Zaktualizuj SSO w 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. Uruchom ponownie 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 masz zainstalowany nowy interfejs Edge, uruchom ponownie komponent edge-management-ui na odpowiednim komputerze (może to nie być komputer 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Uaktualnienie klastra z 13 węzłami

Zaktualizuj te komponenty w przypadku instalacji klastrowej z 13 węzłami:

Listę topologii Edge i numery węzłów znajdziesz w artykule Topologie instalacji.

  1. Zaktualizuj system 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. Zaktualizuj Postgres na maszynie 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Zaktualizuj Postgres 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 tej 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 masz zainstalowane narzędzie apigee-adminapi) Zaktualizowano narzędzie apigee-adminapi na komputerach 6 i 7: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (Jeśli masz zainstalowane SSO w Apigee) Zaktualizuj SSO w Apigee na komputerach 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 instalowania logowania jednokrotnego.

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

Uaktualnienie klastra z 12 węzłami

Zaktualizuj te komponenty w przypadku instalacji klastrowej z 12 węzłami:

Listę topologii Edge i numery węzłów znajdziesz w artykule Topologie instalacji.

  1. Zaktualizuj Cassandrę i ZooKeepera:
    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. Zaktualizuj qpidd na maszynie 4: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Zaktualizuj 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. Zaktualizuj qpidd na maszynie 10: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Zaktualizuj qpidd na komputerze 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. Zaktualizuj komponenty 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. 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 zainstalowane narzędzie apigee-adminapi) Zaktualizowano 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 SSO w Apigee) Zaktualizuj SSO w 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

      3. sso_config_file to plik konfiguracji utworzony podczas instalowania logowania jednokrotnego.

  9. Uruchom ponownie komponent nowego interfejsu Edge (edge-management-ui) lub klasycznego interfejsu Edge (edge-ui) na urządzeniach 1 i 7: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

Konfiguracja niestandardowa

Jeśli masz konfigurację niestandardową, 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, serwerem Edge Postgres, serwerem zarządzania, procesorem komunikatów i routerem.
  6. Interfejs użytkownika Edge (klasyczny lub nowy)
  7. apigee-adminapi
  8. SSO w Apigee

Po zakończeniu aktualizacji pamiętaj, aby ponownie uruchomić komponent interfejsu Edge na wszystkich maszynach, na których jest on uruchomiony.