העברת שרתי Apigee

Edge for Private Cloud גרסה 4.16.09

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

שינוי כתובת ה-IP של צומת Cassandra

כדי לשנות את כתובת ה-IP של צומת Cassandra, יש לבצע את השלבים הבאים:

להגדרות עם צומת Cassandra יחיד

  1. עורכים את /<inst_root>/apigee/customer/application/cassandra.properties במערכת שמתבצעת בה שינוי. אם הקובץ לא קיים, יוצרים אותו.
  2. משנים את הפרמטרים הבאים:
    • מגדירים את הפרמטרים conf_cassandra_seeds ו-conf_cassandra_listen_address כדי לציין את כתובת ה-IP החדשה של המערכת.
    • משנים את הפרמטר conf_cassandra_rpc_address כך שתשתמש בכתובת ה-IP החדשה או ב-0.0.0.0 (שמאפשר ל-Cassandra Thrift להאזין בכל הממשקים).
  3. פותחים את /<inst_root>/apigee/apigee-cassandra/conf/cassandra-topology.properties בעורך. כתובת ה-IP הישנה והגדרת ברירת המחדל אמורים להופיע בתבנית הבאה:
    192.168.56.101=dc-1:ra-1
    default=dc-1:ra-1

    שומרים את המידע הזה.
  4. עורכים את /<inst_root>/apigee/customer/application/cassandra.properties כדי לשנות את כתובת ה-IP הישנה שצוינה לכתובת ה-IP החדשה:
    conf_cassandra-topology_topology=192.168.56.103=dc-1:ra-1\ndefault=dc-1:ra-1\n
    , לאחר הזנת כתובת ה-IP שלמעלה, תציינו את כתובת ה-IP הזו כ-3"

  5. מפעילים מחדש את Cassandra:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-cassandra הפעלה מחדש
  6. במידת הצורך, אפשר גם לתקן אתzoKeeper (לפי ההוראות שבהמשך). אם צריך, מפעילים מחדש כל רכיב בפלטפורמה של Apigee ומתחילים ב-Management Server.

להגדרות עם כמה צומתי Cassandra (טבעת)

  1. אם הצומת שמשתנה הוא צומת מקור, עורכים את הקובץ /<inst_root>/apigee/customer/application/cassandra.properties בכל מערכת בעיגול, ומשנים את הפרמטר conf_cassandra_seeds כך שיכלול את כתובת ה-IP החדשה של המערכת ששונתה. אם הקובץ cassandra.properties לא קיים, יוצרים אותו.
  2. עורכים את /<inst_root>/apigee/customer/application/cassandra.properties במערכת שמתבצעת עכשיו ומשנים את הפרמטרים הבאים:
    • מגדירים את conf_cassandra_listen_address כך שתשתמש בכתובת ה-IP החדשה.
    • מגדירים את conf_cassandra_rpc_address כך שתשתמש בכתובת ה-IP החדשה או ב-0.0.0.0 (הדבר מאפשר ל-Cassandra Thrift להאזין בכל הממשקים).
  3. פותחים את /<inst_root>/apigee/apigee-cassandra/conf/cassandra-topology.properties בעורך. כל כתובות ה-IP של Cassandra והגדרות ברירת המחדל יופיעו בפורמט:
    192.168.56.101=dc-1:ra-1
    192.168.56.102=dc-1:ra-1
    192.168.56.103=dc-1:ra-1:
    default=1:ra-1:
    default=1:ra-1:
    default=1
  4. עורכים את /<inst_root>/apigee/customer/application/cassandra.properties כדי לשנות את כתובת ה-IP הישנה שצוינה לכתובת ה-IP החדשה:
    /<inst_root>/apigee/customer/application/cassandra.properties

    n192.168.56.104
  5. הפעל מחדש את Cassandra במערכת ששונתה. אם המערכת ששונתה היא צומת מקור, צריך גם להפעיל מחדש כל מערכת שהשתמשו בצומת המקור שהשתנה.
    > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-cassandra הפעלה מחדש
  6. מריצים את הפקודה טבעת כלי ה-nodetool בצומת ששונה כדי לוודא שהטבעת מלאה. ניתן למצוא את כלי העזר בכתובת <inst_root>/apigee/apigee-cassandra/bin.
    > dottool -h localhost טבעת
  7. מפעילים את תיקון כלי ה-nodetool בצומת שהשתנה. הערה: התהליך הזה עשוי להימשך זמן מה, ולכן מומלץ מאוד לא לבצע אותו בשעות השיא של תנועת ה-API.
    >> Novetool - תיקון מארח מקומי
  8. במידת הצורך, צריך לתקן אתzoKeeper (לפי ההוראות שבהמשך), ולאחר מכן להפעיל מחדש כל רכיב בפלטפורמה של Apigee, החל מ-Management Server

עדכון רישומים של מאגר נתונים

  1. ניתן למצוא את מזהי ה-UUID של רישומי מאגר נתונים שמציינים את כתובת ה-IP הישנה, באמצעות הפקודות שבהמשך. חשוב לשים לב לפרמטרים 'type' ו-'UUID':
    • curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers?pod=central" | egRep -i '(type|internalip|uuid|region)'
    • curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers?pod=gateway" | egRep -i '(type|internalip|uuid|region)'
    • curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers?pod=analytics" | egRep -i '(type|internalip|uuid|region)'
  2. עליך לרשום את כתובות ה-IP החדשות באמצעות אחת מהפקודות שלמטה. סוג הפקודה הנדרשת תלוי בסוג של הצומת שהשתנה.

    הערה: הפרמטר REGION שבהמשך מתייחס למרכז הנתונים שבו נמצא האשכול. לדוגמה, בזמינות גבוהה בדרך כלל השימוש באשכול ב-dc-1 (Dater Center 1) ובאשכול ב-dc-2 (מרכז נתונים 2). הפרמטר הזה מוגדר בזמן ההתקנה. ערך ברירת המחדל הוא dc-1.
    • עבור type="application-datastore":
      curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers -d "Type=application-datastore&Type=audit-datastore&InternalIP=${NEWIP}&region=${REGION}&pod=central" -H 'content-type: application/x-www-form
    • עבור type="kms-datastore":
      curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers -d "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore&Type=counter-datastore&Type=cache-datastore &InternalIP=${NEWIP}&region=$form}{NEWIP}&region=$${NEWIP}&region=$
    • עבור type="reportcrud-datastore":
      curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers" -d "Type=reportcrud-datastore&InternalIP=${NEW_IP}&region=${REGION}&pod=analytics" -H 'content-type: application/x-www-form-url
  3. מחיקת רישומים ישנים של מזהה ייחודי אוניברסלי (UUID) של המערכת שבה כתובת ה-IP השתנתה. לכל אחת מהבעיות האלה שקשורות ל-UUID:
    curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers/${OLD_UUID}" -X DELETE

שינוי כתובת ה-IP של צומת גן החיות

בצע את השלבים הבאים כדי לשנות את כתובת ה-IP של צומת גן החיות:

שינוי כתובת ה-IP והפעלה מחדש של מתחם גן החיות (ZooKeeper) (לתצורות של שילובים מרובים בלבד)

  1. פותחים את /<inst_root>/apigee/apigee-zookeeper/conf/zoo.cfg בעורך. כל כתובות ה-IP והגדרות ברירת המחדל של שמוצגים ב-ZooKeeper יופיעו באופן הזה:
    server.1=192.168.56.101:2888:3888
    server.2=192.168.56.102:2888:3888
    server.3=192.163.56.18 שמור את המידע הזה

  2. בכל צומת של גן החיות, עורכים את הקובץ /<inst_root>/apigee/customer/application/zookeeper.properties כדי להגדיר את המאפיין conf_zoo_quorum לכתובות ה-IP הנכונות. אם הקובץ לא קיים, יוצרים אותו.
    conf_zoo_quorum=server.1=192.168.56.101:2888:3888\nserver.2=192.168.56.102:2888:3888\nserver.3=192.168.56.104:2888:38 (כל כתובת IP אחרי כל צומת מוכנסת באותה צומת ו-
    ).
    יש להקפיד שכל כתובת IP תוזן באותה כתובת.
  3. מאתרים את המנהיג של המערך שלzoKeeper באמצעות הפקודה הבאה (מחליפים את <node> בכתובת ה-IP של מכונת גן החיות):
    echo srvr | nc <node> 2181

    בשורת המצב בפלט אמורה להיות כתוב "leader".
  4. מפעילים מחדש את גן חיות אחד אחרי השני, שמתחילה במוביל ומסתיימת בצומת שבו כתובת ה-IP השתנתה. אם כתובת ה-IP שונתה על ידי יותר מצומת אחד שלzokeeper, ייתכן שיהיה צורך להפעיל מחדש את כל הצמתים.
    > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-zookeeper הפעלה מחדש
  5. משתמשים בפקודת ה-echo המתוארת למעלה כדי לאמת כל צומת שלzoKeeper.

עדכון צומתי Apigee של התצורה ששונתה

  1. בכל צומת של נתב, עורכים את הקובץ /<inst_root>/apigee/customer/application/router.properties באופן הבא. אם הקובץ לא קיים, יוצרים אותו.
    • צריך לשנות את הפרמטר conf_zookeeper_connection.string כך שיכלול את כתובת ה-IP החדשה
    • משנים את הפרמטר conf_zookeeper_zk1.host כך שיכלול את כתובת ה-IP החדשה
  2. בכל צומת של מעבד ההודעות, עורכים את הקובץ /<inst_root>/apigee/customer/application/message-processor.properties באופן הבא. אם הקובץ לא קיים, יוצרים אותו.
    • צריך לשנות את הפרמטר conf_zookeeper_connection.string כך שיכלול את כתובת ה-IP החדשה
    • משנים את הפרמטר conf_zookeeper_zk1.host כך שיכלול את כתובת ה-IP החדשה
  3. בצומת של שרת הניהול, עורכים את הקובץ /<inst_root>/apigee/customer/application/management-server.properties באופן הבא. אם הקובץ לא קיים, יוצרים אותו.
    • צריך לשנות את הפרמטר conf_zookeeper_connection.string כך שיכלול את כתובת ה-IP החדשה
    • משנים את הפרמטר conf_zookeeper_zk1.host כך שיכלול את כתובת ה-IP החדשה
  4. מפעילים מחדש את כל רכיבי הפלטפורמה של Apigee באמצעות הפקודה הבאה בכל צומת:
    /<inst_root>/apigee/apigee-service/bin/apigee-all הפעלה מחדש

שינוי כתובת ה-IP של שרת LDAP (OpenLDAP)

כדי לשנות את כתובת ה-IP של צומת OpenLDAP, צריך לבצע את הפעולות הבאות:

  1. בצומת של שרת הניהול, עורכים את הקובץ /<inst_root>/apigee/customer/application/management-server.properties. אם הקובץ לא קיים, יוצרים אותו.
  2. בקובץ management-server.properties, מגדירים את הפרמטר conf_security_ldap.server.host לכתובת ה-IP החדשה.
  3. מפעילים מחדש את שרת הניהול:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server מחדש

שינוי כתובת ה-IP של סוגי צמתים אחרים ב-Apigee

כדי לשנות את כתובת ה-IP של כל אחד מסוגי הצמתים האלה (נתב, מעבד הודעות, שרת Postgres (לא postgresql) ושרת Qpid (לא qpidd):

  1. משתמשים בפקודת cURL הבאה כדי לרשום את כתובת ה-IP הפנימית והחיצונית:
    curl -u $ADMINEMAIL:$PW -X PUT http://$MSIP:8080/v1/servers/<uuid> -d ExternalIP=<ip>
    curl -u $EMAIL:$PW -X PUTu$

אם לא יודעים את ה-UUID של הצומת, אפשר להציג אותו באמצעות הפקודה הבאה:

  • נתב: curl http://<router_IP>:8081/v1/servers/self
  • מעבד הודעות: curl http://<mp_IP>:8082/v1/servers/self
  • Qpid: curl http://<qp_IP>:8083/v1/servers/self
  • Postgres: curl http://<pg_IP>:8084/v1/servers/self