Ponowne instalowanie i przywracanie komponentów

Ten dokument opisuje ponowną instalację i przywracanie komponentu Edge. Skorzystaj z tej procedury, jeśli przed przywróceniem kopii zapasowej musisz ponownie zainstalować komponent Edge.

Apache ZooKeeper

Przywracanie jednego samodzielnego węzła

  1. Zatrzymaj ZooKeeper: 
    /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. Przywróć ZooKeepera: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restore 2019.03.17,14.40.41

    Pamiętaj, że podczas przywracania komponentu nie musisz podawać ścieżki do katalogu pliku kopii zapasowej ani prefiksu „backup-” czy sufiksu „.tar.gz”. Podajesz tylko część nazwy pliku kopii zapasowej dotyczącą daty i godziny.

    Możesz opcjonalnie pominąć plik kopii zapasowej w poleceniu restore. W takim przypadku 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 jeden z węzłów ZooKeeper w zespole ulegnie awarii, możesz utworzyć nowy węzeł o tej samej nazwie hosta lub adresie 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. Zatrzymaj cały klaster.
  2. Przywróć wszystkie węzły ZooKeeper z pliku kopii zapasowej w sposób opisany powyżej w przypadku pojedynczego węzła.
  3. Uruchom klaster ZooKeeper.
  4. Uruchom ponownie wszystkie komponenty.

Apache Cassandra

Przywracanie jednego samodzielnego węzła

  1. Zatrzymaj Cassandra: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
  2. Usuń stary katalog Cassandra: 
    /opt/apigee/data/apigee-cassandra
  3. Ponownie zainstaluj Cassandrę: 
    /apigee/apigee-service/bin/apigee-service apigee-cassandra install
  4. Przywracanie Cassandra: 
    /apigee/apigee-service/bin/apigee-service apigee-cassandra restore 2019.03.17,14.40.41

    Pamiętaj, że podczas przywracania komponentu nie musisz podawać ścieżki do katalogu pliku kopii zapasowej ani prefiksu „backup-” czy sufiksu „.tar.gz”. Podajesz tylko część nazwy pliku kopii zapasowej dotyczącą daty i godziny.

    Możesz opcjonalnie pominąć plik kopii zapasowej w poleceniu restore. W takim przypadku Edge użyje najnowszego pliku kopii zapasowej w katalogu kopii zapasowych 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. Replik dostępnych w innych węzłach można użyć do przywrócenia danych w uszkodzonym węźle. Te kroki zwykle mają zastosowanie, gdy węzeł w klastrze Cassandra ulegnie awarii z powodu nieprawidłowego działania sprzętu itp.

Jeśli węzeł, który uległ awarii, jest już niedostępny, zniszcz go i odizoluj jego sieć, aby zapobiec przypadkowemu ponownemu dołączeniu do klastra Cassandra. Następnie uruchom nowy węzeł z tym samym adresem IP co pierwotny węzeł i wykonaj na nim zwykłe czynności związane z uruchamianiem 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. Usuń 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ł o tym samym adresie IP co węzeł, w którym wystąpił błąd. 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. Wyświetli się coś takiego: 
      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. Sprawdź ostatni wiersz danych wyjściowych. Wymienione adresy IP rozdzielone przecinkami to węzły początkowe używane przez węzły w tym centrum danych.
  2. Na przywracanym węźle 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 początkowych (jego adres IP znajduje się na liście węzłów początkowych z kroku 1), dodaj do pliku kolejny wiersz:
    conf_cassandra_seeds="<comma-separated-seed-list-except-this-node’s-ip>"
    1. Na przykład w powyższym przypadku lista początkowa zawiera 2 adresy IP: 10.1.0.1 i 10.1.0.2. Jeśli przywracany węzeł ma adres 10.1.0.1, dodaj wiersz w tym formacie:
      conf_cassandra_seeds="10.1.0.2"
  5. Zapisz plik i upewnij się, że jest on własnością użytkownika Apigee i może być przez niego odczytywany:
    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ługo w zależności od ilości danych do przesyłania strumieniowego z innych węzłów, przepustowości sieci itp.
  9. [Opcja zaawansowana] Możesz przyspieszyć przesyłanie strumieniowe danych, uruchamiając na węźle te polecenia narzędzia 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ł prawidłowo dodany 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. Ponownie uruchom usługę Cassandra w węźle:
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart

Przywracanie całego klastra

  1. Zatrzymaj 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

PosgreSQL działający samodzielnie lub jako węzeł 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 do pliku kopii zapasowej ani sufiksu „.dump”. Podajesz tylko część nazwy pliku kopii zapasowej dotyczącą daty i godziny.

    Możesz opcjonalnie pominąć plik kopii zapasowej w poleceniu restore. W takim przypadku 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 konfiguracyjnego, którego użyto do jej zainstalowania:
    /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 musisz podawać ścieżki do katalogu pliku kopii zapasowej ani prefiksu „backup-” czy sufiksu „.tar.gz”. Podajesz tylko część nazwy pliku kopii zapasowej dotyczącą daty i godziny.

    Możesz opcjonalnie pominąć plik kopii zapasowej w poleceniu restore. W takim przypadku Edge użyje najnowszego pliku kopii zapasowej w katalogu kopii zapasowych 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, Qpid Server i Postgres Server 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 musisz podawać ścieżki do katalogu pliku kopii zapasowej ani prefiksu „backup-” czy sufiksu „.tar.gz”. Podajesz tylko część nazwy pliku kopii zapasowej dotyczącą daty i godziny.

    Możesz opcjonalnie pominąć plik kopii zapasowej w poleceniu restore. W takim przypadku Edge użyje najnowszego pliku kopii zapasowej w katalogu kopii zapasowych 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 musisz podawać ścieżki do katalogu pliku kopii zapasowej ani prefiksu „backup-” czy sufiksu „.tar.gz”. Podajesz tylko część nazwy pliku kopii zapasowej dotyczącą daty i godziny.

    Możesz opcjonalnie pominąć plik kopii zapasowej w poleceniu restore. W takim przypadku Edge użyje najnowszego pliku kopii zapasowej w katalogu kopii zapasowych komponentu.

  8. Ponownie uruchom serwery Qpid, Qpidd i 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. Zainstaluj ponownie 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. Przywróć SymasLDAP: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-openldap restore 2019.03.17,14.40.41

    Pamiętaj, że podczas przywracania komponentu nie musisz podawać ścieżki do katalogu pliku kopii zapasowej ani prefiksu „backup-” czy sufiksu „.tar.gz”. Podajesz tylko część nazwy pliku kopii zapasowej dotyczącą daty i godziny.

    Możesz opcjonalnie pominąć plik kopii zapasowej w poleceniu restore. W takim przypadku Edge użyje najnowszego pliku kopii zapasowej w katalogu kopii zapasowych komponentu.

  5. Uruchom ponownie SymasLDAP: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-openldap start
  6. Ponownie uruchom 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 musisz podawać ścieżki do katalogu pliku kopii zapasowej ani prefiksu „backup-” czy sufiksu „.tar.gz”. Podajesz tylko część nazwy pliku kopii zapasowej dotyczącą daty i godziny.

    Możesz opcjonalnie pominąć plik kopii zapasowej w poleceniu restore. W takim przypadku Edge użyje najnowszego pliku kopii zapasowej w katalogu kopii zapasowych 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 wiadomości: 
    /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 wiadomości 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 musisz podawać ścieżki do katalogu pliku kopii zapasowej ani prefiksu „backup-” czy sufiksu „.tar.gz”. Podajesz tylko część nazwy pliku kopii zapasowej dotyczącą daty i godziny.

    Możesz opcjonalnie pominąć plik kopii zapasowej w poleceniu restore. W takim przypadku 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. Ponownie zainstaluj router:
    /opt/apigee/apigee-service/bin/apigee-service edge-router install
  4. Przywróć router 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 musisz podawać ścieżki do katalogu pliku kopii zapasowej ani prefiksu „backup-” czy sufiksu „.tar.gz”. Podajesz tylko część nazwy pliku kopii zapasowej dotyczącą daty i godziny.

    Możesz opcjonalnie pominąć plik kopii zapasowej w poleceniu restore. W takim przypadku Edge użyje najnowszego pliku kopii zapasowej w katalogu kopii zapasowych komponentu.

  5. Uruchom ponownie router:
    /opt/apigee/apigee-service/bin/apigee-service edge-router start

Interfejs Edge

  1. Zatrzymaj interfejs: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui stop
  2. Usuń stare katalogi interfejsu: 
    /opt/apigee/data/edge-ui
/opt/apigee/etc/edge-ui.d
  3. Ponowna instalacja interfejsu:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui install
  4. Przywróć interfejs z pliku kopii zapasowej: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restore 2019.03.17,14.40.41

    Pamiętaj, że podczas przywracania komponentu nie musisz podawać ścieżki do katalogu pliku kopii zapasowej ani prefiksu „backup-” czy sufiksu „.tar.gz”. Podajesz tylko część nazwy pliku kopii zapasowej dotyczącą daty i godziny.

    Możesz opcjonalnie pominąć plik kopii zapasowej w poleceniu restore. W takim przypadku Edge użyje najnowszego pliku kopii zapasowej w katalogu kopii zapasowych komponentu.

  5. Uruchom ponownie interfejs:
    /opt/apigee/apigee-service/bin/apigee-service edge-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 w sposób opisany 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. Start 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 interfejsu Apigee