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

Aktualizacja Apigee Edge od 4.16.01/4.16.05 do 4.17.09

Edge for Private Cloud w wersji 4.17.09

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

Aby zaktualizować Apigee Edge z wersji 4.16.01.0x lub 4.16.05.x do wersji 4.17.09, wykonaj tę procedurę.

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

Możesz przenieść Apigee Edge z wersji 4.15.07 do wersji 4.16.01.
Jeśli masz wersję Edge starszą niż 4.15.07, musisz najpierw przejść na wersję 4.15.07, a następnie do 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 migrujesz z wersji Edge 4.14.01: najpierw musisz przejść na wersję 4.14.04, a potem na wersję 4.15.07.

Kto może przeprowadzić aktualizację

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

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

Które komponenty musisz zaktualizować

Musisz zaktualizować wszystkie komponenty Edge. Edge nie obsługuje konfiguracji, która zawiera komponenty pochodzące z różnych wersji.

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

Wersja pakietu 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 przywrócona do apigee-zookeeper-3.4.5-0.0.94x. Zapobiega to uaktualnianiu pakietu Zookeeper do nowszych wersji niż 4.16.01. Aby rozwiązać ten problem, przed zaktualizowaniem Zookeepera uruchom polecenie yum downgrade apigee-zookeeper.

Aby sprawdzić wersję Zookeeper, użyj 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 zmienić subskrypcję na niższą.

automatyczne propagowanie ustawień obiektu,

Jeśli ustawisz jakieś właściwości, edytując pliki .properties w katalogu /opt/apigee/customer/application, te wartości zostaną zachowane podczas aktualizacji.

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 przed aktualizacją zalecamy utworzenie pełnej kopii zapasowej wszystkich węzłów. Aby utworzyć kopię zapasową, skorzystaj z procedury odpowiedniej dla Twojej bieżącej wersji przeglądarki Edge.

Dzięki temu możesz utworzyć plan wykonywania kopii zapasowych na wypadek, gdyby aktualizacja do nowej wersji nie działała prawidłowo. Więcej informacji o kopiach zapasowych znajdziesz w artykule Kopie zapasowe i przywracanie.
Sprawdź, czy Edge działa
Sprawdź, czy Edge działa podczas procesu aktualizacji, używając tego polecenia:

> /opt/apigee/apigee-service/bin/apigee-all status

Rozwiązywanie problemów z nieudaną aktualizacją

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

Jeśli awaria wymaga przywrócenia poprzedniej wersji, zapoznaj się z informacjami na temat procesu przywracania wersji 4.17.09.

Informacje o aktualizacji logów

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 /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 Javy JDK w wersji 8

Ta wersja Edge wymaga zainstalowania na wszystkich węzłach przetwarzania Edge wersji 8 pakietu Java JDK. Możesz zainstalować Oracle JDK 8 lub OpenJDK 8. Jeśli nie masz jeszcze zainstalowanej wersji Java JDK 8, skrypt aktualizacji może ją zainstalować.

W ramach aktualizacji do Java 8 niektóre szyfry TLS nie są już dostępne w Oracle JDK 8. Pełną listę znajdziesz w sekcji „Domyślne wyłączone zestawy szyfrów” na stronie http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.

Wymagane do włączenia repozytorium EPEL

Aby zainstalować lub zaktualizować Edge, musisz włączyć dodatkowe pakiety dla Enterprise Linux (lub EPEL). Wybór zależy od używanej wersji RedHat/CentOS:

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

Wymagane dodanie parametru konfiguracji SMTPMAILFROM

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

W wersji interfejsu API BaaS 4.17.09 dodano też obsługę właściwości SMTPMAILFROM. Podczas aktualizowania usługi BaaS na podstawie interfejsu API musisz ustawić parametr SMTPMAILFROM w pliku konfiguracji.

Ten parametr ma postać:

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

Wymagane, jeśli aktualizujesz dane, gdy używasz uwierzytelniania zewnętrznego

Możesz zintegrować zewnętrzną usługę katalogu z dotychczasową instalacją Apigee Edge Private Cloud. Ta funkcja została zaprojektowana do współpracy z dowolną usługą katalogową obsługującą LDAP, na przykład Active Directory, OpenLDAP i innymi. Zewnętrzne rozwiązanie LDAP umożliwia administratorom zarządzanie danymi logowania użytkowników z poziomu scentralizowanej usługi zarządzania katalogiem, która jest zewnętrzna w stosunku do systemów, takich jak Apigee Edge, które z nich korzystają.

Więcej informacji znajdziesz w artykule Konfigurowanie uwierzytelniania zewnętrznego.

Gdy włączona jest zewnętrzna metoda uwierzytelniania, większość klientów używa pola nazwy konta SAM w Active Directory jako nazwy użytkownika do uwierzytelniania zamiast adresu e-mail używanego przez serwer Edge OpenLDAP.

Jeśli masz zintegrowaną zewnętrzną usługę katalogową, dodaj ten wiersz do pliku konfiguracji podczas aktualizowania Edge do wersji 4.17.09:

IS_EXTERNAL_AUTH="true"

Ten wiersz konfiguruje Edge tak, aby obsługiwał nazwę konta zamiast adresu e-mail jako nazwę użytkownika.

Wymagane uaktualnienie do wersji Qpid 1.35

Ta wersja zawiera wymaganą aktualizację do Qpid 1.35. W ramach aktualizacji węzła Qpid musisz:

Tymczasowo uniemożliwij routerom i procesorom wiadomości zapisywanie w węźle Qpid przez zablokowanie portu 5672 w węźle Qpid. Aby zablokować ten port na węźle Qpid, możesz użyć tego polecenia:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
Poczekaj, aż w kolejce Qpid nie będzie żadnych wiadomości, aby mieć pewność, że węzeł Qpid przetworzył wszystkie komunikaty przed aktualizacją. Aby mieć pewność, że kolejka komunikatów Qpid jest pusta, użyj tego polecenia:
> qpid-stat -q
Zaktualizuj węzeł Qpid.
Odblokuj port 5672 na węźle Qpid, aby umożliwić dostęp z routerów i procesorów wiadomości. Aby odblokować ten port, użyj tego polecenia:
> sudo iptables -F

Jeśli używasz iptables do innych reguł, możesz użyć opcji -D, aby cofnąć konkretną zmianę:
> sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP

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

Wymagane uaktualnienie do Postgres 9.4

Ta wersja przeglądarki Edge zawiera uaktualnienie do Postgresa 9.4. W ramach tej aktualizacji wszystkie dane Postgres są przenoszone do wersji Postgres 9.4.

Podczas procesu aktualizacji, gdy węzły Postgres są niedostępne z powodu aktualizacji, dane analityczne są nadal zapisywane w węzłach Qpid. Gdy węzły Postgres zostaną zaktualizowane i znów będą dostępne online, dane analityczne zostaną przesłane do węzłów Postgres.

Dodatkowy węzeł zapasowy PostgreSQL jest wymagany, jeśli z jakiegokolwiek powodu musisz cofnąć aktualizację. Jeśli trzeba cofnąć aktualizację, nowy węzeł zapasowy PostgreSQL stanie się węzłem głównym PostgreSQL po cofnięciu. Dlatego gdy instalujesz nowy węzeł gotowości Postgres, powinien się on znajdować w węźle, który spełnia wszystkie wymagania sprzętowe serwera Postgres opisane w wymaganiach instalacji Edge.

Instaluję nowy węzeł gotowości Postgres

Ta procedura tworzy serwer zapasowy Postgres na nowym węźle. Upewnij się, że instalujesz nowy serwer zapasowy Postgres dla dotychczasowej wersji Edge (4.16.01 lub 4.16.05), a nie wersji 4.17.09.

Aby przeprowadzić instalację, użyj tego samego pliku konfiguracji, którego użyto do zainstalowania bieżącej wersji Edge.

Aby utworzyć nowy węzeł zapasowy Postgres:

Na bieżącym hoście głównym Postgres otwórz plik /opt/apigee/customer/application/postgresql.properties, aby ustawić ten token. Jeśli taki plik nie istnieje, utwórz go:

conf_pg_hba_replication.connection=host apigee replikacjiexisting_slave_ip/32 trust\ \nreplikacja hosta apigee new_slave_ip/32 zaufania

gdzie obecny adres IP bieżącego serwera gotowości i nowy adres IP gotowości to obecny adres IP bieżącego serwera Posta, istniejący adres IP nowego serwera Posty.
Uruchom ponownie apigee-postgresql na hoście głównym Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
Sprawdź, czy nowy węzeł zapasowy został dodany, wyświetlając plik /opt/apigee/apigee-postgresql/conf/pg_hba.conf na węźle głównym. W tym pliku powinny się pojawić te wiersze:
host replication apigee existing_slave_ip/32 trust
host replication apigee new_slave_ip/32 trust
Zainstaluj nowy serwer gotowości Postgres:
1. Zmień plik konfiguracji, którego użyto do zainstalowania bieżącej wersji Edge, aby określić:
  
  # Adres IP bieżącego serwera głównego:
  PG_MASTER=192.168.56.103
  # Adres IP nowego węzła zapasowego
  PG_STANDBY=192.168.56.102
2. Wyłącz SELinux zgodnie z instrukcjami podanymi w artykule Instalowanie narzędzia apigee-setup w Edge.
3. Pobierz plik bootstrap_4.16.05.sh do folderu /tmp/bootstrap_4.16.05.sh:
  > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
  
  Uwaga: jeśli aktualizujesz z wersji 4.16.01, pobierz plik bootstrap.sh.
4. Zainstaluj narzędzie Edge apigee-service oraz zależności:
  > sudo bash /tmp/shoestrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
5. Użyj polecenia apigee-service, aby zainstalować narzędzie apigee-setup:
  > /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. Na nowym węźle zapasowym uruchom to polecenie:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
  
  Sprawdź, czy jest to węzeł zapasowy.

Wycofywanie z użycia węzła Postgres

Po zakończeniu aktualizacji wycofaj nowy węzeł zapasowy:

Upewnij się, że usługa Postgres działa:
> /opt/apigee/apigee-service/bin/apigee-all status

Jeśli usługa Postgres nie działa, uruchom ją:
> /opt/apigee/apigee-service/bin/apigee-all start
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 Postgresa otwórz plik /opt/apigee/customer/application/postgresql.properties, aby usunąć nowy węzeł zapasowy z conf_pg_hba_replication.connection:
conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust
Uruchom ponownie apigee-postgresql na serwerze głównym Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
Sprawdź, czy nowy węzeł zapasowy został usunięty, otwierając plik /opt/apigee/apigee-postgresql/conf/pg_hba.conf na hoście głównym. W tym pliku powinien znajdować się tylko ten wiersz:
host replication apige existing_slave_ip/32 trust
Usuń identyfikator UUID węzła gotowości z ZooKeeper, wykonując to wywołanie interfejsu Edge Management API w węźle serwera zarządzania:
> curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

Aktualizacja bez przestojów

Aktualizacja bez przestojów (krocząca) umożliwia zaktualizowanie instalacji przeglądarki Edge bez wyłączania jej.

Aktualizacja bez przestojów jest możliwa tylko w konfiguracji z 5 lub większą liczbą węzłów.

Kluczem do uaktualnienia z zerowym czasem przestoju jest usunięcie z systemu równoważenia obciążenia każdego routera pojedynczo. Następnie zaktualizuj Router i wszystkie inne komponenty na tym samym komputerze, a potem ponownie dodaj Router do systemu równoważenia obciążenia.

Zaktualizuj maszyny w odpowiednim porządku w ramach instalacji, jak opisano poniżej w sekcji „Kolejność aktualizacji maszyn”.
Gdy nadejdzie czas aktualizacji routerów, wybierz dowolny router i spraw, aby był niedostępny, zgodnie z opisem w sekcji Włączanie i wyłączanie dostępności serwera (przetwarzacza wiadomości/routera).
Zaktualizuj wybrany router i wszystkie inne komponenty Edge na tym samym komputerze. Wszystkie konfiguracje krawędzi pokazują przełącznik i procesor wiadomości na tym samym węźle.
Spraw, aby router był ponownie dostępny.
Powtórz kroki od 2 do 4 dla pozostałych routerów.
Kontynuuj aktualizację pozostałych maszyn w instalacji.

Przed i po aktualizacji wykonaj te czynności:

W kompleksowym węźle Router i Message Processor:
- Przed aktualizacją:
  1. Ustaw router jako nieosiągalny.
  2. Uniemożliwić dostęp do usługi Message Processor.
- Po aktualizacji wykonaj te czynności:
  1. Upewnij się, że usługa Message Processor jest dostępna.
  2. Upewnij się, że router jest dostępny.
Na jednym węźle Router:
- Przed aktualizacją sprawdź, czy router jest niedostępny.
- Po aktualizacji upewnij się, że router jest osiągalny.
W pojedynczym węźle usługi Message Processor:
- Przed aktualizacją ustaw procesor wiadomości jako nieosiągalny.
- Po aktualizacji upewnij się, że usługa Message Processor jest dostępna.

Używanie pliku konfiguracji w trybie bez powiadamiania

Musisz przekazać poleceniemu update plik konfiguracji w trybie cichym. Plik konfiguracji w trybie cichy powinien być tym samym plikiem, którego użyto do zainstalowania przeglądarki Edge w wersji 4.16.01 lub 4.16.05.

Procedura aktualizacji do wersji 4.17.09 na węźle z zewnętrznym połączeniem z internetem

Aby zaktualizować komponenty Edge w węźle:

Jeśli obecnie używasz replikacji instancji głównej Postgres w trybie gotowości, zainstaluj nowy węzeł gotowości Postgres w sposób opisany powyżej w sekcji Instalowanie nowego węzła gotowości Postgres.
Jeśli są obecne, wyłącz wszystkie zadania cron skonfigurowane w celu wykonania operacji naprawy w Cassandra, dopóki aktualizacja nie zostanie ukończona.
Aby zainstalować RPM-y Edge, zaloguj się na węźle jako użytkownik root.
Uwaga: instalacja RPM wymaga dostępu roota, ale konfigurację Edge można przeprowadzić bez dostępu roota.
Zainstaluj yum-utils i yum-plugin-priorities:
> sudo yum install yum-utils
> sudo yum install yum-plugin-priorities
Wyłącz SELinux w sposób opisany w artykule Instalowanie narzędzia Edge apigee-setup.
Włącz repozytorium EPEL, postępując zgodnie z instrukcjami opisanymi powyżej.
Jeśli instalujesz w AWS, uruchom to polecenie yum-configure-manager:
> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
Pobierz plik bootstrap_4.17.09.sh z Edge 4.17.09 i zapisz go w pliku /tmp/bootstrap_4.17.09.sh:
> curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
Zainstaluj narzędzie apigee-service w wersji 4.17.09 i jego zależności:
> sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord

gdzie uName:pWord to nazwa użytkownika i hasło otrzymane od firmy Apigee. Jeśli pominiesz pWord, pojawi się prośba o jego podanie.

Domyślnie instalator sprawdza, czy zainstalowano środowisko Java 1.8. Jeśli tego nie zrobisz, zostanie ona zainstalowana automatycznie. Użyj opcji JAVA_FIX, aby określić sposób obsługi instalacji Javy. JAVA_FIX przyjmuje te wartości:

I = Zainstaluj OpenJDK 1.8 (domyślnie)
C = Kontynuuj bez instalowania Java
Q = Zamknij. Aby skorzystać z tej opcji, musisz samodzielnie zainstalować Javę.
Użyj polecenia apigee-service, aby zaktualizować narzędzie apigee-setup:
1. Jeśli zainstalowano wersję 4.16.01 przez uaktualnienie wersji Edge 4.15.07.0x, należy zainstalować narzędzie apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  
  To polecenie instaluje narzędzie update.sh w folderze /opt/apigee/apigee-setup/bin.
  
  Jeśli narzędzie apigee-setup jest już zainstalowane, zaktualizuj je:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
2. Jeśli zainstalowano bezpośrednio wersję 4.16.01, co oznacza, że nie przeprowadzono uaktualnienia z wersji 4.15.07.0x, należy zaktualizować narzędzie apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  
  Ta aktualizacja apigee-service instaluje narzędzie update.sh w /opt/apigee/apigee-setup/bin.
3. Jeśli zainstalowano wersję 4.16.05 bezpośrednio lub za pomocą aktualizacji, należy zaktualizować narzędzie apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  
  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 na serwerze zarządzania.
1. Jeśli używasz obecnie Edge 4.16.05: zaktualizuj narzędzie apigee-validate na serwerze zarządzania:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
2. Jeśli używasz wersji 4.16.01 wersji 4.16.01. Zainstaluj to narzędzie apigeegee-validate apigee-validateapigee-validateapigee-validate apigee-validate na serwerze zarządzania serwerem zarządzania. :
  > /opt/apigee/apigee-e-service/bin/apigee-apigee/apigee-e-service/bin/apigee..16.01.
  
  Uwaga:
  
  Uwaga:
  
  Uwaga:: zainstaluj narzędzie apigee.
3. Jeśli aktualizujesz z wersji 4.16.01: zmień plik konfiguracji przekazany do narzędzia apigee-validate. W wersji 4.16.01 Edge plik konfiguracji używany przez 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 te 2 inne właściwości.
Zaktualizuj narzędzie apigee-provision:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
Uruchom narzędzie do aktualizacji na węzłach w kolejności podanej w sekcji „Kolejność aktualizacji maszyn” poniżej:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

Jedynym wymaganiem dotyczącym pliku konfiguracji jest to, że musi on być dostępny lub czytelny dla użytkownika „apigee”.

Aby określić komponent do aktualizacji, użyj opcji „-c”. Lista możliwych komponentów:
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
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 = interfejs Edge UI
all = aktualizacja wszystkich komponentów na maszynie (używaj tylko w przypadku profilu instalacji Edge aio lub profilu instalacji API BaaS)
e = ElasticSearch
b = pakiet API BaaS
p = interfejs API BaaS Portal
ebp = ElasticSearch, pakiet API BaaS i interfejs API BaaS na tym samym węźle
Przetestuj aktualizację, uruchamiając narzędzie apigee-validate na serwerze zarządzania zgodnie z opisem w sekcji Testowanie instalacji.
Jeśli masz zainstalowany nowy węzeł gotowości Postgres, wyłącz go w sposób opisany powyżej w sekcji Wycofywanie węzła Postgres.

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

Procedura aktualizacji do wersji 4.17.09 z repozytorium lokalnego

Jeśli Twoje węzły Edge są za zaporą ogniową lub w inny sposób nie mają dostępu do repozytorium Apigee przez Internet, możesz przeprowadzić aktualizację z repozytorium lokalnego lub lustrzanego repozytorium Apigee.

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

Utwórz plik .tar repozytorium, skopiuj plik .tar do węzła, a następnie zaktualizuj Edge z pliku .tar.
Zainstaluj na węźle serwer WWW z repozytorium lokalnym, aby inne węzły mogły uzyskać do niego dostęp. Apigee udostępnia serwer WWW Nginx, ale możesz też użyć własnego serwera WWW.

Aby zaktualizować z lokalnego repozytorium 4.17.09:

Jeśli używasz obecnie replikacji Postgres master-standby, zainstaluj nowy węzeł Postgres standby zgodnie z opisem w sekcji Instalowanie nowego węzła Postgres standby.
Utwórz lokalne repozytorium 4.17.09 zgodnie z instrukcjami podanymi w sekcji „Tworzenie lokalnego repozytorium Apigee” w artykule Instalowanie narzędzia apigee-setup na platformie Edge.
Uwaga: jeśli masz już repozytorium 4.16.01 lub 4.16.05, możesz dodać do niego repozytorium 4.17.09, postępując zgodnie z instrukcjami podanymi w sekcji „Aktualizowanie lokalnego repozytorium Apigee” w artykule Instalowanie narzędzia do konfiguracji apigee na krawędzi.
Aby zainstalować apige-service z pliku .tar:
1. Na węźle z repozytorium lokalnym uruchom to polecenie, aby spakować repozytorium lokalne do pojedynczego pliku tar o nazwie /opt/apigee/data/apigee-mirror/apigee-4.17.09.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 katalogu /tmp w nowym węźle.
3. W nowym węźle rozpakuj plik do katalogu /tmp:
  > tar -xzf apigee-4.17.09.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 apigee-service i zależne od niego pliki z katalogu /tmp/repos:
  > sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  Upewnij się, że w tym poleceniu podajesz ścieżkę do katalogu repozytoriów.
Aby zainstalować apige-service przy użyciu serwera WWW Nginx:
1. Skonfiguruj serwer WWW Nginx zgodnie z opisem w sekcji „Instalowanie z repozytorium przy użyciu serwera WWW Nginx” w artykule Instalowanie narzędzia Edge apigee-setup.
2. Na węźle zdalnym pobierz plik bootstrap_4.17.09.sh z Edge do pliku /tmp/bootstrap_4.17.09.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
  
  gdzie uName:pWord to nazwa użytkownika i hasło ustawione powyżej dla repozytorium, a remoteRepo to adres IP lub nazwa DNS węzła repozytorium.
3. Na węźle zdalnym zainstaluj narzędzie apigee-service i zależne od niego komponenty:
  > sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  
  gdzie uName:pWord to nazwa użytkownika i hasło do repozytorium.
Użyj polecenia apigee-service, aby zaktualizować narzędzie apigee-setup:
1. Jeśli zainstalowano wersję 4.16.01 przez uaktualnienie wersji Edge 4.15.07.0x, należy zainstalować narzędzie apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  
  To polecenie instaluje narzędzie update.sh w folderze /opt/apigee/apigee-setup/bin.
  
  Jeśli masz już zainstalowane narzędzie apigee-setup, zaktualizuj je:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
2. Jeśli zainstalowano bezpośrednio wersję 4.16.01, co oznacza, że nie przeprowadzono uaktualnienia z wersji 4.15.07.0x, należy zaktualizować narzędzie apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  
  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 update
  
  Ta aktualizacja usługi apigee-service instaluje narzędzie update.sh w /opte-apigee.
W zależności od bieżącej wersji Edge musisz zainstalować lub zaktualizować narzędzie apigee-validate na serwerze zarządzania.
1. Jeśli używasz obecnie Edge 4.16.05: zaktualizuj narzędzie apigee-validate na serwerze zarządzania:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
2. Jeśli obecnie używasz wersji Edge 4.16.01: zainstaluj narzędzie apigee-validate na serwerze zarządzającym:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
  
  Uwaga: jeśli podczas instalowania wersji 4.16.01 zainstalowałeś/aś na węźle procesora wiadomości narzędzie apigee-validate, możesz je zaktualizować, wykonując na tym węźle ten polecenie:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  
  Jednak od wersji 4.16.05 Apigee zaleca instalowanie i uruchamianie narzędzia apigee-validate na serwerze zarządzającym.
3. Jeśli uaktualniasz wersję z wersji 4.16.01: edytuj plik konfiguracyjny przekazany do narzędzia apigee-validate. W wersji 4.16.01 Edge plik konfiguracji używany przez 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 te 2 inne właściwości.
Zaktualizuj narzędzie apigee-provision:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
Uruchom narzędzie do aktualizacji w węzłach w kolejności opisanej poniżej w sekcji „Kolejność aktualizacji maszyny”:
> /opt/apigee/apigee-setup/bin/update.sh -c asset -f configFile

Plik konfiguracji musi być dostępny tylko dla użytkownika „apigee”.

Użyj opcji „-c”, aby określić komponent do zaktualizowania. Lista możliwych komponentów:
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
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 = interfejs Edge UI
all = aktualizacja wszystkich komponentów na maszynie (używaj tylko w przypadku profilu instalacji Edge aio lub profilu instalacji API BaaS)
e = ElasticSearch
b = pakiet API BaaS
p = interfejs API BaaS Portal
ebp = ElasticSearch, pakiet API BaaS i interfejs API BaaS na tym samym węźle
Przetestuj aktualizację, uruchamiając na serwerze zarządzającym narzędzie apigee-validate, zgodnie z opisem w sekcji Testowanie instalacji.
Jeśli zainstalowano nowy zapasowy węzeł Postgresa, wycofaj go z użycia zgodnie z opisem w sekcji Wycofywanie z użycia węzła Postgresa.

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

Kolejność aktualizacji

Ważna jest kolejność aktualizowania maszyn w instalacji Edge. Najważniejsze kwestie związane z aktualizacją to:

Przed zaktualizowaniem innych węzłów musisz zaktualizować wszystkie węzły Cassandra i ZooKeeper.
W przypadku dowolnego komputera z wieloma komponentami Edge (serwer zarządzania, przetwarzanie wiadomości, router, serwer QPID, ale nie 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 maszynach, wykonaj go w określonej kolejności.
Nie ma osobnego kroku, który pozwoliłby zaktualizować sekcję Zarabianie. Jest on aktualizowany, gdy określisz opcję „-c edge”.

Instalacja samodzielna z 1 hostem

Ustaw SMTPMAILFROM w pliku konfiguracji, jeśli włączono SMTP w Edge. Parametr ten ma postać:
SMTPMAILFROM="Moja firma <myco@company.com>"
Jeśli aktualizujesz z wersji 4.16.01, wykonaj downgrade Zookeeper:
> yum downgrade apigee-zookeeper
Zaktualizuj Cassandra i ZooKeeper:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
Ustaw tę regułę iptables:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
Sprawdź kolejkę wiadomości Qpid:
> qpid-stat -q

Sprawdzaj kolejkę, dopóki liczba w kolumnie „msg” nie będzie wynosić 0. Nie możesz uaktualnić Qpid, dopóki nie przetworzy wszystkich wiadomości.
Zaktualizuj qpidd:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
Flush iptables:
> sudo iptables -F
Aktualizacja LDAP:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
Zatrzymaj serwer Postgres, serwer Qpid i PostgreSQL:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
> /opt/apigee/apigeegrese-service/
Zaktualizuj postgresql:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
Zaktualizuj bazę danych Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
Zaktualizuj pozostałe komponenty Edge:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
Aktualizacja interfejsu Edge:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Samodzielna instalacja na 2 hostach

Aby zobaczyć listę topologii Edge i numerów węzłów, zapoznaj się z artykułem Topologie instalacji.

Jeśli masz włączone SMTP w Edge, w pliku konfiguracji ustaw parametr SMTPMAILFROM. Parametr ten ma postać:
SMTPMAILFROM="Moja firma <myco@company.com>"
W przypadku aktualizacji z wersji 4.16.01 zmniejsz rolę Zookeeper na komputerze 1:
> yum down apigee-zookeeper
Zaktualizuj Cassandra i ZooKeeper na maszynie 1:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
Ustaw tę regułę iptables na komputerze 2:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `nazwa hosta` -i eth0 -j DROP
Sprawdź kolejkę komunikatów Qpid na maszynie 2:
> qpid-stat -q

Sprawdzaj kolejkę, aż liczba w kolumnie „msg” będzie równa 0. Nie możesz uaktualnić Qpid, dopóki nie przetworzy wszystkich wiadomości.
Zaktualizuj plik qpidd na komputerze 2:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
Wyczyść ustawienia iptables na komputerze 2:
> sudo iptables -F
Zaktualizuj LDAP na komputerze 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
Zaktualizuj komponenty Edge na maszynie 1:
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
Aktualizacja interfejsu użytkownika na komputerze 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
Zaktualizuj postgresql na maszynie 2:
1. Zatrzymaj serwer Postgres, serwer Qpid i postgresql:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
  > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
2. Zaktualizuj postgresql:
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
3. Zaktualizuj bazę danych Postgres:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
4. Zaktualizuj komponenty Edge na maszynie 2 i 1:
  > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Zaktualizuj komponenty Edge na maszynie 2:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

W przypadku klastrowanej instalacji z 5 hostami

Aby zobaczyć listę topologii Edge i numerów węzłów, zapoznaj się z artykułem Topologie instalacji.

Jeśli masz włączone SMTP w Edge, w pliku konfiguracji ustaw parametr SMTPMAILFROM. Parametr ten ma postać:
SMTPMAILFROM="Moja firma <myco@company.com>"
Upewnij się, że masz zainstalowany nowy węzeł zapasowy Postgres zgodnie z opisem w sekcji Instalowanie nowego węzła zapasowego Postgres.
W przypadku aktualizacji z wersji 4.16.01 zmień wersję Zookeeper na Macine 1, 2 i 3:
> yum down apigee-zookeeper
Zaktualizuj Cassandra i ZooKeeper na maszynach 1, 2 i 3:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
Ustaw na maszynie 4 tę regułę iptables:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
Sprawdź kolejkę wiadomości Qpid na maszynie 4:
> qpid-stat -q

Sprawdzaj kolejkę, aż liczba w kolumnie „msg” będzie równa 0. Nie możesz uaktualnić Qpid, dopóki nie przetworzy wszystkich wiadomości.
Zaktualizuj qpidd na maszynie 4:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
Wyczyść iptables na maszynie 4:
> sudo iptables -F
Powtórz kroki 5–8 na komputerze 5.
Zaktualizuj LDAP na maszynie 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
Zaktualizuj komponenty Edge na maszynach 1, 2 i 3:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Zaktualizuj interfejs użytkownika na maszynie 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
Aktualizacja maszyn 4 i 5:
1. Zatrzymaj serwer Postgres i serwer Qpid na komputerze 4:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
  > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
2. Zatrzymaj serwer Postgres, serwer Qpid i postgresql na maszynie 5:
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
  > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stopge
  /opte/postapigegee
3. Zatrzymaj serwer Postgres i postgresql na nowym węźle zapasowym dodany do rollbacka:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
4. Zaktualizuj postgresql na maszynach 4:
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
5. Zaktualizuj bazę danych Postgres na maszynie 4 (tylko w przypadku głównej bazy danych Postgres):
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
6. Aktualizacja postgresql na maszynach 5:
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
7. Uruchom serwer Postgres i serwer Qpid na maszynach 4 i 5:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
  > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
8. Skonfiguruj Postgres jako węzeł zapasowy, wykonując te polecenia na maszynie 5:
  > cd /opt/apigee/data/apigee-postgresql/pgdata
  > rm -rf *
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
9. Sprawdź stan replikacji, uruchamiając poniższe skrypty na obu serwerach. System powinien wyświetlać identyczne wyniki na obu serwerach, aby zapewnić prawidłową replikację:
  
  Na maszynie 4, która jest węzłem głównym, uruchom:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
  
  Sprawdź, czy jest to węzeł główny.
  
  Węzeł gotowości na komputerze 5:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
  
  Sprawdź, czy mówi się, że jest w trybie gotowości.
Aktualizacja komponentów Edge na maszynach 4 i 5:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Upewnij się, że wycofujesz z użycia nowy węzeł zapasowy, wykonując procedurę opisaną powyżej w sekcji Wycofywanie z użycia węzła PostgreSQL.

Instalacja z 9 hostami w klastrze

Listę topologii Edge i numerów węzłów znajdziesz w artykule Topologie instalacji.

Jeśli masz włączone SMTP w Edge, w pliku konfiguracji ustaw parametr SMTPMAILFROM. Ten parametr ma postać:
SMTPMAILFROM="Moja firma <mojaco@firma.com>"
Upewnij się, że masz zainstalowany nowy węzeł zapasowy Postgres zgodnie z opisem w sekcji Instalowanie nowego węzła zapasowego Postgres.
Jeśli aktualizujesz z wersji 4.16.01, wykonaj downgrade Zookeepera na maszynach 1, 2 i 3:
> yum downgrade apigee-zookeeper
Zaktualizuj Cassandra i ZooKeeper na maszynach 1, 2 i 3:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
Ustaw tę regułę iptables na komputerze 6:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `nazwa hosta` -i eth0 -j DROP
Sprawdź kolejkę komunikatów Qpid na maszynie 6:
> qpid-stat -q

Sprawdzaj kolejkę, aż liczba w kolumnie „msg” będzie równa 0. Nie możesz uaktualnić systemu Qpid, dopóki nie przetworzy on wszystkich wiadomości.
Zaktualizuj qpidd na maszynie 6:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
Wyczyść ustawienia iptables na maszynie 6:
> sudo iptables -F
Powtórz kroki 5–8 na maszynie 7.
Zaktualizuj LDAP na maszynie 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
Zaktualizuj komponenty Edge na maszynach 6, 7, 1, 4 i 5 w podanej kolejności:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Aktualizacja interfejsu użytkownika na komputerze 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
Zaktualizuj maszyny 8 i 9:
1. Zatrzymanie serwera Postgres na maszynie 8:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
2. Zatrzymaj serwer Postgres i postgresql na maszynie 9:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
3. Zatrzymaj serwer Qpid na maszynach 6 i 7:
  > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
4. Zatrzymaj serwer Postgres i postgresql na nowym węźle zapasowym dodany do rollbacka:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
5. Zaktualizuj postgresql na maszynach 8:
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
6. Zaktualizuj bazę danych Postgres na maszynie 8 (tylko w przypadku głównego serwera Postgres):
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
7. Aktualizacja postgresql na maszynach 9:
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
8. Uruchom serwer Postgres na maszynach 8 i 9:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
9. Uruchom serwer Qpid na maszynach 6 i 7:
  > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
10. Skonfiguruj Postgres jako węzeł zapasowy, wykonując te polecenia na maszynie 9:
  > cd /opt/apigee/data/apigee-postgresql/pgdata
  > rm -rf *
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
11. Sprawdź stan replikacji, wykonując te skrypty na obu serwerach. System powinien wyświetlać identyczne wyniki na obu serwerach, aby zapewnić prawidłową replikację:
  Na maszynie 8, która jest węzłem głównym, uruchom:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
  
  Sprawdź, czy jest to węzeł główny.
  
  Na maszynie 9, węzeł zapasowy:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
  
  Sprawdź, czy jest to węzeł zapasowy.
Zaktualizuj komponenty Edge na maszynach 8 i 9:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Pamiętaj o wyłączeniu nowego węzła gotowości, wykonując czynności opisane powyżej w sekcji Wycofywanie węzła Postgres.

Instalacja z 13 hostami w klastrze

Listę topologii Edge i numerów węzłów znajdziesz w artykule Topologie instalacji.

Ustaw SMTPMAILFROM w pliku konfiguracji, jeśli włączono SMTP w Edge. Ten parametr ma postać:
SMTPMAILFROM="Moja firma <mojaco@firma.com>"
Upewnij się, że masz zainstalowany nowy węzeł zapasowy Postgres zgodnie z opisem w sekcji Instalowanie nowego węzła zapasowego Postgres.
Jeśli aktualizujesz z wersji 4.16.01, wykonaj downgrade Zookeepera na maszynach 1, 2 i 3:
> yum downgrade apigee-zookeeper
Zaktualizuj Cassandra i ZooKeeper na komputerze 1, 2 i 3:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
Ustaw na maszynie 12 tę regułę iptables:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
Sprawdź kolejkę wiadomości Qpid na maszynie 12:
> qpid-stat -q

Kontynuuj sprawdzanie kolejki, aż liczba w kolumnie „msg” będzie wynosić 0. Nie możesz uaktualnić Qpid, dopóki nie przetworzy wszystkich wiadomości.
Zaktualizuj qpidd na maszynie 12:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
Wyczyść iptables na maszynie 12:
> sudo iptables -F
Powtórz kroki 5–8 na komputerze 13.
Zaktualizuj LDAP na maszynach 4 i 5:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
Zaktualizuj komponenty Edge na maszynach 12, 13, 6, 7, 10 i 11 w podanej kolejności:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Zaktualizuj interfejs użytkownika na komputerze 6 i 7:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
Zaktualizuj maszyny 8 i 9:
1. Zatrzymanie serwera Postgres na maszynie 8:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
2. Zatrzymaj serwer Postgres i postgresql na maszynie 9:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
3. Zatrzymaj serwer Qpid na maszynach 12 i 13:
  > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
4. Zatrzymaj serwer Postgres i postgresql na nowym węźle zapasowym dodany do rollbacka:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
5. Zaktualizuj postgresql na maszynach 8:
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
6. Zaktualizuj bazę danych Postgres na maszynie 8 (tylko w przypadku głównego serwera Postgres):
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
7. Aktualizacja postgresql na maszynach 9:
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
8. Uruchom serwer Postgres na komputerach 8 i 9:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
9. Uruchom serwer Qpid na maszynach 12 i 13:
  > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
10. Skonfiguruj Postgres jako węzeł zapasowy, wykonując te polecenia na maszynie 9:
  > cd /opt/apigee/data/apigee-postgresql/pgdata
  > rm -rf *
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
11. Sprawdź stan replikacji, wykonując te skrypty na obu serwerach. System powinien wyświetlać identyczne wyniki na obu serwerach, aby zapewnić prawidłową replikację:
  Na maszynie 8, która jest węzłem głównym, uruchom:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
  
  Sprawdź, czy jest to węzeł główny.
  
  Na maszynie 9, węzeł zapasowy:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
  
  Sprawdź, czy jest to węzeł zapasowy.
Zaktualizuj komponenty Edge na maszynach 8 i 9:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Upewnij się, że wycofujesz z użycia nowy węzeł zapasowy, wykonując procedurę opisaną powyżej w sekcji Wycofywanie z użycia węzła PostgreSQL.

W przypadku instalacji z 12 hostami w klastrze

Aby zobaczyć listę topologii Edge i numerów węzłów, zapoznaj się z artykułem Topologie instalacji.

Jeśli masz włączone SMTP w Edge, w pliku konfiguracji ustaw parametr SMTPMAILFROM. Parametr ten ma postać:
SMTPMAILFROM="Moja firma <myco@company.com>"
Upewnij się, że masz zainstalowany nowy węzeł zapasowy Postgres zgodnie z opisem w sekcji Instalowanie nowego węzła zapasowego Postgres.
Zaktualizuj Cassandra i ZooKeeper:
1. Jeśli aktualizujesz z wersji 4.16.01, wykonaj downgrade Zookeepera na maszynach 1, 2 i 3 w Data Center 1:
  > yum downgrade apigee-zookeeper
2. Na komputerach 1, 2 i 3 w Centrum danych 1:
  > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. Jeśli aktualizujesz z wersji 4.16.01, wykonaj downgrade Zookeepera na maszynach 7, 8 i 9 w Data Center 2:
  > yum downgrade apigee-zookeeper
4. Na maszynach 7, 8 i 9 w centrum danych 2
  > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
Zaktualizuj qpidd:
1. Maszyny 4, 5 w centrum danych 1
  1. Ustaw na maszynie 4 tę regułę iptables:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  2. Sprawdź kolejkę wiadomości Qpid na maszynie 4:
    > qpid-stat-q
    
    Kontynuuj sprawdzanie kolejki, aż liczba w kolumnie „msg” będzie równa 0. Nie możesz uaktualnić Qpid, dopóki nie przetworzy wszystkich wiadomości.
  3. Zaktualizuj qpidd na maszynie 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Wyczyść iptables na maszynie 4:
    > sudo iptables -F
  5. Powtórz kroki 1–4 na komputerze 5.
2. Maszyny 10 i 11 w centrum danych 2
  1. Ustaw tę regułę iptables na komputerze 10:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  2. Sprawdź kolejkę komunikatów Qpid na komputerze 10:
    > qpid-stat -q
    
    Sprawdzaj kolejkę, aż liczba w kolumnie „msg” wyniesie 0. Nie możesz uaktualnić systemu Qpid, dopóki nie przetworzy on wszystkich wiadomości.
  3. Zaktualizuj qpidd na maszynie 10:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. Wyczyść iptables na maszynie 10:
    > sudo iptables -F
  5. Powtórz kroki 1–4 na komputerze 11.
Zaktualizuj LDAP:
1. Machines 1 w Data Center 1
  > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
2. Machines 7 w centrum danych 2
  > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
Zaktualizuj komponenty Edge:
1. Maszyny 4, 5, 1, 2, 3 w centrum danych 1
  > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
2. Maszyny 10, 11, 7, 8, 9 w Centrum danych 2
  > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
Aktualizacja interfejsu:
1. Maszyna 1 w Centrum danych 1:
  > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
2. Maszyna 7 w centrum danych 2:
  > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
Zaktualizuj maszynę 6 w Centrum danych 1 i 12 w Centrum danych 2:
1. Zatrzymanie serwera Postgres na maszynie 6:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
2. Zatrzymaj serwer Postgres i postgresql na maszynie 12:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
3. Zatrzymaj serwer Qpid na maszynach 4, 5, 10 i 11:
  > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
4. Zatrzymaj serwer Postgres i postgresql na nowym węźle zapasowym dodany do rollbacka:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
5. Zaktualizuj postgresql na maszynach 6:
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
6. Zaktualizuj bazę danych Postgres na maszynie 6 (tylko w przypadku głównego serwera Postgres):
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
7. Zaktualizuj postgresql na maszynach 12:
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
8. Uruchom serwer Postgres na komputerach 6 i 12:
  > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
9. Uruchom serwer Qpid na maszynach 4, 5, 10 i 11:
  > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
10. Skonfiguruj Postgres jako węzeł zapasowy, wykonując te polecenia na maszynie 12:
  > cd /opt/apigee/data/apigee-postgresql/pgdata
  > rm -rf *
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
11. Sprawdź stan replikacji, wykonując te skrypty na obu serwerach. Aby replikacja przebiegła pomyślnie, system powinien wyświetlać identyczne wyniki na obu serwerach:
  Na maszynie 6 (węźle głównym) uruchom polecenie:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
  
  Sprawdź, czy wskazuje ona, że jest to węzeł nadrzędny.
  
  Na maszynie 12, węzeł zapasowy:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
  
  Sprawdź, czy jest to węzeł zapasowy.
Zaktualizuj komponenty Edge na maszynach 6 i 12:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Upewnij się, że wycofujesz z użycia nowy węzeł zapasowy, wykonując procedurę opisaną powyżej w sekcji Wycofywanie z użycia węzła PostgreSQL.

Instalacja interfejsu BaaS API z 7 lub 10 hostami

W przypadku instalacji niestandardowej

Jeśli masz instalację niestandardową, zaktualizuj komponenty Edge w tej kolejności:

ZooKeeper
Cassandra
qpidd
LDAP
Edge, czyli profil „-c edge” na wszystkich węzłach w kolejności: węzły z serwerem Qpid, ale nie z serwerem Postgres, serwer Management, przetwarzacz wiadomości i router.
Uwaga: jeśli w węźle jest zainstalowany zarówno serwer Qpid, jak i serwer Postgres, w kroku 8 uruchom krok profilu „-c Edge”.
Interfejs Edge
postgresql na serwerze głównym Postgres, w tym uaktualnienia.
postgresql na zapasowej instancji Postgres.
Edge, czyli profil „-c Edge” we wszystkich połączonych węzłach Qpid i Postgres lub w dowolnych węzłach Postgres.