Aktualizacja Apigee Edge 4.51.00 lub 4.52.00 do 4.52.01

Apigee obsługuje uaktualnianie Edge for Private Cloud z wersji 4.51.00 lub 4.52.00 bezpośrednio do wersji 4.52.01. Na tej stronie znajdziesz instrukcje dotyczące przeprowadzenia obu tych czynności.

Kto może przeprowadzić aktualizację

Osoba uruchamiająca aktualizację powinna być tą samą osobą, która pierwotnie zainstalowała Edge, lub użytkownikiem z dostępem root.

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

Które komponenty należy zaktualizować

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

Aktualizacja wymagań wstępnych

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

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

    Dzięki temu masz plan awaryjny na wypadek, gdyby aktualizacja do nowej wersji nie działała prawidłowo. Więcej informacji o kopiach zapasowych znajdziesz w artykule Kopie zapasowe i przywracanie.

  • Sprawdzanie, czy przeglądarka Edge jest uruchomiona
    Upewnij się, że przeglądarka Edge jest uruchomiona podczas procesu aktualizacji. Aby to zrobić, użyj tego polecenia: 
    /opt/apigee/apigee-service/bin/apigee-all status
  • Sprawdź, czy strategia kompresji Cassandra to LeveledCompactionStrategy
    Sprawdź, czy strategia kompresji Cassandra jest ustawiona na LeveledCompactionStrategy, zgodnie z opisem w sekcji Zmiana strategii kompresji Cassandra.

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 Zookeeper 3.8.3

Ta wersja Edge for Private Cloud zawiera uaktualnienie do wersji Zookeeper 3.8.3. W ramach tej aktualizacji wszystkie dane Zookeeper zostaną przeniesione do Zookeeper 3.8.3.

Przed uaktualnieniem Zookeeper przeczytaj przewodnik konserwacyjny Zookeeper. Większość systemów produkcyjnych Edge korzysta z klastra węzłów Zookeeper rozmieszczonych w wielu centrach danych. Niektóre z tych węzłów są skonfigurowane jako głosujący, którzy biorą udział w wyborach lidera ZooKeeper, a pozostałe są skonfigurowane jako obserwatorzy. Więcej informacji znajdziesz w artykule Liderzy, obserwatorzy, głosujący i obserwatorzy. Głosujące węzły wybierają lidera, po czym same stają się podążającymi.

Podczas procesu aktualizacji może wystąpić chwilowe opóźnienie lub błąd zapisu w Zookeeperze, gdy węzeł główny jest wyłączony. Może to mieć wpływ na operacje zarządzania, które zapisują dane w Zookeeper, takie jak operacja wdrożenia zastępczego serwera proxy, oraz zmiany w infrastrukturze Apigee, takie jak dodanie lub usunięcie procesora wiadomości itp. Nie powinno to mieć wpływu na interfejsy API w czasie wykonywania w Apigee (chyba że te interfejsy API w czasie wykonywania wywołują interfejsy API zarządzania) podczas uaktualniania Zookeeper zgodnie z opisaną poniżej procedurą.

Ogólnie rzecz biorąc, proces uaktualniania obejmuje utworzenie kopii zapasowej każdego węzła. Następnie następuje uaktualnienie wszystkich obserwatorów i następców, a na końcu węzła głównego.

Tworzenie kopii zapasowej

Utwórz kopię zapasową wszystkich węzłów Zookeeper na wypadek, gdyby trzeba było cofnąć zmiany. Pamiętaj, że rollback przywróci Zookeepera do stanu z czasu tworzenia kopii zapasowej. Uwaga: wszelkie wdrożenia i zmiany infrastruktury w Apigee od momentu utworzenia kopii zapasowej (których informacje są przechowywane w Zookeeper) zostaną utracone podczas przywracania. 

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup

Jeśli używasz maszyn wirtualnych i masz taką możliwość, możesz utworzyć migawki lub kopie zapasowe maszyn wirtualnych, aby przywrócić je do poprzedniego stanu lub cofnąć zmiany (w razie potrzeby).

Identyfikowanie lidera, obserwatorów i obserwatorów

Uwaga: przykładowe polecenia poniżej używają narzędzia nc do wysyłania danych do Zookeepera. Dane do Zookeepera możesz też wysyłać za pomocą innych narzędzi.

  1. Jeśli nie jest zainstalowany na węźle ZooKeeper, zainstaluj nc: 
      sudo yum install nc
  2. Uruchom na węźle to polecenie nc, gdzie 2181 to port ZooKeeper: 
      echo stat | nc localhost 2181

    Powinny się wyświetlić dane wyjściowe podobne do tych:

      Zookeeper version: 3.8.3-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC
  Clients:
   /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0)
  
  Latency min/avg/max: 0/0.2518/41
  Received: 647228
  Sent: 647339
  Connections: 4
  Outstanding: 0
  Zxid: 0x400018b15
  Mode: follower
  Node count: 100597

    W wierszu Mode w wyniku dotyczącym węzłów powinieneś zobaczyć obserwatora, lidera lub naśladowcę (czyli węzeł głosujący, który nie jest liderem) w zależności od konfiguracji węzła. Uwaga: w samodzielnej instalacji Edge z jednym węzłem ZooKeeper parametr Mode jest ustawiony na wartość samodzielny.

  3. Powtórz kroki 1 i 2 na każdym węźle ZooKeeper.

Zaktualizuj Zookeepera na węzłach obserwatora i następcy.

Uaktualnij Zookeepera na każdym z węzłów obserwujących i naśladujących w następujący sposób:

  1. Pobierz i uruchom bootstrap Edge for Private Cloud 4.52, jak opisano w sekcji Zaktualizuj do wersji 4.52.01 na węźle z zewnętrznym połączeniem z internetem. Proces prawdopodobnie będzie się różnić w zależności od tego, czy węzeł ma zewnętrzne połączenie z internetem, czy też przeprowadzasz instalację offline.
  2. Uaktualnij komponent Zookeeper: 
      /opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
     Uwaga: jeśli na tych węzłach są zainstalowane inne komponenty (np. Cassandra), możesz je też teraz uaktualnić (np. profil cs,zk) lub uaktualnić inne komponenty później. Apigee zaleca najpierw zaktualizowanie tylko Zookeepera i upewnienie się, że klaster działa prawidłowo, zanim zaktualizujesz inne komponenty.
  3. Powtórz powyższe czynności w przypadku każdego węzła obserwatora i węzła podążającego Zookeeper.

Wyłączanie lidera

Po uaktualnieniu wszystkich węzłów obserwujących i podążających wyłącz węzeł domowy. Na węźle zidentyfikowanym jako lider uruchom podane niżej polecenie: 

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

Pamiętaj, że przed wybraniem nowego lidera mogą wystąpić chwilowe opóźnienia lub błędy zapisu w Zookeeper. Może to mieć wpływ na operacje zapisujące do Zookeepera, takie jak wdrożenie działania za pomocą serwerów proxy lub zmiany w infrastrukturze Apigee, takie jak dodawanie lub usuwanie procesorów wiadomości.

Sprawdź, czy wybrano nowego lidera

Wykonując czynności opisane w sekcji Identyfikacja lidera, naśladowców i obserwatorów powyżej, sprawdź, czy nowy lider został wybrany spośród naśladowców, gdy obecny lider został zatrzymany. Pamiętaj, że lider może zostać wybrany w innym centrum danych niż obecny lider.

Lider uaktualnienia

Wykonaj czynności opisane w sekcji Aktualizowanie Zookeepera na węzłach obserwatora i następcy.

Gdy stary węzeł główny zostanie również uaktualniony, sprawdź stan klastra i upewnij się, że jest węzeł główny.

Przywróć

W razie konieczności przywrócenia zmian:

  1. Najpierw wykonaj czynności cofnięcia zmian na obserwatorach i obserwowanych użytkownikach.
  2. Pobierz i uruchom bootstrap wersji, do której chcesz przywrócić poprzednią wersję – 4.50 lub 4.51. Proces prawdopodobnie będzie się różnić w zależności od tego, czy węzeł ma zewnętrzne połączenie z internetem, czy też instalujesz aplikację offline.
  3. Zatrzymaj Zookeepera, jeśli jest uruchomiony na węźle: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
  4. Odinstaluj dotychczasowy zookeeper: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall
  5. Zainstaluj Zookeeper w zwykły sposób: 
      /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>
  6. Po cofnięciu wszystkich węzłów obserwowanych i podrzędnych cofnij węzeł docelowy, wykonując kroki 2–5 w przypadku węzła docelowego.
  7. Po przywróceniu wszystkich węzłów sprawdź stan klastra i upewnij się, że jest w nim węzeł domowy.

Przywróć kopię zapasową

Zapoznaj się z artykułem Przywracanie z kopii zapasowej. Pamiętaj, że kopie zapasowe Zookeeper utworzone z wcześniejszych wersji Edge for Private Cloud, takich jak 4.50 i 4.51, powinny być zgodne z wersją Zookeeper w Edge for Private Cloud 4.52.

Wymaga uaktualnienia do Postgres 14

Ta wersja Edge for Private Cloud zawiera uaktualnienie do Postgres 14. W ramach tego uaktualnienia wszystkie dane Postgres są migrowane do Postgres 14.

  • Jeśli przechodzisz z wersji Edge for Private Cloud 4.51.00 na 4.52.01, musisz wykonać dodatkowe czynności związane z aktualizacją Postgres. Jeśli przechodzisz z wersji 4.51.00 na 4.52.01, zapoznaj się z sekcją Wymagane uaktualnienie do Postgres 14.
  • Jeśli przechodzisz z wersji Edge for Private Cloud 4.52.00 na 4.52.01, nie musisz wykonywać dodatkowych czynności związanych z uaktualnieniem Postgres.

Uaktualnianie Qpid

Ta wersja Edge for Private Cloud zawiera uaktualnienie do Qpid J-Broker.

Aby przeprowadzić uaktualnienie Qpid, zalecamy wybranie jednej z tych metod:

Aktualizacja w miejscu bez przestojów

Dzięki tej metodzie nie ma przerw w działaniu środowiska wykonawczego Edge i minimalizowana jest utrata danych z czasu wykonywania (jeśli taka wystąpi) pozyskanych na potrzeby analityki.

Aby przeprowadzić uaktualnienie na miejscu bez przestoju do Qpid:

  1. Na początek wybierz jeden węzeł Qpid.
  2. Zatrzymaj brokera Qpid na węźle: 
    apigee-service apigee-qpidd stop
  3. Za pomocą zapory sieciowej zablokuj ruch przychodzący na porcie brokera 5672 ze wszystkich procesorów wiadomości. Zaporę możesz zastosować na poziomie instancji węzła Qpid lub innego komponentu zapory sieciowej/zewnętrznego.

    Zalecamy wykonanie tego samego kroku w przypadku wszystkich adresów IP procesora wiadomości. Aby na przykład za pomocą IPTables odrzucić żądania przychodzące z adresów IP procesora wiadomości do węzła Qpid na porcie 5672, możesz użyć takiego polecenia:

    iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
  4. Uruchom ponownie brokera Qpid, aby usunąć istniejące wiadomości (jeśli takie istnieją): 
    apigee-service apigee-qpidd start
  5. Sprawdź, czy istniejące kolejki są puste: 
    qpid-stat -q

    Jeśli wiadomości utknął w kolejce nieczynnych wiadomości (DLQ) (ax-q-axgroup-001-consumer-group-001-dl), opróżnij kolejkę, wykonując te czynności.

  6. Po sprawdzeniu, czy kolejki na starym węźle są puste, zatrzymaj apigee-qpidd: 
    apigee-service apigee-qpidd stop
  7. Uaktualnij Qpid na węźle: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Ponownie uruchom edge-qpid-server: 
    apigee-service edge-qpid-server restart

  9. Usuń regułę zapory sieciowej zastosowaną w kroku 3.

    Wykonaj ten sam krok usuwania w przypadku wszystkich adresów IP procesora wiadomości, do których zastosowano zaporę. Gdy zapory zostaną usunięte, akceptowane będą żądania pochodzące z adresów IP procesora wiadomości do węzła Qpid na porcie 5672. Jeśli zaporę sieciową dodano za pomocą polecenia iptables, aby ją usunąć i wyświetlić listę dotychczasowych ustawień, możesz użyć takich poleceń jak:

    iptables -F
  iptables -L
  10. Aby sprawdzić, czy kolejki Qpid otrzymują wiadomości, użyj monitorowania w internecie: 
    http://QPID_NODE_IP:8090
  11. Powtórz kroki 1–9 w przypadku każdego węzła Qpid.

Wdrażanie nowego węzła Qpid

Ta metoda konfiguruje i instaluje apigee-qpidd i edge-qpid-server na nowym węźle.

  1. Dodaj nowy węzeł Qpid. W tym kroku skonfigurujesz węzeł Qpid za pomocą J-brokera. Szczegółowe instrukcje znajdziesz w artykule Dodawanie serwera Qpid.
  2. Wybierz istniejący węzeł Qpid (węzeł z wersji, z której przeprowadzasz uaktualnienie).
  3. Zatrzymaj brokera Qpid na węźle: 
    apigee-service apigee-qpidd stop
  4. Za pomocą zapory sieciowej zablokuj ruch przychodzący na porcie brokera 5672 ze wszystkich procesorów wiadomości. Zaporę możesz zastosować na poziomie instancji węzła Qpid lub innego zewnętrznego komponentu zapory sieciowej.

    Zalecamy wykonanie tego samego kroku w przypadku wszystkich adresów IP procesora wiadomości. Aby na przykład za pomocą IPTables odrzucić żądania przychodzące z adresów IP procesora wiadomości do węzła Qpid na porcie 5672, możesz użyć takiego polecenia:

    iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
  5. Uruchom ponownie brokera Qpid, aby usunąć istniejące wiadomości (jeśli takie istnieją): 
    apigee-service apigee-qpidd start
  6. Sprawdź, czy istniejące kolejki są puste: 
    qpid-stat -q

    Jeśli wiadomości utknął w kolejce nieczynnych wiadomości (DLQ) (ax-q-axgroup-001-consumer-group-001-dl), opróżnij kolejkę, wykonując czynności opisane w temacie rozwiązywania problemów Dane Analytics utknięte w kolejce nieczynnych wiadomości Qpidd.

  7. Po sprawdzeniu, czy kolejki na starym węźle są puste, zatrzymaj apigee-qpidd 
    apigee-service apigee-qpidd stop
  8. Wykonaj odrejestrowanie starego węzła Qpid, wykonując czynności opisane w artykule Usuwanie serwera Qpid.
  9. Dodawaj nowy węzeł i usuwaj stary węzeł po kolei, aż wszystkie węzły Qpid zostaną uaktualnione.

Przywróć

Aby przywrócić poprzednią wersję funkcji, pobierz plik bootstrap.sh dla wersji, do której chcesz przywrócić. Aby przywrócić wersję 4.52.00, pobierz bootstrap_4.52.00.sh.

Aby wycofać Qpid, wykonaj te czynności na wszystkich hostach Qpid:

  1. Zatrzymaj dotychczasowego brokera Qpid. 
    apigee-service apigee-qpidd stop
  2. Za pomocą zapory sieciowej zablokuj ruch przychodzący na porcie brokera 5672 ze wszystkich procesorów wiadomości. Zaporę możesz zastosować na poziomie instancji węzła Qpid lub innego komponentu zapory sieciowej/zewnętrznego.

    Zalecamy wykonanie tego samego kroku w przypadku wszystkich adresów IP procesora wiadomości. Aby na przykład za pomocą IPTables odrzucić żądania przychodzące z adresów IP procesora wiadomości do węzła Qpid na porcie 5672, możesz użyć takiego polecenia:

    iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
  3. Uruchom ponownie brokera qpid, aby usunąć istniejące wiadomości (jeśli takie istnieją): 
    apigee-service apigee-qpidd start
  4. Upewnij się, że istniejące kolejki są puste. Aby to sprawdzić, zaloguj się w portalu zarządzania Qpid: 
    http://QPID_NODE_IP:8090
     Uwaga: jeśli port 8090 na węźle QPID jest niedostępny, możesz użyć alternatywnych mechanizmów, takich jak przekierowanie portu SSH, aby uzyskać dostęp do tego adresu URL.
  5. Po sprawdzeniu, czy kolejki są puste, zatrzymaj i odinstaluj Qpid: 
    apigee-service apigee-apidd uninstall
  6. Usuń katalog danych Qpid: 
    rm -r APIGEE_ROOT/data/apigee-qpidd
  7. Ponownie zainstaluj brokera Qpid: 
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  8. Po ponownym zainstalowaniu brokera Qpid usuń ustawienia zapory sieciowej i wyświetl wszystkie istniejące ustawienia za pomocą tych poleceń: 
    iptables -F
     
    iptables -L

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.

Aktualizowanie interfejsu Edge

Aby zaktualizować komponent interfejsu Edge, sprawdź, z której wersji Edge for Private Cloud chcesz przejść:

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.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 Edge bez wyłączania przeglądarki.

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 komputerze, 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 nawiązania połączenia z serwerem (procesorem wiadomości lub routerem).
  3. Zaktualizuj wybrany router i wszystkie inne komponenty Edge na tym samym komputerze. Wszystkie konfiguracje krawędzi pokazują przełącznik i procesor wiadomości na tym samym węźle.
  4. Spraw, aby router był ponownie dostępny.
  5. Powtórz kroki 2–4 w przypadku pozostałych routerów.
  6. Kontynuuj aktualizację pozostałych maszyn w instalacji.

Przed i po aktualizacji wykonaj te czynności:

Używanie pliku konfiguracji w trybie bez powiadamiania

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.01 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.01.sh w Edge do folderu /tmp/bootstrap_4.52.01.sh: 
      curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
    2. Zainstaluj narzędzie apigee-service Edge 4.52.01 i odpowiednie zależności, wykonując to polecenie: 
      sudo bash /tmp/bootstrap_4.52.01.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 logowanie jednokrotne)
        • ue: nowy interfejs Edge
        • ui: klasyczny interfejs 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 ./sa_silent_config
    7. Uruchom ponownie komponenty interfejsu Edge na wszystkich węzłach, na których są one uruchomione, jeśli nie zostało to jeszcze zrobione: 
      /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
    8. Przetestuj aktualizację, uruchamiając na serwerze zarządzania narzędzie apigee-validate zgodnie z opisem w sekcji Testowanie instalacji.

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

Aktualizacja do wersji 4.52.01 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 na węźle serwer WWW 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.01:

  1. Utwórz lokalne repozytorium 4.52.01 zgodnie z instrukcjami podanymi w sekcji „Tworzenie lokalnego repozytorium Apigee” na stronie Zainstaluj narzędzie do konfiguracji apigee na krawędzi.
  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.01.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.01.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.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Zwróć uwagę, ż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.01.sh Edge do folderu /tmp/bootstrap_4.52.01.sh: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.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.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

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

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

    Gdzie:

    • component to komponent Edge, który chcesz zaktualizować. Zwykle aktualizujesz te komponenty:
      • cs: Cassandra
      • edge: wszystkie komponenty Edge 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 logowanie jednokrotne)
      • ue Nowy interfejs Edge
      • ui: klasyczny interfejs 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 zostało to jeszcze zrobione: 
    /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 aktualizacji 4.52.01.

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 zarządzania, procesor wiadomości, router, serwer QPID, ale nie serwer Postgres) użyj opcji -c edge, aby zaktualizować je wszystkie jednocześnie.
  • Jeśli krok wskazuje, że należy go wykonać na wielu maszynach, wykonaj go w określonej kolejności.
  • Nie trzeba osobno aktualizować ustawień zarabiania. 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.52.01:

  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ą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 Postgresa na maszynie 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Zaktualizuj Postgres na maszynie 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Zaktualizuj LDAP na maszynie 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Zaktualizuj 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:
    • 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 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 Postgres na maszynie 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Zaktualizuj LDAP na maszynach 4 i 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Zaktualizuj 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. 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 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

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