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

Aktualizacja Apigee Edge od 4.16.01/4.16.05 do 4.18.01

Edge for Private Cloud w wersji 4.18.01

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

Za pomocą tego narzędzia możesz zaktualizować Apigee Edge w wersji 4.16.01.0x i 4.16.05.x do 4.18.01 .

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

Możesz przenieść Apigee Edge w wersji 4.15.07 do 4.16.01.
Jeśli masz wersję Edge starszą niż 4.15.07, musisz najpierw przejść na wersji 4.15.07 i wersji 4.16.01.
- Jeśli przeprowadzasz migrację z Edge w wersji 4.14.04 lub nowszej: przeprowadź migrację bezpośrednio do wersji. 4.15.07.
- Jeśli przeprowadzasz migrację z Edge w wersji 4.14.01: musisz najpierw przeprowadzić migrację do wersji 4.14.04, a następnie przeprowadź migrację do wersji 4.15.07.

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.

Przejście na niższą wersję Zookeeper w przypadku aktualizacji z 4.16.01

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 wersja Zookeeper została zmieniona z powrotem na apigee-zookeeper-3.4.5-0.0.94x. Uniemożliwia to yum uaktualnienie aplikacji Zookeeper do nowszej wersji z wersji 4.16.01. Sposób na poprawienie ta sytuacja to przejście na niższą wersję 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ę.

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.

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.18.01 Proces przywracania, 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.

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) pod adresem http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.

Wymagane do włączenia repozytorium EPEL

Musisz włączyć Dodatkowe pakiety dla Enterprise Linux (lub EPEL) do zainstalowania lub zaktualizowania Edge. Sposób użycia polecenia zależy na używanej wersji RedHat/CentOS:

RedHat/CentOS 7.x:
> wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; obr./min -ivh epel-release-latest-7.noarch.rpm
RedHat/CentOS 6.x:
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; obr./min -ivh epel-release-latest-6.noarch.rpm

Wymagane dodanie SMTPMAILFROM parametr konfiguracji

W Edge 4.17.05 dodano nowy wymagany parametr do pliku konfiguracji używanego po włączeniu serwer SMTP. Jeśli aktualizujesz wersję od wersji 4.17.01, musisz ustawić parametr SMTPMAILFROM w pliku konfiguracji. podczas włączania serwera SMTP.

Interfejs API BaaS w wersji 4.17.09 obsługuje też właściwość SMTPMAILFROM. Podczas aktualizowania interfejsu API BaaS należy ustawić parametr SMTPMAILFROM w .

Ma on postać:

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

Wymagany w przypadku aktualizacji podczas używania uwierzytelnianie zewnętrzne

Możesz zintegrować zewnętrzną usługę katalogową z istniejącą chmurą prywatną Apigee Edge instalacji. Ta funkcja jest przeznaczona do działania z każdą usługą katalogową, która obsługuje protokół LDAP, takich jak Active Directory czy OpenLDAP. Zewnętrzne rozwiązanie LDAP umożliwia system administratorów do zarządzania danymi logowania użytkowników ze scentralizowanej usługi zarządzania katalogami; na zewnątrz systemów, takich jak Apigee Edge, które z nich korzystają.

Zobacz Uwierzytelnianie zewnętrzne Konfiguracja.

Gdy włączone jest uwierzytelnianie zewnętrzne, większość klientów używa konta SAM Active Directory. nazwy użytkownika jako nazwy użytkownika na potrzeby uwierzytelniania, a nie adresu e-mail używanego przez Serwer Edge OpenLDAP.

Jeśli przeprowadzisz integrację z zewnętrzną usługą katalogową, dodaj następujący wiersz do pliku konfiguracyjnego podczas aktualizowania Edge do wersji 4.18.01.

IS_EXTERNAL_AUTH="true"

Ten wiersz konfiguruje Edge tak, aby obsługiwała nazwę konta, a nie adres e-mail, ponieważ nazwa użytkownika.

Wymagane uaktualnienie do Qpid 1.35

Ta wersja zawiera wymaganą aktualizację Qpid 1.35. Podczas aktualizowania węzła Qpid należy: muszą:

Tymczasowo uniemożliwiaj routerom i procesorom wiadomości zapisywanie w węźle Qpid przez blokując port 5672 w węźle Qpid. Aby zablokować ten port, możesz użyć tego polecenia węzeł Qpid:
> sudo iptables -A WEJŚCIE -p tcp --destination-port 5672 ! -s `nazwa hosta` -i eth0 -j DROP
Poczekaj, aż w kolejce Qpid nie ma komunikatów, aby mieć pewność, że węzeł Qpid przetworzył wszystkie wiadomości przed aktualizacją. Użyj poniższego polecenia, aby upewnić się, że kolejka komunikatów Qpid jest puste:
> qpid-stat -q
Zaktualizuj węzeł Qpid.
Odblokuj port 5672 w węźle Qpid, aby umożliwić dostęp z routerów i procesorów wiadomości. Aby odblokować ten port, możesz użyć tego polecenia:
> sudo iptables – F

Pamiętaj, że jeśli używasz adresów IP w innych regułach, możesz użyć opcji -D, by odwrócić określona zmiana:
> sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s `nazwa hosta` -i eth0 -j DROP

Ten proces został szczegółowo opisany poniżej dla każdej topologii Edge.

Wymagane uaktualnienie do Postgres 9.6

Ta wersja Edge zawiera uaktualnienie do Postgres 9.6. W ramach tego uaktualnienia wszystkie Dane Postgres są przenoszone do Postgres 9.6.

Podczas procesu aktualizacji, gdy węzły Postgres nie są aktualizowane, dane analityczne są nadal zapisywane w węzłach Qpid. Po zaktualizowaniu węzłów Postgres i przywróceniu ich online są następnie przekazywane do węzłów Postgres.

Dodatkowy węzeł gotowości Postgres jest wymagany, jeśli trzeba wycofać aktualizację dowolnego . Jeśli musisz wycofać aktualizację, nowy węzeł gotowości Postgres staje się nadrzędnym Węzeł Postgres po wycofaniu zmian. Dlatego po zainstalowaniu nowego węzła gotowości Postgres powinien znajdować się w węźle, który spełnia wszystkie wymagania sprzętowe serwera Postgres, zdefiniowane w Wymagania dotyczące instalacji Edge.

Instalowanie nowego Postgres węzeł gotowości

Ta procedura tworzy w nowym węźle serwer gotowości Postgres. Pamiętaj, aby zainstalować nowy serwer gotowości Postgres dla istniejącej wersji Edge (4.16.01 lub 4.16.05), nie w wersji 4.18.01.

Aby przeprowadzić instalację, użyj tego samego pliku konfiguracyjnego, który został użyty do zainstalowania bieżącej wersji Edge.

Aby utworzyć nowy węzeł gotowości Postgres:

W bieżącym głównym elemencie Postgres zmodyfikuj plik /opt/apigee/customer/application/postgresql.properties aby ustawić poniższy token. Jeśli plik nie istnieje, utwórz go:

conf_pg_hba_replication.connection=host API replikacji existing_slave_ip/32 zaufanie\ \nreplikacja hosta apigee new_slave_ip/32 trust

gdzie existing_slave_ip to adres IP bieżącego Postgres serwer gotowości, a new_slave_ip to adres IP nowego trybu gotowości. do węzła.
Uruchom ponownie apigee-postgresql w masterze Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
Sprawdź, czy nowy węzeł gotowości został dodany, wyświetlając plik /opt/apigee/apigee-postgresql/conf/pg_hba.conf w folderze głównym. W tym pliku powinny być widoczne te wiersze:
apigee replikacji hosta istniejącym_slave_ip/32 trust
apigee replikacji hosta new_slave_ip/32 trust
Zainstaluj nowy serwer gotowości Postgres:
1. Edytuj plik konfiguracyjny użyty do zainstalowania bieżącej wersji Edge, aby określić te:
  
  # adres IP bieżącego wzorzec:
  PG_MASTER=192.168.56.103
  # adres IP nowego węzła gotowości
  PG_STANDBY=192.168.56.102
2. Wyłącz SELinux w sposób opisany w artykule Instalowanie narzędzia Edge apigee-setup.
3. Pobierz plik Edge loadstrap_4.16.05.sh do /tmp/Bootstrap_4.16.05.sh:
  > curl https://software.apigee.com/shoestrap_4.16.05.sh -o /tmp/shoestrap_4.16.05.sh
  
  Uwaga: jeśli aktualizujesz wersję z wersji 4.16.01, pobierz plik Edge bootstrap.sh.
4. zainstalować narzędzie Edge apigee-service, zależności:
  > Sudo Bash /tmp/shoestrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
5. Użyj apigee-service, aby: jak zainstalować apigee-setup narzędzie:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
6. Zainstaluj Postgres:
  > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
7. W nowym węźle gotowości uruchom to polecenie:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
  
  Upewnij się, że jest wyświetlany w trybie gotowości.

Wycofanie Postgres węzeł

Po zakończeniu aktualizacji wyłącz nowy węzeł gotowości:

Sprawdź, czy Postgres jest uruchomiony:
> /opt/apigee/apigee-service/bin/apigee-all status

Jeśli Postgres nie jest uruchomiony, uruchom go:
> /opt/apigee/apigee-service/bin/apigee-all start
Uzyskaj identyfikator UUID nowego węzła gotowości, uruchamiając następujące polecenie cURL na nowym węzeł gotowości:
> curl -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self

Identyfikator UUID węzła powinien być widoczny na końcu danych wyjściowych w formacie:
"typ" : [ "postgres-server" ],
„uUID” : „599e8ebf-5d69-4ae4-aa71-154970a8ec75"
Zatrzymaj nowy węzeł gotowości, uruchamiając na nim to polecenie:
> /opt/apigee/apigee-service/bin/apigee-all stop
W węźle głównym Postgres edytuj plik /opt/apigee/customer/application/postgresql.properties aby usunąć nowy węzeł gotowości z conf_pg_hba_replication.connection:
conf_pg_hba_replication.connection=host API replikacji existing_slave_ip/32 zaufanie
Uruchom ponownie apigee-postgresql w masterze Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
Sprawdź, czy nowy węzeł gotowości został usunięty, wyświetlając plik /opt/apigee/apigee-postgresql/conf/pg_hba.conf w folderze głównym. Powinien być w nim widoczny tylko ten wiersz:
apigee replikacji hosta existing_slave_ip/32 – zaufanie
Usuń identyfikator UUID węzła gotowości z ZooKeeper przez wprowadzenie poniższego zarządzania Edge Wywołanie interfejsu API w węźle serwera zarządzania:
> curl -u sysAdminEmail:password -X USUŃ http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

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ć ta sama, która była używana do instalacji Edge w wersji 4.16.01 lub 4.16.05).

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

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

Jeśli obecnie używasz replikacji instancji głównej Postgres w trybie gotowości, zainstaluj nowy Postgres węzeł gotowości, jak opisano powyżej w sekcji Instalowanie nowego Postgres węzła gotowoś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.
zainstalować yum-utils i yum-plugin-priorities:
> sudo yum install yum-utils
> sudo yum install yum-plugin-priorities
Wyłącz SELinux zgodnie z opisem w sekcji Instalowanie narzędzie Edge apigee-setup.
Włącz repozytorium EPEL w sposób opisany powyżej.
Jeśli instalujesz Oracle 7.x, uruchom to polecenie:
> sudo yum-config-manager --enable ol7_optional_latest
Jeśli instalujesz w AWS, uruchom te polecenia yum-configure-manager:
> mniam aktualizację rh-amazon-rhui-client.noarch
> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-serwer-opcjonalny
Pobierz plik Edge 4.18.01 bootstrap_4.18.01.sh do pliku bootstrap_4.18.01.sh:
> curl https://software.apigee.com/shoestrap_4.18.01.sh -o /tmp/shoestrap_4.18.01.sh
Zainstaluj narzędzie apigee-service w Edge 4.18.01 oraz zależności:
> Sudo Bash /tmp/shoestrap_4.18.01.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: zaktualizuj narzędzie apigee-setup:
1. Jeśli zainstalowano 4.16.01 przez uaktualnienie Edge do wersji 4.15.07.0x, musisz zainstalować narzędzie apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  
  To polecenie instaluje narzędzie update.sh w pliku /opt/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
  
  Ta aktualizacja apigee-service instaluje Narzędzie update.sh w /opt/apigee/apigee-setup/bin.
3. Jeśli wersja 4.16.05 została zainstalowana bezpośrednio lub przez aktualizację, musisz zaktualizować narzędzie apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup aktualizacja
  
  Ta aktualizacja apigee-service instaluje Narzędzie update.sh w /opt/apigee/apigee-setup/bin.
W zależności od bieżącej wersji Edge musisz zainstalować lub zaktualizować narzędzie apigee-validate dla Serwer zarządzania.
1. Jeśli korzystasz obecnie z Edge 4.16.05, zaktualizuj narzędzie apigee-validate Serwer zarządzania:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate
2. Jeśli korzystasz obecnie z Edge 4.16.01: zainstaluj narzędzie apigee-validate Serwer zarządzania:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
  
  Uwaga: jeśli w wiadomości zainstalowano narzędzie apigee-validate Węzeł procesora podczas instalacji wersji 4.16.01, możesz go zaktualizować, korzystając z następującego polecenia na ten węzeł:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  
  Jednak od wersji 4.16.05 i nowszych, Apigee zaleca zainstalowanie i uruchomienie Narzędzie apigee-validate dla serwera zarządzania.
3. Jeśli aktualizujesz wersję z wersji 4.16.01: zmodyfikuj plik konfiguracyjny przekazany do apigee-validate. W w wersji 4.16.01 Edge plik konfiguracji używany przez narzędzie apigee-validate wymagał: 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ąć pozostałe 2 właściwości z pliku.
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.
Jeśli masz zainstalowany nowy węzeł gotowości Postgres, wyłącz go w sposób opisany powyżej w Wyłączanie Postgres .

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

Procedura aktualizacji do wersji 4.18.01 z serwera 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.18.01:

Jeśli obecnie używasz replikacji instancji głównej Postgres w trybie gotowości, zainstaluj nowy Postgres węzeł gotowości, jak opisano powyżej w sekcji Instalowanie nowego Postgres węzła gotowości.
Utwórz lokalne repozytorium 4.18.01 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.16.01 lub 4.16.05, możesz dodać do repozytorium 4.18.01 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.18.01.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.18.01.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.18.01.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.18.01.sh do /tmp/shoestrap_4.18.01.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh -o /tmp/shoestrap_4.18.01.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.18.01.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:
1. Jeśli zainstalowano 4.16.01 przez uaktualnienie Edge do wersji 4.15.07.0x, musisz zainstalować narzędzie apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  
  To polecenie instaluje narzędzie update.sh w pliku /opt/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
  
  Ta aktualizacja apigee-service instaluje Narzędzie update.sh w /opt/apigee/apigee-setup/bin.
3. Jeśli wersja 4.16.05 została zainstalowana bezpośrednio lub przez aktualizację, musisz zaktualizować narzędzie apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup aktualizacja
  
  Ta aktualizacja apigee-service instaluje Narzędzie update.sh w /opt/apigee/apigee-setup/bin.
W zależności od bieżącej wersji Edge musisz zainstalować lub zaktualizować narzędzie apigee-validate dla Serwer zarządzania.
1. Jeśli korzystasz obecnie z Edge 4.16.05, zaktualizuj narzędzie apigee-validate Serwer zarządzania:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate
2. Jeśli używasz Edge w wersji 4.16.01: zainstaluj apigee-validate. na serwerze zarządzania:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
  
  Uwaga: jeśli w wiadomości zainstalowano narzędzie apigee-validate Węzeł procesora podczas instalacji wersji 4.16.01, możesz go zaktualizować, korzystając z następującego polecenia na ten węzeł:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate Aktualizacja
  
  Jednak od wersji 4.16.05 i nowszych, Apigee zaleca zainstalowanie i uruchomienie narzędzie apigee-validate na serwerze zarządzania.
3. Jeśli aktualizujesz wersję z wersji 4.16.01: zmodyfikuj plik konfiguracyjny przekazany do apigee-validate. W w wersji 4.16.01 Edge plik konfiguracji używany przez narzędzie apigee-validate wymagał: 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ąć pozostałe 2 właściwości z pliku.
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.
Jeśli masz zainstalowany nowy węzeł gotowości Postgres, wyłącz go w sposób opisany powyżej w Wyłączanie Postgres .

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

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