Ponowne instalowanie i przywracanie komponentów

Ten dokument dotyczy ponownej instalacji i przywracania komponentu Edge. Użyj tej procedury, jeśli przed przywróceniem kopii zapasowej musisz ponownie zainstalować komponent Edge.

Apache ZooKeeper

Przywracanie jednego samodzielnego węzła

1. Zatrzymaj ZooKeepera:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

2. Usuń stare katalogi ZooKeeper:

   /opt/apigee/data/apigee-zookeeper
   /opt/apigee/etc/apigee-zookeeper.d

3. Ponownie zainstaluj ZooKeeper:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper install

4. Przywracanie ZooKeepera:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restore 2019.03.17,14.40.41

   Pamiętaj, że podczas przywracania komponentu nie podajesz ścieżki do katalogu pliku kopii zapasowej ani prefiksu „backup-” ani sufiksu „.tar.gz”. Określasz tylko datę i godzinę w nazwie pliku kopii zapasowej.

   Możesz pominąć plik kopii zapasowej w poleceniu restore, a Edge użyje najnowszego pliku kopii zapasowej w katalogu kopii zapasowych komponentu.

5. Uruchom ponownie wszystkie komponenty:

   /opt/apigee/apigee-service/bin/apigee-all restart

Przywracanie jednego węzła klastra

Jeśli pojedynczy węzeł ZooKeeper, który jest częścią zespołu, ulegnie awarii, możesz utworzyć nowy węzeł z tą samą nazwą hosta lub adresem IP i ponownie zainstalować ZooKeeper. Gdy nowy węzeł ZooKeeper dołączy do zespołu ZooKeeper, otrzyma najnowsze migawki od węzła głównego i zacznie obsługiwać klientów. Nie musisz przywracać danych w tej instancji.

1. Ponownie zainstaluj ZooKeeper:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper install

2. Uruchom konfigurację na węźle ZooKeeper, używając tego samego pliku konfiguracji, który został użyty podczas instalowania oryginalnego węzła:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper setup -f configFile

3. Uruchom ZooKeeper:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper start

Przywracanie całego klastra

1. zatrzymać cały klaster,
2. Przywróć wszystkie węzły ZooKeeper z pliku kopii zapasowej zgodnie z opisem powyżej dla pojedynczego węzła.
3. Uruchom klaster ZooKeeper.
4. Uruchom ponownie wszystkie komponenty.

Apache Cassandra

Przywracanie jednego węzła autonomicznego

1. Zatrzymaj Cassandrę:

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

2. Usuń stary katalog Cassandra:

   /opt/apigee/data/apigee-cassandra

3. Zainstaluj ponownie system Cassandra:

   /apigee/apigee-service/bin/apigee-service apigee-cassandra install

4. Przywróć Cassandra:

   /apigee/apigee-service/bin/apigee-service apigee-cassandra restore 2019.03.17,14.40.41

   Pamiętaj, że podczas przywracania komponentu nie podajesz ścieżki do katalogu pliku kopii zapasowej ani prefiksu „backup-” ani sufiksu „.tar.gz”. Podajesz tylko część nazwy pliku kopii zapasowej związaną z datą i godziną.

   Możesz pominąć plik kopii zapasowej w poleceniu restore, a Edge użyje najnowszego pliku kopii zapasowej w katalogu kopii zapasowej komponentu.

5. Uruchom ponownie wszystkie komponenty:
   

   /apigee/apigee-service/bin/apigee-all restart

Przywracanie jednego węzła klastra

Jeśli pojedynczy węzeł Cassandra, który jest częścią zespołu, ulegnie awarii, możesz utworzyć nowy węzeł o tej samej nazwie hosta lub adresie IP. Wystarczy ponownie zainstalować Cassandrę i wykonać kilka dodatkowych czynności. Nie musisz przywracać danych z kopii zapasowych. Repliki dostępne w innych węzłach mogą służyć do przywracania danych w uszkodzonym węźle. Te kroki są zwykle stosowane, gdy węzeł w klastrze Cassandra ulegnie awarii z powodu usterki sprzętu itp.

Jeśli węzeł, który uległ awarii, nie jest już dostępny, zniszcz go i odizoluj jego sieć, aby nie mógł przypadkowo ponownie dołączyć do klastra Cassandra. Następnie utwórz nowy węzeł z tym samym adresem IP co pierwotny węzeł i wykonaj na nim zwykłe kroki uruchamiania Apigee.

Jeśli węzeł jest nadal dostępny i chcesz go ponownie użyć, wykonaj te czynności:

1. Zatrzymaj proces Cassandra w węźle:
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
2. Odinstaluj oprogramowanie Cassandra z węzła:
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
3. Wyczyść katalog danych z węzła:
   rm -rf /opt/apigee/data/apigee-cassandra

Po wykonaniu powyższych czynności powinien być dostępny węzeł z tym samym adresem IP co węzeł, który uległ awarii. Będzie on gotowy do zainstalowania oprogramowania Apigee. Wykonaj te czynności:

1. Określ węzły początkowe centrum danych.
   1. Na dowolnym działającym węźle Cassandra w tym samym centrum danych co przywracany węzeł uruchom to polecenie:

      apigee-service apigee-cassandra configure -search conf_cassandra_seeds

   2. Dane wyjściowe będą wyglądać mniej więcej tak:

      Found key conf_cassandra_seeds, with value, "127.0.0.1", in /opt/apigee/apigee-cassandra/token/default.properties
      Found key conf_cassandra_seeds, with value, 127.0.0.1, in /opt/apigee/apigee-cassandra/token/application/cassandra.properties
      Found key conf_cassandra_seeds, with value, "10.1.0.1,10.1.0.2", in /opt/apigee/token/application/cassandra.properties
      apigee-configutil: apigee-cassandra: # OK

   3. Spójrz na ostatni wiersz danych wyjściowych. Adresy IP rozdzielone przecinkami to węzły źródłowe używane przez węzły w tym centrum danych.
2. Na nowym węźle, który jest przywracany, utwórz lub zmodyfikuj ten plik:
   

   vi /opt/apigee/customer/application/cassandra.properties
   

3. Add the following line:
   

   conf_jvm_options_custom_settings=-Dcassandra.replace_address=<ip-address-of-dead-node>

4. Jeśli ten węzeł jest jednym z węzłów źródłowych (adres IP węzła pojawia się na liście węzłów źródłowych z kroku 1), dodaj w pliku kolejny wiersz:
   

   conf_cassandra_seeds="<comma-separated-seed-list-except-this-node’s-ip>"

   1. Na przykład w powyższym przypadku lista wyjściowa zawiera 2 adresy IP – 10.1.0.1 i 10.1.0.2. Jeśli przywracany węzeł to 10.1.0.1, dodaj wiersz podobny do tego:
      

      conf_cassandra_seeds="10.1.0.2"

5. Zapisz plik i upewnij się, że jego właścicielem jest użytkownik Apigee i że może on go odczytać:
   

   chown apigee:apigee /opt/apigee/customer/application/cassandra.properties

6. Zainstaluj oprogramowanie Cassandra:
   

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install

7. Uruchom konfigurację Cassandra:
   

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f <configFile>

8. Proces konfiguracji spróbuje wewnętrznie uruchomić usługę Cassandra. Może to potrwać dłuższy czas w zależności od ilości danych do przesłania z innych węzłów, przepustowości sieci itp.
9. [Opcja zaawansowana] Możesz przyspieszyć strumieniowe przesyłanie danych, uruchamiając w węźle te polecenia nodetool:
   

   nodetool setstreamthroughput <value>
   nodetool setcompactionthroughput <value>

10. Gdy węzeł Cassandra zostanie ponownie uruchomiony, użyj standardowych poleceń, takich jak poniższe, aby sprawdzić, czy węzeł został pomyślnie dołączony do pierścienia:
    

    /opt/apigee/apigee-cassandra/bin/nodetool ring
    /opt/apigee/apigee-cassandra/bin/nodetool status

11. Gdy sprawdzisz, że węzeł działa prawidłowo, ponownie edytuj plik /opt/apigee/customer/application/cassandra.properties i usuń wiersze dodane wcześniej w krokach 3 i 4 tej procedury.
12. Uruchom ponownie usługę Cassandra w węźle:
    

    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart

Przywracanie całego klastra

1. zatrzymać cały klaster,
2. Przywróć wszystkie węzły Cassandra z pliku kopii zapasowej.
3. Uruchom klaster Cassandra.
4. Uruchom ponownie wszystkie komponenty.

Baza danych PostgreSQL

PostgreSQL działający samodzielnie lub jako serwer główny

1. Zatrzymaj serwer zarządzania, serwer Qpid i serwer Postgres na wszystkich węzłach:

   /apigee/apigee-service/bin/apigee-service edge-management-server stop
   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop

2. Ponownie zainstaluj bazę danych PostgreSQL:

   /apigee/apigee-service/bin/apigee-service apigee-postgresql install 

3. Uruchom PostgreSQL:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start

4. Przywróć bazę danych PostgreSQL z pliku kopii zapasowej:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restore 2019.03.17,14.40.41

   Pamiętaj, że podczas przywracania komponentu PostgreSQL nie określasz ścieżki katalogu do pliku kopii zapasowej ani sufiksu „.dump”. Określasz tylko datę i godzinę w nazwie pliku kopii zapasowej.

   Możesz pominąć plik kopii zapasowej w poleceniu restore, a Edge użyje najnowszego pliku kopii zapasowej w katalogu kopii zapasowych komponentu.

5. Uruchom serwer zarządzania, serwer Qpid i serwer Postgres na wszystkich węzłach:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server start
   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start

PosgreSQL działający w trybie gotowości

1. Ponownie zainstaluj bazę danych PostgreSQL:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql install

2. Ponownie skonfiguruj bazę danych PostgreSQL, używając tego samego pliku konfiguracji, który został użyty do jej instalacji:
   

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup -f configFile

3. Uruchom PostgreSQL:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start 

Serwer Postgres

1. Zatrzymaj serwer Postgres na wszystkich węzłach głównych i rezerwowych:

   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop

2. Usuń stare katalogi serwera Postgres:

   /opt/apigee/data/edge-postgres-server /opt/apigee/etc/edge-postgres-server.d

3. Ponownie zainstaluj serwer Postgres:

   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server install

4. Przywróć serwer Postgres z pliku kopii zapasowej:

   /opt/apigee/apigee-service/bin/apigee-service edge-postgre-server restore 2019.03.17,14.40.41

   Pamiętaj, że podczas przywracania komponentu nie podajesz ścieżki do katalogu pliku kopii zapasowej ani prefiksu „backup-” ani sufiksu „.tar.gz”. Podajesz tylko część nazwy pliku kopii zapasowej związaną z datą i godziną.

   Możesz pominąć plik kopii zapasowej w poleceniu restore, a Edge użyje najnowszego pliku kopii zapasowej w katalogu kopii zapasowej komponentu.

5. Uruchom serwer Postgres na wszystkich węzłach głównych i rezerwowych:

   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start

Serwer Qpid i Qpidd

1. Zatrzymaj Qpidd, serwer Qpid i serwer Postgres na wszystkich węzłach:
   

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd stop

2. Usuń stare katalogi serwera Qpid i demona Qpidd:

   /opt/apigee/data/edge-qpid-server
   /opt/apigee/etc/edge-qpid-server.d
   /opt/apigee/data/apigee-qpidd
   /opt/apigee/etc/apigee-qpidd.d 

3. Ponownie zainstaluj Qpidd:

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd install 

4. Przywróć Qpidd:

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd restore 2019.03.17,14.40.41

   Pamiętaj, że podczas przywracania komponentu nie podajesz ścieżki do katalogu pliku kopii zapasowej ani prefiksu „backup-” ani sufiksu „.tar.gz”. Podajesz tylko część nazwy pliku kopii zapasowej związaną z datą i godziną.

   Możesz pominąć plik kopii zapasowej w poleceniu restore, a Edge użyje najnowszego pliku kopii zapasowej w katalogu kopii zapasowej komponentu.

5. Uruchom Qpidd:

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd start 

6. Ponownie zainstaluj serwer Qpid:

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server install

7. Przywróć serwer Qpid:

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restore 2019.03.17,14.40.41

   Pamiętaj, że podczas przywracania komponentu nie podajesz ścieżki do katalogu pliku kopii zapasowej ani prefiksu „backup-” ani sufiksu „.tar.gz”. Podajesz tylko część nazwy pliku kopii zapasowej związaną z datą i godziną.

   Możesz pominąć plik kopii zapasowej w poleceniu restore, a Edge użyje najnowszego pliku kopii zapasowej w katalogu kopii zapasowej komponentu.

8. Uruchom ponownie serwer Qpid, Qpidd i serwery Postgres na wszystkich węzłach:

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd restart
   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart

SymasLDAP

1. Zatrzymaj SymasLDAP:

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap stop

2. Ponownie zainstaluj SymasLDAP:

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap install

3. Usuń stare katalogi SymasLDAP:

   /opt/apigee/data/apigee-openldap /opt/apigee/etc/apigee-openldap.d

4. Przywracanie SymasLDAP:

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap restore 2019.03.17,14.40.41

   Pamiętaj, że podczas przywracania komponentu nie podajesz ścieżki do katalogu pliku kopii zapasowej ani prefiksu „backup-” ani sufiksu „.tar.gz”. Określasz tylko datę i godzinę w nazwie pliku kopii zapasowej.

   Możesz pominąć plik kopii zapasowej w poleceniu restore, a Edge użyje najnowszego pliku kopii zapasowej w katalogu kopii zapasowej komponentu.

5. Uruchom ponownie SymasLDAP:

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap start

6. Uruchom ponownie wszystkie serwery zarządzania:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

Serwer zarządzania

1. Zatrzymaj serwer zarządzania:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop

2. Usuń stare katalogi serwera zarządzania:

   /opt/apigee/data/edge-management-server /opt/apigee/etc/edge-management-server.d

3. Ponownie zainstaluj serwer zarządzania:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server install

4. Przywróć serwer zarządzania z pliku kopii zapasowej:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server restore 2019.03.17,14.40.41

   Pamiętaj, że podczas przywracania komponentu nie podajesz ścieżki do katalogu pliku kopii zapasowej ani prefiksu „backup-” ani sufiksu „.tar.gz”. Określasz tylko datę i godzinę w nazwie pliku kopii zapasowej.

   Możesz pominąć plik kopii zapasowej w poleceniu restore, a Edge użyje najnowszego pliku kopii zapasowej w katalogu kopii zapasowej komponentu.

5. Ponownie uruchom serwer zarządzania:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server start

procesor komunikatów

1. Zatrzymaj procesor komunikatów:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop

2. Usuń stare katalogi procesora komunikatów:

   /opt/apigee/data/edge-message-processor
   /opt/apigee/etc/edge-message-processor.d

3. Ponownie zainstaluj procesor komunikatów:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor install

4. Przywróć procesor komunikatów z pliku kopii zapasowej:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restore 2019.03.17,14.40.41

   Pamiętaj, że podczas przywracania komponentu nie podajesz ścieżki do katalogu pliku kopii zapasowej ani prefiksu „backup-” ani sufiksu „.tar.gz”. Podajesz tylko część nazwy pliku kopii zapasowej związaną z datą i godziną.

   Możesz pominąć plik kopii zapasowej w poleceniu restore, a Edge użyje najnowszego pliku kopii zapasowej w katalogu kopii zapasowych komponentu.

5. Uruchom ponownie procesor komunikatów:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor start

Router

1. Zatrzymaj router:

   /opt/apigee/apigee-service/bin/apigee-service edge-router stop

2. Usuń stare katalogi routera:

   /opt/apigee/data/edge-router
   /opt/apigee/etc/edge-router.d

3. Ponowna instalacja routera:
   

   /opt/apigee/apigee-service/bin/apigee-service edge-router install

4. Przywracanie routera z pliku kopii zapasowej:

   /opt/apigee/apigee-service/bin/apigee-service edge-router restore 2019.03.17,14.40.41

   Pamiętaj, że podczas przywracania komponentu nie podajesz ścieżki do katalogu pliku kopii zapasowej ani prefiksu „backup-” ani sufiksu „.tar.gz”. Określasz tylko datę i godzinę w nazwie pliku kopii zapasowej.

   Możesz pominąć plik kopii zapasowej w poleceniu restore, a Edge użyje najnowszego pliku kopii zapasowej w katalogu kopii zapasowej komponentu.

5. Uruchom ponownie router:
   

   /opt/apigee/apigee-service/bin/apigee-service edge-router start

Nowy interfejs Edge

1. Zatrzymaj interfejs New Edge:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-ui stop

2. Usuń stare katalogi nowego interfejsu Edge:

   /opt/apigee/data/edge-management-ui
   /opt/apigee/etc/edge-management-ui.d

3. Ponowna instalacja nowego interfejsu Edge:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-ui install
   /opt/apigee/apigee-service/bin/apigee-service edge-management-ui-static install

4. Przywróć nowy interfejs Edge z pliku kopii zapasowej:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restore 2019.03.17,14.40.41

   Pamiętaj, że podczas przywracania komponentu nie podajesz ścieżki do katalogu pliku kopii zapasowej ani prefiksu „backup-” ani sufiksu „.tar.gz”. Określasz tylko datę i godzinę w nazwie pliku kopii zapasowej.

   Możesz pominąć plik kopii zapasowej w poleceniu restore, a Edge użyje najnowszego pliku kopii zapasowej w katalogu kopii zapasowych komponentu.

5. Ponowne uruchamianie nowego interfejsu Edge:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-ui start

Pełne przywracanie witryny

1. Zatrzymaj wszystkie węzły komponentów. Pamiętaj, że kolejność zatrzymywania podsystemów jest ważna: najpierw zatrzymaj wszystkie węzły brzegowe, a potem wszystkie węzły magazynów danych.
2. Przywróć wszystkie komponenty zgodnie z opisem powyżej.
3. Teraz uruchom wszystkie komponenty w tej kolejności: Pamiętaj, że kolejność uruchamiania podsystemów jest ważna:
   1. Uruchamianie klastra ZooKeeper
   2. Uruchamianie klastra Cassandra
   3. Sprawdź, czy SymasLDAP działa.
   4. Uruchom qpid
   5. Sprawdź, czy baza danych PostgreSQL działa.
   6. Uruchamianie serwera zarządzania
   7. Uruchamianie routerów i procesorów wiadomości
   8. Uruchamianie serwera Qpid
   9. Uruchamianie serwera Postgres
   10. Uruchamianie nowego interfejsu Edge