إضافة عُقد Cassandra

Edge for Private Cloud الإصدار 4.19.01

يشرح هذا المستند طريقة إضافة ثلاث عُقد Cassandra جديدة إلى شبكة Edge الحالية لتثبيت Private Cloud.

بينما يمكنك إضافة عقدة 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. أعِد تشغيل setup.sh باستخدام الملف الشخصي "-p c" وملف الإعداد الجديد: 
    /opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile

تثبيت Cassandra على العُقد الجديدة

في كل عقدة Cassandra جديدة:

  1. ثبِّت Cassandra على العُقد الثلاث:
    1. ثبِّت apigee-setup على العقدة الأولى كما هو موضَّح في تثبيت الأداة المساعدة Edge apigee-setup.
    2. ثبِّت Cassandra على العقدة الأولى باستخدام ملف الإعداد المعدَّل: 
      /opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile
    3. كرر هاتين الخطوتين لعقد كاساندرا الجديدة المتبقية.
  2. عليك إعادة إنشاء عُقد Cassandra الثلاث الجديدة، مع تحديد اسم المنطقة التي تم ضبطها في ملف الإعداد من خلال السمة 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

يجب أن تشير هذه السمة إلى أنّ خادم التوفير قيد التشغيل، ما يسمح لـ "كاساندرا" بقبول طلبات العميل الجديدة.

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

يجب أن تشير هذه السمة إلى أنّ النقل الأصلي (أو البروتوكول الثنائي) قيد التشغيل.

nodetool describecluster

يجب أن يظهر أنّ العُقد الجديدة تستخدم إصدار المخطط نفسه مثل العُقد الأقدم.

لمزيد من المعلومات حول استخدام nodetool، يمكنك الاطّلاع على مستندات استخدام أداة nodetool.