התקנה ושחזור של רכיבים

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

שומר בגן החיות אפאצ'י

שחזור של צומת עצמאי אחד

1. הפסקת גן החיות:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

2. הסרת ספריות ישנות של ZoomKeeper:

   /opt/apigee/data/apigee-zookeeper
   /opt/apigee/etc/apigee-zookeeper.d

3. מתקינים מחדש את ZoomKeeper:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper install

4. שחזור ZoomKeeper:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restore 2019.03.17,14.40.41

   חשוב לשים לב: כשמשחזרים רכיב, לא מציינים את נתיב הספרייה לגיבוי וגם לא מציינים את ה"גיבוי" או " .tar.gz" הסיומת ציינו רק תאריך/שעה של שם קובץ הגיבוי.

   ניתן גם להשמיט את קובץ הגיבוי בפקודה restore ו-Edge להשתמש בקובץ הגיבוי העדכני ביותר מספריית הגיבוי של הרכיב.

5. מפעילים מחדש את כל הרכיבים:

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

שחזור צומת של אשכול אחד

אם צומת שלzoKeeper יחיד נכשל כי הוא חלק ממתחם, אפשר ליצור צומת חדש עם את אותו שם מארח/כתובת IP, ומתקינים מחדש את ZoomKeeper. כשהצומת החדש ZoomKeeper מצטרף אל ב-ZooKeeper הוא מקבל את תמונות המצב האחרונות מהמנהיג ומתחיל לתת שירות ללקוחות. במקרה הזה אין צורך לשחזר נתונים.

1. מתקינים מחדש את ZoomKeeper:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper install

2. מריצים את ההגדרה בצומתZoKeeper באמצעות אותו קובץ תצורה שמשמש להתקנה של הצומת המקורי:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper setup -f configFile

3. מפעילים את ZoomKeeper:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper start

שחזור של אשכול מלא

1. לעצור את האשכול המלא.
2. שחזור כל הצמתים של ZoomKeeper מקובץ הגיבוי כפי שמתואר למעלה עבור צומת אחד.
3. מפעילים את האשכול ZoomKeeper.
4. מפעילים מחדש את כל הרכיבים.

אפאצ'י קסנדרה

שחזור של צומת עצמאי אחד

1. הפסקת קסנדרה:

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

2. הסרת ספריית Cassandra ישנה:

   /opt/apigee/data/apigee-cassandra

3. התקינו מחדש את Cassandra:

   /apigee/apigee-service/bin/apigee-service apigee-cassandra install

4. שחזור של קסנדרה:

   /apigee/apigee-service/bin/apigee-service apigee-cassandra restore 2019.03.17,14.40.41

   חשוב לשים לב: כשמשחזרים רכיב, לא מציינים את נתיב הספרייה לגיבוי וגם לא מציינים את ה"גיבוי" או " .tar.gz" הסיומת ציינו רק תאריך/שעה של שם קובץ הגיבוי.

   ניתן גם להשמיט את קובץ הגיבוי בפקודה restore ו-Edge להשתמש בקובץ הגיבוי העדכני ביותר מספריית הגיבוי של הרכיב.

5. צריך להפעיל מחדש את כל הרכיבים:
   

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

שחזור צומת של אשכול אחד

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

אם לא ניתן לגשת יותר לצומת שנכשל, יש להשמיד את הצומת ולבודד את הרשת שלו כדי לוודא שהוא לא יוכל להצטרף מחדש בטעות לאשכול Cassandra. לאחר מכן הוא מציג צומת חדש עם אותה כתובת IP כמו הצומת המקורי, ומריצים עליו את שלבי האתחול הרגילים של Apigee.

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

1. הפסקת התהליך של Cassandra בצומת:
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
2. מסירים את תוכנת Cassandra מהצומת:
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
3. מחיקה של ספריית הנתונים מהצומת:
   rm -rf /opt/apigee/data/apigee-cassandra

לאחר השלמת השלבים שלמעלה, אמור להיות לכם צומת עם אותה כתובת IP כמו הצומת נכשל, והוא מוכן להתקנת תוכנת Apigee. כך עושים את זה:

1. זיהוי צומתי המקור של מרכז הנתונים.
   1. בכל צומת תפעולי של Cassandra באותו מרכז נתונים שבו נמצא הצומת שמשוחזר, מריצים את הפקודה הבאה:

      apigee-service apigee-cassandra configure -search conf_cassandra_seeds

   2. הפלט אמור להיראות כך:

      Found key conf_cassandra_seeds, with value, "127.0.0.1", in /opt/apigee/apigee-cassandra/token/default.properties
      Found key conf_cassandra_seeds, with value, 127.0.0.1, in /opt/apigee/apigee-cassandra/token/application/cassandra.properties
      Found key conf_cassandra_seeds, with value, "10.1.0.1,10.1.0.2", in /opt/apigee/token/application/cassandra.properties
      apigee-configutil: apigee-cassandra: # OK

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

   vi /opt/apigee/customer/application/cassandra.properties
   

3. Add the following line:
   

   conf_jvm_options_custom_settings=-Dcassandra.replace_address=<ip-address-of-dead-node>

4. אם הצומת הזה הוא אחד מצומתי המקור (כתובת ה-IP של הצומת מופיעה ברשימת צומתי המקור משלב 1), צריך להוסיף שורה נוספת בקובץ:
   

   conf_cassandra_seeds="<comma-separated-seed-list-except-this-node’s-ip>"

   1. לדוגמה, בדוגמה שלמעלה, לרשימת המקור יש 2 כתובות IP – 10.1.0.1 & 10.1.0.2. אם הצומת שרוצים לשחזר הוא 10.1.0.1, צריך להוסיף שורה כמו זו:
      

      conf_cassandra_seeds="10.1.0.2"

5. שומרים את הקובץ ומוודאים שהוא בבעלותך. קריא על ידי משתמש Apigee:
   

   chown apigee:apigee /opt/apigee/customer/application/cassandra.properties

6. התקנת התוכנה Cassandra:
   

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install

7. הפעלת ההגדרה של Cassandra:
   

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f <configFile>

8. המערכת תנסה באופן פנימי לאתחל את שירות Cassandra. התהליך עשוי להימשך זמן רב בהתאם לכמות הנתונים שצריך להזרים מצמתים אחרים, תפוקת הרשת שלך וכו'.
9. [אפשרות מתקדמת] אפשר להאיץ את הסטרימינג של הנתונים על ידי הרצת פקודות ה-Nodetool הבאות בצומת:
   

   nodetool setstreamthroughput <value>
   nodetool setcompactionthroughput <value>

10. אחרי שצומת Cassandra חוזר, משתמשים בפקודות רגילות כמו למטה כדי לוודא שהצומת הצטרף לטבעת:
    

    /opt/apigee/apigee-cassandra/bin/nodetool ring
    /opt/apigee/apigee-cassandra/bin/nodetool status

11. לאחר שמוודאים שהצומת פועל כמו שצריך, עורכים שוב את הקובץ /opt/apigee/customer/application/cassandra.properties ומסירים את השורות שהוספתם קודם לכן בתהליך הזה בשלבים 3 ו-4.
12. הפעלה מחדש של שירות Cassandra בצומת:
    

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

שחזור של אשכול מלא

1. לעצור את האשכול המלא.
2. שחזור של כל הצמתים של Cassandra מקובץ הגיבוי.
3. מפעילים את אשכול Cassandra.
4. מפעילים מחדש את כל הרכיבים.

מסד נתונים של PostgreSQL

PosgreSQL פועל בנפרד או כמאסטר

1. הפסקת שרת הניהול, שרת Qpid ושרת Postgres בכל הצמתים:

   /apigee/apigee-service/bin/apigee-service edge-management-server stop
   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop

2. מתקינים מחדש את מסד הנתונים של PostgreSQL:

   /apigee/apigee-service/bin/apigee-service apigee-postgresql install 

3. מפעילים את PostgreSQL:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start

4. משחזרים את מסד הנתונים של PostgreSQL מקובץ הגיבוי:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restore 2019.03.17,14.40.41

   חשוב לשים לב שכשמשחזרים את רכיב ה-PostgreSQL, לא מציינים את נתיב הספרייה אל את קובץ הגיבוי, וגם לא מציינים 'dump.' הסיומת ציינו רק תאריך/שעה של שם קובץ הגיבוי.

   ניתן גם להשמיט את קובץ הגיבוי בפקודה restore ו-Edge להשתמש בקובץ הגיבוי העדכני ביותר מספריית הגיבוי של הרכיב.

5. הפעלת שרת הניהול, שרת Qpid ושרת Postgres בכל הצמתים:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server start
   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start

PosgreSQL פועל כמצב המתנה

1. מתקינים מחדש את מסד הנתונים של PostgreSQL:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql install

2. מגדירים מחדש את מסד הנתונים של PostgreSQL באמצעות אותו קובץ תצורה שבו השתמשתם כדי להתקין אותו:
   

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup -f configFile

3. מפעילים את PostgreSQL:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start 

שרת Postgres

1. הפסקת שרת Postgres בכל הצמתים הראשיים והמצב המתנה:

   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop

2. הסרת ספריות שרת ישנות של Postgres:

   /opt/apigee/data/edge-postgres-server /opt/apigee/etc/edge-postgres-server.d

3. מתקינים מחדש את שרת Postgres:

   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server install

4. שחזור שרת Postgres מקובץ הגיבוי:

   /opt/apigee/apigee-service/bin/apigee-service edge-postgre-server restore 2019.03.17,14.40.41

   חשוב לשים לב: כשמשחזרים רכיב, לא מציינים את נתיב הספרייה לגיבוי וגם לא מציינים את ה"גיבוי" או " .tar.gz" הסיומת ציינו רק תאריך/שעה של שם קובץ הגיבוי.

   ניתן גם להשמיט את קובץ הגיבוי בפקודה restore ו-Edge להשתמש בקובץ הגיבוי העדכני ביותר מספריית הגיבוי של הרכיב.

5. הפעלת שרת Postgres בכל הצמתים הראשיים והמצב המתנה:

   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start

שרת Qpid ו-Qpidd

1. הפסקת Qpidd , Qpid Server ושרת Postgres בכל הצמתים:
   

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd stop

2. הסרת ספריות Qpid ו-Qpidd ישנות:

   /opt/apigee/data/edge-qpid-server
   /opt/apigee/etc/edge-qpid-server.d
   /opt/apigee/data/apigee-qpidd
   /opt/apigee/etc/apigee-qpidd.d 

3. מתקינים מחדש את Qpidd:

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd install 

4. שחזור Qpidd:

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd restore 2019.03.17,14.40.41

   חשוב לשים לב: כשמשחזרים רכיב, לא מציינים את נתיב הספרייה לגיבוי וגם לא מציינים את ה"גיבוי" או " .tar.gz" הסיומת ציינו רק תאריך/שעה של שם קובץ הגיבוי.

   ניתן גם להשמיט את קובץ הגיבוי בפקודה restore ו-Edge להשתמש בקובץ הגיבוי העדכני ביותר מספריית הגיבוי של הרכיב.

5. מפעילים את Qpidd:

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd start 

6. התקנה מחדש של שרת Qpid:

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server install

7. שחזור שרת Qpid:

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restore 2019.03.17,14.40.41

   חשוב לשים לב: כשמשחזרים רכיב, לא מציינים את נתיב הספרייה לגיבוי וגם לא מציינים את ה"גיבוי" או " .tar.gz" הסיומת ציינו רק תאריך/שעה של שם קובץ הגיבוי.

   ניתן גם להשמיט את קובץ הגיבוי בפקודה restore ו-Edge להשתמש בקובץ הגיבוי העדכני ביותר מספריית הגיבוי של הרכיב.

8. הפעלה מחדש של שרתי Qpid, Qpidd ו-Postgres בכל הצמתים:

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd restart
   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart

OpenLDAP

1. כדי להפסיק את OpenLDAP:

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap stop

2. מתקינים מחדש את OpenLDAP:

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap install

3. הסרת ספריות OpenLDAP ישנות:

   /opt/apigee/data/apigee-openldap /opt/apigee/etc/apigee-openldap.d

4. שחזור OpenLDAP:

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap restore 2019.03.17,14.40.41

   חשוב לשים לב: כשמשחזרים רכיב, לא מציינים את נתיב הספרייה לגיבוי וגם לא מציינים את ה"גיבוי" או " .tar.gz" הסיומת ציינו רק תאריך/שעה של שם קובץ הגיבוי.

   ניתן גם להשמיט את קובץ הגיבוי בפקודה restore ו-Edge להשתמש בקובץ הגיבוי העדכני ביותר מספריית הגיבוי של הרכיב.

5. מפעילים מחדש את OpenLDAP:

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap start

6. הפעלה מחדש של כל שרתי הניהול:

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

שרת ניהול

1. הפסקת שרת הניהול:

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

2. הסרת ספריות ישנות של שרת הניהול:

   /opt/apigee/data/edge-management-server /opt/apigee/etc/edge-management-server.d

3. התקנה מחדש של שרת הניהול:

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

4. שחזור שרת הניהול מקובץ הגיבוי:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server restore 2019.03.17,14.40.41

   חשוב לשים לב: כשמשחזרים רכיב, לא מציינים את נתיב הספרייה לגיבוי וגם לא מציינים את ה"גיבוי" או " .tar.gz" הסיומת ציינו רק תאריך/שעה של שם קובץ הגיבוי.

   ניתן גם להשמיט את קובץ הגיבוי בפקודה restore ו-Edge להשתמש בקובץ הגיבוי העדכני ביותר מספריית הגיבוי של הרכיב.

5. הפעלה מחדש של שרת הניהול:

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

מעבד בקשות

1. הפסקת מעבד ההודעות:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop

2. הסרת ספריות ישנות של מעבד הודעות:

   /opt/apigee/data/edge-message-processor
   /opt/apigee/etc/edge-message-processor.d

3. התקנה מחדש של מעבד ההודעות:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor install

4. שחזור מעבד ההודעות מקובץ הגיבוי:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restore 2019.03.17,14.40.41

   חשוב לשים לב: כשמשחזרים רכיב, לא מציינים את נתיב הספרייה לגיבוי וגם לא מציינים את ה"גיבוי" או " .tar.gz" הסיומת ציינו רק תאריך/שעה של שם קובץ הגיבוי.

   ניתן גם להשמיט את קובץ הגיבוי בפקודה restore ו-Edge להשתמש בקובץ הגיבוי העדכני ביותר מספריית הגיבוי של הרכיב.

5. הפעלה מחדש של מעבד ההודעות:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor start

נתב

1. הפסקת הנתב:

   /opt/apigee/apigee-service/bin/apigee-service edge-router stop

2. הסרת ספריות נתב ישנות:

   /opt/apigee/data/edge-router
   /opt/apigee/etc/edge-router.d

3. התקנה מחדש של הנתב:
   

   /opt/apigee/apigee-service/bin/apigee-service edge-router install

4. שחזרו את הנתב מקובץ הגיבוי:

   /opt/apigee/apigee-service/bin/apigee-service edge-router restore 2019.03.17,14.40.41

   חשוב לשים לב: כשמשחזרים רכיב, לא מציינים את נתיב הספרייה לגיבוי וגם לא מציינים את ה"גיבוי" או " .tar.gz" הסיומת ציינו רק תאריך/שעה של שם קובץ הגיבוי.

   ניתן גם להשמיט את קובץ הגיבוי בפקודה restore ו-Edge להשתמש בקובץ הגיבוי העדכני ביותר מספריית הגיבוי של הרכיב.

5. הפעלה מחדש של הנתב:
   

   /opt/apigee/apigee-service/bin/apigee-service edge-router start

ממשק המשתמש של Edge

1. ממשק עצירה של ממשק המשתמש:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui stop

2. הסרה של ספריות ישנות של ממשק משתמש:

   /opt/apigee/data/edge-ui
   /opt/apigee/etc/edge-ui.d

3. התקנה מחדש של ממשק המשתמש:
   

   /opt/apigee/apigee-service/bin/apigee-service edge-ui install

4. שחזור ממשק המשתמש מקובץ הגיבוי:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui restore 2019.03.17,14.40.41

   חשוב לשים לב: כשמשחזרים רכיב, לא מציינים את נתיב הספרייה לגיבוי וגם לא מציינים את ה"גיבוי" או " .tar.gz" הסיומת ציינו רק תאריך/שעה של שם קובץ הגיבוי.

   ניתן גם להשמיט את קובץ הגיבוי בפקודה restore ו-Edge להשתמש בקובץ הגיבוי העדכני ביותר מספריית הגיבוי של הרכיב.

5. הפעלה מחדש של ממשק המשתמש:
   

   /opt/apigee/apigee-service/bin/apigee-service edge-ui start

השלמת שחזור האתר

1. עצירת כל הצמתים של הרכיבים. שימו לב שהסדר של הפסקת מערכות המשנה חשוב: לעצור את כל הצמתים של Edge ואז לעצור את כל הצמתים של מאגרי הנתונים.
2. עליכם לשחזר את כל הרכיבים כמו שמתואר למעלה.
3. עכשיו מתחילים את כל הרכיבים בסדר הבא. שימו לב שהסדר של התחלת השימוש חשוב תת-מערכות:
   1. הפעלת האשכול ZoomKeeper
   2. הפעלת האשכול Cassandra
   3. צריך לוודא ש-OpenLDAP פועל
   4. התחלת Qpid
   5. מוודאים שמסד הנתונים של PostgreSQL פועל
   6. הפעלת שרת הניהול
   7. הפעלת נתבים ומעבדי הודעות
   8. הפעלת שרת Qpid
   9. הפעלת שרת Postgres
   10. הפעלת ממשק המשתמש של Apigee