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

Edge for Private Cloud v4.18.05

כדי להתקין את Edge בצומת, קודם מתקינים את כלי השירות apigee-setup של 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 באופן סופי או להגדיר אותו למצב permissive:
    1. פותחים את /etc/sysconfig/selinux בכלי לעריכת טקסט.
    2. הגדרה של SELINUX=disabled או SELINUX=permissive
    3. שומרים את השינויים.
    4. מפעילים מחדש את הצומת.
    5. במקרה הצורך, מפעילים מחדש את SELinux אחרי ההתקנה של Edge. כדי לעשות את זה, חוזרים על התהליך הזה ומגדירים את SELINUX=enabled.

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

כדי להתקין או לעדכן את Edge, או כדי ליצור מאגר מקומי, צריך להפעיל את Extra Packages for 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 וב-CentOS 7.4

ב-RedHat 7.4 וב-CentOS 7.4, צריך לבדוק את גרסת ה-RPM של libdb4 לפני ההתקנה. ‫Edge דורש את גרסה 4.8, וחלק מהגרסאות של RedHat 7.4 ו-CentOS 7.4 מגיעות עם גרסה מאוחרת יותר. אם יש לכם גרסה עדכנית יותר, הסירו אותה ואז תוכנת ההתקנה של Edge תתקין את גרסה 4.8.

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

rpm -qa | grep libdb4

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

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

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

  1. משיגים מ-Apigee את שם המשתמש והסיסמה שמשמשים לגישה למאגר של Apigee. אם כבר יש לכם שם משתמש וסיסמה לאתר ה-FTP של Apigee, אתם יכולים להשתמש בפרטי הכניסה האלה.
  2. מתחברים לצומת כמשתמש root כדי להתקין את חבילות ה-RPM של 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. מורידים את הקובץ bootstrap_4.18.05.sh של Edge אל /tmp/bootstrap_4.18.05.sh: 
    curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
  10. מתקינים את כלי השירות apigee-service של Edge ואת יחסי התלות: 
    sudo bash /tmp/bootstrap_4.18.05.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 בעצמכם.

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

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

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

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

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

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

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

  1. משיגים מ-Apigee את שם המשתמש והסיסמה שמשמשים לגישה למאגר של Apigee. אם כבר יש לכם שם משתמש וסיסמה לאתר ה-FTP של Apigee, אתם יכולים להשתמש בהם.
  2. כדי להתקין את חבילות ה-RPM של Edge, מתחברים לצומת כמשתמש root.
  3. משביתים את SELinux כמו שמתואר למעלה.
  4. מורידים את הקובץ bootstrap_4.18.05.sh של Edge אל /tmp/bootstrap_4.18.05.sh: 
    curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
  5. מתקינים את כלי השירות apigee-service של Edge ואת יחסי התלות: 
    sudo bash /tmp/bootstrap_4.18.05.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 כדי להוריד רק את קובצי ה-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 מהמאגר המקומי.

  8. (אופציונלי) אם רוצים להתקין את Edge מהמאגר המקומי באותו צומת שמארח את המאגר המקומי, צריך קודם להריץ את הפקודות הבאות:
    1. מריצים את bootstrap_4.18.05.sh מהמאגר המקומי כדי להתקין את הכלי apigee-service: 
      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.18.05.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.18.05.tar.gz: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
  2. מעתיקים את קובץ ה-‎ .tar לצומת שבו רוצים להתקין את Edge. לדוגמה, מעתיקים אותו לספרייה /tmp בצומת החדש.
  3. בצומת החדש, משביתים את SELinux כמו שמתואר למעלה.
  4. בצומת החדש, מפעילים את מאגר EPEL כמו שמתואר למעלה.
  5. בצומת החדש, מוודאים שהשבתתם את כל מאגרי האינטרנט החיצוניים. כשמריצים את הפקודה הבאה, כל המאגרים החיצוניים אמורים להיות מושבתים, אבל המאגר המקומי של Apigee וכל המאגרים הפנימיים אמורים להיות מופעלים: 
    sudo yum repolist
  6. בצומת החדש, מתקינים את yum-utils ואת yum-plugin-priorities: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  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.18.05.tar.gz

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

  11. מתקינים את כלי השירות apigee-service של Edge ואת יחסי התלות מ-/tmp/repos: 
    sudo bash /tmp/repos/bootstrap_4.18.05.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 בצומת. מידע נוסף זמין במאמר התקנת רכיבי 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. בצומת החדש, בודקים את הגרסה של libdb4 כמו שמתואר למעלה.
  8. בצומת המרוחק, מורידים את הקובץ bootstrap_4.18.05.sh של Edge אל /tmp/bootstrap_4.18.05.sh: 
    curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh

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

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

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

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

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

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

  1. מורידים את הקובץ bootstrap_4.18.05.sh של Edge אל /tmp/bootstrap_4.18.05.sh: 
    curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
  2. מריצים את קובץ ה-Edge bootstrap_4.18.05.sh: 
    sudo bash/tmp/bootstrap_4.18.05.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.18.05

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

כדי להוסיף את 4.16.0x/4.17.0x למאגר 4.18.05:

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

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

    apigee-mirror-4.18.05-0.0.xyz
  2. משתמשים בכלי apigee-mirror כדי להוריד את Edge 4.16.0x/4.17.0x למאגר. שימו לב שמוסיפים לפקודה את הקידומת של הגרסה הרצויה: 
    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.05.sh
thirdparty

    שימו לב שיש לכם קובץ Bootstrap לכל הגרסאות של 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 מהמאגר המקומי או מקובץ ‎ .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" שלמעלה.