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

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 למצב מתיר באופן זמני, מריצים את הפקודה הבאה:
    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

עליכם להפעיל חבילות נוספות ל-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

אם צריך להוריד את ההכנסות האלה לאלף חשיפות, אפשר להוריד אותן מהנכסים הבאים:

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

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

  1. משיגים את שם המשתמש והסיסמה מ-Apigee, שבאמצעותם ניתן לגשת למאגר Apigee. אם יש לכם שם משתמש:סיסמה לאתר Apigee ftp, ניתן להשתמש בפרטי הכניסה האלה.
  2. מתחברים לצומת בתור הבסיס כדי להתקין את ה-RPM של Edge.
  3. מתקינים את yum-utils ואת yum-plugin-priorities:
    > sudo yum install yum-utils
    > sudo yum install yum-plugin-priorities
  4. משביתים את SELinux כפי שמתואר למעלה.
  5. מפעילים מאגר EPEL כפי שמתואר למעלה.
  6. אם מתקינים ב-AWS, מריצים את הפקודה yum-configure-manager הבאה:
    > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  7. מורידים את קובץ 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
  8. מתקינים את תוכנת העזר ואת יחסי התלות של שירות 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*'
  9. צריך להשתמש ב-apigee-service כדי להתקין את כלי השירות apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  10. שימוש ב-apigee-setup להתקנה ולהגדרה של רכיבי Edge בצומת. למידע נוסף, אפשר לקרוא את המאמר התקנת רכיבי Edge בצומת.

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

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

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

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

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

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

  1. משיגים את שם המשתמש והסיסמה מ-Apigee, שבאמצעותם ניתן לגשת למאגר Apigee. אם יש לכם שם משתמש:סיסמה לאתר Apigee ftp, ניתן להשתמש בפרטי הכניסה האלה.
  2. מתחברים לצומת בתור הבסיס כדי להתקין את ה-RPM של Edge.
  3. מתקינים את yum-utils ואת yum-plugin-priorities:
    > sudo yum install yum-utils
    > sudo yum install yum-plugin-priorities
  4. משביתים את SELinux כפי שמתואר למעלה.
  5. מפעילים מאגר EPEL כפי שמתואר למעלה.
  6. אם מתקינים ב-AWS, מריצים את הפקודה yum-configure-manager הבאה:
    > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  7. מורידים את קובץ 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
  8. מתקינים את תוכנת העזר ואת יחסי התלות של Edge apigee-service:
    > sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord

    uName:pWord הם שם המשתמש והסיסמה שקיבלת מ-Apigee. אם לא מזינים את הערך pWord, צריך להזין אותו.

  9. מתקינים את הכלי apigee-mirror בצומת:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
  10. אפשר להשתמש בכלי העזר 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 מהמאגר המקומי.

  11. (אופציונלי) אם רוצים להתקין את Edge מהמאגר המקומי באותו צומת שמארח את המאגר המקומי, צריך קודם להריץ את הפקודות הבאות:
    1. מריצים את הפקודה 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
    2. צריך להשתמש ב-apigee-service כדי להתקין את כלי השירות apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    3. שימוש ב-apigee-setup להתקנה ולהגדרה של רכיבי Edge בצומת. למידע נוסף, אפשר לקרוא את המאמר התקנת רכיבי Edge בצומת.

התקנת apigee-setup בצומת מרוחק מהמאגר המקומי

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

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

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

  1. בצומת עם המאגר המקומי, משתמשים בפקודה הבאה כדי לארוז את המאגר המקומי בקובץ .tar אחד בשם /opt/apigee/data/apigee-mirror/apigee-4.17.09.tar.gz:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
  2. מעתיקים את קובץ ה- .tar לצומת שבו רוצים להתקין את Edge. לדוגמה, מעתיקים אותו לספרייה /tmp בצומת החדש.
  3. מתקינים את yum-utils ואת yum-plugin-priorities:
    > sudo yum install yum-utils
    > sudo yum install yum-plugin-priorities
  4. בצומת החדש, משביתים את SELinux כפי שמתואר למעלה.
  5. מפעילים מאגר EPEL כפי שמתואר למעלה.
  6. בצומת החדש, מבטלים את קיומו של הקובץ לספרייה /tmp:
    > tar -xzf apigee-4.17.09.tar.gz

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

  7. מתקינים את תוכנת העזר ואת יחסי התלות של שירות Edge apigee מ-/tmp/repos:
    > sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

  8. אפשר להשתמש ב-apigee-service כדי להתקין את כלי השירות apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  9. שימוש ב-apigee-setup כדי להתקין ולהגדיר רכיבי Edge בצומת. למידע נוסף, אפשר לקרוא את המאמר התקנת רכיבי Edge בצומת.

התקנה מהמאגר באמצעות שרת האינטרנט של Nginx:

  1. מתקינים את שרת האינטרנט של Nginx בצומת המאגר:
    > 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. כברירת מחדל, המאגר מחייב שם משתמש:סיסמה של 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. בצומת המרוחק, מורידים את הקובץ 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 של צומת המאגר.

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

    כאשר uName:pWord הם שם המשתמש והסיסמה במאגר.

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

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

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

  1. מורידים את הקובץ 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
  2. מריצים את קובץ Edge bootstrap_4.17.09.sh:
    > sudo bash /tmp/bootstrap_4.17.09.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.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:

  1. יש לוודא שהתקנת את גרסה 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
  2. משתמשים בכלי 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 על ידי ציון מספרי הגרסאות הדרושים.

  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
    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 .חשוב להפעיל את קובץ ה-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' שלמעלה.