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.

Zaktualizuj Apigee Edge 4.16.05.x do najnowszej wersji 4.16.05

Edge dla chmury prywatnej w wersji 4.16.05

Ten dokument zawiera procedurę aktualizowania istniejącej instalacji 4.16.05 w celu korzystania z najnowszych plików RPM i plików pomocy od Apigee. Ta procedura wykorzystuje narzędzie update.sh do przeprowadzenia aktualizacji.

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

English: Możesz zaktualizować tylko istniejącą instalację Apigee Edge w wersji 4.16.05.x do najnowszej wersji 4.16.05.

Jeśli obecnie używasz Edge w wersji 4.16.01.0x lub starszej, musisz najpierw przejść na wersję 4.16.05. Informacje o migracji do wersji 4.16.05 znajdziesz w artykule Aktualizowanie Apigee Edge z wersji 4.16.01 do 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ć.

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

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ć 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, zapoznaj się z artykułem 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_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 następnej sekcji „Ustawianie routera i procesora komunikatów jako nieosiągalnych”.
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.

Uniemożliwianie dostępu do routera i procesora komunikatów

W konfiguracji produkcyjnej będziesz mieć wiele routerów i procesorów komunikatów, aby osiągnąć optymalną wydajność. Musisz włączyć lub wyłączyć osiągalność tych routerów i procesorów komunikatów przed aktualizacją lub po niej.

To wywołanie interfejsu API konfiguruje węzeł jako osiągalny lub nieosiągalny:

> curl -u adminEmail:pWord -X POST "http://<ms_IP>:8080/v1/servers/UUID" -d "reachable=true|false"

gdzie UUID to identyfikator UUID procesora komunikatów lub routera, a parametr reachable ma wartość true lub false.

Jeśli chcesz określić identyfikator UUID routera, użyj tego polecenia cURL:

> curl http://<routerIP>:8081/v1/servers/self

Jeśli chcesz określić identyfikator UUID procesora komunikatów, użyj tego polecenia cURL:

> curl http://<mpIP>:8082/v1/servers/self

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 nieosiągalny, używając wywołania interfejsu API pokazanego powyżej.
  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 dostę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.05.

Procedura aktualizacji 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.
Wyczyść wszystkie pamięci podręczne Yum:
> sudo yum clean all
Pobierz najnowszy plik Edge bootstrap_4.16.05.sh do /tmp/bootstrap_4.16.05.sh:
> curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
Zaktualizuj narzędzie apigee-service i zależności Edge:
> 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.
Użyj apigee-service, aby 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 /<inst_dir>/apigee/apigee-setup/bin.
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 odczytu 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 = Cassandr
- 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 = aktualizuj wszystkie komponenty na komputerze (używaj tylko w przypadku profilu instalacji Edge aio lub profilu instalacji API BaaS asa)
- e = ElasticSearch
- b = API BaaS Stack
- 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, Test the install.

Procedura aktualizacji 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:

Upewnij się, że masz lokalne repozytorium 4.16.05, zgodnie z opisem w artykule Instalowanie komponentów Edge w węźle.
Zaktualizuj lokalne repozytorium:
1. Pobierz najnowszy plik Edge bootstrap_4.16.05.sh do /tmp/bootstrap_4.16.05.sh:
  > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
2. Przeprowadź synchronizację:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
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. 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.
5. Wyłącz SELinux zgodnie z opisem w artykule Instalowanie narzędzia apigee-setup w Edge.
6. 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 uwzględniasz ś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 komponentów Edge w węźle.
2. Na węźle zdalnym pobierz plik Edge bootstrap_4.16.05.sh do /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
  
  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. 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.
4. Wyłącz SELinux zgodnie z opisem w artykule Instalowanie narzędzia apigee-setup w Edge.
5. Na węźle zdalnym zainstaluj narzędzie Edge apigee-service i zależności:
  > sudo bash /tmp/bootstrap_4.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uNamea pigeepassword=pWord apigeeprotocol=http://
  
  gdzie uName:pWord to nazwa użytkownika i hasło repozytorium.
Jeśli istnieją zadania CRON skonfigurowane do wykonywania operacji naprawy w Cassandra, wyłącz je do czasu zakończenia aktualizacji.
Użyj apigee-service, aby 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 <inst_dir>/apigee/apigee-setup/bin.
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 = Cassandr
- 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 = aktualizuj wszystkie komponenty na komputerze (używaj tylko w przypadku profilu instalacji Edge aio lub profilu instalacji API BaaS asa)
- e = ElasticSearch
- b = API BaaS Stack
- 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, Test the install (Przetestuj instalację).

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.