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

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

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

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

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

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

דרישה מוקדמת: הפעלת מאגר EPEL

כדי להתקין או לעדכן את Edge, או כדי ליצור מאגר מקומי, צריך להפעיל את Extra Packages for Enterprise Linux (או EPEL). ב-Red Hat Enterprise Linux ‏ (RHEL) 9.x,‏ Rocky Linux 9.x או Oracle Linux 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 9, ל-Rocky 9 ול-Oracle 9

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

1. מפעילים את Extra Packages for 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 והשינויים שצריך לבצע לפני ההתקנה של SymasLDAP 2.6.10.

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

כדי להתקין את 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. מורידים את הקובץ bootstrap_4.54.00.sh של Edge אל /tmp/bootstrap_4.54.00.sh:

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

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

   sudo bash /tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord

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

   ב-Apigee Edge for Private Cloud 4.54.00 נדרשת תמיכה כפולה ב-Java, עם Java 17 ו-Java 21 מותקנות בצומת. צריך להתקין גם את Java 17 וגם את Java 21 לפני שמריצים את הסקריפט של האתחול. מנהל ההתקנה רק מוודא ששתי הגרסאות של ה-JDK מותקנות, הוא לא מתקין את 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

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

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

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

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

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

• ‫Apigee Edge repo: כמו שמתואר במאמר יצירת מאגר מקומי של Apigee.
• ‫Extra Packages for Enterprise Linux (או EPEL): צוות התפעול שלכם אמור להיות מסוגל להגדיר את זה בשבילכם.

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

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

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

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

1. משיגים מ-Apigee את שם המשתמש והסיסמה שמשמשים לגישה למאגר של Apigee. אם כבר יש לכם שם משתמש וסיסמה לאתר ה-FTP של Apigee, אתם יכולים להשתמש בהם.
2. מתחברים לצומת בתור root כדי להתקין את חבילות ה-RPM של Edge.
   
3. משביתים את SELinux כמו שמתואר למעלה.
4. מורידים את קובץ Edge bootstrap_4.54.00.sh אל /tmp/bootstrap_4.54.00.sh:

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

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

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

      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.54.00.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos

   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

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

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

   /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. בצומת המרוחק, מתקינים את כלי השירות של Edge apigee-service ואת יחסי התלות:

   sudo bash /tmp/bootstrap_4.54.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.54.00.sh ואז לבצע סנכרון חדש.

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

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

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

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

   sudo bash/tmp/bootstrap_4.54.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 ואת /var/tmp/yum-apigee-*.‎

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

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