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

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

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

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

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

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

  • כדי להשבית את SELinux באופן סופי או להגדיר אותו למצב הרשאה:
    1. פותחים את /etc/sysconfig/selinux בכלי לעריכה.
    2. הגדרה של SELINUX=disabled או SELINUX=permissive
    3. שומרים את השינויים.
    4. מפעילים מחדש את הצומת.
    5. אם יש צורך, לאחר התקנת Edge מפעילים מחדש את SELinux על ידי חזרה על התהליך הזה כדי להגדיר את SELINUX=enabled.
  • דרישה מוקדמת: הפעלת המאגר EPEL

    כדי להתקין או לעדכן את Edge או ליצור מאגר מקומי, צריך להפעיל את Extra Packages for Enterprise Linux‏ (או EPEL). הפקודה שבה משתמשים תלויה בגרסה של RedHat/CentOS:

    • ב-Red Hat/‏CentOS/‏Oracle 8.x:
      wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
      sudo rpm -ivh epel-release-latest-8.noarch.rpm
    • ב-Red Hat/CentOS/Oracle 9.x:
      wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
      sudo rpm -ivh epel-release-latest-9.noarch.rpm
    • דרישות מוקדמות ל-RHEL 8/‏Rocky 8/‏Oracle 8

      אם מתקינים את Edge בשרת שבו פועלת מערכת Red Hat Enterprise Linux‏ (RHEL) 8, צריך לבצע את השלבים הבאים לפני שמבצעים את ההתקנה:

      1. מפעילים את Extra Packages for Enterprise Linux‏ (EPEL):
        sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
      2. השבתת Postgres ו-Nginx:
        sudo dnf module disable postgresql
        sudo dnf module disable nginx

      דרישות מוקדמות ל-RHEL 9/‏Rocky 9/‏Oracle 9

      אם מתקינים את Edge בשרת שבו מופעלים Red Hat Enterprise Linux (RHEL) 9 , Rocky 9 או Oracle 9, צריך להשלים את השלבים הבאים לפני ביצוע ההתקנה:

      1. מפעילים חבילות נוספות ל-Enterprise Linux (EPEL):
        sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
      2. השבתת Postgres ו-Nginx:
        sudo dnf module disable postgresql
        sudo dnf module disable nginx

      לשינויים לפני ההתקנה של PostgreSQL ו-LDAP, אפשר לעיין בדרישות לפני ההתקנה של מסד הנתונים PostgreSQL ובשינויים לפני ההתקנה של OpenLDAP 2.4, בהתאמה.

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

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

      1. מקבלים מ-Apigee את שם המשתמש והסיסמה שבהם משתמשים כדי לגשת למאגר של Apigee. אם יש לכם username:password קיים לאתר ה-FTP של Apigee, תוכלו להשתמש בפרטי הכניסה האלה.
      2. מתחברים לצומת כ-root כדי להתקין את ה-RPM של Edge
      3. משביתים את SELinux.
      4. מפעילים את המאגר EPEL.
      5. אם מתקינים ב-RHEL 9/‏Rocky 9/‏Oracle 9, פועלים לפי השלבים שמפורטים בקטע דרישות מוקדמות ל-RHEL 9/‏Rocky 9/‏Oracle 9.
      6. מורידים את קובץ Edge bootstrap_4.53.00.sh אל /tmp/bootstrap_4.53.00.sh:
        curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      7. מתקינים את השירות apigee-service של Edge ואת יחסי התלות שלו:
        sudo bash /tmp/bootstrap_4.53.00.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*'
      8. צריך להשתמש ב-apigee-service כדי להתקין את הכלי apigee-setup:
        /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
      9. משתמשים בפקודה apigee-setup כדי להתקין ולהגדיר רכיבי Edge בצומת. מידע נוסף זמין במאמר התקנת רכיבי Edge בצומת.

      פתרון בעיות

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

      Cannot open: https://username@software.apigee.com/apigee-repo-4.53.00.rpm
      
      bootstrap.sh: Error: Repo configuration failed
      
      error: package package_name is not installed

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

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

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

      nc -v software.apigee.com 443

      אמורה להופיע הודעה דומה לזו:

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

      אם nc לא מותקן, אפשר להריץ את הפקודה הבאה של telnet:

      telnet software.apigee.com 443

      אם הפקודות יתבצעו בהצלחה, תוכלו להשתמש ב-CTRL+C כדי לבטל את החיבור הפתוח.

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

      פרטי כניסה שגויים

      מוודאים ששם המשתמש והסיסמה נכונים.

      לדוגמה, בודקים אם מופיעה הודעת שגיאה כשמנסים להשתמש בפקודה הבאה עם שם המשתמש והסיסמה ב-Apigee:

      curl -i -u username:password https://software.apigee.com/apigee-repo.rpm
      בעיות בשרת proxy בתצורה המקומית שלכם נעשה שימוש ב-proxy HTTP ליציאה, ולא הרחבת את אותה תצורה למנהל החבילות yum. בודקים את משתני הסביבה:
      echo $http_proxy
      echo $https_proxy

      בשרת proxy ל-HTTP של תעבורת נתונים יוצאת, צריך להשתמש באחת מהאפשרויות הבאות:

      • הוספת הגדרה של שרת Proxy ל-HTTP ב-/etc/yum.conf
      • הוספת הגדרה גלובלית של שרת proxy ל-HTTP ב-/etc/environment

      התקנת אפליקציית השירות apigee-setup בצומת ללא חיבור חיצוני לאינטרנט

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

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

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

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

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

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

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

      8. (אופציונלי) אם רוצים להתקין את Edge מהמאגר המקומי באותו צומת שמארח את המאגר המקומי, צריך קודם להריץ את הפקודות הבאות:
        1. מריצים את bootstrap_4.53.00.sh מהמאגר המקומי כדי להתקין את השירות apigee-service:
          sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.53.00.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.53.00.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. כדי להתקין את כלי השירות apigee-setup, צריך להשתמש ב-apigee-service:
        /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
      7. משתמשים ב-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. בצומת החדש, מוודאים שמאגר EPEL מופעל באופן מקומי.
      5. בצומת החדש, בודקים את הגרסה של libdb4 כפי שמתואר למעלה.
      6. בצומת המרוחק, מתקינים את כלי השירות apigee-service ואת יחסי התלות של Edge:
        sudo bash /tmp/bootstrap_4.53.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

        כאשר uName:pWord הם שם המשתמש והסיסמה של המאגר.

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

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

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

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

      1. מורידים את הקובץ bootstrap_4.53.00.sh של Edge אל /tmp/bootstrap_4.53.00.sh:
        curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      2. מריצים את הקובץ bootstrap_4.53.00.sh של Edge:
        sudo bash/tmp/bootstrap_4.53.00.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