Trasladar servidores de Apigee

Edge para nube privada v. 4.17.01

Los componentes de Apigee usan direcciones IP para comunicarse entre sí. Mover componentes de una máquina a otra puede causar una discrepancia en la configuración. Para corregir las discrepancias de configuración, sigue las instrucciones pertinentes que se indican 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 configuraciones con un solo nodo de Cassandra

  1. Edita /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:
    • Establece los parámetros conf_cassandra_seeds y conf_cassandra_listen_address para especificar la nueva dirección IP del sistema.
    • Cambia conf_cassandra_rpc_address para usar la dirección IP nueva o 0.0.0.0 (lo que permite que Cassandra Thrift escuche en todas las interfaces).
  3. Abre /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 formato:
    192.168.56.101=dc-1:ra-1
    default=dc-1:ra-1

    Guarda esa información.
  4. Edita /opt/apigee/customer/application/cassandra.properties para cambiar la dirección IP anterior especificada a la dirección IP nueva:
    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 especifica la misma configuración predeterminada 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 más abajo); de lo contrario, reinicia cada componente de la plataforma de Apigee, comenzando por Management Server.

Para configuraciones con varios nodos de Cassandra (anillo)

  1. Si el nodo que se cambia es un nodo de origen, edita el archivo /opt/apigee/customer/application/cassandra.properties en cada sistema del anillo y cambia el parámetro conf_cassandra_seeds para incluir la IP nueva del sistema modificado. Si el archivo cassandra.properties no existe, créalo.
  2. Edita /opt/apigee/customer/application/cassandra.properties en el sistema que se está modificando y cambia los siguientes parámetros:
    • Configura conf_cassandra_listen_address para usar la dirección IP nueva.
    • Configura conf_cassandra_rpc_address para usar la nueva dirección IP o 0.0.0.0 (lo que permite que Cassandra Thrift escuche en todas las interfaces).
  3. Abre /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 el formato:
    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. Edita /opt/apigee/customer/application/cassandra.properties para cambiar la dirección IP anterior especificada a 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 usa la misma configuración predeterminada que registraste en el paso 3.
  5. Reinicia Cassandra en el sistema modificado. Si el sistema modificado es un nodo de origen, también reinicia cada sistema que usó el nodo de origen modificado.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
  6. Ejecuta el comando nodetool ring en el nodo modificado para asegurarte de que el anillo esté completo. La utilidad se puede encontrar en opt/apigee/apigee-cassandra/bin.
    > nodetool -h localhost ring
  7. Ejecuta nodetool repair en el nodo modificado. Ten en cuenta que este proceso puede tardar un poco, por lo que se recomienda que no se realice durante las horas de mayor tráfico de la API.
    > nodetool -h localhost repair
  8. Si es necesario, repara ZooKeeper (consulta más abajo) y, luego, reinicia cada componente de la plataforma de Apigee, comenzando por Management Server.

Actualiza los registros del almacén de datos

  1. Busca los UUID de los registros de almacenes de datos que especifican la dirección IP anterior con los siguientes comandos. Toma nota de los parámetros "type" y "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)'

      donde DC es el nombre del centro de datos. En una instalación de un solo centro de datos, el valor suele ser "dc-1".
  2. Registra las direcciones IP nuevas con uno de los siguientes comandos. El comando necesario dependerá del tipo de nodo modificado.

    Nota: El parámetro REGION que aparece a continuación hace referencia al centro de datos en el que se encuentra el clúster. Por ejemplo, para lograr alta disponibilidad, por lo general, tendrías un clúster en dc-1 (centro de datos 1) y un clúster en dc-2 (centro de datos 2). Este parámetro se define en el momento de la instalación. El valor predeterminado es dc-1.
    • 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 cambió la dirección IP. Para cada uno de estos UUID, emite lo siguiente:
    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 (solo para configuraciones de ensamble de varios nodos)

  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 siguiente 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 de que las entradas estén en el mismo orden en cada nodo.
  3. Busca el líder del conjunto 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 Mode en el resultado debe decir "leader".
  4. Reinicia un ZooKeeper después del otro, comenzando con el líder y terminando con el nodo en el que se cambió la dirección IP. Si más de un nodo de ZooKeeper cambió de dirección IP, es posible que sea necesario reiniciar todos los nodos.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restart
  5. Usa el comando echo descrito anteriormente para verificar cada nodo de ZooKeeper.

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

  1. En cada nodo de 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 de cadena conf_zookeeper_connection para incluir la nueva dirección IP.
    • Cambia el parámetro conf_zookeeper_zk1.host para incluir la nueva dirección IP.
  2. En cada nodo de Message Processor, 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 la dirección IP nueva.
    • Cambia el parámetro conf_zookeeper_zk1.host para incluir la dirección IP nueva.
  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 la dirección IP nueva.
    • Cambia el parámetro conf_zookeeper_zk1.host para incluir la dirección IP nueva.
  4. Reinicia todos los componentes de la plataforma de Apigee ejecutando el siguiente comando en cada nodo:
    /opt/apigee/apigee-service/bin/apigee-all restart

Cambia la dirección IP de un servidor LDAP (OpenLDAP)

Para cambiar la dirección IP de un nodo de 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, establece el parámetro conf_security_ldap.server.host en la nueva dirección IP.
  3. Reinicia el servidor de administración:
    > /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

Cambia la dirección IP de otros tipos de nodos de Apigee

Para cambiar la dirección IP de cualquiera de estos tipos de nodos (Router, Message Processor, Postgres Server [no postgresql] y Qpid Server [no qpidd]), haz lo siguiente:

  1. Usa el siguiente comando cURL para registrar la nueva dirección 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>

    donde 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