درحال افزودن گره‌های 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 را در گره اول نصب کنید، همان‌طور که در نصب برنامه کمکی apigee-setup در Edge توضیح داده شده است.
    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 باقی‌مانده تکرار کنید.

پیکربندی مجدد سرور مدیریت

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

باید نشان دهد که گره‌های جدید از همان نسخه طرح‌واره گره‌های قدیمی‌تر استفاده می‌کنند.

برای اطلاعات بیشتر درباره استفاده از nodetool، سند استفاده از nodetool را ببینید.