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

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

‫Apache ZooKeeper

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

1. עוצרים את ZooKeeper:

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

2. מסירים ספריות ישנות של ZooKeeper:

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

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

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

4. שחזור ZooKeeper:

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

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

   אפשר גם להשמיט את קובץ הגיבוי בפקודה restore, ואז Edge ישתמש בקובץ הגיבוי האחרון בספריית הגיבוי של הרכיב.

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

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

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

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

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

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

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

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

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

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

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

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

‫Apache Cassandra

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

1. מפסיקים את Cassandra:

   /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. שחזור Cassandra:

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

   שימו לב: כשמשחזרים רכיב, לא מציינים את נתיב הספרייה לקובץ הגיבוי, ולא מציינים את הקידומת backup- או את הסיומת ‎.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. מזהים את צמתי ה-seed של מרכז הנתונים.
   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 שמופיעות ברשימה, מופרדות בפסיקים, הן צמתי ה-seed שבהם משתמשים הצמתים במרכז הנתונים הזה.
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

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

   אפשר גם להשמיט את קובץ הגיבוי בפקודה restore, ואז Edge ישתמש בקובץ הגיבוי האחרון בספריית הגיבוי של הרכיב.

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

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

Qpid Server ו-Qpidd

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

   /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 Server ו-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

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

   אפשר גם להשמיט את קובץ הגיבוי בפקודה restore, ואז Edge ישתמש בקובץ הגיבוי האחרון בספריית הגיבוי של הרכיב.

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

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

6. מתקינים מחדש את Qpid Server:

   /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

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

   אפשר גם להשמיט את קובץ הגיבוי בפקודה restore, ואז Edge ישתמש בקובץ הגיבוי האחרון בספריית הגיבוי של הרכיב.

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

   /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

SymasLDAP

1. עוצרים את SymasLDAP:

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

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

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

3. מסירים ספריות ישנות של SymasLDAP:

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

4. שחזור SymasLDAP:

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

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

   אפשר גם להשמיט את קובץ הגיבוי בפקודה restore, ואז Edge ישתמש בקובץ הגיבוי האחרון בספריית הגיבוי של הרכיב.

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

   /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

   שימו לב: כשמשחזרים רכיב, לא מציינים את נתיב הספרייה לקובץ הגיבוי, ולא מציינים את הקידומת backup- או את הסיומת ‎.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. משחזרים את Message Processor מקובץ הגיבוי:

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

   שימו לב: כשמשחזרים רכיב, לא מציינים את נתיב הספרייה לקובץ הגיבוי, ולא מציינים את הקידומת backup- או את הסיומת ‎.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

   שימו לב: כשמשחזרים רכיב, לא מציינים את נתיב הספרייה לקובץ הגיבוי, ולא מציינים את הקידומת backup- או את הסיומת ‎.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

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

   אפשר גם להשמיט את קובץ הגיבוי בפקודה restore, ואז Edge ישתמש בקובץ הגיבוי האחרון בספריית הגיבוי של הרכיב.

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

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

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

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