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

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

Хранитель зоопарка Апач

Восстановление одного автономного узла

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. Переустановите Кассандру:

   /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. Например, в приведенном выше примере исходный список имеет 2 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. Запустите установку Кассандры:
   

   /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. Запустите кластер Кассандра.
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 

Постгрес-сервер

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 из файла резервной копии:

   /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 и каталоги 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

OpenLDAP

1. Остановите OpenLDAP:

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

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

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

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

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

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

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

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

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

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

   /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. Восстановите Сервер Управления из файла резервной копии:

   /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

Пограничный интерфейс

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. Остановите все узлы компонентов. Обратите внимание, что порядок остановки подсистем важен: сначала остановите все пограничные узлы, а затем остановите все узлы хранилищ данных.
2. Восстановите все компоненты, как описано выше.
3. Теперь запустите все компоненты в следующем порядке. Обратите внимание, что важен порядок запуска подсистем:
   1. Запустите кластер ZooKeeper
   2. Запустите кластер Кассандра
   3. Убедитесь, что OpenLDAP запущен и работает.
   4. Запустить qpid
   5. Убедитесь, что база данных PostgreSQL запущена и работает.
   6. Запустить сервер управления
   7. Запустите маршрутизаторы и процессоры сообщений
   8. Запустить сервер Qpid
   9. Запустить сервер Postgres
   10. Запустить пользовательский интерфейс Apigee