כדי להתקין את Edge בצומת, קודם צריך להתקין את כלי השירות Edge apigee-setup. אם אתם נמצאים בסביבה שבה לקודקודים אין חיבור חיצוני לאינטרנט, עליכם להתקין גם עותק מקומי של המאגר של Apigee.
ספריית ההתקנה המוגדרת כברירת מחדל: /opt/apigee
Edge מתקין את כל הקבצים בספרייה /opt/apigee
. אי אפשר לשנות את הספרייה הזו. עם זאת, אם רוצים, אפשר ליצור קישור סימבולי כדי למפות את /opt/apigee
למיקום אחר. מידע נוסף זמין במאמר דרישות ההתקנה.
דרישה מוקדמת: השבתת SELinux
צריך להשבית את SELinux או להגדיר אותו למצב מתירני לפני התקנת אפליקציית השירות apigee-setup
של Edge או כל רכיבי Edge. אם צריך, אחרי התקנת Edge אפשר להפעיל מחדש את SELinux.
- פותחים את
/etc/sysconfig/selinux
בכלי לעריכה. - הגדרה של
SELINUX=disabled
אוSELINUX=permissive
- שומרים את השינויים.
- מפעילים מחדש את הצומת.
- אם יש צורך, לאחר התקנת 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
- מפעילים את Extra Packages for Enterprise Linux (EPEL):
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
- השבתת Postgres ו-Nginx:
sudo dnf module disable postgresql
sudo dnf module disable nginx
- מפעילים חבילות נוספות ל-Enterprise Linux (EPEL):
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
- השבתת Postgres ו-Nginx:
sudo dnf module disable postgresql
sudo dnf module disable nginx
- מקבלים מ-Apigee את שם המשתמש והסיסמה שבהם משתמשים כדי לגשת למאגר של Apigee. אם יש לכם username:password קיים לאתר ה-FTP של Apigee, תוכלו להשתמש בפרטי הכניסה האלה.
- מתחברים לצומת כ-root כדי להתקין את ה-RPM של Edge
- משביתים את SELinux.
- מפעילים את המאגר EPEL.
- אם מתקינים ב-RHEL 9/Rocky 9/Oracle 9, פועלים לפי השלבים שמפורטים בקטע דרישות מוקדמות ל-RHEL 9/Rocky 9/Oracle 9.
- מורידים את קובץ 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
- מתקינים את השירות 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*'
- צריך להשתמש ב-apigee-service כדי להתקין את הכלי apigee-setup:
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- משתמשים בפקודה apigee-setup כדי להתקין ולהגדיר רכיבי Edge בצומת. מידע נוסף זמין במאמר התקנת רכיבי Edge בצומת.
- הוספת הגדרה של שרת Proxy ל-HTTP ב-
/etc/yum.conf
- הוספת הגדרה גלובלית של שרת proxy ל-HTTP ב-
/etc/environment
- מאגר Apigee Edge: כפי שמתואר בקטע יצירת מאגר מקומי של Apigee.
- Extra Packages for Enterprise Linux (או EPEL): צוות התפעול אמור להיות מסוגל להגדיר את זה בשבילכם.
- מקבלים את שם המשתמש והסיסמה מ-Apigee שבהם משתמשים כדי לגשת למאגר של Apigee. אם יש לכם שם משתמש:password לאתר ה-ftp של Apigee, תוכלו להשתמש בפרטי הכניסה האלה.
- מתחברים לצומת בתור root כדי להתקין את קובצי ה-RPM של Edge.
- משביתים את SELinux כמו שמתואר למעלה.
- מורידים את קובץ 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
- מתקינים את השירות apigee-service של Edge ואת יחסי התלות שלו:
sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord
כאשר uName:pWord הם שם המשתמש והסיסמה שקיבלת מ-Apigee. אם משמיטים את pWord, תופיע בקשה להזין אותו.
- התקנת כלי השירות
apigee-mirror
בצומת:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
- משתמשים בכלי
apigee-mirror
כדי לסנכרן את המאגר של Apigee עם הספרייה/opt/apigee/data/apigee-mirror/repos/
.כדי לצמצם את הגודל של המאגר, מוסיפים את
--only-new-rpms
כדי להוריד רק את קובצי ה-RPM העדכניים ביותר. -
(אופציונלי) אם רוצים להתקין את Edge מהמאגר המקומי באותו צומת שמארח את המאגר המקומי, צריך קודם להריץ את הפקודות הבאות:
- מריצים את
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
- כדי להתקין את כלי השירות
apigee-setup
, צריך להשתמש ב-apigee-service
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- משתמשים ב-
apigee-setup
כדי להתקין ולהגדיר רכיבי Edge בצומת. למידע נוסף, ראו התקנת רכיבי Edge בצומת.
- מריצים את
- יוצרים קובץ .tar של המאגר, מעתיקים את קובץ ה- .tar לצומת ומתקינים את Edge מהקובץ .tar.
- מתקינים שרת אינטרנט בצומת עם המאגר המקומי כדי שצמתים אחרים יוכלו לגשת אליו. Apigee מספקת לכם את שרת האינטרנט Nginx או שתוכלו להשתמש בשרת האינטרנט שלכם.
- בצומת שבו נמצא המאגר המקומי, משתמשים בפקודה הבאה כדי לארוז את המאגר המקומי בקובץ tar . יחיד בשם
/opt/apigee/data/apigee-mirror/apigee-4.53.00.tar.gz
:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- מעתיקים את הקובץ .tar לצומת שבו רוצים להתקין את Edge. לדוגמה, מעתיקים אותו לספרייה
/tmp
בצומת החדש. - בצומת החדש, משביתים את SELinux כפי שמתואר למעלה.
- בצומת החדש, מוודאים שיש גישה למאגר הכלים המקומי של Yum ולמאגר EPEL.
- מוודאים שכל המאגרים החיצוניים באינטרנט מושבתים (הדבר אמור לקרות כי מתבצעת התקנה במכונה ללא גישה לאינטרנט):
sudo yum repolist
צריך להשבית את כל המאגרים החיצוניים, אבל צריך להפעיל את המאגר המקומי של Apigee ואת המאגרים הפנימיים.
- כדי להתקין את כלי השירות
apigee-setup
, צריך להשתמש ב-apigee-service
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- משתמשים ב-
apigee-setup
כדי להתקין ולהגדיר רכיבי Edge בצומת. מידע נוסף זמין במאמר התקנת רכיבי Edge בצומת. - מתקינים את שרת האינטרנט Nginx בצומת המאגר:
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
- כברירת מחדל, ב-Nginx מוגדר להשתמש ב-localhost כשם שרת ויציאה 3939. כדי
לשנות את הערכים האלה:
- פותחים את
/opt/apigee/customer/application/mirror.properties
בכלי לעריכה. יוצרים את הקובץ אם הוא לא קיים. - מגדירים את הערכים הבאים לפי הצורך:
conf_apigee_mirror_listen_port=3939 conf_apigee_mirror_server_name=localhost
- מפעילים מחדש את Nginx:
/opt/nginx/scripts/apigee-nginx restart
- פותחים את
- כברירת מחדל, המאגר דורש שם משתמש:סיסמה של
admin:admin
. כדי לשנות את פרטי הכניסה האלה, מגדירים את משתני הסביבה הבאים:MIRROR_USERNAME=uName MIRROR_PASSWORD=pWord
- בצומת החדש, מוודאים שמאגר EPEL מופעל באופן מקומי.
- בצומת החדש, בודקים את הגרסה של
libdb4
כפי שמתואר למעלה. - בצומת המרוחק, מתקינים את כלי השירות
apigee-service
ואת יחסי התלות של Edge:sudo bash /tmp/bootstrap_4.53.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
כאשר uName:pWord הם שם המשתמש והסיסמה של המאגר.
- בצומת המרוחק, משתמשים ב-
apigee-service
כדי להתקין את הכליapigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- משתמשים ב-
apigee-setup
כדי להתקין ולהגדיר את רכיבי Edge בצומת המרוחק. מידע נוסף זמין במאמר התקנת רכיבי Edge בצומת. - מורידים את הקובץ 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
- מריצים את הקובץ
bootstrap_4.53.00.sh
של Edge:sudo bash/tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord
כאשר uName:pWord הם שם המשתמש והסיסמה שקיבלת מ-Apigee. אם pWord לא יצוין, תופיע בקשה להזין אותו.
- עדכון
apigee-mirror
:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
- מבצעים את הסנכרון:
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
- אם רוצים להעלות את כל המאגר:
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync
דרישות מוקדמות ל-RHEL 8/Rocky 8/Oracle 8
אם מתקינים את Edge בשרת שבו פועלת מערכת Red Hat Enterprise Linux (RHEL) 8, צריך לבצע את השלבים הבאים לפני שמבצעים את ההתקנה:
דרישות מוקדמות ל-RHEL 9/Rocky 9/Oracle 9
אם מתקינים את Edge בשרת שבו מופעלים Red Hat Enterprise Linux (RHEL) 9 , Rocky 9 או Oracle 9, צריך להשלים את השלבים הבאים לפני ביצוע ההתקנה:
לשינויים לפני ההתקנה של PostgreSQL ו-LDAP, אפשר לעיין בדרישות לפני ההתקנה של מסד הנתונים PostgreSQL ובשינויים לפני ההתקנה של OpenLDAP 2.4, בהתאמה.
התקנת הכלי להגדרת Edge apigee בצומת עם חיבור חיצוני לאינטרנט
כדי להתקין את 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. |
בעיות קישוריות | כדי לבדוק את הקישוריות לרשת, מריצים את הפקודה הבאה nc -v software.apigee.com 443 אמורה להופיע הודעה דומה לזו: Connection to software.apigee.com 443 port [tcp/https] succeeded! אם 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
בשרת proxy ל-HTTP של תעבורת נתונים יוצאת, צריך להשתמש באחת מהאפשרויות הבאות: |
התקנת אפליקציית השירות apigee-setup בצומת ללא חיבור חיצוני לאינטרנט
אם צמתים של Edge נמצאים מאחורי חומת אש או שאין להם גישה לאינטרנט מסיבה אחרת, צריך ליצור כמה מאגרים או רפליקות שמכילים את הקבצים שנדרשים במהלך ההתקנה. לאחר מכן, כל הצמתים צריכים להיות יכולים לגשת למראה. לאחר היצירה, הצמתים יוכלו לגשת למקורות המידע המקומיים האלה כדי להתקין את Edge.
תהליך ההתקנה של Apigee Edge בצמתים ללא חיבורי אינטרנט מחייב גישה למאגרים המקומיים הבאים:
יצירת מאגר מקומי של Apigee
כדי ליצור את המאגר הפנימי של Apigee, נדרש צומת עם גישה חיצונית לאינטרנט כדי שתוכלו להוריד את יחידות ה-RPM והיחסי התלות של Edge. אחרי שיוצרים את המאגר הפנימי, אפשר להעביר אותו לצומת אחר או לתת לצומת הזה גישה לצמתי Edge לצורך התקנה.
אחרי שיוצרים מאגר מקומי של Apigee, יכול להיות שיהיה צריך לעדכן אותו מאוחר יותר לקובצי ההפצה האחרונים של Edge. בחלקים הבאים מוסבר איך ליצור מאגר מקומי של Apigee ואיך לעדכן אותו.
כדי ליצור מאגר מקומי של Apigee:
התקנת apigee-setup בצומת מרוחק מהמאגר המקומי
יש שתי אפשרויות להתקנת Edge מהמאגר המקומי. אתם יכולים:
התקנה מקובץ ה- .tar
כדי להתקין מקובץ ה- .tar:
התקנה מהמאגר באמצעות שרת האינטרנט Nginx
כדי להתקין מהמאגר באמצעות שרת האינטרנט Nginx:
עדכון מאגר מקומי של Apigee
כדי לעדכן את המאגר, צריך להוריד את הקובץ bootstrap_4.53.00.sh העדכני ואז לבצע סנכרון חדש.
כדי לעדכן את המאגר:
ניקוי מאגר מקומי של Apigee
ניקוי המאגר המקומי מחיקות /opt/apigee/data/apigee-mirror and /var/tmp/yum-apigee-*.
כדי לנקות את המאגר המקומי, משתמשים בפקודה:
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean