Переустановите и восстановите компоненты

В этом документе описывается переустановка и восстановление компонента Edge. Используйте эту процедуру, если вам необходимо переустановить компонент Edge перед восстановлением из резервной копии.

Apache ZooKeeper

Восстановить один автономный узел

1. Остановить ZooKeeper:

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

2. Удалить старые каталоги ZooKeeper:

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

3. Переустановите ZooKeeper:

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

4. Восстановить ZooKeeper:

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

   Обратите внимание, что при восстановлении компонента не указывается путь к файлу резервной копии, а также префикс «backup-» и суффикс «.tar.gz». Указывается только дата и время в имени файла резервной копии.

   При желании вы можете опустить файл резервной копии в команде restore , и Edge будет использовать самый последний файл резервной копии в каталоге резервных копий компонента.

5. Перезапустите все компоненты:

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

Восстановить один узел кластера

В случае выхода из строя одного узла ZooKeeper, входящего в ансамбль, вы можете создать новый узел с тем же именем хоста/IP-адресом и переустановить ZooKeeper. Когда новый узел ZooKeeper присоединится к ансамблю ZooKeeper, он получит последние снимки состояния от лидера и начнёт обслуживать клиентов. В этом случае восстанавливать данные не требуется.

1. Переустановите ZooKeeper:

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

2. Запустите установку на узле ZooKeeper, используя тот же файл конфигурации, который использовался при установке исходного узла:

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

3. Запустить ZooKeeper:

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

Восстановить полный кластер

1. Остановите весь кластер.
2. Восстановите все узлы ZooKeeper из файла резервной копии, как описано выше для одного узла.
3. Запустите кластер ZooKeeper.
4. Перезапустите все компоненты.

Апачи Кассандра

Восстановить один автономный узел

1. Остановите Кассандру:

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

2. Удалить старый каталог Cassandra:

   /opt/apigee/data/apigee-cassandra

3. Переустановите Cassandra:

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

4. Восстановить Кассандру:

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

   Обратите внимание, что при восстановлении компонента не указывается путь к файлу резервной копии, а также префикс «backup-» и суффикс «.tar.gz». Указывается только дата и время в имени файла резервной копии.

   При желании вы можете опустить файл резервной копии в команде restore , и Edge будет использовать самый последний файл резервной копии в каталоге резервных копий компонента.

5. Перезапустите все компоненты:
   

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

Восстановить один узел кластера

В случае выхода из строя одного узла Cassandra, входящего в состав ансамбля, вы можете создать новый узел с тем же именем хоста и IP-адресом. Достаточно переустановить Cassandra и выполнить несколько дополнительных шагов. Восстанавливать данные из резервных копий не требуется. Для восстановления данных на вышедшем из строя узле можно использовать реплики, доступные на других узлах. Эти шаги обычно применимы в случае сбоя узла в кластере Cassandra из-за аппаратной неисправности и т. д.

Если отказавший узел больше недоступен, уничтожьте его и изолируйте его сеть, чтобы исключить возможность его случайного повторного подключения к кластеру Cassandra. Затем подключите новый узел с тем же IP-адресом, что и у исходного узла, и выполните на нём стандартные шаги загрузки Apigee.

Если узел все еще доступен и вы хотите использовать его повторно, выполните следующие действия:

1. Остановите процесс Cassandra на узле:
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
2. Удалите программное обеспечение Cassandra с узла:
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
3. Удалить каталог данных с узла:
   rm -rf /opt/apigee/data/apigee-cassandra

После выполнения вышеуказанных шагов у вас должен появиться узел с тем же IP-адресом, что и у вышедшего из строя узла, готовый к установке программного обеспечения Apigee. Выполните следующие действия:

1. Определите начальные узлы центра обработки данных.
   1. На любом работающем узле Cassandra в том же центре обработки данных, что и восстанавливаемый узел, выполните следующую команду:

      apigee-service apigee-cassandra configure -search conf_cassandra_seeds

   2. Выведется что-то вроде этого:

      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. Обратитесь к последней строке вывода. Перечисленные IP-адреса, разделённые запятыми, — это начальные узлы, используемые узлами в этом центре обработки данных.
2. На восстанавливаемом новом узле создайте или отредактируйте следующий файл:
   

   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. Если этот узел является одним из начальных узлов (IP-адрес узла отображается в списке начальных узлов из шага 1), добавьте еще одну строку в файл:
   

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

   1. Например, в приведённом выше примере начальный список содержит два IP-адреса: 10.1.0.1 и 10.1.0.2. Если восстанавливаемый узел — 10.1.0.1, добавьте следующую строку:
      

      conf_cassandra_seeds="10.1.0.2"

5. Сохраните файл и убедитесь, что он принадлежит пользователю Apigee и доступен для чтения:
   

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

6. Установите программное обеспечение Cassandra:
   

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

7. Запускаем настройку Cassandra:
   

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

8. Настройка выполнит внутреннюю попытку загрузки сервиса Cassandra. Это может занять много времени в зависимости от объёма данных, передаваемых с других узлов, пропускной способности вашей сети и т. д.
9. [Расширенный параметр] Вы можете ускорить потоковую передачу данных, выполнив следующие команды nodetool на узле:
   

   nodetool setstreamthroughput <value>
   nodetool setcompactionthroughput <value>

10. После того как узел Cassandra снова заработает, используйте стандартные команды, как показано ниже, чтобы убедиться, что узел успешно присоединился к кольцу:
    

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

11. После того как вы убедитесь, что узел успешно запущен и работает, снова отредактируйте файл /opt/apigee/customer/application/cassandra.properties и удалите строки, добавленные ранее в этой процедуре на шагах 3 и 4.
12. Перезапустите службу Cassandra на узле:
    

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

Восстановить полный кластер

1. Остановите весь кластер.
2. Восстановите все узлы Cassandra из файла резервной копии.
3. Запустите кластер Cassandra.
4. Перезапустите все компоненты.

База данных PostgreSQL

PosgreSQL работает автономно или как главный сервер

1. Остановите сервер управления, сервер Qpid и сервер Postgres на всех узлах:

   /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. Переустановите базу данных PostgreSQL:

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

3. Запустите PostgreSQL:

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

4. Восстановите базу данных PostgreSQL из файла резервной копии:

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

   Обратите внимание, что при восстановлении компонента PostgreSQL не указывается путь к каталогу с файлом резервной копии и не указывается суффикс «.dump». Указывается только дата и время в имени файла резервной копии.

   При желании вы можете опустить файл резервной копии в команде restore , и Edge будет использовать самый последний файл резервной копии в каталоге резервных копий компонента.

5. Запустите сервер управления, сервер Qpid и сервер Postgres на всех узлах:

   /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 работает в режиме ожидания

1. Переустановите базу данных PostgreSQL:

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

2. Перенастройте базу данных PostgreSQL, используя тот же файл конфигурации, который вы использовали для ее установки:
   

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

3. Запустите PostgreSQL:

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

Сервер Postgres

1. Остановите сервер Postgres на всех главных и резервных узлах:

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

2. Удалите старые каталоги сервера Postgres:

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

3. Переустановите сервер Postgres:

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

4. Восстановите Postgres Server из файла резервной копии:

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

   Обратите внимание, что при восстановлении компонента не указывается путь к файлу резервной копии, а также префикс «backup-» и суффикс «.tar.gz». Указывается только дата и время в имени файла резервной копии.

   При желании вы можете опустить файл резервной копии в команде restore , и Edge будет использовать самый последний файл резервной копии в каталоге резервных копий компонента.

5. Запустите сервер Postgres на всех главных и резервных узлах:

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

Сервер Qpid и Qpidd

1. Остановите Qpidd, Qpid Server и Postgres Server на всех узлах:
   

   /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. Удалите старые каталоги Qpid Server и 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. Переустановите Qpidd:

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

4. Восстановить Qpidd:

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

   Обратите внимание, что при восстановлении компонента не указывается путь к файлу резервной копии, а также префикс «backup-» и суффикс «.tar.gz». Указывается только дата и время в имени файла резервной копии.

   При желании вы можете опустить файл резервной копии в команде restore , и Edge будет использовать самый последний файл резервной копии в каталоге резервных копий компонента.

5. Запустить Qpidd:

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

6. Переустановите сервер Qpid:

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

7. Восстановление сервера Qpid:

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

   Обратите внимание, что при восстановлении компонента не указывается путь к файлу резервной копии, а также префикс «backup-» и суффикс «.tar.gz». Указывается только дата и время в имени файла резервной копии.

   При желании вы можете опустить файл резервной копии в команде restore , и Edge будет использовать самый последний файл резервной копии в каталоге резервных копий компонента.

8. Перезапустите серверы Qpid, Qpidd и Postgres на всех узлах:

   /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. Остановить SymasLDAP:

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

2. Переустановите SymasLDAP:

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

3. Удалить старые каталоги SymasLDAP:

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

4. Восстановление SymasLDAP:

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

   Обратите внимание, что при восстановлении компонента не указывается путь к файлу резервной копии, а также префикс «backup-» и суффикс «.tar.gz». Указывается только дата и время в имени файла резервной копии.

   При желании вы можете опустить файл резервной копии в команде restore , и Edge будет использовать самый последний файл резервной копии в каталоге резервных копий компонента.

5. Перезапустите SymasLDAP:

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

6. Перезапустите все серверы управления:

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

Сервер управления

1. Остановить сервер управления:

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

2. Удалите старые каталоги сервера управления:

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

3. Переустановите сервер управления:

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

4. Восстановите Management Server из файла резервной копии:

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

   Обратите внимание, что при восстановлении компонента не указывается путь к файлу резервной копии, а также префикс «backup-» и суффикс «.tar.gz». Указывается только дата и время в имени файла резервной копии.

   При желании вы можете опустить файл резервной копии в команде restore , и Edge будет использовать самый последний файл резервной копии в каталоге резервных копий компонента.

5. Перезапустите сервер управления:

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

Процессор сообщений

1. Остановить процессор сообщений:

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

2. Удалить старые каталоги обработчика сообщений:

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

3. Переустановите обработчик сообщений:

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

4. Восстановите обработчик сообщений из файла резервной копии:

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

   Обратите внимание, что при восстановлении компонента не указывается путь к файлу резервной копии, а также префикс «backup-» и суффикс «.tar.gz». Указывается только дата и время в имени файла резервной копии.

   При желании вы можете опустить файл резервной копии в команде restore , и Edge будет использовать самый последний файл резервной копии в каталоге резервных копий компонента.

5. Перезапустить обработчик сообщений:

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

Маршрутизатор

1. Остановить маршрутизатор:

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

2. Удалить старые каталоги маршрутизатора:

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

3. Переустановите маршрутизатор:
   

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

4. Восстановите маршрутизатор из файла резервной копии:

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

   Обратите внимание, что при восстановлении компонента не указывается путь к файлу резервной копии, а также префикс «backup-» и суффикс «.tar.gz». Указывается только дата и время в имени файла резервной копии.

   При желании вы можете опустить файл резервной копии в команде restore , и Edge будет использовать самый последний файл резервной копии в каталоге резервных копий компонента.

5. Перезагрузите маршрутизатор:
   

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

Edge UI

1. Остановить пользовательский интерфейс:

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

2. Удалить старые каталоги пользовательского интерфейса:

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

3. Переустановить пользовательский интерфейс:
   

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

4. Восстановить пользовательский интерфейс из файла резервной копии:

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

   Обратите внимание, что при восстановлении компонента не указывается путь к файлу резервной копии, а также префикс «backup-» и суффикс «.tar.gz». Указывается только дата и время в имени файла резервной копии.

   При желании вы можете опустить файл резервной копии в команде restore , и Edge будет использовать самый последний файл резервной копии в каталоге резервных копий компонента.

5. Перезапустить пользовательский интерфейс:
   

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

Полное восстановление сайта

1. Остановите все узлы компонентов. Обратите внимание, что порядок остановки подсистем важен: сначала остановите все узлы Edge, а затем все узлы хранилищ данных.
2. Восстановите все компоненты, как описано выше.
3. Теперь запустите все компоненты в следующем порядке. Обратите внимание, что порядок запуска подсистем важен:
   1. Запустите кластер ZooKeeper
   2. Запустить кластер Cassandra
   3. Убедитесь, что SymasLDAP запущен и работает
   4. Запустить qpid
   5. Убедитесь, что база данных PostgreSQL запущена и работает.
   6. Запустить сервер управления
   7. Запуск маршрутизаторов и обработчиков сообщений
   8. Запустить сервер Qpid
   9. Запустить сервер Postgres
   10. Запустить пользовательский интерфейс Apigee