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

Edge for Private Cloud גרסה 4.18.01

כדי להתקין את 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, צריך לבדוק את גרסת ה-RPM libdb4 לפני ההתקנה. קצה לשם כך נדרשת גרסה 4.8 וחלק מהגרסאות של RedHat 7.4 ו-CentOS 7.4 עם משלוח גרסה מאוחרת יותר. אם מותקנת במכשיר גרסה מאוחרת יותר, מסירים אותה ומנהל ההתקנה של Edge: לאחר מכן מתקינים את גרסה 4.8.

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

> rpm -qa | grep libdb4

אם רואים שהגרסה של ההכנסה לאלף חשיפות libdb4 מאוחרת יותר מהגרסה 4.8, הסרת ההתקנה.

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

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

1. מקבלים את שם המשתמש והסיסמה מ-Apigee שבהם משתמשים כדי לגשת למאגר של Apigee. אם יש לכם שם משתמש:password עבור אתר ה-ftp של Apigee, תוכלו להשתמש ב פרטי הכניסה.
2. כדי להתקין את ה-RPM ב-Edge
   , צריך להתחבר לצומת בתור הרמה הבסיסית (root) הערה: התקנת RPM מחייבת גישה לרמה הבסיסית (root), אבל אפשר להשתמש ב-Edge ללא גישה לרמה הבסיסית (root).
3. מתקינים את yum-utils ואת yum-plugin-priorities:
   > sudo yum התקנת yum-utils
   > עדיפות להתקנת sudo yum yum-plugin
4. משביתים את SELinux כפי שמתואר למעלה.
5. מפעילים מאגר EPEL כמו שמתואר למעלה.
6. בודקים את הגרסה של libdb4 כפי שמתואר למעלה.
7. אם אתם מתקינים ב-Oracle 7.x, מריצים את הפקודה הבאה:
   > sudo yum-config-manager --enable ol7_optional_latest
8. אם אתם מתקינים ב-AWS, מריצים את הפקודות הבאות yum-configure-manager:
   > עדכון יאמי rh-amazon-rhui-client.noarch
   > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
9. מורידים את קובץ bootstrap_4.18.01.sh של Edge אל bootstrap_4.18.01.sh:
   > תלתל https://software.apigee.com/shoestrap_4.18.01.sh -o /tmp/shoestrap_4.18.01.sh
10. התקנה של תוכנית השירות ויחסי התלות של Edge apigee-service:
    > sudo bash /tmp/shoestrap_4.18.01.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. כדי להציג את קובץ ההגדרה, משתמשים בפקודה:
    > חתול /etc/yum.repos.d/apigee.repo
    
    כדי לצפות בתוכן של המאגר, משתמשים בפקודה:
    > מאגר sudo yum -v '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 עבור בתהליך ההתקנה.

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

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

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

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

1. מקבלים את שם המשתמש והסיסמה מ-Apigee שבהם משתמשים כדי לגשת למאגר של Apigee. אם יש לכם שם משתמש:password עבור אתר ה-ftp של Apigee, תוכלו להשתמש ב פרטי הכניסה.
2. כדי להתקין את ההכנסות לאלף חשיפות ב-Edge, צריך להתחבר לצומת בתור הרמה הבסיסית (root).
   הערה: התקנת RPM מחייבת גישה לרמה הבסיסית (root), אבל אפשר להשתמש ב-Edge ללא גישה לרמה הבסיסית (root).
3. משביתים את SELinux כפי שמתואר למעלה.
4. מורידים את קובץ bootstrap_4.18.01.sh של Edge אל bootstrap_4.18.01.sh:
   > תלתל https://software.apigee.com/shoestrap_4.18.01.sh -o /tmp/shoestrap_4.18.01.sh
5. התקנה של תוכנית השירות ויחסי התלות של Edge apigee-service:
   > sudo bash /tmp/shoestrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord
   
   כאשר uName:pWord הם שם המשתמש והסיסמה שקיבלתם ב-Apigee. אם משמיטים את המילה pWord, תתבקשו להזין אותה.
6. מתקינים את apigee-mirror כלי עזר בצומת:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror התקנה
   
   הערה: אם מעדכנים מאגר קיים ל-4.18.01, צריך רק לעדכן אותו. apigee-mirror:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
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
   
   אם רוצים להוריד את המאגר כולו, כולל הכנסה ישנה יותר לאלף חשיפות, צריך להשמיט --only-new-rpms. נדרשות כ-6 GB משטח האחסון להורדה המלאה:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync
   
   עכשיו יש לכם עותק מקומי של המאגר של Apigee. הקטע הבא מתאר איך להתקין את שירות apigee-setup מ- המאגר המקומי.
8. (אופציונלי) אם רוצים להתקין את Edge מהמאגר המקומי בצומת שמארח את המאגר המקומי, צריך קודם להריץ את הפקודות הבאות:
   1. מריצים את bootstrap_4.18.01.sh מהאחסון המקומי repo כדי להתקין את כלי השירות apigee-service:
      > sudo bash /opt/apigee/data/apigee-mirror/repos/shoestrap_4.18.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 installation
   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.01.tar.gz:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
2. מעתיקים את קובץ ה- .tar לצומת שבו רוצים להתקין את Edge. לדוגמה, מעתיקים אותו הספרייה /tmp בקובץ החדש .
3. בצומת החדש, משביתים את SELinux כפי שמתואר למעלה.
4. בצומת החדש, מפעילים מאגר EPEL כמו שמתואר למעלה.
5. בצומת החדש, מוודאים שהשבתה של כל מאגרי האינטרנט החיצוניים. כשמריצים את הפקודה הבאה, כל המאגרים החיצוניים אמורים להופיע כמושבתים. אבל צריך להפעיל את המאגר המקומי של Apigee וכל אחד מהמאגרים הפנימיים שלך:
   > sudo מאגר יאמי
6. בצומת החדש, מתקינים את yum-utils ואת העדיפות של yum-plugin:
   > סודו יאם התקנה של yum-utils
   > עדיפות להתקנת sudo yum yum-plugin
7. בצומת החדש, בודקים את הגרסה של libdb4 כפי שמתואר למעלה.
8. אם אתם מתקינים ב-Oracle 7.x, מריצים את הפקודה הבאה:
   > sudo yum-config-manager --enable ol7_optional_previous
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.01.tar.gz
    
    הפקודה הזו יוצרת ספרייה חדשה, בשם repos, בספרייה שמכילה את קובץ ה- .tar. לדוגמה /tmp/repos.
11. מתקינים את כלי השירות ואת יחסי התלות של Edge apigee-service מ-/tmp/repos:
    > sudo bash /tmp/repos/shoestrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
    
    שימו לב שהפקודה הזו כוללת את הנתיב לספריית ה-repos.
12. להשתמש ב-apigee-service כדי מתקינים את apigee-setup תוכנית שירות:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup installation
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 מחדש
3. כברירת מחדל, המאגר דורש שם משתמש:סיסמה של admin:admin. כדי לשנות את פרטי הכניסה האלה, מגדירים את משתני הסביבה הבאים:
   MIRROR_USERNAME=uName
   MIRROR_PASSWORD=pWord
4. בצומת החדש, מתקינים את yum-utils ואת העדיפות של yum-plugin:
   > סודו יאם התקנה של yum-utils
   > עדיפות להתקנת sudo yum yum-plugin
5. בצומת החדש, משביתים את SELinux כפי שמתואר למעלה.
6. בצומת החדש, מפעילים מאגר EPEL כמו שמתואר למעלה.
7. בצומת החדש, בודקים את הגרסה של libdb4 כפי שמתואר למעלה.
8. בצומת המרוחק, מורידים את קובץ Edge shoestrap_4.18.01.sh אל /tmp/shoestrap_4.18.01.sh:
   > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh -o /tmp/shoestrap_4.18.01.sh
   
   כאשר uName:pWord הם שם המשתמש והסיסמה שהגדרתם למעלה עבור המאגר ו-remoteRepo הוא כתובת ה-IP או שם ה-DNS של המאגר .
9. בצומת המרוחק, מתקינים את כלי השירות ואת יחסי התלות של Edge apigee-service:
   > sudo bash /tmp/shoestrap_4.18.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 installation
11. להשתמש ב-apigee-setup כדי להתקין ולהגדיר את רכיבי Edge בצומת המרוחק. למידע נוסף, ראו התקנת רכיבי Edge בצומת.

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

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

1. מורידים את הקובץ Edge bootrap_4.18.01.sh אל /tmp/shoestrap_4.18.01.sh:
   > תלתל https://software.apigee.com/shoestrap_4.18.01.sh -o /tmp/shoestrap_4.18.01.sh
2. מריצים את הקובץ bootstrap_4.18.01.sh של Edge:
   > sudo bash /tmp/shoestrap_4.18.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 and /var/tmp/yum-apigee-*.

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

> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean

הוספה או עדכון של Edge 4.16.0x/4.17.0x במאגר 4.18.01

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

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

1. חשוב לוודא שהתקנתם את גרסה 4.18.01 של כלי השירות apigee-mirror:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version
   
   אמורה להופיע תוצאה בטופס שלמטה, שבו xyz הוא ה-build מספר:
   apigee-mirror-4.18.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 כדי לראות את מבנה הקובץ:
   > שנ' /opt/apigee/data/apigee-mirror/repos
   
   אתם אמורים לראות את הקבצים והספריות הבאים:
   apigee apigee-repo-1.0-6.x86_64.rpm shoestrap_4.16.01.sh bootstrap_4.16.05.sh bootstrap_4.17.01.sh bootstrap_4.17.01.sh bootstrap_4.17.01.sh shoestrap_4.18.01.sh צד שלישי
   
   שימו לב שיש קובץ אתחול לכל הגרסאות של Edge. ספריית apigee מכילה גם ספציפיות לכל גרסה של Edge.
4. כדי לאחסן את המאגר בקובץ .tar, משתמשים בפקודה הבאה:
   > apigeeReleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service חבילת שיקוף apigee
   
   הפקודה הזו משלבת את כל המאגרים מסוג 4.17.0x ו-4.16.0x לאותו קובץ tar. אי אפשר רק חלק מהמאגר.