Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Aktualizacja Apigee Edge od 4.16.01/4.16.05 do 4.17.05

Edge dla chmury prywatnej w wersji 4.17.05

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

Za pomocą tej procedury możesz zaktualizować Apigee Edge w wersji 4.16.01.0x i 4.16.05.x do wersji 4.17.05.

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

Możesz przenieść Apigee Edge w 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 na wersję 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 do wersji 4.15.07.

Kto może przeprowadzić aktualizację

Użytkownik, który przeprowadza aktualizację, powinien być tym samym użytkownikiem, który pierwotnie zainstalował Edge, lub użytkownikiem z uprawnieniami administratora.

Po zainstalowaniu pakietó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 zawierającej komponenty z wielu wersji.

Przechodzenie na starszą wersję ZooKeepera w przypadku aktualizacji z wersji 4.16.01

Wersja pakietu RPM ZooKeeper w Edge dla chmury prywatnej 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. Zapobiega to uaktualnianiu ZooKeepera przez yum do wersji nowszych niż 4.16.01. Aby rozwiązać ten problem, przed zaktualizowaniem ZooKeepera uruchom polecenie yum downgrade apigee-zookeeper.

Wersję ZooKeepera możesz sprawdzić za pomocą 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 przejść na niższą wersję.

Automatyczne rozpowszechnianie ustawień usługi

Jeśli ustawiono jakieś właściwości przez edycję plików .properties w /opt/apigee/customer/application, te wartości zostaną zachowane podczas aktualizacji.

Wymagania wstępne dotyczące aktualizacji

Przed uaktualnieniem Apigee Edge spełnij te wymagania wstępne:

Utwórz kopię zapasową wszystkich węzłów
Przed aktualizacją zalecamy ze względów bezpieczeństwa utworzenie pełnej kopii zapasowej wszystkich węzłów. Aby wykonać kopię zapasową, postępuj zgodnie z procedurą dla bieżącej wersji Edge.

Dzięki temu będziesz mieć plan awaryjny na wypadek, gdyby aktualizacja do nowej wersji nie działała prawidłowo. Więcej informacji o kopiach zapasowych znajdziesz w artykule Tworzenie i przywracanie kopii zapasowych.
Upewnij się, że Edge działa
Upewnij się, że Edge działa podczas procesu aktualizacji, używając polecenia:

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

Postępowanie w przypadku nieudanej aktualizacji

Jeśli aktualizacja się nie powiedzie, możesz spróbować rozwiązać problem, a następnie ponownie uruchomić skrypt update.sh. Możesz uruchomić aktualizację wielokrotnie, a będzie ona kontynuowana od miejsca, w którym została przerwana.

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

Rejestrowanie informacji o aktualizacji

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

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

Jeśli użytkownik, który uruchamia narzędzie update.sh, nie ma dostępu do tego katalogu, dziennik jest zapisywany w katalogu /tmp jako plik o nazwie update_username.log.

Jeśli użytkownik nie ma dostępu do katalogu /tmp, narzędzie update.sh nie zadziała.

Wymagane uaktualnienie do wersji 8 pakietu Java JDK

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

W ramach aktualizacji do Javy 8 niektóre mechanizmy szyfrowania TLS nie są już dostępne w Oracle JDK 8. Pełną listę znajdziesz w sekcji „Default Disabled Cipher Suites” 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ć Extra Packages for Enterprise Linux (EPEL). Polecenie, którego użyjesz, zależy od wersji RedHat/CentOS:

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
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. Podczas włączania serwera SMTP musisz teraz ustawić SMTPMAILFROM w pliku konfiguracji. Ten parametr ma postać:

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

Przed przeprowadzeniem aktualizacji dodaj ten parametr do pliku konfiguracji.

Wymagane w przypadku aktualizacji przy użyciu uwierzytelniania zewnętrznego

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

Więcej informacji znajdziesz w sekcji Topologie instalacji.

Gdy uwierzytelnianie zewnętrzne jest włączone, większość klientów używa pola nazwy konta SAM Active Directory jako nazwy użytkownika do uwierzytelniania, zamiast adresu e-mail, który jest używany przez serwer Edge OpenLDAP.

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

IS_EXTERNAL_AUTH="true"

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

Wymagane uaktualnienie do Qpid 1.35

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

tymczasowo uniemożliwić routerom i procesorom komunikatów zapisywanie w węźle Qpid przez zablokowanie portu 5672 w węźle Qpid; Aby zablokować ten port w 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ż kolejka Qpid zostanie opróżniona z wiadomości, aby mieć pewność, że węzeł Qpid przetworzył wszystkie wiadomości przed aktualizacją. Aby upewnić się, że kolejka wiadomości Qpid jest pusta, użyj tego polecenia:
> 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 komunikatów. Aby odblokować ten port, możesz użyć 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 jest szczegółowo opisany poniżej dla każdej topologii Edge.

Wymagane uaktualnienie do Postgres 9.4

Ta wersja Edge obejmuje uaktualnienie do Postgres 9.4. W ramach tego uaktualnienia wszystkie dane Postgres są przenoszone do Postgres 9.4.

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

Dodatkowy węzeł rezerwowy Postgres jest wymagany, jeśli z jakiegoś powodu musisz wycofać aktualizację. Jeśli musisz wycofać aktualizację, po wycofaniu nowy węzeł rezerwowy Postgres stanie się węzłem głównym Postgres. Dlatego podczas instalowania nowego węzła rezerwowego Postgres powinien on znajdować się w węźle, który spełnia wszystkie wymagania sprzętowe serwera Postgres, zgodnie z definicją w wymaganiach instalacji Edge.

Instalowanie nowego węzła rezerwowego Postgres

Ta procedura tworzy serwer rezerwowy Postgres na nowym węźle. Upewnij się, że instalujesz nowy serwer rezerwowy Postgres dla istniejącej wersji Edge (4.16.01 lub 4.16.05), a nie dla wersji 4.17.05.

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

Aby utworzyć nowy węzeł rezerwowy Postgres:

On the current Postgres master, edit the /opt/apigee/customer/application/postgresql.properties file to set the following token. Jeśli ten plik nie istnieje, utwórz go:

conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust\ \nhost replication apigee new_slave_ip/32 trust

gdzie existing_slave_ip to adres IP bieżącego serwera rezerwowego Postgres, a new_slave_ip to adres IP nowego węzła rezerwowego.
Uruchom ponownie apigee-postgresql na serwerze głównym Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
Sprawdź, czy nowy węzeł rezerwowy został dodany, wyświetlając plik /opt/apigee/apigee-postgresql/conf/pg_hba.conf na węźle głównym. W tym pliku powinny znajdować się te wiersze:
host replication apigee existing_slave_ip/32 trust
host replication apigee new_slave_ip/32 trust
Zainstaluj nowy serwer rezerwowy Postgres:
1. Edytuj plik konfiguracji użyty do zainstalowania bieżącej wersji Edge, aby określić te informacje:
  
  # adres IP bieżącego mastera:
  PG_MASTER=192.168.56.103
  # adres IP nowego węzła rezerwowego
  PG_STANDBY=192.168.56.102
2. Wyłącz SELinux zgodnie z opisem w artykule Instalowanie narzędzia apigee-setup w Edge.
3. Pobierz plik Edge bootstrap_4.16.05.sh do /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 Edge bootstrap.sh.
4. Zainstaluj narzędzie Edge apigee-service i zależności:
  > sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
5. Użyj 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 rezerwowym uruchom to polecenie:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
  
  Sprawdź, czy jest on oznaczony jako rezerwowy.

Wycofanie węzła Postgres

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

Sprawdź, czy Postgres działa:
> /opt/apigee/apigee-service/bin/apigee-all status

Jeśli Postgres nie działa, uruchom go:
> /opt/apigee/apigee-service/bin/apigee-all start
Pobierz identyfikator UUID nowego węzła rezerwowego, uruchamiając na nim to polecenie cURL:
> 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 takiej postaci:
"type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
Zatrzymaj nowy węzeł rezerwowy, uruchamiając na nim to polecenie:
> /opt/apigee/apigee-service/bin/apigee-all stop
Na węźle głównym Postgres zmodyfikuj plik /opt/apigee/customer/application/postgresql.properties, aby usunąć nowy węzeł rezerwowy 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ł rezerwowy został usunięty, wyświetlając plik /opt/apigee/apigee-postgresql/conf/pg_hba.conf na węźle głównym. W tym pliku powinien być widoczny tylko ten wiersz:
host replication apigee existing_slave_ip/32 trust
Usuń identyfikator UUID węzła rezerwowego z ZooKeeper, wykonując to wywołanie interfejsu API zarządzania Edge 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, czyli aktualizacja krocząca, umożliwia aktualizację instalacji Edge bez wyłączania Edge.

Aktualizacja bez przestojów jest możliwa tylko w przypadku konfiguracji z co najmniej 5 węzłami.

Kluczem do uaktualnienia bez przestojów jest usuwanie z systemu równoważenia obciążenia po jednym routerze naraz. Następnie zaktualizuj router i inne komponenty na tej samej maszynie co router, a potem dodaj router z powrotem do systemu równoważenia obciążenia.

Zaktualizuj maszyny w odpowiedniej kolejności, zgodnie z opisem w sekcji „Kolejność aktualizacji maszyn” poniżej.
Gdy nadejdzie czas aktualizacji routerów, wybierz dowolny router i ustaw go jako nieosiągalny, jak opisano w artykule Włączanie i wyłączanie osiągalności serwera (procesora komunikatów lub routera).
Zaktualizuj wybrany router i wszystkie inne komponenty Edge na tym samym komputerze co router. Wszystkie konfiguracje Edge pokazują router i procesor komunikatów w tym samym węźle.
Spraw, aby router był ponownie dostępny.
Powtórz kroki od 2 do 4 w przypadku pozostałych routerów.
Kontynuuj aktualizację pozostałych maszyn w instalacji.

Przed aktualizacją lub po niej wykonaj te czynności:

Na węźle połączonego routera i procesora komunikatów:
- Przed aktualizacją wykonaj te czynności:
  1. Ustaw router jako niedostępny.
  2. Spraw, aby procesor komunikatów był nieosiągalny.
- Po aktualizacji wykonaj te czynności:
  1. Udostępnij procesor komunikatów.
  2. Ustaw router jako dostępny.
Na pojedynczym węźle routera:
- Przed aktualizacją upewnij się, że router jest niedostępny.
- Po aktualizacji upewnij się, że router jest dostępny.
Na pojedynczym węźle procesora komunikatów:
- Przed aktualizacją ustaw procesor komunikatów jako nieosiągalny.
- Po aktualizacji udostępnij procesor komunikatów.

Używanie pliku konfiguracji instalacji dyskretnej

Do polecenia aktualizacji musisz przekazać plik konfiguracji instalacji dyskretnej. Plik konfiguracji instalacji dyskretnej powinien być taki sam jak ten, który został użyty do zainstalowania Edge 4.16.01 lub 4.16.05.

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

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

Jeśli obecnie używasz replikacji Postgres master-standby, zainstaluj nowy węzeł rezerwowy Postgres zgodnie z opisem powyżej w sekcji Instalowanie nowego węzła rezerwowego Postgres.
Jeśli istnieją zadania CRON skonfigurowane do wykonywania operacji naprawy w Cassandra, wyłącz je do czasu zakończenia aktualizacji.
Zaloguj się w węźle jako użytkownik root, aby zainstalować pakiety RPM Edge.
Uwaga: instalacja RPM wymaga dostępu do konta root, ale konfigurację Edge można przeprowadzić bez niego.
Wyłącz SELinux zgodnie z opisem w artykule Instalowanie narzędzia Edge apigee-setup.
Pobierz plik Edge 4.17.05 bootstrap_4.17.05.sh do /tmp/bootstrap_4.17.05.sh:
> curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
Zainstaluj narzędzie apigee-service Edge 4.17.05 i zależności:
> sudo bash /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord

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

Domyślnie instalator sprawdza, czy masz zainstalowaną Javę 1.8. Jeśli nie, zainstaluje ją za Ciebie. Aby określić, jak ma być obsługiwana instalacja Javy, użyj opcji JAVA_FIX. JAVA_FIX przyjmuje te wartości:

I = zainstaluj OpenJDK 1.8 (domyślnie)
C = kontynuuj bez instalowania Javy
Q = zamknij. W przypadku tej opcji musisz samodzielnie zainstalować Javę.
(tylko CentOS-6.x i RedHat-6.x) Na wszystkich węzłach Qpid uruchom to polecenie, aby pobrać prawidłową wersję Qpid:
> yum install apigee-qpidd --disablerepo=epel
Użyj apigee-service, aby zaktualizować narzędzie apigee-setup:
1. Jeśli wersja 4.16.01 została zainstalowana przez uaktualnienie Edge w 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 katalogu /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 wersja 4.16.01 została zainstalowana bezpośrednio, czyli nie przeprowadzono uaktualnienia z wersji 4.15.07.0x, musisz 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 katalogu /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 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 obecnie używasz Edge 4.16.01: zainstaluj narzędzie apigee-validate na serwerze zarządzania:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
  
  Uwaga: jeśli podczas instalowania wersji 4.16.01 narzędzie apigee-validate zostało zainstalowane na węźle procesora komunikatów, możesz je zaktualizować, używając tego polecenia na tym węźle:
  > /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ądzania.
3. Jeśli uaktualniasz wersję 4.16.01: zmodyfikuj plik konfiguracji przekazany do narzędzia apigee-validate. In the 4.16.01 Edge release, the config file used by apigee-validate required the following properties:
  APIGEE_ADMINPW=sysAdminPword
  MP_POD=gateway
  REGION=dc-1
  
  In this release, the config file only requires the APIGEE_ADMINPW property. Możesz usunąć z pliku pozostałe 2 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 opisanej poniżej w sekcji „Kolejność aktualizacji maszyn”:
> /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 możliwy do odczytania przez użytkownika „apigee”.

Użyj opcji „-c”, aby określić komponent do zaktualizowania. Lista możliwych komponentów obejmuje:
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge =wszystkie komponenty Edge oprócz interfejsu Edge: serwer zarządzania, procesor komunikatów, router, serwer QPID, serwer Postgres
ui = interfejs Edge
all = aktualizacja wszystkich komponentów na komputerze (używaj tylko w przypadku profilu instalacji Edge aio lub profilu instalacji API BaaS asa)
e = ElasticSearch
b = stos API BaaS
p = portal API BaaS
ebp = ElasticSearch, stos API BaaS i portal API BaaS w 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 zainstalowano nowy węzeł rezerwowy Postgres, wycofaj go z eksploatacji zgodnie z opisem powyżej w sekcji Wycofanie węzła Postgres z eksploatacji.

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

Procedura aktualizacji do wersji 4.17.05 z repozytorium lokalnego

Jeśli węzły Edge znajdują się za zaporą sieciową lub w inny sposób nie mają dostępu do repozytorium Apigee przez internet, możesz przeprowadzić aktualizację z lokalnego repozytorium lub kopii lustrzanej repozytorium Apigee.

Po utworzeniu lokalnego repozytorium Edge masz 2 opcje aktualizowania Edge z lokalnego 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, ale możesz też użyć własnego serwera WWW.

Aby zaktualizować z lokalnego repozytorium 4.17.05:

Jeśli obecnie używasz replikacji Postgres master-standby, zainstaluj nowy węzeł rezerwowy Postgres zgodnie z opisem powyżej w sekcji Instalowanie nowego węzła rezerwowego Postgres.
Utwórz lokalne repozytorium 4.17.05 zgodnie z opisem w sekcji „Tworzenie lokalnego repozytorium Apigee” w artykule Instalowanie narzędzia apigee-setup w Edge.
Uwaga: jeśli masz już repozytorium 4.16.01 lub 4.16.05, możesz dodać do niego repozytorium 4.17.05 zgodnie z opisem w sekcji „Aktualizowanie lokalnego repozytorium Apigee” w artykule Instalowanie narzędzia apigee-setup w Edge.
Aby zainstalować apigee-service z pliku .tar:
1. On the node with the local repo, use the following command to package the local repo into a single .tar file named /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. Możesz go na przykład skopiować do katalogu /tmp w nowym węźle.
3. Na nowym węźle rozpakuj plik do katalogu /tmp:
  > tar -xzf apigee-4.17.05.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 Edge apigee-service i zależności z /tmp/repos:
  > sudo bash /tmp/repos/bootstrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  Zwróć uwagę, że w tym poleceniu uwzględniasz ścieżkę do katalogu repos.
Aby zainstalować apigee-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 apigee-setup Edge.
2. Na węźle zdalnym pobierz plik Edge bootstrap_4.17.05.sh do /tmp/bootstrap_4.17.05.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.05.sh -o /tmp/bootstrap_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 węzła repozytorium.
3. Na węźle zdalnym zainstaluj narzędzie Edge apigee-service i zależności:
  > sudo bash /tmp/bootstrap_4.17.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  
  gdzie uName:pWord to nazwa użytkownika i hasło do repozytorium.
Użyj apigee-service, aby zaktualizować narzędzie apigee-setup:
1. Jeśli wersja 4.16.01 została zainstalowana przez uaktualnienie Edge w 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 katalogu /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 wersja 4.16.01 została zainstalowana bezpośrednio, czyli nie przeprowadzono uaktualnienia z wersji 4.15.07.0x, musisz 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 katalogu /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 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 obecnie używasz Edge 4.16.01: zainstaluj narzędzie apigee-validate na serwerze zarządzania:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
  
  Uwaga: jeśli podczas instalowania wersji 4.16.01 narzędzie apigee-validate zostało zainstalowane w węźle procesora komunikatów, możesz je zaktualizować, używając tego polecenia w tym węźle:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  
  Jednak w przypadku wersji 4.16.05 i nowszych Apigee zaleca zainstalowanie i uruchomienie narzędzia apigee-validate na serwerze zarządzania.
3. Jeśli uaktualniasz wersję 4.16.01: zmodyfikuj plik konfiguracji przekazany do narzędzia apigee-validate. In the 4.16.01 Edge release, the config file used by apigee-validate required the following properties:
  APIGEE_ADMINPW=sysAdminPword
  MP_POD=gateway
  REGION=dc-1
  
  In this release, the config file only requires the APIGEE_ADMINPW property. Możesz usunąć z pliku pozostałe 2 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 opisanej poniżej w sekcji „Kolejność aktualizacji maszyn”:
> /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 możliwy do odczytania przez użytkownika „apigee”.

Użyj opcji „-c”, aby określić komponent do zaktualizowania. Lista możliwych komponentów obejmuje:
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge =wszystkie komponenty Edge oprócz interfejsu Edge: serwer zarządzania, procesor komunikatów, router, serwer QPID, serwer Postgres
ui = interfejs Edge
all = aktualizacja wszystkich komponentów na komputerze (używaj tylko w przypadku profilu instalacji Edge aio lub profilu instalacji API BaaS asa)
e = ElasticSearch
b = stos API BaaS
p = portal API BaaS
ebp = ElasticSearch, stos API BaaS i portal API BaaS w 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 zainstalowano nowy węzeł rezerwowy Postgres, wycofaj go z eksploatacji zgodnie z opisem powyżej w sekcji Wycofanie węzła Postgres z eksploatacji.

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

Kolejność aktualizacji maszyn

Kolejność aktualizowania maszyn w instalacji Edge jest ważna. Najważniejsze kwestie, które należy wziąć pod uwagę podczas aktualizacji:

Zanim zaktualizujesz inne węzły, musisz zaktualizować wszystkie węzły Cassandra i ZooKeeper.
W przypadku każdej maszyny z wieloma komponentami Edge (serwer zarządzania, procesor komunikatów, router, serwer QPID, ale nie serwer Postgres) użyj opcji „-c edge”, aby zaktualizować je wszystkie jednocześnie.
Jeśli dany krok ma zostać wykonany na wielu maszynach, wykonaj go w określonej kolejności maszyn.
Nie ma osobnego kroku do aktualizacji zarabiania. Jest aktualizowany, gdy określisz opcję „-c edge”.
(tylko CentOS-6.x i RedHat-6.x) Na wszystkich węzłach Qpid z zewnętrznym połączeniem internetowym upewnij się, że zostało uruchomione poniższe polecenie, aby pobrać prawidłową wersję Qpid, jak pokazano powyżej:
> yum install apigee-qpidd --disablerepo=epel