Se usó la API de Cloud Translation para traducir esta página.

Agrega nodos de Cassandra

Cuando agregas nodos de Cassandra a un clúster, es fundamental tener en cuenta los siguientes dos puntos clave:

Las posiciones existentes de los nodos en el anillo de Cassandra no deben cambiar para minimizar la transmisión y mantener un anillo equilibrado.
La cantidad de nodos en todos los centros de datos debe ser coherente.

Para garantizar el primer objetivo, es fundamental duplicar la cantidad de nodos en el clúster de Cassandra cada vez que agregues nodos nuevos.

Por ejemplo, si comienzas con una topología estándar de instalación de clúster de 12 nodos distribuida en dos centros de datos, tendrás un total de seis nodos de Cassandra, tres en cada centro de datos. Para expandir este clúster, debes agregar tres nodos a cada centro de datos, lo que aumenta el recuento total de nodos a 12 (seis nodos en cada centro de datos). Si se requiere una expansión adicional, debes agregar seis nodos adicionales a cada centro de datos, lo que da como resultado un recuento total de 24 nodos (12 nodos en cada centro de datos).

En este documento, se proporcionan instrucciones para agregar tres nodos de Cassandra nuevos a una instalación existente de Edge para la nube privada. Se pueden seguir los mismos pasos para agregar nodos adicionales. Siempre asegúrate de que, cuando expandas el clúster, dupliques la cantidad de nodos.

Para obtener una lista de los requisitos del sistema para un nodo de Cassandra, consulta la sección Requisitos de instalación.

Configuración existente de Edge

Todas las topologías de Edge compatibles para un sistema de producción especifican el uso de tres nodos de Cassandra. Los tres nodos se especifican en la propiedad CASS_HOSTS del archivo de configuración, como se muestra a continuación:

IP1=10.10.0.1
IP2=10.10.0.2
IP3=10.10.0.3
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1 
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=1
APIGEE_LDAPPW=secret
MP_POD=gateway
REGION=dc-1
ZK_HOSTS="$IP1 $IP2 $IP3"
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1" 
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
SMTPPASSWORD=smtppwd

Ten en cuenta que la propiedad REGION especifica el nombre de la región como "dc-1". Necesitas esa información cuando agregues los nuevos nodos de Cassandra.

Modifica el archivo de configuración para agregar los tres nodos de Cassandra nuevos

En este ejemplo, los tres nodos de Cassandra nuevos se encuentran en las siguientes direcciones IP:

10.10.0.14
10.10.0.15
10.10.0.16

Primero, debes actualizar el archivo de configuración de Edge para agregar los nodos nuevos:

IP1=10.10.0.1
IP2=10.10.0.2
IP3=10.10.0.3
# Add the new node IP addresses.
IP14=10.10.0.14
IP15=10.10.0.15
IP16=10.10.0.16
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@google.com
...
# Update CASS_HOSTS to add each new node after an existing nodes. 
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1:1,1 $IP14:1,1 $IP2:1,1 $IP15:1,1 $IP3:1,1 $IP16:1,1"

Nota: Agrega cada nodo de Cassandra nuevo a CASS_HOSTS después de un nodo existente.

Esto garantiza que los nodos existentes conserven su configuración de token inicial y que el token inicial de cada nodo nuevo esté entre los valores de token de los nodos existentes.

Nota: A continuación, se incluyen algunos ejemplos:

Una instalación estándar de 12 nodos (6 nodos de Cassandra):

CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1 $IP7:2,1 $IP8:2,1 $IP9:2,1"

Para expandir el clúster anterior y duplicar la capacidad con 12 nodos de Cassandra (6 en cada DC), haz lo siguiente:

CASS_HOSTS="$IP1:1,1 $IP13:1,1 $IP2:1,1 $IP14:1,1 $IP3:1,1 $IP15:1,1 $IP7:2,1 $IP16:2,1 $IP8:2,1 $IP17:2,1 $IP9:2,1 $IP18:2,1"

Para expandir aún más el clúster anterior y duplicarlo con 24 nodos de Cassandra (12 en cada DC), haz lo siguiente:

CASS_HOSTS="$IP1:1,1 $IP19:1,1 $IP13:1,1 $IP20:1,1 $IP2:1,1 $IP21:1,1 $IP14:1,1 $IP22:1,1 $IP3:1,1 $IP23:1,1 $IP15:1,1 $IP24:1,1 $IP7:2,1 $IP25:2,1 $IP16:2,1 $IP26:2,1 $IP8:2,1 $IP27:2,1 $IP17:2,1 $IP28:2,1 $IP9:2,1 $IP29:2,1 $IP18:2,1 $IP30:2,1"

Configura Edge

Después de editar el archivo de configuración, debes hacer lo siguiente:

Cómo volver a configurar los nodos de Cassandra existentes
Instala Cassandra en los nodos nuevos
Vuelve a configurar el servidor de administración

Reconfigura los nodos de Cassandra existentes

En los nodos de Cassandra existentes, haz lo siguiente:

Vuelve a ejecutar setup.sh con el perfil "-p c" y el nuevo archivo de configuración:
```
/opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile
```

Instala Cassandra en los nodos nuevos

Usa el siguiente procedimiento para instalar Cassandra en los nodos nuevos.

Nota: Cassandra usa los nombres fijos de centros de datos dc-1, dc-2, etcétera, independientemente de los nombres de región especificados en la propiedad REGION del archivo de configuración para las regiones en las que instalas los nodos nuevos. En el paso 2 del siguiente procedimiento, debes usar los nombres de los centros de datos de Cassandra (dc-1, dc-2, etcétera). en los comandos.

En cada nodo de Cassandra nuevo, haz lo siguiente:

Instala Cassandra en los tres nodos:
1. Instala apigee-setup en el primer nodo como se describe en Instala la utilidad apigee-setup de Edge.
2. Instala Cassandra en el primer nodo con el archivo de configuración actualizado:
```
/opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile
```
3. Repite estos dos pasos para los nodos de Cassandra nuevos restantes.
Vuelve a compilar los tres nodos de Cassandra nuevos y especifica el nombre de la región como el centro de datos en el que agregas el nodo (dc-1, dc-2, etcétera). En este ejemplo, es dc-1:
1. En el primer nodo, ejecuta lo siguiente:
```
/opt/apigee/apigee-cassandra/bin/nodetool [-u username -pw password] -h nodeIP rebuild dc-1
```
  En el que nodeIP es la dirección IP del nodo de Cassandra.
  
  Solo debes pasar tu nombre de usuario y contraseña si habilitaste la autenticación de JMX para Cassandra.
2. Repite este paso en los nodos de Cassandra nuevos restantes.

Vuelve a configurar el servidor de administración

En un nodo de servidor de administración

Vuelve a ejecutar setup.sh para actualizar el servidor de administración de los nodos de Cassandra recién agregados:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ms -f updatedConfigFile
```

Reinicia todos los routers y procesadores de mensajes

En todos los routers:

/opt/apigee/apigee-service/bin/apigee-service edge-router restart

En todos los procesadores de mensajes:

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

Espacio en disco libre en los nodos de Cassandra existentes

Después de agregar un nodo nuevo, puedes usar el comando nodetool cleanup en los nodos preexistentes para liberar espacio en el disco. Este comando borra los tokens de configuración que ya no son propiedad del nodo Cassandra preexistente.

Para liberar espacio en disco en los nodos de Cassandra preexistentes después de agregar un nodo nuevo, ejecuta el siguiente comando:

/opt/apigee/apigee-cassandra/bin/nodetool [-u username -pw password] -h cassandraIP cleanup

Solo debes pasar tu nombre de usuario y contraseña si habilitaste la autenticación de JMX para Cassandra.

Verifica la compilación

Usa los siguientes comandos para verificar que la recompilación se realizó correctamente:

nodetool [-u username -pw password] -h nodeIP netstats

Este comando indica si se está ejecutando el transporte nativo (o protocolo binario), lo que permite que Cassandra acepte solicitudes de clientes nuevas.

nodetool [-u username -pw password] -h nodeIP statusbinary

Este comando indica si se está ejecutando el transporte nativo (o protocolo binario).

nodetool [-u username -pw password] -h nodeIP describecluster

Este comando muestra si los nodos nuevos usan la misma versión de esquema que los nodos más antiguos.

Nota: El comando statusthrift ya no está disponible en Apache Cassandra 4.x porque se quitó la API de Thrift, como se describe en CASSANDRA-11115. En Apigee OPDK 4.53.00, el puerto 9160 dejó de estar disponible y ya no es necesario. El puerto 9042 ahora es el puerto de cliente principal para las conexiones de Cassandra. Para obtener más información, consulta el anuncio sobre la baja de la API de Thrift.

Para obtener más información sobre el uso de nodetool, consulta la documentación de uso de nodetool.