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

כדי להתקין את 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. אם יש לכם username: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.19.06.sh אל /tmp/bootstrap_4.19.06.sh:

   curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh

10. מתקינים את כלי השירות ואת יחסי התלות של Edge apigee-service:

    sudo bash /tmp/bootstrap_4.19.06.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 בצומת.

פתרון בעיות

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

Cannot open: https:// : @ software.apigee.com//apigee-repo-version.rpm

bootstrap.sh: Error: Repo configuration failed

error: package package_name is not installed

בטבלה הבאה מפורטות כמה פתרונות אפשריים לשגיאות האלה:

nc -v software.apigee.com 443

Connection to software.apigee.com 443 port [tcp/https] succeeded!

telnet software.apigee.com 443

curl -i -u username:password https://software.apigee.com/apigee-repo.rpm

echo $http_proxy
echo $https_proxy

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

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

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

• מאגר Apigee Edge: כפי שמתואר ב ליצור מאגר Apigee מקומי.
• מאגר Yum (לכלים כמו yum-utils ו- yum-plugin-priorities): צוות התפעול שלך אמור להיות מסוגל להגדיר זאת עבורך.
• חבילות נוספות עבור Enterprise Linux (או EPEL): צוות התפעול שלכם אמור להיות מסוגל להגדיר זאת בשביל את/ה.

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

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

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

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

1. מקבלים את שם המשתמש והסיסמה מ-Apigee שבהם משתמשים כדי לגשת למאגר של Apigee. אם יש לכם שם משתמש:password עבור אתר ה-ftp של Apigee, תוכלו להשתמש ב פרטי הכניסה.
2. כדי להתקין את ההכנסות לאלף חשיפות ב-Edge, צריך להתחבר לצומת בתור הרמה הבסיסית (root).
   
3. משביתים את SELinux כפי שמתואר למעלה.
4. מורידים את קובץ Edge bootstrap_4.19.06.sh אל /tmp/bootstrap_4.19.06.sh:

   curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh

5. התקנה של תוכנית השירות ויחסי התלות של Edge apigee-service:
   

   sudo bash /tmp/bootstrap_4.19.06.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.19.06.sh מהמאגר המקומי כדי להתקין את תוכנית השירות apigee-service:

      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.19.06.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

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

1. בצומת עם המאגר המקומי, משתמשים בפקודה הבאה כדי לארוז את המאגר המקומי קובץ tar יחיד בשם /opt/apigee/data/apigee-mirror/apigee-4.19.06.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.06.tar.gz

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

11. מתקינים את כלי השירות ואת יחסי התלות של Edge apigee-service מ-/tmp/repos:

    sudo bash /tmp/repos/bootstrap_4.19.06.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

כדי להתקין מהמאגר באמצעות שרת האינטרנט 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.19.06.sh כדי /tmp/bootstrap_4.19.06.sh:

   curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh

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

9. בצומת המרוחק, מתקינים את כלי השירות apigee-service ואת יחסי התלות של Edge:

   sudo bash /tmp/bootstrap_4.19.06.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

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

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

1. מורידים את הקובץ Edge bootrap_4.19.06.sh אל /tmp/bootstrap_4.19.06.sh:

   curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh

2. מריצים את קובץ Edge bootstrap_4.19.06.sh:

   sudo bash/tmp/bootstrap_4.19.06.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.19.06

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

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

1. חשוב לוודא שהתקנת את הגרסה 4.19.06 של apigee-mirror תוכנית שירות:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version

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

   apigee-mirror-4.19.06-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 מהמאגר המקומי או מקובץ ה- .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 למעלה.