העברת שרתי Apigee

Edge for Private Cloud גרסה 4.17.01

רכיבי 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. אם צריך, מתקנים גם את ZooKeeper (ראו בהמשך). אחרת, מפעילים מחדש כל רכיב בפלטפורמת Apigee, החל משרת הניהול.

במערכים עם כמה צומתי 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. אם צריך, מתקנים את ZooKeeper (ראו בהמשך) ומפעילים מחדש את כל הרכיבים של פלטפורמת Apigee, החל מ-Management Server.

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

1. כדי למצוא את מזהי ה-UUID של רישומי מאגר הנתונים שמציינים את כתובת ה-IP הישנה, משתמשים בפקודות הבאות. שימו לב לפרמטרים "type" ו-"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 החדשות באמצעות אחת מהפקודות הבאות. הפקודה שצריך להריץ תלויה בסוג הצומת שהשתנה.
   
   הערה: הפרמטר REGION שבהמשך מתייחס למרכז הנתונים שבו נמצא האשכול. לדוגמה, כדי להשיג זמינות גבוהה, בדרך כלל יהיה לכם אשכול ב-dc-1 (מרכז נתונים 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-urlencoded' -X POST
   • For 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 השתנתה. לכל אחד מהמזהים האלה, מנפיקים:
   curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers/${OLD_UUID}" -X DELETE

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

כדי לשנות את כתובת ה-IP של צומת ZooKeeper:

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

1. פתחו את /opt/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.168.56.103:2888:3888
   
   שומרים את המידע הזה.
2. בכל צומת ZooKeeper, עורכים את הקובץ ‎/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. מאתרים את ה-leader של אנסמבל ZooKeeper באמצעות הפקודה הבאה (מחליפים את <node> בכתובת ה-IP של מכונת Zookeeper):
   echo srvr | nc <node> 2181
   
   בשורת המצב בפלט אמור להופיע "leader".
4. מפעילים מחדש את ZooKeeper אחד אחרי השני, החל מה-leader וכלה בצומת שבו כתובת ה-IP השתנתה. אם כתובות ה-IP של יותר מצומת אחד של ZooKeeper השתנו, יכול להיות שצריך להפעיל מחדש את כל הצמתים.
   > /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restart
5. משתמשים בפקודה echo שמתוארת למעלה כדי לאמת כל צומת ZooKeeper.

מודיעים לצומתי 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. בצומת Management Server, עורכים את הקובץ /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. בצומת Management Server, עורכים את הקובץ /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 של כל אחד מסוגי הצמתים האלה (Router, ‏ מעבד בקשות, ‏ Postgres Server (לא postgresql) ו-Qpid Server (לא qpidd):

1. משתמשים בפקודת ה-cURL הבאה כדי לרשום את כתובת ה-IP הפנימית וכתובת ה-IP החיצונית החדשה:
   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