Zaktualizuj Apigee Edge do wersji 4.19.06 lub 4.50.00 do 4.51.00

W tej sekcji opisaliśmy, jak przejść z Apigee Edge w wersji 4.19.06 lub 4.50.00 na 4.51.00.

Kto może przeprowadzać aktualizację

Osobą przeprowadzającą aktualizację powinna być ta sama osoba, która pierwotnie zainstalowała Edge lub użytkownik root.

Po zainstalowaniu Edge RPM każdy może je skonfigurować.

Które komponenty musisz zaktualizować?

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

Automatyczne rozpowszechnianie ustawień usługi

Jeśli masz ustawione jakieś właściwości przez edytowanie plików .properties w /opt/apigee/customer/application, wartości te zostaną zachowane po aktualizacji.

Wymagane uaktualnienie do Postgres 10.17

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

Większość systemów produkcyjnych Edge używa 2 węzłów Postgres skonfigurowanych na potrzeby replikacji gotowości głównej. 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.

Sposób aktualizowania Postgres zależy od tego, jak została skonfigurowana pamięć masowa danych dla węzłów Postgres:

  • Jeśli w węzłach Postgres używasz lokalnej pamięci masowej, musisz zainstalować nowy węzeł gotowości Postgres na czas uaktualniania. Po zakończeniu uaktualniania możesz wyłączyć nowy węzeł gotowości 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.

    W konfiguracji Edge z 1 węzłem i 2 węzłami topologie używane do prototypowania i testowania masz tylko 1 węzeł Postgres. Możesz aktualizować te węzły Postgres bezpośrednio bez konieczności tworzenia nowego węzła Postgres.

  • Jeśli używasz pamięci sieciowej węzłów Postgres, zgodnie z zaleceniami Apigee, nie musisz instalować nowego węzła Postgres. Z poniższych procedur możesz pominąć kroki określające instalację, a następnie wycofać nowy węzeł gotowości Postgres.

    Przed rozpoczęciem procesu aktualizacji wykonaj zrzut sieci magazynu danych używanego przez Postgres. Następnie, jeśli podczas aktualizacji wystąpią błędy i trzeba będzie wycofać zmiany, możesz przywrócić węzeł Postgres z tego zrzutu.

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.19.06 lub 4.50.00), a nie dla wersji 4.51.00.

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 replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust

    Gdzie existing_standby_ip to adres IP bieżącego serwera gotowości Postgres, a new_standby_ip to adres IP nowego węzła gotowości.

  2. Uruchom ponownie apigee-postgresql w masterze 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 masterze. Plik powinien zawierać te wiersze: 
    host replication apigee existing_standby_ip/32 trust
host replication apigee new_standby_ip/32 trust
  4. Zainstaluj nowy serwer gotowości Postgres:
    1. Edytuj plik konfiguracyjny użyty do zainstalowania bieżącej wersji Edge, aby określić następujące ustawienia: 
      # IP address of the current master:
PG_MASTER=192.168.56.103
# IP address of the new standby node
PG_STANDBY=192.168.56.102
    2. Wyłącz SELinux zgodnie z opisem w sekcji Instalowanie narzędzia Edge apigee-setup.
    3. Wykonaj jedną z tych czynności w zależności od wersji Edge, którą chcesz uaktualnić:
      • Jeśli przechodzisz z Edge 4.19.06, pobierz plik Edge bootstrap_4.19.06.sh do wersji /tmp/bootstrap_4.19.06.sh : 
        curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh

        Następnie zainstaluj narzędzie i zależności Edge apigee-service: 

        sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord

      • Jeśli przechodzisz z Edge 4.50.00, pobierz plik Edge bootstrap_4.50.00.sh do wersji /tmp/bootstrap_4.50.00.sh : 
        curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh

        Następnie zainstaluj narzędzie i zależności Edge apigee-service: 

        sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord

    4. Użyj apigee-service, aby zainstalować narzędzie apigee-setup: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    5. Zainstaluj Postgres: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    6. W nowym węźle gotowości uruchom to polecenie: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      Potwierdź, że jest w trybie gotowości.

Lokalne uaktualnianie Postgres

Aby przeprowadzić lokalne uaktualnienie do Postgres 10.17, wykonaj te czynności:

  1. Uaktualnij postgres na hoście głównym 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  2. Uruchom polecenie konfiguracji na hoście głównym: 
    apigee-service apigee-postgresql setup -f /opt/silent.conf
  3. Uruchom polecenie konfiguracji na hoście głównym: 
    apigee-service apigee-postgresql configure
  4. Ponownie uruchom hosta głównego: 
    apigee-service apigee-postgresql restart
  5. Skonfiguruj go jako mastera: 
    apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf
  6. Sprawdź, czy host główny został uruchomiony: 
    apigee-service apigee-postgresql wait_for_ready
  7. Zatrzymaj tryb gotowości: 
    apigee-service apigee-postgresql stop
  8. Uaktualnij tryb gotowości.

    Uwaga: jeśli ten krok się nie powiedzie, możesz go zignorować. update.sh spróbuje uruchomić serwer gotowości z nieprawidłową konfiguracją. Jeśli instalacja Postgres zostanie uaktualniona do wersji 10.17, błąd można zignorować.

    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  9. Upewnij się, że tryb gotowości jest zatrzymany: 
    apigee-service apigee-postgresql stop
  10. Usuń starą konfigurację gotowości: 
    rm -rf /opt/apigee/data/apigee-postgresql/
  11. Skonfiguruj replikację na serwerze gotowości: 
    apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf

Po wykonaniu tej procedury tryb gotowości zostanie włączony.

Wyłączanie węzła Postgres

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

  1. Upewnij się, że 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 to polecenie curl w nowym węźle gotowości: 
    curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

    Identyfikator UUID węzła powinien pojawić się na końcu danych wyjściowych w formie: 

    "type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"

  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 nadrzędnym 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 replication apigee existing_standby_ip/32 trust
  5. Uruchom ponownie 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 masterze. W pliku powinien być widoczny tylko ten wiersz: 
    host replication apigee existing_standby_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_standby_uuid

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 wykonanie pełnej kopii zapasowej wszystkich węzłów. Wykonaj procedurę dotyczącą bieżącej wersji Edge, aby utworzyć kopię zapasową.

    Pozwala to utworzyć plan tworzenia kopii zapasowych na wypadek, gdyby aktualizacja do nowej wersji nie działała prawidłowo. Więcej informacji o tworzeniu kopii zapasowych znajdziesz w artykule Tworzenie i przywracanie kopii zapasowej.

  • Upewnij się, że przeglądarka Edge jest uruchomiona
    Podczas procesu aktualizacji upewnij się, że przeglądarka Edge jest uruchomiona, korzystając z polecenia: 
    /opt/apigee/apigee-service/bin/apigee-all status

Nowy interfejs użytkownika Edge

Ta sekcja zawiera uwagi na temat interfejsu użytkownika Edge. Więcej informacji znajdziesz w artykule o nowym interfejsie użytkownika Edge dla Private Cloud.

Instalowanie interfejsu Edge

Po zakończeniu wstępnej instalacji Apigee zaleca zainstalowanie interfejsu Edge, który jest ulepszonym interfejsem dla programistów i administratorów Apigee Edge dla Private Cloud.

Pamiętaj, że interfejs Edge wymaga wyłączenia uwierzytelniania podstawowego i użycia dostawcy tożsamości, takiego jak SAML lub LDAP.

Więcej informacji znajdziesz w temacie Instalowanie nowego interfejsu Edge.

Aktualizowanie interfejsu Edge

Aby zaktualizować komponent interfejsu Edge, weź pod uwagę wersję Edge dla chmury Private Cloud, z której uaktualniasz wersję:

Zaktualizuj za pomocą Apigee mTLS

Aby zaktualizować Apigee mTLS , wykonaj te czynności:

Wycofywanie aktualizacji

W przypadku błędu aktualizacji możesz spróbować rozwiązać problem, a następnie ponownie wykonać zadanie 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 szczegółowe instrukcje dotyczące przywracania wersji 4.51.00.

Informacje o aktualizacjach logowania

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

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

Jeśli osoba uruchamiająca 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 ta osoba nie ma dostępu do konta /tmp, narzędzie update.sh przestanie działać.

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 opisem w sekcji Kolejność aktualizacji maszyny.
  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.

Zadbaj o to, aby przed aktualizacją i po niej:

Użyj cichego pliku konfiguracji

Do polecenia aktualizacji musisz przekazać dyskretny plik konfiguracji. Plik konfiguracji w trybie cichym powinien być taki sam jak ten użyty do zainstalowania Edge 4.19.06 lub 4.50.00.

Aktualizacja do wersji 4.51.00 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 tak, wyłącz wszystkie zadania cron skonfigurowane do wykonywania operacji naprawy na urządzeniu Cassandra do czasu zakończenia aktualizacji.
  2. Zaloguj się w węźle jako użytkownik root, aby zainstalować pakiety RPM Edge.
  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 opisem w sekcji Instalowanie narzędzia Edge apigee-setup.
  5. Jeśli instalujesz Oracle w wersji 7.x, wykonaj to polecenie: 
    sudo yum-config-manager --enable ol7_optional_latest
  6. Jeśli instalujesz w AWS, wykonaj 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
  7. Pobierz plik bootstrap_4.51.00.sh Edge w wersji 4.51.00 do /tmp/bootstrap_4.51.00.sh: 
    curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
  8. Zainstaluj narzędzie Edge 4.51.00 apigee-service i zależności, wykonując to polecenie: 
    sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

    Gdzie uName:pWord to nazwa użytkownika i hasło otrzymane z Apigee. Jeśli pominiesz właściwość pWord, pojawi się prośba o jej podanie.

    Domyślnie instalator sprawdza, czy zainstalowano środowisko Java 1.8. Jeśli tego nie zrobisz, instalator zainstaluje ją za Ciebie.

    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: Wyjdź. W przypadku tej opcji musisz samodzielnie zainstalować język Java.
  9. Zaktualizuj narzędzie apigee-setup za pomocą apigee-service, jak pokazano w tym przykładzie: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  10. Zaktualizuj narzędzie apigee-validate na serwerze zarządzania zgodnie z poniższym przykładem: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  11. Zaktualizuj narzędzie apigee-provision na serwerze zarządzania zgodnie z poniższym przykładem: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  12. Uruchom narzędzie update w swoich węzłach, wykonując to polecenie: 
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    Zrób to w kolejności opisanej w sekcji Kolejność aktualizacji maszyny.

    Gdzie:

    • component to komponent Edge do aktualizacji. Możliwe wartości:
      • cs: Cassandra
      • edge: wszystkie komponenty brzegowe oprócz interfejsu użytkownika Edge: serwer zarządzania, procesor wiadomości, router, serwer QPID, serwer Postgres
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: logowanie jednokrotne w Apigee (jeśli zostało zainstalowane logowanie jednokrotne)
      • ue: nowy interfejs Edge
      • ui: klasyczny interfejs Edge
      • zk: opiekun zoologiczny
    • configFile to ten sam plik konfiguracji, który został użyty do zdefiniowania komponentów Edge podczas instalacji w wersji 4.19.06 lub 4.50.00.

    Możesz uruchomić update.sh dla wszystkich komponentów, ustawiając component na „all”, ale tylko wtedy, gdy masz profil instalacji Edge all-in-one (AIO). Na przykład:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  13. Ponownie uruchom komponent interfejsu Edge we wszystkich węzłach, które go obsługują, jeśli jeszcze tego nie zrobiłeś: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  14. Przetestuj aktualizację, uruchamiając narzędzie apigee-validate na serwerze zarządzania zgodnie z opisem w sekcji Testowanie instalacji.

Jeśli później zdecydujesz się wycofać aktualizację, wykonaj czynności opisane w sekcji Przywracanie wersji 4.51.00.

Aktualizacja z lokalnego repozytorium do wersji 4.51.00

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 4.51.00:

  1. Utwórz lokalne repozytorium w wersji 4.51.00 zgodnie z opisem w sekcji „Tworzenie lokalnego repozytorium Apigee” artykułu Instalowanie narzędzia Edge apigee-setup.
  2. Aby zainstalować usługę apigee-service z pliku .tar:
    1. W węźle z lokalnym repozytorium użyj poniższego polecenia, aby spakować lokalne repozytorium do jednego pliku .tar o nazwie /opt/apigee/data/apigee-mirror/apigee-4.51.00.tar.gz: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. Skopiuj plik .tar do węzła, w którym chcesz zaktualizować Edge. Na przykład skopiuj go do katalogu /tmp w nowym węźle.
    3. W nowym węźle cofnij tar pliku do katalogu /tmp: 
      tar -xzf apigee-4.51.00.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 przeglądarki /tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.51.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      Zwróć uwagę, że to polecenie zawiera ścieżkę do katalogu repos.

  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” artykułu Instalowanie narzędzia Edge apigee-setup.
    2. W węźle zdalnym pobierz plik Edge bootstrap_4.51.00.sh do serwera /tmp/bootstrap_4.51.00.sh: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh

      Gdzie uName:pWord to nazwa użytkownika i hasło ustawione wcześniej dla repozytorium, a remoteRepo to adres IP lub nazwa DNS węzła repozytorium.

    3. W węźle zdalnym zainstaluj narzędzie Edge apigee-setup i jego zależności: 
      sudo bash /tmp/bootstrap_4.51.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      Gdzie uName:pWord to nazwa użytkownika i hasło repozytorium.

  4. Zaktualizuj narzędzie apigee-setup za pomocą apigee-service, jak pokazano w tym przykładzie: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. Zaktualizuj narzędzie apigee-validate na serwerze zarządzania zgodnie z poniższym przykładem: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. Zaktualizuj narzędzie apigee-provision na serwerze zarządzania zgodnie z poniższym przykładem: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. Uruchom narzędzie update w węzłach w kolejności opisanej w sekcji Kolejność aktualizacji maszyny: 
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    Gdzie:

    • component to komponent Edge do aktualizacji. Zazwyczaj aktualizuje się te komponenty:
      • cs: Cassandra
      • edge: wszystkie komponenty brzegowe oprócz interfejsu użytkownika Edge: serwer zarządzania, procesor wiadomości, router, serwer QPID, serwer Postgres
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: logowanie jednokrotne w Apigee (jeśli zostało zainstalowane logowanie jednokrotne)
      • Nowy interfejs użytkownika Edge w ue
      • ui: klasyczny interfejs Edge
      • zk: opiekun zoologiczny
    • configFile to ten sam plik konfiguracji, który został użyty do zdefiniowania komponentów Edge podczas instalacji w wersji 4.19.06 lub 4.50.00.

    Możesz uruchomić update.sh dla wszystkich komponentów, ustawiając component na „all”, ale tylko wtedy, gdy masz profil instalacji Edge all-in-one (AIO). Na przykład:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
  8. Ponownie uruchom komponenty interfejsu we wszystkich węzłach, które go obsługują: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. Przetestuj aktualizację, uruchamiając narzędzie apigee-validate na serwerze zarządzania zgodnie z opisem w sekcji Testowanie instalacji.

Jeśli później zdecydujesz się wycofać aktualizację, wykonaj czynności opisane w sekcji Przywracanie wersji 4.51.00.

Kolejność aktualizacji maszyny

Kolejność aktualizowania maszyn w instalacji Edge jest ważna:

  • 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 aktualizowana, gdy określisz opcję -c edge.

Uaktualnienie niezależne dla 1 węzła

Aby uaktualnić samodzielną konfigurację z 1 węzłem do wersji 4.51.00:

  1. Zaktualizuj wszystkie komponenty: 
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. (Jeśli zainstalowano apigee-adminapi) Zaktualizowano narzędzie apigee-adminapi: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

Uaktualnienie niezależne dla 2 węzłów

W przypadku samodzielnej instalacji z 2 węzłami zaktualizuj te komponenty:

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

  1. Zaktualizuj Cassandra i ZooKeeper na komputerze 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Zaktualizuj Qpid i Postgres na maszynie 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  3. Zaktualizuj LDAP na komputerze 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Zaktualizuj komponenty brzegowe w maszynach 2 i 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. Zaktualizuj interfejs użytkownika na maszynie 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  6. (Jeśli zainstalowano apigee-adminapi) Zaktualizowano narzędzie apigee-adminapi na komputerze 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  7. (Jeśli masz zainstalowane logowanie jednokrotne Apigee) Zaktualizuj logowanie jednokrotne w Apigee na komputerze 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Gdzie sso_config_file to plik konfiguracji utworzony podczas instalowania logowania jednokrotnego.

  8. Ponownie uruchom komponent interfejsu Edge na maszynie 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Uaktualnienie 5 węzłów

W przypadku instalacji składającej się z 5 węzłów zaktualizuj te komponenty:

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

  1. Zaktualizuj Cassandra i ZooKeeper na komputerze 1, 2 i 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Zaktualizuj Qpid i Postgres na maszynie 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
  3. Zaktualizuj Qpid i Postgres na komputerze 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
  4. Zaktualizuj LDAP na komputerze 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Aktualizowanie komponentów brzegowych w maszynie 4, 5, 1, 2, 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Zaktualizuj interfejs Edge:
    • Klasyczny interfejs: jeśli korzystasz z klasycznego interfejsu użytkownika, zaktualizuj komponent ui na komputerze 1 zgodnie z tym przykładem: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    • Nowy interfejs użytkownika Edge: jeśli zainstalowano nowy interfejs użytkownika Edge, zaktualizuj komponent ue na odpowiednim komputerze (może to nie być maszyna 1): 
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  7. (Jeśli zainstalowano apigee-adminapi) Zaktualizowano narzędzie apigee-adminapi na komputerze 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Jeśli masz zainstalowane logowanie jednokrotne Apigee) Zaktualizuj logowanie jednokrotne w Apigee na komputerze 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Gdzie sso_config_file to plik konfiguracji utworzony podczas instalowania logowania jednokrotnego.

  9. Ponownie uruchom komponent UI:
    • Klasyczny interfejs: jeśli korzystasz z klasycznego interfejsu użytkownika, ponownie uruchom komponent edge-ui na komputerze 1, jak pokazano w tym przykładzie: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Nowy interfejs użytkownika Edge: jeśli zainstalowano nowy interfejs użytkownika Edge, uruchom ponownie komponent edge-management-ui na odpowiednim komputerze (może to nie być maszyna 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Uaktualnienie klastra z 9 węzłami

Zaktualizuj te komponenty w przypadku instalacji w klastrze z 9 węzłami:

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

  1. Zaktualizuj Cassandra i ZooKeeper na komputerze 1, 2 i 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Zaktualizuj Qpid na komputerach 6 i 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Aktualizowanie Postgres na komputerze 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Aktualizowanie Postgres na komputerze 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. Zaktualizuj LDAP na komputerze 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Zaktualizuj komponenty Edge w maszynie 6, 7, 8, 9, 1, 4 i 5 w tej kolejności: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Zaktualizuj nowy interfejs użytkownika (ue) lub klasyczny (ui) na komputerze 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (Jeśli zainstalowano apigee-adminapi) Zaktualizuj narzędzie apigee-adminapi na komputerze 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (Jeśli masz zainstalowane logowanie jednokrotne Apigee) Zaktualizuj logowanie jednokrotne w Apigee na komputerze 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Gdzie sso_config_file to plik konfiguracji utworzony podczas instalowania logowania jednokrotnego.

  10. Ponownie uruchom komponent UI:
    • Klasyczny interfejs: jeśli korzystasz z klasycznego interfejsu użytkownika, ponownie uruchom komponent edge-ui na komputerze 1, jak pokazano w tym przykładzie: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Nowy interfejs użytkownika Edge: jeśli zainstalowano nowy interfejs użytkownika Edge, uruchom ponownie komponent edge-management-ui na odpowiednim komputerze (może to nie być maszyna 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Uaktualnienie klastra z 13 węzłami

W przypadku instalacji grupowanej z 13 węzłami zaktualizuj te komponenty:

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

  1. Zaktualizuj Cassandra i ZooKeeper na komputerach 1, 2 i 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Aktualizacja Qpid na komputerach 12 i 13: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Aktualizowanie Postgres na komputerze 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Aktualizowanie Postgres na komputerze 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. Zaktualizuj LDAP na komputerach 4 i 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Zaktualizuj komponenty Edge na komputerach 12, 13, 8, 9, 6, 7, 10 i 11 w tej kolejności: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. Zaktualizuj nowy interfejs użytkownika (ue) lub klasyczny (ui) na komputerach 6 i 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (Jeśli zainstalowano apigee-adminapi) Zaktualizowano narzędzie apigee-adminapi na komputerach 6 i 7: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (Jeśli masz zainstalowane logowanie jednokrotne Apigee) Zaktualizuj logowanie jednokrotne w Apigee na komputerach 6 i 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    Gdzie sso_config_file to plik konfiguracji utworzony podczas instalowania logowania jednokrotnego.

  10. Ponownie uruchom komponent UI:
    • Klasyczny interfejs: jeśli używasz klasycznego interfejsu użytkownika, uruchom ponownie komponent edge-ui na komputerach 6 i 7, jak pokazano w tym przykładzie: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Nowy interfejs użytkownika Edge: jeśli masz zainstalowany nowy interfejs Edge, uruchom ponownie komponent edge-management-ui na komputerach 6 i 7: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

Uaktualnienie klastra z 12 węzłami

W przypadku instalacji grupowanej z 12 węzłami zaktualizuj te komponenty:

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

  1. 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
  2. Zaktualizuj Qpidd:
    1. Maszyny 4 i 5 w Centrum danych 1
      1. Aktualizacja pliku qpidd na maszynie 4: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Aktualizacja qpidd na komputerze 5: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. Maszyny 10, 11 w Centrum danych 2
      1. Aktualizacja qpidd na komputerze 10: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. Aktualizacja qpidd na komputerze 11: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Zaktualizuj Postgres:
    1. Maszyna 6 w centrum danych 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    2. Maszyna 12 w Centrum danych 2 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. Zaktualizuj LDAP:
    1. Maszyna 1 w Centrum danych 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. Maszyna 7 w Centrum danych 2 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Zaktualizuj komponenty 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
  6. Zaktualizuj interfejs nowy (ue) lub klasyczny (ui):
    1. Maszyna 1 w Centrum danych 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
    2. Maszyna 7 w Centrum danych 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  7. (Jeśli zainstalowano apigee-adminapi) Zaktualizowano narzędzie apigee-adminapi:
    1. Maszyna 1 w Centrum danych 1: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
    2. Maszyna 7 w Centrum danych 2: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (Jeśli masz zainstalowane logowanie jednokrotne Apigee) Zaktualizuj logowanie jednokrotne w Apigee:
    1. Maszyna 1 w Centrum danych 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    2. Maszyna 7 w Centrum danych 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

      3. Gdzie sso_config_file to plik konfiguracji utworzony podczas instalowania logowania jednokrotnego.

  9. Ponownie uruchom nowy komponent interfejsu Edge (edge-management-ui) lub klasyczny interfejs Edge (edge-ui) na komputerach 1 i 7: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

W przypadku konfiguracji niestandardowej

Jeśli masz konfigurację 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 tej kolejności: węzły z serwerem Qpid, serwerem Edge Postgres, serwerem zarządzania, procesorem wiadomości i routerem.
  6. interfejs Edge (klasyczny lub nowy).
  7. apigee-adminapi
  8. Logowanie jednokrotne Apigee

Po zakończeniu aktualizacji ponownie uruchom komponent interfejsu Edge na wszystkich komputerach, na których jest uruchomiony.