Edge for Private Cloud גרסה 4.16.05
אחרי שמתקינים את כלי השירות apigee-setup של Edge בצומת, משתמשים בכלי השירות apigee-setup כדי להתקין רכיב אחד או יותר של Edge בצומת.
כלי ההגדרה של Apigee משתמש בפקודה בפורמט הבא:
> /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFileכאשר component הוא רכיב Edge שרוצים להתקין, ו-configFile הוא קובץ התצורה השקט שמכיל את פרטי ההתקנה. למשתמש apigee צריכה להיות גישה לקובץ התצורה או אפשרות לקרוא אותו. לדוגמה, אפשר לשים את הקובץ בספרייה /tmp בצומת.
לדוגמה, כדי להתקין את Edge Management Server:
> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f /tmp/myConfigשיקולים בקשר להתקנה
כשאתם כותבים את קובץ התצורה, כדאי להביא בחשבון את האפשרויות הבאות.
הגדרת רפליקציה של Postgres במצב המתנה ראשי
כברירת מחדל, Edge מתקין את כל צומתי Postgres במצב מאסטר. עם זאת, במערכות ייצור עם כמה צומתי Postgres, צריך להגדיר אותם לשימוש ברפליקציה של מאסטר-המתנה, כך שאם הצומת הראשי נכשל, צומת ההמתנה יכול להמשיך לשרת את התנועה.
אפשר להפעיל ולהגדיר שכפול של מאסטר-גיבוי בזמן ההתקנה באמצעות מאפיינים בקובץ התצורה השקט. אפשר גם להפעיל את הרפליקציה של המאסטר-סטנדביי אחרי ההתקנה. מידע נוסף זמין במאמר הגדרת שכפול Master-Standby ל-Postgres.
הפעלת אימות ב-Cassandra
כברירת מחדל, Cassandra מותקנת בלי אימות. זה אומר שכל אחד יכול לגשת אל קסנדרה. אפשר להפעיל את האימות אחרי שמתקינים את Edge, או כחלק מתהליך ההתקנה.
כדי להפעיל את האימות של Cassandra בזמן ההתקנה, משתמשים במאפיינים בקובץ התצורה השקט. אפשר גם להפעיל אותה אחרי ההתקנה.
למידע נוסף, ראו הפעלת אימות של Cassandra.
קישור הנתב ליציאה מוגנת
אם רוצים לקשר את הנתב ליציאה מוגנת, כמו מספרי יציאות קטנים מ-1024, צריך להגדיר את הנתב כך שיפעל כמשתמש עם גישה ליציאות האלה. כברירת מחדל, ה-Router פועל כמשתמש apigee, שאין לו גישה ליציאות עם הרשאות.
כדי להפעיל את הנתב כמשתמש אחר:
- כמשתמש root, יוצרים את הקובץ /opt/apigee/etc/edge-router.d/RUN_USER.sh.
- מוסיפים את הרשומה הבאה לקובץ:
RUN_USER=root
אם לא רוצים להריץ את הנתב כמשתמש Root, צריך לציין משתמש עם גישה ליציאה. - שומרים את הקובץ.
- אם ציינתם משתמש אחר שהוא לא root, צריך לשנות את הבעלים של הקובץ למשתמש הזה:
> chown USER:USER /opt/apigee/etc/edge-router.d/RUN_USER.sh - מפעילים מחדש את הנתב:
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
ציון הרכיבים להתקנה
בטבלה הבאה מפורטות האפשרויות שמעבירים לאפשרות -p של כלי השירות apigee-service כדי לציין אילו רכיבים להתקין בצומת:
|
רכיב |
תיאור |
|---|---|
|
c |
מתקינים רק את Cassandra. |
| zk | התקנה של ZooKeeper בלבד. |
|
ds |
מתקינים את ZooKeeper ו-Cassandra. |
|
ld |
מתקינים רק את OpenLDAP. |
|
ms |
מתקינים את Edge Management Server, שמתקין גם את ממשק המשתמש של Edge ואת OpenLDAP. אם מגדירים USE_LDAP_REMOTE_HOST=y בקובץ התצורה, המערכת מדלגת על ההתקנה של OpenLDAP ושרת הניהול משתמש ב-OpenLDAP שמותקן בצומת אחר. |
|
r |
התקנה של Edge Router בלבד. |
|
mp |
התקנה של מעבד הבקשות של Edge בלבד. |
|
rmp |
מתקינים את Edge Router ואת Message Processor. |
|
ui |
מתקינים את ממשק המשתמש של Edge. |
|
qs |
מתקינים רק את Qpid Server. |
|
ps |
מתקינים רק את Postgres Server. |
|
סקסופון, סקס, sax |
מתקינים את רכיבי הניתוח, כלומר Qpid ו-Postgres. האפשרות הזו מיועדת לפיתוח ולבדיקה בלבד, ולא לייצור. |
|
לחודש |
מתקינים את Monetization. |
|
sa |
התקנה של Edge עצמאי, כלומר Cassandra, ZooKeeper, Management Server, OpenLDAP, ממשק המשתמש של Edge, Router ו-Message Processor. האפשרות הזו משמיטה את רכיבי הניתוח של Edge: Qpid ו-Postgres. האפשרות הזו מיועדת לפיתוח ולבדיקה בלבד, ולא לייצור. |
|
aio |
התקנת כל הרכיבים בצומת אחד. האפשרות הזו מיועדת לפיתוח ולבדיקה בלבד, ולא לייצור. |
יצירת קובץ תצורה
קובץ התצורה מכיל את כל המידע שנדרש כדי להתקין את Edge. בדרך כלל אפשר להשתמש באותו קובץ תצורה כדי להתקין את כל הרכיבים בהתקנה של Edge.
עם זאת, תצטרכו להשתמש בקובצי תצורה שונים או לשנות את קובץ התצורה אם:
- אתם מתקינים כמה שרתי OpenLDAP וצריכים להגדיר שכפול כחלק מהתקנה של 13 צמתים. כל קובץ דורש ערכים שונים ל-LDAP_SID ול-LDAP_PEER.
- אתם יוצרים כמה מרכזי נתונים כחלק מהתקנה של 12 צמתים. לכל מרכז נתונים נדרשות הגדרות שונות למאפיינים כמו ZK_CLIENT_HOSTS ו-CASS_HOSTS.
קובץ תצורה לדוגמה
בהמשך מוצגת דוגמה לקובץ תצורה שקט מלא להתקנת Edge עם 9 צמתים. עורכים את הקובץ הזה לפי הצורך בהתאם להגדרות האישיות. כדי לכלול את הקובץ הזה, משתמשים באפשרות -f ב-setup.sh. בהמשך מוצגות גם דוגמאות לקובצי תצורה לכל טופולוגיית Edge.
# IP address or DNS name of nodes. IP1=192.168.1.1 # Management Server, OpenLDAP, UI, ZooKeeper, Cassandra IP2=192.168.1.2 # ZooKeeper, Cassandra IP3=192.168.1.3 # ZooKeeper, Cassandra IP4=192.168.1.4 # Router, Message Processor IP5=192.168.1.5 # Router, Message Processor IP6=192.168.1.6 # Qpid IP7=192.168.1.7 # Qpid IP8=192.168.1.8 # Postgres IP9=192.168.1.9 # Postgres # Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost. HOSTIP=$(hostname -i) # Set Edge sys admin credentials. ADMIN_EMAIL=your@email.com APIGEE_ADMINPW=yourPassword # If omitted, you are prompted for it. # Location of Edge license file. LICENSE_FILE=/tmp/license.txt # Management Server information. MSIP=$IP1 # IP or DNS name of Management Server node. # Specify the port the Management Server listens on for API calls. # APIGEE_PORT_HTTP_MS=8080 # Default is 8080. # # OpenLDAP information. # # Set to y if you are connecting to a remote LDAP server. # If n, Edge installs OpenLDAP when it installs the Management Server. USE_LDAP_REMOTE_HOST=n # If connecting to remote OpenLDAP server, specify the IP/DNS name and port. # LDAP_HOST=$IP1 # IP or DNS name of OpenLDAP node. # LDAP_PORT=10389 # Default is 10389. APIGEE_LDAPPW=yourLdapPassword # Specify OpenLDAP without replication, 1, or with replication, 2. LDAP_TYPE=1 # Set only if using replication. # LDAP_SID=1 # Unique ID for this LDAP server. # LDAP_PEER= # IP or DNS name of LDAP peer. BIND_ON_ALL_INTERFACES=y # The Message Processor and Router pod. MP_POD=gateway # The name of the region, corresponding to the data center name. REGION=dc-1 # Use dc-1 unless installing in a # multi-data center environment. # ZooKeeper information. # See table below if installing in a multi-data center environment. ZK_HOSTS="$IP1 $IP2 $IP3" # IP/DNS names of all ZooKeeper nodes. ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" # IP/DNS names of all ZooKeeper nodes. # Cassandra information. CASS_CLUSTERNAME=Apigee # Default name is Apigee. # IP addresses of the Cassandra hosts separated by spaces. CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1" # Set to enable Cassandra authentication. # CASS_AUTH=y # The default value is n. # Cassandra uname/pword required if you enabled Cassandra authentication. # CASS_USERNAME= # CASS_PASSWORD= # Use to enable Postgres master-standby replication # when you have multiple Postgres nodes. # PG_MASTER=IPorDNSofNewMaster # PG_STANDBY=IPorDNSofOldMaster # SMTP information. SKIP_SMTP=n # Skip now and configure later by specifying "y". SMTPHOST=smtp.gmail.com SMTPUSER=your@email.com SMTPPASSWORD=yourEmailPassword SMTPSSL=y SMTPPORT=465 # If no SSL, use a different port, such as 25.
בטבלה הבאה מופיע מידע נוסף על המאפיינים האלה:
|
נכס |
הערה |
|---|---|
|
שמות IP/DNS |
כשמציינים את כתובת ה-IP של צומת, אל תשתמשו במיפוי של שם מארח ל-127.0.0.1 או בכתובת IP של 127.0.0.1. |
|
ADMIN_EMAIL |
הסיסמה של מנהל המערכת צריכה להיות באורך של 8 תווים לפחות, ולכלול אות גדולה אחת, אות קטנה אחת, ספרה אחת או תו מיוחד אחד. אם לא תציינו את הסיסמה, תתבקשו להזין אותה. |
|
LICENSE_FILE |
המיקום של קובץ הרישיון, שחייב להיות נגיש למשתמש apigee. לדוגמה, אפשר לאחסן אותו בספרייה /tmp ולהפעיל את הפקודה chmod 777 על הקובץ. הקובץ מועתק לספריית ההתקנה של Edge. |
|
USE_LDAP_REMOTE_HOST |
אם הערך של USE_LDAP_REMOTE_HOST הוא n, Edge מתקין באופן אוטומטי את OpenLDAP כשהוא מתקין את שרת הניהול. אם אתם מתחברים לשרת LDAP מרוחק, צריך להגדיר את USE_LDAP_REMOTE_HOST ל-y. OpenLDAP לא מותקן עם שרת הניהול. אם אתם מתחברים לשרת OpenLDAP מרוחק, השתמשו ב-LDAP_HOST |
|
LDAP_TYPE |
מגדירים את LDAP_TYPE=1 ל-OpenLDAP בלי שכפול. LDAP_TYPE=2 תואם ל-OpenLDAP עם רפליקציה. אם הטופולוגיה של Edge משתמשת בשרת OpenLDAP אחד, מציינים 1. אם בהתקנה של Edge יש כמה צומתי OpenLDAP, כמו בהתקנה של 13 צמתים בסביבת הייצור, צריך לציין 2. אם מפעילים את הרפליקציה, צריך להגדיר את המאפיינים הבאים:
|
|
BIND_ON_ALL_INTERFACES |
אם הערך הוא "y", הנתב או מעבד הבקשות נקשרים (מאזינים) לכל הממשקים (כתובות ה-IP). אם הערך הוא "n", ה-Router או ה-מעבד בקשות נקשרים (מאזינים) לממשק ספציפי, כתובת ה-IP שמוחזרת על ידי הפקודה "hostname -i". |
|
MP_POD |
מציינים את השם של pod מעבד הבקשות ו-Router. כברירת מחדל, השם הוא gateway. |
|
REGION |
שם האזור. בדרך כלל, השמות הם בפורמט dc-# , כאשר # מייצג ערך של מספר שלם. לדוגמה, dc-1, dc-2 וכו'. אפשר להשתמש ב-dc-1, אלא אם מתקינים בסביבה של כמה מרכזי נתונים. בהתקנה של כמה מרכזי נתונים, הערך הוא dc-1 או dc-2 וכו', בהתאם למרכז הנתונים שמתקינים. עם זאת, אתם לא מוגבלים לשימוש בשמות בפורמט dc-#, ואתם יכולים להשתמש בכל שם לאזור. |
|
ZK_HOSTS |
כתובות ה-IP או שמות ה-DNS של צומתי ZooKeeper. כתובות ה-IP או שמות ה-DNS צריכים להופיע באותו סדר בכל צומתי ZooKeeper. בסביבה של כמה מרכזי נתונים, צריך לציין את כל צומתי ZooKeeper משני מרכזי הנתונים. ציינו את המשתנה ":observer" בצומתי ZooKeeper רק כשאתם יוצרים כמה מרכזי נתונים, כמו שמתואר בהתקנה של 12 מארחים. בהתקנה של מרכז נתונים יחיד, משמיטים את המאפיין הזה. מידע נוסף זמין במאמר התקנה באשכול של 12 מארחים. |
|
ZK_CLIENT_HOSTS |
כתובות ה-IP או שמות ה-DNS של צומתי ZooKeeper שמשמשים את מרכז הנתונים הזה. כתובות ה-IP או שמות ה-DNS צריכים להופיע באותו סדר בכל צומתי ZooKeeper. בהתקנה של מרכז נתונים יחיד, אלה אותם צמתים שצוינו על ידי ZK_HOSTS. בסביבה של כמה מרכזי נתונים, צריך לציין רק את צומתי ZooKeeper במרכז הנתונים הזה. מידע נוסף זמין במאמר התקנה באשכול של 12 מארחים. |
|
CASS_HOSTS |
כתובות ה-IP (לא שמות DNS) של צומתי Cassandra. שני הצמתים הראשונים ישמשו כשרתי seed. כתובות ה-IP צריכות להיות רשומות באותו סדר בכל צומתי Cassandra. לצומתי Cassandra יכולה להיות סיומת אופציונלית ":dc,ra" שמציינת את מרכז הנתונים ואת המדף של צומת Cassandra. ציינו את המשתנה הזה רק כשאתם יוצרים כמה מרכזי נתונים, כמו שמתואר בהתקנה של 12 מארחים. אם מתקינים במרכז נתונים אחד, משמיטים את המאפיין הזה. לדוגמה, '192.168.124.201:1,1 = מרכז נתונים 1 וארון שרתים/אזור זמינות 1, ו-'192.168.124.204:2,1 = מרכז נתונים 2 וארון שרתים/אזור זמינות 1. בסביבה עם כמה מרכזי נתונים, כדי להתגבר על בעיות בחומת האש, צריך לסדר את CASS_HOSTS באופן (כמו בדוגמה שלמעלה) שבו הצמתים של מרכז הנתונים הנוכחי ממוקמים בהתחלה. מידע נוסף זמין במאמר התקנה באשכול של 12 מארחים. |
|
CASS_AUTH CASS_PASSWORD |
אם מפעילים את האימות של Cassandra, CASS_AUTH=y, אפשר להעביר את שם המשתמש והסיסמה של Cassandra באמצעות המאפיינים האלה. |
|
PG_MASTER PG_STANDBY |
הגדרה להפעלת שכפול של Postgres master-standby, בפורמט: PG_MASTER=IPorDNSofNewMaster PG_STANDBY=IPorDNSofOldMaster |
|
SKIP_SMTP |
מגדירים SMTP כדי ש-Edge יוכל לשלוח אימיילים לגבי סיסמאות שאבדו והתראות אחרות. אם לא נדרשים פרטי כניסה של משתמש SMTP, משמיטים את SMTPUSER ואת SMTPPASSWORD. |
סדר התקנת הרכיבים
סדר ההתקנה של הרכיבים מבוסס על הטופולוגיה הרצויה.
כל דוגמאות ההתקנה שמוצגות בהמשך מבוססות על ההנחה שאתם מתקינים:
- כשהאימות של Cassandra מושבת (ברירת המחדל). מידע נוסף זמין במאמר הפעלת אימות של Cassandra.
- כשהרפליקציה של Postgres master-standby מושבתת (ברירת המחדל). מידע נוסף זמין במאמר הגדרת שכפול מאסטר-המתנה ל-Postgres.
- מעבד בקשות ונתב באותו צומת. אם מתקינים את מעבדי ההודעות והנתבים בצמתים שונים, קודם מתקינים את כל מעבדי ההודעות ואז את כל הנתבים.
קובצי יומן של ההתקנה
כברירת מחדל, כלי השירות setup.sh כותב מידע ביומן על ההתקנה בנתיב:
/opt/apigee/var/log/apigee-setup/setup.log
אם למשתמש שמריץ את הכלי setup.sh אין גישה לספרייה הזו, היומן נכתב בספרייה /tmp כקובץ בשם setup_username.log.
אם למשתמש אין גישה אל /tmp, הכלי setup.sh נכשל.
התקנה של הכל במקום אחד
- מתקינים את כל הרכיבים בצומת אחד באמצעות הפקודה:
> /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile - מוחקים את כל הקבצים ב-/opt/nginx/conf.d:
> rm -f /opt/nginx/conf.d/* - מפעילים מחדש את Edge Router:
> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart - בודקים את ההתקנה לפי ההוראות שבקטע בדיקת ההתקנה.
- מגדירים את הארגון כמו שמתואר במאמר הגדרת ארגון.
למטה מוצג קובץ תצורה שקט לטופולוגיה הזו:
# With SMTP IP1=IPorDNSnameOfNode HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@apigee.com APIGEE_ADMINPW=Secret123 LICENSE_FILE=/tmp/license.txt MSIP=$IP1 LDAP_TYPE=1 APIGEE_LDAPPW=secret BIND_ON_ALL_INTERFACES=y MP_POD=gateway REGION=dc-1 ZK_HOSTS="$IP1" ZK_CLIENT_HOSTS="$IP1" # Must use IP addresses for CASS_HOSTS, not DNS names. CASS_HOSTS="$IP1" SKIP_SMTP=n SMTPHOST=smtp.example.com SMTPUSER=smtp@example.com # omit for no username SMTPPASSWORD=smtppwd # omit for no password SMTPSSL=n SMTPPORT=25
התקנה עצמאית עם 2 מארחים
במאמר טופולוגיות של התקנה מפורטות הטופולוגיות של Edge ומספרי הצמתים.
- מתקינים את השער העצמאי ואת צומת 1
> /opt/apigee/apigee-setup/bin/setup.sh -p sa -f configFile - בצומת 1:
- מוחקים את כל הקבצים ב-/opt/nginx/conf.d:
> rm -f /opt/nginx/conf.d/* - מפעילים מחדש את Edge Router:
> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
- מוחקים את כל הקבצים ב-/opt/nginx/conf.d:
- מתקינים את Analytics בצומת 2:
> /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile - בודקים את ההתקנה לפי ההוראות שבקטע בדיקת ההתקנה.
- מגדירים את הארגון כמו שמתואר במאמר הגדרת ארגון.
למטה מוצג קובץ תצורה שקט לטופולוגיה הזו:
# With SMTP IP1=IPorDNSnameOfNode1 HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@apigee.com APIGEE_ADMINPW=Secret123 LICENSE_FILE=/tmp/license.txt MSIP=$IP1 LDAP_TYPE=1 APIGEE_LDAPPW=secret BIND_ON_ALL_INTERFACES=y MP_POD=gateway REGION=dc-1 ZK_HOSTS="$IP1" ZK_CLIENT_HOSTS="$IP1" # Must use IP addresses for CASS_HOSTS, not DNS names. CASS_HOSTS="$IP1" SKIP_SMTP=n SMTPHOST=smtp.example.com SMTPUSER=smtp@example.com # omit for no username SMTPPASSWORD=smtppwd # omit for no password SMTPSSL=n SMTPPORT=25
התקנה באשכול של 5 מארחים
במאמר טופולוגיות של התקנה מפורטות הטופולוגיות של Edge ומספרי הצמתים.
- מתקינים את אשכול מאגר הנתונים בצמתים 1, 2 ו-3:
> /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile - מתקינים את שרת הניהול בצומת 1:
> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile - בצמתים 2 ו-3:
- מתקינים את הנתב ואת מעבד הבקשות:
> /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile - מוחקים את כל הקבצים ב-/opt/nginx/conf.d:
> rm -f /opt/nginx/conf.d/* - מפעילים מחדש את Edge Router:
> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
- מתקינים את הנתב ואת מעבד הבקשות:
- מתקינים את Analytics בצמתים 4 ו-5:
> /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile - בודקים את ההתקנה לפי ההוראות שבקטע בדיקת ההתקנה.
- מגדירים את הארגון כמו שמתואר במאמר הגדרת ארגון.
למטה מוצג קובץ תצורה שקט לטופולוגיה הזו:
# With SMTP IP1=IPorDNSnameOfNode1 IP2=IPorDNSnameOfNode2 IP3=IPorDNSnameOfNode3 IP4=IPorDNSnameOfNode4 IP5=IPorDNSnameOfNode5 HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@apigee.com APIGEE_ADMINPW=Secret123 LICENSE_FILE=/tmp/license.txt MSIP=$IP1 USE_LDAP_REMOTE_HOST=n LDAP_TYPE=1 APIGEE_LDAPPW=secret BIND_ON_ALL_INTERFACES=y MP_POD=gateway REGION=dc-1 ZK_HOSTS="$IP1 $IP2 $IP3" ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" # Must use IP addresses for CASS_HOSTS, not DNS names. CASS_HOSTS="$IP1 $IP2 $IP3" PG_MASTER=$IP4 PG_STANDBY=$IP5 SKIP_SMTP=n SMTPHOST=smtp.example.com SMTPUSER=smtp@example.com # omit for no username SMTPPASSWORD=smtppwd # omit for no password SMTPSSL=n SMTPPORT=25
התקנה באשכול של 9 מארחים
במאמר טופולוגיות של התקנה מפורטות הטופולוגיות של Edge ומספרי הצמתים.
- מתקינים את Datastore Cluster Node בצמתים 1, 2 ו-3:
> /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile - מתקינים את שרת הניהול של Apigee בצומת 1:
> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile - בצמתים 4 ו-5:
- מתקינים את הנתב ואת מעבד הבקשות:
> /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile - מוחקים את כל הקבצים ב-/opt/nginx/conf.d:
> rm -f /opt/nginx/conf.d/* - מפעילים מחדש את Edge Router:
> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
- מתקינים את הנתב ואת מעבד הבקשות:
- מתקינים את שרת Apigee Analytics Qpid בצמתים 6 ו-7:
> /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile - מתקינים את שרת Postgres של Apigee Analytics בצמתים 8 ו-9:
> /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile - בודקים את ההתקנה לפי ההוראות שבקטע בדיקת ההתקנה.
- מגדירים את הארגון כמו שמתואר במאמר הגדרת ארגון.
למטה מוצג קובץ תצורה שקט לטופולוגיה הזו:
# With SMTP IP1=IPorDNSnameOfNode1 IP2=IPorDNSnameOfNode2 IP3=IPorDNSnameOfNode3 IP8=IPorDNSnameOfNode8 IP9=IPorDNSnameOfNode9 HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@apigee.com APIGEE_ADMINPW=Secret123 LICENSE_FILE=/tmp/license.txt MSIP=$IP1 USE_LDAP_REMOTE_HOST=n LDAP_TYPE=1 APIGEE_LDAPPW=secret BIND_ON_ALL_INTERFACES=y MP_POD=gateway REGION=dc-1 ZK_HOSTS="$IP1 $IP2 $IP3" ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" # Must use IP addresses for CASS_HOSTS, not DNS names. CASS_HOSTS="$IP1 $IP2 $IP3" SKIP_SMTP=n PG_MASTER=$IP8 PG_STANDBY=$IP9 SMTPHOST=smtp.example.com SMTPUSER=smtp@example.com # omit for no username SMTPPASSWORD=smtppwd # omit for no password SMTPSSL=n SMTPPORT=25
התקנה באשכול של 13 מארחים
במאמר טופולוגיות של התקנה מפורטות הטופולוגיות של Edge ומספרי הצמתים.
- מתקינים את Datastore Cluster Node בצמתים 1, 2 ו-3:
> /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile - מתקינים את OpenLDAP בצומת 4 ובצומת 5:
> /opt/apigee/apigee-setup/bin/setup.sh -p ld -f configFile - מתקינים את שרת הניהול של Apigee בצמתים 6 ו-7:
> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile - מתקינים את שרת Postgres של Apigee Analytics בצמתים 8 ו-9:
> /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile - בצמתים 10 ו-11:
- מתקינים את הנתב ואת מעבד הבקשות:
> /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile - מוחקים את כל הקבצים ב-/opt/nginx/conf.d:
> rm -f /opt/nginx/conf.d/* - מפעילים מחדש את Edge Router:
> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
- מתקינים את הנתב ואת מעבד הבקשות:
- מתקינים את Apigee Analytics Qpid Server בצמתים 12 ו-13:
> /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile - בודקים את ההתקנה לפי ההוראות שבקטע בדיקת ההתקנה.
- מגדירים את הארגון כמו שמתואר במאמר הגדרת ארגון.
למטה מוצג קובץ תצורה שקט לטופולוגיה הזו:
# For all components except OpenLDAP IP1=IPorDNSnameOfNode1 IP2=IPorDNSnameOfNode2 IP3=IPorDNSnameOfNode3 IP4=IPorDNSnameOfNode4 IP5=IPorDNSnameOfNode5 IP6=IPorDNSnameOfNode6 IP7=IPorDNSnameOfNode7 IP8=IPorDNSnameOfNode8 IP9=IPorDNSnameOfNode9 HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@apigee.com APIGEE_ADMINPW=Secret123 LICENSE_FILE=/tmp/license.txt # First Management Server on IP6 MSIP=$IP6 USE_LDAP_REMOTE_HOST=y LDAP_HOST=$IP4 LDAP_PORT=10389 # Second Management Server on IP7 # MSIP=$IP7 # USE_LDAP_REMOTE_HOST=y # LDAP_HOST=$IP5 # LDAP_PORT=10389 # Same password for both OpenLDAPs. APIGEE_LDAPPW=secret BIND_ON_ALL_INTERFACES=y MP_POD=gateway REGION=dc-1 ZK_HOSTS="$IP1 $IP2 $IP3" ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" # Must use IP addresses for CASS_HOSTS, not DNS names. CASS_HOSTS="$IP1 $IP2 $IP3" PG_MASTER=$IP8 PG_STANDBY=$IP9 SKIP_SMTP=n SMTPHOST=smtp.example.com SMTPUSER=smtp@example.com # omit for no username SMTPPASSWORD=smtppwd # omit for no password SMTPSSL=n SMTPPORT=25 |
# For OpenLDAP on IP4 and IP5 IP1=IPorDNSnameOfNode1 IP2=IPorDNSnameOfNode2 IP3=IPorDNSnameOfNode3 IP4=IPorDNSnameOfNode4 IP5=IPorDNSnameOfNode5 IP6=IPorDNSnameOfNode6 IP7=IPorDNSnameOfNode7 IP8=IPorDNSnameOfNode8 IP9=IPorDNSnameOfNode9 HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@apigee.com APIGEE_ADMINPW=Secret123 # First OpenLDAP Server on IP4 MSIP=$IP6 USE_LDAP_REMOTE_HOST=n LDAP_TYPE=2 LDAP_SID=1 LDAP_PEER=$IP5 # Second OpenLDAP Server on IP5 # MSIP=$IP7 # USE_LDAP_REMOTE_HOST=n # LDAP_TYPE=2 # LDAP_SID=2 # LDAP_PEER=$IP4 # Set same password for both OpenLDAPs. APIGEE_LDAPPW=secret |
התקנה באשכול של 12 מארחים
לפני שמתקינים את Edge בטופולוגיית אשכול עם 12 מארחים (שני מרכזי נתונים), צריך להבין איך להגדיר את המאפיינים של ZooKeeper ו-Cassandra בקובץ התצורה השקט.
- ZooKeeper
במאפיין ZK_HOSTS של שני מרכזי הנתונים, מציינים את כתובות ה-IP או שמות ה-DNS של כל צומתי ZooKeeper משני מרכזי הנתונים, באותו סדר, ומסמנים את כל הצמתים באמצעות המשנה ":observer". צמתים בלי המאפיין ":observer" נקראים "מצביעים". מספר "המצביעים" בהגדרות חייב להיות אי-זוגי.
בטופולוגיה הזו, המארח של ZooKeeper במארח 9 הוא הצופה:

במאפיין ZK_CLIENT_HOSTS של כל מרכז נתונים, מציינים את כתובות ה-IP או את שמות ה-DNS של הצמתים של ZooKeeper במרכז הנתונים בלבד, באותו סדר, לכל הצמתים של ZooKeeper במרכז הנתונים. בקובץ התצורה לדוגמה שמוצג בהמשך, צומת 9 מתויג עם המשנה ":observer" כך שיש חמישה מצביעים: צמתים 1, 2, 3, 7 ו-8. - Cassandra
בכל מרכזי הנתונים צריך להיות אותו מספר של צומתי Cassandra.
ב-CASS_HOSTS לכל מרכז נתונים, חשוב לציין את כל כתובות ה-IP של Cassandra (לא שמות DNS) לשני מרכזי הנתונים. במרכז הנתונים הראשון, קודם מפרטים את צומתי Cassandra במרכז הנתונים הזה. במרכז נתונים 2, קודם צריך לציין את צומתי Cassandra במרכז הנתונים הזה. צריך לרשום את צומתי Cassandra באותו סדר בכל צומתי Cassandra במרכז הנתונים.
לכל צומתי Cassandra חייבת להיות הסיומת ':<d>,<r>', לדוגמה '<ip>:1,1 = מרכז נתונים 1 ומתלה/אזור זמינות 1 ו-'<ip>:2,1 = מרכז נתונים 2 ומתלה/אזור זמינות 1.
לדוגמה, "192.168.124.201:1,1 192.168.124.202:1,1 192.168.124.203:1,1 192.168.124.204:2,1 192.168.124.205:2,1 192.168.124.206:2,1"
הצומת הראשון במדף/אזור הזמינות 1 של כל מרכז נתונים ישמש כשרת ה-seed.
במודל הפריסה הזה, ההגדרה של Cassandra תיראה כך:

במאמר טופולוגיות של התקנה מפורטות הטופולוגיות של Edge ומספרי הצמתים.
- מתקינים את Datastore Cluster Node בצמתים 1, 2, 3, 7, 8 ו-9:
> /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile - מתקינים את שרת הניהול של Apigee עם שכפול OpenLDAP בצומת 1 ו-7:
> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile - בצמתים 2, 3, 8 ו-9:
- מתקינים את הנתב ואת מעבד הבקשות:
> /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile - מוחקים את כל הקבצים ב-/opt/nginx/conf.d:
> rm -f /opt/nginx/conf.d/* - מפעילים מחדש את Edge Router:
> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
- מתקינים את הנתב ואת מעבד הבקשות:
- מתקינים את Apigee Analytics Qpid Server בצמתים 4, 5, 10 ו-11:
> /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile - מתקינים את Apigee Analytics Postgres Server בצומת 6 ו-12:
> /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile - בודקים את ההתקנה לפי ההוראות שבקטע בדיקת ההתקנה.
- מגדירים את הארגון כמו שמתואר במאמר הגדרת ארגון.
בהמשך מוצג קובץ תצורה שקט לטופולוגיה הזו. שימו לב שבקובץ התצורה הזה:
- הגדרת OpenLDAP עם שכפול בשני צומתי OpenLDAP.
- מציין את המשנה ":observer" בצומת ZooKeeper אחד. בהתקנה של מרכז נתונים יחיד, משמיטים את המשתנה הזה.
# Datacenter 1 IP1=IPorDNSnameOfNode1 IP2=IPorDNSnameOfNode2 IP3=IPorDNSnameOfNode3 IP6=IPorDNSnameOfNode6 IP7=IPorDNSnameOfNode7 IP8=IPorDNSnameOfNode8 IP9=IPorDNSnameOfNode9 IP12=IPorDNSnameOfNode12 HOSTIP=$(hostname -i) MSIP=$IP1 ADMIN_EMAIL=opdk@apigee.com APIGEE_ADMINPW=Secret123 LICENSE_FILE=/tmp/license.txt USE_LDAP_REMOTE_HOST=n LDAP_TYPE=2 LDAP_SID=1 LDAP_PEER=$IP7 APIGEE_LDAPPW=secret BIND_ON_ALL_INTERFACES=y MP_POD=gateway-1 REGION=dc-1 ZK_HOSTS="$IP1 $IP2 $IP3 $IP7 $IP8 $IP9:observer" ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" # Must use IP addresses for CASS_HOSTS, not DNS names. CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1 $IP7:2,1 $IP8:2,1 $IP9:2,1" PG_MASTER=$IP6 PG_STANDBY=$IP12 SKIP_SMTP=n SMTPHOST=smtp.example.com SMTPUSER=smtp@example.com # omit for no username SMTPPASSWORD=smtppwd # omit for no password SMTPSSL=n SMTPPORT=25 |
# Datacenter 2 IP1=IPorDNSnameOfNode1 IP2=IPorDNSnameOfNode2 IP3=IPorDNSnameOfNode3 IP6=IPorDNSnameOfNode6 IP7=IPorDNSnameOfNode7 IP8=IPorDNSnameOfNode8 IP9=IPorDNSnameOfNode9 IP12=IPorDNSnameOfNode12 HOSTIP=$(hostname -i) MSIP=$IP7 ADMIN_EMAIL=opdk@apigee.com APIGEE_ADMINPW=Secret123 LICENSE_FILE=/tmp/license.txt USE_LDAP_REMOTE_HOST=n LDAP_TYPE=2 LDAP_SID=2 LDAP_PEER=$IP1 APIGEE_LDAPPW=secret BIND_ON_ALL_INTERFACES=y MP_POD=gateway-2 REGION=dc-2 ZK_HOSTS="$IP1 $IP2 $IP3 $IP7 $IP8 $IP9:observer" ZK_CLIENT_HOSTS="$IP7 $IP8 $IP9" # Must use IP addresses for CASS_HOSTS, not DNS names. CASS_HOSTS="$IP7:2,1 $IP8:2,1 $IP9:2,1 $IP1:1,1 $IP2:1,1 $IP3:1,1" PG_MASTER=$IP6 PG_STANDBY=$IP12 SKIP_SMTP=n SMTPHOST=smtp.example.com SMTPUSER=smtp@example.com # omit for no username SMTPPASSWORD=smtppwd # omit for no password SMTPSSL=n SMTPPORT=25 |