Ta strona została przetłumaczona przez Cloud Translation API.

Aktualizacja Apigee Edge od 4.16.01 do 4.16.05

Edge for Private Cloud wer. 4.16.05

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

Możesz zaktualizować Apigee Edge tylko w wersji 4.16.01.x do wersji 4.16.05.

Jeśli masz wersję Edge wcześniejszą 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 przeprowadzać aktualizację

Użytkownik przeprowadzający aktualizację powinien być tym samym użytkownikiem, który pierwotnie zainstalował Edge lub użytkownikiem root.

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

Wymagane uaktualnienie do wersji 8 Java JDK

Ta wersja Edge wymaga zainstalowania oprogramowania Java JDK w wersji 8 we wszystkich węzłach przetwarzania brzegowego. Możesz zainstalować Oracle JDK 8 lub OpenJDK 8. Jeśli nie masz jeszcze zainstalowanego pakietu Java JDK 8, skrypt aktualizacji może go 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 „Domyślne wyłączone pakiety szyfrów” http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.

Ostrzeżenie: ta wersja Edge nie obsługuje JDK 7. Jeśli korzystasz obecnie z pakietu JDK 7, musisz przejść na wersję JDK 8. Jeśli przywrócisz instalację Edge 4.16.05, możesz opcjonalnie ponownie skonfigurować Edge tak, aby używała wtyczki Java JDK 7.

Zmiana opiekuna ogrodu zoologicznego na niższą wersję

Wersja RPM Zookeeper w Edge for Private Cloud 4.16.01 to apigee-zookeeper-3.4.5-1.0.905.noarch.rpm. W kolejnych wersjach Edge zmieniono wersję Zookeeper z powrotem na apigee-zookeeper-3.4.5-0.0.948. Uniemożliwia to yum uaktualnienie Zookeeper do nowszej wersji z wersji 4.16.01. Sposobem na rozwiązanie tej sytuacji jest uruchomienie polecenia yum przejście na niższą wersję apigee-zookeeper przed aktualizacją Zookeeper.

Wersję Zookeeper 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 podczas aktualizacji

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

Automatyczne rozpowszechnienie ustawień usługi z wersji 4.16.01.x

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

Aktualizowanie narzędzia apigee-validate

W wersji 4.16.01 zainstalowano i uruchomiono narzędzie apigee-validate w węźle procesora wiadomości. W wersji 4.16.05 narzędzie apigee-validate zostało zaktualizowane, aby mogło działać w węźle serwera zarządzania.

Po aktualizacji do wersji 4.16.05 dostępne są 2 opcje aktualizacji narzędzia apigee-validate:

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

Opcjonalnie możesz odinstalować narzędzie apigee-validate z węzłów procesora wiadomości. Jeśli pozostawisz ją w węźle procesora wiadomości, musisz zaktualizować go do wersji 4.16.05.
Możesz też zaktualizować narzędzie apigee-validate w węźle procesora wiadomości i uruchomić je stamtąd. Apigee zaleca jednak zainstalowanie i uruchomienie go z serwera zarządzania.

Zaktualizuj wymagania wstępne

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

Utwórz kopię zapasową wszystkich węzłów
Ze względów bezpieczeństwa zalecamy wykonanie pełnej kopii zapasowej wszystkich węzłów przed aktualizacją. Wykonaj procedurę dotyczącą bieżącej wersji Edge, aby utworzyć kopię zapasową.

Pozwala to uzyskać plan wykonywania kopii zapasowych na wypadek problemów z aktualizacją do nowej wersji. Więcej informacji o tworzeniu kopii zapasowych znajdziesz w artykule Tworzenie i przywracanie kopii zapasowych.
Upewnij się, że przeglądarka Edge jest uruchomiona
Podczas aktualizacji sprawdź, czy przeglądarka Edge jest uruchomiona i działa, korzystając z polecenia:

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

Obsługa nieudanej aktualizacji

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

Jeśli błąd wymaga przywrócenia aktualizacji do poprzedniej wersji, przeczytaj artykuł 4.16.05 Proces przywracania, aby dowiedzieć się więcej.

Informacje o aktualizacjach logowania

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

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

Jeśli użytkownik uruchamiający narzędzie update.sh nie ma dostępu do tego katalogu, zapisuje dziennik w katalogu update.sh jako plik o nazwie update.sh.

Jeśli użytkownik nie ma dostępu do pliku /tmp, działanie narzędzia update.sh ulegnie awarii.

Aktualizacja bez przestojów

Aktualizacja krocząca z zerowym czasem przestoju umożliwia zaktualizowanie instalacji Edge bez wyłączania Edge.

Aktualizacja bez przestojów jest możliwa tylko w przypadku konfiguracji obejmującej 5 węzłów i więcej.

Kluczem do uaktualnienia bez przestojów jest usunięcie każdego routera pojedynczo z systemu równoważenia obciążenia. Następnie zaktualizuj router i wszystkie pozostałe komponenty na tej samej maszynie co router, a następnie dodaj go z powrotem do systemu równoważenia obciążenia.

Zaktualizuj maszyny w odpowiedniej kolejności, zgodnie z sekcją „Kolejność aktualizacji maszyny” poniżej.
Gdy nadejdzie czas zaktualizowania routerów, wybierz dowolny router i ustaw go jako nieosiągalny zgodnie z opisem w sekcji Osiągalność: włączanie/wyłączanie serwera (procesor wiadomości/router).
Zaktualizuj wybrany router i wszystkie pozostałe komponenty brzegowe na tym samym komputerze co router. Wszystkie konfiguracje brzegowe pokazują router i procesor wiadomości w tym samym węźle.
Przywróć dostęp do routera.
Powtórz kroki od 2 do 4 dla pozostałych routerów.
Kontynuuj aktualizację na wszystkich pozostałych komputerach w instalacji.

Przed aktualizacją i po niej zadbaj o te kwestie:

W połączonym węźle routera i procesora wiadomości:
- Przed aktualizacją wykonaj te czynności:
  1. Ustaw router jako nieosiągalny.
  2. Sprawiaj, że procesor wiadomości jest nieosiągalny.
- Po aktualizacji – wykonaj te czynności:
  1. Zapewnij osiągalność procesora wiadomości.
  2. Zadbaj o osiągnięcie routera.
W jednym węźle routera:
- Przed aktualizacją ustaw router jako nieosiągalny.
- Po aktualizacji zadbaj o to, aby router był osiągalny.
W jednym węźle procesora wiadomości:
- Przed aktualizacją ustaw procesor wiadomości jako nieosiągalny.
- Po zakończeniu aktualizacji zapewnij dostęp do procesora wiadomości.

Korzystanie z cichego pliku konfiguracji

Do polecenia aktualizacji musisz przekazać dyskretny plik konfiguracji. Plik konfiguracji dyskretnej powinien być taki sam jak ten użyty do zainstalowania Edge 4.16.01.

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

Aby zaktualizować komponenty Edge w węźle, wykonaj czynności opisane poniżej:

Jeśli są obecne, wyłącz wszystkie zadania CRON skonfigurowane tak, aby przeprowadzały operację naprawy na urządzeniu Cassandra, dopóki aktualizacja nie zostanie zakończona.
Aby zainstalować Edge RPM, zaloguj się w węźle jako użytkownik root.
Uwaga: chociaż instalacja RPM wymaga dostępu do roota, możesz skonfigurować Edge bez dostępu do roota.
Wyłącz SELinux zgodnie z opisem w sekcji Instalowanie narzędzia Edge apigee-setup.
Pobierz plik bootstrap_4.16.05.sh Edge w wersji /tmp/bootstrap_4.16.05.sh:
> curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap05.1.
Zainstaluj narzędzie Edge 4.16.05 apigee-service i jego 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 z Apige. Jeśli pominiesz parametr pWord, pojawi się prośba o jego podanie.
Instalator domyślnie sprawdza, czy jest zainstalowana platforma Java 1.8. Jeśli tego nie zrobisz, zostanie ona automatycznie zainstalowana. Aby określić sposób obsługi instalacji Java, użyj opcji JAVA_FIX. JAVA_FIX przyjmuje te wartości:
I = Zainstaluj OpenJDK 1.8 (domyślnie)
C = kontynuuj bez instalowania języka Java
Q = Zakończ. W przypadku tej opcji musisz samodzielnie zainstalować Javę.
Użyj apigee-service, aby zaktualizować narzędzie apigee-setup:
1. Jeśli masz zainstalowaną wersję 4.16.01 po uaktualnieniu Edge do wersji 4.15.07.0x, musisz zainstalować narzędzie apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service/setupgee-setup apply
  To polecenie instaluje narzędzie update.bine> w katalogu <ingest/apie>
  
  Jeśli masz już zainstalowane narzędzie apigee-setup, zaktualizuj je:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
2. Jeśli zainstalowałeś wersję 4.16.01 bezpośrednio, czyli nie uaktualniłeś(-aś) z wersji 4.15.07.0x, musisz zaktualizować narzędzie apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup.
  Ta aktualizacja jest przeprowadzana dla /update-apigee-api
Zainstaluj narzędzie apigee-validate na serwerze zarządzania:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate instalacja
Uwaga: jeśli narzędzie apigee-validate jest zainstalowane w węźle Message Processor, możesz je zaktualizować, używając tego polecenia/optege/opte, wykonując w tym węźle to polecenie:
apigee-validate
Edytuj plik konfiguracyjny przekazany do narzędzia apigee-validate. W poprzedniej wersji Edge plik konfiguracji używany przez funkcję apigee-validate wymagał tych właściwości:
APIGEE_ADMINPW=sysAdminPword
MP_POD=brama
REGION=dc-1
W tej wersji plik konfiguracji wymaga tylko właściwości APIGEE_ADMINPW. Możesz usunąć z pliku pozostałe 2 właściwości.
Uruchom narzędzie do aktualizacji w węzłach w kolejności opisanej w sekcji „Kolejność aktualizacji maszyny” poniżej:
> /opt/apigee/apigee-setup/bin/update.sh -c komponencie -f configFile
Jedynym wymaganiem dotyczącym pliku konfiguracji jest to, aby plik konfiguracji był dostępny i zrozumiały dla użytkownika „apigee”. Na przykład umieść plik w katalogu /tmp w węźle.
Użyj opcji „-c”, aby wskazać komponent do aktualizacji. Lista możliwych komponentów to:
- ldap = OpenLDAP
- cs = Cassandra
- zk = Zookeeper
- qpid = qpidd
- ps = postgresql
- edge =Wszystkie komponenty brzegowe oprócz UI Edge: Serwer zarządzania, Procesor wiadomości, Router, Serwer QPID i Serwer Postgres
- ui = interfejs Edge
- all = aktualizacja wszystkich komponentów na maszynie (używaj tylko w przypadku profilu instalacji Edge Aio lub profilu instalacji API BaaS asa)
- e = ElasticSearch
- b = stos API BaaS
- p = API BaaS Portal
- 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 czynności opisane w sekcji 4.16.05 Proces przywracania.

Procedura aktualizacji do wersji 4.16.05 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 lub jego dublowania.

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

Utwórz w repozytorium plik .tar, skopiuj go do węzła, a następnie zaktualizuj Edge z poziomu 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, którego możesz używać, lub możesz użyć własnego serwera.

Aby zaktualizować dane z lokalnego repozytorium w wersji 4.16.05:

Utwórz lokalne repozytorium w wersji 4.16.05 zgodnie z opisem w sekcji „Tworzenie lokalnego repozytorium Apigee” artykułu Instalowanie narzędzia Edge apigee-setup.
Uwaga: jeśli masz już repozytorium w wersji 4.16.01, możesz dodać do niego repozytorium 4.16.05.
Aby zainstalować apigee-service z pliku .tar:
1. W węźle z lokalnym repozytorium za pomocą tego polecenia spakuj je do jednego pliku .tar o nazwie /opt/apigee/data/apigee-mirror/apigee-4.16.05.tar.gz:
  > /opt/apigee/apigee-service/bin/apigee-service apigee
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 cofnij 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 jego zależności z /tmp/repos:
  > sudo bash /tmp/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  Pamiętaj, że w tym poleceniu uwzględniono ścieżkę do katalogu repozytorium.
Aby zainstalować usługę apigee-service przy użyciu serwera WWW Nginx:
1. Skonfiguruj serwer WWW Nginx, wykonując instrukcje podane w sekcji „Instalowanie z repozytorium przy użyciu serwera WWW Nginx” artykułu Instalowanie narzędzia Edge apigee-setup.
2. Na węźle zdalnym pobierz plik Edge bootstrap_4.16.05.sh dla adresu IP /tmp/bootstrap_4.16.05.sh:
  > /usr/bin/curl http://uName:pWord@nazwa_zdalnego_repozytorium:nazwa_użytkownika_zdalnego.0 lub adres_zespołu_zdalnego0.repo5 .
3. W 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=uName apigeepassword=pWordprotokół i hasło to
Użyj apigee-service, aby zaktualizować narzędzie apigee-setup:
1. Jeśli masz zainstalowaną wersję 4.16.01 po uaktualnieniu Edge do wersji 4.15.07.0x, musisz zainstalować narzędzie apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup setup
  To polecenie instaluje narzędzie apigee-dire.sh w instrukcjach <inge-apie.sh w sekcji <inge-apie/api
  
  Jeśli masz już zainstalowane narzędzie apigee-setup, zaktualizuj je:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
2. Jeśli masz zainstalowaną wersję 4.16.01 bezpośrednio, czyli nie uaktualniono z wersji 4.15.07.0x, musisz zaktualizować narzędzie apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup aktualizacja
  Ta aktualizacja dla apigee-update/service.
Zainstaluj narzędzie apigee-validate w węźle serwera zarządzania:
apigee-validate
Uwaga: jeśli w węźle procesora wiadomości zostało zainstalowane narzędzie apigee-validate, możesz je zaktualizować, wykonując w tym węźle to polecenie:

> /opt/apigee/apigee-service/bin/apigee-service apigee-validate aktualizacja
Jednak w przypadku wersji 4.16.05 Apigee zaleca zainstalowanie i uruchomienie narzędzia apigee-validate na serwerze zarządzania.
Edytuj plik konfiguracyjny przekazany do narzędzia apigee-validate. W poprzedniej wersji Edge plik konfiguracji używany przez funkcję apigee-validate wymagał tych właściwości:
APIGEE_ADMINPW=sysAdminPword
MP_POD=gateway
REGION=dc-1
W tej wersji plik konfiguracji wymaga tylko właściwości APIGEE_ADMINPW. Możesz usunąć z pliku pozostałe 2 właściwości.
Uruchom narzędzie do aktualizacji w węzłach w kolejności opisanej w sekcji „Kolejność aktualizacji maszyny” poniżej:
> /opt/apigee/apigee-setup/bin/update.sh -c komponencie -f configFile
Jedynym wymaganiem dotyczącym pliku konfiguracji jest to, aby plik konfiguracji był dostępny i zrozumiały dla użytkownika „apigee”. Na przykład umieść plik w katalogu /tmp w węźle.
Użyj opcji „-c”, aby wskazać komponent do aktualizacji. Lista możliwych komponentów to:
- ldap = OpenLDAP
- cs = Cassandra
- zk = Zookeeper
- qpid = qpidd
- ps = postgresql
- edge =Wszystkie komponenty brzegowe oprócz UI Edge: Serwer zarządzania, Procesor wiadomości, Router, Serwer QPID i Serwer Postgres
- ui = interfejs Edge
- all = aktualizacja wszystkich komponentów na maszynie (używaj tylko w przypadku profilu instalacji Edge Aio lub profilu instalacji API BaaS asa)
- e = ElasticSearch
- b = stos API BaaS
- p = API BaaS Portal
- 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 czynności opisane w sekcji 4.16.05 Proces przywracania.

Kolejność aktualizacji maszyny

Kolejność aktualizowania maszyn w instalacji Edge jest ważna. Najważniejsze kwestie dotyczące aktualizacji:

Zanim zaktualizujesz inne węzły, musisz zaktualizować wszystkie węzły Cassandra i ZooKeeper.
Zanim zaktualizujesz węzły routera i procesora wiadomości, musisz zaktualizować wszystkie węzły qpidd i postgresql.
W przypadku maszyn z wieloma komponentami brzegowymi (serwer zarządzania, procesor wiadomości, router, serwer QPID, serwer Postgres) użyj opcji „-c Edge”, aby zaktualizować je wszystkie jednocześnie.
Jeśli krok określa, że należy go wykonać na wielu komputerach, wykonaj go w określonej kolejności maszyn.
Nie musisz robić nic więcej, aby zaktualizować ustawienia Zarabianie. 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.