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 wersji 4.52.00 bezpośrednio do wersji 4.52.01. Na tej stronie dowiesz się, jak przeprowadzić uaktualnienie.

Kto może przeprowadzić aktualizację

Osobą uruchamiającą aktualizację powinna być ta sama osoba, która pierwotnie zainstalowała Edge lub jako użytkownik roota.

Gdy zainstalujesz pakiety RPM Edge, każdy będzie mógł je skonfigurować.

Które komponenty musisz zaktualizować

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

Zaktualizuj wymagania wstępne

Zanim uaktualnisz Apigee Edge, musisz spełnić te wymagania wstępne:

  • Utwórz kopię zapasową wszystkich węzłów
    Przed aktualizacją zalecamy wykonanie pełnej kopii zapasowej wszystkich węzłów, aby zapewnić bezpieczeństwo . Wykonaj procedurę tworzenia kopii zapasowej dla bieżącej wersji Edge.

    Pozwala to utworzyć plan wykonywania kopii zapasowych na wypadek, gdyby aktualizacja do nowej wersji nie powiodła się. nie działają poprawnie. Więcej informacji o kopii zapasowej znajdziesz w artykule Kopia zapasowa i Przywróć.

  • Sprawdzanie, czy przeglądarka Edge działa
    Sprawdź, czy podczas procesu aktualizacji przeglądarka Edge jest uruchomiona. Aby to zrobić, użyj polecenia: 
    /opt/apigee/apigee-service/bin/apigee-all status
  • Upewnij się, że strategia kompilacji Cassandra jest LeveledCompactionStrategy
    Sprawdź, czy strategia zgodności Cassandra jest ustawiona na LeveledCompactionStrategy, jak opisano w Zmień Strategia kompresowania Cassandra.

Automatyczne propagacja ustawień usługi

Jeśli ustawiłeś jakieś właściwości, edytując pliki .properties w /opt/apigee/customer/application, to te wartości są zachowywane w ramach aktualizacji.

Wymagane uaktualnienie do wersji Zookeeper 3.8.3

Ta wersja Edge for Private Cloud zawiera aktualizację Zookeeper 3.8.3. W ramach wszystkie dane Zookeeper zostaną przeniesione do wersji 3.8.3.

Zanim uaktualnisz Zookeeper, przeczytaj Miłośnik zoo . Większość zewnętrznych systemów produkcyjnych wykorzystuje klaster węzłów Zookeeper między wieloma centrami danych. Niektóre z tych węzłów są skonfigurowane jako wyborcy uczestniczący w wyborach na lidera Zookeeper, a reszta jest skonfigurowana jako obserwator. Zobacz Więcej informacji o liderach, obserwatorach, wyborcach i obserwatorach. Węzły wyborców wybierają przywódcą, po czym węzły wyborcze stają się obserwatorami.

W trakcie procesu aktualizacji może wystąpić chwilowe opóźnienie lub błąd zapisu w Zookeeper. gdy węzeł lidera jest wyłączony. Może to wpłynąć na operacje zarządzania, które zapisują informacje w takie jak operacja wdrożenia serwera proxy czy zmiany w infrastrukturze Apigee; np. dodanie lub usunięcie podmiotu przetwarzającego wiadomości itp. Nie powinno to mieć wpływu na czas działania. Interfejsy API Apigee (chyba że te interfejsy API do zarządzania wywołaniami interfejsów API środowiska wykonawczego) podczas uaktualniania Zookeeper podczas postępując zgodnie z poniższą procedurą.

Ogólnie proces uaktualniania obejmuje utworzenie kopii zapasowej każdego węzła. To jest obserwowane przez uaktualnienie wszystkich obserwatorów i obserwatorów, a na koniec uaktualnienie węzła lidera.

Zrób kopię zapasową

Utwórz kopię zapasową wszystkich węzłów Zookeeper na wypadek, gdyby wymagane było przywrócenie poprzedniej wersji. Pamiętaj, że przywrócenie aplikacji Zookeeper do stanu z momentu wykonania kopii zapasowej. Uwaga: wszystkie wdrożenia lub zmian w infrastrukturze Apigee od czasu 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 odpowiednie możliwości, zrzuty lub kopie zapasowe maszyn wirtualnych mogą również można je przywrócić lub przywrócić (w razie potrzeby).

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

Uwaga: w poniższych przykładach poleceń narzędzie nc aby wysłać dane do Zookeeper. Możesz użyć za pomocą różnych narzędzi, aby wysyłać dane do witryny Zookeeper.

  1. Jeśli nie jest on zainstalowany w węźle ZooKeeper, zainstaluj nc: 
      sudo yum install nc
  2. Uruchom następujące polecenie nc w węźle, 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 wierszu Mode danych wyjściowych węzłów powinny być widoczne: „obserwator”, „wiodący” lub obserwator (czyli wyborca, który nie jest liderem) w zależności od konfiguracji węzła. Uwaga: w ramach samodzielnej instalacji Edge z jednym węzłem ZooKeeper 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 obserwatorów w następujący sposób:

  1. Pobierz i uruchom wczytywanie Edge dla Private Cloud 4.52 zgodnie z opisem w Aktualizacja do wersji 4.52.01 w węźle z zewnętrznym połączeniem internetowym. Proces ten będzie prawdopodobnie różnią się w zależności od tego, czy węzeł ma zewnętrzne połączenie z internetem, czy kiedy instalujesz offline.
  2. Ulepsz 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 uaktualnić teraz (np. w przypadku profilu cs,zk). Inne komponenty możesz też uaktualnić później. Apigee zaleca najpierw uaktualnienie aplikacji Zookeeper i upewnij się, że klaster działa prawidłowo .
  3. Powtórz powyższe kroki w każdym węźle obserwatora i obserwatora Zookeeper.

Wyłącz lidera

Po uaktualnieniu wszystkich węzłów obserwatora i obserwatorów wyłącz lidera. W węźle zidentyfikowane jako lider, uruchom poniższe 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łędów zapisu w Zookeeper. Może to wpłynąć na operacje zapisujące do Zookeeper na przykład wdrożenie serwerów proxy lub zmian w infrastrukturze Apigee, takich jak dodanie usunięcie podmiotów przetwarzających wiadomości itp.

Sprawdź, czy wybrano nowego lidera

Korzystając z instrukcji w sekcji Identyfikowanie lidera, obserwatorów powyżej sprawdź, czy został wybrany nowy lider obserwujących, gdy dotychczasowy lider zostanie zatrzymany. Lider mógł zostać wybrany w w innym centrum danych niż obecny lider.

Uaktualnij lidera

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

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

Przywróć

Jeśli wymagane jest przywrócenie danych:

  1. Najpierw wykonaj kroki wycofywania obejmujące obserwatorów i obserwatorów.
  2. Pobierz i wykonaj proces wczytywania wersji, do której przywracasz – 4.50 lub 4.51. Przebieg tego procesu będzie się różnić w zależności od tego, czy węzeł ma zewnętrzne połączenie internetowe lub śledzisz instalację offline.
  3. Zatrzymaj Zookeeper, jeśli działa w węźle: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
  4. Odinstaluj istniejącego 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 wycofaniu wszystkich obserwatorów i obserwatorów wycofaj zmiany w węźle wiodącym, wykonując następujące czynności: kroków 2–5 w węźle wiodącym.
  7. Po wycofaniu wszystkich węzłów sprawdź stan klastra i upewnij się, że węzłem wiodącym w klastrze.

Przywróć kopię zapasową

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

Wymagane uaktualnienie do Postgres 14

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

  • Jeśli uaktualniasz Edge for Private Cloud do wersji 4.51.00 do wersji 4.52.01, musisz wykonać dodatkowe kroki uaktualniania do Postgres. Jeśli uaktualniasz wersję 4.51.00 do 4.52.01, zapoznaj się z sekcją Wymagane uaktualnienie do Postgres 14.
  • Jeśli uaktualniasz Edge for Private Cloud do wersji 4.52.00 do wersji 4.52.01, nie musisz wykonywać żadnych dodatkowych czynności.

Uaktualnij Qpid

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

Zalecamy wybranie jednej z tych metod do uaktualnienia Qpid:

Uaktualnienie w miejscu pracy z zerowym czasem przestoju

Ta metoda zapewnia brak przestojów w środowisku wykonawczym Edge i minimalizuje utraty danych w czasie działania pozyskanych do celów analitycznych.

Aby przeprowadzić lokalne uaktualnienie do Qpid bez przestojów:

  1. Wybierz 1 węzeł Qpid, od którego chcesz zacząć.
  2. Zatrzymaj brokera Qpid w węźle: 
    apigee-service apigee-qpidd stop
  3. Blokuj ruch przychodzący na porcie 5672 dla wszystkich procesorów wiadomości przez zastosowanie zapory sieciowej. Możesz zastosować tę zaporę sieciową na poziomie instancji węzła Qpid lub innego zewnętrzny komponent zapory sieciowej/sieci.

    Zalecamy wykonanie tego samego kroku w przypadku wszystkich adresów IP procesorów wiadomości. Na przykład żądania DROP wysyłane z adresów IP procesora wiadomości do węzła Qpid na porcie 5672 przy użyciu tabel IPTables, możesz użyć następującego 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 takie są): 
    apigee-service apigee-qpidd start
  5. Sprawdź, czy istniejące kolejki są puste: 
    qpid-stat -q

    Jeśli wiadomości utkną w kolejce niedostarczonych wiadomości (DLQ) (ax-q-axgroup-001-consumer-group-001-dl), opróżnij ją kolejki, wykonując czynności do rozwiązywania problemów z utknięciem w kolejce niedostarczonych komunikatów.

  6. Po sprawdzeniu, czy kolejki w starym węźle zostały opróżnione, zatrzymaj instancję 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 te same czynności związane z usunięciem wszystkich adresów IP procesorów wiadomości, do których została zastosowana zapora sieciowa. Po usunięciu zapór sieciowych żądania pochodzące z adresów IP procesorów wiadomości do węzeł Qpid na porcie 5672 zostanie zaakceptowany. Jeśli do dodania zapory sieciowej użyto iptables, w usuń zaporę sieciową i wyświetl istniejące ustawienia, używając poleceń takich jak:

    iptables -F
  iptables -L
  10. Użyj monitorowania sieci, aby sprawdzić, czy kolejki Qpid otrzymują komunikaty: 
    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 na nowego węzła.

  1. Dodaj nowy węzeł Qpid. W tym kroku skonfigurujesz węzeł Qpid z J-brokerem. Szczegółowe instrukcje znajdziesz Więcej informacji znajdziesz w artykule Dodawanie serwera Qpid.
  2. Wybierz istniejący węzeł Qpid (węzeł z wersji, z której uaktualniasz).
  3. Zatrzymaj brokera Qpid w węźle: 
    apigee-service apigee-qpidd stop
  4. Blokuj ruch przychodzący na porcie 5672 dla wszystkich procesorów wiadomości przez zastosowanie zapory sieciowej. Możesz zastosować tę zaporę sieciową na poziomie instancji węzła Qpid lub innego zewnętrzny komponent zapory sieciowej/sieci.

    Zalecamy wykonanie tego samego kroku w przypadku wszystkich adresów IP procesorów wiadomości. Na przykład żądania DROP wysyłane z adresów IP procesora wiadomości do węzła Qpid na porcie 5672 przy użyciu tabel IPTables, możesz użyć następującego polecenia:

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

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

  7. Po sprawdzeniu, czy kolejki w starym węźle zostały opróżnione, zatrzymaj usługę apigee-qpidd 
    apigee-service apigee-qpidd stop
  8. Wyrejestruj stary węzeł Qpid, wykonując czynności opisane w sekcji Usuwanie serwera Qpid
  9. Kontynuuj dodawanie nowego węzła i usuwanie starego węzła, aż zostaną usunięte wszystkie węzły Qpid zostały uaktualnione.

Przywróć

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

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

  1. Zatrzymaj istniejącego brokera Qpid 
    apigee-service apigee-qpidd stop
  2. Blokuj ruch przychodzący na porcie 5672 dla wszystkich procesorów wiadomości przez zastosowanie zapory sieciowej. Możesz zastosować tę zaporę sieciową na poziomie instancji węzła Qpid lub innego zewnętrzny komponent zapory sieciowej/sieci.

    Zalecamy wykonanie tego samego kroku w przypadku wszystkich adresów IP procesorów wiadomości. Na przykład żądania DROP wysyłane z adresów IP procesora wiadomości do węzła Qpid na porcie 5672 przy użyciu tabel IPTables, możesz użyć następującego 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. Sprawdź, czy istniejące kolejki są puste. Aby to sprawdzić, zaloguj się do Qpid portal zarządzania: 
    http://QPID_NODE_IP:8090
     Uwaga: jeśli ten port 8090 w węźle QPID jest niedostępny, możesz uzyskać dostęp do tego adresu URL za pomocą mechanizmów alternatywnych, takich jak przekierowanie portów SSH.
  5. Po sprawdzeniu, czy kolejki są 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 wymień wszystkie istniejące ustawienia za pomocą tych poleceń: 
    iptables -F
     
    iptables -L

Nowy interfejs Edge

W tej sekcji znajdziesz informacje na temat interfejsu Edge. Więcej informacji: Nowy interfejs Edge dla Private Cloud.

Instalowanie interfejsu Edge

Po zakończeniu wstępnej instalacji Apigee zaleca zainstalowanie interfejsu 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 IDP, na przykład SAML lub LDAP.

Więcej informacji znajdziesz w artykule Instalowanie nowego interfejsu Edge.

Aktualizowanie interfejsu Edge

Aby zaktualizować komponent interfejsu Edge dla Twojej chmury, wybierz wersję Edge dla Twojej chmury prywatnej są uaktualniane z wersji:

Zaktualizuj przy użyciu Apigee mTLS

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

Wycofywanie aktualizacji

W przypadku niepowodzenia aktualizacji możesz spróbować rozwiązać problem, a następnie wykonać aktualizację. update.sh. Możesz uruchomić aktualizację kilka razy i kontynuować aktualizację od tego samego miejsca.

Jeśli błąd wymaga przywrócenia poprzedniej wersji, zapoznaj się z artykułem Aby zapoznać się ze szczegółowymi instrukcjami, przywróć poprzednią wersję 4.52.00.

Informacje o aktualizacji logów

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 ten katalog zapisze w katalogu /tmp dziennik w postaci pliku o nazwie update_username.log

Jeśli użytkownik nie ma dostępu do konta /tmp, narzędzie update.sh niepowodzenie.

Aktualizacja z zerowym czasem przestoju

Dzięki aktualizacji bez przestojów (czyli aktualizacji kroczącej) możesz zaktualizować instalację Edge bez Zmniejszając do siebie Edge.

Aktualizacja z zerowym czasem przestoju jest możliwa tylko w przypadku konfiguracji z 5 węzłami lub większą.

Kluczem do uaktualnienia bez przestojów jest usunięcie z obciążenia każdego routera pojedynczo. systemu równoważenia obciążenia. Następnie zaktualizujesz router i wszystkie inne komponenty na tym samym komputerze, co router, a potem z powrotem dodaj router do systemu równoważenia obciążenia.

  1. Aktualizuj komputery w odpowiedniej kolejności zgodnie z opisem. Kolejność aktualizacji maszyny.
  2. Gdy przyjdzie czas na aktualizację routerów, wybierz dowolny z nich i ustaw go jako nieosiągalny, opisane w sekcji Włączanie/wyłączanie serwera Osiągalność (procesora wiadomości/routera).
  3. Zaktualizuj wybrany router i wszystkie pozostałe komponenty Edge na tym samym komputerze, na którym znajduje się router. We wszystkich konfiguracjach brzegowych router i procesor wiadomości znajdują się w tym samym węźle.
  4. Ustaw router ponownie jako osiągalny.
  5. Powtórz kroki od 2 do 4 dla pozostałych routerów.
  6. Kontynuuj aktualizację na wszystkich pozostałych komputerach w instalacji.

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

Używanie cichego pliku konfiguracji

Do polecenia aktualizacji musisz przekazać dyskretny plik konfiguracji. Plik konfiguracji cichej (powinien to być ta sama, która była używana do instalacji Edge w wersji 4.50.00 lub 4.51.00).

Zaktualizuj do 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 dostępny, wyłącz wszystkie zadania cron skonfigurowane pod kątem wykonywania operacji naprawy Cassandra do momentu zakończenia aktualizacji.
  2. Zaloguj się do węzła jako root, aby zainstalować 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ędzie Edge apigee-setup.
  5. Jeśli instalujesz Oracle 7.x, wykonaj to polecenie: 
    sudo yum-config-manager --enable ol7_optional_latest
  6. Jeśli instalujesz w AWS, wykonaj to polecenie 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 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 i zależności w Edge 4.52.01 apigee-service przez 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 pomiń pWord, pojawi się prośba o jego podanie.

      Domyślnie instalator sprawdza, czy zainstalowano środowisko Java 1.8. Jeśli tego nie zrobisz, tag i instaluje ją.

      Użyj opcji JAVA_FIX, aby określić sposób obsługi Instalacja Javy. Funkcja JAVA_FIX przyjmuje następujące wartości:

      • I: zainstaluj OpenJDK 1.8 (domyślnie).
      • C: kontynuuj bez instalowania Javy.
      • Q: zakończ. Aby skorzystać z tej opcji, musisz samodzielnie zainstalować Javę.
    3. Użyj narzędzia apigee-service, aby zaktualizować narzędzie apigee-setup, ponieważ następujący przykład: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    4. Zaktualizuj narzędzie apigee-validate na serwerze zarządzania w następujący sposób przykład pokazuje: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    5. Zaktualizuj narzędzie apigee-provision na serwerze zarządzania w następujący sposób przykład pokazuje: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
    6. Uruchom w 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ść maszyn .

      Gdzie:

      • component to komponent Edge, który ma zostać zaktualizowany. Możliwe wartości:
        • cs: Cassandra
        • edge: wszystkie komponenty brzegowe oprócz interfejsu Edge UI: serwer zarządzania, wiadomość Procesor, router, serwer QPID, serwer Postgres
        • ldap: OpenLDAP
        • ps: postgresql
        • qpid: qpidd
        • sso: logowanie jednokrotne w Apigee (jeśli zostało zainstalowane logowanie jednokrotne)
        • ue: nowy interfejs Edge
        • ui: klasyczny interfejs Edge
        • zk: strażnik zoo
      • configFile to ten sam plik konfiguracji co poprzednio Zdefiniuj swoje urządzenie Edge podczas instalacji wersji 4.50.00 lub 4.51.00.

      Możesz uruchomić update.sh w odniesieniu do wszystkich komponentów przy użyciu ustawienia 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 na wszystkich węzłach, w których go działa: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    8. Przetestuj aktualizację, uruchamiając narzędzie apigee-validate w Zarządzaniu serwera zgodnie z opisem w sekcji Testowanie instalacji.

Jeśli później zdecydujesz się wycofać aktualizację, wykonaj procedurę opisaną w Przywróć poprzednią wersję 4.52.01.

Aktualizacja do wersji 4.52.01 z lokalnego repozytorium

Jeśli węzły brzegowe są za zaporą sieciową lub z innego powodu nie mają dostępu z repozytorium Apigee przez internet, możesz przeprowadzić aktualizację z repozytorium lokalnego lub powielanie repozytorium Apigee.

Po utworzeniu lokalnego repozytorium Edge masz 2 opcje aktualizowania Edge z poziomu lokalne 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, z którego możesz korzystać. Możesz też skorzystać z własnego serwera WWW.

Aby zaktualizować dane z lokalnego repozytorium 4.52.01:

  1. Utwórz lokalne repozytorium 4.52.01 zgodnie z opisem w sekcji „Tworzenie lokalnego repozytorium Apigee” o Zainstaluj narzędzie Edge apigee-setup.
  2. Aby zainstalować usługę apigee z pliku .tar:
    1. W węźle z lokalnym repozytorium użyj tego polecenia, aby spakować lokalne repozytorium do jednego 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. Na przykład skopiuj go do katalogu /tmp w nowym węźle.
    3. W nowym węźle wypakuj plik do katalogu /tmp: 
      tar -xzf apigee-4.52.01.tar.gz

      To polecenie utworzy w katalogu nowy katalog o nazwie repos zawierający plik .tar. na przykład /tmp/repos.

    4. Zainstaluj narzędzie Edge apigee-service i zależności z /tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.52.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

  3. Aby zainstalować usługę apigee za pomocą serwera WWW Nginx:
    1. Skonfiguruj serwer WWW Nginx zgodnie z opisem w sekcji „Instalowanie z repozytorium przy użyciu interfejsu Nginx” webserver&quot; na stronie Install the Edge apigee-setup.
    2. W 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 repozytorium, a remoteRepo to adres IP lub nazwa DNS węzła repozytorium.

    3. Na 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 narzędzia apigee-service, aby zaktualizować narzędzie apigee-setup, ponieważ następujący przykład: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. Zaktualizuj narzędzie apigee-validate na serwerze zarządzania w następujący sposób przykład pokazuje: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. Zaktualizuj narzędzie apigee-provision na serwerze zarządzania w następujący sposób przykład pokazuje: 
    /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, który ma zostać zaktualizowany. Zazwyczaj aktualizujesz następujące komponenty:
      • cs: Cassandra
      • edge: wszystkie komponenty brzegowe z wyjątkiem interfejsu Edge UI: serwer zarządzania, procesor wiadomości, router, Serwer QPID, serwer Postgres
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: logowanie jednokrotne w Apigee (jeśli zostało zainstalowane logowanie jednokrotne)
      • ue – nowy interfejs Edge
      • ui: klasyczny interfejs Edge
      • zk: strażnik zoo
    • configFile to ten sam plik konfiguracji co poprzednio definiowanie komponentów Edge podczas instalacji wersji 4.50.00 lub 4.51.00.

    Możesz uruchomić update.sh w odniesieniu do wszystkich komponentów przy użyciu ustawienia 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. Uruchom ponownie komponenty interfejsu we wszystkich węzłach, w których działa ten interfejs, chyba że zostało to już zrobione: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. Przetestuj aktualizację, uruchamiając narzędzie apigee-validate w Zarządzaniu serwera zgodnie z opisem w sekcji Testowanie instalacji.

Jeśli później zdecydujesz się wycofać aktualizację, wykonaj procedurę opisaną w Przywróć poprzednią wersję 4.52.01.

Kolejność aktualizacji maszyny

Kolejność aktualizowania komputerów podczas instalacji Edge jest ważna:

  • Musisz zaktualizować wszystkie węzły Cassandra i ZooKeeper przed w innych węzłach.
  • W przypadku każdego komputera z wieloma składnikami brzegowymi (serwer zarządzania, procesor wiadomości, routera, serwer QPID, ale nie serwer Postgres), do aktualizacji użyj opcji -c edge. jednocześnie.
  • Jeśli określony krok określa, że powinien być wykonany na wielu maszynach, wykonaj go w określonej kolejności maszyn.
  • Nie ma osobnego kroku, jak to zrobić. Jest ona aktualizowana, gdy podasz Opcja: -c edge.
.

Samodzielne przejście na 1 węzeł

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 aplikację apigee-adminapi) Zaktualizowano narzędzie apigee-adminapi: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

Samodzielne przejście na 2 węzły

Aby przeprowadzić samodzielną instalację z 2 węzłami, zaktualizuj te komponenty:

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

  1. Zaktualizuj Cassandra i ZooKeeper na komputerze 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Zaktualizuj Postgres na komputerze 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Aktualizacja LDAP na komputerze 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Zaktualizuj komponenty Edge na maszynie 2 i 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. Aktualizacja Qpid na maszynie 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Zaktualizuj interfejs użytkownika na komputerze 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 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 zainstalowano SSO.

  9. Ponownie uruchom komponent interfejsu Edge na komputerze 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Aktualizacja 5-węzłów

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

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

  1. Zaktualizuj Cassandra i ZooKeeper na komputerze 1, 2 i 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Zaktualizuj Postgres na komputerze 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Zaktualizuj Postgres na komputerze 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Aktualizacja LDAP na komputerze 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Zaktualizuj komponenty Edge na maszynie 4, 5, 1, 2, 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Zaktualizuj Qpid na komputerze 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Zaktualizuj Qpid na komputerze 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 interfejs ui na maszynie 1, jak w przykładzie poniżej: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    • Nowy interfejs Edge: jeśli masz zainstalowany nowy interfejs Edge, zaktualizuj ue na odpowiedniej maszynie (nie musi to być komputer 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 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 zainstalowano SSO.

  11. Ponownie uruchom komponent interfejsu:
    • Klasyczny interfejs: jeśli korzystasz z klasycznego interfejsu użytkownika, uruchom ponownie edge-ui na maszynie 1, jak w przykładzie poniżej: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Nowy interfejs Edge: jeśli masz zainstalowany nowy interfejs Edge, uruchom ponownie edge-management-ui na odpowiedniej maszynie (może to nie być komputer) 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Uaktualnianie klastra z 9 węzłami

W przypadku klastrowanej instalacji z 9 węzłami zaktualizuj te komponenty:

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

  1. Zaktualizuj Cassandra i ZooKeeper na komputerze 1, 2 i 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Zaktualizuj Postgres na komputerze 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Zaktualizuj Postgres na komputerze 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Aktualizacja LDAP na komputerze 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Zaktualizuj komponenty Edge na 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. Aktualizacja Qpid na komputerach 6 i 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Zaktualizuj nowy (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 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 zainstalowano SSO.

  10. Ponownie uruchom komponent interfejsu:
    • Klasyczny interfejs: jeśli korzystasz z klasycznego interfejsu użytkownika, uruchom ponownie edge-ui na maszynie 1, jak w przykładzie poniżej: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Nowy interfejs Edge: jeśli masz zainstalowany nowy interfejs Edge, uruchom ponownie edge-management-ui na odpowiedniej maszynie (może to nie być komputer) 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Uaktualnianie klastra z 13 węzłami

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

Listę topologii Edge i numerów węzłów znajdziesz w artykule 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 na komputerze 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Zaktualizuj Postgres na komputerze 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Aktualizacja 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. Aktualizacja Qpid na komputerach 12 i 13: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Zaktualizuj nowy (ue) lub klasyczny interfejs użytkownika (ui) na komputerach 6 oraz 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 masz zainstalowane logowanie jednokrotne 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 zainstalowano SSO.

  10. Ponownie uruchom komponent interfejsu:
    • Klasyczny interfejs: jeśli korzystasz z klasycznego interfejsu użytkownika, uruchom ponownie edge-ui na maszynach 6 i 7, jak 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 maszynach 6 i 7: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Uaktualnianie klastra z 12 węzłami

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

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

  1. Zaktualizuj Cassandra i ZooKeeper:
    1. Na komputerach 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. Aktualizacja 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. Aktualizacja pliku qpidd:
    1. Maszyny 4, 5 w centrum danych 1
      1. Aktualizacja urządzenia qpidd na komputerze 4: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Aktualizacja urządzenia qpidd na komputerze 5: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. Maszyny 10, 11 w centrum danych 2
      1. Aktualizacja qpidd na komputerze 10: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Aktualizacja qpidd na komputerze 11: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Zaktualizuj nowy (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 zainstalowano aplikację 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 logowanie jednokrotne 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 zainstalowano SSO.

  9. Uruchom ponownie nowy interfejs Edge (edge-management-ui) lub klasyczny interfejs Edge (edge-ui) na maszynach 1 i 7: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

W przypadku konfiguracji niestandardowej

Jeśli masz niestandardową konfigurację, zaktualizuj komponenty Edge w następujący sposób zamówienie:

  1. ZooKeeper
  2. Cassandra
  3. ps
  4. LDAP
  5. Edge, czyli „-c Edge”. we 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 uruchomionych komputerach .