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.17.01/4.17.05 do 4.17.09

Edge dla chmury prywatnej w wersji 4.17.09

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

Za pomocą tej procedury możesz zaktualizować Apigee Edge w wersji 4.17.01.0x/4.17.05.0x do wersji 4.17.09.

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

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

Które komponenty musisz zaktualizować

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

Automatyczne rozpowszechnianie ustawień usługi

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

Wymagane dodanie parametru konfiguracji SMTPMAILFROM

W Edge 4.17.05 dodano nowy wymagany parametr do pliku konfiguracji używanego podczas włączania serwera SMTP. Jeśli przeprowadzasz aktualizację z wersji 4.17.01, podczas włączania serwera SMTP musisz ustawić SMTPMAILFROM w pliku konfiguracji.

W wersji 4.17.09 interfejsu API BaaS dodano też obsługę właściwości SMTPMAILFROM. Podczas aktualizowania API BaaS z wersji 4.17.01 lub 4.17.05 musisz ustawić SMTPMAILFROM w pliku konfiguracji.

Ten parametr ma postać:

SMTPMAILFROM="My Company <myco@company.com>"

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.
Upewnij się, że Edge działa
Upewnij się, że Edge działa podczas procesu aktualizacji, używając polecenia:

> /opt/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ć skrypt 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 sekcji 4.17.09 Proces przywracania.

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

Procedura aktualizacji do wersji 4.17.09 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 RPM wymaga dostępu do konta root, ale konfigurację Edge można przeprowadzić bez niego.
Zainstaluj yum-utils i yum-plugin-priorities:
> sudo yum install yum-utils
> sudo yum install yum-plugin-priorities
Wyłącz SELinux zgodnie z opisem w artykule Instalowanie narzędzia apigee-setup w Edge.
Jeśli instalujesz na AWS, uruchom to polecenie yum-configure-manager:
> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
Pobierz plik Edge 4.17.09 bootstrap_4.17.09.sh do /tmp/bootstrap_4.17.09.sh:
> curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
Zainstaluj narzędzie apigee-service Edge 4.17.09 i zależności:
> sudo bash /tmp/bootstrap_4.17.09.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 te 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:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
Zaktualizuj narzędzie apigee-validate na serwerze zarządzania:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
Zaktualizuj narzędzie apigee-provision:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
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”.

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 oprócz interfejsu Edge: serwer zarządzania, procesor komunikatów, router, serwer QPID, serwer Postgres
ui = interfejs Edge
all = aktualizacja wszystkich komponentów 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, stos API BaaS i portal API BaaS 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.17.09 Proces wycofywania.

Procedura aktualizacji do wersji 4.17.09 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.17.09:

Utwórz lokalne repozytorium 4.17.09 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.17.01/4.17.05, możesz dodać do niego repozytorium 4.17.09 zgodnie z opisem w sekcji „Aktualizowanie lokalnego repozytorium Apigee” w artykule Instalowanie narzędzia apigee-setup Edge.
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.17.09.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.17.09.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.17.09.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 „Instalowanie z repozytorium przy użyciu serwera WWW Nginx” w artykule Instalowanie narzędzia apigee-setup Edge.
2. Na węźle zdalnym pobierz plik Edge bootstrap_4.17.09.sh do /tmp/bootstrap_4.17.09.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
  
  gdzie uName:pWord to nazwa użytkownika i hasło ustawione powyżej dla repozytorium, a remoteRepo to adres IP lub nazwa DNS węzła repozytorium.
3. Na węźle zdalnym zainstaluj narzędzie Edge apigee-service i zależności:
  > sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  
  gdzie uName:pWord to nazwa użytkownika i hasło repozytorium.
Użyj apigee-service, aby zaktualizować narzędzie apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
Zaktualizuj narzędzie apigee-validate na serwerze zarządzania.
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
Zaktualizuj narzędzie apigee-provision:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
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”.

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 oprócz interfejsu Edge: serwer zarządzania, procesor komunikatów, router, serwer QPID, serwer Postgres
ui = interfejs Edge
all = aktualizacja wszystkich komponentów 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, stos API BaaS i portal API BaaS 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.17.09 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.
W przypadku każdej maszyny z wieloma komponentami Edge (serwer zarządzania, procesor komunikatów, router, serwer QPID, ale nie serwer Postgres) użyj opcji „-c edge”, aby zaktualizować je wszystkie jednocześnie.
Jeśli 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”.