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

В этом документе описывается переустановка и восстановление компонента 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. Перезапустите все компоненты.

Apache Cassandra

Как восстановить отдельный узел

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

   /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. Восстановите Cassandra:

   /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. Если восстанавливаемый узел имеет IP-адрес 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

PostgreSQL, работающий в режиме ожидания

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 Server:

   /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 Server и 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. Чтобы восстановить сервер управления из файла резервной копии:

   /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

Message Processor

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

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

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

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

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

   /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. Удалите старые каталоги Router:

   /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

1. Остановить новый интерфейс Edge:

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

2. Удалите старые каталоги интерфейса New Edge:

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

3. Переустановите интерфейс New 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. Чтобы восстановить интерфейс New Edge из файла резервной копии:

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

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

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

5. Чтобы перезапустить новый интерфейс Edge:

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

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

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