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

Zaktualizuj Apigee Edge 4.16.05.x do najnowszej wersji 4.16.05

Edge for Private Cloud w wersji 4.16.05

Niniejszy dokument zawiera procedurę aktualizowania obecnej instalacji w wersji 4.16.05. aby korzystać z najnowszych zasobów RPM i plików pomocniczych Apigee. Ta procedura korzysta z narzędzia update.sh , by przeprowadzić aktualizację.

Które wersje Edge możesz aktualizować do najnowszej wersji 4.16.05,

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

Jeśli korzystasz obecnie z Edge w wersji 4.16.01.0x lub starszej, musisz najpierw przeprowadzić migrację do 4.16.05. Zobacz Aktualizowanie Apigee Edge w wersji 4.16.01 do 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ć.

Wymagania dotyczące miejsca na dysku dla aktualizacji

Przed wykonaniem .

Automatyczne propagacja właściwości ustawienia z wersji 4.16.05.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.

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 uruchomić update.sh. ponownie. Możesz uruchomić aktualizację kilka razy i kontynuować ją od miejsca, w którym została ostatnio przerwana wyłączone.

Jeśli błąd wymaga przywrócenia poprzedniej wersji, zapoznaj się z sekcją 4.16.05 Proces wycofywania zmian.

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 update_username.log.

Jeśli użytkownik nie ma dostępu do pliku /tmp, narzędzie update.sh niepowodzenie.

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 następnej sekcji „Jak ustawić router i procesor wiadomości jako nieosiągalny”.
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.

Tworzenie routera Procesor wiadomości nieosiągalny

W konfiguracji produkcyjnej będziesz mieć wiele routerów i procesorów wiadomości, które pozwolą uzyskać optymalną wydajność i musisz włączyć/wyłączyć osiągalność tych routerów oraz wiadomości Procesory przed aktualizacją i 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 wiadomości lub routera oraz Parametr osiągalny ma wartość prawda lub fałsz.

Jeśli chcesz określić identyfikator UUID routera, użyj następującego polecenia cURL:

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

Jeśli chcesz określić identyfikator UUID procesora wiadomości, użyj poniższego cURL polecenie:

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

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 za pomocą opisanego powyżej wywołania interfejsu API.
  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ą upewnij się, że router jest osią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.05).

Procedura aktualizacji 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 .
Wyczyść wszystkie pamięci podręczne Yum:
> sudo mniam wyczyść wszystko
Pobierz najnowszy plik Edge Boost_4.16.05.sh do pliku /tmp/Bootstrap_4.16.05.sh:
> curl https://software.apigee.com/shoestrap_4.16.05.sh -o /tmp/shoestrap_4.16.05.sh
Zaktualizuj narzędzie Edge apigee-service i 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.
Użyj apigee-service, aby zaktualizować narzędzie apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup aktualizacja

Ta aktualizacja usługi apigee-service instaluje narzędzie update.sh w katalogu /<inst_dir>/apigee/apigee-setup/bin.
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 komponent -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 = Cassandr
- zk = opiekun zoo
- qpid = qpidd
- ps = postgresql
- Edge =Wszystkie komponenty brzegowe z wyjątkiem interfejsu Edge UI: serwer zarządzania, procesor wiadomości, router, Serwer QPID, serwer Postgres
- ui = UI Edge
- wszystko = zaktualizuj wszystkie komponenty na komputerze (używaj tylko w przypadku profilu instalacji Edge aio) lub profil instalacji API BaaS asa)
- E = ElasticSearch
- B = stos BaaS API
- P = Portal BaaS API
- ebp = ElasticSearch, stos BaaS API i portal BaaS API w tym samym węźle
Przetestuj aktualizację za pomocą narzędzia apigee-validate i przetestuj instalację.

Procedura aktualizacji wersji 4.16.05 z lokalnego 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:

Upewnij się, że masz lokalne repozytorium w wersji 4.16.05 opisane w artykule Instalowanie komponentów Edge na .
Zaktualizuj lokalne repozytorium:
1. Pobierz najnowszy plik Edge bootstrap_4.16.05.sh do /tmp/shoestrap_4.16.05.sh:
  curl https://software.apigee.com/shoestrap_4.16.05.sh -o /tmp/shoestrap_4.16.05.sh
2. Przeprowadź synchronizację:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror synchronizacja --only-new-rpms
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 utworzy nowy katalog o nazwie „repos” w katalogu zawierającym pliki .tar . Na przykład /tmp/repos.
4. 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.
5. Wyłącz SELinux zgodnie z opisem w sekcji Instalowanie Edge apigee-setup.
6. 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 w tym poleceniu umieszczasz ścieżkę do katalogu repozytoriów.
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" przy Zainstaluj Komponenty brzegowe w węźle.
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/butytrap_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 z repozytorium.
3. 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.
4. Wyłącz SELinux zgodnie z opisem w sekcji Instalowanie Edge apigee-setup.
5. 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=uNamea pigeepassword=pWord apigeeprotocol=http://
  
  gdzie uName:pWord to nazwa użytkownika i hasło repozytorium.
Jeśli jest obecna, wyłącz wszystkie zadania CRON skonfigurowane pod kątem wykonywania operacji naprawy w Cassandra .
Użyj apigee-service, aby zaktualizować narzędzie apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup aktualizacja

Ta aktualizacja usługi apigee-service instaluje narzędzie update.sh w katalogu <inst_dir>/apigee/apigee-setup/bin.
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 komponent -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 = Cassandr
- zk = opiekun zoo
- qpid = qpidd
- ps = postgresql
- Edge =Wszystkie komponenty brzegowe z wyjątkiem interfejsu Edge UI: serwer zarządzania, procesor wiadomości, router, Serwer QPID, serwer Postgres
- ui = UI Edge
- wszystko = zaktualizuj wszystkie komponenty na komputerze (używaj tylko w przypadku profilu instalacji Edge aio) lub profil instalacji API BaaS asa)
- E = ElasticSearch
- B = stos BaaS API
- P = Portal BaaS API
- ebp = ElasticSearch, stos BaaS API i portal BaaS API w tym samym węźle
Przetestuj aktualizację za pomocą narzędzia apigee-validate – Przetestuj instalację.

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, i ponownie uruchom router.