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

המסמך הזה עוסק בהתקנה מחדש ובשחזור של רכיב 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. אם הצומת הזה הוא אחד מצומתי ה-seed (כתובת ה-IP של הצומת מופיעה ברשימת צומתי ה-seed משלב 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 ו-Qpidd

1. עוצרים את Qpidd, שרת Qpid ושרת 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 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,‏ 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

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. משחזרים את מעבד הבקשות מקובץ הגיבוי:

   /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. מסירים את הספריות הישנות של Router:

   /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. הפסקת ממשק המשתמש החדש של Edge:

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

2. מסירים את הספריות הישנות של ממשק המשתמש של New Edge:

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

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

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

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

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

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

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

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

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

שחזור אתר מלא

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