Aktualizacja Apigee Edge od 4.16.09 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

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

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

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.

Gdy zainstalujesz pakiety RPM Edge, każdy użytkownik będzie mógł je skonfigurować.

Które komponenty należy zaktualizować

Musisz zaktualizować wszystkie komponenty Edge. Edge nie obsługuje konfiguracji zawierającej komponenty z różnych wersji.

Wymagane uaktualnienie do wersji Qpid 1.35

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

  • Tymczasowo uniemożliwić routerom i procesorom wiadomości zapisywanie na węźle Qpid, blokując port 5672 na 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ż kolejka Qpid będzie pusta, aby mieć pewność, że węzeł Qpid przetworzył wszystkie wiadomości przed aktualizacją. Aby sprawdzić, czy 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, 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.

Wymagany 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/Oracle 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/Oracle 6.x:
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

Wymagany jest parametr konfiguracyjny 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 interfejsu API BaaS musisz ustawić SMTPMAILFROM w pliku konfiguracji.

Ten parametr ma postać:

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

Wymagane, jeśli aktualizujesz podczas korzystania z 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 każdą usługą katalogową, która obsługuje LDAP, na przykład Active Directory, OpenLDAP i inne. 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 uwierzytelnianie zewnętrzne, 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.

Automatyczne propagowanie ustawień usługi

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

Aktualizacja wymagań wstępnych

Zanim uaktualnisz Apigee Edge, musisz spełnić 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.

    W ten sposób masz plan awaryjny 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 błąd wymaga przywrócenia poprzedniej wersji, zapoznaj się z informacjami na temat procesu przywracania do wersji 4.17.09.

Informacje o logowaniu

Domyślnie narzędzie update.sh zapisuje informacje o logach w tych plikach:

/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, log jest zapisywany w katalogu /tmp w pliku o nazwie update_username.log.

Jeśli użytkownik nie ma dostępu do pliku /tmp, narzędzie update.sh kończy się niepowodzeniem.

Aktualizacja 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 aktualizacji bez przestojów jest usuwanie pojedynczo każdego routera z systemu równoważenia obciążenia. Następnie zaktualizuj Router i wszystkie inne komponenty na tym samym komputerze, a potem ponownie dodaj Router do systemu równoważenia obciążenia.

  1. Zaktualizuj maszyny w odpowiedniej kolejności zgodnie z opisem poniżej w sekcji „Kolejność aktualizacji maszyny”.
  2. Gdy przyjdzie czas na zaktualizowanie routerów, wybierz dowolny z nich i ustaw go jako nieosiągalny zgodnie z opisem w sekcji Włączanie/wyłączanie osiągalności serwera (procesora wiadomości/routera).
  3. 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.
  4. Spraw, aby router był ponownie dostępny.
  5. Powtórz kroki 2–4 w przypadku pozostałych routerów.
  6. Kontynuuj aktualizację pozostałych maszyn w instalacji.

Przed aktualizacją i po niej weź pod uwagę te kwestie:

  • 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 procesor wiadomości jest osiągalny.
      2. Upewnij się, że router jest dostępny.
  • Na jednym węźle Router:
    • Przed aktualizacją sprawdź, czy router jest niedostępny.
    • Po aktualizacji sprawdź, czy router jest dostępny.
  • 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 cichego pliku konfiguracji

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

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

Aby zaktualizować komponenty Edge w węźle:

  1. Jeśli są obecne, wyłącz wszystkie zadania cron skonfigurowane w celu wykonania operacji naprawy w Cassandra, dopóki aktualizacja nie zostanie ukończona.
  2. 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.
  3. Zainstaluj yum-utils i yum-plugin-priorities:
    > sudo yum install yum-utils
    > sudo yum install yum-plugin-priorities
  4. Wyłącz SELinux w sposób opisany w artykule Instalowanie narzędzia Edge apigee-setup.
  5. Włącz repozytorium EPEL, postępując zgodnie z instrukcjami opisanymi powyżej.
  6. 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
  7. Pobierz plik Edge w wersji 4.17.09 Bootstrap_4.17.09.sh na adres /tmp/shoestrap_4.17.09.sh:
    > curl https://software.apigee.com/shoestrap_4.17.09.sh -o /tmp/shoestrap_4.sh17.0
  8. Zainstaluj narzędzie apigee-service i zależności w Edge 4.17.09:
    > sudo bash /tmp/shoestrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord

    Gdzie uName:pWord zostały odebrane przez Ciebie nazwę użytkownika i hasło. Jeśli pominiesz pWord, pojawi się prośba o jego podanie.

    Domyślnie instalator sprawdza, czy masz zainstalowaną Javę w wersji 1.8. Jeśli tego nie zrobisz, aplikacja zainstaluje ją za Ciebie. Aby określić sposób obsługi instalacji Javy, użyj opcji JAVA_FIX. JAVA_FIX przyjmuje te wartości:

    I = Zainstaluj OpenJDK 1.8 (domyślnie)
    C = Kontynuuj bez instalowania Java
    Q = Zamknij. W tym przypadku musisz samodzielnie zainstalować Javę.
  9. Użyj narzędzia apigee-service, aby zaktualizować narzędzie apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  10. Zaktualizuj narzędzie apigee-validate na serwerze zarządzania:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  11. Zaktualizuj narzędzie apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision aktualizacja
  12. 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”.

    Użyj opcji „-c”, aby określić komponent do zaktualizowania. Informacje i dostępne na liście mogą:
    ldap. ldap = OpenLDAP = OpenLDAP.
    cs cs = Cassandra.
    zk = Zookeeper
    .
    qpid = qpidd
    ps qpid = qpidd
    ps




  13. Przetestuj aktualizację, uruchamiając na serwerze zarządzającym narzędzie apigee-validate, zgodnie z opisem w sekcji Testowanie instalacji.

Aby później wycofać 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 go do węzła, a potem zaktualizuj Edge z tego pliku.
  • Zainstaluj serwer WWW w węźle z lokalnym repozytorium, aby inne węzły miały do niego dostęp. Apigee udostępnia serwer WWW Nginx, z którego możesz korzystać. Możesz też użyć własnego serwera WWW.

Aby zaktualizować dane z lokalnego repozytorium 17.09:

  1. Utwórz lokalne repozytorium 4.17.09 zgodnie z instrukcjami podanymi w artykule „Tworzenie lokalnego repozytorium Apigee” na stronie Zainstaluj narzędzie apigee-setup w Edge.
    Uwaga: jeśli masz już repozytorium w wersji 4.16.09, możesz je dodać do niego w sposób opisany w sekcji „Aktualizowanie lokalnego repozytorium Apigee” w artykule Instalowanie narzędzia do konfiguracji Edge apigee.
  2. 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. Możesz na przykład skopiować plik 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 Edge apigee-service i zależności z /tmp/repos:
      > sudo bash /tmp/repos/Bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Zwróć uwagę, że to polecenie zawiera ścieżkę do katalogu repozytoriów.
  3. Aby zainstalować usługę apigee za pomocą serwera WWW Nginx:
    1. Skonfiguruj serwer WWW Nginx zgodnie z opisem w sekcji „Instalowanie z repozytorium przy użyciu 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.
  4. Użyj polecenia apigee-service, aby zaktualizować narzędzie apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. Zaktualizuj narzędzie apigee-validate na serwerze zarządzającym.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. Zaktualizuj narzędzie apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision aktualizacja
  7. 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”.

    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
  8. Przetestuj aktualizację, uruchamiając na serwerze zarządzającym narzędzie apigee-validate, zgodnie z opisem w sekcji Testowanie instalacji.

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

Kolejność aktualizacji maszyny

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 aktualizowana, gdy podasz opcję „-c Edge”.

Instalacja samodzielna z 1 hostem

  1. Jeśli masz włączone SMTP w Edge, w pliku konfiguracji ustaw parametr SMTPMAILFROM. Parametr ten ma postać:
    SMTPMAILFROM="Moja firma <myco@company.com>"
  2. Zaktualizuj Cassandra i ZooKeeper:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Ustaw tę regułę iptables:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  4. Sprawdź kolejkę wiadomości Qpid:
    > 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.
  5. Zaktualizuj qpidd:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Flush iptables:
    > sudo iptables -F
  7. Zaktualizuj postgresql:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  8. Uruchom postgresql:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  9. Aktualizacja LDAP:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  10. Zaktualizuj pozostałe komponenty Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. 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.

  1. Jeśli masz włączone SMTP w Edge, w pliku konfiguracji ustaw parametr SMTPMAILFROM. Ten parametr ma postać:
    SMTPMAILFROM="Moja firma <mojaco@firma.com>"
  2. Zaktualizuj Cassandra i ZooKeeper na maszynie 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Ustaw na maszynie 2 tę regułę iptables:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  4. Sprawdź kolejkę komunikatów Qpid na komputerze 2:
    > qpid-stat -q

    Sprawdzaj kolejkę, dopóki liczba w kolumnie „msg” nie wyniesie 0. Nie możesz uaktualnić Qpid, dopóki nie przetworzy wszystkich wiadomości.
  5. Zaktualizuj qpidd na maszynie 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Wyczyść iptables na maszynie 2:
    > sudo iptables -F
  7. Zaktualizuj postgresql na maszynie 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  8. Uruchom postgresql na maszynie 2:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  9. Zaktualizuj LDAP na maszynie 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  10. Zaktualizuj komponenty Edge na maszynach 2 i 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. Aktualizacja interfejsu użytkownika na komputerze 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

W przypadku instalacji z 5 hostami w klastrze

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

  1. Ustaw SMTPMAILFROM w pliku konfiguracji, jeśli włączono SMTP w Edge. Parametr ten ma postać:
    SMTPMAILFROM="Moja firma <myco@company.com>"
  2. Zaktualizuj Cassandra i ZooKeeper na maszynach 1, 2 i 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Ustaw tę regułę iptables na komputerze 4:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `nazwa hosta` -i eth0 -j DROP
  4. 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.
  5. Zaktualizuj qpidd na maszynie 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Wyczyść iptables na maszynie 4:
    > sudo iptables -F
  7. Powtórz kroki od 3 do 6 na komputerze 5.
  8. Zaktualizuj postgresql na maszynie 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  9. Uruchom postgresql na maszynie 4:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  10. Powtórz kroki 8 i 9 na maszynie 5.
  11. Zaktualizuj LDAP na maszynie 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  12. Zaktualizuj komponenty Edge na maszynach 4, 5, 1, 2, 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  13. Zaktualizuj interfejs użytkownika na maszynie 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Instalacja z 9 hostami w klastrze

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

  1. Ustaw SMTPMAILFROM w pliku konfiguracji, jeśli włączono SMTP w Edge. Parametr ten ma postać:
    SMTPMAILFROM="Moja firma <myco@company.com>"
  2. Zaktualizuj Cassandra i ZooKeeper na maszynach 1, 2 i 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Ustaw tę regułę iptables na komputerze 6:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `nazwa hosta` -i eth0 -j DROP
  4. 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.
  5. Zaktualizuj qpidd na maszynie 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Wyczyść ustawienia iptables na maszynie 6:
    > sudo iptables -F
  7. Powtórz kroki od 3 do 6 na komputerze 7.
  8. Zaktualizuj postgresql na maszynie 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  9. Uruchom postgresql na maszynie 6:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  10. Powtórz kroki 8 i 9 na maszynie 7.
  11. Zaktualizuj LDAP na maszynie 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  12. Zaktualizuj komponenty Edge na maszynach 6, 7, 8, 9, 1, 4 i 5 w podanej kolejności:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  13. Zaktualizuj interfejs użytkownika na maszynie 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

W przypadku klastrowanej instalacji z 13 hostami

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

  1. Jeśli masz włączone SMTP w Edge, w pliku konfiguracji ustaw parametr SMTPMAILFROM. Parametr ten ma postać:
    SMTPMAILFROM="Moja firma <myco@company.com>"
  2. Zaktualizuj Cassandra i ZooKeeper na maszynach 1, 2 i 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Ustaw na maszynie 12 tę regułę iptables:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  4. 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.
  5. Zaktualizuj qpidd na maszynie 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. Wyczyść ustawienia iptables w maszynie 12:
    > sudo iptables -F
  7. Powtórz kroki od 3 do 6 na komputerze 13.
  8. Zaktualizuj postgresql na maszynie 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  9. Uruchom postgresql na maszynie 12:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  10. Powtórz kroki 8 i 9 na maszynie 13.
  11. Zaktualizuj LDAP na maszynach 4 i 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  12. Zaktualizuj komponenty Edge na maszynach 12, 13, 8, 9, 6, 7, 10 i 11 w podanej kolejności:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  13. Zaktualizuj interfejs użytkownika na komputerze 6 i 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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.

  1. Jeśli masz włączone SMTP w Edge, w pliku konfiguracji ustaw parametr SMTPMAILFROM. Ten parametr ma postać:
    SMTPMAILFROM="Moja firma <mojaco@firma.com>"
  2. Zaktualizuj Cassandra i ZooKeeper:
    1. Na komputerach 1, 2 i 3 w Centrum danych 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. Na komputerach 7, 8 i 9 w Centrum danych 2
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Zaktualizuj qpidd:
    1. Maszyny 4 i 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ę komunikatów Qpid na komputerze 4:
        > qpid-stat -q

        Sprawdzaj kolejkę, dopóki liczba w kolumnie „msg” nie wyniesie 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 od 1 do 4 na komputerze 5.
    2. Maszyny 10 i 11 w centrum danych 2
      1. Ustaw na maszynie 10 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 10:
        > 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 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.
  4. Zaktualizuj postgresql:
    1. Machines 6 w Data Center 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
    2. Machines 12 w Data Center 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. 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
  6. Aktualizowanie komponentów Edge:
    1. Maszyny 4, 5, 6, 1, 2, 3 w centrum danych 1
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. Maszyny 10, 11, 12, 7, 8, 9 w centrum danych 2
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. 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

W przypadku instalacji BaaS z 7 hostami interfejsu API

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

# Specify the from address of generated emails.
SMTPMAILFROM="My Company <myco@company.com>"

Pełny przykład pliku konfiguracyjnego znajdziesz w sekcji Instalacja BaaS interfejsu API.

Musisz też zapewnić dostęp do portu 2551 na wszystkich węzłach usługi Stack ze wszystkich innych węzłów tej usługi.

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

  1. Zaktualizuj Cassandra na maszynach 5, 6 i 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. Zaktualizuj ElasticSearch i baas API na maszynach 1, 2 i 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile

  3. Zaktualizuj portal API BaaS na maszynie 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

W przypadku instalacji BaaS interfejsu API z 10 hostami

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

# Specify the from address of generated emails.
SMTPMAILFROM="My Company <myco@company.com>"

Przykład pełnego pliku konfiguracji znajdziesz w artykule Instalacja BaaS API.

Musisz też upewnić się, że port 2551 jest otwarty na wszystkich węzłach stosu, aby mieć do nich dostęp ze wszystkich pozostałych węzłów stosu.

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

  1. Zaktualizuj Cassandra na maszynach 8, 9 i 10:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. Zaktualizuj ElasticSearch na maszynach 1, 2 i 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  3. Zaktualizuj pakiet API BaaS na maszynach 4, 5 i 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  4. Zaktualizuj portal API BaaS na maszynie 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

W przypadku instalacji niestandardowej

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

  1. ZooKeeper
  2. Cassandra
  3. qpidd, ps
  4. LDAP
  5. Edge, czyli profil „-c edge” na wszystkich węzłach w kolejności: węzły z serwerem Qpid, serwer Postgres, serwer zarządzający, przetwarzacz wiadomości i router.
    Uwaga: jeśli na węźle jest zainstalowany zarówno serwer Qpid, jak i serwer Postgres, wykonaj krok profilu „-c edge”.
  6. Interfejs Edge