Zaktualizuj Apigee Edge w wersji 4.51.00, 4.52.00 lub 4.52.01 do wersji 4.52.02

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

Kto może przeprowadzić aktualizację

Osobą uruchamiającą aktualizację powinna być ta sama osoba, która pierwotnie zainstalowała Edge lub użytkownik z uprawnieniami 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, która zawiera komponenty pochodzące z różnych wersji.

Zaktualizuj wymagania wstępne

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

  • Utwórz kopie zapasowe wszystkich węzłów
    Ze względów bezpieczeństwa przed aktualizacją zalecamy wykonanie pełnej kopii zapasowej wszystkich węzłów. 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 działała prawidłowo. Więcej informacji o kopii zapasowej znajdziesz w artykule Tworzenie i przywracanie kopii zapasowej.

  • Sprawdzanie, czy przeglądarka Edge jest uruchomiona
    Sprawdź, czy podczas procesu aktualizacji przeglądarka Edge jest uruchomiona, korzystając z polecenia: 
    /opt/apigee/apigee-service/bin/apigee-all status
  • Upewnij się, że strategia kompresowania Cassandra jest ustawiona na LeveledCompactionStrategy
    Upewnij się, że strategia kompresowania Cassandra jest ustawiona na LeveledCompactionStrategy, zgodnie z opisem w sekcji Zmiana strategii kompresowania Cassandra.

Szczególne kroki, które warto wziąć pod uwagę przed uaktualnieniem

Aby przejść na Edge for Private Cloud 4.52.02, rozważ wykonanie określonych kroków w celu uaktualnienia określonego oprogramowania. Wymagane kroki zależą od używanej wersji. W tabeli poniżej znajdziesz różne programy, które wymagają dodatkowych czynności. W dalszych sekcjach tej strony znajdziesz szczegółowe omówienie i szczegółowe instrukcje dotyczące każdego oprogramowania.

Obecna wersja Oprogramowanie, które wymaga specjalnych kroków w celu aktualizacji do wersji 4.52.02
4.52.01 Cassandra
4.52.00 Cassandra, Zookeeper, Qpid
4.51.00 Cassandra, Zookeeper, Qpid, Postgres

Automatyczne propagacja ustawień usługi

Jeśli ustawisz jakieś właściwości, edytując pliki .properties w narzędziu /opt/apigee/customer/application, wartości te zostaną zachowane w ramach aktualizacji.

Wymagane uaktualnienie do wersji Cassandra 3.11.16

Apigee Edge dla Private Cloud 4.52.02 obejmuje uaktualnienie systemu Cassandra do wersji 3.11.16. Cassandra jest kluczowym komponentem Apigee, a uaktualnienie obejmuje również aktualizacje oprogramowania sterownika w różnych środowiskach wykonawczych i komponentach zarządzania, które są używane do wysyłania zapytań i zapisywania w systemie Cassandra.

Ponieważ jest to duża aktualizacja, konieczne były pewne zmiany w modelu danych Apigee w Cassandra, aby zapewnić optymalną wydajność nowszych wersji. Chociaż te zmiany są minimalne, proces uaktualniania zakłóca działanie niektórych interfejsów API do zarządzania, wpływając zarówno na interfejs Apigee, jak i portal dla programistów. W poniższym dokumencie określono konkretne interfejsy API, które nie będą działać, oraz przedstawia czynności wykonywane podczas uaktualniania po rozpoczęciu i zakończeniu przerwy w działaniu. Co ważne, w trakcie uaktualniania ruch w środowisku wykonawczym nie powinien być zakłócony.

Przywracanie wysokiego poziomu

Stosuj uaktualnienia Cassandra tylko jeden węzeł naraz. Natychmiast po zaktualizowaniu węzła zaczynają obowiązywać pewne zmiany schematu, których nie można bezpośrednio wycofać. Dokładnie przeczytaj sekcję dotyczącą przywracania poprzedniej wersji, ponieważ w zależności od tego, jak duża część klastra została uaktualniona, mogą być używane różne metody.

Jeśli chcesz wycofać uaktualnienie po uaktualnieniu całego klastra Cassandra, jedyną opcją jest przywrócenie kopii zapasowych. Przygotuj się do tego i zapoznaj się z przywracaniem kopii zapasowych Cassandra. Jeśli możesz przywracać zrzuty na poziomie maszyny wirtualnej szybciej niż kopie zapasowe Apigee, użyj zrzutów maszyny wirtualnej, aby przywrócić maszyny wirtualne Cassandra do wcześniejszego stanu.

Więcej informacji znajdziesz w sekcji Przywracanie aktualizacji systemu Cassandra 3.11.16.

Dokumentacja interfejsów API w portalu dla programistów

Portal dla deweloperów Apigee Drupal oferuje różne funkcje umożliwiające dokumentowanie interfejsów API. Zalecamy rezygnację z portalu dla deweloperów opartego na Drupal 7, ale jeśli nadal go używasz i korzystasz z jego funkcji SmartDocuments, zapoznaj się z artykułem Korzystanie z interfejsów API SmartDocuments. Jeśli korzystasz z nowszej wersji portalu dla deweloperów, to uaktualnienie nie wpłynie na dokumentację interfejsu API.

Po uaktualnieniu Apigee do wersji 4.52.02 żadne modele API utworzone przy użyciu funkcji SmartDocuments w portalu dla deweloperów Drupal 7 nie zostaną automatycznie przeniesione do nowszej wersji. Każdy model musisz wyeksportować ręcznie w portalu dla deweloperów i zaimportować go ponownie po zakończeniu uaktualniania.

Terminologia używana w poniższych sekcjach

Środowisko wykonawcze: środowisko wykonawcze obejmuje obsługę ruchu przez serwer proxy środowiska wykonawczego. Obejmuje wszystkie operacje wykonywane przez routery i procesory wiadomości w celu skutecznego przetwarzania żądań interfejsu API środowiska wykonawczego do istniejących serwerów proxy. Nie obejmuje to jednak wdrażania nowych serwerów proxy ani nowych wersji serwerów proxy.

Zarządzanie: zarządzanie obejmuje administrowanie systemem Apigee Edge. Dotyczy to m.in. wdrożeń i modyfikacji aplikacji, usług, serwerów docelowych czy magazynów kluczy. Zakres ten obejmuje wszystkie interfejsy API do zarządzania (oraz ich klienty, takie jak interfejs Apigee UI i portal dla programistów).

W poniższych krokach stan środowiska wykonawczego i zarządzania jest opisany w miarę postępów przez kolejne etapy procedury uaktualniania. Pamiętaj, że uaktualnienie nie ma wpływu na ruch w czasie działania. Pojawiły się jednak zakłócenia w działaniu niewielkiej części interfejsów API do zarządzania i funkcjonalności portalu dla deweloperów.

Krok 0. Stan początkowy

  1. Cassandra w Apigee uruchomionym w wersji 2.1.22.
  2. Komponenty Edge dla Private Cloud 4.52.02:
    • Serwer zarządzania komunikujący się z Cassandra za pomocą starszego protokołu Thrift.
    • Serwery środowiska wykonawczego (procesory komunikatów i routery) komunikujące się z Cassandra za pomocą starszego protokołu Thrift.
Stan środowiska wykonawczego na tym etapie Stan zarządzania na tym etapie
Środowisko wykonawcze jest w pełni funkcjonalne W pełni funkcjonalne zarządzanie

Krok 1. Przygotuj się do uaktualnienia

Poniższe czynności są uzupełnieniem standardowych plików, które zwykle tworzysz, takich jak standardowy plik konfiguracji Apigee umożliwiający uaktualnianie komponentów.

  1. Zmień Cassandra na LeveledCompactionStrategy.
  2. Utwórz kopię zapasową danych Cassandra przy użyciu Apigee.
  3. Jeśli to możliwe, wykonaj zrzuty maszyn wirtualnych węzłów Cassandra.
  4. Utwórz plik konfiguracji uaktualnienia Cassandra w każdym węźle Cassandra w /opt/apigee/apigee-cassandra/cass_upgrade.conf z następującą treścią: 
    # IP Address of node
HOSTIP=10.0.0.1

# Username for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_USERNAME=<cassuser>

# Password for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_PASSWORD=<casspass>

# Port for connecting to Cassandra via thrift. Optional. Defaults to 9160 if skipped.
CASS_PORT=9160

# Port for connecting to Cassandra via CQL. Optional. Defaults to 9042 if skipped.
CASS_CQL_PORT=9042

# Directory to be used by Cassandra upgrade scripts. Optional. Defaults to /tmp/cass_upgrade_scripts if skipped.
# Note that if upgrade is successful, this directory is deleted via root user - so provide a directory accordingly.
CASS_TMP_DIR=/tmp/cass_upgrade_scripts
    Jeśli nie można utworzyć pliku w /opt/apigee/apigee-cassandra/cass_upgrade.conf, utwórz plik /opt/silent.conf z tą samą zawartością w każdym węźle Cassandra.
  • Jeśli korzystasz z funkcji SmartDocuments w portalu dla deweloperów Apigee Drupal 7, wyeksportuj każdy ze swoich modeli, pobierając je w formacie JSON z interfejsu portalu dla programistów. Po zaktualizowaniu serwerów zarządzania musisz zaimportować te modele z powrotem do Apigee.
  • Sprawdź, czy porty 9160 i 9042 są dostępne ze wszystkich komponentów Edge for Private Cloud 4.52.02 do węzłów Cassandra, jeśli jeszcze ich nie ma. Więcej informacji znajdziesz w wymaganiach dotyczących portów.

Krok 2. Uaktualnij wszystkie węzły Cassandra

  1. Uaktualnij pojedynczo wszystkie węzły Cassandra we wszystkich regionach. Uruchom te polecenia w każdym węźle: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. Po zaktualizowaniu węzła uruchom w nim to polecenie, aby przeprowadzić w nim kilka weryfikacji, zanim przejdziesz dalej: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
  3. Powyższy kod zwróci coś w następujący sposób: 
    Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified
Stan środowiska wykonawczego na tym etapie Stan zarządzania na tym etapie
Środowisko wykonawcze jest w pełni funkcjonalne Po uaktualnieniu systemu Cassandra ta funkcja zarządzania ulegnie pogorszeniu:

Krok 3. Uaktualnij wszystkie węzły zarządzania

Uaktualnij pojedynczo wszystkie węzły zarządzania we wszystkich regionach:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Stan środowiska wykonawczego Stan zarządzania
Środowisko wykonawcze jest w pełni funkcjonalne Interfejs API zarządzania uległ pogorszeniu:

Krok 3a. [Opcjonalnie] Zaimportuj wcześniej wyeksportowane pliki Dokumentów Smart.

Po uaktualnieniu wszystkich serwerów zarządzania możesz zaimportować modele SmartDocuments wyeksportowane w kroku 1. Możesz to zrobić również później.

Stan środowiska wykonawczego Stan zarządzania
Środowisko wykonawcze jest w pełni funkcjonalne W pełni funkcjonalne zarządzanie

Krok 4. Uaktualnij wszystkie węzły środowiska wykonawczego

Uaktualnij po kolei wszystkie routery i węzły procesora wiadomości we wszystkich regionach:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Stan środowiska wykonawczego Stan zarządzania
Środowisko wykonawcze jest w pełni funkcjonalne W pełni funkcjonalne zarządzanie

Krok 5. Uaktualnij wszystkie pozostałe komponenty Edge dla Private Cloud w wersji 4.52.02

Uaktualnij po kolei wszystkie pozostałe węzły edge-qpid-server i edge-postgres-server we wszystkich regionach.

Jeśli na tym etapie uaktualniasz wersję starszą niż Edge dla Private Cloud 4.52.01 i wykonujesz dodatkowe czynności związane z uaktualnianiem Qpid lub Postgres, postępuj zgodnie z odpowiednimi instrukcjami.

Stan środowiska wykonawczego Stan zarządzania
Środowisko wykonawcze jest w pełni funkcjonalne W pełni funkcjonalne zarządzanie

Krok 6. Po uaktualnieniu

Po zakończeniu uaktualniania uruchom po kolei to polecenie w każdym węźle Cassandra:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade

Uruchom poniższe polecenie, aby usunąć stare nieużywane tabele z klastra Cassandra. Do tego czasu nie będzie można korzystać z niektórych funkcji systemu Cassandra (takich jak konfigurowanie nowego uwierzytelniania – stare mechanizmy uwierzytelniania będą nadal działać). To polecenie można wykonać tylko na 1 węźle w klastrze:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile

Wykonaj krok 3a, jeśli jeszcze nie zostało to zrobione.

Stan środowiska wykonawczego Stan zarządzania
Środowisko wykonawcze jest w pełni funkcjonalne W pełni funkcjonalne zarządzanie

Wymagane uaktualnienie do wersji Zookeeper 3.8.3

Mimo że Edge for Private Cloud 4.52.02 nie obejmuje uaktualnienia do Zookeeper, jeśli przeprowadzasz uaktualnienie z wersji starszej niż 4.52.01, musisz wykonać te czynności, aby uaktualnić Zookeeper.

  • Jeśli aktualizujesz Edge dla chmury prywatnej w wersji 4.51.00 lub 4.52.00, zapoznaj się z instrukcjami w sekcji Wymagane uaktualnienie aplikacji Zookeeper 3.8.3 w celu uaktualnienia Zookeeper.
  • Jeśli uaktualniasz Edge for Private Cloud w wersji 4.52.01, musisz już korzystać z aplikacji Zookeeper w wersji 3.8.3 i nie musisz wykonywać żadnych specjalnych czynności w celu uaktualnienia Zookeeper.

Wymagane uaktualnienie do Postgres 14

  • Jeśli uaktualniasz Edge dla Private Cloud do wersji 4.51.00 do wersji 4.52.02, musisz wykonać te czynności, aby uaktualnić Postgres, mimo że Edge dla Private Cloud 4.52.02 nie obejmuje uaktualnienia Postgres. Uaktualnienie z Edge for Private Cloud do wersji 4.51.00 do wersji 4.52.02 wymaga dodatkowych czynności uaktualniania Postgres. Zapoznaj się z sekcją Wymagane uaktualnienie do Postgres 14.
  • Jeśli uaktualniasz Edge dla Private Cloud w wersji 4.52.00 lub 4.52.01 do wersji 4.52.02, nie są wymagane żadne dodatkowe czynności związane z przejściem na Postgres.

Wymagane uaktualnienie do Qpid J-Broker

Mimo że Edge for Private Cloud 4.52.02 nie zawiera uaktualnienia do QPID, jeśli przeprowadzasz uaktualnienie z wersji starszej niż 4.52.01, musisz wykonać te czynności, aby uaktualnić QPID.

  • Jeśli uaktualniasz Edge for Private Cloud do wersji 4.51.00 lub 4.52.00 do wersji 4.52.02, musisz wykonać dodatkowe kroki uaktualniania QPID. Jeśli uaktualniasz wersję 4.51.00 lub 4.52.00 do 4.52.02, zapoznaj się z sekcją Uaktualnienie Qpid.
  • Jeśli uaktualniasz Edge dla Private Cloud do wersji 4.52.01 do wersji 4.52.02, prawdopodobnie korzystasz już z najnowszej wersji Qpid Broker i nie musisz wykonywać żadnych dodatkowych czynności.

Nowy interfejs Edge

W tej sekcji znajdziesz informacje na temat interfejsu Edge. Więcej informacji znajdziesz w nowym interfejsie Edge dla Private Cloud.

Instalowanie interfejsu Edge

Po zakończeniu wstępnej instalacji Apigee zaleca zainstalowanie interfejsu Edge, który jest ulepszonym interfejsem użytkownika 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 artykule Instalowanie nowego interfejsu Edge.

Aktualizowanie interfejsu Edge

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

Zaktualizuj przy użyciu Apigee mTLS

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

Wycofywanie aktualizacji

W przypadku niepowodzenia aktualizacji możesz spróbować rozwiązać problem, a następnie ponownie wykonać polecenie update.sh. Możesz uruchomić aktualizację kilka razy i kontynuować ją od miejsca, w którym została przerwana.

Jeśli błąd wymaga przywrócenia poprzedniej wersji, zapoznaj się ze szczegółowymi instrukcjami na temat przywracania wersji 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 tego katalogu, zapisuje dziennik w katalogu /tmp jako plik o nazwie update_username.log.

Jeśli użytkownik nie ma dostępu do usługi /tmp, narzędzie update.sh kończy się niepowodzeniem.

Aktualizacja z zerowym czasem przestoju

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

  1. Zaktualizuj maszyny w kolejności odpowiedniej dla danej instalacji, zgodnie z opisem Kolejność aktualizacji maszyny.
  2. Gdy przyjdzie czas na zaktualizowanie routerów, wybierz dowolny z nich i ustaw go jako nieosiągalny zgodnie z opisem w sekcji Włączanie/wyłączanie osiągalności serwera wiadomości i 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 być taki sam jak plik użyty do zainstalowania Edge w wersji 4.50.00 lub 4.51.00.

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

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

  1. Jeśli ta opcja jest dostępna, wyłącz wszystkie zadania cron skonfigurowane pod kątem wykonywania operacji naprawy na urządzeniu 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ędzia Edge apigee-setup.
  5. Jeśli instalujesz w Oracle 7.x, wykonaj to polecenie: 
    sudo yum-config-manager --enable ol7_optional_latest
  6. Jeśli instalujesz w AWS, wykonaj te polecenia yum-configure-manager: 
    yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

  7. Jeśli używasz Edge 4.51.00:

    1. Pobierz plik Edge bootstrap_4.52.02.sh na serwer /tmp/bootstrap_4.52.02.sh: 
      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
    2. Zainstaluj narzędzie i zależności w Edge w wersji 4.52.02 apigee-service, wykonując to polecenie: 
      sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

      Gdzie uName:pWord to nazwa użytkownika i hasło otrzymane z Apigee. Jeśli pominiesz pWord, pojawi się prośba o jego podanie.

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

      Użyj opcji JAVA_FIX, aby określić sposób obsługi instalacji 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 zgodnie z poniższym przykładem: 
      /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 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ść aktualizacji maszyny.

      Gdzie:

      • component to komponent Edge, który ma zostać zaktualizowany. Możliwe wartości:
        • 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, który był używany do definiowania 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 zasadę 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 się uruchamia: 
      /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ę, wykonaj procedurę opisaną w sekcji Wycofanie zmian 4.52.02.

Aktualizacja do wersji 4.52.02 z lokalnego repozytorium

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 Apigee (lub kopii lustrzanej).

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

  • Utwórz plik .tar repozytorium, skopiuj plik .tar 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ż użyć własnego serwera WWW.

Aby zaktualizować dane z lokalnego repozytorium 4.52.02:

  1. Utwórz lokalne repozytorium 4.52.02 zgodnie z opisem w sekcji „Tworzenie lokalnego repozytorium Apigee” w artykule Instalowanie narzędzia 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.02.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 wygeneruj plik z katalogu /tmp: 
      tar -xzf apigee-4.52.02.tar.gz

      Polecenie to utworzy nowy katalog o nazwie repos w katalogu zawierającym plik .tar. na przykład /tmp/repos.

    4. Zainstaluj narzędzie Edge apigee-service i zależności z witryny /tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.52.02.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 serwera WWW Nginx” w artykule Instalowanie narzędzia Edge apigee-setup.
    2. W węźle zdalnym pobierz plik Edge bootstrap_4.52.02.sh do /tmp/bootstrap_4.52.02.sh: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh

      Gdzie uName:pWord to nazwa użytkownika i hasło ustawione wcześniej dla repozytorium, a remoteRepo to adres IP lub nazwa DNS węzła repozytorium.

    3. Na węźle zdalnym zainstaluj narzędzie Edge apigee-setup i zależności: 
      sudo bash /tmp/bootstrap_4.52.02.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 zgodnie z poniższym przykładem: 
    /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, który ma zostać zaktualizowany. Zwykle aktualizujesz te 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, który był używany do definiowania 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 zasadę 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 na serwerze zarządzania zgodnie z opisem w sekcji Testowanie instalacji.

Jeśli później zdecydujesz się wycofać aktualizację, wykonaj procedurę opisaną w sekcji Wycofanie zmian 4.52.02.

Kolejność aktualizacji maszyny

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

  • Musisz zaktualizować wszystkie węzły Cassandra i ZooKeeper, zanim zaktualizujesz inne węzły.
  • W przypadku każdego komputera 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 maszynach, wykonaj go w podanej kolejności maszyn.
  • Nie ma osobnego kroku, jak to zrobić. Jest aktualizowana, gdy określisz opcję -c edge.

Samodzielne przejście na 1 węzeł

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

  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

Samodzielna licencja z 2 węzłami

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. Zaktualizuj 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. Zaktualizuj 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 instalacji logowania jednokrotnego.

  9. Ponownie uruchom komponent interfejsu Edge na maszynie 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. Zaktualizuj LDAP na komputerze 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Zaktualizuj komponenty Edge w 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 użytkownika, zaktualizuj komponent ui na komputerze 1 zgodnie z poniższym przykładem: 
      /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 odpowiedniej maszynie (może to nie 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 instalacji logowania jednokrotnego.

  11. Ponownie uruchom komponent interfejsu:
    • Klasyczny interfejs: jeśli używasz klasycznego interfejsu użytkownika, ponownie uruchom 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, ponownie uruchom komponent 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. Zaktualizuj 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. Zaktualizuj 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 instalacji logowania jednokrotnego.

  10. Ponownie uruchom komponent interfejsu:
    • Klasyczny interfejs: jeśli używasz klasycznego interfejsu użytkownika, ponownie uruchom 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, ponownie uruchom komponent 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. Zaktualizuj LDAP na komputerze 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 komputerach 12 i 13: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Zaktualizuj nowy interfejs (ue) lub klasyczny interfejs (ui) na maszynach 6 i 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (Jeśli zainstalowano apigee-adminapi) Zaktualizowano narzędzie apigee-adminapi na 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 instalacji logowania jednokrotnego.

  10. Ponownie uruchom komponent interfejsu:
    • Klasyczny interfejs: jeśli używasz klasycznego interfejsu użytkownika, ponownie uruchom komponent edge-ui na maszynach 6 i 7, zgodnie z poniższym przykładem: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Nowy interfejs Edge: jeśli masz zainstalowany nowy interfejs Edge, ponownie uruchom komponent edge-management-ui na komputerach 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. 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 plik qpidd:
    1. Maszyny 4, 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. 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 instalacji logowania jednokrotnego.

  9. Uruchom ponownie nowy interfejs Edge (edge-management-ui) lub klasyczny interfejs 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 niestandardową konfigurację, zaktualizuj komponenty Edge w następującej kolejności:

  1. ZooKeeper
  2. Cassandra
  3. ps
  4. LDAP
  5. Edge, czyli profil „-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. QPID
  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 maszynach, na których go uruchamia.