Aktualizacja Apigee Edge 4.51.00 lub 4.52.00 do 4.52.01

Apigee obsługuje uaktualnienie Edge dla Private Cloud z wersji 4.51.00 lub 4.52.00 bezpośrednio do wersji 4.52.01. Na tej stronie opisujemy, jak przeprowadzić uaktualnienie.

Kto może przeprowadzić aktualizację

Osoba, która przeprowadza aktualizację, powinna być taka sama jak osoba, która pierwotnie zainstalowała Edge lub użytkownik root.

Po zainstalowaniu RPM serwerów brzegowych 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.

Zaktualizuj wymagania wstępne

Przed uaktualnieniem Apigee Edge upewnij się, że spełniasz te wymagania wstępne:

  • Utwórz kopię zapasową wszystkich węzłów
    Ze względów bezpieczeństwa przed aktualizacją zalecamy wykonanie pełnej kopii zapasowej wszystkich węzłów. Aby utworzyć kopię zapasową, wykonaj czynności wymagane w przypadku bieżącej wersji Edge.

    Pozwala to przygotować plan wykonywania kopii zapasowych na wypadek, gdyby aktualizacja do nowej wersji nie zadziałała prawidłowo. Więcej informacji na temat tworzenia kopii zapasowych znajdziesz w artykule Tworzenie i przywracanie kopii zapasowych.

  • Upewnij się, że serwer Edge jest uruchomiony
    Użyj polecenia, aby upewnić się, że Edge działa i działa w trakcie procesu aktualizacji: 
    /opt/apigee/apigee-service/bin/apigee-all status
  • Upewnij się, że strategia kompatybilności Cassandra jest ustawiona na LeveledCompactionStrategy
    Upewnij się, że strategia kompilacji Cassandra jest ustawiona na LeveledCompactionStrategy zgodnie z opisem w sekcji Zmienianie strategii kompresowania Cassandra.

Automatyczne rozpowszechnianie ustawień usługi

Jeśli ustawisz jakieś właściwości przez edytowanie plików .properties w usłudze /opt/apigee/customer/application, wartości zostaną zachowane.

Wymagane uaktualnienie do wersji Zookeeper 3.8.3

Ta wersja Edge for Private Cloudes obejmuje uaktualnienie do Zookeeper 3.8.3. W ramach tego uaktualnienia wszystkie dane Zookeeper zostaną przeniesione do wersji 3.8.3.

Zanim uaktualnisz Zookeeper, przeczytaj przewodnik po konserwacji. Większość systemów produkcyjnych Edge używa klastra węzłów Zookeeper rozłożonych w wielu centrach danych. Niektóre z tych węzłów są skonfigurowane jako wyborcy, którzy biorą udział w wyborach lidera Zookeeper, a pozostałe są skonfigurowane jako obserwatorzy. Więcej informacji znajdziesz w artykule Informacje o liderach, obserwatorach, wyborcach i obserwatorach. Węzły wyborcze wybierają lidera, po czym same węzły wyborcze stają się obserwatorami.

Podczas procesu aktualizacji może wystąpić chwilowe opóźnienie lub awaria zapisu w Zookeeper, gdy węzeł wiodący zostanie wyłączony. Może to mieć wpływ na operacje zarządzania zapisywane w Zookeeper, takie jak operacja wdrażania serwera proxy czy zmiany w infrastrukturze Apigee, np. dodanie lub usunięcie procesora wiadomości. Nie powinno to mieć wpływu na działające w czasie działania interfejsy API Apigee (chyba że te interfejsy API do zarządzania wywołaniami tej aplikacji) podczas uaktualniania Zookeeper i wykonywania poniższej procedury.

Ogólnie proces uaktualniania obejmuje tworzenie kopii zapasowej każdego węzła. Następnie należy uaktualnić wszystkie obserwatorów i obserwatorów, a na koniec uaktualnić węzeł główny.

Zrób kopię zapasową

Zrób kopię zapasową wszystkich węzłów Zookeeper do użycia na wypadek, gdyby wymagane było przywrócenie. Pamiętaj, że przywrócenie spowoduje przywrócenie Zookeeper do stanu z chwili utworzenia kopii zapasowej. Uwaga: wszystkie wdrożenia i zmiany infrastruktury w Apigee od czasu utworzenia kopii zapasowej (które informacje są przechowywane w Zookeeper) zostaną utracone podczas przywracania. 

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

Jeśli korzystasz z maszyn wirtualnych i masz odpowiednie uprawnienia, możesz też w razie potrzeby wykonać zrzuty maszyny wirtualnej lub kopie zapasowe, aby je przywrócić lub przywrócić.

Określenie lidera, obserwatorów i obserwatorów

Uwaga: w poniższych przykładowych poleceniach użyj narzędzia nc, aby wysłać dane do Zookeeper. Do wysyłania danych do Zookeeper możesz też użyć 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

    Zostaną wyświetlone 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 zależności od konfiguracji węzła w wierszu Mode danych wyjściowych węzłów powinien być widoczny obserwator, lider lub obserwator (co oznacza, że wyborca nie jest liderem). Uwaga: w samodzielnej instalacji Edge z jednym węzłem ZooKeeper interfejs Mode jest ustawiony jako samodzielny.

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

Uaktualnij Zookeeper w węzłach obserwatora i obserwatorów

Uaktualnij Zookeeper w każdym z węzłów obserwatora i obserwatora w następujący sposób:

  1. Pobierz i uruchom przeglądarkę Edge dla Private Cloud 4.52 zgodnie z opisem w sekcji Aktualizacja do wersji 4.52.01 w węźle z zewnętrznym połączeniem internetowym. Proces będzie prawdopodobnie różnić się w zależności od tego, czy węzeł ma zewnętrzne połączenie internetowe, czy wykonujesz instalację offline.
  2. Uaktualnij komponent Zookeeper: 
      /opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
    Uwaga: jeśli w tych węzłach są zainstalowane inne komponenty (np. Cassandra), możesz je uaktualnić teraz (np. za pomocą profilu cs,zk) lub później. Apigee zaleca, aby przed uaktualnieniem innych komponentów tylko uaktualnić Zookeeper i upewnić się, że klaster działa prawidłowo.
  3. Powtórz powyższe kroki w przypadku każdego węzła obserwatora Zookeeper i węzła kolejnych.

Zamknij lidera

Po uaktualnieniu wszystkich węzłów obserwacyjnych i obserwacyjnych wyłącz replikę wiodącą. W węźle zidentyfikowanym jako replika wiodąca uruchom to polecenie: 

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

Pamiętaj, że w trakcie tego wydarzenia przed wybraniem nowego lidera mogą wystąpić chwilowe opóźnienia lub błędy zapisu w Zookeeper. Może to wpływać na operacje zapisu w Zookeeper, takie jak działanie związane z wdrożeniem serwerów proxy lub zmiany w infrastrukturze Apigee, takie jak dodawanie lub usuwanie procesorów wiadomości.

Sprawdź, czy wybrano nowego lidera

Wykonaj czynności podane w sekcji Identyfikowanie lidera, obserwatorów i obserwatorów powyżej, aby sprawdzić, czy z Twoich obserwatorów został wybrany nowy lider, gdy obecny lider zostanie zatrzymany. Pamiętaj, że lider mógł zostać wybrany w innym centrum danych niż obecny lider.

Uaktualnij lidera

Wykonaj te same czynności co w kroku Uaktualnianie Zookeeper w węzłach obserwatora i obserwatorów powyżej.

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

Przywróć

Jeśli konieczne jest przywrócenie poprzedniej wersji:

  1. Najpierw wykonaj kroki przywracania na obserwatorach i obserwatorach.
  2. Pobierz i uruchom ponownie przywracaną wersję – 4.50 lub 4.51. Ten proces będzie prawdopodobnie różnić się w zależności od tego, czy węzeł ma zewnętrzne połączenie internetowe, czy używasz instalacji offline.
  3. Zatrzymaj Zookeeper, jeśli jest uruchomiony w węźle: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
  4. Odinstaluj istniejącą aplikację zookeeper: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall
  5. Zainstaluj Zookeeper tak jak zwykle: 
      /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>
  6. Po wycofaniu wszystkich obserwujących i obserwatorów wycofaj węzeł wiodący, wykonując kroki od 2 do 5 w węźle wiodącym.
  7. Po wycofaniu wszystkich węzłów sprawdź stan klastra i upewnij się, że istnieje w nim węzeł główny.

Przywrócenie kopii zapasowej

Więcej informacji znajdziesz w artykule Przywracanie danych z kopii zapasowej. Pamiętaj, że kopie zapasowe Zookeeper pobrane z wcześniejszych wersji Edge dla Private Cloud, takich jak 4.50 i 4.51, powinny być zgodne z wersją Zookeeper w Edge dla Private Cloud 4.52.

Uaktualnij Qpid

Ta wersja Edge dla Private Cloud zawiera uaktualnienie do usługi Qpid J-Broker. Zalecamy wybranie jednej z tych metod uaktualnienia Qpid:

Lokalne uaktualnienie z zerowym czasem przestoju

Ta metoda zapewnia brak przestojów w środowisku wykonawczym Edge i minimalizuje utratę danych środowiska wykonawczego (jeśli występują) pozyskanych na potrzeby analiz.

Aby przeprowadzić wdrożenie na miejscu, zero przestojów w uaktualnianiu do Qpid:

  1. Wybierz na początek 1 węzeł Qpid.
  2. Zatrzymaj brokera Qpid w węźle: 
    apigee-service apigee-qpidd stop
  3. Zablokuj ruch przychodzący na porcie brokera 5672 ze wszystkich procesorów wiadomości, stosując zaporę sieciową. Tę zaporę sieciową możesz zastosować na poziomie instancji węzła Qpid lub innego zewnętrznego komponentu zapory sieciowej/sieci.

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

    iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
  4. Ponownie uruchom brokera Qpid, aby opróżnić istniejące wiadomości (jeśli są takie): 
    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 (DLQ) (ax-q-axgroup-001-consumer-group-001-dl), opróżnij kolejkę, wykonując czynności umożliwiające rozwiązanie problemu danych analitycznych, które utknęły w kolejce niedostarczonych komunikatów.

  6. Po sprawdzeniu, czy kolejki w starym węźle zostały opróżnione, zatrzymaj instancję maszyny wirtualnej 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. Ponowne uruchomienie edge-qpid-server: 
    apigee-service edge-qpid-server restart

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

    Wykonaj ten sam krok usuwania dla wszystkich adresów IP procesora wiadomości, do których zastosowano zaporę sieciową. Po usunięciu zapór sieciowych żądania przychodzące z adresów IP procesora wiadomości do węzła Qpid na porcie 5672 będą akceptowane. Jeśli do dodania zapory sieciowej użyto polecenia iptables, do jej usunięcia i wyświetlenia listy istniejących ustawień możesz użyć poleceń takich jak:

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

Uruchamiam nowy węzeł Qpid

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

  1. Dodaj nowy węzeł Qpid. W tym kroku skonfigurujesz węzeł Qpid z usługą J-broker. Szczegółowe instrukcje znajdziesz w artykule o dodawaniu serwera Qpid.
  2. Wybierz istniejący węzeł Qpid (węzeł z wersji, z której przeprowadzasz uaktualnienie).
  3. Zatrzymaj brokera Qpid w węźle: 
    apigee-service apigee-qpidd stop
  4. Zablokuj ruch przychodzący na porcie brokera 5672 ze wszystkich procesorów wiadomości, stosując zaporę sieciową. Tę zaporę sieciową możesz zastosować na poziomie instancji węzła Qpid lub innego zewnętrznego komponentu zapory sieciowej/sieci.

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

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

    Jeśli wiadomości utkną w kolejce niedostarczonych komunikatów (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 utknęły w kolejce niedostarczonych komunikatów w Qpidd.

  7. Po sprawdzeniu, czy kolejki w 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 sekcji 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ć poprzednią wersję. 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 istniejący brokera Qpid 
    apigee-service apigee-qpidd stop
  2. Zablokuj ruch przychodzący na porcie brokera 5672 ze wszystkich procesorów wiadomości, stosując zaporę sieciową. Tę zaporę sieciową możesz zastosować na poziomie instancji węzła Qpid lub innego zewnętrznego komponentu zapory sieciowej/sieci.

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

    iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
  3. Ponownie uruchom brokera qpid, aby opróżnić istniejące wiadomości (jeśli 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 uzyskać dostęp do tego adresu URL za pomocą alternatywnych mechanizmów, takich jak przekierowanie portów SSH.
  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 wszystkie istniejące ustawienia, używając tych poleceń: 
    iptables -F
    iptables -L

Nowy interfejs Edge

Ta sekcja zawiera uwagi dotyczące interfejsu użytkownika Edge. Więcej informacji znajdziesz w artykule o nowym interfejsie Edge dla Private Cloud.

Instalowanie interfejsu użytkownika Edge

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

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

Więcej informacji znajdziesz w temacie Instalowanie nowego interfejsu użytkownika Edge.

Aktualizowanie interfejsu użytkownika Edge

Aby zaktualizować komponent interfejsu użytkownika brzegowego, weź pod uwagę wersję Edge dla chmury prywatnej, z której uaktualniasz:

Aktualizacja z użyciem Apigee mTLS

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

Wycofywanie aktualizacji

W przypadku niepowodzenia aktualizacji możesz spróbować rozwiązać problem, a potem wykonać update.sh jeszcze raz. Możesz przeprowadzić aktualizację kilka razy i kontynuować ją od miejsca, w którym została wstrzymana.

Jeśli błąd wymaga przywrócenia aktualizacji do poprzedniej wersji, szczegółowe instrukcje znajdziesz w sekcji Przywracanie wersji 4.52.00.

Informacje o aktualizacji logowania

Domyślnie narzędzie update.sh zapisuje informacje w dzienniku 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, zapisuje dziennik w katalogu /tmp jako plik o nazwie update_username.log.

Jeśli ta osoba nie ma dostępu do usługi /tmp, narzędzie update.sh przestanie działać.

Aktualizacja bez przestojów

Aktualizacja krocząca bez przestojów umożliwia zaktualizowanie 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 usunięcie każdego routera pojedynczo z systemu równoważenia obciążenia. Następnie zaktualizuj router i wszystkie inne komponenty na tej samej maszynie co router, a następnie dodaj go z powrotem do systemu równoważenia obciążenia.

  1. Zaktualizuj maszyny w prawidłowej kolejności instalacji zgodnie z opisem Kolejność aktualizacji maszyny.
  2. Gdy nadejdzie czas zaktualizowania routerów, wybierz dowolny router i ustaw go jako nieosiągalny zgodnie z opisem w sekcji Osiągalność serwera (procesor wiadomości/router).
  3. Zaktualizuj wybrany router i wszystkie inne komponenty brzegowe na tej samej maszynie co router. Wszystkie konfiguracje brzegowe pokazują router i procesor wiadomości w tym samym węźle.
  4. Spraw, aby router był ponownie osiągalny.
  5. Powtórz kroki 2–4 dla pozostałych routerów.
  6. Kontynuuj aktualizację na pozostałych komputerach w instalacji.

Przed aktualizacją i po niej:

Użyj pliku konfiguracji w trybie cichym

Do polecenia aktualizacji musisz przekazać dyskretny plik konfiguracji. Plik konfiguracji dyskretnej powinien być taki sam jak plik użyty do zainstalowania Edge 4.50.00 lub 4.51.00.

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

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

  1. Jeśli jest obecne, wyłącz wszystkie zadania cron skonfigurowane do wykonywania operacji naprawy na Cassandra 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 sekcji Instalowanie narzędzia Edge apigee-setup.
  5. Jeśli instalujesz oprogramowanie w Oracle 7.x, wykonaj to polecenie: 
    sudo yum-config-manager --enable ol7_optional_latest
  6. Jeśli instalujesz w 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. Jeśli korzystasz z Edge 4.51.00:

    1. Pobierz plik Edge bootstrap_4.52.01.sh do witryny /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 i zależności apigee-service, 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 z Apigee. Jeśli pominiesz właściwość pWord, pojawi się prośba o jej podanie.

      Domyślnie instalator sprawdza, czy zainstalowano środowisko Java 1.8. Jeśli tego nie zrobisz, instalator zainstaluje ją za Ciebie.

      Aby określić sposób obsługi instalacji Java, użyj opcji JAVA_FIX. JAVA_FIX przyjmuje te wartości:

      • I: zainstaluj OpenJDK 1.8 (domyślnie).
      • C: kontynuuj bez instalowania języka Java.
      • Q: Zakończ. W przypadku tej opcji musisz samodzielnie zainstalować język Java.
    3. Użyj apigee-service, aby zaktualizować narzędzie apigee-setup, tak jak w tym przykładzie: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    4. Zaktualizuj narzędzie apigee-validate na serwerze zarządzania zgodnie z poniższym przykładem: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    5. Zaktualizuj narzędzie apigee-provision na serwerze zarządzania zgodnie z poniższym przykładem: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
    6. Uruchom narzędzie update w swoich 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 maszyny.

      Gdzie:

      • component to komponent Edge do zaktualizowania. Możliwe wartości:
        • cs: Cassandra
        • edge: wszystkie komponenty brzegowe oprócz interfejsu użytkownika Edge: serwer zarządzania, procesor wiadomości, router, serwer QPID i serwer Postgres
        • ldap: OpenLDAP
        • ps: postgresql
        • qpid: qpidd
        • sso: logowanie jednokrotne w Apigee (jeśli masz zainstalowane logowanie jednokrotne).
        • ue: nowy interfejs Edge
        • ui: klasyczny interfejs użytkownika Edge
        • zk: opiekuna zoo
      • configFile to ten sam plik konfiguracji, który został użyty do zdefiniowania komponentów Edge podczas instalacji w wersji 4.50.00 lub 4.51.00.

      Możesz uruchomić update.sh dla wszystkich komponentów, ustawiając component na „wszystkie”, 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. Ponownie uruchom komponent interfejsu Edge we wszystkich węzłach, w których jest uruchomiony: 
      /opt/apigee/apigee-service/bin/apigee-service 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ę, użyj procedury opisanej w sekcji Wycofywanie aktualizacji do wersji 4.52.01.

Aktualizacja lokalnego repozytorium do wersji 4.52.01

Jeśli węzły brzegowe znajdują się za zaporą sieciową lub z innego powodu nie mają dostępu do repozytorium Apigee przez internet, możesz wykonać aktualizację z lokalnego repozytorium lub jego powielania.

Po utworzeniu lokalnego repozytorium Edge możesz zaktualizować Edge z poziomu lokalnego repozytorium na 2 sposoby:

  • Utwórz plik .tar repozytorium, skopiuj go do węzła i zaktualizuj Edge z tego pliku.
  • 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, którego możesz używać, możesz też użyć własnego serwera.

Aby zaktualizować dane z lokalnego repozytorium w wersji 4.52.01:

  1. Utwórz lokalne repozytorium w wersji 4.52.01 zgodnie z opisem w sekcji „Tworzenie lokalnego repozytorium Apigee” artykułu Instalowanie narzędzia Edge apigee-setup.
  2. Aby zainstalować apigee-service z pliku .tar:
    1. W węźle z repozytorium lokalnym spakuj lokalne repozytorium do jednego pliku .tar o nazwie /opt/apigee/data/apigee-mirror/apigee-4.52.01.tar.gz, korzystając z następującego polecenia: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. Skopiuj plik .tar do węzła, w którym chcesz zaktualizować Edge. Na przykład skopiuj go do katalogu /tmp w nowym węźle.
    3. W nowym węźle przenieś 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 serwera /tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.52.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Zwróć uwagę, że to polecenie zawiera ścieżkę do katalogu repos.

  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” artykułu Instalowanie narzędzia Edge Apigee-setup.
    2. W węźle zdalnym pobierz plik Edge bootstrap_4.52.01.sh do serwera /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 repozytorium.

  4. Użyj apigee-service, aby zaktualizować narzędzie apigee-setup, tak jak w tym przykładzie: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. Zaktualizuj narzędzie apigee-validate na serwerze zarządzania zgodnie z poniższym przykładem: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. Zaktualizuj narzędzie apigee-provision na serwerze zarządzania zgodnie z poniższym przykładem: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. Uruchom narzędzie update w 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 do zaktualizowania. Zazwyczaj aktualizujesz te komponenty:
      • cs: Cassandra
      • edge: wszystkie komponenty brzegowe oprócz interfejsu użytkownika Edge: serwer zarządzania, procesor wiadomości, router, serwer QPID, serwer Postgres
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: logowanie jednokrotne w Apigee (jeśli masz zainstalowane logowanie jednokrotne).
      • Nowy interfejs użytkownika Edge w ue
      • ui: klasyczny interfejs użytkownika Edge
      • zk: opiekuna zoo
    • configFile to ten sam plik konfiguracji, który został użyty do zdefiniowania komponentów Edge podczas instalacji w wersji 4.50.00 lub 4.51.00.

    Możesz uruchomić update.sh dla wszystkich komponentów, ustawiając component na „wszystkie”, 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 we wszystkich węzłach, w których jest uruchomiony: 
    /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ę, użyj procedury opisanej w sekcji Wycofywanie aktualizacji do wersji 4.52.01.

Kolejność aktualizacji maszyny

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 brzegowymi (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 dany krok określa, że powinien zostać wykonany na wielu komputerach, wykonaj go w określonej kolejności maszyn.
  • Żeby zaktualizować sekcję Zarabianie, nie musisz robić nic osobnego. Jest aktualizowana, gdy określisz opcję -c edge.

Uaktualnienie samodzielne z 1 węzłem

Aby uaktualnić samodzielną konfigurację 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 zainstalowano apigee-adminapi) Zaktualizowano narzędzie apigee-adminapi: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

Uaktualnienie samodzielne z 2 węzłami

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

Listę topologii brzegowych i numerów węzłów znajdziesz w sekcji Topologie instalacji.

  1. Zaktualizuj Cassandra i ZooKeeper na komputerze 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Aktualizowanie Postgres na komputerze 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Zaktualizuj LDAP na komputerze 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Zaktualizuj komponenty brzegowe w 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 użytkownika 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 zainstalowano logowanie jednokrotne w Apigee) Zaktualizuj logowanie jednokrotne 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 instalacji logowania jednokrotnego.

  9. Ponownie uruchom komponent interfejsu użytkownika Edge na maszynie 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Uaktualnienie 5 węzłów

Zaktualizuj następujące komponenty w przypadku instalacji z 5 węzłami:

Listę topologii brzegowych i numerów węzłów znajdziesz w sekcji 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 Postgres w maszynie 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Zaktualizuj Postgres w maszynie 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Zaktualizuj LDAP na komputerze 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Aktualizowanie komponentów brzegowych w maszynie 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: jeśli korzystasz z 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 zainstalowano nowy interfejs Edge, zaktualizuj komponent ue na odpowiedniej maszynie (może to nie być maszyna 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 zainstalowano logowanie jednokrotne w Apigee) Zaktualizuj logowanie jednokrotne 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 instalacji logowania jednokrotnego.

  11. Ponownie uruchom komponent UI:
    • Klasyczny interfejs: jeśli korzystasz z 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 użytkownika Edge: jeśli zainstalowano nowy interfejs użytkownika Edge, ponownie uruchom komponent edge-management-ui na odpowiedniej maszynie (może to nie być maszyna 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 brzegowych i numerów węzłów znajdziesz w sekcji 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 Postgres w maszynie 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Zaktualizuj Postgres w maszynie 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Zaktualizuj LDAP na komputerze 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Zaktualizuj komponenty Edge w maszynie 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 komputerach 6 i 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Zaktualizuj nowy interfejs użytkownika (ue) lub klasyczny (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 zainstalowano logowanie jednokrotne w Apigee) Zaktualizuj logowanie jednokrotne 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 instalacji logowania jednokrotnego.

  10. Ponownie uruchom komponent UI:
    • Klasyczny interfejs: jeśli korzystasz z 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 użytkownika Edge: jeśli zainstalowano nowy interfejs użytkownika Edge, ponownie uruchom komponent edge-management-ui na odpowiedniej maszynie (może to nie być maszyna 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 brzegowych i numerów węzłów znajdziesz w sekcji Topologie instalacji.

  1. Zaktualizuj Cassandra i ZooKeeper na komputerach 1, 2 i 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Zaktualizuj Postgres w maszynie 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Zaktualizuj Postgres w maszynie 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Zaktualizuj LDAP na komputerach 4 i 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Zaktualizuj komponenty Edge na komputerach 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 komputerach 12 i 13: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Zaktualizuj nowy interfejs użytkownika (ue) lub klasyczny (ui) na komputerach 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 komputerach 6 i 7: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (Jeśli zainstalowano logowanie jednokrotne w Apigee) Zaktualizuj logowanie jednokrotne 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 instalacji logowania jednokrotnego.

  10. Ponownie uruchom komponent UI:
    • Klasyczny interfejs: jeśli korzystasz z klasycznego interfejsu użytkownika, ponownie uruchom 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 użytkownika Edge: jeśli zainstalowano nowy interfejs użytkownika Edge, ponownie uruchom 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

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

Listę topologii brzegowych i numerów węzłów znajdziesz w sekcji 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. 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. Aktualizacja qpidd na komputerze 4: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Aktualizacja qpidd na komputerze 5: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. Maszyny 10, 11 w centrum danych 2
      1. Zaktualizuj qpidd na komputerze 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 interfejs nowy (ue) lub klasyczny (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 zainstalowano 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 zainstalowano logowanie jednokrotne w Apigee) Zaktualizuj logowanie jednokrotne 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 instalacji logowania jednokrotnego.

  9. Ponownie uruchom nowy komponent interfejsu Edge (edge-management-ui) lub klasycznej wersji UI Edge (edge-ui) na komputerach 1 i 7: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

W przypadku konfiguracji niestandardowej

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

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

Po zakończeniu aktualizacji ponownie uruchom komponent interfejsu Edge na wszystkich komputerach, na których jest uruchomiony.