העברת שרתי Apigee

Edge for Private Cloud גרסה 4.18.05

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

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

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

עבור עם צומת Cassandra יחיד

1. עריכה של /opt/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. לפתיחת /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties בעורך. כתובת ה-IP הישנה והגדרת ברירת המחדל אמורים להופיע בטופס:

   192.168.56.101=dc-1:ra-1
   default=dc-1:ra-1

   שומרים את המידע הזה.

4. עריכה של /opt/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

   יש להזין '\n' אחרי כתובת ה-IP, ולציין את אותן הגדרות ברירת מחדל כמו שמצאתם למעלה בשלב 3.

5. הפעלה מחדש של Cassandra:

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart

6. אם צריך, אפשר גם לתקן את ZoomKeeper (ראו בהמשך), אחרת, להפעיל מחדש כל פלטפורמת Apigee שמתחיל ב-Management Server.

עבור הגדרות עם מספר צמתים של Cassandra (צלצול)

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

   שומרים את המידע הזה.

4. עריכה של /opt/apigee/customer/application/cassandra.properties כדי לשנות את כתובת ה-IP הישנה שצוינה לכתובת ה-IP החדשה:

   conf_cassandra-topology_topology=192.168.56.101=dc-1:ra-1\n192.168.56.102=dc-1:ra-1\n192.168.56.104=dc-1:ra-1\ndefault=dc-1:ra-1\n

   יש להזין '\n' אחרי כל כתובת IP, ותשתמשו באותן הגדרות ברירת מחדל שתוארו למעלה בשלב 3.

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

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart

6. הפעלה של nodetool ring בצומת שהשתנה כדי לוודא שהצלצול הושלם. אפשר למצוא את הכלי בכתובת /opt/apigee/apigee-cassandra/bin

   nodetool -h localhost ring

7. מריצים את nodetool repair צומת שהשתנה. הערה: התהליך עשוי להימשך זמן מה, ולכן מומלץ מאוד שלא לעשות זאת במהלך שעות השיא של התנועה ב-API.

   nodetool -h localhost repair

8. במידת הצורך, יש לתקן את ZoomKeeper (ראו בהמשך), ואז להפעיל מחדש כל רכיב בפלטפורמת Apigee מתחיל ב-Management Server.

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

1. מחפשים את מזהי ה-UUID של רישומי מאגר הנתונים שמציינים את כתובת ה-IP הישנה באמצעות הפרמטר פקודות שלמטה. חשוב לשים לב ל"סוג" ו-UUID :
   • curl -u ADMINEMAIL:PW "http://$MSIP:$port/v1/servers?pod=central&region=DC" | egrep -i '[type|internalip|uuid|region]'

   • curl -u ADMINEMAIL:PW "http://$MSIP:$port/v1/servers?pod=gateway&region=DC" | egrep -i '[type|internalip|uuid|region]'

   • curl -u ADMINEMAIL:PW "http://$MSIP:$port/v1/servers?pod=analytics&region=DC" | egrep -i '[type|internalip|uuid|region]'

     כאשר DC הוא השם של מרכז הנתונים. בהתקנה של מרכז נתונים יחיד, הוא בדרך כלל 'dc-1'.

2. לרשום את כתובות ה-IP החדשות באמצעות אחת מהפקודות הבאות. הפקודה הנדרשת תגרום לביצוע של תלויים בסוג הצומת שהשתנה.
   • עבור 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-urlencoded' -X POST

   • עבור 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=REGION&pod=GATEWAY_POD" -H 'content-type: \
       application/x-www-form-urlencoded' -X POST

   • עבור 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-urlencoded' -X POST 

3. מחיקת רישומים ישנים של ה-UUID של המערכת שבה כתובת ה-IP הייתה השתנה. בכל אחד מהבעיות הבאות עם מזהה ייחודי אוניברסלי (UUID):

   curl -u ADMINEMAIL:PW "http://MSIP:port/v1/servers/OLD_UUID" -X DELETE

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

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

שינוי כתובת ה-IP והפעלה מחדש של האנסמבל של ZzooKeeper (לתצורות של הרכבה מרובת צמתים בלבד)

1. פתיחת /opt/apigee/apigee-zookeeper/conf/zoo.cfg בעורך. אתם אמורים לראות כל כתובות ה-IP של ZoomKeeper והגדרות ברירת המחדל בטופס:

   server.1=192.168.56.101:2888:3888
   server.2=192.168.56.102:2888:3888
   server.3=192.168.56.103:2888:3888

   שומרים את המידע הזה.

2. בכל צומת של ZoomKeeper, עורכים את הקובץ /opt/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:3888\n

   יש להזין '\n' לאחר כל כתובת IP, והרשומות יופיעו באותו סדר בכל צומת.

3. כדי למצוא את המנהיג של המארז של ZogoKeeper, משתמשים בפקודה הבאה (מחליפים node מחליפים בכתובת ה-IP של מכשיר Zoomkeeper :

   echo srvr | nc node 2181

   בשורה Mode בפלט אמור להיות כתוב 'leader'.

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

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restart

5. משתמשים בפקודה echo שמתוארת למעלה כדי לאמת כל צומת של ZoomKeeper.

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

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

   /opt/apigee/apigee-service/bin/apigee-all restart

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

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

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

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

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

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

1. כדי לרשום את כתובת ה-IP הפנימית והחיצונית החדשה, צריך להשתמש בפקודה curl הבאה:

   curl -u ADMINEMAIL:PW -X PUT \
     http://MSIP:8080/v1/servers/uuid -d ExternalIP=ip
   curl -u ADMINEMAIL:PW -X PUT \
     http://$MSIP:8080/v1/servers/uuid -d InternalIP=ip

   כאשר uuid הוא ה-UUID של הצומת.

אם לא יודעים את ה-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