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

Edge for Private Cloud גרסה 4.17.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:
      echo 0 > /selinux/enforce

      כדי להפעיל מחדש את SELinux לאחר התקנת Edge:
      echo 1 > /selinux/enforce
    2. במערכת הפעלה Linux 7.x:
      setenforce 0

      כדי להפעיל מחדש את SELinux אחרי התקנת Edge:
      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 7.x:
    > wget https://dl.fedoraproject.org/pub/epel/epel-release-Last-7.noarch.rpm; sudo rpm -ivh epel-release-updated-7.noarch.rpm
  • ל-RedHat/CentOS 6.x:
    > wget https://dl.fedoraproject.org/pub/epel/epel-release-release-6.noarch.rpm; sudo rpm -ivh epel-release-updated-6.noarch.rpm

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

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

  1. משיגים את שם המשתמש והסיסמה מ-Apigee, שבאמצעותם ניתן לגשת למאגר Apigee. אם יש לכם שם משתמש:סיסמה לאתר Apigee ftp, ניתן להשתמש בפרטי הכניסה האלה.
  2. מתחברים לצומת בתור הבסיס כדי להתקין את ה-RPM של Edge
    הערה: להתקנת RPM נדרשת גישה לרמה הבסיסית, אבל אפשר לקבוע הגדרת Edge בלי גישה לרמה הבסיסית.
  3. משביתים את SELinux כפי שמתואר למעלה.
  4. מפעילים מאגר EPEL כפי שמתואר למעלה.
  5. מורידים את הקובץ bootstrap_4.17.01.sh מ-Edge אל bootstrap_4.17.01.sh:
    > curl https://software.apigee.com/shoestrap_4.17.01.sh -o /tmp/shoestrap_4.17.01.sh
  6. מתקינים את כלי השירות ואת יחסי התלות של שירות Edge apigee:
    > sudo bash /tmp/shoestrap_4.17.01.sh apigeeuser=uName apigeepassword=pWord

    כאשר uName:pWord הם שם המשתמש והסיסמה שקיבלת מ-Apigee. אם לא תשמיטו את pWord, תתבקשו להזין אותו.

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

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

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

    כדי להציג את תוכן המאגר, משתמשים בפקודה:
    > sudo yum -v repolist 'apigee*'
  7. (CentOS-6.x ו-RedHat-6.x בלבד) בכל צומתי ה-Qpid, מריצים את הפקודה הבאה כדי להוריד את גרסת ה-Qpid הנכונה:
    > yum install apigee-qpidd --disablerepo=epel
  8. משתמשים בשירות apigee-service כדי להתקין את כלי העזר apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup התקנה
  9. השתמש ב-apigee-setup כדי להתקין ולהגדיר רכיבי Edge בצומת. למידע נוסף, אפשר לקרוא את המאמר על התקנת רכיבי Edge בצומת.

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

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

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

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

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

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

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

  1. משיגים את שם המשתמש והסיסמה מ-Apigee, שבאמצעותם ניתן לגשת למאגר Apigee. אם יש לכם שם משתמש:סיסמה לאתר Apigee ftp, ניתן להשתמש בפרטי הכניסה האלה.
  2. מתחברים לצומת RedHat או לצומת CentOS בתור בסיס כדי להתקין את ה-RPM של Edge.
    הערה: התקנת RPM מחייבת גישה לרמה הבסיסית, אבל אפשר להגדיר את Edge בלי גישה לרמה הבסיסית.
  3. מוודאים שבמכשיר מותקנת הגרסה העדכנית ביותר של yum-utils:
    > sudo yum update yum-utils
  4. משביתים את SELinux כפי שמתואר למעלה.
  5. מפעילים מאגר EPEL כפי שמתואר למעלה.
  6. מורידים את הקובץ bootstrap_4.17.01.sh מ-Edge אל bootstrap_4.17.01.sh:
    > curl https://software.apigee.com/shoestrap_4.17.01.sh -o /tmp/shoestrap_4.17.01.sh
  7. (CentOS-6.x ו-RedHat-6.x בלבד) מריצים את הפקודה הבאה כדי לוודא שאתם מורידים את גרסת ה-Qpid הנכונה:
    > yum install apigee-qpidd --disablerepo=epel
  8. מתקינים את כלי השירות ואת יחסי התלות של שירות Edge apigee:
    > sudo bash /tmp/shoestrap_4.17.01.sh apigeeuser=uName apigeepassword=pWord

    כאשר uName:pWord הם שם המשתמש והסיסמה שקיבלת מ-Apigee. אם לא תשמיטו את pWord, תתבקשו להזין אותו.
  9. מתקינים את תוכנת העזר apigee-mirror בצומת:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror התקנה

    הערה: אם אתם מעדכנים מאגר קיים ל-4.17.01, צריך רק לעדכן את apigee-mirege-apige/optrapige/optrapige/optror:
  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

    אם רוצים להוריד את כל המאגר, כולל RPM ישן יותר, צריך להשמיט --only-new-rpms. נדרש נפח אחסון של כ-6GB להורדה המלאה:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

    עכשיו יש לך עותק מקומי של המאגר של Apigee. בקטע הבא מוסבר איך להתקין את כלי השירות apigee-setup של Edge מהמאגר המקומי.
  11. (אופציונלי) אם רוצים להתקין את Edge מהמאגר המקומי באותו צומת שמארח את המאגר המקומי, קודם צריך להריץ את הפקודות הבאות:
    1. מריצים את הפקודה bootstrap_4.17.01.sh מהמאגר המקומי כדי להתקין את תוכנת העזר bootstrap_4.17.01.sh:
      > sudo bash /opt/apigee/data/apigee-mirror/repos/shoestrap_4.17.01.sh apigeeprotocol="file://" apigeeposerepopathe
    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:

  1. בצומת עם המאגר המקומי, משתמשים בפקודה הבאה כדי לארוז את המאגר המקומי בקובץ .tar אחד בשם /opt/apigee/data/apigee-mirror/apigee-4.17.01.tar.gz:

    > /opt/apigee/apigee-service/bin/apigee-mirorapirapi?hl=iw
  2. מעתיקים את קובץ ה- .tar לצומת שבו רוצים להתקין את Edge. לדוגמה, מעתיקים אותו לספרייה /tmp בצומת החדש.
  3. בצומת החדש, משביתים את SELinux כפי שמתואר למעלה.
  4. בצומת החדש, מבטלים את היררכיית הקובץ /tmp:
    > tar -xzf apigee-4.17.01.tar.gz

    הפקודה הזו יוצרת ספרייה חדשה בשם repos, בספרייה שמכילה את קובץ ה- .tar. לדוגמה: /tmp/repos.
  5. מתקינים את כלי השירות ואת יחסי התלות של Edge apigee-service מ-/tmp/repos:
    > sudo bash /tmp/repos/shoestrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    שימו לב שכללתם את הספרייה בפקודה הזו לrepos.
  6. משתמשים ב-apigee-service כדי להתקין את כלי השירות apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  7. אפשר להשתמש ב-apigee-setup כדי להתקין ולהגדיר רכיבי Edge בצומת. למידע נוסף, אפשר לקרוא את המאמר על התקנת רכיבי Edge בצומת.

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

  1. מתקינים את שרת האינטרנט של Nginx בצומת ה-repo:
    > 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. בצומת החדש, משביתים את SELinux כפי שמתואר למעלה.
  5. בצומת המרוחק, מורידים את הקובץ Edge shoestrap_4.17.01.sh אל /tmp/bootstrap_4.17.01.sh:
    > /usr/bin/curl http://uName:pWord@remoteRepo:3939/shoestrap_4.remote/shoes.remote_remote.mprepo:3939/shoestrap_4.remote/shoes..

  6. בצומת המרוחק, מתקינים את כלי העזר ויחסי התלות של שירות Edge apigee:
    > sudo bash /tmp/shoestrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord:PP כאשר המשתמש apigeepassword=pWord:api:

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

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

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

  1. מורידים את הקובץ Edge bootrap_4.17.01.sh אל /tmp/bootstrap_4.17.01.sh:
    > curl https://software.apigee.com/shoestrap_4.17.01.sh -o /tmp/shoestrap_4.17.01.sh
  2. מריצים את הקובץ bootstrap_4.17.01.sh:
    > sudo bash /tmp/shoestrap_4.17.01.sh apigeeuser=uName apigeepassword=uName

    כאשר uName הוא שם המשתמש והסיסמה שקיבלת. אם לא כוללים את הפרמטר 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.01/4.16.05/4.16.09 במאגר של 4.17.01

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

כדי להוסיף 4.16.0x למאגר 4.17.01:

  1. יש לוודא שהתקנת את גרסה 4.17.01 של כלי השירות apigee-mirror:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version

    התוצאה אמורה להופיע בתבנית הבאה, שבה xyz הוא מספר ה-build :
    0.xyz-mirror xyz
    הוא מספר ה-build :
    apigee-service/bin/apigee-service apigee-mirror
  2. משתמשים בכלי apigee-mirror כדי להוריד את Edge 4.16.01/4.16.05/4.16.09 למאגר. שימו לב איך מוסיפים לפקודה תחילית עם apigeereleasever=4.16.01 או apigeereleasever=4.16.05:
    > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirrpm sync --only-service apigee-mirror sync --only-new

  3. בודקים את הספרייה /opt/apigee/data/apigee-mirror/repos כדי לראות את מבנה הקובץ:
    > ls /opt/apigee/data/apigee-mirror/repos
    הקבצים והספריות הבאים אמורים להופיע:
    apigee apigee-repo-1.0-6.x86shoes.app-1.0-rapshoes.x86


    הספרייה apigee מכילה גם ספריות נפרדות לכל גרסה של Edge.
  4. כדי לארוז את המאגר בקובץ .tar, משתמשים בפקודה הבאה:
    > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

    הפקודה הזו כוללת גם את גרסה 4.17.01 וגם את הקובץ 4.17.01 ואותו קובץ 4.16.0x של קובץ .16.0x 4.17.01. לא ניתן לארוז רק חלק מהמאגר.

כדי להתקין את Edge מקובץ ה-repo המקומי או ה-tar .חשוב להפעיל את קובץ ה-Bootstrap המתאים באמצעות אחת מהפקודות הבאות:

  • אם מבצעים התקנה מקובץ .tar, מריצים את קובץ ה-Boottrap הנכון מהמאגר:
    > sudo bash /tmp/repos/bootstrap_4.16.0X.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    כדי להשלים את ההתקנה, פועלים לפי השלבים הנותרים המתוארים למעלה.
  • אם מתקינים את השרת האינטרנט Nginx, צריך להוריד את קובץ האתחול הנכון מה-repo. לאחר מכן צריך להוריד אותו מה-repo:
    > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.0X.sh -o /tmp/bootstrap_4.16.0X.sh