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

Aktualizacja Apigee Edge od 4.17.01 do 4.17.05

Edge for Private Cloud w wersji 4.17.05

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

Korzystając z tej procedury, możesz zaktualizować Apigee Edge w wersji 4.17.01.0x do 4.17.05.

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

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

Które komponenty musisz zaktualizować

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

Automatyczne propagacja właściwości ustawienia

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

Wymagane dodanie SMTMAILFROM parametr konfiguracji

W Edge 4.17.05 dodano nowy wymagany parametr do pliku konfiguracji używanego po włączeniu serwer SMTP. Musisz teraz ustawić parametr SMTPMAILFROM w pliku konfiguracji podczas włączania serwera SMTP. Ma on postać:

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

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 Kopia zapasowa i Przywróć.
Sprawdzanie, czy przeglądarka Edge działa
Sprawdź, czy podczas aktualizacji przeglądarka Edge jest uruchomiona, korzystając z polecenia:

> /opt/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, przeczytaj artykuł 4.17.05 Proces przywracania wcześniejszej wersji, aby dowiedzieć się więcej.

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 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 w wersji 4.17.01).

Procedura dla aktualizacja do wersji 4.17.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ę do węzła jako root, aby zainstalować 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 narzędzie Edge apigee-setup.
Pobierz plik Edge 4.17.05 bootstrap_4.17.05.sh do pliku bootstrap_4.17.05.sh:
curl https://software.apigee.com/shoestrap_4.17.05.sh -o /tmp/shoestrap_4.17.05.sh
Zainstaluj narzędzie apigee-service w Edge 4.17.05 oraz zależności:
Sudo Bash /tmp/shoestrap_4.17.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ę.
(Tylko CentOS-6.x i RedHat-6.x) We wszystkich węzłach Qpid uruchom następujące polecenie aby pobrać prawidłową wersję Qpid:
> mniam instalację apigee-qpidd --disablerepo=epel
Użyj apigee-service, aby: aktualizowanie pliku apigee-setup narzędzie:
/opt/apigee/apigee-service/bin/apigee-service apigee-setup aktualizacja
Zaktualizuj pole apigee-validate. na serwerze zarządzania:
/opt/apigee/apigee-service/bin/apigee-service apigee-validate
Zaktualizuj apigee-provision narzędzie:
/opt/apigee/apigee-service/bin/apigee-service apigee-provision Aktualizacja
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.

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 =wszystkie komponenty Edge z wyjątkiem interfejsu Edge UI: serwer zarządzania, procesor wiadomości, router, serwer QPID, serwer Postgres
ui = UI Edge
all = zaktualizuj wszystkie komponenty włączone komputer (używaj tylko w przypadku profilu instalacji Edge aio lub instalacji API BaaS asa API profil)
E = ElasticSearch
b = stos BaaS API
p = portal API BaaS
ebp = ElasticSearch, API BaaS Stos 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.17.05 Proces wycofywania.

Procedura aktualizacji do wersji 4.17.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 17.05:

Utwórz lokalne repozytorium 4.17.05 zgodnie z opisem w sekcji „Tworzenie lokalnego repozytorium Apigee” znajdziesz w artykule na temat instalacji narzędzia Edge apigee-setup.
Uwaga: jeśli masz już repozytorium w wersji 4.17.01, możesz dodać wersję 4.17.05 do repozytorium zgodnie z opisem w sekcji „Aktualizowanie lokalnego repozytorium Apigee” artykułu na temat instalacji narzędzia Edge apigee-setup.
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.17.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.17.05.tar.gz
  
  To polecenie utworzy nowy katalog o nazwie „repos” w katalogu zawierającym pliki .tar . Na 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.17.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" na stronie Install the Edge apigee-setup.
2. W węźle zdalnym pobierz plik Edge bootstrap_4.17.05.sh do /tmp/shoestrap_4.17.05.sh:
  /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.05.sh -o /tmp/shoestrap_4.17.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. W węźle zdalnym zainstaluj narzędzie Edge apigee-service i zależności:
  > Sudo Bash /tmp/shoestrap_4.17.05.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: zaktualizuj narzędzie apigee-setup:
/opt/apigee/apigee-service/bin/apigee-service apigee-setup Aktualizacja
Zaktualizuj pole apigee-validate. na serwerze zarządzania.
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate
Zaktualizuj apigee-provision narzędzie:
/opt/apigee/apigee-service/bin/apigee-service apigee-provision Aktualizacja
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.

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 =wszystkie komponenty Edge z wyjątkiem interfejsu Edge UI: serwer zarządzania, procesor wiadomości, router, serwer QPID, serwer Postgres
ui = UI Edge
all = zaktualizuj wszystkie komponenty włączone komputer (używaj tylko w przypadku profilu instalacji Edge aio lub instalacji API BaaS asa API profil)
E = ElasticSearch
b = stos BaaS API
p = portal API BaaS
ebp = ElasticSearch, API BaaS Stos 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.17.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.
W przypadku każdego komputera z wieloma składnikami brzegowymi (serwer zarządzania, procesor wiadomości, routera, serwer QPID, ale nie serwer Postgres), użyj parametru „-c Edge”. zaktualizować je wszystkie na o tej samej nazwie.
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” .
(Tylko CentOS-6.x i RedHat-6.x) We wszystkich węzłach Qpid z upewnij się, że uruchomiono to polecenie, aby pobrać poprawna wersja Qpid jak pokazano powyżej:
> mniam zainstaluj apigee-qpidd --disablerepo=epel