עדכון של Apigee Edge 4.16.01/4.16.05 ל-4.18.01

Edge for Private Cloud v4.18.01

אילו גרסאות של Edge אפשר לעדכן לגרסה 4.18.01

אתם יכולים לעדכן את Apigee Edge מגרסה 4.16.01.0x ו-4.16.05.x לגרסה 4.18.01 באמצעות התהליך הזה.

אם יש לכם גרסה של Edge שקודמת לגרסה 4.16.01, קודם אתם צריכים לעבור לגרסה 4.16.01 ואז לעדכן לגרסה 4.18.01.

• אתם יכולים להעביר את Apigee Edge מגרסה 4.15.07 לגרסה 4.16.01.
• אם יש לכם גרסה של Edge שקודמת לגרסה 4.15.07, אתם צריכים קודם לעבור לגרסה 4.15.07 ואז לגרסה 4.16.01.
  • אם אתם עוברים מגרסה 4.14.04 של Edge או מגרסה חדשה יותר: עברו ישירות לגרסה 4.15.07.
  • אם אתם עוברים מגרסה 4.14.01 של Edge: קודם צריך לעבור לגרסה 4.14.04, ואז לגרסה 4.15.07.

מי יכול לבצע את העדכון

המשתמש שמפעיל את העדכון צריך להיות אותו משתמש שהתקין את Edge במקור, או משתמש שפועל כ-root.

אחרי שמתקינים את ה-RPM של Edge, כל משתמש יכול להגדיר אותם.

אילו רכיבים צריך לעדכן

צריך לעדכן את כל הרכיבים של Edge. ב-Edge אין תמיכה בהגדרה שמכילה רכיבים מכמה גרסאות.

שדרוג לאחור של Zookeeper אם מעדכנים מגרסה 4.16.01

גרסת ה-RPM של Zookeeper ב-Edge for Private Cloud 4.16.01 היא apigee-zookeeper-3.4.5-1.0.905.noarch.rpm. בגרסאות הבאות של Edge, גרסת Zookeeper שונתה בחזרה ל-apigee-zookeeper-3.4.5-0.0.94x. כך מונעים מ-yum לשדרג את Zookeeper לגרסאות מאוחרות יותר מ-4.16.01. כדי לתקן את המצב הזה, צריך להריץ את הפקודה yum downgrade apigee-zookeeper לפני שמעדכנים את Zookeeper.

כדי לבדוק את הגרסה של Zookeeper, משתמשים בפקודה הבאה:

> rpm -qa |grep apigee-zookeeper

אם הפקודה הזו מחזירה את גרסת Zookeeper:

apigee-zookeeper-3.4.5-1.0.905

ואז צריך לשדרג לאחור.

הפצה אוטומטית של הגדרות הנכס

אם הגדרתם מאפיינים כלשהם על ידי עריכת קובצי ‎.properties ב-‎/opt/apigee/customer/application, הערכים האלה נשמרים בעדכון.

דרישות מוקדמות לעדכון

לפני שמשדרגים את Apigee Edge, צריך לבצע את הפעולות הבאות:

• גיבוי כל הצמתים
  לפני העדכון, מומלץ לבצע גיבוי מלא של כל הצמתים מטעמי בטיחות. כדי לבצע את הגיבוי, משתמשים בהליך שמתאים לגרסה הנוכחית של Edge.
  
  כך תהיה לכם תוכנית גיבוי למקרה שהעדכון לגרסה החדשה לא יפעל כמו שצריך. מידע נוסף על גיבוי זמין במאמר גיבוי ושחזור.
• מוודאים ש-Edge פועל
  מוודאים ש-Edge פועל במהלך תהליך העדכון באמצעות הפקודה:
  
  > /opt/apigee/apigee-service/bin/apigee-all status

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

אם העדכון נכשל, אתם יכולים לנסות לתקן את הבעיה ואז להריץ שוב את update.sh. אפשר להריץ את העדכון כמה פעמים, והוא ימשיך מהנקודה שבה הוא הפסיק.

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

רישום פרטי העדכון

כברירת מחדל, כלי השירות update.sh כותב את פרטי היומן בנתיב:

/opt/apigee/var/log/apigee-setup/update.log

אם למשתמש שמפעיל את הכלי update.sh אין גישה לספרייה הזו, הכלי כותב את היומן בספרייה ‎/tmp כקובץ בשם update_username.log.

אם למשתמש אין גישה אל ‎/tmp, הכלי update.sh נכשל.

שדרוג חובה ל-Java JDK גרסה 8

כדי להשתמש בגרסה הזו של Edge, צריך להתקין את Java JDK גרסה 8 בכל צומתי העיבוד של Edge. אפשר להתקין את Oracle JDK 8 או את OpenJDK 8. אם Java JDK 8 עדיין לא מותקן, סקריפט העדכון יכול להתקין אותו בשבילכם.

במסגרת העדכון ל-Java 8, חלק מהצפנות ה-TLS כבר לא זמינות ב-Oracle JDK 8. הרשימה המלאה מופיעה בקטע Default Disabled Cipher Suites בכתובת http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.

נדרש כדי להפעיל את מאגר EPEL

כדי להתקין או לעדכן את Edge, צריך להפעיל את Extra Packages for Enterprise Linux (או EPEL). הפקודה שבה משתמשים תלויה בגרסה של RedHat/CentOS:

• ב-RedHat/CentOS 7.x:
  > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm
• ‫ב-RedHat/CentOS 6.x:
  wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

חובה להוסיף את פרמטר ההגדרה SMTPMAILFROM

בגרסה 4.17.05 של Edge נוסף פרמטר חובה חדש לקובץ התצורה שמשמש להפעלת שרת SMTP. אם אתם מעדכנים מגרסה 4.17.01, אתם צריכים להגדיר את SMTPMAILFROM בקובץ התצורה כשאתם מפעילים את שרת ה-SMTP.

בגרסה 4.17.09 של API BaaS נוספה גם תמיכה במאפיין SMTPMAILFROM. כשמעדכנים את API BaaS, צריך להגדיר את SMTPMAILFROM בקובץ התצורה.

הפרמטר הזה הוא בפורמט הבא:

SMTPMAILFROM="My Company <myco@company.com>"

חובה אם מעדכנים כשמשתמשים באימות חיצוני

אתם יכולים לשלב שירות ספריות חיצוני בהתקנה קיימת של Apigee Edge ענן פרטי. התכונה הזו נועדה לפעול עם כל שירות ספריות שתומך ב-LDAP, כמו Active Directory,‏ OpenLDAP ואחרים. פתרון LDAP חיצוני מאפשר למנהלי מערכת לנהל את פרטי הכניסה של המשתמשים משירות ניהול ספריות מרכזי, שהוא חיצוני למערכות כמו Apigee Edge שמשתמשות בהם.

למידע נוסף, ראו הגדרת אימות חיצוני.

כשמופעל אימות חיצוני, רוב הלקוחות משתמשים בשדה שם החשבון של Active Directory SAM כשם המשתמש לאימות, במקום בכתובת אימייל שמשמשת את שרת Edge OpenLDAP.

אם שילבתם שירות ספריות חיצוני, צריך להוסיף את השורה הבאה לקובץ התצורה כשמעדכנים את Edge לגרסה 4.18.01:

IS_EXTERNAL_AUTH="true"

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

שדרוג חובה ל-Qpid 1.35

הגרסה הזו כוללת עדכון נדרש ל-Qpid 1.35. כחלק מהעדכון של צומת Qpid, צריך:

• מונעים באופן זמני מהנתבים וממעבדי הבקשות לכתוב לצומת Qpid על ידי חסימת יציאה 5672 בצומת Qpid. כדי לחסום את היציאה הזו בצומת Qpid, אפשר להשתמש בפקודה הבאה:
  > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
• מחכים שהתור של Qpid יתרוקן מהודעות כדי לוודא שצומת Qpid עיבד את כל ההודעות לפני העדכון. כדי לוודא שתור ההודעות של Qpid ריק, משתמשים בפקודה הבאה:
  > qpid-stat -q
• מעדכנים את צומת Qpid.
• מבטלים את החסימה של יציאה 5672 בצומת Qpid כדי לאפשר גישה מנתבים וממעבדי בקשות. כדי לבטל את החסימה של היציאה, אפשר להשתמש בפקודה הבאה:
  > sudo iptables -F
  
  שימו לב שאם אתם משתמשים ב-iptables לכללים אחרים, אתם יכולים להשתמש באפשרות ‎-D כדי לבטל את השינוי הספציפי:
  > sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP

התהליך הזה מתואר בפירוט בהמשך לכל טופולוגיית Edge.

שדרוג נדרש ל-Postgres 9.6

הגרסה הזו של Edge כוללת שדרוג ל-Postgres 9.6. כחלק מהשדרוג, כל הנתונים של Postgres מועברים ל-Postgres 9.6.

במהלך תהליך העדכון, בזמן שצומתי Postgres מושבתים לצורך עדכון, נתוני הניתוח עדיין נכתבים לצומתי Qpid. אחרי שצומתי Postgres מתעדכנים וחוזרים לפעול, נתוני הניתוח נשלחים לצומתי Postgres.

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

התקנת צומת המתנה חדש של Postgres

התהליך הזה יוצר שרת המתנה של Postgres בצומת חדש. חשוב להתקין שרת Postgres חדש במצב המתנה לגרסה הקיימת של Edge‏ (4.16.01 או 4.16.05), ולא לגרסה 4.18.01.

כדי לבצע את ההתקנה, משתמשים באותו קובץ תצורה ששימש להתקנת הגרסה הנוכחית של Edge.

כדי ליצור צומת המתנה חדש של Postgres:

1. ב-Postgres הראשי הנוכחי, עורכים את הקובץ /opt/apigee/customer/application/postgresql.properties כדי להגדיר את הטוקן הבא. אם הקובץ לא קיים, יוצרים אותו:
   
   conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust\ \nhost replication apigee new_slave_ip/32 trust
   
   כאשר existing_slave_ip היא כתובת ה-IP של שרת הגיבוי הנוכחי של Postgres, ו-new_slave_ip היא כתובת ה-IP של צומת הגיבוי החדש.
2. הפעל מחדש את apigee-postgresql במאסטר של Postgres:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
3. כדי לוודא שצומת ההמתנה החדש נוסף, בודקים את הקובץ /opt/apigee/apigee-postgresql/conf/pg_hba.conf במאסטר. השורות הבאות אמורות להופיע בקובץ:
   host replication apigee existing_slave_ip/32 trust
   host replication apigee new_slave_ip/32 trust
4. מתקינים את שרת הגיבוי החדש של Postgres:
   1. עורכים את קובץ התצורה שבו השתמשתם כדי להתקין את הגרסה הנוכחית של Edge, ומציינים את הפרטים הבאים:
      
      # כתובת IP של ה-master הנוכחי:
      PG_MASTER=192.168.56.103
      # כתובת IP של ה-standby node החדש
      PG_STANDBY=192.168.56.102
   2. משביתים את SELinux כמו שמתואר במאמר התקנת כלי השירות apigee-setup של Edge.
   3. מורידים את הקובץ bootstrap_4.16.05.sh של Edge אל ‎/tmp/bootstrap_4.16.05.sh:
      > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
      
      הערה: אם אתם מעדכנים מגרסה 4.16.01, הורידו את הקובץ bootstrap.sh של Edge.
   4. מתקינים את כלי השירות apigee-service של Edge ואת יחסי התלות:
      > sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
   5. ‫משתמשים ב-apigee-service כדי להתקין את הכלי apigee-setup:
      ‎> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
   6. מתקינים את Postgres:
      > ‎/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
   7. בצומת ההמתנה החדש, מריצים את הפקודה הבאה:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
      
      מוודאים שכתוב שהוא במצב המתנה.

הוצאה משימוש של צומת Postgres

אחרי שהעדכון מסתיים, מוציאים משימוש את צומת ההמתנה החדש:

1. מוודאים ש-Postgres פועל:
   > /opt/apigee/apigee-service/bin/apigee-all status
   
   אם Postgres לא פועל, מפעילים אותו:
   > /opt/apigee/apigee-service/bin/apigee-all start
2. מריצים את פקודת ה-cURL הבאה בצומת ההמתנה החדש כדי לקבל את ה-UUID שלו:
   > curl -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self
   
   ה-UUID של הצומת אמור להופיע בסוף הפלט, בפורמט הבא:
   "type" : [ "postgres-server" ],
   "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
3. עוצרים את צומת ההמתנה החדש על ידי הרצת הפקודה הבאה בצומת ההמתנה החדש:
   > /opt/apigee/apigee-service/bin/apigee-all stop
4. בצומת הראשי של Postgres, עורכים את ‎/opt/apigee/customer/application/postgresql.properties כדי להסיר את צומת הגיבוי החדש מ-conf_pg_hba_replication.connection:
   conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust
5. מפעילים מחדש את apigee-postgresql ב-Postgres הראשי:
   > ‎/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
6. כדי לוודא שצומת ההמתנה החדש הוסר, בודקים את הקובץ /opt/apigee/apigee-postgresql/conf/pg_hba.conf במאסטר. בקובץ הזה אמורה להופיע רק השורה הבאה:
   host replication apigee existing_slave_ip/32 trust
7. מוחקים את ה-UUID של צומת הגיבוי מ-ZooKeeper על ידי ביצוע הקריאה הבאה ל-Edge Management API בצומת של שרת הניהול:
   > curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

עדכון ללא זמן השבתה

עדכון ללא זמן השבתה, או עדכון בהדרגה (rolling), מאפשר לעדכן את ההתקנה של Edge בלי להשבית את Edge.

אפשר לבצע עדכון ללא זמן השבתה רק בהגדרה של 5 צמתים ומעלה.

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

1. מעדכנים את המכונות בסדר הנכון להתקנה, כמו שמתואר בהמשך בקטע "סדר עדכון המכונות".
2. כשיגיע הזמן לעדכן את הנתבים, בוחרים נתב אחד ומשנים את הסטטוס שלו ל"לא נגיש", כמו שמתואר במאמר הפעלה או השבתה של הנגישות לשרת (מעבד בקשות או נתב).
3. מעדכנים את הנתב שנבחר ואת כל רכיבי Edge האחרים באותו מחשב כמו הנתב. בכל ההגדרות של Edge מוצגים נתב ומעבד בקשות באותו צומת.
4. צריך לוודא שהנתב זמין שוב.
5. חוזרים על שלבים 2 עד 4 בשאר הנתבים.
6. ממשיכים לעדכן את שאר המחשבים בהתקנה.

מה צריך לעשות לפני או אחרי העדכון:

• בצומת משולב של נתב ומעבד בקשות:
  • לפני העדכון – מבצעים את הפעולות הבאות:
    1. הופכים את הנתב ללא נגיש.
    2. הופכים את מעבד הבקשות ללא נגיש.
  • אחרי העדכון – מבצעים את הפעולות הבאות:
    1. מוודאים שמעבד הבקשות נגיש.
    2. מוודאים שהנתב נגיש.
• בצומת Router יחיד:
  • לפני העדכון, צריך להגדיר את הנתב כלא נגיש.
  • אחרי העדכון, צריך לוודא שהנתב נגיש.
• בצומת יחיד של מעבד בקשות:
  • לפני העדכון, צריך להגדיר שאי אפשר יהיה להגיע למעבד הבקשות.
  • אחרי העדכון, צריך לוודא שאפשר להגיע למעבד הבקשות.

שימוש בקובץ תצורה שקט

צריך להעביר קובץ תצורה שקט לפקודת העדכון. קובץ התצורה השקט צריך להיות זהה לזה שבו השתמשתם כדי להתקין את Edge 4.16.01 או 4.16.05.

תהליך העדכון לגרסה 4.18.01 בצומת עם חיבור חיצוני לאינטרנט

כדי לעדכן את רכיבי Edge בצומת:

1. אם אתם משתמשים כרגע ברפליקציה של Postgres master-standby, התקינו צומת המתנה חדש של Postgres כמו שמתואר למעלה בקטע התקנת צומת המתנה חדש של Postgres.
2. אם יש משימות CRON שמוגדרות לבצע פעולת תיקון ב-Cassandra, צריך להשבית אותן עד לסיום העדכון.
3. כדי להתקין את חבילות ה-RPM של Edge, מתחברים לצומת כמשתמש root.
   הערה: כדי להתקין את RPM נדרשת גישת root, אבל אפשר להגדיר את Edge בלי גישת root.
4. מתקינים את yum-utils ואת yum-plugin-priorities:
   ‎> sudo yum install yum-utils
   ‎> sudo yum install yum-plugin-priorities
5. משביתים את SELinux כמו שמתואר במאמר Install the Edge apigee-setup utility.
6. מפעילים את מאגר EPEL כמו שמתואר למעלה.
7. אם מתקינים ב-Oracle 7.x, מריצים את הפקודה הבאה:
   > sudo yum-config-manager --enable ol7_optional_latest
8. אם אתם מתקינים ב-AWS, הריצו את הפקודות הבאות של yum-configure-manager:
   > yum update rh-amazon-rhui-client.noarch
   > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
9. מורידים את הקובץ bootstrap_4.18.01.sh של Edge 4.18.01 אל /tmp/bootstrap_4.18.01.sh:
   > curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
10. מתקינים את כלי השירות apigee-service של Edge 4.18.01 ואת יחסי התלות:
    > sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord
    
    כאשר uName:pWord הם שם המשתמש והסיסמה שקיבלתם מ-Apigee. אם לא תציינו את pWord, תתבקשו להזין אותו.
    
    כברירת מחדל, מנהל ההתקנה בודק אם מותקנת גרסה 1.8 של Java. אם לא, היא תתקין אותה. משתמשים באפשרות JAVA_FIX כדי לציין איך לטפל בהתקנה של Java. JAVA_FIX מקבל את הערכים הבאים:
    
    I = התקנת OpenJDK 1.8 (ברירת מחדל)
    C = המשך בלי להתקין את Java
    Q = יציאה. כדי להשתמש באפשרות הזו, צריך להתקין את Java בעצמכם.
11. משתמשים ב-apigee-service כדי לעדכן את כלי השירות apigee-setup:
    1. אם התקנתם את גרסה 4.16.01 על ידי שדרוג של Edge מגרסה 4.15.07.0x, אתם צריכים להתקין את כלי השירות apigee-setup:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
       
       הפקודה הזו מתקינה את כלי השירות update.sh ב-/opt/apigee/apigee-setup/bin.
       
       אם כבר התקנתם את הכלי apigee-setup, צריך לעדכן אותו:
       > ‎/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    2. אם התקנתם את גרסה 4.16.01 ישירות, כלומר לא שדרגתם מגרסה 4.15.07.0x, אתם צריכים לעדכן את כלי השירות apigee-setup:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
       
       העדכון הזה ל-apigee-service מתקין את כלי השירות update.sh ב-/opt/apigee/apigee-setup/bin.
    3. אם התקנתם את גרסה 4.16.05 ישירות או באמצעות עדכון, אתם צריכים לעדכן את כלי השירות apigee-setup:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
       
       העדכון הזה של apigee-service מתקין את כלי השירות update.sh ב-/opt/apigee/apigee-setup/bin.
12. בהתאם לגרסה הנוכחית של Edge, צריך להתקין או לעדכן את כלי השירות apigee-validate בשרת הניהול.
    1. אם אתם משתמשים כרגע ב-Edge 4.16.05: מעדכנים את כלי השירות apigee-validate בשרת הניהול:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    2. אם אתם משתמשים כרגע ב-Edge 4.16.01: מתקינים את כלי השירות apigee-validate בשרת הניהול:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
       
       הערה: אם התקנתם את כלי השירות apigee-validate בצומת של מעבד בקשות כשהתקנתם את 4.16.01, אתם יכולים לעדכן אותו באמצעות הפקודה הבאה בצומת הזה:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
       
       עם זאת, החל מגרסה 4.16.05 ואילך, Apigee ממליצה להתקין ולהפעיל את כלי השירות apigee-validate בשרת הניהול.
    3. אם משדרגים מגרסה 4.16.01: עורכים את קובץ התצורה שמועבר לכלי apigee-validate. בגרסה 4.16.01 של Edge, קובץ התצורה ששימש את apigee-validate דרש את המאפיינים הבאים:
       APIGEE_ADMINPW=sysAdminPword
       MP_POD=gateway
       REGION=dc-1
       
       בגרסה הזו, קובץ התצורה דורש רק את המאפיין APIGEE_ADMINPW. אפשר להסיר את שני המאפיינים האחרים מהקובץ.
13. עדכון כלי השירות apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
14. מריצים את כלי העדכון בצמתים לפי הסדר שמתואר בקטע "סדר עדכון המכונות" בהמשך:
    > ‎/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
    
    הדרישה היחידה לגבי קובץ התצורה היא שהוא יהיה נגיש או קריא למשתמש apigee.
    
    משתמשים באפשרות "‎-c" כדי לציין את הרכיב שרוצים לעדכן. רשימת הרכיבים האפשריים כוללת:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =כל רכיבי Edge, חוץ מ-Edge UI: Management Server, ‏ Message Processor, ‏ Router, ‏ QPID Server, ‏ Postgres Server
    ui = Edge UI
    all = עדכון כל הרכיבים במכונה (משתמשים רק בפרופיל התקנה של Edge aio או בפרופיל התקנה של API BaaS asa)
    e = ElasticSearch
    b = API BaaS Stack
    p = API BaaS Portal
    ebp = ElasticSearch, ‏ API BaaS Stack ו-API BaaS Portal באותו צומת
15. בודקים את העדכון על ידי הפעלת כלי השירות apigee-validate בשרת הניהול, כפי שמתואר בקטע בדיקת ההתקנה.
16. אם התקנתם צומת המתנה חדש של Postgres, הוציאו אותו משימוש כמו שמתואר למעלה בקטע הוצאה משימוש של צומת Postgres.

כדי לחזור לגרסה הקודמת, צריך לפעול לפי ההוראות שמפורטות בקטע 4.18.01 Rollback Process.

תהליך העדכון לגרסה 4.18.01 ממאגר מקומי

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

אחרי שיוצרים מאגר מקומי של Edge, יש שתי אפשרויות לעדכון Edge מהמאגר המקומי:

• יוצרים קובץ ‎ .tar של המאגר, מעתיקים את קובץ ה-‎ .tar לצומת ואז מעדכנים את Edge מקובץ ה-‎.tar.
• מתקינים שרת אינטרנט בצומת עם המאגר המקומי כדי שצמתים אחרים יוכלו לגשת אליו. ב-Apigee אתם יכולים להשתמש בשרת האינטרנט Nginx או בשרת אינטרנט משלכם.

כדי לעדכן ממאגר מקומי בגרסה 4.18.01:

1. אם אתם משתמשים כרגע ברפליקציה של Postgres master-standby, התקינו צומת המתנה חדש של Postgres כמו שמתואר למעלה בקטע התקנת צומת המתנה חדש של Postgres.
2. יוצרים מאגר מקומי בגרסה 4.18.01, כמו שמתואר בקטע "יצירת מאגר Apigee מקומי" במאמר התקנת כלי השירות apigee-setup של Edge.
   הערה: אם כבר יש לכם מאגר קיים בגרסה 4.16.01 או 4.16.05, אתם יכולים להוסיף לו את המאגר בגרסה 4.18.01, כמו שמתואר בקטע "עדכון מאגר מקומי של Apigee" במאמר התקנת כלי השירות apigee-setup של Edge.
3. כדי להתקין את apigee-service מקובץ ‎ .tar:
   1. בצומת עם המאגר המקומי, משתמשים בפקודה הבאה כדי לארוז את המאגר המקומי לקובץ ‎ .tar יחיד בשם /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
   2. מעתיקים את קובץ ה-‎ .tar לצומת שבו רוצים לעדכן את Edge. לדוגמה, מעתיקים אותו לספרייה ‎/tmp בצומת החדש.
   3. בצומת החדש, מחלצים את הקובץ לספרייה ‎ /tmp:
      > tar -xzf apigee-4.18.01.tar.gz
      
      הפקודה הזו יוצרת ספרייה חדשה בשם repos בספרייה שמכילה את קובץ ה-‎ .tar. לדוגמה, ‎ /tmp/repos.
   4. מתקינים את כלי השירות apigee-service של Edge ואת יחסי התלות מ-‎ /tmp/repos:
      > sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
      
      שימו לב שאתם כוללים את הנתיב לספריית המאגרים בפקודה הזו.
4. כדי להתקין את apigee-service באמצעות שרת האינטרנט Nginx:
   1. מגדירים את שרת האינטרנט Nginx כמו שמתואר בקטע "התקנה מהמאגר באמצעות שרת האינטרנט Nginx" במאמר התקנת כלי השירות apigee-setup של Edge.
   2. בצומת המרוחק, מורידים את קובץ Edge bootstrap_4.18.01.sh אל ‎/tmp/bootstrap_4.18.01.sh:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
      
      כאשר uName:pWord הם שם המשתמש והסיסמה שהגדרתם למעלה למאגר, ו-remoteRepo הוא כתובת ה-IP או שם ה-DNS של צומת המאגר.
   3. בצומת המרוחק, מתקינים את כלי השירות apigee-service של Edge ואת יחסי התלות:
      > sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
      
      כאשר uName:pWord הם שם המשתמש והסיסמה של המאגר.
5. משתמשים ב-apigee-service כדי לעדכן את כלי השירות apigee-setup:
   1. אם התקנתם את גרסה 4.16.01 על ידי שדרוג של Edge מגרסה 4.15.07.0x, אתם צריכים להתקין את כלי השירות apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
      
      הפקודה הזו מתקינה את כלי השירות update.sh ב-/opt/apigee/apigee-setup/bin.
      
      אם כבר התקנתם את הכלי apigee-setup, צריך לעדכן אותו:
      > ‎/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
   2. אם התקנתם את גרסה 4.16.01 ישירות, כלומר לא ביצעתם שדרוג מגרסה 4.15.07.0x, אתם צריכים לעדכן את כלי השירות apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
      
      העדכון הזה ל-apigee-service מתקין את כלי השירות update.sh ב-/opt/apigee/apigee-setup/bin.
   3. אם התקנתם את גרסה 4.16.05 ישירות או באמצעות עדכון, אתם צריכים לעדכן את כלי השירות apigee-setup:
      > ‎/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
      
      העדכון הזה של apigee-service מתקין את כלי השירות update.sh ב-‎/opt/apigee/apigee-setup/bin.
6. בהתאם לגרסה הנוכחית של Edge, צריך להתקין או לעדכן את כלי השירות apigee-validate בשרת הניהול.
   1. אם אתם משתמשים כרגע ב-Edge 4.16.05: מעדכנים את כלי השירות apigee-validate בשרת הניהול:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
   2. אם אתם משתמשים כרגע ב-Edge 4.16.01: התקינו את כלי השירות apigee-validate בשרת הניהול:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
      
      הערה: אם התקנתם את כלי השירות apigee-validate בצומת של מעבד בקשות כשהתקנתם את 4.16.01, תוכלו לעדכן אותו באמצעות הפקודה הבאה בצומת הזה:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
      
      עם זאת, החל מגרסה 4.16.05 ואילך, Apigee ממליצה להתקין ולהפעיל את כלי השירות apigee-validate בשרת הניהול.
   3. אם משדרגים מגרסה 4.16.01: עורכים את קובץ התצורה שמועבר לכלי apigee-validate. בגרסה 4.16.01 של Edge, קובץ התצורה ששימש את apigee-validate דרש את המאפיינים הבאים:
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=gateway
      REGION=dc-1
      
      בגרסה הזו, קובץ התצורה דורש רק את המאפיין APIGEE_ADMINPW. אפשר להסיר את שני המאפיינים האחרים מהקובץ.
7. עדכון כלי השירות apigee-provision:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
8. מריצים את כלי העדכון בצמתים לפי הסדר שמתואר בקטע "סדר עדכון המכונות" בהמשך:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
   
   הדרישה היחידה לגבי קובץ התצורה היא שהוא יהיה נגיש או קריא למשתמש apigee.
   
   משתמשים באפשרות "‎-c" כדי לציין את הרכיב שרוצים לעדכן. רשימת הרכיבים האפשריים כוללת:
   ldap = OpenLDAP
   cs = Cassandra
   zk = Zookeeper
   qpid = qpidd
   ps = postgresql
   edge =כל רכיבי Edge, חוץ מ-Edge UI: Management Server, ‏ Message Processor, ‏ Router, ‏ QPID Server, ‏ Postgres Server
   ui = Edge UI
   all = עדכון כל הרכיבים במכונה (משתמשים רק בפרופיל התקנה של Edge aio או בפרופיל התקנה של API BaaS asa)
   e = ElasticSearch
   b = API BaaS Stack
   p = API BaaS Portal
   ebp = ElasticSearch, ‏ API BaaS Stack ו-API BaaS Portal באותו צומת
9. בודקים את העדכון על ידי הפעלת כלי השירות apigee-validate בשרת הניהול, כפי שמתואר בקטע בדיקת ההתקנה.
10. אם התקנתם צומת המתנה חדש של Postgres, הוציאו אותו משימוש כמו שמתואר למעלה בקטע הוצאה משימוש של צומת Postgres.

כדי לחזור לגרסה הקודמת, צריך לפעול לפי ההוראות שמפורטות בקטע 4.18.01 Rollback Process.

סדר העדכון של המכונות

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

• צריך לעדכן את כל הצמתים של Cassandra ו-ZooKeeper לפני שמעדכנים צמתים אחרים.
• בכל מכונה עם כמה רכיבי Edge (שרת ניהול, מעבד בקשות, נתב, שרת QPID אבל לא שרת Postgres), צריך להשתמש באפשרות "‎-c edge" כדי לעדכן את כולם בו-זמנית.
• אם בשלב מסוים מצוין שצריך לבצע אותו בכמה מכונות, בצעו אותו לפי סדר המכונות שצוין.
• אין שלב נפרד לעדכון המונטיזציה. הוא מתעדכן כשמציינים את האפשרות "‎-c edge".

להתקנה עצמאית במארח אחד

1. אם הפעלתם את SMTP ב-Edge, הגדירו את SMTPMAILFROM בקובץ התצורה. הפרמטר הזה נראה כך:
   SMTPMAILFROM="My Company <myco@company.com>"
2. אם משדרגים מגרסה 4.16.01, משדרגים לאחור את Zookeeper:
   > yum downgrade apigee-zookeeper
3. מעדכנים את Cassandra ו-ZooKeeper:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
4. מגדירים את הכלל הבא של iptables:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
5. בודקים את תור ההודעות של Qpid:
   > qpid-stat -q
   
   ממשיכים לבדוק את התור עד שהמספר בעמודה msg הוא 0. אי אפשר לשדרג את Qpid עד שהוא יעבד את כל ההודעות.
6. מעדכנים את qpidd:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
7. מנקים את iptables:
   > sudo iptables -F
8. מעדכנים את LDAP:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
9. עוצרים את שרת Postgres, שרת Qpid ו-PostgreSQL:
   > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
   > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
10. מעדכנים את postgresql:
    > ‎/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
11. מעדכנים את מסד הנתונים של Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
12. מעדכנים את שאר הרכיבים של Edge:
    > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
13. מעדכנים את ממשק המשתמש של Edge:
    > ‎/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

להתקנה עצמאית עם 2 מארחים

במאמר טופולוגיות של התקנה מפורטות הטופולוגיות של Edge ומספרי הצמתים.

1. אם הפעלתם את SMTP ב-Edge, הגדירו את SMTPMAILFROM בקובץ התצורה. הפרמטר הזה נראה כך:
   SMTPMAILFROM="My Company <myco@company.com>"
2. אם מעדכנים מגרסה 4.16.01, משדרגים לאחור את Zookeeper במכונה 1:
   > yum downgrade apigee-zookeeper
3. מעדכנים את Cassandra ו-ZooKeeper במכונה 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
4. מגדירים את כלל ה-iptables הבא במכונה 2:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 !‎ -s `hostname` -i eth0 -j DROP
5. בודקים את תור ההודעות של Qpid במכונה 2:
   > qpid-stat -q
   
   ממשיכים לבדוק את התור עד שהמספר בעמודה msg הוא 0. אי אפשר לשדרג את Qpid עד שהוא יעבד את כל ההודעות.
6. מעדכנים את qpidd במכונה 2:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
7. מנקים את iptables במכונה 2:
   > sudo iptables -F
8. מעדכנים את LDAP במכונה 1:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
9. מעדכנים את רכיבי Edge במכונה 1:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
10. מעדכנים את ממשק המשתמש במכונה 1:
    > ‎/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
11. מעדכנים את postgresql במכונה 2:
    1. עוצרים את שרת Postgres, שרת Qpid ו-postgresql:
       > ‎/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
       ‎> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
       ‎> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    2. מעדכנים את postgresql:
       > ‎/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    3. מעדכנים את מסד הנתונים של Postgres:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    4. מעדכנים את רכיבי Edge במכונה 2:
       > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

להתקנה באשכול של 5 מארחים

במאמר טופולוגיות של התקנה מפורטות הטופולוגיות של Edge ומספרי הצמתים.

1. אם הפעלתם את SMTP ב-Edge, הגדירו את SMTPMAILFROM בקובץ התצורה. הפרמטר הזה נראה כך:
   SMTPMAILFROM="My Company <myco@company.com>"
2. מוודאים שהתקנתם צומת המתנה חדש של Postgres, כמו שמתואר למעלה בקטע התקנת צומת המתנה חדש של Postgres.
3. אם משדרגים מגרסה 4.16.01, משדרגים לאחור את Zookeeper במכונות 1, 2 ו-3:
   > yum downgrade apigee-zookeeper
4. מעדכנים את Cassandra ו-ZooKeeper במכונות 1, 2 ו-3:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
5. מגדירים את כלל ה-iptables הבא במכונה 4:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
6. בודקים את תור ההודעות של Qpid במכונה 4:
   > qpid-stat -q
   
   ממשיכים לבדוק את התור עד שהמספר בעמודה msg הוא 0. אי אפשר לשדרג את Qpid עד שהוא יעבד את כל ההודעות.
7. מעדכנים את qpidd במכונה 4:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
8. מנקים את iptables במכונה 4:
   > sudo iptables -F
9. חוזרים על שלבים 5 עד 8 במכונה 5.
10. מעדכנים את LDAP במכונה 1:
    > ‎/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
11. מעדכנים את רכיבי Edge במכונות 1, 2, 3:
    > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
12. מעדכנים את ממשק המשתמש במכונה 1:
    > ‎/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
13. עדכון מכונות 4 ו-5:
    1. עוצרים את שרת Postgres ואת שרת Qpid במכונה 4:
       > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
       > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    2. עוצרים את שרת Postgres, שרת Qpid ו-postgresql במכונה 5:
       > ‎/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
       ‎> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
       ‎> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. עוצרים את שרת Postgres ואת postgresql בצומת ההמתנה החדש שהוספתם לצורך החזרה למצב הקודם:
       > ‎/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
       ‎> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    4. מעדכנים את postgresql במכונות 4:
       > ‎/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    5. מעדכנים את מסד הנתונים של Postgres במכונה 4 (רק ב-Postgres master):
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    6. מעדכנים את postgresql במכונה 5:
       > ‎/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. מפעילים את שרת Postgres ואת שרת Qpid במכונות 4 ו-5:
       > ‎/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
       ‎> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    8. מגדירים את Postgres כצומת המתנה על ידי הפעלת הפקודות הבאות במכונה 5:
       > cd /opt/apigee/data/apigee-postgresql/pgdata
       > rm -rf *
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    9. כדי לאמת את סטטוס הרפליקציה, מריצים את הסקריפטים הבאים בשני השרתים. המערכת אמורה להציג תוצאות זהות בשני השרתים כדי לוודא שהשכפול בוצע בהצלחה:
       
       במכונה 4, צומת המאסטר, מריצים:
       > ‎/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
       
       מוודאים שכתוב שזה המאסטר.
       
       במכונה 5, צומת ההמתנה:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
       
       מוודאים שכתוב שהיא במצב המתנה.
14. מעדכנים את רכיבי Edge במכונות 4 ו-5:
    > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
15. חשוב להוציא משימוש את צומת הגיבוי החדש באמצעות ההליך שמתואר למעלה בקטע הוצאה משימוש של צומת Postgres.

להתקנה באשכול של 9 מארחים

במאמר טופולוגיות של התקנה מפורטות הטופולוגיות של Edge ומספרי הצמתים.

1. אם הפעלתם את SMTP ב-Edge, הגדירו את SMTPMAILFROM בקובץ התצורה. הפרמטר הזה נראה כך:
   SMTPMAILFROM="My Company <myco@company.com>"
2. מוודאים שהתקנתם צומת המתנה חדש של Postgres, כמו שמתואר למעלה בקטע התקנת צומת המתנה חדש של Postgres.
3. אם מעדכנים מגרסה 4.16.01, משדרגים לאחור את Zookeeper במכונות 1, 2 ו-3:
   > yum downgrade apigee-zookeeper
4. מעדכנים את Cassandra ו-ZooKeeper במכונות 1, 2 ו-3:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
5. מגדירים את כלל ה-iptables הבא במכונה 6:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
6. בודקים את תור ההודעות של Qpid במכונה 6:
   > qpid-stat -q
   
   ממשיכים לבדוק את התור עד שהמספר בעמודה msg הוא 0. אי אפשר לשדרג את Qpid עד שהוא יעבד את כל ההודעות.
7. מעדכנים את qpidd במכונה 6:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
8. מנקים את iptables במכונה 6:
   > sudo iptables -F
9. חוזרים על שלבים 5 עד 8 במכונה 7.
10. מעדכנים את LDAP במכונה 1:
    > ‎/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
11. מעדכנים את רכיבי Edge במכונות 6, 7, 1, 4 ו-5 בסדר הזה:
    > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
12. מעדכנים את ממשק המשתמש במכונה 1:
    > ‎/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
13. עדכון מכונות 8 ו-9:
    1. עוצרים את שרת Postgres במכונה 8:
       > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. עוצרים את שרת Postgres ואת postgresql במכונה 9:
       > ‎/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
       ‎> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. עוצרים את שרת Qpid במכונות 6 ו-7:
       > ‎/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. עוצרים את שרת Postgres ואת postgresql בצומת ההמתנה החדש שהוספתם לצורך החזרה למצב הקודם:
       > ‎/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
       ‎> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. מעדכנים את postgresql במכונות 8:
       > ‎/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. מעדכנים את מסד הנתונים של Postgres במכונה 8 (רק ב-Postgres הראשי):
       > ‎/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. מעדכנים את postgresql במכונות 9:
       > ‎/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. מפעילים את שרת Postgres במכונות 8 ו-9:
       > ‎/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. מפעילים את שרת Qpid במכונות 6 ו-7:
       > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. מגדירים את Postgres כצומת המתנה על ידי הפעלת הפקודות הבאות במכונה 9:
        > cd /opt/apigee/data/apigee-postgresql/pgdata
        > rm -rf *
        > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    11. כדי לאמת את סטטוס הרפליקציה, מריצים את הסקריפטים הבאים בשני השרתים. המערכת אמורה להציג תוצאות זהות בשני השרתים כדי לוודא שהשכפול בוצע בהצלחה:
        במכונה 8, צומת המאסטר, מריצים את הפקודה:
        > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
        
        מוודאים שמופיע הכיתוב שזהו המאסטר.
        
        במכונה 9, צומת ההמתנה:
        > ‎/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
        
        מוודאים שמופיע הכיתוב standby.
14. מעדכנים את רכיבי Edge במכונות 8 ו-9:
    > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
15. חשוב להוציא משימוש את צומת הגיבוי החדש באמצעות ההליך שמתואר למעלה בקטע הוצאה משימוש של צומת Postgres.

להתקנה באשכול של 13 מארחים

במאמר טופולוגיות של התקנה מפורטות הטופולוגיות של Edge ומספרי הצמתים.

1. אם הפעלתם את SMTP ב-Edge, הגדירו את SMTPMAILFROM בקובץ התצורה. הפרמטר הזה נראה כך:
   SMTPMAILFROM="My Company <myco@company.com>"
2. מוודאים שהתקנתם צומת המתנה חדש של Postgres, כמו שמתואר למעלה בקטע התקנת צומת המתנה חדש של Postgres.
3. אם מעדכנים מגרסה 4.16.01, משדרגים לאחור את Zookeeper במכונות 1, 2 ו-3:
   > yum downgrade apigee-zookeeper
4. מעדכנים את Cassandra ו-ZooKeeper במכונות 1, 2 ו-3:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
5. מגדירים את כלל ה-iptables הבא במכונה 12:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
6. בודקים את תור ההודעות של Qpid במכונה 12:
   > qpid-stat -q
   
   ממשיכים לבדוק את התור עד שהמספר בעמודה msg הוא 0. אי אפשר לשדרג את Qpid עד שהוא יעבד את כל ההודעות.
7. מעדכנים את qpidd במכונה 12:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
8. מנקים את iptables במכונה 12:
   > sudo iptables -F
9. חוזרים על שלבים 5 עד 8 במכונה 13.
10. מעדכנים את LDAP במכונות 4 ו-5:
    > ‎/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
11. מעדכנים את רכיבי Edge במכונות 12, 13, 6, 7, 10 ו-11 בסדר הזה:
    > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
12. מעדכנים את ממשק המשתמש במכונות 6 ו-7:
    > ‎/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
13. עדכון מכונות 8 ו-9:
    1. עוצרים את שרת Postgres במכונה 8:
       > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. עוצרים את שרת Postgres ואת postgresql במכונה 9:
       > ‎/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
       ‎> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. עוצרים את שרת Qpid במכונות 12 ו-13:
       > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. עוצרים את שרת Postgres ואת postgresql בצומת ההמתנה החדש שהוספתם לצורך החזרה למצב הקודם:
       > ‎/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
       ‎> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. מעדכנים את postgresql במכונות 8:
       > ‎/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. מעדכנים את מסד הנתונים של Postgres במכונה 8 (רק ב-Postgres הראשי):
       > ‎/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. מעדכנים את postgresql במכונות 9:
       > ‎/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. מפעילים את שרת Postgres במכונות 8 ו-9:
       > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. מפעילים את שרת Qpid במכונות 12 ו-13:
       > ‎/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. מגדירים את Postgres כצומת המתנה על ידי הפעלת הפקודות הבאות במכונה 9:
        > cd /opt/apigee/data/apigee-postgresql/pgdata
        > rm -rf *
        > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    11. כדי לאמת את סטטוס הרפליקציה, מריצים את הסקריפטים הבאים בשני השרתים. המערכת אמורה להציג תוצאות זהות בשני השרתים כדי לוודא שהשכפול בוצע בהצלחה:
        במכונה 8, צומת המאסטר, מריצים את הפקודה:
        > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
        
        מוודאים שמופיע הכיתוב שזהו המאסטר.
        
        במכונה 9, צומת ההמתנה:
        > ‎/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
        
        מוודאים שמופיע הכיתוב standby.
14. מעדכנים את רכיבי Edge במכונות 8 ו-9:
    > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
15. חשוב לוודא שאתם מוציאים משימוש את הצומת החדש במצב המתנה, לפי ההליך שמתואר למעלה בקטע הוצאה משימוש של צומת Postgres.

להתקנה באשכול של 12 מארחים

במאמר טופולוגיות של התקנה מפורטות הטופולוגיות של Edge ומספרי הצמתים.

1. אם הפעלתם את SMTP ב-Edge, הגדירו את SMTPMAILFROM בקובץ התצורה. הפרמטר הזה נראה כך:
   SMTPMAILFROM="My Company <myco@company.com>"
2. מוודאים שהתקנתם צומת המתנה חדש של Postgres, כמו שמתואר למעלה בקטע התקנת צומת המתנה חדש של Postgres.
3. מעדכנים את Cassandra ואת ZooKeeper:
   1. אם מעדכנים מגרסה 4.16.01, משדרגים לאחור את Zookeeper במכונות 1, 2 ו-3 במרכז נתונים 1:
      > yum downgrade apigee-zookeeper
   2. במכונות 1, 2 ו-3 במרכז נתונים 1:
      > ‎/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
   3. אם מעדכנים מגרסה 4.16.01, משדרגים לאחור את Zookeeper במכונות 7, 8 ו-9 במרכז נתונים 2:
      > yum downgrade apigee-zookeeper
   4. במכונות 7, 8 ו-9 במרכז הנתונים 2
      > ‎/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
4. מעדכנים את qpidd:
   1. מכונות 4 ו-5 במרכז נתונים 1
      1. מגדירים את כלל ה-iptables הבא במכונה 4:
         > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
      2. בודקים את תור ההודעות של Qpid במכונה 4:
         > qpid-stat -q
         
         ממשיכים לבדוק את התור עד שהמספר בעמודה msg הוא 0. אי אפשר לשדרג את Qpid עד שהוא יעבד את כל ההודעות.
      3. מעדכנים את qpidd במכונה 4:
         > ‎/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. מנקים את iptables במכונה 4:
         > sudo iptables -F
      5. חוזרים על שלבים 1 עד 4 במכונה 5.
   2. מכונות 10 ו-11 במרכז נתונים 2
      1. מגדירים את הכלל הבא של iptables במכונה 10:
         > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
      2. בודקים את תור ההודעות של Qpid במכונה 10:
         > qpid-stat -q
         
         ממשיכים לבדוק את התור עד שהמספר בעמודה msg הוא 0. אי אפשר לשדרג את Qpid עד שהוא יעבד את כל ההודעות.
      3. מעדכנים את qpidd במכונה 10:
         > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. מנקים את iptables במכונה 10:
         > sudo iptables -F
      5. חוזרים על שלבים 1 עד 4 במכונה 11.
5. מעדכנים את ה-LDAP:
   1. מכונה 1 במרכז נתונים 1
      > ‎/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
   2. מכונות 7 במרכז נתונים 2
      > ‎/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
6. מעדכנים את הרכיבים של Edge:
   1. מכונות 4, 5, 1, 2, 3 במרכז נתונים 1
      > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
   2. מכונות 10, 11, 7, 8, 9 במרכז נתונים 2
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
7. עדכון ממשק המשתמש:
   1. מכונה 1 במרכז נתונים 1:
      > ‎/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
   2. מכונה 7 במרכז נתונים 2:
      > ‎/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
8. מעדכנים את מכונה 6 במרכז נתונים 1 ואת מכונה 12 במרכז נתונים 2:
   1. עוצרים את שרת Postgres במכונה 6:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
   2. עוצרים את שרת Postgres ואת postgresql במכונה 12:
      > ‎/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      ‎> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
   3. עוצרים את שרת Qpid במכונות 4, 5, 10 ו-11:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
   4. עוצרים את שרת Postgres ואת postgresql בצומת ההמתנה החדש שהוספתם לצורך החזרה למצב הקודם:
      > ‎/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      ‎> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
   5. מעדכנים את postgresql במכונות 6:
      > ‎/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile‎
   6. מעדכנים את מסד הנתונים של Postgres במכונה 6 (רק ב-Postgres הראשי):
      > ‎/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
   7. מעדכנים את postgresql במכונות 12:
      > ‎/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
   8. מפעילים את שרת Postgres במכונות 6 ו-12:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
   9. מפעילים את שרת Qpid במכונות 4, 5, 10 ו-11:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
   10. מגדירים את Postgres כצומת המתנה על ידי הפעלת הפקודות הבאות במכונה 12:
       > cd /opt/apigee/data/apigee-postgresql/pgdata
       > rm -rf *
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
   11. כדי לאמת את סטטוס הרפליקציה, מריצים את הסקריפטים הבאים בשני השרתים. המערכת אמורה להציג תוצאות זהות בשני השרתים כדי להבטיח שכפול מוצלח:
       במכונה 6, צומת המאסטר, מריצים:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
       
       מוודאים שכתוב שזה המאסטר.
       
       במכונה 12, צומת ההמתנה:
       > ‎/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
       
       מוודאים שכתוב שהצומת במצב המתנה.
9. מעדכנים את רכיבי Edge במכונות 6 ו-12:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
10. מוודאים שהוצאתם משימוש את הצומת החדש במצב המתנה, לפי ההליך שמתואר למעלה בקטע הוצאה משימוש של צומת Postgres.

להתקנת API BaaS עם 7 מארחים או 10 מארחים

להתקנה לא סטנדרטית

אם ההתקנה לא סטנדרטית, צריך לעדכן את רכיבי Edge בסדר הבא:

1. ZooKeeper
2. Cassandra
3. qpidd
4. LDAP
5. ‫Edge, כלומר הפרופיל "‎-c edge" בכל הצמתים לפי הסדר: צמתים עם שרת Qpid אבל לא שרת Postgres, שרת ניהול, מעבד בקשות ונתב.
   הערה: אם בצומת מותקנים גם שרת Qpid וגם שרת Postgres, מריצים את שלב הפרופיל "‎-c edge" כחלק משלב 8.
6. ממשק המשתמש של Edge
7. ‫postgresql ב-Postgres הראשי, כולל שדרוג.
8. ‫postgresql ב-Postgres standby.
9. Edge, כלומר הפרופיל "-c edge" בכל הצמתים המשולבים של Qpid ו-Postgres, או בכל צומת עצמאי של Postgres.