Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Aktualizacja Apigee Edge od 4.16.01 do 4.16.05

Edge dla chmury prywatnej w wersji 4.16.05

Które wersje Edge można zaktualizować do wersji 4.16.05

Wersję 4.16.01.x Apigee Edge możesz zaktualizować tylko do wersji 4.16.05.

Jeśli masz wersję Edge starszą niż 4.16.01.x, musisz najpierw przejść na wersję 4.16.01.x, a następnie zaktualizować ją do wersji 4.16.05.

Kto może przeprowadzić aktualizację

Użytkownik, który przeprowadza aktualizację, powinien być tym samym użytkownikiem, który pierwotnie zainstalował Edge, lub użytkownikiem z uprawnieniami administratora.

Po zainstalowaniu pakietów RPM Edge każdy użytkownik może je skonfigurować.

Wymagane uaktualnienie do wersji 8 pakietu Java JDK

Ta wersja Edge wymaga zainstalowania pakietu Java JDK w wersji 8 na wszystkich węzłach przetwarzania Edge. Możesz zainstalować Oracle JDK 8 lub OpenJDK 8. Jeśli nie masz jeszcze zainstalowanego środowiska Java JDK 8, skrypt aktualizacji może je zainstalować.

W ramach aktualizacji do Javy 8 niektóre mechanizmy szyfrowania TLS nie są już dostępne w Oracle JDK 8. Pełną listę znajdziesz w sekcji „Default Disabled Cipher Suites” (Domyślnie wyłączone zestawy szyfrów) na stronie http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.

Ostrzeżenie: ta wersja Edge nie obsługuje JDK 7. Jeśli obecnie używasz JDK 7, musisz przejść na JDK 8. Jeśli wycofasz instalację Edge 4.16.05, możesz opcjonalnie ponownie skonfigurować Edge, aby używać Java JDK 7.

Przenoszenie Zookeepera na niższą wersję

Wersja pakietu RPM ZooKeeper w Edge dla chmury prywatnej 4.16.01 to apigee-zookeeper-3.4.5-1.0.905.noarch.rpm. W kolejnych wersjach Edge wersja ZooKeepera została zmieniona z powrotem na apigee-zookeeper-3.4.5-0.0.948. Zapobiega to uaktualnianiu ZooKeepera przez yum do wersji nowszych niż 4.16.01. Aby rozwiązać ten problem, przed zaktualizowaniem ZooKeepera uruchom polecenie yum downgrade apigee-zookeeper.

Wersję ZooKeepera możesz sprawdzić za pomocą tego polecenia:

> rpm -qa |grep apigee-zookeeper

Jeśli to polecenie zwróci wersję Zookeeper:

apigee-zookeeper-3.4.5-1.0.905

Następnie musisz przejść na niższą wersję.

Wymagania dotyczące miejsca na dysku na potrzeby aktualizacji

Przed przeprowadzeniem aktualizacji upewnij się, że masz co najmniej 1 GB wolnego miejsca na dysku.

Automatyczne rozpowszechnianie ustawień usługi od wersji 4.16.01.x

Jeśli ustawiono jakieś właściwości przez edycję plików .properties w /opt/apigee/customer/application, te wartości zostaną zachowane podczas aktualizacji.

Aktualizowanie narzędzia apigee-validate

W wersji 4.16.01 narzędzie apigee-validate zostało zainstalowane i uruchomione w węźle procesora komunikatów. W wersji 4.16.05 narzędzie apigee-validate zostało zaktualizowane, aby działało w węźle Management Server.

Podczas aktualizacji do wersji 4.16.05 masz 2 możliwości aktualizacji narzędzia apigee-validate:

Zalecane przez Apigee – zainstaluj i uruchom narzędzie apigee-validate w węźle serwera zarządzania.

Możesz opcjonalnie odinstalować narzędzie apigee-validate z węzłów procesora komunikatów. Jeśli pozostawisz go w węźle procesora komunikatów, musisz go zaktualizować do wersji 4.16.05.
Możesz też zaktualizować narzędzie apigee-validate w węźle procesora komunikatów i uruchomić je z tego miejsca. Apigee zaleca jednak zainstalowanie i uruchomienie go z serwera zarządzania.

Wymagania wstępne dotyczące aktualizacji

Przed uaktualnieniem Apigee Edge spełnij te wymagania wstępne:

Utwórz kopię zapasową wszystkich węzłów
Przed aktualizacją zalecamy ze względów bezpieczeństwa utworzenie pełnej kopii zapasowej wszystkich węzłów. Aby wykonać kopię zapasową, postępuj zgodnie z procedurą dla bieżącej wersji Edge.

Dzięki temu będziesz mieć plan awaryjny na wypadek, gdyby aktualizacja do nowej wersji nie działała prawidłowo. Więcej informacji o kopiach zapasowych znajdziesz w artykule Tworzenie i przywracanie kopii zapasowej.
Sprawdź, czy Edge działa
Upewnij się, że Edge działa podczas procesu aktualizacji, używając polecenia:

> /<inst_root>/apigee/apigee-service/bin/apigee-all status

Postępowanie w przypadku nieudanej aktualizacji

Jeśli aktualizacja się nie powiedzie, możesz spróbować rozwiązać problem, a następnie ponownie uruchomić update.sh. Możesz uruchomić aktualizację wielokrotnie, a będzie ona kontynuowana od miejsca, w którym została przerwana.

Jeśli błąd wymaga przywrócenia poprzedniej wersji, więcej informacji znajdziesz w artykule Proces przywracania wersji 4.16.05.

Rejestrowanie informacji o aktualizacji

Domyślnie narzędzie update.sh zapisuje informacje dziennika w:

/opt/apigee/var/log/apigee-setup/update.log

Jeśli użytkownik, który uruchamia narzędzie update.sh, nie ma dostępu do tego katalogu, dziennik jest zapisywany w katalogu /tmp jako plik o nazwie update_nazwa_użytkownika.log.

Jeśli użytkownik nie ma dostępu do katalogu /tmp, narzędzie update.sh nie zadziała.

Aktualizacja bez przestojów

Aktualizacja bez przestojów, czyli aktualizacja krocząca, umożliwia aktualizację instalacji Edge bez wyłączania Edge.

Aktualizacja bez przestojów jest możliwa tylko w przypadku konfiguracji z co najmniej 5 węzłami.

Kluczem do uaktualnienia bez przestojów jest usuwanie z systemu równoważenia obciążenia po jednym routerze naraz. Następnie zaktualizuj router i inne komponenty na tej samej maszynie co router, a potem dodaj router z powrotem do systemu równoważenia obciążenia.

Zaktualizuj maszyny w odpowiedniej kolejności, zgodnie z opisem w sekcji „Kolejność aktualizacji maszyn” poniżej.
Gdy nadejdzie czas aktualizacji routerów, wybierz dowolny router i ustaw go jako nieosiągalny, jak opisano w artykule Włączanie i wyłączanie osiągalności serwera (procesora komunikatów lub routera).
Zaktualizuj wybrany router i wszystkie inne komponenty Edge na tym samym komputerze co router. Wszystkie konfiguracje Edge pokazują router i procesor komunikatów w tym samym węźle.
Spraw, aby router był ponownie dostępny.
Powtórz kroki od 2 do 4 w przypadku pozostałych routerów.
Kontynuuj aktualizację pozostałych maszyn w instalacji.

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

Na węźle połączonego routera i procesora komunikatów:
- Przed aktualizacją wykonaj te czynności:
  1. Ustaw router jako niedostępny.
  2. Spraw, aby procesor komunikatów był nieosiągalny.
- Po aktualizacji wykonaj te czynności:
  1. Udostępnij procesor komunikatów.
  2. Ustaw router jako dostępny.
Na pojedynczym węźle routera:
- Przed aktualizacją upewnij się, że router jest niedostępny.
- Po aktualizacji upewnij się, że router jest dostępny.
Na pojedynczym węźle procesora komunikatów:
- Przed aktualizacją ustaw procesor komunikatów jako nieosiągalny.
- Po aktualizacji udostępnij procesor komunikatów.

Używanie pliku konfiguracji instalacji dyskretnej

Do polecenia aktualizacji musisz przekazać plik konfiguracji instalacji dyskretnej. Plik konfiguracji instalacji dyskretnej powinien być taki sam jak ten, który został użyty do zainstalowania Edge 4.16.01.

Procedura aktualizacji do wersji 4.16.05 na węźle z zewnętrznym połączeniem internetowym

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

Jeśli istnieją zadania CRON skonfigurowane do wykonywania operacji naprawy w Cassandra, wyłącz je do czasu zakończenia aktualizacji.
Zaloguj się w węźle jako użytkownik root, aby zainstalować pakiety RPM Edge.
Uwaga: instalacja pakietów RPM wymaga dostępu na poziomie root, ale konfigurację Edge można przeprowadzić bez takiego dostępu.
Wyłącz SELinux zgodnie z opisem w artykule Instalowanie narzędzia apigee-setup w Edge.
Pobierz plik bootstrap_4.16.05.sh Edge 4.16.05 do /tmp/bootstrap_4.16.05.sh:
> curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
Zainstaluj narzędzie apigee-service Edge 4.16.05 i zależności:
> sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
gdzie uName:pWord to nazwa użytkownika i hasło otrzymane od Apigee. Jeśli pominiesz parametr pWord, pojawi się prośba o jego podanie.
Domyślnie instalator sprawdza, czy masz zainstalowaną Javę 1.8. Jeśli nie, zainstaluje ją za Ciebie. Aby określić, jak ma być obsługiwana instalacja Javy, użyj opcji JAVA_FIX. JAVA_FIX przyjmuje następujące wartości:
I = zainstaluj OpenJDK 1.8 (domyślnie),
C = kontynuuj bez instalowania Javy,
Q = zamknij. W przypadku tej opcji musisz samodzielnie zainstalować Javę.
Użyj apigee-service, aby zaktualizować narzędzie apigee-setup:
1. Jeśli wersja 4.16.01 została zainstalowana przez uaktualnienie Edge w wersji 4.15.07.0x, musisz zainstalować narzędzie apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  To polecenie instaluje narzędzie update.sh w katalogu <inst_dir>/apigee/apigee-setup/bin.
  
  Jeśli masz już zainstalowane narzędzie apigee-setup, zaktualizuj je:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
2. Jeśli wersja 4.16.01 została zainstalowana bezpośrednio, czyli nie została przeprowadzona aktualizacja z wersji 4.15.07.0x, musisz zaktualizować narzędzie apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  Ta aktualizacja apigee-service instaluje narzędzie update.sh w katalogu <inst_dir>/apigee/apigee-setup/bin.
Zainstaluj narzędzie apigee-validate na serwerze zarządzania:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
Uwaga: jeśli narzędzie apigee-validate zostało zainstalowane w węźle procesora komunikatów, możesz je zaktualizować, używając w tym węźle tego polecenia:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
Jednak w przypadku wersji 4.16.05 Apigee zaleca zainstalowanie i uruchomienie narzędzia apigee-validate na serwerze zarządzania.
Zmodyfikuj plik konfiguracji przekazany do narzędzia apigee-validate. In the previous Edge release, the config file used by apigee-validate required the following properties:
APIGEE_ADMINPW=sysAdminPword
MP_POD=gateway
REGION=dc-1
In this release, the config file only requires the APIGEE_ADMINPW property. Możesz usunąć z pliku pozostałe 2 właściwości.
Uruchom narzędzie do aktualizacji na węzłach w kolejności opisanej poniżej w sekcji „Kolejność aktualizacji maszyn”:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
Jedynym wymaganiem dotyczącym pliku konfiguracji jest to, że musi on być dostępny lub możliwy do odczytania przez użytkownika „apigee”. Możesz na przykład umieścić plik w katalogu /tmp w węźle.
Użyj opcji „-c”, aby określić komponent do zaktualizowania. Lista możliwych komponentów obejmuje:
- ldap = OpenLDAP
- cs = Cassandra
- zk = ZooKeeper
- qpid = qpidd
- ps = postgresql
- edge =wszystkie komponenty Edge z wyjątkiem interfejsu Edge: serwer zarządzania, procesor komunikatów, router, serwer QPID, serwer Postgres
- ui = interfejs Edge
- all = aktualizuje wszystkie komponenty na komputerze (używaj tylko w przypadku profilu instalacji Edge aio lub profilu instalacji API BaaS asa)
- e = ElasticSearch
- b = stos API BaaS
- p = portal API BaaS
- ebp = ElasticSearch, API BaaS Stack i API BaaS Portal w tym samym węźle
Przetestuj aktualizację, uruchamiając narzędzie apigee-validate na serwerze zarządzania, zgodnie z opisem w sekcji Testowanie instalacji.

Aby później wycofać aktualizację, wykonaj procedurę opisaną w sekcji 4.16.05 Proces wycofywania.

Procedura aktualizacji do wersji 4.16.05 z lokalnego repozytorium

Jeśli węzły Edge znajdują się za zaporą sieciową lub w inny sposób nie mają dostępu do repozytorium Apigee przez internet, możesz przeprowadzić aktualizację z lokalnego repozytorium lub kopii lustrzanej repozytorium Apigee.

Po utworzeniu lokalnego repozytorium Edge masz 2 opcje aktualizowania Edge z lokalnego repozytorium:

Utwórz plik .tar repozytorium, skopiuj go do węzła, a następnie zaktualizuj Edge z pliku .tar.
Zainstaluj serwer WWW w węźle z lokalnym repozytorium, aby inne węzły miały do niego dostęp. Apigee udostępnia serwer WWW Nginx, ale możesz też użyć własnego serwera WWW.

Aby zaktualizować z lokalnego repozytorium 4.16.05:

Utwórz lokalne repozytorium 4.16.05 zgodnie z opisem w sekcji „Tworzenie lokalnego repozytorium Apigee” w artykule Instalowanie narzędzia apigee-setup w Edge.
Uwaga: jeśli masz już repozytorium 4.16.01, możesz dodać do niego repozytorium 4.16.05.
Aby zainstalować apigee-service z pliku .tar:
1. On the node with the local repo, use the following command to package the local repo into a single .tar file named /opt/apigee/data/apigee-mirror/apigee-4.16.05.tar.gz:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
2. Skopiuj plik .tar do węzła, w którym chcesz zaktualizować Edge. Możesz go na przykład skopiować do katalogu /tmp w nowym węźle.
3. Na nowym węźle rozpakuj plik do katalogu /tmp:
  > tar -xzf apigee-4.16.05.tar.gz
  To polecenie tworzy nowy katalog o nazwie repos w katalogu zawierającym plik .tar. na przykład /tmp/repos.
4. Zainstaluj narzędzie Edge apigee-service i zależności z /tmp/repos:
  > sudo bash /tmp/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  Zwróć uwagę, że w tym poleceniu podajesz ścieżkę do katalogu repos.
Aby zainstalować apigee-service przy użyciu serwera WWW Nginx:
1. Skonfiguruj serwer WWW Nginx zgodnie z opisem w sekcji „Install from the repo using the Nginx webserver” (Instalowanie z repozytorium przy użyciu serwera WWW Nginx) w artykule Instalowanie narzędzia apigee-setup Edge.
2. On the remote node, download the Edge bootstrap_4.16.05.sh file to /tmp/bootstrap_4.16.05.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
  where uName:pWord are the username and password you set above for the repo, and remoteRepo is the IP address or DNS name of the repo node.
3. On the remote node, install the Edge apigee-service utility and dependencies:
  > sudo bash /tmp/bootstrap_4.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  where uName:pWord are the repo username and password.
Użyj apigee-service, aby zaktualizować narzędzie apigee-setup:
1. Jeśli wersja 4.16.01 została zainstalowana przez uaktualnienie Edge w wersji 4.15.07.0x, musisz zainstalować narzędzie apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  To polecenie instaluje narzędzie update.sh w katalogu <inst_dir>/apigee/apigee-setup/bin.
  
  Jeśli masz już zainstalowane narzędzie apigee-setup, zaktualizuj je:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
2. Jeśli wersja 4.16.01 została zainstalowana bezpośrednio, czyli nie przeprowadzono uaktualnienia z wersji 4.15.07.0x, musisz zaktualizować narzędzie apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  Ta aktualizacja apigee-service instaluje narzędzie update.sh w katalogu <inst_dir>/apigee/apigee-setup/bin.
Zainstaluj narzędzie apigee-validate na węźle serwera zarządzania:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
Uwaga: jeśli narzędzie apigee-validate zostało zainstalowane na węźle procesora komunikatów, możesz je zaktualizować, używając na tym węźle tego polecenia:

> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
Jednak w przypadku wersji 4.16.05 Apigee zaleca zainstalowanie i uruchomienie narzędzia apigee-validate na serwerze zarządzania.
Zmodyfikuj plik konfiguracji przekazany do narzędzia apigee-validate. In the previous Edge release, the config file used by apigee-validate required the following properties:
APIGEE_ADMINPW=sysAdminPword
MP_POD=gateway
REGION=dc-1
In this release, the config file only requires the APIGEE_ADMINPW property. Możesz usunąć z pliku pozostałe 2 właściwości.
Uruchom narzędzie do aktualizacji na węzłach w kolejności opisanej poniżej w sekcji „Kolejność aktualizacji maszyn”:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
Jedynym wymaganiem dotyczącym pliku konfiguracji jest to, że musi on być dostępny lub możliwy do odczytania przez użytkownika „apigee”. Możesz na przykład umieścić plik w katalogu /tmp w węźle.
Użyj opcji „-c”, aby określić komponent do zaktualizowania. Lista możliwych komponentów obejmuje:
- ldap = OpenLDAP
- cs = Cassandra
- zk = ZooKeeper
- qpid = qpidd
- ps = postgresql
- edge =wszystkie komponenty Edge z wyjątkiem interfejsu Edge: serwer zarządzania, procesor komunikatów, router, serwer QPID, serwer Postgres
- ui = interfejs Edge
- all = aktualizuje wszystkie komponenty na komputerze (używaj tylko w przypadku profilu instalacji Edge aio lub profilu instalacji API BaaS asa)
- e = ElasticSearch
- b = stos API BaaS
- p = portal API BaaS
- ebp = ElasticSearch, API BaaS Stack i API BaaS Portal w tym samym węźle
Przetestuj aktualizację, uruchamiając narzędzie apigee-validate na serwerze zarządzania, zgodnie z opisem w sekcji Testowanie instalacji.

Aby później wycofać aktualizację, wykonaj procedurę opisaną w sekcji 4.16.05 Proces wycofywania.

Kolejność aktualizacji maszyn

Kolejność aktualizowania maszyn w instalacji Edge jest ważna. Najważniejsze kwestie, które należy wziąć pod uwagę podczas aktualizacji:

Zanim zaktualizujesz inne węzły, musisz zaktualizować wszystkie węzły Cassandra i ZooKeeper.
Przed zaktualizowaniem węzłów routera i procesora komunikatów musisz zaktualizować wszystkie węzły qpidd i postgresql.
W przypadku każdej maszyny z wieloma komponentami Edge (serwer zarządzania, procesor komunikatów, router, serwer QPID, serwer Postgres) użyj opcji „-c edge”, aby zaktualizować je wszystkie jednocześnie.
Jeśli dany krok ma zostać wykonany na wielu maszynach, wykonaj go w określonej kolejności maszyn.
Nie ma osobnego kroku do aktualizacji zarabiania. Jest aktualizowany, gdy określisz opcję „-c edge”.
Po zaktualizowaniu węzła routera musisz usunąć wszystkie pliki z katalogu /opt/nginx/conf.d, a następnie ponownie uruchomić router.