Перемещение серверов Apigee

Edge для частного облака v. 4.17.01

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

Изменение IP-адреса узла Cassandra

Чтобы изменить IP-адрес узла Cassandra, выполните следующие действия:

Для конфигураций с одним узлом Cassandra

  1. Отредактируйте /opt/apigee/customer/application/cassandra.properties в изменяемой системе. Если файл не существует, создайте его.
  2. Измените следующие параметры:
    • Установите параметры conf_cassandra_seeds и conf_cassandra_listen_address , чтобы указать новый IP-адрес системы.
    • Измените conf_cassandra_rpc_address , чтобы использовать либо новый IP-адрес, либо 0.0.0.0 (что позволяет Cassandra Thrift прослушивать все интерфейсы).
  3. Откройте /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties в редакторе. Вы должны увидеть старый IP-адрес и настройки по умолчанию в форме:
    192.168.56.101=DC-1:ра-1
    по умолчанию = DC-1: RA-1


    Сохраните эту информацию.
  4. Отредактируйте /opt/apigee/customer/application/cassandra.properties , чтобы изменить указанный старый IP-адрес на новый IP-адрес:
    conf_cassandra-topology_topology=192.168.56.103=dc-1:ra-1\ndefault=dc-1:ra-1\n

    Убедитесь, что вы вставили «\n» после IP-адреса и указали те же настройки по умолчанию, которые вы нашли выше в шаге 3.
  5. Перезапустите Кассандру:
    > /opt/apigee/apigee-service/bin/apigee-service перезапуск apigee-cassandra
  6. При необходимости также отремонтируйте ZooKeeper (см. ниже), в противном случае перезапустите каждый компонент платформы Apigee, начиная с Management Server.

Для конфигураций с несколькими узлами Cassandra (кольцо)

  1. Если изменяемый узел является начальным узлом, отредактируйте файл /opt/apigee/customer/application/cassandra.properties в каждой системе в кольце и измените параметр conf_cassandra_seeds , включив в него новый IP-адрес измененной системы. Если файл cassandra.properties не существует, создайте его.
  2. Отредактируйте /opt/apigee/customer/application/cassandra.properties в изменяемой системе и измените следующие параметры:
    • Установите conf_cassandra_listen_address для использования нового IP-адреса.
    • Установите для conf_cassandra_rpc_address использование либо нового IP-адреса, либо 0.0.0.0 (что позволяет Cassandra Thrift прослушивать все интерфейсы).
  3. Откройте /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties в редакторе. Вы должны увидеть все IP-адреса Cassandra и настройки по умолчанию в форме:
    192.168.56.101=DC-1:ра-1
    192.168.56.102=DC-1:ра-1
    192.168.56.103=DC-1:ра-1
    по умолчанию = DC-1: RA-1


    Сохраните эту информацию.
  4. Отредактируйте /opt/apigee/customer/application/cassandra.properties , чтобы изменить указанный старый IP-адрес на новый IP-адрес:
    conf_cassandra-topology_topology=192.168.56.101=dc-1:ra-1\n192.168.56.102=dc-1:ra-1\ n192.168.56.104 =dc-1:ra-1\ndefault=dc-1: ра-1\n

    Обязательно вставьте «\n» после каждого IP-адреса и используйте те же настройки по умолчанию, которые вы записали выше на шаге 3.
  5. Перезапустите Cassandra в модифицированной системе. Если измененная система является начальным узлом, также перезапустите каждую систему, которая использовала измененный начальный узел.
    > /opt/apigee/apigee-service/bin/apigee-service перезапуск apigee-cassandra
  6. Запустите команду nodetool Ring на измененном узле, чтобы убедиться, что кольцо завершено. Утилиту можно найти по адресу opt/apigee/apigee-cassandra/bin .
    > nodetool -h кольцо локального хоста
  7. Запустите восстановление nodetool на измененном узле. Обратите внимание, что этот процесс может занять некоторое время, поэтому настоятельно не рекомендуется делать это в часы пик трафика API.
    > nodetool -h восстановление локального хоста
  8. При необходимости восстановите ZooKeeper (см. ниже), затем перезапустите каждый компонент платформы Apigee, начиная с Management Server.

Обновление регистрации хранилища данных

  1. Найдите UUID регистраций хранилища данных с указанием старого IP-адреса, используя приведенные ниже команды. Обратите внимание на параметры «type» и «UUID»:
    • Curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers?pod=central&region= DC " | egrep -i '(тип|внутреннийIP|uuid|регион)'
    • Curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers?pod=gateway&region= DC " | egrep -i '(тип|внутреннийIP|uuid|регион)'
    • Curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers?pod=analytics&region= DC " | egrep -i '(тип|внутреннийIP|uuid|регион)'

      где DC — имя центра обработки данных. При установке в одном центре обработки данных обычно используется значение « dc-1 ».
  2. Зарегистрируйте новые IP-адреса, используя одну из команд ниже. Необходимая команда будет зависеть от типа измененного узла.

    Примечание . Приведенный ниже параметр REGION относится к центру обработки данных, в котором находится кластер. Например, для обеспечения высокой доступности обычно используется кластер в dc-1 (Dater Center 1) и кластер в dc-2 (центр обработки данных 2). Этот параметр определяется во время установки. Значение по умолчанию — DC-1.
    • Для type="application-datastore":
      Curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers -d "Type=application-datastore&Type=audit-datastore&InternalIP=${NEWIP}&region=${REGION}&pod=central" - H 'тип содержимого: приложение/x-www-form-urlencoded' -X POST
    • Для типа="kms-datastore":
      Curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers -d "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore&Type=counter-datastore&Type=cache-datastore &InternalIP=${ NEWIP}&region=${REGION}&pod=${GATEWAY_POD}" -H 'тип контента: application/x-www-form-urlencoded' -X POST
    • Для type="reportcrud-datastore":
      Curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers" -d "Type=reportcrud-datastore&InternalIP=${NEW_IP}&region=${REGION}&pod=analytics" -H 'content -тип: приложение/x-www-form-urlencoded' -X POST
  3. Удалите старые регистрации UUID системы, в которой был изменен IP-адрес. Для каждой из этих проблем UUID:
    curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers/${OLD_UUID}" -X DELETE

Изменение IP-адреса узла ZooKeeper

Выполните следующие действия, чтобы изменить IP-адрес узла ZooKeeper:

Измените IP-адрес и перезапустите ансамбль ZooKeeper (только для конфигураций ансамбля с несколькими узлами).

  1. Откройте /opt/apigee/apigee-zookeeper/conf/zoo.cfg в редакторе. Вы должны увидеть все IP-адреса ZooKeeper и настройки по умолчанию в форме:
    server.1=192.168.56.101:2888:3888
    server.2=192.168.56.102:2888:3888
    server.3=192.168.56.103:2888:3888


    Сохраните эту информацию.
  2. На каждом узле ZooKeeper отредактируйте файл /opt/apigee/customer/application/zookeeper.properties , чтобы установить для свойства conf_zoo_quorum правильные IP-адреса. Если файл не существует, создайте его.
    conf_zoo_quorum=server.1=192.168.56.101:2888:3888\nserver.2=192.168.56.102:2888:3888\nserver.3=192.168.56.104:2888:3888\n

    Убедитесь, что вы вставили «\n» после каждого IP-адреса и что записи расположены в одном и том же порядке на каждом узле.
  3. Найдите лидера ансамбля ZooKeeper с помощью следующей команды (замените <node> на IP-адрес компьютера Zookeeper):
    эхо-срвр | nc <узел> 2181

    В строке режима вывода должно быть написано «лидер».
  4. Перезапускайте один ZooKeeper за другим, начиная с лидера и заканчивая узлом, на котором был изменен IP-адрес. Если более одного узла Zookeeper изменили IP-адреса, возможно, потребуется перезапустить все узлы.
    > /opt/apigee/apigee-service/bin/apigee-service перезапуск apigee-zookeeper
  5. Используйте команду echo , описанную выше, для проверки каждого узла ZooKeeper.

Сообщите узлам Apigee об измененной конфигурации.

  1. На каждом узле маршрутизатора отредактируйте файл /opt/apigee/customer/application/router.properties следующим образом. Если файл не существует, создайте его.
    • Измените параметр conf_zookeeper_connection.string , чтобы включить новый IP-адрес.
    • Измените параметр conf_zookeeper_zk1.host , чтобы включить новый IP-адрес.
  2. На каждом узле процессора сообщений отредактируйте файл /opt/apigee/customer/application/message-processor.properties следующим образом. Если файл не существует, создайте его.
    • Измените параметр conf_zookeeper_connection.string , чтобы включить новый IP-адрес.
    • Измените параметр conf_zookeeper_zk1.host , чтобы включить новый IP-адрес.
  3. На узле Сервер управления отредактируйте файл /opt/apigee/customer/application/management-server.properties следующим образом. Если файл не существует, создайте его.
    • Измените параметр conf_zookeeper_connection.string , чтобы включить новый IP-адрес.
    • Измените параметр conf_zookeeper_zk1.host , чтобы включить новый IP-адрес.
  4. Перезапустите все компоненты платформы Apigee, выполнив следующую команду на каждом узле:
    /opt/apigee/apigee-service/bin/apigee-all перезапустить

Изменение IP-адреса LDAP-сервера (OpenLDAP)

Чтобы изменить IP-адрес узла OpenLDAP, выполните следующие действия:

  1. На узле Сервер управления отредактируйте файл /opt/apigee/customer/application/management-server.properties . Если файл не существует, создайте его.
  2. В файле Management-server.properties установите для параметра conf_security_ldap.server.host новый IP-адрес.
  3. Перезапустите сервер управления:
    > /opt/apigee/apigee-service/bin/apigee-service перезапуск сервера Edge-Management-Server

Изменение IP-адреса других типов узлов Apigee

Чтобы изменить IP-адрес любого из этих типов узлов (маршрутизатор, процессор сообщений, сервер Postgres (не postgresql) и сервер Qpid (не qpidd):

  1. Используйте следующую команду cURL для регистрации нового внутреннего и внешнего IP-адреса:
    Curl -u $ADMINEMAIL:$PW -X PUT http://$MSIP:8080/v1/servers/< uuid > -d ВнешнийIP=<ip>
    Curl -u $ADMINEMAIL:$PW -X PUT http://$MSIP:8080/v1/servers/< uuid > -d InternalIP=<ip>


    где uuid — это UUID узла.

Если вы не знаете UUID узла, вы можете использовать следующую команду для его отображения:

  • Маршрутизатор : curl http://<router_IP>:8081/v1/servers/self
  • Обработчик сообщений: curl http://<mp_IP>:8082/v1/servers/self
  • Qpid : curl http://<qp_IP>:8083/v1/servers/self
  • Postgres : завиток http://<pg_IP>:8084/v1/servers/self