تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

إضافة عُقد Cassandra

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

يوضّح هذا المستند كيفية إضافة ثلاث عُقد Cassandra جديدة إلى تثبيت Edge for 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"

ملاحظة: أضِف كل عقدة Cassandra جديدة إلى CASS_HOSTS بعد عقدة حالية.

يضمن ذلك احتفاظ العُقد الحالية بإعدادات الرموز المميّزة الأولية، وأنّ الرمز المميّز الأولي لكل عقدة جديدة يقع بين قيم الرموز المميّزة للعُقد الحالية.

ضبط Edge

بعد تعديل ملف الإعداد، عليك إجراء ما يلي:

إعادة ضبط عُقد Cassandra الحالية
تثبيت Cassandra على العُقد الجديدة
إعادة ضبط خادم الإدارة

أعِد ضبط عُقد Cassandra الحالية

على عُقد Cassandra الحالية:

أعِد تشغيل setup.sh باستخدام الملف الشخصي "-p c" وملف الإعداد الجديد:
```
/opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile
```

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

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

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

أعِد تشغيل setup.sh لتحديث خادم الإدارة لعُقد Cassandra المُضافة حديثًا:
```
/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

ما عليك سوى تمرير اسم المستخدم وكلمة المرور إذا فعّلت مصادقة 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.