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

เอกสารนี้อธิบายวิธีเพิ่มโหนด 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 ในโหนดใหม่

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

  1. ติดตั้ง Cassandra บนโหนดทั้ง 3 โหนด ดังนี้
    1. ติดตั้ง apigee-setup ในโหนดแรกตามที่อธิบายไว้ในติดตั้งยูทิลิตี apigee-setup ของ Edge
    2. ติดตั้ง Cassandra ในโหนดแรกโดยใช้ไฟล์การกำหนดค่าที่อัปเดตแล้ว โดยทำดังนี้ 
      /opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile
    3. ทำ 2 ขั้นตอนนี้ซ้ำสำหรับโหนด Cassandra ใหม่ที่เหลือ
  2. สร้างโหนด Cassandra ใหม่ 3 โหนดอีกครั้ง โดยระบุชื่อภูมิภาคเป็นศูนย์ข้อมูลที่คุณกำลังเพิ่มโหนด (dc-1, dc-2 และอื่นๆ) ในตัวอย่างนี้คือ 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

รีสตาร์ทเราเตอร์และ Message Processor ทั้งหมด

  1. ในเราเตอร์ทั้งหมด ให้ทำดังนี้ 
    /opt/apigee/apigee-service/bin/apigee-service edge-router restart
  2. ใน Message Processor ทั้งหมด ให้ทำดังนี้ 
    /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 [-u username -pw password] -h nodeIP describecluster

ควรแสดงโหนดใหม่ที่ใช้เวอร์ชันสคีมาเดียวกันกับโหนดเก่า

ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ nodetool ได้ที่เอกสารประกอบการใช้งาน nodetool