Edge for Private Cloud v4.19.01
本文档介绍了如何向现有 Edge for Private Cloud 安装添加三个新的 Cassandra 节点。
虽然您可以向现有 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 节点上:
- 使用“-p c”配置文件和新配置文件重新运行 setup.sh:
/opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile
在新节点上安装 Cassandra
在每个新的 Cassandra 节点上:
- 在三个节点上安装 Cassandra:
- 按照安装 Edge apigee-setup 实用程序中的说明,在第一个节点上安装
apigee-setup。 - 使用更新后的配置文件在第一个节点上安装 Cassandra:
/opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile
- 对其余的新 Cassandra 节点重复这两个步骤。
- 按照安装 Edge apigee-setup 实用程序中的说明,在第一个节点上安装
- 重新构建三个新的 Cassandra 节点,并指定配置文件中由
REGION属性设置的区域名称。在此示例中,该名称为“dc-1”:- 在第一个节点上,运行以下命令:
/opt/apigee/apigee-cassandra/bin/nodetool [-u username -pw password] -h nodeIP rebuild dc-1
其中 nodeIP 是 Cassandra 节点的 IP 地址。
只有在为 Cassandra 启用了 JMX 身份验证时,您才需要传递用户名和密码。
- 在其余的新 Cassandra 节点上重复此步骤。
- 在第一个节点上,运行以下命令:
重新配置管理服务器
在管理服务器节点上
- 重新运行 setup.sh,为新添加的 Cassandra 节点更新 Management Server:
/opt/apigee/apigee-setup/bin/setup.sh -p ms -f updatedConfigFile
重启所有路由器和消息处理器
- 在所有路由器上:
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
- 在所有消息处理器上:
/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
应指明 Thrift 服务器正在运行,这允许 Cassandra 接受新的客户端请求。
nodetool [-u username -pw password] -h nodeIP statusbinary
应指示原生传输(或二进制协议)正在运行。
nodetool describecluster
应显示新节点使用的架构版本与旧节点相同。
如需详细了解如何使用 nodetool,请参阅 nodetool 使用文档。