إضافة عُقد Cassandra

يوضّح هذا المستند كيفية إضافة ثلاث عقد جديدة من Cassandra إلى عملية تثبيت حالية من Edge لخدمات Private Cloud.

على الرغم من أنّه يمكنك إضافة عقدة واحدة أو عقدتَين من عقد Cassandra إلى عملية تثبيت Edge حالية، تنصحك 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 على العقد الجديدة.

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

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

إعادة ضبط "خادم الإدارة"

على عقدة "خادم الإدارة"

  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 [-u username -pw password] -h nodeIP describecluster

يوضّح هذا الأمر ما إذا كانت العقد الجديدة تستخدِم إصدار المخطّط نفسه المستخدَم في العقد القديمة.

لمزيد من المعلومات حول استخدام nodetool، يُرجى الاطّلاع على مستندات استخدام nodetool.