Trasladar servidores de Apigee

Edge for Private Cloud v4.18.05

Los componentes de Apigee usan direcciones IP para comunicarse entre sí. Mover componentes de un una máquina virtual a otra puede causar una discrepancia en la configuración. Para corregir las discrepancias de configuración, sigue las instrucciones relevantes a continuación.

Cambia la dirección IP de un nodo de Cassandra

Para cambiar la dirección IP de un nodo de Cassandra, sigue estos pasos:

Para configuración con un solo nodo de Cassandra

  1. Editar /opt/apigee/customer/application/cassandra.properties en el sistema que se está modificando. Si el archivo no existe, créalo.
  2. Cambia los siguientes parámetros:
    • Configura conf_cassandra_seeds y conf_cassandra_listen_address. parámetros para especificar la nueva dirección IP del sistema.
    • Cambia el conf_cassandra_rpc_address que quieres usar ya sea la nueva dirección IP o 0.0.0.0 (lo que le permite a Cassandra Thrift escuchar en todos (interfaces de programación de aplicaciones).
  3. Abrir /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties en un editor. Deberías ver la dirección IP anterior y la configuración predeterminada en el siguiente formulario: 
    192.168.56.101=dc-1:ra-1
default=dc-1:ra-1

    Guarda esa información.

  4. Editar /opt/apigee/customer/application/cassandra.properties para cambiar la dirección IP anterior especificada por la nueva dirección IP: 
    conf_cassandra-topology_topology=192.168.56.103=dc-1:ra-1\ndefault=dc-1:ra-1\n

    Asegúrate de insertar “\n” después de la dirección IP y especificar la misma configuración predeterminada que que encontraste en el paso 3.

  5. Reinicia Cassandra: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
  6. Si es necesario, también repara ZooKeeper (consulta a continuación) o reinicia todas las plataformas de Apigee. que inicia con el servidor de administración.

Para configuraciones con varios nodos de Cassandra (anillo)

  1. Si el nodo que se modifica es un nodo de origen, edita /opt/apigee/customer/application/cassandra.properties. archivo en cada sistema del anillo y cambia el parámetro conf_cassandra_seeds para incluir la nueva IP del sistema modificado. Si el archivo cassandra.properties no existe, crea que la modifica.
  2. Editar /opt/apigee/customer/application/cassandra.properties en el sistema que se está modificando y cambiar los siguientes parámetros:
    • Configura conf_cassandra_listen_address para usar la dirección IP nueva.
    • Configura conf_cassandra_rpc_address para que use la dirección IP nueva o “0.0.0.0”. (que permite que Cassandra Thrift escuche en todas las interfaces).
  3. Abrir /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties en un editor. Deberías ver todas las direcciones IP de Cassandra y la configuración predeterminada en la formulario: 
    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

    Guarda esa información.

  4. Editar /opt/apigee/customer/application/cassandra.properties para cambiar la dirección IP anterior especificada por la nueva dirección 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

    Asegúrate de insertar “\n” después de cada dirección IP y usarás la misma configuración predeterminada registradas anteriormente en el paso 3.

  5. Reinicia Cassandra en el sistema modificado. Si el sistema modificado es un nodo de origen, también reiniciar cada sistema que usó el nodo inicial modificado. 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
  6. Ejecuta nodetool ring. en el nodo modificado para garantizar que el anillo esté completo. Puedes encontrar la utilidad en /opt/apigee/apigee-cassandra/bin 
    nodetool -h localhost ring
  7. Ejecuta nodetool repair en la nodo modificado. Ten en cuenta que este proceso puede tardar un poco, por lo que es muy recomendable que no se realice en las horas pico de tráfico de API. 
    nodetool -h localhost repair
  8. Si es necesario, repara ZooKeeper (consulta a continuación) y, luego, reinicia todos los componentes de la plataforma de Apigee. empezando por el servidor de administración.

Actualiza el almacén de datos registros

  1. Busca los UUID de los registros del almacén de datos que especifican la dirección IP anterior con el a continuación. Anota el "tipo" y "UUID" parámetros: 
    • 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]'

      En el ejemplo anterior, DC es el nombre del centro de datos. En una instalación de centro de datos única, el valor suele ser “dc-1”.

  2. Registra las direcciones IP nuevas con uno de los siguientes comandos. El comando necesario dependen del tipo de nodo modificado.
    • Para 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
    • Para 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
    • Para 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. Borra los registros antiguos del UUID del sistema en el que se encontraba la dirección IP cambió. Problema para cada uno de estos UUID: 
    curl -u ADMINEMAIL:PW "http://MSIP:port/v1/servers/OLD_UUID" -X DELETE

Cambia la dirección IP de un nodo de ZooKeeper

Sigue los pasos que se indican a continuación para cambiar la dirección IP de un nodo de ZooKeeper:

Cambia la dirección IP y reinicia el ensamble de ZooKeeper (para configuraciones de ensamble de varios nodos) solo)

  1. Abre /opt/apigee/apigee-zookeeper/conf/zoo.cfg en un editor. Deberías ver Todas las direcciones IP de ZooKeeper y la configuración predeterminada en el formato: 
    server.1=192.168.56.101:2888:3888
server.2=192.168.56.102:2888:3888
server.3=192.168.56.103:2888:3888

    Guarda esa información.

  2. En cada nodo de ZooKeeper, edita el archivo /opt/apigee/customer/application/zookeeper.properties. para establecer la propiedad conf_zoo_quorum en las direcciones IP correctas. Si el archivo no existe, créalo. 
    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

    Asegúrate de insertar “\n” después de cada dirección IP y que las entradas estén en el mismo orden en todos los nodos.

  3. Encuentra al líder del ensamble de ZooKeeper con el siguiente comando (reemplaza node por la dirección IP de la máquina de Zookeeper: 
    echo srvr | nc node 2181

    La línea de modo en el resultado debe decir "leader".

  4. Reiniciar un ZooKeeper después del otro comenzando con el líder y finalizando con el nodo en por la que se cambió la dirección IP. Si más de un nodo de Zookeeper cambió la dirección IP, es posible que necesario reiniciar todos los nodos. 
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restart
  5. Usa el comando echo que se describió anteriormente para verificar cada nodo de ZooKeeper.

Informar a los nodos de Apigee sobre el cambio de configuración

  1. En cada nodo del router, edita el archivo /opt/apigee/customer/application/router.properties. de la siguiente manera. Si el archivo no existe, créalo.
    • Cambia el parámetro conf_zookeeper_connection.string para incluir la IP nueva dirección
    • Cambia el parámetro conf_zookeeper_zk1.host para incluir la IP nueva dirección
  2. En cada nodo del procesador de mensajes, edita el archivo /opt/apigee/customer/application/message-processor.properties. de la siguiente manera. Si el archivo no existe, créalo.
    • Cambia el parámetro conf_zookeeper_connection.string para incluir el nuevo Dirección IP
    • Cambia el parámetro conf_zookeeper_zk1.host para incluir la IP nueva dirección
  3. En el nodo del servidor de administración, edita el archivo /opt/apigee/customer/application/management-server.properties. de la siguiente manera. Si el archivo no existe, créalo.
    • Cambia el parámetro conf_zookeeper_connection.string para incluir el nuevo Dirección IP
    • Cambia el parámetro conf_zookeeper_zk1.host para incluir la IP nueva dirección
  4. Ejecuta el siguiente comando en cada nodo para reiniciar todos los componentes de la plataforma de Apigee: 
    /opt/apigee/apigee-service/bin/apigee-all restart

Cómo cambiar la dirección IP de un servidor LDAP (OpenLDAP)

Para cambiar la dirección IP de un nodo OpenLDAP, haz lo siguiente:

  1. En el nodo del servidor de administración, edita el archivo /opt/apigee/customer/application/management-server.properties. . Si el archivo no existe, créalo.
  2. En el archivo management-server.properties, configura la El parámetro conf_security_ldap.server.host a la dirección IP nueva.
  3. Reinicia el servidor de administración: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

Cambiar la dirección IP de otro nodo de Apigee tipos

Cambiar la dirección IP de cualquiera de estos tipos de nodos (router, procesador de mensajes, Postgres Servidor (no postgresql) y servidor Qpid (no qpidd):

  1. Usa el siguiente comando de curl para registrar las nuevas direcciones IP interna y externa: 
    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

    En el que uuid es el UUID del nodo.

Si no conoces el UUID del nodo, puedes usar el siguiente comando para mostrarlo:

  • Router: 
    curl http://router_IP:8081/v1/servers/self
  • Message Processor: 
    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