Edge for Private Cloud גרסה 4.17.09
כדי להתקין את Edge בצומת, קודם צריך להתקין את כלי השירות Edge apigee-setup. בסביבה שבה אין לצמתים שלך חיבור חיצוני לאינטרנט, עליך להתקין גם עותק מקומי של המאגר ב-Apigee.
ספריית התקנה המוגדרת כברירת מחדל: /opt/apigee
Edge מתקין את כל הקבצים בספרייה /opt/apigee
. לא ניתן לשנות את הספרייה הזו. עם זאת, אפשר ליצור קישור סמלי כדי למפות את /opt/apigee
למיקום אחר. למידע נוסף, אפשר לעיין בדרישות התקנה.
דרישה מוקדמת: השבתת SELinux
כדי להתקין את תוכנת העזר של Edge apigee-setup
או את כל רכיבי Edge צריך להשבית את SELinux או להגדיר אותה למצב מתירני. אם צריך, אחרי שמתקינים את Edge, אפשר להפעיל מחדש את SELinux.
- כדי להגדיר את SELinux למצב מתיר באופן זמני, מריצים את הפקודה הבאה:
- במערכת הפעלה Linux 6.x:
> sudo echo 0 > /selinux/enforce
כדי להפעיל מחדש את SELinux אחרי התקנת Edge:
> sudo echo 1 > /selinux/enforce
- במערכת הפעלה Linux 7.x:
> sudo setenforce 0
כדי להפעיל מחדש את SELinux אחרי התקנת Edge:
> sudo setenforce 1
- במערכת הפעלה Linux 6.x:
- כדי להשבית באופן סופי את SELinux או להגדיר אותה למצב מתירני:
- פתיחת
/etc/sysconfig/selinux
בעורך. - הגדרת
SELINUX=disabled
אוSELINUX=permissive
- שומרים את השינויים.
- מפעילים מחדש את הצומת.
- אם צריך, מפעילים מחדש את SELinux אחרי התקנת Edge על ידי חזרה על התהליך הזה כדי להגדיר את
SELINUX=enabled
.
- פתיחת
דרישה מוקדמת: הפעלת מאגר EPEL
עליכם להפעיל חבילות נוספות ל-Enterprise Linux (או EPEL) כדי להתקין או לעדכן את Edge, או כדי ליצור מאגר מקומי. פקודת השימוש תלויה בגרסת RedHat/CentOS שבה אתם משתמשים:
- ל-RedHat/CentOS/Oracle 7.x:
> wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; sudo rpm -ivh epel-release-latest-7.noarch.rpm
- ל-RedHat/CentOS/Oracle 6.x:
> wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; sudo rpm -ivh epel-release-latest-6.noarch.rpm
דרישה מוקדמת: יש לבדוק את הגרסה של ספריית libdb4 ב-RedHat 7.4 וב-CentOS 7.4
ב-RedHat 7.4 וב-CentOS 7.4, יש לבדוק את הגרסה של ה-RPM של libdb4
לפני ההתקנה. כדי להשתמש ב-Edge
נדרשת גרסה 4.8 וגרסאות מסוימות של RedHat 7.4 ושל CentOS 7.4 עם
גרסה מאוחרת יותר.
כדי לבדוק את הגרסה שלכם, השתמשו בפקודה הבאה:
> rpm -qa | grep libdb
אם רואים שהגרסה של ה-RPM של libdb4
מאוחרת יותר מגרסה 4.8, אפשר להשתמש בפקודה הבאה כדי להחליף את ה-RPM:
> rpm -Uvh --oldpackage libdb4-cxx-4.8.30-13.el7.x86_64.rpm libdb4-4.8.30-13.el7.x86_64.rpm
אם צריך להוריד את ההכנסות האלה לאלף חשיפות, אפשר להוריד אותן מהנכסים הבאים:
- http://dl.fedoraproject.org/pub/epel/7/x86_64/Packages/l/libdb4-cxx-4.8.30-13.el7.x86_64.rpm
- http://dl.fedoraproject.org/pub/epel/7/x86_64/Packages/l/libdb4-4.8.30-13.el7.x86_64.rpm
התקנת תוכנית השירות של Edge להגדרת apigee בצומת עם חיבור חיצוני לאינטרנט
כדי להתקין את Edge בצומת עם חיבור אינטרנט חיצוני:
- משיגים את שם המשתמש והסיסמה מ-Apigee, שבאמצעותם ניתן לגשת למאגר Apigee. אם יש לכם שם משתמש:סיסמה לאתר Apigee ftp, ניתן להשתמש בפרטי הכניסה האלה.
- מתחברים לצומת בתור הבסיס כדי להתקין את ה-RPM של Edge.
- מתקינים את
yum-utils
ואתyum-plugin-priorities
:> sudo yum install yum-utils > sudo yum install yum-plugin-priorities
- משביתים את SELinux כפי שמתואר למעלה.
- מפעילים מאגר EPEL כפי שמתואר למעלה.
- אם מתקינים ב-AWS, מריצים את הפקודה
yum-configure-manager
הבאה:> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
- מורידים את קובץ Edge
bootstrap_4.17.09.sh
ל-/tmp/bootstrap_4.17.09.sh
:> curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
- מתקינים את תוכנת העזר ואת יחסי התלות של שירות Edge apigee:
> sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord
uName:pWord הם שם המשתמש והסיסמה שקיבלת מ-Apigee. אם לא מזינים את הערך pWord, צריך להזין אותו.
כברירת מחדל, מנהל ההתקנה בודק שמותקנת אצלך גרסת Java 1.8. אם לא, הוא יתקין אותו עבורכם. השתמשו באפשרות
JAVA_FIX
כדי לציין איך לטפל בהתקנת Java. הפונקציהJAVA_FIX
מקבלת את הערכים הבאים:- I = התקן את OpenJDK 1.8 (ברירת מחדל)
- C = המשך ללא התקנת Java
- Q = יציאה. עבור אפשרות זו, עליכם להתקין את Java בעצמכם.
ההתקנה של כלי השירות apigee-service יוצרת את הקובץ /etc/yum.repos.d/apigee.repo שמגדיר את מאגר Apigee. כדי להציג את קובץ ההגדרה, משתמשים בפקודה:
> cat /etc/yum.repos.d/apigee.repo
כדי לראות את התוכן במאגר, משתמשים בפקודה:
> sudo yum -v repolist 'apigee*'
- צריך להשתמש ב-
apigee-service
כדי להתקין את כלי השירותapigee-setup
:> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- שימוש ב-
apigee-setup
להתקנה ולהגדרה של רכיבי Edge בצומת. למידע נוסף, אפשר לקרוא את המאמר התקנת רכיבי Edge בצומת.
התקנת תוכנית השירות של Edge להגדרת apigee בצומת ללא חיבור אינטרנט חיצוני
אם צמתים של Edge נמצאים מאחורי חומת אש, או שהגישה שלהם למאגר Apigee באינטרנט אסורה בדרך אחרת, צריך ליצור מאגר מקומי, או שיקוף, של המאגר של Apigee. לאחר מכן, המראה הזה צריך להיות נגיש לכל הצמתים. אחרי שצמתים נוצרו, הם יוכלו לגשת לשיקוף המקומי כדי להתקין את Edge.
כדי ליצור את מאגר Apigee הפנימי, צריך צומת עם גישה חיצונית לאינטרנט כדי להוריד את יחסי התלות וה-RPM של Edge. אחרי שיוצרים את המאגר הפנימי, אפשר להעביר אותו לצומת אחר או להפוך את הצומת לנגיש לצומתי Edge לצורך התקנה.
אחרי שיוצרים מאגר מקומי של Edge, יכול להיות שבשלב מאוחר יותר צריך לעדכן אותו בקובצי הגרסה האחרונים של Edge. בקטעים הבאים מוסבר איך ליצור מאגר מקומי ואיך לעדכן אותו.
יצירת מאגר Apigee מקומי
כדי ליצור מאגר Apigee מקומי:
- משיגים את שם המשתמש והסיסמה מ-Apigee, שבאמצעותם ניתן לגשת למאגר Apigee. אם יש לכם שם משתמש:סיסמה לאתר Apigee ftp, ניתן להשתמש בפרטי הכניסה האלה.
- מתחברים לצומת בתור הבסיס כדי להתקין את ה-RPM של Edge.
- מתקינים את
yum-utils
ואתyum-plugin-priorities
:> sudo yum install yum-utils > sudo yum install yum-plugin-priorities
- משביתים את SELinux כפי שמתואר למעלה.
- מפעילים מאגר EPEL כפי שמתואר למעלה.
- אם מתקינים ב-AWS, מריצים את
הפקודה
yum-configure-manager
הבאה:
> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
- מורידים את קובץ Edge
bootstrap_4.17.09.sh
ל-/tmp/bootstrap_4.17.09.sh
:> curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
- מתקינים את תוכנת העזר ואת יחסי התלות של Edge
apigee-service
:> sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord
uName:pWord הם שם המשתמש והסיסמה שקיבלת מ-Apigee. אם לא מזינים את הערך pWord, צריך להזין אותו.
- מתקינים את הכלי
apigee-mirror
בצומת:> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
- אפשר להשתמש בכלי העזר
apigee-mirror
כדי לסנכרן את מאגר Apigee לספרייה/opt/apigee/data/apigee-mirror/repos/
.כדי לצמצם את גודל המאגר, צריך לכלול את
--only-new-rpms
כדי להוריד רק את ה-RPM העדכני ביותר. צריך נפח אחסון של 1.6GB בערך להורדה:> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
כדי להוריד את כל המאגר, כולל RPM ישנות יותר, צריך להשמיט את
--only-new-rpms
. נדרש נפח אחסון של כ-6GB להורדה מלאה:> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync
יש לך עכשיו עותק מקומי של מאגר Apigee. בקטע הבא מוסבר איך להתקין את כלי השירות Edge
apigee-setup
מהמאגר המקומי. -
(אופציונלי) אם רוצים להתקין את Edge מהמאגר המקומי באותו צומת שמארח את המאגר המקומי, צריך קודם להריץ את הפקודות הבאות:
- מריצים את הפקודה
bootstrap_4.17.09.sh
מהמאגר המקומי כדי להתקין את תוכנית השירותapigee-service
:> sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
- צריך להשתמש ב-
apigee-service
כדי להתקין את כלי השירותapigee-setup
:> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- שימוש ב-
apigee-setup
להתקנה ולהגדרה של רכיבי Edge בצומת. למידע נוסף, אפשר לקרוא את המאמר התקנת רכיבי Edge בצומת.
- מריצים את הפקודה
התקנת apigee-setup בצומת מרוחק מהמאגר המקומי
יש שתי אפשרויות להתקנת Edge מהמאגר המקומי. אתם יכולים:
- יוצרים קובץ .tar של המאגר, מעתיקים את קובץ ה- .tar לצומת ואז מתקינים את Edge מקובץ ה- .tar.
- מתקינים שרת אינטרנט בצומת עם המאגר המקומי כדי שצמתים אחרים יוכלו לגשת אליו. Apigee מספקת לך את שרת האינטרנט של Nginx, או שתוכל להשתמש בשרת אינטרנט משלך.
התקנה מקובץ ה- .tar:
- בצומת עם המאגר המקומי, משתמשים בפקודה הבאה כדי לארוז את המאגר המקומי בקובץ .tar אחד בשם
/opt/apigee/data/apigee-mirror/apigee-4.17.09.tar.gz
:> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- מעתיקים את קובץ ה- .tar לצומת שבו רוצים להתקין את Edge. לדוגמה, מעתיקים אותו לספרייה
/tmp
בצומת החדש. - מתקינים את
yum-utils
ואתyum-plugin-priorities
:> sudo yum install yum-utils > sudo yum install yum-plugin-priorities
- בצומת החדש, משביתים את SELinux כפי שמתואר למעלה.
- מפעילים מאגר EPEL כפי שמתואר למעלה.
- בצומת החדש, מבטלים את קיומו של הקובץ לספרייה /tmp:
> tar -xzf apigee-4.17.09.tar.gz
פקודה זו יוצרת ספרייה חדשה בשם repos, בספרייה שמכילה את קובץ ה- .tar. לדוגמה
/tmp/repos.
- מתקינים את תוכנת העזר ואת יחסי התלות של שירות Edge apigee מ-
/tmp/repos
:> sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
שימו לב שאתם כוללים בפקודה הזו את הנתיב לספריית ה-repos.
- אפשר להשתמש ב-
apigee-service
כדי להתקין את כלי השירותapigee-setup
:> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- שימוש ב-
apigee-setup
כדי להתקין ולהגדיר רכיבי Edge בצומת. למידע נוסף, אפשר לקרוא את המאמר התקנת רכיבי Edge בצומת.
התקנה מהמאגר באמצעות שרת האינטרנט של Nginx:
- מתקינים את שרת האינטרנט של Nginx בצומת המאגר:
> opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
- כברירת מחדל, Nginx מוגדר להשתמש ב-localhost כשם השרת וביציאה 3939. כדי
לשנות את הערכים האלה:
- פתיחת
/opt/apigee/customer/application/mirror.properties
בעורך. אם הקובץ לא קיים, יוצרים אותו. - מגדירים את הערכים הבאים לפי הצורך:
conf_apigee_mirror_listen_port=3939 conf_apigee_mirror_server_name=localhost
- מפעילים מחדש את Nginx:
> /opt/nginx/scripts/apigee-nginx restart
- פתיחת
- כברירת מחדל, המאגר מחייב שם משתמש:סיסמה של
admin:admin
. כדי לשנות את פרטי הכניסה האלה, מגדירים את משתני הסביבה הבאים:MIRROR_USERNAME=uName MIRROR_PASSWORD=pWord
- מתקינים את
yum-utils
ואתyum-plugin-priorities
:> sudo yum install yum-utils > sudo yum install yum-plugin-priorities
- בצומת החדש, משביתים את SELinux כפי שמתואר למעלה.
- מפעילים מאגר EPEL כפי שמתואר למעלה.
- בצומת המרוחק, מורידים את הקובץ Edge bootrap_4.17.09.sh אל
/tmp/bootstrap_4.17.09.sh
:> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
uName:pWord הוא שם המשתמש והסיסמה שהגדרתם למעלה למאגר ו-remoteRepo הוא כתובת ה-IP או שם ה-DNS של צומת המאגר.
- בצומת המרוחק, מתקינים את תוכנת השירות
apigee-service
של Edge ואת יחסי התלות:> sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
כאשר uName:pWord הם שם המשתמש והסיסמה במאגר.
- בצומת המרוחק, יש להשתמש ב-
apigee-service
כדי להתקין את כלי השירותapigee-setup
:> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- שימוש ב-
apigee-setup
להתקנה ולהגדרה של רכיבי Edge בצומת המרוחק. למידע נוסף, אפשר לקרוא את המאמר התקנת רכיבי Edge בצומת.
עדכון מאגר Apigee מקומי
כדי לעדכן את המאגר, צריך להוריד את הקובץ shoestrap_4.17.09.sh האחרון ולאחר מכן לבצע סנכרון חדש:
- מורידים את הקובץ Edge bootrap_4.17.09.sh אל
/tmp/bootstrap_4.17.09.sh
:> curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
- מריצים את קובץ Edge
bootstrap_4.17.09.sh
:> sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord
uName:pWord הם שם המשתמש והסיסמה שקיבלת מ-Apigee. אם לא מזינים את הערך pWord, צריך להזין אותו.
- עדכון של
apigee-mirror
:> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
- לבצע את הסנכרון:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
- כדי להוריד את כל המאגר:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync
ניקוי מאגר Apigee מקומי
ניקוי המאגר המקומי יגרום למחיקה של /opt/apigee/data/apigee-mirror
ושל /var/tmp/yum-apigee-*
.
כדי לנקות את המאגר המקומי, משתמשים ב:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean
מוסיפים או מעדכנים את Edge 4.16.0x/4.17.0x במאגר של 4.17.09
אם אתם צריכים לשמור התקנות עבור Edge 4.16.0x או 4.17.01/4.17.05 במאגר של 4.17.09, תוכלו לתחזק מאגר שמכיל את כל הגרסאות. מהמאגר הזה תוכלו להתקין כל גרסה של Edge.
כדי להוסיף 4.16.0x/4.17.0x למאגר 4.17.09:
- יש לוודא שהתקנת את גרסה 4.17.09 של כלי השירות
apigee-mirror
:> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version
אמורה להופיע תוצאה בטופס שבהמשך, כאשר xyz הוא מספר ה-Build:
apigee-mirror-4.17.09-0.0.xyz
- משתמשים בכלי
apigee-mirror
כדי להוריד את Edge 4.16.0x/4.17.01/4.17/05 למאגר. שימו לב איך מוסיפים לפקודה את התחילית הרצויה:> apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
משתמשים בפקודה הזאת כדי לעדכן מאוחר יותר את המאגרים של 4.16.0x/4.17.05 על ידי ציון מספרי הגרסאות הדרושים.
- בודקים את הספרייה
/opt/apigee/data/apigee-mirror/repos
כדי לראות את מבנה הקבצים:> ls /opt/apigee/data/apigee-mirror/repos
הקבצים והספריות הבאים אמורים להופיע:
apigee apigee-repo-1.0-6.x86_64.rpm bootstrap_4.16.01.sh bootstrap_4.16.05.sh bootstrap_4.17.01.sh bootstrap_4.17.05.sh bootstrap_4.17.09.sh thirdparty
שימו לב שיש לכם קובץ אתחול לכל הגרסאות של Edge. הספרייה
apigee
מכילה גם ספריות נפרדות לכל גרסה של Edge. - כדי לארוז את המאגר בקובץ .tar, להשתמש בפקודה הבאה:
> apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
פקודה זו משלבת את כל המאגרים בגרסאות 4.17.0x ו-4.16.0x באותו קובץ .tar לא ניתן לארוז רק חלק מהמאגר.
כדי להתקין את Edge מקובץ ה-repo המקומי או ה-tar .חשוב להפעיל את קובץ ה-Bootstrap המתאים באמצעות אחת מהפקודות הבאות. בדוגמה הזו אפשר להתקין את Edge מגרסה 4.17.01:
- אם מתקינים מקובץ tar., מריצים את קובץ ה-Bootstrap המתאים מהמאגר:
> sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
כדי להשלים את ההתקנה, מבצעים את שאר השלבים בקטע 'התקנה מקובץ ה- .tar' שלמעלה.
- אם משתמשים בשרת האינטרנט של Nginx, צריך להוריד את קובץ ה-Bootstrap המתאים מהמאגר ואז להריץ אותו:
> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh > sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
כדי להשלים את ההתקנה, בצע את השלבים שנותרו בקטע 'התקנה מהמאגר באמצעות שרת האינטרנט של Nginx' שלמעלה.