Jeśli podczas aktualizowania do wersji Edge 4.52.01 wystąpi błąd, możesz przywrócić który spowodował błąd, a następnie spróbuj ponownie przeprowadzić aktualizację.
Możesz przywrócić Edge 4.52.01 do tych głównych wersji:
- Wersja 4.52.00
- Wersja 4.51.00
Możesz wykonać cofnięcie zmian w 2 sytuacjach:
- Przywracanie poprzedniej wersji głównej lub podrzędnej Na przykład z od 4.52.01 do 4.52.00.
- Przywróć poprzednią wersję poprawki w ramach tej samej 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 komponenty Edge mogą być uruchamiane jako różne użytkownicy. 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.
Przywróć poprzednią wersję główną lub podrzędną.
Aby przywrócić poprzednią główną lub pomocniczą wersję, wykonaj te czynności na każdym węźle, na którym hostowany jest komponent:
-
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.01 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
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 to instalowany komponent, a configFile to plik konfiguracji 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 poprawki
Aby wycofać komponent do określonej wersji poprawki, 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 wersja komponentu i poprawka 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
- Aby zainstalować komponent, użyj
apigee-setup
:/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.01 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:
- Ustaw nowy węzeł zapasowy jako węzeł główny Postgresa. 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 usługa Postgres jest uruchomiona, zatrzymaj ją:
/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ł zapasowy został już uaktualniony do nowszej wersji, musisz najpierw obniżyć wersję oprogramowania Apigee na starym węźle zapasowym. Jeśli na starym węźle zapasowym nadal masz starszą wersję, możesz pominąć ten krok i przejść do kroku 6.
- Zatrzymaj Postgres na starym węźle zapasowym:
apigee-service apigee-postgresql stop apigee-service edge-postgres-server stop
- Odinstaluj Postgresa ze starego węzła zapasowego:
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 spowoduje 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 na starym węźle zapasowym:
- 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 zapasowe 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
w przypadkuconsumer-groups
powinna być teraz pusta. - 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
W grupie analitycznej i grupie konsumentów powinny się wyświetlić identyfikatory UUID nowych węzłów głównych i zapasowych.
- 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 serwer główny Postgres, wykonując procedurę Wycofywanie z użycia węzła 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