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 w wersji 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 starszą niż 4.16.01.x, musisz najpierw przeprowadzić migrację do wersji 4.16.01.x, a następnie zaktualizować ją do wersji 4.16.05.

Kto może przeprowadzić aktualizację

Użytkownik uruchamiający aktualizację powinien być taki sam jak użytkownik, który pierwotnie zainstalował Edge lub z wykorzystaniem roota.

Gdy zainstalujesz pakiety RPM Edge, każdy użytkownik będzie mógł je skonfigurować.

Wymagane uaktualnienie do Java JDK w wersji 8

Ta wersja Edge wymaga zainstalowania środowiska Java JDK w wersji 8 na całej platformie Edge węzłów przetwarzania. Możesz zainstalować Oracle JDK 8 lub OpenJDK 8. Jeśli nie zainstalowano środowiska Java JDK 8 skrypt aktualizacji może już go zainstalować.

W ramach aktualizacji do Javy 8 niektóre mechanizmy szyfrowania TLS nie są już dostępne w Oracle JDK 8. Dla: pełną listę znajdziesz w sekcji „DefaultDisabled Cipher Suite” (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 pakietu JDK 7. Jeśli obecnie używając pakietu JDK 7, musisz uaktualnić go do wersji JDK 8. Jeśli przywrócisz instalację Edge 4.16.05, opcjonalnie zmień konfigurację Edge tak, aby używała środowiska Java JDK 7.

Zmniejszający kapitał zoologiczny

Wersja RPM Zookeeper w Edge for Private Cloud 4.16.01 to apigee-zookeeper-3.4.5-1.0.905.noarch.rpm. W W kolejnych wersjach Edge wersja Zookeeper została zmieniona z powrotem na apigee-zookeeper-3.4.5-0.0.948. Zapobiega to Uaktualnianie Zookeeper do nowszej wersji z 4.16.01. Sposób na rozstrzygnięcie tej sytuacji to uruchomienie yumlegacy apigee-zookeeper.

Wersję aplikacji Zookeeper możesz sprawdzić za pomocą następującego 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 dla aktualizacji

Przed wykonaniem .

Automatyczne propagacja właściwości ustawienia z wersji 4.16.01.x

Jeśli masz ustawione jakieś właściwości, edytując pliki .properties w pliku /opt/apigee/customer/application, są zachowywane w ramach aktualizacji.

Aktualizowanie narzędzia apigee-validate

W wersji 4.16.01 w wiadomości zainstalowano i uruchomiono narzędzie apigee-validate Węzeł procesora. W wersji 4.16.05 narzędzie apigee-validate zostało udostępnione zaktualizowany tak, aby działał w węźle serwer zarządzania.

Po aktualizacji do wersji 4.16.05 narzędzie apigee-validate możesz wykonać na 2 sposoby:

Zalecane rozwiązanie Apigee – zainstaluj i uruchom narzędzie apigee-validate Węzeł serwera zarządzania.

Możesz opcjonalnie odinstalować narzędzie apigee-validate, które pozwala w węzłach procesora wiadomości. Jeśli pozostawisz go w węźle procesora wiadomości, musisz go zaktualizować do 4.16.05.
Możesz też zaktualizować narzędzie apigee-validate i uruchomić go w węźle procesora wiadomości. Apigee zaleca jednak zainstalowanie i uruchamiać go z serwera zarządzania.

Zaktualizuj wymagania wstępne

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

Utwórz kopię zapasową wszystkich węzłów
Przed aktualizacją zalecamy wykonanie pełnej kopii zapasowej wszystkich węzłów, aby zapewnić bezpieczeństwo . 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 powiodła się. nie działają poprawnie. Więcej informacji o kopii zapasowej znajdziesz w artykule Tworzenie i przywracanie kopii zapasowej.
Sprawdzanie, czy przeglądarka Edge działa
Sprawdź, czy podczas aktualizacji przeglądarka Edge jest uruchomiona, korzystając z polecenia:

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

Obsługa nieudanej aktualizacji

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

Jeśli błąd wymaga przywrócenia poprzedniej wersji, zobacz 4.16.05 Proces wycofywania, aby uzyskać więcej informacji.

Informacje o aktualizacji logów

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

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

Jeśli użytkownik uruchamiający narzędzie update.sh nie ma dostępu do ten katalog zapisze dziennik w katalogu /tmp jako plik o nazwie /tmp.

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

Aktualizacja z zerowym czasem przestoju

Dzięki aktualizacji bez przestojów (czyli aktualizacji kroczącej) możesz zaktualizować instalację Edge bez Zmniejszając do siebie 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 obciążenia każdego routera pojedynczo. systemu równoważenia obciążenia. Następnie zaktualizujesz router i wszystkie inne komponenty na tym samym komputerze, co router, a potem z powrotem dodaj router do systemu równoważenia obciążenia.

Zaktualizuj komputery w odpowiedniej kolejności, zgodnie z opisem poniżej w sekcji „Zamawianie” aktualizacji maszyny”.
Gdy przyjdzie czas na aktualizację routerów, wybierz dowolny z nich i ustaw go jako nieosiągalny, opisane w sekcji Włączanie/wyłączanie serwera Osiągalność (procesora i trafikatora wiadomości).
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.
Ustaw router ponownie jako osiągalny.
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 weź pod uwagę 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. Ustaw procesor wiadomości jako nieosiągalny.
- Po aktualizacji:
  1. Upewnij się, że procesor wiadomości jest osiągalny.
  2. Ustaw router jako osiągalny.
W jednym węźle routera:
- Przed aktualizacją ustaw router jako nieosiągalny.
- Po aktualizacji upewnij się, że router jest osiągalny.
W jednym węźle procesora wiadomości:
- Przed aktualizacją ustaw procesor wiadomości jako nieosiągalny.
- Po aktualizacji upewnij się, że procesor wiadomości jest osiągalny.

Używanie cichego pliku konfiguracji

Do polecenia aktualizacji musisz przekazać dyskretny plik konfiguracji. Plik konfiguracji cichej (powinien to być ten sam, który został użyty do zainstalowania Edge 4.16.01).

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

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

Jeśli jest obecna, wyłącz wszystkie zadania CRON skonfigurowane pod kątem wykonywania operacji naprawy w Cassandra .
Zaloguj się w węźle jako root, aby zainstalować pakiety RPM Edge
Uwaga: chociaż instalacja pakietu RPM wymaga dostępu do roota, możesz uruchomić Edge bez dostępu do roota.
Wyłącz SELinux zgodnie z opisem w sekcji Instalowanie Edge apigee-setup .
Pobierz plik Edge 4.16.05 bootstrap_4.16.05.sh do pliku bootstrap_4.16.05.sh:
curl https://software.apigee.com/shoestrap_4.16.05.sh -o /tmp/shoestrap_4.16.05.sh
Zainstaluj narzędzie apigee-service w Edge 4.16.05 oraz zależności:
Sudo Bash /tmp/shoestrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
gdzie uName:pWord to nazwa użytkownika i hasło otrzymane z adresu Apigee. Jeśli pominiesz słowo pWord, pojawi się prośba o jego wpisanie.
Domyślnie instalator sprawdza, czy zainstalowano środowisko Java 1.8. Jeśli tego nie zrobisz, zainstaluje ją za Ciebie. Użyj opcji JAVA_FIX, aby określić sposób obsługi Instalacja Javy. JAVA_FIX przyjmuje następujące wartości:
I = Zainstaluj OpenJDK 1.8 (domyślnie)
C = kontynuuj bez instalowania Javy
P = Zakończ. Aby skorzystać z tej opcji, musisz samodzielnie zainstalować Javę.
Użyj apigee-service, aby: aktualizowanie pliku apigee-setup narzędzie:
1. Jeśli zainstalowałeś wersję 4.16.01 przez uaktualnienie Edge do wersji 4.15.07.0x, musisz zainstaluj narzędzie apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service instalacja apigee-setup
  To polecenie instaluje narzędzie update.sh w katalogu <inst_dir>/apigee/apigee-setup/bin.
  
  Jeśli narzędzie apigee-setup jest już zainstalowane, zaktualizuj it:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup aktualizacja
2. Jeśli wersja 4.16.01 została zainstalowana bezpośrednio, oznacza to, że nie przeprowadzono aktualizacji z 4.15.07.0x, musisz zaktualizować narzędzie apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup Aktualizacja
  Aktualizacja apigee-service spowoduje zainstalowanie rozszerzenia Narzędzie update.sh w <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 węźle procesora wiadomości, możesz go zaktualizować, korzystając z następującego 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 do weryfikacji Apigee na serwera zarządzania.
Edytuj plik konfiguracji przekazany do narzędzia apigee-validate. W w poprzedniej wersji Edge plik konfiguracyjny używany przez narzędzie apigee-validate wymagał parametru te 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ąć dwóch innych właściwości.
Uruchom narzędzie do aktualizacji w węzłach w kolejności opisanej poniżej w sekcji „Kolejność maszyn zaktualizuj” poniżej:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
Plik konfiguracji musi być tylko dostępny lub czytelna przez „apigee” użytkownika. Na przykład umieść plik w katalogu /tmp w katalogu do węzła.
Aby określić komponent do aktualizacji, użyj opcji „-c”. Na liście możliwych komponenty obejmują:
- ldap = OpenLDAP
- cs = Cassandra,
- zk = opiekun zoo
- qpid = qpidd
- ps = postgresql
- edge =All Edge komponenty oprócz interfejsu Edge UI: serwer zarządzania, procesor wiadomości, router, serwer QPID, Serwer Postgres
- ui = UI Edge
- all = zaktualizuj wszystkie komponenty na maszynie (używane tylko w przypadku profilu instalacji Edge aio lub API BaaS API Asa) profilu instalacji)
- E = ElasticSearch
- b – stos BaaS API
- p = baaS interfejsu API. Portale
- ebp = ElasticSearch, Stos BaaS API i portal BaaS API w tym samym węźle
Przetestuj aktualizację, uruchamiając narzędzie apigee-validate na serwerze zarządzania zgodnie z opisane w artykule 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 repozytorium

Jeśli węzły brzegowe są za zaporą sieciową lub z innego powodu nie mają dostępu z repozytorium Apigee przez internet, możesz przeprowadzić aktualizację z repozytorium lokalnego lub powielanie repozytorium Apigee.

Po utworzeniu lokalnego repozytorium Edge masz 2 opcje aktualizowania Edge z poziomu lokalne 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, z którego możesz korzystać. Możesz też skorzystać z własnego serwera WWW.

Aby zaktualizować dane z lokalnego repozytorium 4.16.05:

Utwórz lokalne repozytorium 4.16.05 zgodnie z opisem w sekcji „Tworzenie lokalnego repozytorium Apigee” na stronie Install the Edge apigee-setup .
Uwaga: jeśli masz już repozytorium w wersji 4.16.01, możesz dodać wersję 4.16.05 do repozytorium.
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.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. Na przykład skopiuj go do katalog /tmp w nowy węzeł.
3. W nowym węźle wyciągnij plik z katalogu /tmp:
  > tar -xzf apigee-4.16.05.tar.gz
  To polecenie tworzy nowy katalog, w katalogu zawierającym plik .tar. Przykład: /tmp/repos.
4. Zainstaluj narzędzie Edge apigee-service oraz zależności z katalogu /tmp/repos:
  > Sudo Bash /tmp/repos/shoestrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  Zwróć uwagę, że wpisano ścieżkę do katalogu repozytorium w tym poleceniu.
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 interfejsu Nginx” webserver" na stronie Install the Edge apigee-setup.
2. W węźle zdalnym pobierz plik Edge loadstrap_4.16.05.sh do /tmp/shoestrap_4.16.05.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.05.sh -o /tmp/shoestrap_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 repozytorium. do węzła.
3. W węźle zdalnym zainstaluj narzędzie Edge apigee-service i zależności:
  > Sudo Bash /tmp/shoestrap_4.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  gdzie uName:pWord to nazwa użytkownika repozytorium, hasło.
Użyj apigee-service, aby: Zaktualizuj narzędzie apigee-setup:
1. Jeśli zainstalowałeś wersję 4.16.01 przez uaktualnienie Edge do wersji 4.15.07.0x, musisz zainstaluj narzędzie apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service instalacja apigee-setup
  To polecenie instaluje narzędzie update.sh. w <inst_dir>/apigee/apigee-setup/bin.
  
  Jeśli narzędzie apigee-setup jest już zainstalowane, zaktualizuj it:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup aktualizacja
2. Jeśli wersja 4.16.01 została zainstalowana bezpośrednio, oznacza to, że nie przeprowadzono aktualizacji z 4.15.07.0x, musisz zaktualizować narzędzie apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup Aktualizacja
  Aktualizacja dotycząca instalacji usługi apigee-service narzędzie update.sh w katalogu <inst_dir>/apigee/apigee-setup/bin.
Zainstaluj narzędzie apigee-validate. w 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 w w węźle procesora wiadomości, możesz go zaktualizować, korzystając z następującego polecenia:

/opt/apigee/apigee-service/bin/apigee-service apigee-validate
Jednak w przypadku wersji 4.16.05 Apigee zaleca zainstalowanie i uruchomienie procesu weryfikacji Apigee na serwerze zarządzania.
Edytuj plik konfiguracji przekazany do narzędzia apigee-validate. W w poprzedniej wersji Edge plik konfiguracyjny używany przez narzędzie apigee-validate wymagał parametru te 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ąć dwóch innych właściwości.
Uruchom narzędzie do aktualizacji w węzłach w kolejności opisanej poniżej w sekcji „Kolejność maszyn zaktualizuj” poniżej:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
Plik konfiguracji musi być tylko dostępny lub czytelna przez „apigee” użytkownika. Na przykład umieść plik w katalogu /tmp w katalogu do węzła.
Aby określić komponent do aktualizacji, użyj opcji „-c”. Na liście możliwych komponenty obejmują:
- ldap = OpenLDAP
- cs = Cassandra,
- zk = opiekun zoo
- qpid = qpidd
- ps = postgresql
- edge =All Edge komponenty oprócz interfejsu Edge UI: serwer zarządzania, procesor wiadomości, router, serwer QPID, Serwer Postgres
- ui = UI Edge
- all = zaktualizuj wszystkie komponenty na maszynie (używane tylko w przypadku profilu instalacji Edge aio lub API BaaS API Asa) profilu instalacji)
- E = ElasticSearch
- b – stos BaaS API
- p = baaS interfejsu API. Portale
- ebp = ElasticSearch, Stos BaaS API i portal BaaS API w tym samym węźle
Przetestuj aktualizację, uruchamiając narzędzie apigee-validate na serwerze zarządzania zgodnie z opisane w artykule Testowanie instalacji.

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

Kolejność aktualizacji maszyny

Kolejność aktualizowania maszyn podczas instalacji Edge jest ważna. Najbardziej Istotne kwestie dotyczące aktualizacji:

Musisz zaktualizować wszystkie węzły Cassandra i ZooKeeper przed w innych węzłach.
Przed aktualizacją musisz zaktualizować wszystkie węzły qpidd i postgresql Węzły routera i procesora wiadomości.
W przypadku każdego komputera z wieloma składnikami brzegowymi (serwer zarządzania, procesor wiadomości, routera, serwer QPID, serwer Postgres), użyj parametru „-c Edge”. zaktualizować je wszystkie w tym samym czasie, obecnie się znajdujesz.
Jeśli określony krok określa, że powinien być wykonany na wielu maszynach, wykonaj go w określonej kolejności maszyn.
Nie ma osobnego kroku, jak to zrobić. Jest aktualizowana, gdy określisz parametr „-c” Edge” .
Po zaktualizowaniu węzła routera musisz usunąć wszystkie pliki z katalogu /opt/nginx/conf.d, a następnie i ponownie uruchom router.