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

Korzystając z tej procedury, możesz zaktualizować Apigee Edge w wersji 4.16.01.0x i od 4.16.05.x do 4.18.01.

Jeśli masz wersję Edge wcześniejszą niż 4.16.01, musisz najpierw przeprowadzić migrację do wersji 4.16.01, a następnie zaktualizować ją 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 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: przejdź bezpośrednio na wersję 4.15.07.
  • Jeśli przeprowadzasz migrację z Edge w wersji 4.14.01: najpierw musisz przejść na wersję 4.14.04, a następnie przeprowadzić migrację do wersji 4.15.07.

Kto może przeprowadzać aktualizację

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

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

Które komponenty musisz zaktualizować?

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

Przejście na niższą wersję Zookeeper w przypadku aktualizacji od 16.04.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 zmieniono wersję Zookeeper na apigee-zookeeper-3.4.5-0.0.94x. Uniemożliwia to yum uaktualnienie Zookeeper do nowszej wersji z wersji 4.16.01. Sposób na rozwiązanie tej sytuacji to uruchomienie polecenia yum przejście na standardową wersję apigee-zookeeper przed aktualizacją Zookeeper.

Wersję Zookeeper 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 ustawisz jakieś właściwości przez edycję plików .properties w katalogu /opt/apigee/customer/application, wartości te 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 zalecamy wykonanie pełnej kopii zapasowej wszystkich węzłów przed aktualizacją. Wykonaj procedurę dotyczącą bieżącej wersji Edge, aby utworzyć kopię zapasową.
  
  Pozwala to uzyskać plan wykonywania kopii zapasowych na wypadek problemów z aktualizacją do nowej wersji. Więcej informacji o tworzeniu kopii zapasowych znajdziesz w artykule Tworzenie i przywracanie kopii zapasowej.
• Upewnij się, że urządzenie Edge jest uruchomione
  Podczas procesu aktualizacji sprawdź, czy Edge jest uruchomiony i działa, korzystając z polecenia:
  
  > /opt/apigee/apigee-service/bin/apigee-all status

Obsługa nieudanej aktualizacji

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

Jeśli błąd wymaga przywrócenia aktualizacji do poprzedniej wersji, przeczytaj 4.18.01 proces przywracania, aby dowiedzieć się więcej.

Informacje o aktualizacjach logowania

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, działanie narzędzia update.sh ulegnie awarii.

Wymagane uaktualnienie do wersji 8 Java JDK

Ta wersja Edge wymaga zainstalowania oprogramowania Java JDK w wersji 8 we wszystkich węzłach przetwarzania brzegowego. Możesz zainstalować Oracle JDK 8 lub OpenJDK 8. Jeśli nie masz jeszcze zainstalowanego pakietu Java JDK 8, skrypt aktualizacji może go 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 „Domyślne wyłączone pakiety 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). Użyte polecenie 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 przeglądarce Edge 4.17.05 dodano nowy wymagany parametr do pliku konfiguracji używanego podczas włączania serwera SMTP. Jeśli aktualizujesz wersję z wersji 4.17.01, podczas włączania serwera SMTP musisz ustawić SMTPMAILFROM w pliku konfiguracji.

Interfejs API BaaS w wersji 4.17.09 również dodał obsługę właściwości SMTPMAILFROM. Podczas aktualizowania API BaaS musisz ustawić SMTPMAILFROM w pliku konfiguracji.

Ten parametr ma postać:

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

Wymagane w przypadku aktualizowania przy korzystaniu z uwierzytelniania zewnętrznego

Możesz zintegrować zewnętrzną usługę katalogu z istniejącą instalacją Apigee Edge Private Cloud. Ta funkcja działa z każdą usługą katalogową obsługującą LDAP, na przykład Active Directory czy OpenLDAP. Zewnętrzne rozwiązanie LDAP umożliwia administratorom systemu zarządzanie danymi logowania użytkowników za pomocą scentralizowanej usługi zarządzania katalogami. Nie dotyczy to systemów, które z nich korzystają, takich jak Apigee Edge.

Więcej informacji znajdziesz w sekcji Konfiguracja uwierzytelniania zewnętrznego.

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

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

IS_EXTERNAL_AUTH="true"

Ten wiersz konfiguruje Edge jako nazwę użytkownika, a nie adres e-mail.

Wymagane uaktualnienie do Qpid 1.35

Ta wersja zawiera wymaganą aktualizację Qpid 1.35. Podczas aktualizowania węzła Qpid musisz:

• Tymczasowo nie zezwalaj routerom i procesorom wiadomości na zapis w węźle Qpid, blokując port 5672 w węźle Qpid. Możesz zablokować ten port w węźle Qpid za pomocą tego polecenia:
  > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `nazwa_hosta` -i eth0 -j DROP
• Poczekaj, aż w kolejce Qpid nie będzie żadnych komunikatów, aby mieć pewność, że węzeł Qpid przetworzył wszystkie komunikaty 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 wiadomości. Aby odblokować ten port, możesz użyć tego polecenia:
  > sudo iptables -F
  
  Pamiętaj, że jeśli do obsługi innych reguł używasz polecenia iptables, możesz użyć opcji -D, aby cofnąć określoną zmianę:
  > sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s `nazwa_hosta` -i eth0 -j DROP

Proces ten opisano szczegółowo poniżej dla każdej topologii brzegowej.

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 aktualizacji, gdy węzły Postgres są niedostępne w celu aktualizacji, dane analityczne są nadal zapisywane w węzłach Qpid. Po zaktualizowaniu węzłów Postgres i powrocie do trybu online dane analityczne są przekazywane do węzłów Postgres.

Jeśli z jakiegoś powodu musisz wycofać aktualizację, dodatkowy węzeł gotowości Postgres jest wymagany. Jeśli musisz wycofać aktualizację, po przywróceniu nowy węzeł gotowości Postgres stanie się głównym węzłem Postgres. Dlatego gdy zainstalujesz nowy węzeł gotowości Postgres, powinien on znajdować się w węźle, który spełnia wszystkie wymagania sprzętowe serwera Postgres, zgodnie z wymaganiami dotyczącymi instalacji Edge.

Instaluję nowy węzeł gotowości Postgres

Ta procedura tworzy serwer gotowości Postgres w nowym węźle. Zainstaluj nowy serwer gotowości Postgres dla istniejącej wersji Edge (4.16.01 lub 4.16.05), a nie dla 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:

1. W bieżącym masterze Postgres zmodyfikuj plik /opt/apigee/customer/application/postgresql.properties, aby ustawić poniższy token. Jeśli ten plik nie istnieje, utwórz go:
   
   conf_pg_hba_replication.connection=host naprawić apigee existing_slave_ip/32 trust\ \nreplikacja hosta apigee existing_slave_ip/32 trust
   
   gdzie existing_slave_ip to existing_slave_ip.
2. Ponownie uruchom apigee-postgresql w instancji głównej Postgres:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
3. Sprawdź, czy został dodany nowy węzeł gotowości, wyświetlając plik /opt/apigee/apigee-postgresql/conf/pg_hba.conf w instancji głównej. W tym pliku powinny być widoczne te wiersze:
   host recommendations apigee existing_slave_ip/32 trust
   host replik apigee new_slave_ip/32 trust
4. Zainstaluj nowy serwer gotowości Postgres:
   1. Edytuj plik konfiguracyjny użyty do zainstalowania bieżącej wersji Edge, aby podać następujące informacje:
      
      # adres IP bieżącego mastera:
      PG_MASTER=192.168.56.103
      # adres IP nowego węzła gotowości
      PG_STANDBY=192.168.56.102
   2. Wyłącz SELinux zgodnie z opisem w temacie Instalowanie narzędzia Edge apigee-setup.
   3. Pobierz plik Edge bootstrap_4.16.05.sh na adres /tmp/bootstrap_4.16.05.sh:
      > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_1.bootstrap_4.16.05.sh
      /tmp/bootstrap_4.16.05.sh
      
   4. Zainstaluj narzędzie Edge apigee-service i jego zależności:
      > sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
   5. Aby zainstalować narzędzie apigee-setup, użyj usługi apigee-service:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup setup
   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
      
      Sprawdź, czy wskazuje ono tryb gotowości.

Wyłączanie węzła Postgres

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

1. 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
2. Uzyskaj identyfikator UUID nowego węzła gotowości, uruchamiając w nowym węźle gotowości:
   > curl -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self
   
   Identyfikator UUID węzła 9e75” powinien być widoczny na końcu danych wyjściowych, w formacie:[eb / 9] na końcu danych wyjściowych:
   
   
3. Zatrzymaj nowy węzeł gotowości, uruchamiając na nim to polecenie:
   > /opt/apigee/apigee-service/bin/apigee-all stop
4. W węźle głównym Postgres edytuj /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 solution apigee existing_slave_ip/32 trust
5. Ponownie uruchom apigee-postgresql w masterze Postgres:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
6. Sprawdź, czy nowy węzeł gotowości został usunięty, wyświetlając plik /opt/apigee/apigee-postgresql/conf/pg_hba.conf w instancji głównej. W tym pliku powinien być widoczny tylko ten wiersz:
   host Regulation apigee existing_slave_ip/32 trust
7. Usuń identyfikator UUID węzła gotowości z ZooKeeper, wykonując to wywołanie interfejsu API zarządzania urządzeniami brzegowymi 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 krocząca z zerowym czasem przestoju umożliwia zaktualizowanie instalacji Edge bez wyłączania Edge.

Aktualizacja bez przestojów jest możliwa tylko w przypadku konfiguracji obejmującej 5 węzłów i więcej.

Kluczem do uaktualnienia bez przestojów jest usunięcie każdego routera pojedynczo z systemu równoważenia obciążenia. Następnie zaktualizuj router i wszystkie pozostałe komponenty na tej samej maszynie co router, a następnie dodaj go z powrotem do systemu równoważenia obciążenia.

1. Zaktualizuj maszyny w odpowiedniej kolejności, zgodnie z sekcją „Kolejność aktualizacji maszyny” poniżej.
2. Gdy nadejdzie czas zaktualizowania routerów, wybierz dowolny router i ustaw go jako nieosiągalny zgodnie z opisem w sekcji Osiągalność: włączanie/wyłączanie serwera (procesor wiadomości/router).
3. Zaktualizuj wybrany router i wszystkie pozostałe komponenty brzegowe na tym samym komputerze co router. Wszystkie konfiguracje brzegowe pokazują router i procesor wiadomości w tym samym węźle.
4. Przywróć dostęp do routera.
5. Powtórz kroki od 2 do 4 dla pozostałych routerów.
6. Kontynuuj aktualizację na wszystkich pozostałych komputerach w instalacji.

Przed aktualizacją i po niej zadbaj o 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. Sprawiaj, że procesor wiadomości jest nieosiągalny.
  • Po aktualizacji – wykonaj te czynności:
    1. Zapewnij osiągalność procesora wiadomości.
    2. Zadbaj o osiągnięcie routera.
• W jednym węźle routera:
  • Przed aktualizacją ustaw router jako nieosiągalny.
  • Po aktualizacji zadbaj o to, aby router był osiągalny.
• W jednym węźle procesora wiadomości:
  • Przed aktualizacją ustaw procesor wiadomości jako nieosiągalny.
  • Po zakończeniu aktualizacji zapewnij dostęp do procesora wiadomości.

Korzystanie z cichego pliku konfiguracji

Do polecenia aktualizacji musisz przekazać dyskretny plik konfiguracji. Plik konfiguracji w trybie cichym powinien być taki sam jak podczas instalacji Edge 4.16.01 lub 4.16.05.

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

Aby zaktualizować komponenty Edge w węźle, wykonaj czynności opisane poniżej:

1. Jeśli obecnie używasz replikacji instancji głównej Postgres, zainstaluj nowy węzeł gotowości Postgres zgodnie z opisem powyżej w sekcji Instalowanie nowego węzła gotowości Postgres.
2. Jeśli są obecne, wyłącz wszystkie zadania CRON skonfigurowane tak, aby przeprowadzały operację naprawy na urządzeniu Cassandra, dopóki aktualizacja nie zostanie zakończona.
3. Zaloguj się w węźle jako użytkownik root, aby zainstalować pakiety RPM Edge.
   Uwaga: instalacja RPM wymaga dostępu do roota, ale możesz skonfigurować Edge bez dostępu do roota.
4. Zainstaluj yum-utils i yum-plugin-priorities:
   > sudo yuminstall yum-utils
   > sudo yum instalacja yum-plugin-priorities
5. Wyłącz SELinux zgodnie z opisem w sekcji Instalowanie narzędzia Edge apigee-setup.
6. Włącz repozytorium EPEL w sposób opisany powyżej.
7. Jeśli instalujesz oprogramowanie w systemie Oracle 7.x, uruchom to polecenie:
   > sudo yum-config-manager --enable ol7_optional_latest
8. Jeśli przeprowadzasz instalację w AWS, uruchom te polecenia yum-configure-manager:
   > yum update rh-amazon-rhui-client.noarch
   > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
9. Pobierz plik bootstrap_4.18.01.sh Edge w wersji /tmp/bootstrap_4.18.01.sh:
   > curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap01.1.
10. Zainstaluj narzędzie Edge 4.18.01 apigee-service i jego zależności:
    > sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord
    
    , gdzie uName:pWord pochodzi z nazwy użytkownika i hasła uName:pWord. Jeśli pominiesz parametr pWord, pojawi się prośba o jego podanie.
    
    Domyślnie instalator sprawdza, czy masz zainstalowaną środowisko Java 1.8. Jeśli tego nie zrobisz, zostanie ona automatycznie zainstalowana. Aby określić sposób obsługi instalacji Java, użyj opcji JAVA_FIX. JAVA_FIX przyjmuje te wartości:
    
    I = Zainstaluj OpenJDK 1.8 (domyślnie)
    C = kontynuuj bez instalowania języka Java
    Q = Zakończ. W przypadku tej opcji musisz samodzielnie zainstalować Javę.
11. Użyj apigee-service, aby zaktualizować narzędzie apigee-setup:
    1. Jeśli masz zainstalowaną wersję 4.16.01 po uaktualnieniu Edge do wersji 4.15.07.0x, musisz zainstalować narzędzie apigee-setup:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-setup setup
       
       To polecenie instaluje narzędzie update.sh w witrynie /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 zainstalowałeś wersję 4.16.01 bezpośrednio, co oznacza, że nie uaktualniłeś(-aś) z wersji 4.15.07.0x, musisz zaktualizować narzędzie apigee-setup:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-setup aktualizacja
       
       Aktualizuj narzędzie shapigee-setup/setup
    3. Jeśli masz zainstalowaną wersję 4.16.05 bezpośrednio lub przez aktualizację, musisz zaktualizować narzędzie apigee-setup:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-setup aktualizacja
       
       
       Ta aktualizacja usługi apigee-service instaluje narzędzie update.sh w /optge-apigee//opt.
12. W zależności od bieżącej wersji Edge musisz zainstalować lub zaktualizować narzędzie apigee-validate na serwerze zarządzania.
    1. Jeśli korzystasz obecnie z 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 korzystasz obecnie z Edge w wersji 4.16.01: zainstaluj narzędzie apigee-validate na serwerze zarządzania serwerem zarządzania:
       apigee-validate
       
       Uwaga: jeśli masz zainstalowane narzędzie apigee-validate
       
    3. Jeśli uaktualniasz wersję 4.16.01: zmodyfikuj plik konfiguracyjny przekazany do narzędzia apigee-validate. W wersji Edge 4.16.01 plik konfiguracji używany przez funkcję 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 pozostałe 2 właściwości.
13. Zaktualizuj narzędzie apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
14. 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 component -f configFile
    
    
    Jedynym wymaganiem w pliku konfiguracji jest to, aby plik konfiguracji był dostępny i zrozumiały dla użytkownika „apigee”.
    
    Użyj opcji „-c”, aby wskazać komponent do aktualizacji. Lista możliwych komponentów obejmuje:
    ldap = OpenLDAPS,
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge = Wszystkie komponenty serwera Edge z wyjątkiem interfejsu Edge Management Server, interfejsu Message Processor, Router (oprogramowanie Edge Management Server, Postgres) w tym samym interfejsie użytkownika, Postgres API
    
    
    
    
    
    
15. Przetestuj aktualizację, uruchamiając narzędzie apigee-validate na serwerze zarządzania zgodnie z opisem w sekcji Testowanie instalacji.
16. Jeśli zainstalowano nowy węzeł gotowości Postgres, zamknij go w sposób opisany powyżej w sekcji Wyłączanie węzła Postgres.

Aby później wycofać aktualizację, wykonaj czynności opisane w sekcji 4.18.01 Proces przywracania.

Procedura aktualizacji do wersji 4.18.01 z lokalnego repozytorium

Jeśli węzły brzegowe znajdują się za zaporą sieciową lub z innego powodu nie mają dostępu do repozytorium Apigee przez internet, możesz wykonać aktualizację z lokalnego repozytorium lub jego dublowania.

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

• Utwórz w repozytorium plik .tar, skopiuj go do węzła, a następnie zaktualizuj Edge z poziomu 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, którego możesz używać, lub możesz użyć własnego serwera.

Aby zaktualizować dane z lokalnego repozytorium w wersji 4.18.01:

1. Jeśli obecnie używasz replikacji instancji głównej Postgres, zainstaluj nowy węzeł gotowości Postgres zgodnie z opisem powyżej w sekcji Instalowanie nowego węzła gotowości Postgres.
2. Utwórz lokalne repozytorium w wersji 4.18.01 zgodnie z opisem w sekcji „Tworzenie lokalnego repozytorium Apigee” artykułu Instalowanie narzędzia Edge apigee-setup.
   Uwaga: jeśli masz już repozytorium w wersji 4.16.01 lub 4.16.05, możesz dodać do niego repozytorium 4.18.01, wykonując instrukcje podane w sekcji „Aktualizowanie lokalnego repozytorium Apigee” artykułu Instalowanie narzędzia Edge apigee-setup.
3. Aby zainstalować usługę apigee-service z pliku .tar:
   1. W węźle z lokalnym repozytorium za pomocą tego polecenia spakuj je 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
   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 przejdź do katalogu /tmp:
      > tar -xzf apigee-4.18.01.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 jego zależności z /tmp/repos:
      > sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
      
      Zwróć uwagę, że w tym poleceniu uwzględniono ścieżkę do katalogu repos
4. Aby zainstalować usługę 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” artykułu Instalowanie narzędzia Edge apigee-setup.
   2. W węźle zdalnym pobierz plik Edge bootstrap_4.18.01.sh jako adres /tmp/bootstrap_4.18.01.sh na potrzeby adresu /tmp/bootstrap_4.18.01.sh:
      > /usr/bin/curl http://uName:pWord@remoteReporepo (nazwa_użytkownika.adresu_zdalnego.1), gdzie nazwa użytkownika lub nazwa_pliku_zdalnego.0.01 to nazwa użytkownika dla_zdalnego_adresu_zdalnego@nazwa_adresu_zdalnego.1.adresu.adresu.1 powyżej, nazwa_Twojego_adresu_dla_zdalnego_adresu_zdalnego.3939/bootstrap1:3939/bootstrap_4:3939/bootstrap_4
      
      
   3. W węźle zdalnym zainstaluj narzędzie Edge Apigee i jej zależności:
      > sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWordrepohost, gdzie nazwa_użytkownika to uName apigeepassword=pWordtprot
      
      
5. Użyj apigee-service, aby zaktualizować narzędzie apigee-setup:
   1. Jeśli masz zainstalowaną wersję 4.16.01 po uaktualnieniu Edge do wersji 4.15.07.0x, musisz zainstalować narzędzie apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup setup
      
      To polecenie instaluje narzędzie update.sh w witrynie /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 zainstalowałeś wersję 4.16.01 bezpośrednio, co oznacza, że nie uaktualniłeś(-aś) z wersji 4.15.07.0x, musisz zaktualizować narzędzie apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup aktualizacja
      
      Wymagana jest aktualizacja narzędzia apigee-setup/setup
   3. Jeśli masz zainstalowaną wersję 4.16.05 bezpośrednio lub przez aktualizację, musisz zaktualizować narzędzie apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup aktualizacja
      
      
      Ta aktualizacja usługi apigee-service instaluje narzędzie update.sh w witrynie /optge.apigee//optge-apigee//opt.
6. W zależności od bieżącej wersji Edge musisz zainstalować lub zaktualizować narzędzie apigee-validate na serwerze zarządzania.
   1. Jeśli korzystasz obecnie z 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 korzystasz obecnie z Edge w wersji 4.16.01: zainstaluj narzędzie apigee-service-validate narzędzia apigee-validate na serwerze zarządzania serwerem zarządzania:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate apply
      
      Uwaga: jeśli zainstalujesz narzędzie apigee-service-validate, które do tego służy, możesz zainstalować narzędzie apigee-apige.validate, gdy używasz tego narzędzia apigee-apige.validate, gdy używasz tego narzędzia apigee-apige.validate.
      
      
      
   3. Jeśli uaktualniasz wersję 4.16.01: zmodyfikuj plik konfiguracyjny przekazany do narzędzia apigee-validate. W wersji Edge 4.16.01 plik konfiguracji używany przez funkcję 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 pozostałe 2 właściwości.
7. Zaktualizuj narzędzie apigee-provision:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
8. 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 -ccomponent -f configFile
   
   
   Jedynym wymaganiem dotyczącym pliku konfiguracji jest to, aby plik konfiguracji był dostępny i zrozumiały dla użytkownika „apigee”.
   
   Użyj opcji „-c”, aby wskazać komponent do aktualizacji. Lista możliwych komponentów obejmuje:
   ldap = OpenLDAPS,
   cs = Cassandra
   zk = Zookeeper
   qpid = qpidd
   ps = postgresql
   edge = Wszystkie komponenty serwera Edge z wyjątkiem interfejsu Edge Management Server, interfejsu Message Processor, Router (oprogramowanie Edge Management Server, Postgres) w tym samym interfejsie użytkownika, Postgres API
   
   
   
   
   
   
9. Przetestuj aktualizację, uruchamiając narzędzie apigee-validate na serwerze zarządzania zgodnie z opisem w sekcji Testowanie instalacji.
10. Jeśli zainstalowano nowy węzeł gotowości Postgres, zamknij go w sposób opisany powyżej w sekcji Wyłączanie węzła Postgres.

Aby później wycofać aktualizację, wykonaj czynności opisane w sekcji 4.18.01 Proces przywracania.

Kolejność aktualizacji maszyny

Kolejność aktualizowania maszyn w instalacji Edge jest ważna. Najważniejsze kwestie dotyczące aktualizacji:

• Zanim zaktualizujesz inne węzły, musisz zaktualizować wszystkie węzły Cassandra i ZooKeeper.
• W przypadku maszyn z wieloma komponentami brzegowymi (serwer zarządzania, procesor 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 komputerach, wykonaj go w określonej kolejności maszyn.
• Nie musisz robić nic więcej, aby zaktualizować ustawienia Zarabianie. Jest aktualizowany, gdy określisz opcję „-c Edge”.

Samodzielna instalacja z 1 hostem

1. Ustaw SMTPMAILFROM w pliku konfiguracji, jeśli masz włączony protokół SMTP w Edge. Ten parametr ma postać:
   SMTPMAILFROM="Moja firma <moja_firma.com>"
2. Jeśli aktualizujesz aplikację z wersji 4.16.01, przejdź na niższą wersję Zookeeper:
   > yum starszych wersji apigee-zookeeper
3. Zaktualizuj Cassandra i ZooKeeper:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -fconfigFile
4. Ustaw tę regułę iptables:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `nazwa_hosta` -i eth0 -j DROP
5. Sprawdź kolejkę wiadomości Qpid:
   > qpid-stat -q
   
   Sprawdzaj kolejkę, aż liczba w kolumnie „msg” wyniesie 0. Nie możesz uaktualnić Qpid, dopóki nie przetworzy on wszystkich wiadomości.
6. Zaktualizuj qpidd:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
7. Flush iptables:
   > sudo iptables -F
8. Zaktualizuj LDAP:
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
9. 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/bin/apigee
10. Zaktualizuj postgresql:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
11. Zaktualizuj bazę danych Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
12. Zaktualizuj pozostałe komponenty Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -cedge -f configFile
13. Zaktualizuj interfejs Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Samodzielna instalacja na 2 hostach

Listę topologii brzegowych i numerów węzłów znajdziesz w sekcji Topologie instalacji.

1. Ustaw SMTPMAILFROM w pliku konfiguracji, jeśli masz włączony protokół SMTP w Edge. Ten parametr ma postać:
   SMTPMAILFROM="Moja firma <moja_firma.com>"
2. Jeśli aktualizujesz aplikację z wersji 4.16.01, przejdź na niższą wersję Zookeeper na komputerze 1:
   > yum przejście na wersję apigee-zookeeper
3. Zaktualizuj Cassandra i ZooKeeper na maszynie 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
4. Ustaw w maszynie 2 tę regułę iptables:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `nazwa_hosta` -i eth0 -j DROP
5. Sprawdź kolejkę wiadomości Qpid na maszynie 2:
   > qpid-stat -q
   
   Sprawdzaj kolejkę, aż liczba w kolumnie „msg” wyniesie 0. Nie możesz uaktualnić Qpid, dopóki nie przetworzy on wszystkich wiadomości.
6. Zaktualizuj qpidd na komputerze 2:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
7. Usuń plik iptables na maszynie 2:
   > sudo iptables -F
8. Zaktualizuj LDAP na komputerze 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
9. Zaktualizuj komponenty Edge w maszynie 1:
   > /opt/apigee/apigee-setup/bin/update.sh -cedge -f configFile
10. Zaktualizuj interfejs użytkownika na maszynie 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
11. 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 krawędź-qpid-server stope
       > /opt/apigee/apigee/
    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 w maszynie 2:
       > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile

Instalacja scalona z 5 hostami

Listę topologii brzegowych i numerów węzłów znajdziesz w sekcji Topologie instalacji.

1. Ustaw SMTPMAILFROM w pliku konfiguracji, jeśli masz włączony protokół SMTP w Edge. Ten parametr ma postać:
   SMTPMAILFROM="Moja firma <moja_firma.com>"
2. Sprawdź, czy został zainstalowany nowy węzeł gotowości Postgres zgodnie z opisem powyżej w sekcji Instalowanie nowego węzła gotowości Postgres.
3. Jeśli aktualizujesz aplikację z wersji 4.16.01, przejdź na niższą wersję Zookeeper na maszynach 1, 2 i 3:
   > yum przejście na standardową wersję apigee-zookeeper
4. Zaktualizuj Cassandra i ZooKeeper na maszynie 1, 2 i 3:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
5. Ustaw w maszynie 4 tę regułę iptables:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `nazwa_hosta` -i eth0 -j DROP
6. Sprawdź kolejkę wiadomości Qpid na maszynie 4:
   > qpid-stat -q
   
   Sprawdzaj kolejkę, aż liczba w kolumnie „msg” wyniesie 0. Nie możesz uaktualnić Qpid, dopóki nie przetworzy on wszystkich wiadomości.
7. Zaktualizuj qpidd na maszynie 4:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
8. Usuń plik iptables na maszynie 4:
   > sudo iptables -F
9. Powtórz kroki od 5 do 8 na komputerze 5.
10. Zaktualizuj LDAP na komputerze 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
11. Zaktualizuj komponenty Edge w maszynie 1, 2, 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
12. Zaktualizuj interfejs użytkownika na maszynie 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
13. Zaktualizuj maszyny 4 i 5:
    1. Zatrzymaj serwer Postgres i serwer Qpid na maszynie 4:
       > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
       > /opt/apigee/apigee-service/bin/apigee-service krawędź-qpid-server stop
    2. Zatrzymaj serwer Postgres, serwer Qpid i postgresql na maszynie 5:
       > /opt/apigee/apigee-service/bin/apigee-serviceedge-postgres-server stop
       > /opt/apigee/apigee-service/bin/apigee-serviceedge-qpidge-server stop
       > /opt/apie-server stop
       
    3. Zatrzymaj serwer Postgres i postgresql w nowym węźle gotowości, który został dodany na potrzeby przywracania:
       > /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 komputerach 4:
       > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    5. Zaktualizuj bazę danych Postgres w maszynie 4 (tylko master Postgres):
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    6. Zaktualizuj postgresql na komputerach 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-serviceedge-qpid-server start
    8. Skonfiguruj Postgres jako węzeł gotowości, uruchamiając na maszynie 5 te polecenia:
       > cd /opt/apigee/data/apigee-postgresql/pgdata
       > rm -rf *
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql konfiguracja-usługiconfigFile
    9. Sprawdź stan replikacji, uruchamiając te skrypty na obu serwerach. Aby zapewnić pomyślną replikację, system powinien wyświetlać identyczne wyniki na obu serwerach:
       
       Na komputerze 4, w węźle głównym, uruchom:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
       
       Potwierdź, że jest to maszyna główna.
       
       W maszynie 5 węzeł gotowości:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
       
       Potwierdź, że jest to tryb gotowości.
14. Zaktualizuj komponenty Edge w maszynie 4, 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
15. Pamiętaj, aby wyłączyć nowy węzeł gotowości, wykonując czynności opisane powyżej w sekcji Wycofywanie węzła Postgres.

Instalacja scalona z 9 hostami

Listę topologii brzegowych i numerów węzłów znajdziesz w sekcji Topologie instalacji.

1. Ustaw SMTPMAILFROM w pliku konfiguracji, jeśli masz włączony protokół SMTP w Edge. Ten parametr ma postać:
   SMTPMAILFROM="Moja firma <moja_firma.com>"
2. Sprawdź, czy został zainstalowany nowy węzeł gotowości Postgres zgodnie z opisem powyżej w sekcji Instalowanie nowego węzła gotowości Postgres.
3. Jeśli aktualizujesz aplikację z wersji 4.16.01, przejdź na niższą wersję Zookeeper na komputerze 1, 2 i 3:
   > yum przejście na standardową wersję apigee-zookeeper
4. Zaktualizuj Cassandra i ZooKeeper na maszynie 1, 2 i 3:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
5. Ustaw w maszynie 6 tę regułę iptables:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `nazwa_hosta` -i eth0 -j DROP
6. Sprawdź kolejkę wiadomości Qpid na maszynie 6:
   > qpid-stat -q
   
   Sprawdzaj kolejkę, aż liczba w kolumnie „msg” wyniesie 0. Nie możesz uaktualnić Qpid, dopóki nie przetworzy on wszystkich wiadomości.
7. Zaktualizuj qpidd na komputerze 6:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
8. Wyczyść iptables na maszynie 6:
   > sudo iptables -F
9. Powtórz kroki od 5 do 8 na komputerze 7.
10. Zaktualizuj LDAP na komputerze 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
11. Zaktualizuj komponenty Edge w maszynie 6, 7, 1, 4 i 5 w tej kolejności:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
12. Zaktualizuj interfejs użytkownika na maszynie 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
13. Zaktualizuj maszyny 8 i 9:
    1. Zatrzymaj serwer Postgres w 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 komputerach 6 i 7:
       > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
    4. Zatrzymaj serwer Postgres i postgresql w nowym węźle gotowości, który został dodany na potrzeby przywracania:
       > /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 komputerach 8:
       > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Zaktualizuj bazę danych Postgres w maszynie 8 (tylko master Postgres):
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Zaktualizuj postgresql na komputerach 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 komputerach 6 i 7:
       > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    10. Skonfiguruj Postgres jako węzeł gotowości, uruchamiając na maszynie 9 te polecenia:
        > cd /opt/apigee/data/apigee-postgresql/pgdata
        > rm -rf *
        > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql konfiguracja-usługiconfigFile
    11. Sprawdź stan replikacji, uruchamiając te skrypty na obu serwerach. Aby zapewnić pomyślną replikację, system powinien wyświetlić identyczne wyniki na obu serwerach:
        Na maszynie 8, czyli w węźle głównym, wykonaj te czynności:
        > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
        
        Sprawdź, czy jest to maszyna główna.
        
        W maszynie 9 węzeł gotowości:
        > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
        
        Potwierdź, że jest to tryb gotowości.
14. Zaktualizuj komponenty Edge w maszynach 8 i 9:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
15. Pamiętaj, aby wyłączyć nowy węzeł gotowości, wykonując czynności opisane powyżej w sekcji Wycofywanie węzła Postgres.

Instalacja scalona z 13 hostami

Listę topologii brzegowych i numerów węzłów znajdziesz w sekcji Topologie instalacji.

1. Ustaw SMTPMAILFROM w pliku konfiguracji, jeśli masz włączony protokół SMTP w Edge. Ten parametr ma postać:
   SMTPMAILFROM="Moja firma <moja_firma.com>"
2. Sprawdź, czy został zainstalowany nowy węzeł gotowości Postgres zgodnie z opisem powyżej w sekcji Instalowanie nowego węzła gotowości Postgres.
3. Jeśli aktualizujesz aplikację z wersji 4.16.01, przejdź na niższą wersję Zookeeper na komputerze 1, 2 i 3:
   > yum przejście na standardową wersję apigee-zookeeper
4. Zaktualizuj Cassandra i ZooKeeper na maszynie 1, 2 i 3:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
5. Ustaw w maszynie 12 tę regułę iptables:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `nazwa_hosta` -i eth0 -j DROP
6. Sprawdź kolejkę wiadomości Qpid na maszynie 12:
   > qpid-stat -q
   
   Sprawdzaj kolejkę, aż liczba w kolumnie „msg” wyniesie 0. Nie możesz uaktualnić Qpid, dopóki nie przetworzy on wszystkich wiadomości.
7. Zaktualizuj qpidd na komputerze 12:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
8. Wyczyść iptables w maszynie 12:
   > sudo iptables -F
9. Powtórz kroki od 5 do 8 na komputerze 13.
10. Zaktualizuj LDAP na maszynach 4 i 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
11. Zaktualizuj komponenty Edge w maszynie 12, 13, 6, 7, 10 i 11 w tej kolejności:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
12. Zaktualizuj interfejs użytkownika na maszynach 6 i 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
13. Zaktualizuj maszyny 8 i 9:
    1. Zatrzymaj serwer Postgres w 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 komputerach 12 i 13:
       > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
    4. Zatrzymaj serwer Postgres i postgresql w nowym węźle gotowości, który został dodany na potrzeby przywracania:
       > /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 komputerach 8:
       > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. Zaktualizuj bazę danych Postgres w maszynie 8 (tylko master Postgres):
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. Zaktualizuj postgresql na komputerach 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ł gotowości, uruchamiając na maszynie 9 te polecenia:
        > cd /opt/apigee/data/apigee-postgresql/pgdata
        > rm -rf *
        > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql konfiguracja-usługiconfigFile
    11. Sprawdź stan replikacji, uruchamiając te skrypty na obu serwerach. Aby zapewnić pomyślną replikację, system powinien wyświetlić identyczne wyniki na obu serwerach:
        Na maszynie 8, czyli w węźle głównym, wykonaj te czynności:
        > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
        
        Sprawdź, czy jest to maszyna główna.
        
        W maszynie 9 węzeł gotowości:
        > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
        
        Potwierdź, że jest to tryb gotowości.
14. Zaktualizuj komponenty Edge w maszynach 8 i 9:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
15. Pamiętaj, aby wyłączyć nowy węzeł gotowości, wykonując czynności opisane powyżej w sekcji Wycofywanie węzła Postgres.

Instalacja scalona z 12 hostami

Listę topologii brzegowych i numerów węzłów znajdziesz w sekcji Topologie instalacji.

1. Ustaw SMTPMAILFROM w pliku konfiguracji, jeśli masz włączony protokół SMTP w Edge. Ten parametr ma postać:
   SMTPMAILFROM="Moja firma <moja_firma.com>"
2. Sprawdź, czy został zainstalowany nowy węzeł gotowości Postgres zgodnie z opisem powyżej w sekcji Instalowanie nowego węzła gotowości Postgres.
3. Zaktualizuj Cassandra i ZooKeeper:
   1. Jeśli aktualizujesz aplikację z wersji 4.16.01, przejdź na niższą wersję Zookeeper na komputerze 1, 2 i 3 w Centrum danych 1:
      > yum przejdź na starszą wersję 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 aplikację z wersji 4.16.01, przejdź na niższą wersję Zookeeper na komputerach Macine 7, 8 i 9 w Centrum danych 2:
      > yum przejście na niższą wersję apigee-zookeeper
   4. Na komputerach 7, 8 i 9 w Centrum danych 2
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
4. Zaktualizuj qpidd:
   1. Maszyny 4 i 5 w Centrum danych 1
      1. Ustaw w maszynie 4 tę regułę iptables:
         > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `nazwa_hosta` -i eth0 -j DROP
      2. Sprawdź kolejkę wiadomości Qpid na maszynie 4:
         > qpid-stat -q
         
         Sprawdzaj kolejkę, aż liczba w kolumnie „msg” wyniesie 0. Nie możesz uaktualnić Qpid, dopóki nie przetworzy on 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 od 1 do 4 na komputerze 5.
   2. Maszyny 10, 11 w Centrum danych 2
      1. Ustaw w maszynie 10 tę regułę iptables:
         > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `nazwa_hosta` -i eth0 -j DROP
      2. Sprawdź kolejkę wiadomości Qpid na maszynie 10:
         > qpid-stat -q
         
         Sprawdzaj kolejkę, aż liczba w kolumnie „msg” wyniesie 0. Nie możesz uaktualnić Qpid, dopóki nie przetworzy on wszystkich wiadomości.
      3. Zaktualizuj qpidd na komputerze 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 od 1 do 4 na komputerze 11.
5. Zaktualizuj LDAP:
   1. Maszyny 1 w Centrum danych 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
   2. Maszyny 7 w Centrum danych 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
6. 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 Data Center 2
      > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
7. Zaktualizuj interfejs:
   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
8. Zaktualizuj maszynę 6 w Centrum danych 1 i 12 w Centrum danych 2:
   1. Zatrzymaj serwer 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 w nowym węźle gotowości, który został dodany na potrzeby przywracania:
      > /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 komputerach 6:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
   6. Zaktualizuj bazę danych Postgres w maszynie 6 (tylko master Postgres):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
   7. Zaktualizuj postgresql na komputerach 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ł gotowości, uruchamiając na maszynie 12 te polecenia:
       > cd /opt/apigee/data/apigee-postgresql/pgdata
       > rm -rf *
       > /opt/apigee/apigee-service/bin/lapigee-service fapigee-postgresql configFile
   11. Sprawdź stan replikacji, uruchamiając te skrypty na obu serwerach. Aby zapewnić pomyślną replikację, system powinien wyświetlić identyczne wyniki na obu serwerach:
       Na maszynie 6, czyli w węźle głównym, wykonaj te czynności:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
       
       Sprawdź, czy jest to maszyna główna.
       
       W maszynie 12 węzeł gotowości:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
       
       Potwierdź, że jest to tryb gotowości.
9. Zaktualizuj komponenty Edge w maszynach 6 i 12:
   > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
10. Pamiętaj, aby wyłączyć nowy węzeł gotowości, wykonując czynności opisane powyżej w sekcji Wycofywanie węzła Postgres.

Instalacja BaaS z interfejsem API z 7 lub 10 hostami

Niestandardowa instalacja

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

1. ZooKeeper
2. Cassandra
3. QPID
4. LDAP
5. Edge czyli profil „-c Edge” na wszystkich węzłach w tej kolejności: węzły z serwerem Qpid, ale nie serwerem Postgres, serwerem zarządzania, procesorem wiadomości i routerem.
   Uwaga: jeśli w węźle jest zainstalowany zarówno serwer Qpid, jak i serwer Postgres, w kroku 8 uruchom krok profilu „-c Edge”.
6. Interfejs Edge
7. postgresql w masterze Postgres, w tym uaktualnienie.
8. postgresql w trybie gotowości Postgres.
9. Edge, czyli profil „-c Edge” we wszystkich połączonych węzłach Qpid i Postgres lub w dowolnych samodzielnych węzłach Postgres;