Перенос серверов Apigee

Edge для частного облака версии 4.17.09

Компоненты 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:ra-1
    default=dc-1:ra-1

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

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

Для конфигураций с несколькими узлами 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:ra-1
    192.168.56.102=dc-1:ra-1
    192.168.56.103=dc-1:ra-1
    default=dc-1:ra-1

    Сохраните эту информацию.
  4. Измените файл /opt/apigee/customer/application/cassandra.properties, чтобы указать новый 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:ra-1\n

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

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

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

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

    Примечание. Параметр REGION ниже относится к центру обработки данных, в котором находится кластер. Например, для обеспечения высокой доступности обычно создается кластер в dc-1 (центр обработки данных 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 'content-type: application/x-www-form-urlencoded' -X POST
    • Для type="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 'content-type: 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-type: application/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

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

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

Уведомление узлов 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 restart

Как изменить IP-адрес сервера LDAP (OpenLDAP)

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

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

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

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

  1. Чтобы зарегистрировать новый внутренний и внешний IP-адрес, используйте следующую команду cURL:
    curl -u $ADMINEMAIL:$PW -X PUT http://$MSIP:8080/v1/servers/<uuid> -d ExternalIP=<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 curl http://<pg_IP>:8084/v1/servers/self