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

Edge for Private Cloud גרסה 4.18.05

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

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

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

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

כדי להתקין את Edge, צריך להשבית את SELinux או להגדיר אותו למצב מתירני חבילת שירות apigee-setup או כל דפדפן Edge רכיבים. במקרה הצורך, אחרי שמתקינים את 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. אם יש צורך, לאחר התקנת Edge מפעילים מחדש את SELinux על ידי חזרה על התהליך הזה כדי הגדרה של 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, צריך לבדוק את הגרסה של libdb4 ההכנסות לאלף חשיפות (RPM) לפני ההתקנה. קצה לשם כך נדרשת גרסה 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. אם יש לכם שם משתמש:password עבור אתר ה-ftp של Apigee, תוכלו להשתמש ב פרטי הכניסה.
  2. כדי להתקין את ה-RPM ב-Edge
    , צריך להתחבר לצומת בתור הרמה הבסיסית (root)
  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.18.05.sh אל /tmp/bootstrap_4.18.05.sh: 
    curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
  10. מתקינים את כלי השירות ואת יחסי התלות של Edge apigee-service: 
    sudo bash /tmp/bootstrap_4.18.05.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-setup:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  12. שימוש ב-apigee-setup כדי להתקין ולהגדיר רכיבי Edge בצומת. למידע נוסף, ראו התקנת רכיבי Edge בצומת.

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

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

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

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

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

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

  1. מקבלים את שם המשתמש והסיסמה מ-Apigee שבהם משתמשים כדי לגשת למאגר של Apigee. אם יש לכם שם משתמש:password עבור אתר ה-ftp של Apigee, תוכלו להשתמש ב פרטי הכניסה.
  2. כדי להתקין את ההכנסות לאלף חשיפות ב-Edge, צריך להתחבר לצומת בתור הרמה הבסיסית (root).
  3. משביתים את SELinux כפי שמתואר למעלה.
  4. מורידים את קובץ Edge bootstrap_4.18.05.sh אל /tmp/bootstrap_4.18.05.sh: 
    curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
  5. התקנה של תוכנית השירות ויחסי התלות של Edge apigee-service: 
    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 כדי להוריד רק את ההכנסות האחרונות לאלף חשיפות. כדי להוריד את האפליקציה, צריך נפח אחסון של כ-1.6GB:

    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

    אם רוצים להוריד את כל המאגר, כולל הכנסות ישנות יותר לאלף חשיפות, צריך להשמיט את --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-setup, צריך להשתמש ב-apigee-service: 
      /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. מתקינים את כלי השירות ואת יחסי התלות של Edge apigee-service מ-/tmp/repos: 
    sudo bash /tmp/repos/bootstrap_4.18.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

  12. כדי להתקין את כלי השירות apigee-setup, צריך להשתמש ב-apigee-service: 
    /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. בצומת המרוחק, מורידים את קובץ Edge bootrap_4.18.05.sh כדי /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

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

  1. מורידים את הקובץ Edge bootrap_4.18.05.sh אל /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 and /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, לנהל מאגר שמכיל את כל הגרסאות. מהמאגר הזה אפשר להתקין כל גרסה של קצה.

כדי להוסיף את 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

    שימו לב שיש קובץ אתחול לכל הגרסאות של 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., מריצים את קובץ ה-bootrap הנכון מהמאגר:
    sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

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