Aktualizacja Apigee Edge 4.51.00 lub 4.52.00 do 4.52.01

Apigee obsługuje uaktualnianie Edge dla chmury prywatnej z wersji 4.51.00 lub 4.52.00 bezpośrednio do wersji 4.52.01. Na tej stronie dowiesz się, jak przeprowadzić uaktualnienie.

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

Wymagania wstępne dotyczące aktualizacji

Przed uaktualnieniem Apigee Edge sprawdź, czy spełniasz 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 zapasowych.

  • Sprawdzanie, czy Edge działa
    Upewnij się, że Edge działa podczas procesu aktualizacji, używając polecenia: 
    /opt/apigee/apigee-service/bin/apigee-all status
  • Sprawdź, czy strategia kompaktowania Cassandra to LeveledCompactionStrategy
    Sprawdź, czy strategia kompaktowania Cassandra jest ustawiona na LeveledCompactionStrategy, zgodnie z opisem w artykule Zmienianie strategii kompaktowania Cassandra.

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

Ta wersja Edge dla chmury prywatnej zawiera uaktualnienie do Zookeeper 3.8.3. W ramach tego uaktualnienia wszystkie dane ZooKeeper zostaną przeniesione do ZooKeeper 3.8.3.

Zanim uaktualnisz ZooKeepera, przeczytaj przewodnik po konserwacji ZooKeepera. Większość systemów produkcyjnych Edge korzysta z klastra węzłów ZooKeeper rozproszonych w wielu centrach danych. Niektóre z tych węzłów są skonfigurowane jako głosujący, którzy uczestniczą w wyborze lidera ZooKeeper, a pozostałe są skonfigurowane jako obserwatorzy. Więcej informacji znajdziesz w artykule Liderzy, obserwujący, głosujący i obserwatorzy. Węzły głosujące wybierają lidera, po czym same stają się obserwatorami.

Podczas procesu aktualizacji może wystąpić chwilowe opóźnienie lub błąd zapisu w Zookeeperze, gdy węzeł lidera zostanie wyłączony. Może to mieć wpływ na operacje zarządzania, które zapisują dane w Zookeeperze, takie jak operacja wdrożenia serwera proxy, oraz na zmiany w infrastrukturze Apigee, takie jak dodanie lub usunięcie procesora komunikatów itp. Podczas uaktualniania Zookeepera zgodnie z poniższą procedurą nie powinno to mieć wpływu na interfejsy API środowiska wykonawczego Apigee (chyba że te interfejsy API środowiska wykonawczego wywołują interfejsy API zarządzania Google Analytics).

Na najwyższym poziomie proces uaktualniania obejmuje utworzenie kopii zapasowej każdego węzła. Następnie uaktualniane są wszystkie węzły obserwujące i śledzące, a na końcu węzeł lidera.

Tworzenie kopii zapasowej

Utwórz kopię zapasową wszystkich węzłów ZooKeepera, aby użyć jej w razie konieczności wycofania zmian. Pamiętaj, że przywrócenie spowoduje przywrócenie ZooKeepera do stanu, w którym utworzono kopię zapasową. Uwaga: wszelkie wdrożenia lub 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 też utworzyć zrzuty lub kopie zapasowe maszyn wirtualnych, aby móc je przywrócić lub cofnąć zmiany (w razie potrzeby).

Identyfikowanie lidera, obserwujących i obserwatorów

Uwaga: przykładowe polecenia poniżej używają narzędzia nc do wysyłania danych do ZooKeepera. Do wysyłania danych do ZooKeepera możesz też używać innych narzędzi.

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

    Powinny pojawić się 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 danych wyjściowych węzłów powinna być widoczna wartość observer, leader lub follower (czyli węzeł głosujący, który nie jest liderem) w zależności od konfiguracji węzła. Uwaga: w przypadku samodzielnej instalacji Edge z jednym węzłem ZooKeeper parametr Mode jest ustawiony na „standalone”.

  3. Powtórz kroki 1 i 2 w przypadku każdego węzła ZooKeeper.

Uaktualnianie ZooKeepera na węzłach obserwatora i obserwującego

Uaktualnij ZooKeepera na każdym węźle obserwatora i obserwującego w następujący sposób:

  1. Pobierz i uruchom bootstrap Edge dla chmury prywatnej 4.52 zgodnie z opisem w artykule Aktualizacja do wersji 4.52.01 na węźle z zewnętrznym połączeniem internetowym. Proces będzie się prawdopodobnie różnić w zależności od tego, czy węzeł ma zewnętrzne połączenie z internetem, czy 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 teraz uaktualnić (np. za pomocą profilu cs,zk) lub uaktualnić je później. Apigee zaleca, aby najpierw uaktualnić tylko ZooKeepera i upewnić się, że klaster działa prawidłowo, a dopiero potem uaktualnić inne komponenty.
  3. Powtórz powyższe kroki na każdym węźle obserwatora i obserwującego ZooKeeper.

Wyłącz lidera

Po uaktualnieniu wszystkich węzłów obserwatora i obserwującego wyłącz lidera. W węźle zidentyfikowanym jako lider uruchom poniższe polecenie: 

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

Pamiętaj, że podczas tego zdarzenia, zanim zostanie wybrany nowy lider, mogą wystąpić chwilowe opóźnienia lub błędy zapisu w ZooKeeperze. Może to mieć wpływ na operacje, które zapisują dane w ZooKeeper, takie jak wdrażanie serwerów proxy lub zmiany w infrastrukturze Apigee, np. dodawanie lub usuwanie procesorów komunikatów.

Sprawdzanie, czy nowy lider został wybrany

Wykonaj czynności opisane w sekcji Identyfikowanie lidera, obserwujących i obserwatorów powyżej, aby sprawdzić, czy po zatrzymaniu dotychczasowego lidera został wybrany nowy lider spośród obserwujących. Pamiętaj, że lider mógł zostać wybrany w innym centrum danych niż obecny lider.

Uaktualnij lidera

Wykonaj te same czynności co w sekcji Uaktualnianie ZooKeepera na węzłach obserwatora i obserwującego powyżej.

Po uaktualnieniu starego węzła lidera sprawdź stan klastra i upewnij się, że istnieje węzeł lidera.

Przywróć

Jeśli konieczne jest wycofanie:

  1. Najpierw wykonaj kroki wycofywania na obserwatorach i obserwujących.
  2. Pobierz i uruchom wczytywanie wersji, do której chcesz wrócić – 4.50 lub 4.51. Proces będzie się prawdopodobnie różnić w zależności od tego, czy węzeł ma zewnętrzne połączenie z internetem, czy też przeprowadzasz instalację offline.
  3. Zatrzymaj ZooKeepera, jeśli jest uruchomiony w węźle: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
  4. Odinstaluj istniejący 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 przywróceniu wszystkich węzłów obserwujących i obserwatorów przywróć węzeł lidera, wykonując kroki od 2 do 5 na węźle lidera.
  7. Po przywróceniu wszystkich węzłów sprawdź stan klastra i upewnij się, że jest w nim węzeł lidera.

Przywróć kopię zapasową

Zapoznaj się z artykułem Przywracanie z kopii zapasowej. Pamiętaj, że kopie zapasowe ZooKeepera utworzone we wcześniejszych wersjach Edge dla chmury prywatnej, takich jak 4.50 i 4.51, powinny być zgodne z wersją ZooKeepera w Edge dla chmury prywatnej 4.52.

Wymagane uaktualnienie do Postgres 14

Ta wersja Edge dla chmury prywatnej obejmuje uaktualnienie do Postgres 14. W ramach tego uaktualnienia wszystkie dane Postgres są przenoszone do Postgres 14.

  • Jeśli uaktualniasz Edge dla chmury prywatnej z wersji 4.51.00 do wersji 4.52.01, musisz wykonać dodatkowe czynności uaktualniania Postgres. Jeśli uaktualniasz wersję 4.51.00 do wersji 4.52.01, zapoznaj się z sekcją Wymagane uaktualnienie do Postgres 14.
  • Jeśli uaktualniasz Edge dla chmury prywatnej z wersji 4.52.00 do wersji 4.52.01, nie musisz wykonywać żadnych dodatkowych czynności związanych z uaktualnieniem Postgres.

Uaktualnianie Qpid

Ta wersja Edge dla chmury prywatnej zawiera uaktualnienie do Qpid J-Broker.

Zalecamy wybranie jednej z tych metod uaktualnienia Qpid:

Uaktualnienie na miejscu bez przestojów

Ta metoda gwarantuje, że nie będzie przerw w działaniu środowiska wykonawczego Edge, i minimalizuje utratę danych środowiska wykonawczego (jeśli takie istnieją) pozyskanych na potrzeby analizy.

Aby przeprowadzić uaktualnienie do Qpid na miejscu i bez przestojów:

  1. Wybierz jeden węzeł Qpid, aby rozpocząć.
  2. Zatrzymaj brokera Qpid na węźle: 
    apigee-service apigee-qpidd stop
  3. Zablokuj ruch przychodzący na porcie brokera 5672 ze wszystkich procesorów komunikatów, stosując zaporę sieciową. Możesz zastosować tę zaporę sieciową na poziomie instancji węzła Qpid lub innego zewnętrznego komponentu zapory sieciowej lub sieci.

    Zalecamy wykonanie tego samego kroku w przypadku wszystkich adresów IP procesorów komunikatów. Aby na przykład za pomocą IPTables odrzucić (DROP) żądania przychodzące z adresów IP procesora komunikatów 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 opróżnić istniejące wiadomości (jeśli są): 
    apigee-service apigee-qpidd start
  5. Sprawdź, czy istniejące kolejki są puste: 
    qpid-stat -q

    Jeśli wiadomości utknęły w kolejce niedostarczonych komunikatów (ax-q-axgroup-001-consumer-group-001-dl), opróżnij ją, wykonując czynności opisane w sekcji dotyczącej rozwiązywania problemów z danymi analitycznymi, które utknęły w kolejce niedostarczonych komunikatów.

  6. Po sprawdzeniu, czy kolejki zostały opróżnione w starym węźle, zatrzymaj apigee-qpidd: 
    apigee-service apigee-qpidd stop
  7. Uaktualnij Qpid w węźle: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Uruchom ponownie edge-qpid-server: 
    apigee-service edge-qpid-server restart

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

    Wykonaj tę samą czynność usuwania w przypadku wszystkich adresów IP procesorów komunikatów, do których zastosowano zaporę sieciową. Po usunięciu zapór sieciowych żądania pochodzące z adresów IP procesora komunikatów do węzła Qpid na porcie 5672 będą akceptowane. Jeśli do dodania zapory sieciowej użyto iptables, możesz usunąć zaporę sieciową i wyświetlić listę istniejących ustawień za pomocą poleceń takich jak:

    iptables -F
  iptables -L
  10. Użyj monitorowania sieci, aby sprawdzić, czy kolejki Qpid otrzymują wiadomości: 
    http://QPID_NODE_IP:8090
  11. Powtórz kroki od 1 do 9 dla każdego węzła Qpid.

Uruchamianie 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. Ten krok konfiguruje węzeł Qpid z J-brokerem. 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. Zablokuj ruch przychodzący na porcie brokera 5672 ze wszystkich procesorów komunikatów, stosując zaporę sieciową. Możesz zastosować tę zaporę sieciową na poziomie instancji węzła Qpid lub innego zewnętrznego komponentu zapory sieciowej lub sieci.

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

    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 są): 
    apigee-service apigee-qpidd start
  6. Sprawdź, czy istniejące kolejki są puste: 
    qpid-stat -q

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

  7. Po sprawdzeniu, czy kolejki na starym węźle zostały opróżnione, zatrzymaj apigee-qpidd 
    apigee-service apigee-qpidd stop
  8. Wyrejestruj stary węzeł Qpid, wykonując czynności opisane w artykule Usuwanie serwera Qpid.
  9. Dodawaj nowe węzły i usuwaj stare, po jednym naraz, aż wszystkie węzły Qpid zostaną uaktualnione.

Przywróć

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

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

  1. Zatrzymaj istniejącego brokera Qpid 
    apigee-service apigee-qpidd stop
  2. Zablokuj ruch przychodzący na porcie brokera 5672 ze wszystkich procesorów komunikatów, stosując zaporę sieciową. Możesz zastosować tę zaporę sieciową na poziomie instancji węzła Qpid lub innego zewnętrznego komponentu zapory sieciowej lub sieci.

    Zalecamy wykonanie tego samego kroku w przypadku wszystkich adresów IP procesorów komunikatów. Aby na przykład za pomocą IPTables odrzucić (DROP) żądania przychodzące z adresów IP procesora komunikatów 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 opróżnić istniejące wiadomości, jeśli takie są: 
    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 w węźle QPID jest niedostępny, możesz użyć alternatywnych mechanizmów, takich jak przekierowanie portów SSH, aby uzyskać dostęp do tego adresu URL.
  5. Po sprawdzeniu, czy kolejki zostały opróżnione, 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 listę istniejących ustawień za pomocą tych poleceń: 
    iptables -F
     
    iptables -L

Nowy interfejs Edge

Ta sekcja zawiera uwagi dotyczące interfejsu Edge. Więcej informacji znajdziesz w artykule o nowym interfejsie Edge dla chmury prywatnej.

Instalowanie interfejsu Edge UI

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

Zapisywanie 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 aktualizowanie 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, 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 instalacji cichej

Do polecenia aktualizacji musisz przekazać plik instalacji cichej. Plik instalacji cichej powinien być taki sam jak ten, który został użyty 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 na węźle, wykonaj te czynności:

  1. Jeśli są jakieś zadania cron skonfigurowane do wykonywania operacji 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, 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 obecnie używasz Edge 4.51.00:

    1. Pobierz plik Edge bootstrap_4.52.01.sh do /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 Edge 4.52.01 apigee-service i 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ą 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ć środowisko Java.
    3. 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
    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 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.50.00 lub 4.51.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
    7. Jeśli jeszcze nie zostało to zrobione, uruchom ponownie komponenty interfejsu Edge na wszystkich węzłach, na których są uruchomione: 
      /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
    8. 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.52.01.

Aktualizacja do wersji 4.52.01 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.52.01:

  1. Utwórz lokalne repozytorium 4.52.01 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.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 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.52.01.tar.gz

      To polecenie tworzy nowy katalog o nazwie repos w katalogu zawierającym plik .tar. Przykład: /tmp/repos.

    4. Zainstaluj narzędzie Edge apigee-service i zależności z /tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.52.01.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 apigee-setup Edge.
    2. Na węźle zdalnym pobierz plik Edge bootstrap_4.52.01.sh do /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. W węźle zdalnym zainstaluj narzędzie Edge apigee-setup i zależności: 
      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. 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)
      • Nowy interfejs Edge ue
      • 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.50.00 lub 4.51.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.52.01.

Kolejność aktualizacji maszyn

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

  • Przed aktualizacją innych węzłów 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, który trzeba wykonać, aby zaktualizować zarabianie. Jest aktualizowany, gdy określisz opcję -c edge.

Samodzielna licencja na 1 węzeł

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

  1. Zaktualizuj wszystkie komponenty: 
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. (Jeśli masz zainstalowane narzędzie apigee-adminapi) Zaktualizowaliśmy 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 liczbę węzłów znajdziesz w artykule Topologie instalacji.

  1. Zaktualizuj systemy 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. Zaktualizuj komponenty Edge na maszynach 2 i 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. Zaktualizuj Qpid na komputerze 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 masz zainstalowane narzędzie 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

    sso_config_file to plik konfiguracji utworzony podczas instalowania logowania jednokrotnego.

  9. 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 liczbę węzłów znajdziesz w artykule Topologie instalacji.

  1. Zaktualizuj Cassandrę i ZooKeepera na maszynach 1, 2 i 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Zaktualizuj Postgres 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. Zaktualizuj Qpid na maszynie 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Zaktualizuj interfejs Edge:
    • Klasyczny interfejs użytkownika: jeśli używasz klasycznego interfejsu użytkownika, zaktualizuj komponent ui na komputerze 1, jak pokazano w tym przykładzie: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    • Nowy interfejs Edge: jeśli masz zainstalowany nowy interfejs 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
  9. (Jeśli masz zainstalowane narzędzie 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 SSO w Apigee) Zaktualizuj SSO w Apigee na komputerze 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    sso_config_file to plik konfiguracji utworzony podczas instalowania logowania jednokrotnego.

  11. Uruchom ponownie komponent UI:
    • 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 liczbę węzłów znajdziesz w artykule Topologie instalacji.

  1. Zaktualizuj Cassandrę i ZooKeepera na maszynach 1, 2 i 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Zaktualizuj Postgres 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 tej 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 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

    sso_config_file to plik konfiguracji utworzony podczas instalowania logowania jednokrotnego.

  10. Uruchom ponownie komponent UI:
    • 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 13 węzłami

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

Listę topologii Edge i liczbę 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 Postgres 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 tej 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 komputerach 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 maszynach 6 i 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    sso_config_file to plik konfiguracji utworzony podczas instalowania logowania jednokrotnego.

  10. Uruchom ponownie komponent UI:
    • Klasyczny interfejs: jeśli używasz klasycznego interfejsu, uruchom ponownie 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 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 liczbę 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 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. 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
  5. 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 komputerze 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
  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. Gdzie 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 komputerach 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. 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. qpidd
  7. Interfejs użytkownika Edge (klasyczny lub nowy)
  8. apigee-adminapi
  9. SSO w Apigee

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