דף זה תורגם על ידי Cloud Translation API.

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

Edge for Private Cloud גרסה 4.18.01

אילו גרסאות של Edge אפשר לעדכן ל-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.
- אם עוברים מגרסת Edge 4.14.04 ואילך: העברה ישירה לגרסה 4.15.07.
- אם את/ה מבצע/ת העברה מגרסה 4.14.01 של Edge: צריך קודם לעבור לגרסה 4.14.04, ולאחר מכן עוברים לגרסה 4.15.07.

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

המשתמש שמריץ את העדכון צריך להיות זהה למשתמש שהתקין את Edge, או משתמש שפועל ברמה הבסיסית (root).

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

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

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

שדרוג לאחור של Zoomkeeper אם מתבצע עדכון מ- 4.16.01

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

אפשר לבדוק את הגרסה שלZokeeper באמצעות הפקודה הבאה:

> rpm -qa |grep apigee-zookeeper

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

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 תהליך החזרה למצב קודם לקבלת מידע נוסף.

פרטי העדכון ביומן

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

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

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

אם למשתמש אין גישה ל-/tmp, הכלי /tmp ייכשל.

נדרש שדרוג לגרסה 8 של Java JDK

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

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

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

צריך להפעיל חבילות נוספות עבור Enterprise Linux (או EPEL) כדי להתקין או לעדכן את Edge. הפקודה שבה משתמשים תלויה בגרסת 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 פרמטר הגדרה

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

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

הפורמט של הפרמטר הזה:

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

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

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

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

כשהאימות החיצוני מופעל, רוב הלקוחות משתמשים בחשבון SAM של Active Directory. השדה name בתור שם המשתמש לאימות, במקום כתובת אימייל שמשמשת את שרת 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

שימו לב שאם משתמשים בטבלאות iptable בכללים אחרים, אפשר להשתמש באפשרות -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 מושבתים לעדכון, נתוני Analytics עדיין נכתב לצמתים ה-Qpid. אחרי שמעדכנים את הצמתים של Postgres וחוזרים למצב אונליין, ניתוח הנתונים הנתונים נדחפים לצמתים של Postgres.

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

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

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

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

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

במאסטר הנוכחי של Postgres, עורכים את /opt/apigee/customer/application/postgresql.properties כדי להגדיר את האסימון הבא. אם הקובץ הזה לא קיים, יוצרים אותו:

conf_pg_hba_replication.connection=host אפיק רפליקציה existing_slave_ip/32 trust\ \nרפליקציית מארח apigee new_slave_ip/32 trust

כאשר existing_slave_ip הוא כתובת ה-IP של ה-Postgres הנוכחי שרת ההמתנה ו-new_slave_ip הוא כתובת ה-IP של מצב ההמתנה החדש .
הפעלה מחדש של apigee-postgresql במאסטר של Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql הפעלה מחדש
כדי לוודא שהצומת החדש של מצב המתנה נוסף, אפשר לעיין ב-/opt/apigee/apigee-postgresql/conf/pg_hba.conf במאסטר. השורות הבאות אמורות להופיע בקובץ:
apigee של רפליקציית מארח existing_slave_ip/32 Trust
host apigee new_slave_ip/32 trust
התקנת שרת ההמתנה החדש של Postgres:
1. כדי לציין, עורכים את קובץ התצורה שבו השתמשתם כדי להתקין את הגרסה הנוכחית של Edge. אלה:
  
  מספר כתובת IP של מאסטר:
  PG_MASTER=192.168.56.103
  כתובת IP אחת של צומת ההמתנה החדש
  PG_STANDBY=192.168.56.102
2. משביתים את SELinux כפי שמתואר בהתקנת כלי ההגדרה של Edge apigee-setup.
3. מורידים את הקובץ Edge shoestrap_4.16.05.sh אל /tmp/shoestrap_4.16.05.sh:
  > תלתל https://software.apigee.com/shoestrap_4.16.05.sh -o /tmp/shoestrap_4.16.05.sh
  
  הערה: אם מעדכנים מגרסה 4.16.01, צריך להוריד את הקובץ bootstrap.sh של Edge.
4. מתקינים את כלי השירות apigee-service של Edge ו של יחסי התלות:
  > sudo bash /tmp/shoestrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
5. להשתמש ב-apigee-service כדי מתקינים את apigee-setup תוכנית שירות:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup installation
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 צומת

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

צריך לוודא ש-Postgres פועל:
> /opt/apigee/apigee-service/bin/apigee-all status

אם Postgres לא פועל, מפעילים אותו:
> /opt/apigee/apigee-service/bin/apigee-all start
כדי לקבל את ה-UUID של צומת ההמתנה החדש, מריצים את פקודת ה-cURL הבאה צומת מצב המתנה:
> curl -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self

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

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

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

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

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

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

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

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

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

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

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

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

אם אתם משתמשים כרגע ברפליקציית המתנה מאסטר של Postgres, עליכם להתקין גרסה חדשה של Postgres צומת המתנה, כפי שמתואר למעלה בהתקנת Postgres חדש צומת במצב המתנה.
צריך להשבית את כל משימות CRON שהוגדרו לביצוע פעולת תיקון ב-Cassandra, אם יש כאלה עד לסיום העדכון.
כדי להתקין את ההכנסות לאלף חשיפות ב-Edge, צריך להתחבר לצומת בתור הרמה הבסיסית (root).
הערה: התקנת RPM מחייבת גישה לרמה הבסיסית (root), אבל אפשר להשתמש ב-Edge ללא גישה לרמה הבסיסית (root).
מתקינים את yum-utils ואת yum-plugin-priorities:
> sudo yum התקנת yum-utils
> עדיפות ל-sudo yum להתקנת yum-Plugin
השבתת SELinux כפי שמתואר בהתקנה כלי ההגדרה של Edge apigee-setup.
מפעילים מאגר EPEL כמו שמתואר למעלה.
אם אתם מתקינים ב-Oracle 7.x, מריצים את הפקודה הבאה:
> sudo yum-config-manager --enable ol7_optional_previous
אם אתם מתקינים ב-AWS, מריצים את הפקודות הבאות yum-configure-manager:
> עדכון יאמי rh-amazon-rhui-client.noarch
> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
מורידים את קובץ bootstrap_4.18.01.sh ב-Edge 4.18.01 אל bootstrap_4.18.01.sh:
> תלתל https://software.apigee.com/shoestrap_4.18.01.sh -o /tmp/shoestrap_4.18.01.sh
מתקינים את כלי השירות apigee-service 4.18.01 ו- של יחסי התלות:
> sudo bash /tmp/shoestrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

כאשר uName:pWord הם שם המשתמש והסיסמה שקיבלתם ב-Apigee. אם משמיטים את המילה pWord, תתבקשו להזין אותה.

כברירת מחדל, מנהל ההתקנה בודק אם התקנתם את Java 1.8. אם לא, יתקין אותו בשבילך. משתמשים באפשרות JAVA_FIX כדי לציין איך לטפל התקנת Java. JAVA_FIX מקבל את הערכים הבאים:

I = התקנת OpenJDK 1.8 (ברירת מחדל)
C = המשך בלי להתקין Java
שאלה = יציאה. כדי להשתמש באפשרות הזו, תצטרכו להתקין Java בעצמכם.
להשתמש ב-apigee-service כדי מעדכנים את כלי השירות apigee-setup:
1. אם התקנת את גרסה 4.16.01 על ידי שדרוג גרסה 4.15.07.0x של Edge, עליך להתקין כלי ההגדרה 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.
בהתאם לגרסה הנוכחית של Edge, צריך להתקין או לעדכן את apigee-validate ב- שרת ניהול.
1. אם אתם משתמשים כרגע ב-Edge 4.16.05: מעדכנים את הכלי apigee-validate ב שרת ניהול:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-authentic update
2. אם אתם משתמשים כרגע ב-Edge 4.16.01: מתקינים את הכלי apigee-validate ב שרת ניהול:
  > /opt/apigee/apigee-service/bin/apigee-service apigee- שני באירוע
  
  הערה: אם התקנתם את הכלי apigee-validate בהודעה צומת של מעבד המידע כשמתקינים את גרסה 4.16.01, אפשר לעדכן אותו באמצעות הפקודה הבאה ב- הצומת הזה:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-authentic 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. אפשר להסיר את שני המאפיינים האחרים מהקובץ.
עדכון של apigee-provision תוכנית שירות:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
מריצים את כלי העדכון בצמתים לפי הסדר הבא שמוצג בקטע סדר המכונה עדכון" מתחת:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

הדרישה היחידה בקובץ התצורה היא שקובץ התצורה יהיה נגיש או קריא באמצעות ה-apigee משתמש.

משתמשים באפשרות ' -c' כדי לציין את הרכיב שרוצים לעדכן. רשימת האפשרויות הרכיבים כוללים:
ldap = OpenLDAP
cs = Cassandra
zk = הזואומרים
qpid = qpidd
ps = postgresql
dge =כל רכיבי Edge חוץ מממשק משתמש של Edge: שרת ניהול, מעבד הודעות, נתב, שרת QPID, שרת Postgres
ui = ממשק משתמש של Edge
all = עדכון כל הרכיבים ב- מחשב (לשימוש רק בפרופיל התקנה של ממשק Aio ב-Edge או בהתקנת API BaaS asa) פרופיל)
e = ElasticSearch
b = API BaaS Stack
p = פורטל API BaaS
ebp = ElasticSearch, API BaaS מקבץ ופורטל BaaS של API באותו צומת
בודקים את העדכון על ידי הרצת הכלי לאימות apigee בשרת הניהול, כפי שמתואר במאמר בדיקת ההתקנה.
אם התקנתם צומת מצב המתנה חדש ב-Postgres, צריך להוציא את הצומת משימוש כפי שמתואר למעלה הסרת שירות Postgres צומת.

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

נוהל עדכון לגרסה 4.18.01 של מקור מקומי מאגר

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

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

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

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

אם אתם משתמשים כרגע ברפליקציית המתנה מאסטר של Postgres, עליכם להתקין גרסה חדשה של Postgres צומת המתנה, כפי שמתואר למעלה בהתקנת Postgres חדש צומת במצב המתנה.
יוצרים מאגר 4.18.01 מקומי כפי שמתואר ב"יצירת מאגר Apigee מקומי" מתקינים את כלי ההגדרה של Edge apigee-setup.
הערה: אם כבר יש לכם מאגר נתונים 4.16.01 או 4.16.05, אפשר להוסיף את 4.18.01 מאגר שלו כפי שמתואר ב"עדכון מאגר Apigee מקומי" בהתקנת כלי ההגדרה של Edge apigee-setup.
כדי להתקין את 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. התקנה של כלי העזר של Edge apigee-service ויחסי תלות מ- /tmp/repos:
  > sudo bash /tmp/repos/shoestrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  שימו לב שהפקודה הזו כוללת את הנתיב לספריית ה-repos.
כדי להתקין את apigee-service באמצעות שרת האינטרנט Nginx:
1. הגדרת שרת האינטרנט Nginx כפי שמתואר ב"התקנה מהמאגר באמצעות ה-Nginx webserver" בדף Install the Edge הכלי apigee-setup.
2. בצומת המרוחק, מורידים את קובץ bootstrap_4.18.01.sh של Edge אל /tmp/shoestrap_4.18.01.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh -o /tmp/shoestrap_4.18.01.sh
  
  כאשר uName:pWord הם שם המשתמש והסיסמה שהגדרתם למעלה המאגר ו-remoteRepo הוא כתובת ה-IP או שם ה-DNS של מאגר מאגר.
3. בצומת המרוחק, מתקינים את כלי השירות ואת יחסי התלות של Edge apigee-service:
  > sudo bash /tmp/shoestrap_4.18.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  
  כאשר uName:pWord הם שם המשתמש והסיסמה במאגר.
להשתמש ב-apigee-service כדי מעדכנים את כלי השירות apigee-setup:
1. אם התקנת את גרסה 4.16.01 על ידי שדרוג גרסה 4.15.07.0x של Edge, עליך להתקין כלי ההגדרה 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.
בהתאם לגרסה הנוכחית של Edge, צריך להתקין או לעדכן את השירות apigee-validate ב- שרת ניהול.
1. אם אתם משתמשים כרגע ב-Edge 4.16.05: מעדכנים את כלי השירות apigee-validate ב שרת ניהול:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-authentic update
2. אם אתם משתמשים כרגע ב-Edge 4.16.01: מתקינים את אימות ה-apigee בשרת הניהול:
  > /opt/apigee/apigee-service/bin/apigee-service apigee- שני באירוע
  
  הערה: אם התקנתם את הכלי apigee-validate בהודעה צומת של מעבד המידע כשמתקינים את גרסה 4.16.01, אפשר לעדכן אותו באמצעות הפקודה הבאה ב- הצומת הזה:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-authentic update
  
  עם זאת, החל מ-4.16.05 ואילך, Apigee ממליצה להתקין ולהריץ את שירות לאימות apigee בשרת הניהול.
3. אם משדרגים מ-4.16.01: עורכים את קובץ התצורה שמועבר השירות apigee-validate. לחשבון בגרסה 4.16.01 Edge, בקובץ התצורה שמשמש את apigee-validate בדרישות הבאות נכסים:
  APIGEE_ADMINPW=sysAdminPword
  MP_POD=gateway
  REGION=dc-1
  
  בגרסה הזו, לקובץ התצורה נדרש רק המאפיין APIGEE_ADMINPW. אפשר להסיר את שני המאפיינים האחרים מהקובץ.
עדכון של apigee-provision תוכנית שירות:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
מריצים את הכלי לעדכון בצמתים לפי הסדר הבא שמוצג בקטע 'הזמנת המכונה' עדכון" מתחת:
> /opt/apigee/apigee-setup/bin/update.sh -cComponent -f configFile

הדרישה היחידה בקובץ התצורה היא שקובץ התצורה יהיה נגיש או קריא באמצעות ה-apigee משתמש.

משתמשים באפשרות ' -c' כדי לציין את הרכיב שרוצים לעדכן. רשימת האפשרויות הרכיבים כוללים:
ldap = OpenLDAP
cs = Cassandra
zk = הזואומרים
qpid = qpidd
ps = postgresql
dge =כל רכיבי Edge חוץ מממשק משתמש של Edge: שרת ניהול, מעבד הודעות, נתב, שרת QPID, שרת Postgres
ui = ממשק משתמש של Edge
all = עדכון כל הרכיבים ב- מחשב (לשימוש רק בפרופיל התקנה של ממשק Aio ב-Edge או בהתקנת API BaaS asa) פרופיל)
e = ElasticSearch
b = API BaaS Stack
p = פורטל API BaaS
ebp = ElasticSearch, API BaaS מקבץ ופורטל BaaS של API באותו צומת
בודקים את העדכון על ידי הרצת הכלי לאימות apigee בשרת הניהול, כפי שמתואר במאמר בדיקת ההתקנה.
אם התקנתם צומת מצב המתנה חדש ב-Postgres, צריך להוציא את הצומת משימוש כפי שמתואר למעלה הסרת שירות Postgres צומת.

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

סדר עדכון המכונה

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

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