การเพิ่มโหนด Cassandra

Edge สำหรับ Private Cloud เวอร์ชัน 4.19.01

เอกสารนี้จะอธิบายวิธีเพิ่มโหนด Cassandra ใหม่ 3 โหนดไปยัง Edge ที่มีอยู่สำหรับการติดตั้ง Private Cloud

แม้ว่าคุณจะเพิ่มโหนด Cassandra อย่างน้อย 1 หรือ 2 โหนดลงในการติดตั้ง Edge ที่มีอยู่ได้ แต่ Apigee ขอแนะนำให้คุณเพิ่มโหนดครั้งละ 3 โหนด

ดูรายการข้อกำหนดของระบบสำหรับโหนด Cassandra ได้ที่ข้อกำหนดในการติดตั้ง

การกำหนดค่า Edge ที่มีอยู่

โทโพโลยี Edge ที่รองรับทั้งหมดสำหรับระบบที่ใช้งานจริงระบุให้ใช้โหนด Cassandra 3 รายการ มีการระบุโหนด 3 โหนดให้กับพร็อพเพอร์ตี้ 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 ใหม่ 3 โหนด

ในตัวอย่างนี้ โหนด Cassandra ใหม่ 3 โหนดจะอยู่ที่ที่อยู่ 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. เรียกใช้ Setup.sh อีกครั้งด้วยโปรไฟล์ "-p c" และไฟล์การกำหนดค่าใหม่ดังนี้
    /opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile

ติดตั้ง Cassandra ในโหนดใหม่

ในโหนด Cassandra ใหม่แต่ละรายการ ให้ทำดังนี้

  1. ติดตั้ง Cassandra บนโหนด 3 โหนด ดังนี้
    1. ติดตั้ง apigee-setup บนโหนดแรกตามที่อธิบายไว้ในติดตั้งยูทิลิตี Edge Apigee-setup
    2. ติดตั้ง Cassandra ในโหนดแรกโดยใช้ไฟล์การกำหนดค่าที่อัปเดตแล้ว:
      /opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile
    3. ทำซ้ำ 2 ขั้นตอนนี้สำหรับโหนด Cassandra ใหม่ที่เหลืออยู่
  2. สร้างโหนด Cassandra ใหม่ทั้ง 3 โหนดอีกครั้ง โดยระบุชื่อภูมิภาคที่ตั้งไว้ในไฟล์การกำหนดค่าโดยใช้พร็อพเพอร์ตี้ REGION ในตัวอย่างนี้คือ "dc-1"
    1. ในโหนดแรก ให้เรียกใช้
      /opt/apigee/apigee-cassandra/bin/nodetool [-u username -pw password] -h nodeIP rebuild dc-1

      โดย nodeIP คือที่อยู่ IP ของโหนด Cassandra

      คุณจะต้องส่งชื่อผู้ใช้และรหัสผ่านต่อเมื่อเปิดใช้การตรวจสอบสิทธิ์ JMX สำหรับ Cassandra เท่านั้น

    2. ทำขั้นตอนนี้ซ้ำกับโหนด Cassandra ใหม่ที่เหลืออยู่

กำหนดค่าเซิร์ฟเวอร์การจัดการอีกครั้ง

ในโหนด Management-Server

  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

คุณจะต้องส่งชื่อผู้ใช้และรหัสผ่านต่อเมื่อเปิดใช้การตรวจสอบสิทธิ์ JMX สำหรับ Cassandra เท่านั้น

ยืนยันการสร้างใหม่

ใช้คำสั่งต่อไปนี้เพื่อยืนยันว่าการสร้างใหม่เสร็จสมบูรณ์แล้ว

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