Edge for Private Cloud wer. 4.17.01
W przypadku błędu podczas aktualizacji do Edge 4.17.01 możesz przywrócić komponent, który spowodował błąd, a następnie ponowić próbę aktualizacji. Jeśli na przykład aktualizacja do Postgres 9.4 nie powiedzie się, możesz wycofać zmiany tylko w węzłach Postgres i spróbować ponownie.
Są 2 sytuacje, w których warto przeprowadzić przywrócenie:
- Przywróć starszą wersję. Na przykład od 4.17.01 do 4.16.09.
- Przywrócenie starszej wersji w tej samej wersji.
Wykonaj poniższą procedurę, by przywrócić zmiany w obu scenariuszach.
Kto może przywracać zmiany
Użytkownik wykonujący przywrócenie musi być taki sam jak użytkownik, który pierwotnie zaktualizował Edge, lub użytkownik root.
Domyślnie komponenty Edge są uruchamiane jako użytkownik „apigee”. W niektórych przypadkach komponenty Edge mogą być używane jako różni użytkownicy. Jeśli na przykład router musi mieć dostęp do portów z podwyższonymi uprawnieniami, takich jak te poniżej 1000, musisz uruchomić router jako użytkownik root lub jako użytkownik z dostępem do tych portów. Możesz też uruchomić jeden komponent jako jeden użytkownik, a drugi jako inny użytkownik.
Komponenty, które można wycofać
Podczas przywracania wcześniejszej wersji pamiętaj o tych warunkach:
- Pięć wymienionych poniżej komponentów Edge ma ten sam kod. Dlatego, aby wycofać dowolny z 5 komponentów w węźle, musisz wycofać dowolny z pięciu zainstalowanych w nim komponentów. Jeśli na przykład w węźle są zainstalowane serwer zarządzania, router i procesor wiadomości, to aby przywrócić dowolny z nich, musisz przywrócić wszystkie 3 elementy.
5 komponentów, które korzystają z tego samego kodu:- Serwer zarządzania
- Router
- procesor komunikatów
- Serwer Qpid
- Serwer Postgres
- Jeśli przeprowadzasz aktualizację z wersji Edge 4.16.01, nie przywracaj wersji Cassandra. Ta wersja Edge zawiera zaktualizowaną wersję Cassandra. Jeśli przywrócisz komponenty, pozostaw Cassandra w wersji 4.17.01.
Od 17.01
Ta sekcja zawiera procedurę przywracania Edge 4.17.01 do poprzedniej wersji. Ta sekcja jest podzielona na 2 części:
- Jeśli aktualizujesz tylko z wersji 4.16.01 lub 4.16.05 – przywrócenie aktualizacji Postgres do wersji 9.4
Ostatnim etapem każdej procedury aktualizacji z wersji 4.16.01 lub 4.16.05 jest zaktualizowanie węzłów Postgres do wersji 9.4. Jeśli aktualizacja się nie powiedzie, możesz ją przywrócić, korzystając z tej procedury. - Przywracanie wszystkich innych komponentów Edge
Skorzystaj z tej procedury, aby przywrócić wszystkie pozostałe komponenty Edge.
Aby wycofać aktualizację Postgres 9.4
Aby wycofać aktualizację Postgres podczas aktualizowania Postgres w konfiguracji gotowości, wykonaj te czynności:
- Awansuj nowy węzeł gotowości na status mastera Postgres. Nowy master Postgres będzie w tej samej wersji co poprzednia instalacja Edge.
- Skonfiguruj stary węzeł gotowości jako węzeł gotowości dla nowego węzła głównego. Stary węzeł gotowości będzie w tej samej wersji co poprzednia instalacja Edge.
- Zarejestruj nowe węzły główne i zapasowe w grupach analitycznych i konsumentów.
Po zakończeniu przywracania stary węzeł nadrzędny nie będzie już potrzebny. Możesz wtedy wyłączyć stary węzeł nadrzędny.
- 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 - Upewnij się, że usługa Postgres jest zatrzymana na 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-serviceedge-postgres-server stopge/optge serviceedge-postgres-server stopge/optge - Jeśli zainstalowano, uruchom Qpid w starym węźle gotowości:
> /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
Uwaga: w wielu konfiguracjach stary węzeł gotowości będzie hostował tylko Postgres, ale nie Qpid. - Awansuj nowy węzeł gotowości jako węzeł główny Postgres:
- Wyznacz nowy węzeł gotowości na nowy węzeł główny:
> apigee-service apigee-postgresql promotion-standby-to-master new_standby_IP
Jeśli pojawi się prośba, wpisz hasło Postgres dla użytkownika „apigee”. Wartość domyślna to „postgres”. - Edytuj plik konfiguracyjny użyty do zainstalowania bieżącej wersji Edge, aby określić:
# adres IP nowego mastera:
PG_MASTER=new_standby_IP
# adres IP starego węzła gotowości
PG_STANDBY=old_standby_IP - Skonfiguruj nowego mastera:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFile
- Wyznacz nowy węzeł gotowości na nowy węzeł główny:
- Ponownie utwórz stary węzeł gotowości:
- Edytuj plik konfiguracyjny użyty do zainstalowania bieżącej wersji Edge, aby podać następujące informacje:
# adres IP nowego mastera:
PG_MASTER=new_standby_IP
# adres IP starego węzła gotowości
PG_STANDBY=old_standby_IP - Usuń katalog danych w starym węźle gotowości:
> cd /opt/apigee/data/apigee-postgresql/pgdata
> rm -rf * - Ponownie skonfiguruj stary węzeł gotowości, aby był węzłem gotowości nowego mastera:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile - Upewnij się, że w starym węźle gotowości działa Postgres:
> /opt/apigee/apigee-service/bin/apigee-all status
Jeśli nie jest uruchomiony, uruchom go:
> /opt/apigee/apigee-service/bin/apigee-serviceedge-postgres-server start
- Edytuj plik konfiguracyjny użyty do zainstalowania bieżącej wersji Edge, aby podać następujące informacje:
- Sprawdź, czy został dodany nowy węzeł gotowości, wyświetlając plik /opt/apigee/apigee-postgresql/conf/pg_hba.conf w nowym masterze.
- Aby wyświetlić bieżące statystyki i informacje o grupach klientów, uruchom 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 Analytics w polu name, a w polu name (nazwa grupy klienta) Zwraca też identyfikatory UUID starego węzła głównego Postgres i węzłów gotowości w polach postgres-server i datastores. - Uzyskaj adres UUID starego mastera, uruchamiając w starym węźle głównym:
> curl -u sysAdminEmail:password:8084/v1/servers/self
Na końcu adresu wyjściowego powinien być widoczny identyfikator UUID e-serwera6” egr18.
Jeśli serwer Postgres nie jest uruchomiony, możesz uruchomić na nim to polecenie, aby określić identyfikator UUID:
> curl -u sysAdminEmail:password http://<ms_IP>:8080/v1/servers?pod=analytics
W wynikach tego polecenia wyświetlany jest identyfikator UUID każdego węzła adresu IP Postres. - Powtórz poprzedni krok, aby uzyskać adresy IP starego węzła gotowości i nowego węzła głównego.
- Usuń stare węzły główne i zapasowe z grupy klientów:
> curl -u sysAdminEmail:password -X DELETE "http://<ms_IP>:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/agent-group-001consumer-group-001/consumer-grupa-klientów0
Atrybuty masterUUID,standbyUUID są podane w takiej samej kolejności, w jakiej pojawiły się powyżej podczas wyświetlania bieżących statystyk i informacji o grupie konsumentów. Konieczne może być określenie ich w formacie standbyUUID,masterUUID.
Właściwość datastores właściwości consumer-groups powinna być teraz pusta. - Usuń z grupy Analytics stare węzły główne i zapasowe:
> curl -u sysAdminEmail:password -X DELETE "http://<ms_IP>:8080/v1/analytics/groups/ax/axgroup-001/postservers?underuid=masterUUID,standbymasterUUID
- Zarejestruj nowe węzły główne i gotowe PG w grupach Analytics i konsumentów:
> curl -u sysAdminEmail:password -X POST -H "Content-Type: application/json" -d '' "http://<adres_IP>:8080/v1/analytics/groups/IP:server0?axgroup - Zweryfikuj grupę statystyk:
> curl -u sysAdminEmail:password http://<ms_IP>:8080/v1/analytics/groups/ax
Powinny się wyświetlić identyfikatory UUID nowych węzłów głównych i gotowości znajdujących się w grupie analityki i w grupie konsumentów. - Ponownie uruchom serwer zarządzania brzegowymi:
> /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 te skrypty na obu serwerach. Aby zapewnić prawidłową replikację, system powinien wyświetlić identyczne wyniki na obu serwerach:
Na nowym masterze uruchom:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
Potwierdź, że jest to serwer główny.
W starym węźle gotowości:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
Sprawdź, czy wskazuje on tryb gotowości. - Po wykonaniu kilku żądań do interfejsu API powtórz poprzedni krok, aby upewnić się, że węzły są zsynchronizowane.
- Usuń starego mastera Postgres, wykonując procedurę aktualizacji Apigee Edge do wersji 4.16.09.
Uwaga: jeśli stary węzeł nadrzędny uruchamiał Qpid, możesz pozostawić ten serwer bez zmian, aby uruchomić Qpid. Upewnij się, że działa. Jeśli nie, uruchom go:
> /opt/apigee/apigee-service/bin/apigee-service Edge-management-server start
Możesz też odinstalować Qpid ze starego mastera i zainstalować Qpid w nowym węźle nadrzędnym, jak opisano poniżej. Po odinstalowaniu Qpid możesz wyłączyć stary węzeł główny.
Odinstaluj Qpid ze starego mastera i zainstaluj Qpid na nowym
Wykonaj te czynności, aby odinstalować Qpid ze starego mastera i zainstalować go w nowym:
- Zablokuj dostęp procesorom wiadomości do portu Qpid 5672 w starym masterze, uruchamiając to polecenie we wszystkich procesorach wiadomości:
> iptables -A OUTPUT -p tcp -d 10.233.147.20 --dport 5672 -j DROP - Sprawdź, czy kolejka wiadomości Qpid jest pusta, uruchamiając poniższe polecenie. Nie możesz odinstalować Qpid, dopóki nie przetworzy on wszystkich oczekujących wiadomości:
> qpid-stat -q
To polecenie wyświetla tabelę zawierającą liczbę zdarzeń msg, msgIn i msgOut. Wszystkie wiadomości zostaną przetworzone, gdy: msg=0 i msgIn=msgOut. - Ustal identyfikator UUID serwera Qpid na starym masterze, uruchamiając następujące polecenie na starym masterze. Zapisz te informacje na później:
> curl -u sysAdminEmail:password http://<adres_IP_węzła>::8083/v1/servers/self - Zatrzymaj Qpid w starym masterze:
> /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd stop - Odinstaluj serwer Qpid:
> /opt/apigee/apigee-service/bin/apigee-serviceedge-qpid-server zapisz
> /opt/apigee/apigee-service/bin/apigee-service apigee-qpiddrób - Usuń stary serwer Qpid z grup Analytics i grup indywidualnych:
> curl -u sysAdminEmail:password -X DELETE -H "Content-Type: application/json" -d '' "http://<ms_IP>:8080/v1/analytics/groups/ax/axgroup-001<adres_IP>:8080/v1/analytics/groups/ax/axgroup-001 - Usuń stary serwer Qpid z Zookeeper:
> curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/qpid_UUID - Zainstaluj Qpid w nowym masterze:
> /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile - Określ identyfikator UUID serwera Qpid w nowym masterze, uruchamiając na nim poniższe polecenie. Zapisz te informacje na później:
> curl -u sysAdminEmail:password http://<adres_IP_węzła>::8083/v1/servers/self - Zarejestruj nowy serwer Qpid w grupach Analytics i konsumenckich:
> curl -u sysAdminEmail:password -X POST -H "Content-Type: application/json" -d '' "http://<ms_IP>:8080/v1/analytics/groups/groups/axType/axgroup-00? - Uruchom ponownie wszystkie procesory wiadomości:
> /opt/apigee/apigee-service/bin/apigee-service Edge-message-processor restart - Na nowym serwerze Qpid uruchom to polecenie, aby sprawdzić, czy utworzono kolejki:
> qpid-stat -q
Sprawdź, czy panel msg, msgIn i msgOut jest aktualizowany, gdy serwer Qpid przetwarza wiadomości.
Aby przywrócić poszczególne komponenty z wersji 4.17.01
W ramach procesu przywracania musisz pobrać plik bootstrap.sh dla bieżącej wersji Edge:
- Jeśli chcesz wrócić do wersji 4.16.09, pobierz plik bootstrap_4.16.09.sh
- Aby wrócić do wersji 4.16.05, pobierz plik bootstrap_4.16.05.sh
- Jeśli chcesz wrócić do wersji 4.16.01, pobierz plik bootstrap.sh
W przypadku każdego węzła hostującego komponent, który ma zostać przywrócony:
- Zatrzymaj komponent, który chcesz przywrócić:
-
Jeśli przywracasz jeden z tych komponentów w węźle, musisz zatrzymać go wszystkie: serwer zarządzania, router, procesor wiadomości, serwer Qpid lub serwer Postgres:
- > apigee-service streaming-management-server stop
- > apigee-service usługa brzegowa zatrzymania
- > apigee-service Edge-message-processor stop
- > apigee-service Edge-qpid-server stop
- > apigee-service Edge-postgres-server stop
-
Jeśli przywracasz inny komponent w węźle, zatrzymaj tylko ten komponent:
- > apigee-service comp stop
-
Jeśli przywracasz jeden z tych komponentów w węźle, musisz zatrzymać go wszystkie: serwer zarządzania, router, procesor wiadomości, serwer Qpid lub serwer Postgres:
- Jeśli wycofujesz funkcję Monetization, odinstaluj ją ze wszystkich węzłów serwera zarządzania i procesora wiadomości:
> apigee-service Edge-mint-gateway odinstaluj - Aby przywrócić poprzednią wersję węzła, odinstaluj komponent:
- Jeśli przywracasz którykolwiek z tych komponentów w węźle, odinstaluj je wszystkie: Serwer zarządzania, Router, Procesor wiadomości, Serwer Qpid lub Postgres Server:
> apigee-service brzegowa brama brzegowa - Jeśli przywracasz dowolny inny komponent w węźle, odinstaluj tylko ten:
> apigee-service comp odinstaluj - Jeśli przywracasz router do poprzedniej wersji, musisz usunąć zawartość pliku /opt/nginx/conf.d:
> cd /opt/nginx/conf.d
> rm -rf *
- Jeśli przywracasz którykolwiek z tych komponentów w węźle, odinstaluj je wszystkie: Serwer zarządzania, Router, Procesor wiadomości, Serwer Qpid lub Postgres Server:
-
Aby przywrócić komponent:
- Odinstaluj wersję apigee-setup w wersji 4.17.01:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup zapisz - Pobierz plik bootstrap.sh dla wersji 4.16.01, 4.16.05, lub 4.16.09:
Na przykład dla wersji 4.16.09:
> curl https://software.apigee.com/bootstrap_4.16.09.sh -o1.sh.sh. - Zainstaluj narzędzie oraz jego zależności w wersjach 4.16.01, 4.16.05 lub 4.16.09 apigee-service.
Na przykład w przypadku 4.16.09:
> sudo bash /tmp/bootstrap_4.16.09.sh apigeeuser=uName apigeepassword=pWord
gdzie uName i pWord to te dane, które pochodzą z Apigeepassword. i pWord. Jeśli pominiesz parametr pWord, pojawi się prośba o jego podanie. - Zainstaluj wersję 4.16.01, 4.16.05, lub 4.16.09 apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup setup - Zainstaluj wersję 4.16.01, 4.16.05, lub 4.16.09:
> /opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile
gdzie komp4.0, 1.0 i 4.0 to komponent do zainstalowania 4.0.5 to komponent do zainstalowania i pliku. - Jeśli przywracasz Qpid, wyczyść iptables:
> sudo iptables -F
- Odinstaluj wersję apigee-setup w wersji 4.17.01:
-
Aby przywrócić komponent do określonej wersji 4.17.01:
- Pobierz konkretną wersję komponentu:
> /opt/apigee/apigee-service/bin/apigee-service/bin/apigee-service comp-version zainstaluj
gdzie comp-version to komponent i wersja do zainstalowania. Na przykład:
> /opt/apigee/apigee-service/bin/apigee-serviceedge-ui-4.17.01-0.0.3749 zainstaluj
Jeśli używasz duplikatu internetowego repozytorium Apigee, możesz określić dostępne wersje komponentu, używając tego polecenia:
> yum-show example lists
yum - Zainstaluj komponent apigee-setup:
> /opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile
Na przykład:
> /opt/apigee/apigee-setup/bin/how-setup.sh -p Uwaga: jeśli używasz tylko interfejsu
podczas instalacji,
Uwaga: jeśli używasz interfejsu instalowania tego komponentu,
- Pobierz konkretną wersję komponentu:
Jeśli podczas przywracania wcześniejszej wersji wystąpią problemy, skontaktuj się z zespołem pomocy Apigee.