添加 Cassandra 节点

本文档介绍了如何将三个新的 Cassandra 节点添加到现有 Edge for Private 云端安装。

虽然您可以向现有 Edge 安装添加一个或两个 Cassandra 节点，但 Apigee 建议您一次添加三个节点。

如需 Cassandra 节点的系统要求列表，请参阅 安装要求。

现有 Edge 配置

生产系统支持的所有 Edge 拓扑都指定使用三个 Cassandra 节点。这三个节点在配置文件中的 CASS_HOSTS 属性中指定 如下所示：

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

请注意，REGION 属性将地区名称指定为“dc-1”。你需要 在添加新的 Cassandra 节点时提供相关信息。

修改配置文件以添加 三个新的 Cassandra 节点

在此示例中，三个新的 Cassandra 节点位于以下 IP 地址：

  • 10.10.0.14
  • 10.10.0.15
  • 10.10.0.16

您必须先更新 Edge 配置文件才能添加新节点：

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"

这样可以确保现有节点保留其初始令牌设置和初始令牌 介于现有节点的令牌值之间。

配置 Edge

修改配置文件后，您必须执行以下操作：

  • 重新配置现有的 Cassandra 节点
  • 在新节点上安装 Cassandra
  • 重新配置管理服务器

重新配置现有的 Cassandra 节点

在现有 Cassandra 节点上：

  1. 使用“-p c”重新运行 setup.sh配置文件和新的配置文件： 
    /opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile

在新节点上安装 Cassandra

按照以下步骤在新节点上安装 Cassandra。

在每个新的 Cassandra 节点上：

  1. 在三个节点上安装 Cassandra： <ph type="x-smartling-placeholder">
      </ph>
    1. 在以下设备上安装“apigee-setup”： 如安装 Edge apigee-setup 实用程序。
    2. 使用更新后的配置文件在第一个节点上安装 Cassandra： 
      /opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile
    3. 对剩余的新 Cassandra 节点重复执行这两个步骤。
  2. 重新构建三个新的 Cassandra 节点，并将区域名称指定为数据中心 在其中添加节点（dc-1、dc-2 等）。 在此示例中，它是 dc-1： <ph type="x-smartling-placeholder">
      </ph>
    1. 在第一个节点上，运行以下命令： 
      /opt/apigee/apigee-cassandra/bin/nodetool [-u username -pw password] -h nodeIP rebuild dc-1

      其中，nodeIP 是 Cassandra 节点的 IP 地址。

      只有在以下情况下，您才需要传递用户名和密码： 为 Cassandra 启用了 JMX 身份验证。

    2. 在剩余的新 Cassandra 节点上重复此步骤。

重新配置管理服务器

在管理服务器节点上

  1. 重新运行 setup.sh 文件，为新添加的 Cassandra 节点更新管理服务器： 
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f updatedConfigFile

重启所有路由器和邮件 处理器

  1. 在所有路由器上： 
    /opt/apigee/apigee-service/bin/apigee-service edge-router restart
  2. 在所有消息处理器上： 
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

现有磁盘 Cassandra 节点

添加新节点后，您可以在nodetool cleanup 先前存在的节点以释放磁盘空间。此命令会清除 不再归现有 Cassandra 节点所有。

要在添加新节点后释放现有 Cassandra 节点上的磁盘空间，请执行 以下命令：

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

只有在以下情况下，您才需要传递用户名和密码： 为 Cassandra 启用了 JMX 身份验证。

验证重新生成

使用以下命令验证重新构建是否成功：

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

当节点已启动且有索引时，此命令应指示 MODE: Normal 。

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

应指明旧服务器服务器正在运行，以便 Cassandra 接受新客户端 请求。

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

应表示本地传输（或二进制协议）正在运行。

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

应显示新节点使用的架构版本与旧节点相同。

如需详细了解如何使用 nodetool，请参阅 nodetool 用法文档。