Jeśli podczas aktualizowania do wersji Edge 4.52.00 wystąpi błąd, możesz przywrócić który spowodował błąd, a następnie spróbuj ponownie przeprowadzić aktualizację.
Edge 4.52.00 możesz przywrócić do tych wersji funkcji:
- Wersja 4.51.00
Istnieją 2 sytuacje, w których możesz chcieć przywrócić poprzednią wersję aplikacji:
- Przywracanie poprzedniej wersji funkcji. Na przykład z od 4.52.00 do 4.51.00.
- Przywróć poprzednią wersję aktualizacji w tym samym wersji. Na przykład od 4.52.00.02 do 4.52.00.01.
Więcej informacji znajdziesz w artykule o wersji Apigee Edge .
Kto może przywrócić poprzednią wersję aplikacji
Użytkownik wykonujący przywrócenie poprzedniej wersji powinien być tym samym użytkownikiem, który pierwotnie zaktualizował Edge lub z wykorzystaniem roota.
Domyślnie komponenty Edge działają jako „apigee” użytkownika. W niektórych przypadkach możesz używać Edge jako różnych użytkowników. Jeśli na przykład router musi mieć dostęp do portów z podwyższonymi uprawnieniami, takich jak poniżej 1000, musisz uruchomić router jako użytkownik root lub użytkownik z dostępem do tych porty. Możesz też uruchomić jeden komponent jako jeden użytkownik, a drugi jako inny użytkownik.
Komponenty ze wspólnym kodem
Poniższe komponenty Edge mają wspólny kod. Dlatego, aby wycofać dowolną tych komponentów w węźle, musisz wycofać wszystkie te komponenty, które znajdują się w tym węźle.
edge-management-server
(serwer zarządzania)edge-message-processor
(system przetwarzania wiadomości)edge-router
(router)edge-postgres-server
(serwer Postgres)edge-qpid-server
(serwer Qpid)
Jeśli na przykład na serwerze zarządzania, routerze i procesorze wiadomości i wycofać dowolną z nich.
Przywracanie poprzedniej wersji funkcji
Aby przywrócić poprzednią wersję funkcji, wykonaj te czynności na każdym węźle, który hostuje składnik:
-
Pobierz plik
bootstrap.sh
dla wersji, którą chcesz zastosować plecy:- Aby przywrócić wersję 4.51.00, pobierz
bootstrap_4.51.00.sh
:curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
- Aby przywrócić wersję 4.51.00, pobierz
- Zatrzymaj komponent do wycofania:
- Aby wycofać dowolny z komponentów ze wspólnym kodem w
musisz zatrzymać je wszystkie, jak pokazano w poniższym przykładzie:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-router stop
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
- Aby przywrócić poprzednią wersję dowolnego komponentu innego w węźle, zatrzymaj tylko ten komponent:
/opt/apigee/apigee-service/bin/apigee-service component stop
- Aby wycofać dowolny z komponentów ze wspólnym kodem w
musisz zatrzymać je wszystkie, jak pokazano w poniższym przykładzie:
- Jeśli chcesz przywrócić zarabianie, odinstaluj tę funkcję z serwera zarządzania i wiadomości
Węzły procesora:
/opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
- Odinstaluj komponent, aby przywrócić poprzednią wersję w węźle:
- Aby wycofać dowolny z komponentów ze wspólnym kodem w
węzła, musisz je wszystkie odinstalować, odinstalowując komponent
edge-gateway
jak w tym przykładzie:/opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
- Aby przywrócić dowolny inny komponent w węźle, odinstaluj tylko ten komponent, ponieważ
następujący przykład:
/opt/apigee/apigee-service/bin/apigee-service component uninstall
Gdzie component to nazwa komponentu.
- Aby przywrócić router brzegowy, musisz usunąć zawartość
/opt/nginx/conf.d
, oprócz odinstalowania Grupa komponentówedge-gateway
:cd /opt/nginx/conf.d
rm -rf *
- Aby wycofać dowolny z komponentów ze wspólnym kodem w
węzła, musisz je wszystkie odinstalować, odinstalowując komponent
- Odinstaluj wersję 4.52.00 aplikacji
apigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
- Zainstaluj wersję 4.51.00 aplikacji
apigee-service
i ich zależnościami. Poniższy przykład instaluje wersję 4.51.00apigee-service
:sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord
Gdzie uName i pWord to otrzymana nazwa użytkownika i hasło z Apigee. Jeśli pominiesz pWord, pojawi się prośba o jego podanie.
Jeśli pojawi się błąd, sprawdź, czy w kroku został pobrany plik
bootstrap.sh
. 1. - Zainstaluj aplikację
apigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Zainstaluj starszą wersję komponentu:
/opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile
Gdzie component jest komponentem do zainstalowania, a configFile to komponent i konfigurację starszej wersji.
- Jeśli wycofujesz zmiany Qpid, opróżnij pliki iptables:
sudo iptables -F
- Powtórz ten proces dla każdego węzła hostującego wycofywany komponent.
Przywracanie poprzedniej wersji aktualizacji
Aby przywrócić komponent do określonej wersji wersji, w każdym węźle wykonaj te czynności który hostuje komponent:
- Pobierz konkretną wersję komponentu:
/opt/apigee/apigee-service/bin/apigee-service component_version install
Gdzie component_version to komponent i wersja do zainstalowania. Dla: przykład:
/opt/apigee/apigee-service/bin/apigee-service edge-ui-4.51.05-0.0.3749 install
Jeśli korzystasz z repozytorium online Apigee, możesz określić dostępny komponent za pomocą tego polecenia:
yum --showduplicates list comp
Na przykład:
yum --showduplicates list edge-ui
- Użyj narzędzia
apigee-setup
, aby zainstalować komponent:/opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile
Na przykład:
/opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile
Pamiętaj, że podczas instalacji podajesz tylko nazwę komponentu, a nie wersję.
- Powtórz ten proces dla każdego węzła hostującego wycofywany komponent.
Cofanie aktualizacji Postgres 10.17
W przypadku uaktualnienia do wersji 4.52.00 z wersji 4.50.00 lub 4.51.00 musisz wycofać Aktualizuj Postgres, a nie tylko komponenty Edge.
Aby wycofać aktualizację Postgres podczas aktualizowania Postgres w konfiguracji stanu głównego:
- Awansuj nowy węzeł gotowości na główny węzeł Postgres. Nowy master Postgres zostanie taką samą wersję jak poprzednia instalacja Edge.
- Skonfiguruj stary węzeł gotowości tak, aby był węzłem gotowości nowego mastera. Stary węzeł gotowości będzie taka sama jak poprzednia instalacja Edge
- Zarejestruj nowe węzły główne i gotowości w grupach Analytics i konsumentów.
Po zakończeniu przywracania stary węzeł główny nie będzie już potrzebny. Dostępne opcje a następnie wyłączyć stary węzeł główny.
- Sprawdź, czy nowy węzeł gotowości 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
- Sprawdź, czy Postgres został zatrzymany w starym węźle głównym i starym węźle gotowości:
/opt/apigee/apigee-service/bin/apigee-all status
Jeśli Postgres jest uruchomiony, zatrzymaj go:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
- Jeśli zainstalowano usługę Qpid, uruchom ją w starym węźle gotowości:
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
- Awansuj nowy węzeł gotowości jako główny Postgres:
- Awansuj nowy węzeł gotowości na nowy węzeł nadrzędny:
apigee-service apigee-postgresql promote-standby-to-master new_standby_IP
Jeśli pojawi się prośba, wpisz hasło Postgres dla „apigee” user, która jest domyślnie ustawiona jako „postgres”.
- Edytuj plik konfiguracyjny użyty do zainstalowania bieżącej wersji Edge, aby określić
następujące:
# IP address of the new master: PG_MASTER=new_standby_IP # IP address of the old standby node PG_STANDBY=old_standby_IP
- Skonfiguruj nowy wzorzec:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFile
- Awansuj nowy węzeł gotowości na nowy węzeł nadrzędny:
- Jeśli stary węzeł gotowości został już uaktualniony do nowszej wersji, musisz najpierw
przełączyć oprogramowanie Apigee na starszą wersję w starym węźle gotowości. Jeśli nadal masz starszą wersję na starej
węzła gotowości, możesz pominąć ten krok i przejść do kroku 6.
- Zatrzymaj Postgres w starym węźle gotowości:
apigee-service apigee-postgresql stop apigee-service edge-postgres-server stop
- Odinstaluj Postgres ze starego węzła gotowości:
apigee-service apigee-postgresql uninstall apigee-service edge-postgres-server uninstall
- Usuń katalog danych Postgres ze starego węzła gotowości:
cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *
- Pobierz i uruchom starszą wersję wczytywania (dla używanej przez Ciebie wersji Apigee w starym węźle gotowości. Dokładne czynności mogą się różnić w zależności od tego, przez internet lub w trybie offline. Uruchomienie starszej wersji Apigee przy wczytywaniu Apigee skonfigurować repozytoria yum przy użyciu starszej wersji danych Apigee.
- Skonfiguruj komponenty Postgres w starym węźle gotowości:
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
- Sprawdź, czy komponenty Postgres w starym węźle gotowości
zostały przywrócone do starszej wersji:
apigee-service apigee-postgresql version apigee-service edge-postgres-server version
- Zatrzymaj Postgres w starym węźle gotowości:
- Utwórz ponownie stary węzeł gotowości:
- Edytuj plik konfiguracyjny użyty do zainstalowania bieżącej wersji Edge, aby określić
następujące:
# IP address of the new master: PG_MASTER=new_standby_IP # IP address of the old standby node PG_STANDBY=old_standby_IP
- Usuń katalog danych w starym węźle gotowości:
cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *
- Skonfiguruj ponownie stary węzeł gotowości tak, aby był węzłem gotowości nowego węzła głównego:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
- Sprawdź, czy Postgres działa w starym węźle gotowości:
/opt/apigee/apigee-service/bin/apigee-all status
Jeśli Postgres nie jest uruchomiony, uruchom go:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
- Edytuj plik konfiguracyjny użyty do zainstalowania bieżącej wersji Edge, aby określić
następujące:
- Sprawdź, czy nowy węzeł gotowości został dodany, wyświetlając
/opt/apigee/apigee-postgresql/conf/pg_hba.conf
w nowym wzorcu. - Wyświetl bieżące statystyki i informacje o grupach konsumentów, uruchamiając następujące polecenie
na serwerze zarządzania:
curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax
To polecenie zwraca nazwę grupy analitycznej w polu
name
, a parametr w poluname
w kolumnieconsumer-groups
. Dodatkowo zwraca identyfikatory UUID starych węzłów głównych i gotowości Postgres wpostgres-server
idatastores
. Zobaczysz, że dane wyjściowe w formacie:{ "name" : "axgroup-001", "properties" : { }, "scopes" : [ "VALIDATE~test", "sgilson~prod" ], "uuids" : { "qpid-server" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ], "postgres-server" : [ "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256" ] }, "consumer-groups" : [ { "name" : "consumer-group-001", "consumers" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ], "datastores" : [ "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256" ], "properties" : { } } ], "data-processors" : { } }
- Uzyskaj adres UUID starego mastera, uruchamiając na urządzeniu następujące polecenie
curl
stary węzeł główny: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"
- Powtórz poprzedni krok, aby uzyskać adresy IP starego i nowego węzła gotowości głównym.
- Usuń stare węzły główne i gotowości z grupy konsumentów:
curl -u sysAdminEmail:password -X DELETE \ "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores/masterUUID,standbyUUID" -v
Gdzie axgroup-001 i consumer-group-001 to domyślne nazwy funkcji analiz i grup konsumentów. masterUUID,standbyUUID są w tej samej kolejności pojawia się powyżej, gdy wyświetlisz aktualne informacje o bieżących danych analitycznych i o grupie konsumentów powyżej. Ty może być konieczne określenie ich jako standbyUUID,masterUUID.
Właściwość
datastores
elementuconsumer-groups
powinna teraz być puste. - Usuń z grupy analitycznej stary węzeł główny i węzeł gotowości:
curl -u sysAdminEmail:password -X DELETE \ "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v
Właściwość
postgres-server
w poluuuids
powinna być teraz pusta. - Zarejestruj nowe węzły główne i gotowości PG w grupach analitycznych i dla konsumentów:
curl -u sysAdminEmail:password -X POST -H "Content-Type: application/json" -d '' "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v
curl -u sysAdminEmail:password -X POST -H "Content-Type:application/json" -d '' "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores?uuid=masterUUID,standbyUUID" -v
- Zweryfikuj grupę statystyk:
curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax
Identyfikatory UUID nowych węzłów głównych i gotowości powinny wyświetlić się w grupie Analytics. i grupę konsumentów.
- Ponownie uruchom serwer zarządzania brzegiem:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
- Uruchom ponownie wszystkie serwery Qpid:
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
- Uruchom ponownie wszystkie serwery Postgres:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
- Sprawdź stan replikacji, uruchamiając poniższe skrypty na obu serwerach. System
powinny wyświetlać identyczne wyniki na obu serwerach, aby zapewnić pomyślną replikację:
Na nowym wzorcu uruchom polecenie:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
Sprawdź, czy jest to plik główny. W starym węźle gotowości:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Sprawdź, czy jest to tryb gotowości.
- Powtórz poprzedni krok po wykonaniu kilku żądań do interfejsu API, aby mieć pewność, że węzły są synchronizację.
- Wycofaj stary master Postgres, korzystając z procedury w
Wycofanie
Węzeł Postgres.
.
Możesz też odinstalować Qpid ze starego wzorca i zainstaluj Qpid w nowym węźle głównym. Po odinstalowaniu narzędzia Qpid możesz wyłączyć starego węzła głównego.
Wycofaj mTLS
Aby wycofać aktualizację mTLS, na wszystkich hostach wykonaj te czynności:
- Zatrzymaj Apigee:
apigee-all stop
- Zatrzymaj mTLS:
apigee-service apigee-mtls uninstall
- Ponownie zainstaluj mTLS:
apigee-service apigee-mtls install
apigee-service apigee-mtls setup -f /opt/silent.conf