Aktualizacja Apigee Edge od 4.17.01/4.17.05 do 4.17.09

Edge for Private Cloud w wersji 4.17.09

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

Aby zaktualizować Apigee Edge z wersji 4.17.01.0x/4.17.05.0x do wersji 4.17.09, wykonaj tę procedurę.

Jeśli masz wersję Edge starszą niż 4.16.01, musisz najpierw przejść na wersję 4.16.01.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.

automatyczne propagowanie ustawień obiektu,

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

Wymagane dodanie parametru konfiguracji SMTPMAILFROM

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

W wersji interfejsu API BaaS 4.17.09 dodano też obsługę właściwości SMTPMAILFROM. Podczas aktualizacji interfejsu API BaaS z wersji 4.17.01 lub 4.17.05 musisz ustawić parametr SMTPMAILFROM w pliku konfiguracji.

Ten parametr ma postać:

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

Zaktualizuj wymagania wstępne

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

  • Utwórz kopię zapasową wszystkich węzłów
    Ze względów bezpieczeństwa przed aktualizacją zalecamy utworzenie pełnej kopii zapasowej wszystkich węzłów. Aby utworzyć kopię zapasową, skorzystaj z procedury odpowiedniej dla Twojej bieżącej wersji przeglądarki Edge.

    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, a on będzie kontynuować ją od miejsca, w którym została przerwana.

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

Informacje o 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 katalogu /tmp, narzędzie update.sh nie działa.

Aktualizacja bez przestojów

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

Aktualizacja z zerowym czasem przestoju jest możliwa tylko w przypadku konfiguracji z 5 węzłami lub większą.

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 odpowiednim porządku w ramach instalacji, jak opisano poniżej w sekcji „Kolejność aktualizacji maszyn”.
  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ę na wszystkich pozostałych komputerach w instalacji.

Przed i po aktualizacji wykonaj te czynności:

  • W kompleksowym węźle Router i Message Processor:
    • Przed aktualizacją:
      1. Ustaw router jako nieosiągalny.
      2. Uniemożliwić dostęp do usługi Message Processor.
    • Po aktualizacji wykonaj te czynności:
      1. Upewnij się, że procesor wiadomości jest osiągalny.
      2. Upewnij się, że router jest dostępny.
  • Na jednym węźle Router:
    • Przed aktualizacją ustaw router jako nieosiągalny.
    • 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

Do polecenia aktualizacji musisz przekazać dyskretny plik konfiguracji. Plik konfiguracji w trybie cichy powinien być tym samym plikiem, którego użyto do zainstalowania Edge 4.17.01.

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 zgodnie z instrukcjami podanymi w artykule Install the Edge apige-setup utility (w języku angielskim).
  5. Jeśli instalujesz pakiet w AWS, uruchom to polecenie yum-configure-manager:
    > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  6. Pobierz plik bootstrap_4.17.09.sh z Edge 4.17.09 i zapisz go w pliku /tmp/bootstrap_4.17.09.sh:
    > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
  7. Zainstaluj narzędzie apigee-service w wersji 4.17.09 i jego zależności:
    > sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord

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

    Domyślnie instalator sprawdza, czy masz zainstalowaną Javę w wersji 1.8. Jeśli tego nie zrobisz, zostanie ona zainstalowana automatycznie. Użyj opcji JAVA_FIX, aby określić sposób obsługi instalacji Javy. JAVA_FIX przyjmuje te wartości:

    I = Zainstaluj OpenJDK 1.8 (domyślnie)
    C = kontynuuj bez instalowania języka Java
    Q = Zamknij. Aby skorzystać z tej opcji, musisz samodzielnie zainstalować Javę.
  8. Użyj narzędzia apigee-service do zaktualizowania narzędzia apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  9. Zaktualizuj narzędzie apigee-validate na serwerze zarządzania:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  10. Zaktualizuj narzędzie apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  11. Uruchom narzędzie do aktualizacji na 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 lub czytelny dla użytkownika „apigee”.

    Użyj opcji „-c”, aby określić komponent do zaktualizowania. Lista możliwych komponentów:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =wszystkie komponenty Edge (z wyjątkiem interfejsu Edge UI): serwer zarządzania, procesor wiadomości, router, serwer QPID, serwer Postgres
    ui = interfejs Edge UI
    all = aktualizacja wszystkich komponentów na maszynie (używaj tylko w przypadku profilu instalacji Edge aio lub profilu instalacji API BaaS)
    e = ElasticSearch
    b = pakiet API BaaS
    p = interfejs API BaaS Portal
    ebp = ElasticSearch, pakiet API BaaS i interfejs API BaaS na tym samym węźle
  12. Przetestuj aktualizację, uruchamiając narzędzie apigee-validate na serwerze zarządzania zgodnie z opisem w sekcji Testowanie instalacji.

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

Procedura aktualizacji do wersji 4.17.09 z repozytorium lokalnego

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

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

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

Aby zaktualizować z lokalnego repozytorium 4.17.09:

  1. Utwórz lokalne repozytorium 4.17.09 zgodnie z instrukcjami podanymi w sekcji „Tworzenie lokalnego repozytorium Apigee” w artykule Instalowanie narzędzia apigee-setup na platformie Edge.
    Uwaga: jeśli masz już repozytorium 4.17.01 lub 4.17.05, możesz dodać do niego repozytorium 4.17.09, postępując zgodnie z instrukcjami podanymi w sekcji „Aktualizowanie lokalnego repozytorium Apigee” w artykule Instalowanie narzędzia apigee-setup w wersji Edge.
  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ć apige-service przy użyciu serwera WWW Nginx:
    1. Skonfiguruj serwer WWW Nginx zgodnie z opisem w sekcji „Instalowanie z repozytorium przy użyciu serwera WWW Nginx” w artykule Instalowanie narzędzia Edge apigee-setup.
    2. Na węźle zdalnym pobierz plik bootstrap_4.17.09.sh z Edge do pliku /tmp/bootstrap_4.17.09.sh:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh

      gdzie uName:pWord to nazwa użytkownika i hasło ustawione powyżej dla repozytorium, a remoteRepo to adres IP lub nazwa DNS węzła repozytorium.
    3. Na węźle zdalnym zainstaluj narzędzie apigee-service i zależne od niego komponenty:
      > sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      gdzie uName:pWord to nazwa użytkownika i hasło do repozytorium.
  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
  6. Zaktualizuj narzędzie apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. Uruchom narzędzie do aktualizacji na swoich węzłach w kolejności podanej poniżej w sekcji „Kolejność aktualizacji maszyny”:
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

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

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




  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

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

  • Musisz zaktualizować wszystkie węzły Cassandra i ZooKeeper, zanim zaktualizujesz inne węzły.
  • W przypadku każdego komputera 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 powinien zostać wykonany na wielu maszynach, wykonaj go w podanej kolejności maszyn.
  • Nie ma osobnego kroku, który pozwoliłby zaktualizować sekcję Zarabianie. Jest on aktualizowany, gdy określisz opcję „-c edge”.

Samodzielna instalacja na 1 hoście

  1. Jeśli aktualizujesz z wersji 4.17.01, ustaw SMTPMAILFROM w pliku konfiguracji, jeśli masz włączone SMTP w Edge. 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. Zaktualizuj Qpid i Postgres:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. Uruchom postgresql:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. Aktualizacja LDAP:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Zaktualizuj pozostałe komponenty Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  7. Aktualizacja interfejsu Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Samodzielna instalacja na 2 hostach

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

  1. Jeśli aktualizujesz z wersji 4.17.01, ustaw SMTPMAILFROM w pliku konfiguracji, jeśli masz włączone SMTP w Edge. 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. Zaktualizuj Qpid i Postgres na maszynie 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. Uruchom postgresql na maszynie 2:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. Zaktualizuj LDAP na maszynie 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Zaktualizuj komponenty Edge na maszynach 2 i 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. 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. Jeśli aktualizujesz wersję od wersji 4.17.01, ustaw w pliku konfiguracji funkcję SMTPMAILFROM, o ile włączono SMTP w Edge. Ten parametr ma postać:
    SMTPMAILFROM="Moja firma <mojaco@firma.com>"
  2. Zaktualizuj Cassandra i ZooKeeper na komputerze 1, 2 i 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Zaktualizuj Qpid i Postgres na maszynie 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. Uruchom postgresql na maszynie 4:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. Powtórz kroki 3 i 4 na komputerze 5.
  6. Zaktualizuj LDAP na maszynie 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  7. Zaktualizuj komponenty Edge na maszynach 4, 5, 1, 2, 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. 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. Jeśli aktualizujesz z wersji 4.17.01, ustaw SMTPMAILFROM w pliku konfiguracji, jeśli masz włączone SMTP w Edge. Ten parametr ma postać:
    SMTPMAILFROM="Moja firma <mojaco@firma.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. Zaktualizuj Qpid i Postgres na maszynie 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. Uruchom postgresql na maszynie 6:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. Powtórz kroki 3 i 4 na maszynie 7.
  6. Zaktualizuj LDAP na maszynie 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  7. 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
  8. Zaktualizuj interfejs użytkownika na maszynie 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

Instalacja z 13 hostami w klastrze

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

  1. Jeśli aktualizujesz wersję od wersji 4.17.01, ustaw w pliku konfiguracji funkcję SMTPMAILFROM, o ile 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. Zaktualizuj Qpid i Postgres na maszynie 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. Uruchom postgresql na maszynie 12:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. Powtórz kroki 3 i 4 na komputerze 13.
  6. Zaktualizuj LDAP na maszynach 4 i 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  7. 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
  8. Zaktualizuj interfejs użytkownika na maszynach 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 aktualizujesz z wersji 4.17.01, ustaw SMTPMAILFROM w pliku konfiguracji, jeśli masz włączone SMTP w Edge. Parametr ten ma postać:
    SMTPMAILFROM="Moja firma <myco@company.com>"
  2. Zaktualizuj Cassandra i ZooKeeper:
    1. Na maszynach 1, 2 i 3 w centrum danych 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. Na maszynach 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. Zaktualizuj plik qpidd na komputerze 4:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Powtórz krok 1 na komputerze 5.
    2. Maszyny 10 i 11 w centrum danych 2
      1. Zaktualizuj qpidd na maszynie 10:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Powtórz krok 1 na komputerze 11.
  4. Zaktualizuj postgresql:
    1. Maszyny 6 w Centrum danych 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. Maszyny 1 w Centrum danych 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

  1. W pliku konfiguracji ustaw parametr SMTPMAILFROM. Parametr ten ma postać:
    SMTPMAILFROM="Moja firma <myco@company.com>"
  2. Zaktualizuj Cassandra na maszynach 5, 6 i 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

  3. Zaktualizuj stos BaaS ElasticSearch i interfejsu API na maszynach 1, 2 i 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile

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

W przypadku instalacji BaaS interfejsu API z 10 hostami

  1. Ustaw SMTPMAILFROM w pliku konfiguracji. Parametr ten ma postać:
    SMTPMAILFROM="Moja firma <myco@company.com>"
  2. Zaktualizuj Cassandra na maszynach 8, 9 i 10:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  3. Zaktualizuj ElasticSearch na komputerze 1, 2 i 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  4. Zaktualizuj pakiet API BaaS na maszynach 4, 5 i 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  5. Zaktualizuj portal BaaS API na komputerze 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

Instalacja Baas API w 2 centrum danych

Ta procedura wymaga zaktualizowania węzłów Cassandra w obu centrach danych. Jeśli udostępniasz te węzły Cassandra w usłudze Edge, zwykle aktualizujesz je w ramach procesu aktualizowania usługi Edge.

  1. W plikach konfiguracji ustaw parametr SMTPMAILFROM. Parametr ten ma postać:
    SMTPMAILFROM="Moja firma <myco@company.com>"
  2. Zaktualizuj przestrzenie kluczy Cassandra, podając prawidłowy współczynnik replikacji dla 2 centrów danych. Wystarczy wykonać ten krok tylko raz na dowolnym serwerze Cassandra w dowolnym centrum danych:

    Uwaga: podane niżej polecenia powodują ustawienie współczynnika replikacji na „3”, co oznacza, że w klastrze znajdują się 3 węzły Cassandra. W razie potrzeby zmień tę wartość.
    1. Uruchom narzędzie Cassandra cqlsh:
      > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
    2. Aby ustawić poziomy replikacji przestrzeni kluczy Cassandra, wykonaj te polecenia CQL w wierszu „cqlsh>”:
      1. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      2. cqlsh> ALTER KEYSPACE "Apigee_Baas" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      3. cqlsh> ALTER KEYSPACE "Apigee_Baas_Locks" WITH replikacja = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      4. cqlsh> ALTER KEYSPACE "system_traces" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      5. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      6. Wyświetl przestrzenie klawiszy za pomocą polecenia:
        cqlsh> select * from system.schema_keyspaces;
      7. Wyjdź z cqlsh:
        cqlsh> exit
  3. (Tylko jeśli nie zaktualizowano Cassandra w ramach aktualizowania Edge) Aktualizuj węzły Cassandra w centrum danych 1, po jednym maszynie naraz:
    >> /opt/apigee/apigee-setup/bin/update.sh -c cs -f plik_konfiguracyjny
  4. (Tylko jeśli nie zaktualizujesz Cassandra w ramach aktualizowania Edge) Aktualizuj węzły Cassandra w centrum danych 2, pojedynczo:
    >> /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  5. Zaktualizuj ElasticSearch na maszynach w centrum danych 1, po jednej maszynie naraz:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  6. Zaktualizuj ElasticSearch na maszynach w centrum danych 2, po jednej maszynie naraz:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  7. Zaktualizuj stos BaaS API na maszynach w centrum danych 1, każdy komputer naraz:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  8. Zaktualizuj stos API BaaS na maszynach w centrum danych 2, po jednej maszynie naraz:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  9. Zaktualizuj API BaaS Portal na maszynach w centrum danych 1, po jednej maszynie naraz:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
  10. Zaktualizuj interfejs API BaaS Portal na maszynach w centrum danych 2, po jednej maszynie naraz:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
  11. Zaktualizuj wartości przestrzeni kluczy BaaS. Te przestrzenie kluczy muszą być skonfigurowane do replikowania w momencie instalacji, ale nie muszą być skonfigurowane do replikowania w momencie wykonywania. Usunięcie replikacji spowoduje też zaoszczędzenie pamięci Cassandra.

    Wystarczy, że wykonasz ten krok tylko raz na dowolnym serwerze Cassandra w dowolnym centrum danych:
    1. Uruchom narzędzie Cassandra cqlsh:
      > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
    2. Aby ustawić poziomy replikacji przestrzeni kluczy Cassandra, wykonaj te polecenia CQL:
      1. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH replikacja = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3' };
      2. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH replikacja = { 'class': 'NetworkTopologyStrategy', 'dc-2': '3' };
      3. Wyświetl przestrzenie klawiszy za pomocą tego polecenia:
        cqlsh> select * from system.schema_keyspaces;
      4. Wyjdź z cqlsh:
        cqlsh> exit

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