Z tej sekcji dowiesz się, jak przejść z Apigee Edge w wersji 4.19.06 lub 4.50.00 na 4.51.00.
Kto może przeprowadzić aktualizację
Osobą uruchamiającą aktualizację powinna być ta sama osoba, która pierwotnie zainstalowała Edge lub jako użytkownik roota.
Gdy zainstalujesz pakiety RPM Edge, każdy będzie mógł je skonfigurować.
Które komponenty musisz zaktualizować
Musisz zaktualizować wszystkie komponenty Edge. Edge nie obsługuje konfiguracji zawierającej komponenty z kilku wersji.
Automatyczne propagacja ustawień usługi
Jeśli ustawiłeś jakieś właściwości, edytując pliki .properties
w
/opt/apigee/customer/application
, to te wartości są zachowywane w ramach 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 pod kątem replikacji danych w trybie gotowości mastera. W trakcie procesu aktualizacji, gdy węzły Postgres są wyłączone z powodu aktualizacji, dane analityczne są nadal dostępne. zapisane w węzłach Qpid. Po zaktualizowaniu węzłów Postgres i przywróceniu ich online dane analityczne jest następnie przekazywana do węzłów Postgres.
Sposób aktualizacji Postgres zależy od tego, jak skonfigurowano przechowywanie danych w Węzły Postgres:
- Jeśli na potrzeby węzłów Postgres używasz lokalnego przechowywania danych, musisz
zainstaluj nowy węzeł gotowości Postgres na czas uaktualniania. Po
uaktualnianie się zakończy, możesz wyłączyć nowy węzeł gotowości Postgres.
Dodatkowy węzeł gotowości Postgres jest wymagany, jeśli trzeba wycofać aktualizację z dowolnego powodu. Jeśli musisz wycofać aktualizację, nowy węzeł gotowości Postgres po przywróceniu staje się głównym węzłem Postgres. Dlatego po zainstalowaniu nowym węźle gotowości Postgres, powinien on znajdować się w węźle, który spełnia wszystkie wymagania sprzętowe wymagania serwera Postgres zdefiniowane w Edge Wymagania dotyczące instalacji
W konfiguracji Edge z 1 i 2 węzłami topologie używane do prototypowania i testowania mają tylko jeden węzeł Postgres. Możesz zaktualizować te węzły Postgres bezpośrednio bez konieczności aby utworzyć nowy węzeł Postgres.
- Jeśli na potrzeby węzłów Postgres używasz sieciowej pamięci masowej,
zalecane przez Apigee, nie musisz instalować nowego węzła Postgres. W
poniższych procedur, można pominąć kroki dotyczące instalacji i późniejszych procedur
Węzeł gotowości Postgres.
Przed rozpoczęciem procesu aktualizacji zrób zrzut sieciowy magazynu danych używanego przez Postgres. Następnie, jeśli w trakcie aktualizacji wystąpią błędy i konieczne będzie przywrócenie poprzedniej wersji, możesz przywrócić z niego węzeł Postgres.
Instalowanie nowego Postgres węzeł gotowości
Ta procedura tworzy w nowym węźle serwer gotowości Postgres. Pamiętaj, aby zainstalować nowy serwer gotowości Postgres dla istniejącej wersji Edge (4.19.06 lub 4.50.00), a nie w 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:
- W bieżącym masterze Postgres zmodyfikuj
/opt/apigee/customer/application/postgresql.properties
aby ustawić poniższy token. Jeśli 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 Postgresa serwer gotowości, a new_standby_ip to adres IP nowego węzła gotowości.
- Uruchom ponownie
apigee-postgresql
w instancji głównej Postgres:/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
- Sprawdź, czy nowy węzeł gotowości został dodany, wyświetlając
/opt/apigee/apigee-postgresql/conf/pg_hba.conf
plik w masterze. Zobaczysz, że te wiersze w pliku:host replication apigee existing_standby_ip/32 trust host replication apigee new_standby_ip/32 trust
- Zainstaluj nowy serwer gotowości Postgres:
- Edytuj plik konfiguracyjny użyty do zainstalowania bieżącej wersji Edge, aby określić
następujące:
# 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
- Wyłącz SELinux w sposób opisany w Zainstaluj narzędzie Edge apigee-setup.
- W zależności od tego, którą wersję Edge uaktualniasz, wykonaj jedną z tych czynności:
- Jeśli aktualizujesz Edge z wersji 4.19.06,
pobierz plik Edge loadstrap_4.19.06.sh do
/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 Edge
apigee-service
i zależności:sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord
- Jeśli aktualizujesz Edge z wersji 4.50.00,
pobierz plik Edge loadstrap_4.50.00.sh do
/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 Edge
apigee-service
i zależności:sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
- Jeśli aktualizujesz Edge z wersji 4.19.06,
pobierz plik Edge loadstrap_4.19.06.sh do
- Użyj programu
apigee-service
, aby zainstalować narzędzieapigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Zainstaluj Postgres:
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
- W nowym węźle gotowości uruchom to polecenie:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Upewnij się, że jest wyświetlany w trybie gotowości.
- Edytuj plik konfiguracyjny użyty do zainstalowania bieżącej wersji Edge, aby określić
następujące:
Przeprowadzam lokalne uaktualnianie Postgres
Aby przeprowadzić lokalne uaktualnienie do Postgres 10.17, wykonaj te czynności:
- Uaktualnianie Postgres na hoście głównym
/opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
- Uruchom polecenie konfiguracji na hoście głównym:
apigee-service apigee-postgresql setup -f /opt/silent.conf
- Uruchom polecenie setup na hoście głównym:
apigee-service apigee-postgresql configure
- Uruchom ponownie hosta głównego:
apigee-service apigee-postgresql restart
- Skonfiguruj go jako mastera:
apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf
- Sprawdź, czy host główny się rozpoczął:
apigee-service apigee-postgresql wait_for_ready
- Zatrzymaj tryb gotowości:
apigee-service apigee-postgresql stop
- Uaktualnij tryb gotowości.
Uwaga: jeśli ten krok zakończy się niepowodzeniem, możesz go zignorować.
update.sh
spróbuje aby uruchomić serwer zapasowy z nieprawidłową konfiguracją. Udostępniono 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
- Upewnij się, że tryb gotowości został zatrzymany:
apigee-service apigee-postgresql stop
- Usuń starą konfigurację gotowości:
rm -rf /opt/apigee/data/apigee-postgresql/
- 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 uruchomiony.
Wycofanie węzła Postgres
Po zakończeniu aktualizacji wyłącz nowy węzeł gotowości:
- 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
- Aby uzyskać identyfikator UUID nowego węzła gotowości, uruchom następujące polecenie
curl
na nowym węzeł gotowości:curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self
Identyfikator UUID węzła powinien być widoczny na końcu danych wyjściowych w formacie:
"type" : [ "postgres-server" ], "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
- Zatrzymaj nowy węzeł gotowości, uruchamiając na nim to polecenie:
/opt/apigee/apigee-service/bin/apigee-all stop
- Edytuj w węźle głównym Postgres edycję
/opt/apigee/customer/application/postgresql.properties
. aby usunąć nowy węzeł gotowości z instancjiconf_pg_hba_replication.connection
:conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
- Uruchom ponownie apigee-postgresql w masterze Postgres:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
- Sprawdź, czy nowy węzeł gotowości został usunięty, wyświetlając
/opt/apigee/apigee-postgresql/conf/pg_hba.conf
plik w masterze. Zobaczysz, że tylko ten wiersz:host replication apigee existing_standby_ip/32 trust
- Usuń identyfikator UUID węzła gotowości z ZooKeeper przez wprowadzenie poniższego zarządzania Edge
Wywołanie interfejsu API 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
Zanim uaktualnisz Apigee Edge, musisz spełnić te wymagania wstępne:
- Utwórz kopię zapasową wszystkich węzłów
Przed aktualizacją zalecamy wykonanie pełnej kopii zapasowej wszystkich węzłów, aby zapewnić bezpieczeństwo . Wykonaj procedurę tworzenia kopii zapasowej dla bieżącej wersji Edge.Pozwala to utworzyć plan wykonywania kopii zapasowych na wypadek, gdyby aktualizacja do nowej wersji nie powiodła się. nie działają poprawnie. Więcej informacji o kopii zapasowej znajdziesz w artykule Kopia zapasowa i Przywróć.
- Sprawdzanie, czy przeglądarka Edge działa
Sprawdź, czy podczas procesu aktualizacji przeglądarka Edge jest uruchomiona. Aby to zrobić, użyj polecenia:/opt/apigee/apigee-service/bin/apigee-all status
Nowy interfejs Edge
W tej sekcji znajdziesz informacje na temat interfejsu Edge. Więcej informacji: Nowy interfejs 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 IDP, na przykład SAML lub LDAP.
Więcej informacji znajdziesz w artykule Instalowanie nowego interfejsu Edge.
Aktualizowanie interfejsu Edge
Aby zaktualizować komponent interfejsu Edge dla Twojej chmury, wybierz wersję Edge dla Twojej chmury prywatnej są uaktualniane z wersji:
- Od wersji 4.19.06 lub 4.50.00 do 4.51.00 (z zainstalowanym nowym interfejsem Edge): użyj
instrukcje uaktualniania w tej sekcji dla
Komponent
edge-management-ui
.
Zaktualizuj przy użyciu Apigee mTLS
Aby zaktualizować Apigee mTLS , wykonaj te czynności kroki:
Wycofywanie aktualizacji
W przypadku niepowodzenia aktualizacji możesz spróbować rozwiązać problem, a następnie wykonać aktualizację.
update.sh
. Możesz uruchomić aktualizację kilka razy i kontynuować aktualizację
od tego samego miejsca.
Jeśli błąd wymaga przywrócenia poprzedniej wersji, zapoznaj się z artykułem Aby zapoznać się ze szczegółowymi instrukcjami, przywróć wersję 4.51.00.
Informacje o aktualizacji logów
Domyślnie narzędzie update.sh
zapisuje informacje dziennika w:
/opt/apigee/var/log/apigee-setup/update.log
Jeśli osoba uruchamiająca narzędzie update.sh
nie ma dostępu do
ten katalog zapisze w katalogu /tmp
dziennik w postaci pliku o nazwie
update_username.log
Jeśli użytkownik nie ma dostępu do konta /tmp
, narzędzie update.sh
niepowodzenie.
Aktualizacja z zerowym czasem przestoju
Dzięki aktualizacji bez przestojów (czyli aktualizacji kroczącej) możesz zaktualizować instalację Edge bez Zmniejszając do siebie Edge.
Aktualizacja z zerowym czasem przestoju jest możliwa tylko w przypadku konfiguracji z 5 węzłami lub większą.
Kluczem do uaktualnienia bez przestojów jest usunięcie z obciążenia każdego routera pojedynczo. systemu równoważenia obciążenia. Następnie zaktualizujesz router i wszystkie inne komponenty na tym samym komputerze, co router, a potem z powrotem dodaj router do systemu równoważenia obciążenia.
- Aktualizuj komputery w odpowiedniej kolejności zgodnie z opisem. Kolejność aktualizacji maszyny.
- Gdy przyjdzie czas na aktualizację routerów, wybierz dowolny z nich i ustaw go jako nieosiągalny, opisane w sekcji Włączanie/wyłączanie serwera Osiągalność (procesora wiadomości/routera).
- Zaktualizuj wybrany router i wszystkie pozostałe komponenty Edge na tym samym komputerze, na którym znajduje się router. We wszystkich konfiguracjach brzegowych router i procesor wiadomości znajdują się w tym samym węźle.
- Ustaw router ponownie jako osiągalny.
- Powtórz kroki od 2 do 4 dla pozostałych routerów.
- Kontynuuj aktualizację na wszystkich pozostałych komputerach w instalacji.
Przed aktualizacją i po niej wykonaj te czynności:
- W połączonym węźle routera i procesora wiadomości:
- Przed aktualizacją – wykonaj te czynności:
- Ustaw router jako nieosiągalny.
- Ustaw procesor wiadomości jako nieosiągalny.
- Po aktualizacji:
- Upewnij się, że procesor wiadomości jest osiągalny.
- Ustaw router jako osiągalny.
- Przed aktualizacją – wykonaj te czynności:
- W przypadku pojedynczych węzłów routera:
- Przed aktualizacją ustaw router jako nieosiągalny.
- Po aktualizacji upewnij się, że router jest osiągalny.
- W pojedynczym węźle procesora wiadomości:
- Przed aktualizacją ustaw procesor wiadomości jako niedostępny.
- Po aktualizacji upewnij się, że procesor wiadomości jest osiągalny.
Używanie cichego pliku konfiguracji
Do polecenia aktualizacji musisz przekazać dyskretny plik konfiguracji. Plik konfiguracji cichej (powinien to być ta sama, która była używana do instalacji Edge w wersji 4.19.06 lub 4.50.00).
Zaktualizuj do 4.51.00 na węźle z zewnętrznym połączeniem internetowym
Aby zaktualizować komponenty Edge w węźle, wykonaj te czynności:
- Jeśli jest dostępny, wyłącz wszystkie zadania
cron
skonfigurowane pod kątem wykonywania operacji naprawy Cassandra do momentu zakończenia aktualizacji. - Zaloguj się do węzła jako root, aby zainstalować RPM Edge.
- Zainstaluj
yum-utils
iyum-plugin-priorities
:sudo yum install yum-utils
sudo yum install yum-plugin-priorities
- Wyłącz SELinux zgodnie z opisem w sekcji Instalowanie narzędzie Edge apigee-setup.
- Jeśli instalujesz Oracle 7.x, wykonaj to polecenie:
sudo yum-config-manager --enable ol7_optional_latest
- Jeśli instalujesz w AWS, wykonaj to polecenie
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
- Pobierz plik Edge w wersji 4.51.00
bootstrap_4.51.00.sh
do/tmp/bootstrap_4.51.00.sh
:curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
- Zainstaluj narzędzie i zależności Edge w wersji 4.51.00
apigee-service
przez 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 pomiń pWord, pojawi się prośba o jego podanie.
Domyślnie instalator sprawdza, czy zainstalowano środowisko Java 1.8. Jeśli tego nie zrobisz, tag i instaluje ją.
Użyj opcji
JAVA_FIX
, aby określić sposób obsługi Instalacja Javy. FunkcjaJAVA_FIX
przyjmuje następujące wartości:I
: zainstaluj OpenJDK 1.8 (domyślnie).C
: kontynuuj bez instalowania Javy.Q
: zakończ. Aby skorzystać z tej opcji, musisz samodzielnie zainstalować Javę.
- Użyj narzędzia
apigee-service
, aby zaktualizować narzędzieapigee-setup
, ponieważ następujący przykład:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- Zaktualizuj narzędzie
apigee-validate
na serwerze zarządzania w następujący sposób przykład pokazuje:/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
- Zaktualizuj narzędzie
apigee-provision
na serwerze zarządzania w następujący sposób przykład pokazuje:/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
- Uruchom w węzłach narzędzie
update
, 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ść maszyn .
Gdzie:
- component to komponent Edge, który ma zostać zaktualizowany. Możliwe wartości:
cs
: Cassandraedge
: wszystkie komponenty brzegowe oprócz interfejsu Edge UI: serwer zarządzania, wiadomość Procesor, router, serwer QPID, serwer Postgresldap
: OpenLDAPps
: postgresqlqpid
: qpiddsso
: logowanie jednokrotne w Apigee (jeśli zostało zainstalowane logowanie jednokrotne)ue
: nowy interfejs Edgeui
: klasyczny interfejs Edgezk
: strażnik zoo
- configFile to ten sam plik konfiguracji co poprzednio Zdefiniuj swoje urządzenie Edge komponentów podczas instalacji wersji 4.19.06 lub 4.50.00.
Możesz uruchomić
update.sh
w odniesieniu do wszystkich komponentów przy użyciu ustawienia component na „wszystkie”, 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
- component to komponent Edge, który ma zostać zaktualizowany. Możliwe wartości:
- Ponownie uruchom komponent interfejsu Edge na wszystkich węzłach, w których go działa:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- Przetestuj aktualizację, uruchamiając narzędzie
apigee-validate
w Zarządzaniu serwera zgodnie z opisem w sekcji Testowanie instalacji.
Jeśli później zdecydujesz się wycofać aktualizację, wykonaj procedurę opisaną w Cofnij 4.51.00
Aktualizacja do wersji 4.51.00 z lokalnego repozytorium
Jeśli węzły brzegowe są za zaporą sieciową lub z innego powodu nie mają dostępu z repozytorium Apigee przez internet, możesz przeprowadzić aktualizację z repozytorium lokalnego lub powielanie repozytorium Apigee.
Po utworzeniu lokalnego repozytorium Edge masz 2 opcje aktualizowania Edge z poziomu lokalne repozytorium:
- Utwórz plik .tar repozytorium, skopiuj go do węzła, a następnie zaktualizuj Edge z pliku .tar.
- Zainstaluj serwer WWW w węźle z lokalnym repozytorium, aby inne węzły miały do niego dostęp. Apigee udostępnia serwer WWW NGINX, z którego możesz korzystać. Możesz też skorzystać z własnego serwera WWW.
Aby zaktualizować dane z lokalnego repozytorium 4.51.00:
- Utwórz lokalne repozytorium 4.51.00 zgodnie z opisem w sekcji „Tworzenie lokalnego repozytorium Apigee” o Zainstaluj narzędzie Edge apigee-setup.
- Aby zainstalować usługę apigee z pliku .tar:
- W węźle z lokalnym repozytorium użyj tego 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
- 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. - W nowym węźle wypakuj plik do katalogu
/tmp
:tar -xzf apigee-4.51.00.tar.gz
To polecenie utworzy w katalogu nowy katalog o nazwie
repos
zawierający plik .tar. na przykład/tmp/repos
. - Zainstaluj narzędzie Edge
apigee-service
i zależności z/tmp/repos
:sudo bash /tmp/repos/bootstrap_4.51.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
Zwróć uwagę, że w tym poleceniu umieszczasz ścieżkę do katalogu repozytoriów.
- W węźle z lokalnym repozytorium użyj tego polecenia, aby spakować lokalne repozytorium
do jednego pliku .tar o nazwie
- Aby zainstalować usługę apigee za pomocą serwera WWW NGINX:
- Skonfiguruj serwer WWW NGINX w sposób opisany w sekcji „Instalowanie z repozytorium przy użyciu NGINX” webserver" na stronie Install the Edge apigee-setup.
- W węźle zdalnym pobierz plik Edge
bootstrap_4.51.00.sh
do/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 repozytorium, a remoteRepo to adres IP lub nazwa DNS węzła repozytorium.
- Na węźle zdalnym zainstaluj narzędzie Edge
apigee-setup
i 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.
- Użyj narzędzia
apigee-service
, aby zaktualizować narzędzieapigee-setup
, ponieważ następujący przykład:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- Zaktualizuj narzędzie
apigee-validate
na serwerze zarządzania w następujący sposób przykład pokazuje:/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
- Zaktualizuj narzędzie
apigee-provision
na serwerze zarządzania w następujący sposób przykład pokazuje:/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
- 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, który ma zostać zaktualizowany. Zazwyczaj aktualizujesz
następujące komponenty:
cs
: Cassandraedge
: wszystkie komponenty brzegowe z wyjątkiem interfejsu Edge UI: serwer zarządzania, procesor wiadomości, router, Serwer QPID, serwer Postgresldap
: OpenLDAPps
: postgresqlqpid
: qpiddsso
: logowanie jednokrotne w Apigee (jeśli zostało zainstalowane logowanie jednokrotne)ue
– nowy interfejs Edgeui
: klasyczny interfejs Edgezk
: strażnik zoo
- configFile to ten sam plik konfiguracji co poprzednio definiowanie komponentów Edge podczas instalacji wersji 4.19.06 lub 4.50.00.
Możesz uruchomić
update.sh
w odniesieniu do wszystkich komponentów przy użyciu ustawienia component na „wszystkie”, 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
- component to komponent Edge, który ma zostać zaktualizowany. Zazwyczaj aktualizujesz
następujące komponenty:
- Uruchom ponownie komponenty interfejsu we wszystkich węzłach, w których działa ten interfejs, chyba że zostało to już zrobione:
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
- Przetestuj aktualizację, uruchamiając narzędzie
apigee-validate
w Zarządzaniu serwera zgodnie z opisem w sekcji Testowanie instalacji.
Jeśli później zdecydujesz się wycofać aktualizację, wykonaj procedurę opisaną w Cofnij 4.51.00
Kolejność aktualizacji maszyny
Kolejność aktualizowania komputerów podczas instalacji Edge jest ważna:
- Musisz zaktualizować wszystkie węzły Cassandra i ZooKeeper przed w innych węzłach.
- W przypadku każdego komputera z wieloma składnikami brzegowymi (serwer zarządzania, procesor wiadomości,
routera, serwer QPID, ale nie serwer Postgres), do aktualizacji użyj opcji
-c edge
. jednocześnie. - Jeśli określony krok określa, że powinien być wykonany na wielu maszynach, wykonaj go w określonej kolejności maszyn.
- Nie ma osobnego kroku, jak to zrobić. Jest ona aktualizowana, gdy podasz
Opcja:
-c edge
.
Samodzielne przejście na 1 węzeł
Aby uaktualnić samodzielną konfigurację z 1 węzłem do wersji 4.51.00:
- Zaktualizuj wszystkie komponenty:
/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
- (Jeśli zainstalowano aplikację
apigee-adminapi
) Zaktualizowano narzędzieapigee-adminapi
:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
Samodzielne przejście na 2 węzły
Aby przeprowadzić samodzielną instalację z 2 węzłami, zaktualizuj te komponenty:
Listę topologii Edge i numerów węzłów znajdziesz w artykule Topologie instalacji.
- Zaktualizuj Cassandra i ZooKeeper na komputerze 1:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Zaktualizuj Qpid i Postgres na komputerze 2:
/opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
- Aktualizacja LDAP na komputerze 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Zaktualizuj komponenty Edge na maszynie 2 i 1:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Zaktualizuj interfejs użytkownika na komputerze 1:
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- (Jeśli zainstalowano
apigee-adminapi
) Zaktualizowano narzędzieapigee-adminapi
na komputerze 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (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 zainstalowano SSO.
- Ponownie uruchom komponent interfejsu Edge na komputerze 1:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
Aktualizacja 5-węzłów
W przypadku instalacji z 5 węzłami zaktualizuj te komponenty:
Listę topologii Edge i numerów węzłów znajdziesz w artykule Topologie instalacji.
- Zaktualizuj Cassandra i ZooKeeper na komputerze 1, 2 i 3:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Zaktualizuj Qpid i Postgres na komputerze 4:
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
- Zaktualizuj Qpid i Postgres na komputerze 5:
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
- Aktualizacja LDAP na komputerze 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Zaktualizuj komponenty Edge na maszynie 4, 5, 1, 2, 3:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Zaktualizuj interfejs Edge:
- Klasyczny interfejs: jeśli używasz klasycznego interfejsu, zaktualizuj interfejs
ui
na maszynie 1, jak w przykładzie poniżej:/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- Nowy interfejs Edge: jeśli masz zainstalowany nowy interfejs Edge, zaktualizuj
ue
na odpowiedniej maszynie (nie musi to być komputer 1):/opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
- Klasyczny interfejs: jeśli używasz klasycznego interfejsu, zaktualizuj interfejs
- (Jeśli zainstalowano
apigee-adminapi
) Zaktualizowano narzędzieapigee-adminapi
na komputerze 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (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 zainstalowano SSO.
- Ponownie uruchom komponent interfejsu:
- Klasyczny interfejs: jeśli korzystasz z klasycznego interfejsu użytkownika, uruchom ponownie
edge-ui
na maszynie 1, jak w przykładzie poniżej:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- Nowy interfejs Edge: jeśli masz zainstalowany nowy interfejs Edge, uruchom ponownie
edge-management-ui
na odpowiedniej maszynie (może to nie być komputer) 1):/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- Klasyczny interfejs: jeśli korzystasz z klasycznego interfejsu użytkownika, uruchom ponownie
Uaktualnianie klastra z 9 węzłami
W przypadku klastrowanej instalacji z 9 węzłami zaktualizuj te komponenty:
Listę topologii Edge i numerów węzłów znajdziesz w artykule Topologie instalacji.
- Zaktualizuj Cassandra i ZooKeeper na komputerze 1, 2 i 3:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Aktualizacja Qpid na komputerach 6 i 7:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Zaktualizuj Postgres na komputerze 8:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Zaktualizuj Postgres na komputerze 9:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Aktualizacja LDAP na komputerze 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Zaktualizuj komponenty Edge na maszynie 6, 7, 8, 9, 1, 4 i 5 w tej kolejności:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Zaktualizuj nowy (
ue
) lub klasyczny interfejs (ui
) na komputerze 1:/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- (Jeśli zainstalowano
apigee-adminapi
) Zaktualizuj narzędzieapigee-adminapi
na komputerze 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (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 zainstalowano SSO.
- Ponownie uruchom komponent interfejsu:
- Klasyczny interfejs: jeśli korzystasz z klasycznego interfejsu użytkownika, uruchom ponownie
edge-ui
na maszynie 1, jak w przykładzie poniżej:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- Nowy interfejs Edge: jeśli masz zainstalowany nowy interfejs Edge, uruchom ponownie
edge-management-ui
na odpowiedniej maszynie (może to nie być komputer) 1):/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- Klasyczny interfejs: jeśli korzystasz z klasycznego interfejsu użytkownika, uruchom ponownie
Uaktualnianie klastra z 13 węzłami
Zaktualizuj te komponenty w przypadku klastrowanej instalacji z 13 węzłami:
Listę topologii Edge i numerów węzłów znajdziesz w artykule Topologie instalacji.
- Zaktualizuj Cassandra i ZooKeeper na komputerach 1, 2 i 3:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Aktualizacja Qpid na komputerach 12 i 13:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Zaktualizuj Postgres na komputerze 8:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Zaktualizuj Postgres na komputerze 9:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Aktualizacja LDAP na komputerach 4 i 5:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- 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
- Zaktualizuj nowy (
ue
) lub klasyczny interfejs użytkownika (ui
) na komputerach 6 oraz 7./opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- (Jeśli zainstalowano
apigee-adminapi
) Zaktualizowano narzędzieapigee-adminapi
na komputerach 6 i 7:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (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 zainstalowano SSO.
- Ponownie uruchom komponent interfejsu:
- Klasyczny interfejs: jeśli korzystasz z klasycznego interfejsu użytkownika, uruchom ponownie
edge-ui
na maszynach 6 i 7, jak w tym przykładzie:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- Nowy interfejs Edge: jeśli masz zainstalowany nowy interfejs Edge, uruchom ponownie
Komponent
edge-management-ui
na maszynach 6 i 7:/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- Klasyczny interfejs: jeśli korzystasz z klasycznego interfejsu użytkownika, uruchom ponownie
Uaktualnianie klastra z 12 węzłami
Zaktualizuj te komponenty w przypadku klastrowanej instalacji z 12 węzłami:
Listę topologii Edge i numerów węzłów znajdziesz w artykule Topologie instalacji.
- Zaktualizuj Cassandra i ZooKeeper:
- Na komputerach 1, 2 i 3 w Centrum danych 1:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Na maszynach 7, 8 i 9 w centrum danych 2
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Na komputerach 1, 2 i 3 w Centrum danych 1:
- Aktualizacja pliku qpidd:
- Maszyny 4, 5 w centrum danych 1
- Aktualizacja urządzenia
qpidd
na komputerze 4:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Aktualizacja urządzenia
qpidd
na komputerze 5:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Aktualizacja urządzenia
- Maszyny 10, 11 w centrum danych 2
- Aktualizacja
qpidd
na komputerze 10:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Aktualizacja
qpidd
na komputerze 11:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- Aktualizacja
- Maszyny 4, 5 w centrum danych 1
- Zaktualizuj Postgres:
- Maszyna 6 w centrum danych 1
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Maszyna 12 w centrum danych 2
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- Maszyna 6 w centrum danych 1
- Aktualizacja LDAP:
- Maszyna 1 w centrum danych 1
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Maszyna 7 w Centrum danych 2
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- Maszyna 1 w centrum danych 1
- Aktualizowanie komponentów Edge:
- Maszyny 4, 5, 6, 1, 2, 3 w centrum danych 1
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Maszyny 10, 11, 12, 7, 8, 9 w centrum danych 2
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Maszyny 4, 5, 6, 1, 2, 3 w centrum danych 1
- Zaktualizuj nowy (
ue
) lub klasyczny interfejs (ui
):- Maszyna 1 w Centrum danych 1:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- Maszyna 7 w Centrum danych 2:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- Maszyna 1 w Centrum danych 1:
- (Jeśli zainstalowano aplikację
apigee-adminapi
) Zaktualizowano narzędzieapigee-adminapi
:- .
- Maszyna 1 w Centrum danych 1:
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- Maszyna 7 w Centrum danych 2:
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- Maszyna 1 w Centrum danych 1:
- (Jeśli masz zainstalowane logowanie jednokrotne Apigee) Zaktualizuj logowanie jednokrotne w Apigee:
- Maszyna 1 w Centrum danych 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
- Maszyna 7 w Centrum danych 2:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
Gdzie sso_config_file to plik konfiguracji utworzony podczas zainstalowano SSO.
- Maszyna 1 w Centrum danych 1:
- Uruchom ponownie nowy interfejs Edge (
edge-management-ui
) lub klasyczny interfejs Edge (edge-ui
) na maszynach 1 i 7:/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
W przypadku konfiguracji niestandardowej
Jeśli masz niestandardową konfigurację, zaktualizuj komponenty Edge w następujący sposób zamówienie:
- ZooKeeper
- Cassandra
- qpidd, ps
- LDAP
- Edge, czyli „-c Edge”. we wszystkich węzłach w kolejności: węzły z serwerem Qpid, Serwer Edge Postgres, serwer zarządzania, procesor wiadomości i router.
- Interfejs Edge (klasyczny lub nowy)
apigee-adminapi
- Logowanie jednokrotne w Apigee
Po zakończeniu aktualizacji ponownie uruchom komponent interfejsu Edge na wszystkich uruchomionych komputerach .