התקנה של תוכנת השירות להגדרת קצה

Edge for Private Cloud v4.19.01

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

ספריית ההתקנה המוגדרת כברירת מחדל: /opt/apigee

Edge מתקין את כל הקבצים בספרייה /opt/apigee. לא ניתן לשנות את הספרייה הזו. עם זאת, אם רוצים, אפשר ליצור קישור סמלי כדי למפות את /opt/apigee למיקום אחר. מידע נוסף על דרישות התקנה.

דרישה מוקדמת: משביתים את SELinux

כדי להשתמש בכלי Edge apigee-setup או בכל רכיב אחר של Edge, צריך להשבית את SELinux או להגדיר אותו למצב אישור, במידת הצורך, אחרי ההתקנה של Edge אפשר להפעיל מחדש את SELinux.

  • כדי להגדיר את SELinux באופן זמני למצב מתיר גישה, מריצים את הפקודה הבאה:
    1. במערכת הפעלה Linux 6.x:
      sudo echo 0 > /selinux/enforce

      כדי להפעיל מחדש את SELinux אחרי ההתקנה של Edge:

      sudo echo 1 > /selinux/enforce
    2. במערכת הפעלה Linux 7.x:
      sudo setenforce 0

      כדי להפעיל מחדש את SELinux אחרי ההתקנה של Edge:

      sudo setenforce 1
  • כדי להשבית לצמיתות את SELinux או להעביר אותו למצב מתירי:
    1. יש לפתוח את /etc/sysconfig/selinux בעורך.
    2. הגדרת SELINUX=disabled או SELINUX=permissive
    3. שומרים את השינויים.
    4. מפעילים מחדש את הצומת.
    5. במידת הצורך, יש להפעיל מחדש את SELinux אחרי ההתקנה של Edge. לשם כך, צריך לחזור על התהליך הזה כדי להגדיר את SELINUX=enabled.

דרישה מוקדמת: הפעלת EPEL repo

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

בגרסאות 7.4 ו-CנוסtOS 7.4, כדאי לבדוק את הגרסה של libdb4 לאלף חשיפות לפני ההתקנה. Edge מחייב שימוש בגרסה 4.8 ובגרסאות מסוימות של RedHat 7.4 ובגרסה 7.4 של OSOS עם גרסה מאוחרת יותר. אם מותקנת גרסה מאוחרת יותר, צריך להסיר אותה ומתקינים את Edge. לאחר מכן, תתבצע התקנה של גרסה 4.8.

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

rpm -qa | grep libdb4

אם הגרסה של libdb4 ל-RPM מאוחרת יותר מגרסה 4.8, צריך להסיר אותה.

התקנה של כלי עזר להגדרת קצה מרוחק בצומת עם חיבור אינטרנט חיצוני

כדי להתקין את Edge בצומת עם חיבור אינטרנט חיצוני:

  1. משיגים את שם המשתמש והסיסמה מ-Apigee שבהם אתם משתמשים כדי לגשת למאגר Apigee. אם יש לך username:password קיים באתר של Apigee ftp, אפשר להשתמש בפרטי הכניסה האלה.
  2. כדי להתקין את ההכנסות לאלף חשיפות ב-Edge, צריך להתחבר לצומת
  3. מתקינים את yum-utils ואת yum-plugin-priorities:
    sudo yum install yum-utils
    sudo yum install yum-plugin-priorities
  4. משביתים את SELinux כפי שמתואר למעלה.
  5. יש להפעיל את מאגר ה-EPEL כפי שמתואר למעלה.
  6. בודקים את הגרסה של libdb4 שמתוארת למעלה.
  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. מורידים את קובץ ה-Edge של bootstrap_4.19.01.sh ל-/tmp/bootstrap_4.19.01.sh:
    curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
  10. מתקינים את השירות והשירות התלוי של Edge:
    sudo bash /tmp/bootstrap_4.19.01.sh apigeeuser=uName apigeepassword=pWord

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

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

    • I: התקנת OpenJDK 1.8 (ברירת מחדל)
    • ג: המשך בלי להתקין Java
    • שאלה: יציאה. לאפשרות זו, עליך להתקין את Java בעצמך.

    ההתקנה של כלי השירות apigee-service יוצרת את הקובץ /etc/yum.repos.d/apigee.repo שמגדיר את מאגר ה-Apigee. כדי להציג את קובץ ההגדרה, משתמשים בפקודה:

    cat /etc/yum.repos.d/apigee.repo

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

    sudo yum -v repolist 'apigee*'
  11. צריך להשתמש ב-apigee-service כדי להתקין את כלי ההתקנה של apigee:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  12. כדי להתקין ולהגדיר את רכיבי Edge בצומת צריך להשתמש בהגדרת API. מידע נוסף זמין במאמר התקנת רכיבי Edge בצומת.

התקנה של כלי להגדרת שירותים חיצוניים ב-Edge שבצומת ללא חיבור חיצוני לאינטרנט

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

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

יצירת מאגר מקומי של Apigee

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

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

כדי ליצור מאגר מקומי ב-Apigee:

  1. משיגים את שם המשתמש והסיסמה מ-Apigee שבהם אתם משתמשים כדי לגשת למאגר Apigee. אם יש לכם שם משתמש:סיסמה לאתר Apigee ftp, תוכלו להשתמש בפרטי הכניסה האלה.
  2. התחבר לשורש שלך כדי להתקין את RPM של Edge.
  3. משביתים את SELinux כפי שמתואר למעלה.
  4. מורידים את קובץ ה-Edge של bootstrap_4.19.01.sh ל-/tmp/bootstrap_4.19.01.sh:
    curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
  5. מתקינים את השירות והשירות התלוי של Edge:
    sudo bash /tmp/bootstrap_4.19.01.sh apigeeuser=uName apigeepassword=pWord

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

  6. מתקינים את תוכנית השירות apigee-mirror בצומת:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
  7. יש להשתמש בכלי השירות apigee-mirror כדי לסנכרן את מאגר Apigee לספרייה /opt/apigee/data/apigee-mirror/repos/.

    כדי להקטין את נפח המאגר, צריך לכלול את קובץ --only-new-rpms כדי להוריד רק את ההכנסות האחרונות לאלף חשיפות. גודל הקובץ הדרוש להורדה הוא כ-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 מהמאגר המקומי.

  8. (אופציונלי) אם רוצים להתקין את Edge מ-Repo המקומי באותו צומת שמארח את ה-repo המקומי, קודם כל צריך להריץ את הפקודות הבאות:
    1. מריצים את הפקודה bootstrap_4.19.01.sh מהמאגר המקומי כדי להתקין את הכלי apigee-service:
      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.19.01.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
    2. משתמשים ב-apigee-service כדי להתקין את כלי השירות apigee-setup:
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    3. יש להשתמש ב-apigee-setup כדי להתקין ולהגדיר רכיבי Edge בצומת. מידע נוסף זמין במאמר התקנת רכיבים של צומת בצומת.

התקנה של התקנה מרחוק דרך צומת מרוחק מהמאגר המקומי

יש שתי אפשרויות להתקנת Edge מהמאגר המקומי. תוכלו לבחור באחת מהאפשרויות הבאות:

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

התקנה מקובץ ה- .tar

כדי להתקין את הקובץ מקובץ ה-tar:

  1. בצומת עם ה-Repo המקומי, משתמשים בפקודה הבאה כדי לאגד את ה-repo המקומי בקובץ .tar אחד בשם /opt/apigee/data/apigee-mirror/apigee-4.19.01.tar.gz:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
  2. מעתיקים את קובץ ה- .tar לצומת שבו רוצים להתקין את Edge. לדוגמה, אפשר להעתיק אותו לספרייה /tmp בצומת החדש.
  3. בצומת החדש, השביתו את SELinux כמתואר.
  4. בצומת החדש, חשוב לוודא שיש לך גישה למאגר המקומי של Yum ולמאגר ה-EPEL.
  5. חשוב לוודא שכל היציאות החיצוניות באינטרנט מושבתות (יכול להיות שהסיבה לכך היא שמתבצעת התקנה במחשב ללא גישה לאינטרנט):
    sudo yum repolist

    יש להשבית את כל המאגרים החיצוניים, אבל את המאגר המקומי של Apigee ואת המאגר הפנימי שלך צריך להפעיל.

  6. בצומת החדש, מתקינים את yum-utils ואת yum-plugin-priorities מהמאגר המקומי:
    sudo yum install yum-utils
    sudo yum install yum-plugin-priorities

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

  7. בצומת החדש, בדוק את הגרסה של libdb4 כפי שמתואר למעלה.
  8. אם אתם מתקינים את הדפדפן ב-Oracle 7.x, מריצים את הפקודה הבאה:
    sudo yum-config-manager --enable ol7_optional_latest
  9. אם אתם מתקינים את AWS, מריצים את הפקודה yum-configure-manager הבאה:
    sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  10. בצומת החדש, מבטלים את ההעברה של הקובץ לספרייה /tmp:
    tar -xzf apigee-4.19.01.tar.gz

    הפקודה הזו יוצרת ספרייה חדשה בשם repos בספרייה שמכילה את הקובץ tar. לדוגמה: /tmp/repos.

  11. מתקינים את השירות והשירות התלוי של Edge מ-/tmp/repos:
    sudo bash /tmp/repos/bootstrap_4.19.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    שימו לב שאתם כוללים את הנתיב לספריית התיקיות בפקודה הזו.

  12. משתמשים ב-apigee-service כדי להתקין את כלי השירות apigee-setup:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  13. יש להשתמש ב-apigee-setup כדי להתקין ולהגדיר רכיבי Edge בצומת. מידע נוסף זמין במאמר התקנת רכיבים של צומת בצומת.

התקנה מ-repo באמצעות שרת האינטרנט Nginx

כדי להתקין מ-Repo באמצעות שרת האינטרנט Nginx:

  1. התקנה של שרת האינטרנט Nginx בצומת ה-Repo:
    opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
  2. כברירת מחדל, Nginx מוגדר להשתמש ב-localhost בתור שם השרת ויציאה 3939. כדי לשנות את הערכים האלה:
    1. יש לפתוח את /opt/apigee/customer/application/mirror.properties בעורך. אם הקובץ לא קיים, יש ליצור אותו.
    2. מגדירים את הערכים הבאים לפי הצורך:
      conf_apigee_mirror_listen_port=3939
      conf_apigee_mirror_server_name=localhost
    3. מפעילים מחדש את Nginx:
      /opt/nginx/scripts/apigee-nginx restart
  3. כברירת מחדל, מערכת ה-Repo דורשת שם משתמש:סיסמה של admin:admin. כדי לשנות את פרטי הכניסה האלה, צריך להגדיר את משתני הסביבה הבאים:
    MIRROR_USERNAME=uName
    MIRROR_PASSWORD=pWord
  4. בצומת החדש, מתקינים את yum-utils ואת yum-plugin-priorities:
    sudo yum install yum-utils
    sudo yum install yum-plugin-priorities
  5. בצומת החדש, השביתו את SELinux כמתואר.
  6. בצומת החדש, מוודאים שמאגר EPEL המקומי מופעל.
  7. בצומת החדש, בדוק את הגרסה של libdb4 כפי שמתואר למעלה.
  8. בצומת המרוחק, מורידים את הקובץ Edge shoestrap_4.19.01.sh אל /tmp/bootstrap_4.19.01.sh:
    curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh

    כאשר uName:pWord הוא שם המשתמש והסיסמה שהגדרת עבור ה-Repo, ו-remoteRepo היא כתובת ה-IP או שם ה-DNS של צומת המאגר.

  9. בצומת המרוחק, מתקינים את כלי השירות של Edge apigee-service ואת יחסי התלות:
    sudo bash /tmp/bootstrap_4.19.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

    כאשר uName:pWord הוא שם המשתמש והסיסמה של ה-Repo.

  10. בצומת המרוחק, משתמשים ב-apigee-service כדי להתקין את כלי השירות של apigee-setup:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  11. יש להשתמש ב-apigee-setup כדי להתקין ולהגדיר רכיבי Edge בצומת המרוחק. מידע נוסף זמין במאמר התקנת רכיבי Edge בצומת.

עדכון של מאגר Apigee מקומי

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

כדי לעדכן את הנכס:

  1. מורידים את קובץ אתחול ה-Edge: 4.19.01.sh ל-/tmp/bootstrap_4.19.01.sh:
    curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
  2. מריצים את קובץ bootstrap_4.19.01.sh של Edge:
    sudo bash/tmp/bootstrap_4.19.01.sh apigeeuser=uName apigeepassword=pWord

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

  3. עדכון של apigee-mirror:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
  4. עורכים את הסנכרון:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
  5. אם רוצים לבצע את כל הפעולות הנדרשות:
    /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.19.01

אם אתם צריכים לתחזק התקנות של Edge 4.16.0x או 4.17.0x במאגר 4.19.01, תוכלו לשמור מאגר הכולל את כל הגרסאות. ממאגר זה תוכלו להתקין כל גרסה של Edge.

להוספת פי 4.16.0/4.17.0x למאגר 4.19.01:

  1. לוודא שהתקנת את גרסה 4.19.01 של כלי apigee-mirror:
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version

    התוצאה אמורה להופיע בטופס שבהמשך, כאשר xyz הוא מספר ה-build:

    apigee-mirror-4.19.01-0.0.xyz
  2. כדי להוריד את Edge 4.16.0x/4.17.0x למאגר, צריך להשתמש בכלי apigee-mirror. שימו לב איך מוסיפים את הפקודה לגרסה הרצויה:
    apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

    משתמשים בפקודה הזו כדי לעדכן את המאגר 4.16.0x/4.17.0x מאוחר יותר, על ידי ציון מספרי הגרסאות הנדרשים.

  3. בודקים את הספרייה של /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
    bootstrap_4.18.01.sh
    bootstrap_4.18.05.sh
    bootstrap_4.19.01.sh
    thirdparty

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

  4. כדי לאגד את המאגר בקובץ .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 המקומי, צריך רק להפעיל את קובץ ה-restrap הנכון באמצעות אחת מהפקודות הבאות. דוגמה זו מתקינה את Edge 4.17.01:

  • אם מתקינים מקובץ tar., מריצים את קובץ ה-retoutrap הנכון מתוך המאגר:
    sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    להשלמת ההתקנה, פועלים לפי השלבים שמפורטים למעלה בקטע "התקנה מקובץ ה- .tar" שלמעלה.

  • אם מתקינים באמצעות שרת האינטרנט Nginx, מורידים את קובץ ה-restrap הנכון ומפעילים אותו מהמאגר:
    /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" שלמעלה.