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

Edge for Private Cloud גרסה 4.19.01

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

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

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

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

כדי להתקין את תוכנית השירות apigee-setup של Edge או כל רכיבי 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 עם גרסה מאוחרת יותר. אם יש לך גרסה מאוחרת יותר, צריך להסיר אותה, ומנהל ההתקנה של Edge יתקין את גרסה 4.8.

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

rpm -qa | grep libdb4

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

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

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

  1. משיגים את שם המשתמש והסיסמה מ-Apigee, שבאמצעותם ניתן לגשת למאגר Apigee. אם יש לך username:password קיים לאתר ה-ftp של Apigee, אפשר להשתמש בפרטי הכניסה האלה.
  2. מתחברים לצומת בתור root כדי להתקין את Edge RPM
  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 apigee: 
    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. משתמשים בשירות API כדי להתקין את כלי העזר apigee-setup:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  12. השתמש ב-apigee-setup כדי להתקין ולהגדיר רכיבי Edge בצומת. למידע נוסף, אפשר לקרוא את המאמר על התקנת רכיבי Edge בצומת.

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

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

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

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

כדי ליצור את מאגר Apigee הפנימי, צריך צומת עם גישה חיצונית לאינטרנט כדי להוריד את יחסי התלות וה-RPM של 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 apigee: 
    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 כדי להוריד רק את ה-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.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 בצומת.

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

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

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

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

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

  1. בצומת עם המאגר המקומי, משתמשים בפקודה הבאה כדי לארוז את המאגר המקומי בקובץ .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 apigee מ-/tmp/repos: 
    sudo bash /tmp/repos/bootstrap_4.19.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

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

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

כדי להתקין מהמאגר באמצעות שרת האינטרנט של 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. בצומת המרוחק, מורידים את הקובץ 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 הוא שם המשתמש והסיסמה שהגדרת למעלה למאגר, ו-remoteRepo הוא כתובת ה-IP או שם ה-DNS של צומת המאגר.

  9. בצומת המרוחק, מתקינים את תוכנת השירות apigee-service של Edge ואת יחסי התלות: 
    sudo bash /tmp/bootstrap_4.19.01.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 מקומי

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

כדי לעדכן את המאגר:

  1. מורידים את הקובץ Edge bootrap_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. מריצים את קובץ Edge bootstrap_4.19.01.sh: 
    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.0x/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. משתמשים בכלי 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.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 .חשוב להפעיל את קובץ ה-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' שלמעלה.