הוספת צמתים של קסנדרה

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"

כך אפשר לוודא שהצמתים הקיימים ישמרו על הגדרות האסימון הראשוניות שלהם, ושהאסימון הראשוני של כל צומת חדש יהיה בין ערכי האסימון של הצמתים הקיימים.

הגדרת 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 בצומת הראשון, כמו שמתואר בקטע התקנת כלי השירות apigee-setup של Edge.
    2. מתקינים את Cassandra בצומת הראשון באמצעות קובץ התצורה המעודכן: 
      /opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile
    3. חוזרים על שני השלבים האלה בשאר צומתי Cassandra החדשים.
  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

ההודעה הזו מציינת ששרת ה-Thrift פועל, מה שמאפשר ל-Cassandra לקבל בקשות חדשות מלקוחות.

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

הפלט אמור לציין שהתעבורה המקומית (או הפרוטוקול הבינארי) פועלת.

nodetool describecluster

צריך להראות שהצמתים החדשים משתמשים באותה גרסת סכימה כמו הצמתים הישנים יותר.

מידע נוסף על השימוש ב-nodetool זמין במסמכי התיעוד של nodetool.