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

Edge for Private Cloud גרסה 4.17.09

כדי להתקין את 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 עם משלוח גרסה מאוחרת יותר.

אפשר לבדוק את הגרסה באמצעות הפקודה הבאה:

> rpm -qa | grep libdb

אם רואים שהגרסה של libdb4 לאלף צפיות (RPM) מאוחרת יותר מגרסה 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

אם אתם צריכים להוריד את נתוני ה-RPM האלה, תוכלו לקבל אותם מ:

• http://dl.fedoraproject.org/pub/epel/7/x86_64/Packages/l/libdb4-cxx-4.8.30-13.el7.x86_64.rpm
• http://dl.fedoraproject.org/pub/epel/7/x86_64/Packages/l/libdb4-4.8.30-13.el7.x86_64.rpm

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

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

1. מקבלים את שם המשתמש והסיסמה מ-Apigee שבהם משתמשים כדי לגשת למאגר של Apigee. אם יש לכם שם משתמש:password עבור אתר ה-ftp של Apigee, תוכלו להשתמש ב פרטי הכניסה.
2. כדי להתקין את ההכנסות לאלף חשיפות ב-Edge, צריך להתחבר לצומת בתור הרמה הבסיסית (root)
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, תתבקשו להזין אותו.

   כברירת מחדל, מנהל ההתקנה בודק אם התקנתם את Java 1.8. אם לא, יתקין אותו בשבילך. יש להשתמש באפשרות JAVA_FIX כדי לציין איך לטפל התקנת Java. JAVA_FIX מקבל את הערכים הבאים:

   • I = התקנת OpenJDK 1.8 (ברירת מחדל)
   • C = המשך בלי להתקין Java
   • שאלה = יציאה. כדי להשתמש באפשרות הזו, תצטרכו להתקין Java בעצמכם.

   ההתקנה של כלי השירות apigee-service יוצרת את הקובץ /etc/yum.repos.d/apigee.repo שמגדיר את המאגר של Apigee. כדי להציג את קובץ ההגדרה, משתמשים בפקודה:

   > cat /etc/yum.repos.d/apigee.repo

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

   > sudo yum -v repolist 'apigee*'

9. כדי להתקין את כלי השירות apigee-setup, צריך להשתמש ב-apigee-service:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

10. אפשר להשתמש ב-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. התקנת 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

    אם רוצים להוריד את כל המאגר, כולל הכנסות ישנות יותר לאלף חשיפות, צריך להשמיט את --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-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.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-service מ-/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 shoestrap_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

כדי לעדכן את המאגר, צריך להוריד את הקובץ bootrap_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 מהמאגר המקומי או מקובץ ה- .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 למעלה.