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

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

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

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

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

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

כדי להשבית את SELinux לצמיתות או להגדיר אותו למצב הרשאה:

1. פותחים את /etc/sysconfig/selinux בעורך.
2. הגדרה של SELINUX=disabled או SELINUX=permissive
3. שומרים את השינויים.
4. מפעילים מחדש את הצומת.
5. במקרה הצורך, אפשר להפעיל מחדש את SELinux אחרי התקנת Edge. לשם כך, חוזרים על התהליך הזה כדי להגדיר את 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. מפעילים את 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.7.

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

כדי להתקין את 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.01.sh אל /tmp/bootstrap_4.53.01.sh:

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

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

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

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

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

   • ‫I: התקנה של OpenJDK 1.8 (ברירת מחדל)
   • C: Continue without installing Java (המשך בלי להתקין 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	ההגדרה המקומית שלכם משתמשת ב-HTTP proxy ליציאה, ולא הרחבתם את אותה הגדרה למנהל החבילות yum. בודקים את משתני הסביבה: echo $http_proxy echo $https_proxy כדי להגדיר שרת proxy ל-HTTP ליציאה, צריך להשתמש באחת מהאפשרויות הבאות: הוספת הגדרת HTTP proxy ב-/etc/yum.conf הוספת הגדרת שרת proxy גלובלית של HTTP ב-/etc/environment

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

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

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

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

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

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

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

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

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

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

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

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

      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.53.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 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.01.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.53.01.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.01.sh ואז לבצע סנכרון חדש.

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

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

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

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

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

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

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