התקנת רכיבים של Edge בצומת

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

כלי השירות apigee-setup משתמש בפקודה בצורה:

/opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

כאשר component הוא רכיב Edge להתקנה, ו-configFile הוא קובץ התצורה להתקנה שקטה שמכיל את פרטי ההתקנה. קובץ התצורה צריך להיות נגיש או קריא למשתמש 'apigee'. לדוגמה, אפשר ליצור ספרייה חדשה לקבצים, למקם אותם בספרייה ‎ /usr/local או בספרייה ‎/usr/local/share, או בכל מקום אחר בצומת שזמין למשתמש ‎apigee.

לדוגמה, כדי להתקין את Edge Management Server:

/opt/apigee/apigee-setup/bin/setup.sh -p ms -f /usr/local/myConfig

למידע על התקנת התוסף apigee-setup של Edge, אפשר להיעזר במאמר התקנת כלי ההגדרה של Edge apigee-setup.

שיקולים בקשר להתקנה

כשתכתבו את קובץ התצורה, כדאי להביא בחשבון את האפשרויות הבאות.

הגדרת רפליקציה של Postgres בין שרת ראשי לשרת ניצב

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

אפשר להפעיל ולהגדיר את העתקה ממאסטרים למצב המתנה בזמן ההתקנה באמצעות מאפיינים בקובץ התצורה להתקנה שקטה. לחלופין, אפשר להפעיל את העתקת המאסטר למצב המתנה אחרי ההתקנה. מידע נוסף זמין במאמר הגדרת רפליקציה של master-standby ל-Postgres.

שיקולים לגבי openldap 2.4 ב-RHEL 9.X/‏Rocky 9.X/‏Oracle 9.X

כדי להתקין את ה-OpenLDAP בארגון צריך את הגרסה 2.4, שכלולה במאגר apigee-thirdparty-opdk. כדי להקל על ההתקנה, צריך להסיר את הספרייה openldap-compat.

בהתקנות של 13 מארחים ובהתקנות של 12 מארחים עם שני מרכזי נתונים נדרשת רפליקציית OpenLDAP כי יש כמה צמתים שמארחים את OpenLDAP.

הפעלת אימות ב-Cassandra

כברירת מחדל, Cassandra מתקינה ללא אימות מופעל. כלומר, כל אחד יכול לגשת ל-Cassandra. אפשר להפעיל את האימות אחרי התקנת Edge, או כחלק מתהליך ההתקנה.

מידע נוסף זמין במאמר הפעלת אימות ב-Cassandra.

שימוש ביציאה מוגנת כשיוצרים מארח וירטואלי

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

במאמר הגדרת מארח וירטואלי מוסבר איך להגדיר מארח וירטואלי ונתב גישה ליציאות מתחת ל-1,000.

דרישות חדשות שהוצגו על ידי apigee-qpidd-4.52.01-X.X.X

החל מגרסה 4.52.01, נוספו דרישות חדשות במהלך ההתקנה. כדי להשתמש בה, צריך לכלול את המאפיינים QPID_MGMT_USERNAME ו-QPID_MGMT_PASSWORD במהלך ההתקנה. כדי שההתקנה תתבצע בהצלחה, חשוב לוודא שהמאפיינים האלה נוספו עם ערכים מתאימים בקובץ התצורה.

התקנת ממשק המשתמש החדש של Edge

אחרי השלמת ההתקנה הראשונית, מומלץ להתקין את ממשק המשתמש החדש של Edge. זהו ממשק משתמש משופר למפתחים ולמנהלים של Apigee Edge לענן פרטי. (ממשק המשתמש הקלאסי מותקן כברירת מחדל).

חשוב לזכור שבממשק המשתמש של Edge צריך להשבית את האימות הבסיסי ולהשתמש ב-IDP כמו SAML או LDAP.

מידע נוסף זמין במאמר התקנת ממשק המשתמש החדש של Edge.

ציון הרכיבים להתקנה

בטבלה הבאה מפורטות האפשרויות שאפשר להעביר לאפשרות -p של הכלי apigee-service כדי לציין אילו רכיבים להתקין בצומת:

רכיב תיאור

c

מתקינים את Cassandra בלבד.
zk התקנה של ZooKeeper בלבד.

ds

מתקינים את ZooKeeper ואת Cassandra.

ld

יש להתקין את OpenLDAP בלבד.

mt

מתקינים את Edge Management Server, שמתקין גם את OpenLDAP.

אם מגדירים את הערך USE_LDAP_REMOTE_HOST=y בקובץ התצורה, ההתקנה של OpenLDAP תועבר על פני ושרתי הניהול ישתמשו ב-OpenLDAP שמותקן בצומת אחר.

ms

מתקינים את Edge Management Server, שמתקין גם את ממשק המשתמש של Edge ו-OpenLDAP.

אם מגדירים את הערך USE_LDAP_REMOTE_HOST=y בקובץ התצורה, המערכת מדלגת על התקנת OpenLDAP ושרת הניהול משתמש ב-OpenLDAP שמותקן בצומת אחר.

r

יש להתקין את נתב Edge בלבד.

mp

מתקינים רק את Edge Message Processor.

rmp

מתקינים נתב Edge ומעבד הודעות.

ui

מתקינים את ממשק המשתמש של Edge.

qs

מתקינים את Qpid Server בלבד.

ps

התקנה של שרת Postgres בלבד.
pdb התקנת מסד נתונים של Postgres בלבד – משמש רק כשמתקינים את פורטל השירותים למפתחים של Apigee (או פשוט, הפורטל). איך מתקינים את הפורטל

sax

מתקינים את רכיבי הניתוח, כלומר Qpid ו-Postgres.

יש להשתמש באפשרות הזו לפיתוח ובבדיקה בלבד, ולא בסביבת הייצור.
sso התקנת מודול ה-SSO של Apigee.

mo

מתקינים את התוסף Monetization.

sa

התקנה של Edge כמכונה עצמאית, כלומר Cassandra,‏ ZooKeeper,‏ Management Server,‏ OpenLDAP,‏ Edge UI,‏ Router ו-Message Processor. האפשרות הזו משמיטה את רכיבי הניתוח של Edge:‏ Qpid ו-Postgres.

יש להשתמש באפשרות הזו לפיתוח ובבדיקה בלבד, ולא בסביבת הייצור.

aio

התקנת כל הרכיבים בצומת אחד.

יש להשתמש באפשרות הזו לפיתוח ולבדיקה בלבד, ולא בסביבת הייצור.
dp

מתקינים את הפורטל.

יצירת קובץ תצורה

קובץ התצורה מכיל את כל המידע הנדרש להתקנת Edge. לעיתים קרובות אפשר להשתמש באותו קובץ תצורה כדי להתקין את כל הרכיבים בהתקנת Edge.

עם זאת, תצטרכו להשתמש בקובצי תצורה שונים או לשנות את קובץ התצורה אם:

  • אתם מתקינים כמה שרתים של OpenLDAP ואתם צריכים להגדיר את הרפליקציה כחלק מהתקנה של 13 צמתים. לכל קובץ נדרשים ערכים שונים עבור LDAP_SID ו-LDAP_PEER.
  • בחרת ליצור מספר מרכזי נתונים כחלק מהתקנה של 12 צמתים. בכל מרכז נתונים נדרשות הגדרות שונות למאפיינים כמו ZK_CLIENT_HOSTS ו-CASS_HOSTS.

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

בדיקת דרישות המערכת בלי להריץ התקנה

ב-Edge for the Private Cloud יש תמיכה בנכס ENABLE_SYSTEM_CHECK=y כדי לבדוק את דרישות המעבד והזיכרון במכונה במהלך ההתקנה. עם זאת, בגרסאות קודמות של Edge, הבדיקה הזו חייבה לבצע את ההתקנה בפועל.

עכשיו אפשר להשתמש בדגל '-t' כדי לבצע את הבדיקה הזו בלי צורך בהתקנה. לדוגמה, כדי לבדוק את דרישות המערכת להתקנה מסוג 'aio' בלי לבצע את ההתקנה בפועל, משתמשים בפקודה הבאה:

/opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile -t

הפקודה הזו מציגה במסך את כל השגיאות שקשורות לדרישות המערכת.

רשימת דרישות המערכת לכל רכיבי Edge מופיעה במאמר דרישות ההתקנה.

קובצי יומן של התקנה

כברירת מחדל, השירות setup.sh רושם את פרטי היומן של ההתקנה בנתיב הבא:

/opt/apigee/var/log/apigee-setup/setup.log

אם למשתמש שמפעיל את השירות setup.sh אין גישה לספרייה הזו, השירות יכתוב את היומן בספרייה /tmp כקובץ בשם setup_username.log.

אם למשתמש אין גישה ל-/tmp, השירות setup.sh נכשל.

התקנת רכיבי Edge

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

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

  • כשאימות Cassandra מושבת (ברירת המחדל). מידע נוסף זמין במאמר הפעלת אימות ב-Cassandra.
  • כשהרפליקציה של Postgres ממאסטרים למצב המתנה מושבתת (ברירת המחדל). מידע נוסף זמין במאמר הגדרת רפליקציית המתנה ראשית ל-Postgres.
  • מעבד הודעות ונתב באותו צומת. אם מתקינים את מעבדי ההודעות והנתבים בצמתים שונים, צריך להתקין קודם את כל מעבדי ההודעות ואז את כל הנתב.

דרישות מוקדמות

כדי להתקין רכיבי Edge, צריך:

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

התקנה משולבת

  1. כדי להתקין את כל הרכיבים בצומת יחיד, משתמשים בפקודה: 
    /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
  2. מפעילים מחדש את רכיב ממשק המשתמש הקלאסי אחרי השלמת ההתקנה: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    ההנחיה הזו רלוונטית לממשק המשתמש הקלאסי, ולא לממשק המשתמש החדש של Edge, ששם הרכיב שלו הוא edge-management-ui.

  3. בודקים את ההתקנה כפי שמתואר במאמר בדיקת ההתקנה.
  4. מוסיפים את הארגון כפי שמתואר במאמר הוספת ארגון.

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

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

# With SMTP
IP1=IP_or_DNS_name_of_Node_1
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
# Admin password must be at least 8 characters long and contain one uppercase
# letter, one lowercase letter, and one digit or special character
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
LDAP_TYPE=1
APIGEE_LDAPPW=LDAP_PASSWORD
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"
# Default is postgres
PG_PWD=postgres
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234

התקנה עצמאית של שני צמתים

במאמר טופולוגיות של התקנה אפשר למצוא רשימה של הטופולוגיות של Edge ומספרי הצמתים.

  1. התקנה של Standalone Gateway ושל צומת 1 
    /opt/apigee/apigee-setup/bin/setup.sh -p sa -f configFile
  2. מתקינים את Analytics בצומת 2: 
    /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile
  3. מפעילים מחדש את רכיב ממשק המשתמש הקלאסי בצומת 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    ההנחיה הזו מתייחסת לממשק המשתמש הקלאסי ולא לממשק המשתמש החדש של Edge, ששם הרכיב שלו הוא edge-management-ui.

  4. בודקים את ההתקנה כפי שמתואר בקטע בדיקת ההתקנה.
  5. מוסיפים את הארגון לפי ההוראות במאמר הוספת ארגון.

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

# With SMTP
IP1=IP_of_Node_1
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
LDAP_TYPE=1
APIGEE_LDAPPW=LDAP_PASSWORD
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"
# Default is postgres
PG_PWD=postgres
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234

התקנה עם 5 צמתים

בטופולוגיות התקנה מופיעה רשימה של טופולוגיות Edge ומספרי צמתים.

  1. התקנת אשכול Datastore בצמתים 1, 2 ו-3: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. התקנת שרת ניהול בצומת 1: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. מתקינים את הנתב ואת מעבד ההודעות בצמתים 2 ו-3: 
    /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. מתקינים את Analytics בצמתים 4 ו-5: 
    /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile
  5. מפעילים מחדש את רכיב ממשק המשתמש הקלאסי בצומת 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    ההנחיה הזו מתייחסת לממשק המשתמש הקלאסי ולא לממשק המשתמש החדש של Edge, ששם הרכיב שלו הוא edge-management-ui.

  6. בודקים את ההתקנה כפי שמתואר בקטע בדיקת ההתקנה.
  7. מוסיפים את הארגון כפי שמתואר במאמר הוספת ארגון.

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

# With SMTP
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP4=IP_of_Node_4
IP5=IP_of_Node_5
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=1
APIGEE_LDAPPW=LDAP_PASSWORD
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"
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP4
PG_STANDBY=$IP5
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234

התקנה באשכול של 9 צמתים

במאמר טופולוגיות של התקנה אפשר למצוא רשימה של הטופולוגיות של Edge ומספרי הצמתים.

  1. התקנת צומת Datastore Cluster Node בצומת 1, 2 ו-3: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. מתקינים את Apigee Management Server בצומת 1: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. מתקינים את הנתב ומעבד ההודעות בצמתים 4 ו-5: 
    /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. מתקינים את שרת Qpid של Apigee Analytics בצמתים 6 ו-7: 
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. מתקינים את שרת Apigee Analytics Postgres בצמתים 8 ו-9: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. מפעילים מחדש את רכיב ממשק המשתמש הקלאסי בצומת 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    ההגדרה הזו רלוונטית לממשק המשתמש הקלאסי, ולא לממשק המשתמש החדש של Edge, ששם הרכיב שלו הוא edge-management-ui.

  7. בודקים את ההתקנה כפי שמתואר בקטע בדיקת ההתקנה.
  8. מוסיפים את הארגון כפי שמתואר במאמר הוספת ארגון.

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

# With SMTP
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP8=IP_of_Node_8
IP9=IP_of_Node_9
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt 
MSIP=$IP1 
USE_LDAP_REMOTE_HOST=n 
LDAP_TYPE=1
APIGEE_LDAPPW=LDAP_PASSWORD
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.
# Optionally use Cassandra racks
CASS_HOSTS="$IP1 $IP2 $IP3" 
# Default is postgres
PG_PWD=postgres
SKIP_SMTP=n
PG_MASTER=$IP8
PG_STANDBY=$IP9
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234

התקנה באשכולות של 13 צמתים

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

סדר ההתקנה של אשכול עם 13 צמתים הוא:

  1. מתקינים את צומת האשכולות של Datastore בצמתים 1, 2 ו-3: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. התקנת OpenLDAP בצומת 4 ו-5: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ld -f configFile
  3. התקנת Apigee Management Server בצומת 6 ו-7: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  4. מתקינים את שרת Apigee Analytics Postgres בצמתים 8 ו-9: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  5. מתקינים את הנתב ואת מעבד ההודעות בצמתים 10 ו-11: 
    /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  6. מתקינים את שרת Qpid של Apigee Analytics בצמתים 12 ו-13: 
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  7. מפעילים מחדש את הרכיב של ממשק המשתמש הקלאסי בצמתים 6 ו-7: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    ההנחיה הזו רלוונטית לממשק המשתמש הקלאסי, ולא לממשק המשתמש החדש של Edge ששם הרכיב שלו הוא edge-management-ui.

  8. בודקים את ההתקנה כפי שמתואר במאמר בדיקת ההתקנה.
  9. מוסיפים את הארגון כפי שמתואר במאמר הוספת ארגון.

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

# For all nodes except IP4 and IP5
# (which are the OpenLDAP nodes)
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP4=IP_of_Node_4
IP5=IP_of_Node_5
IP6=IP_of_Node_6
IP7=IP_of_Node_7
IP8=IP_of_Node_8
IP9=IP_of_Node_9
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
# Management Server on IP6 only
MSIP=$IP6
USE_LDAP_REMOTE_HOST=y
LDAP_HOST=$IP4
LDAP_PORT=10389
# Management Server on IP7 only
# MSIP=$IP7
# USE_LDAP_REMOTE_HOST=y
# LDAP_HOST=$IP5
# LDAP_PORT=10389
# Use the same password for both OpenLDAP nodes
APIGEE_LDAPPW=LDAP_PASSWORD 
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.
# Optionally use Cassandra racks
CASS_HOSTS="$IP1 $IP2 $IP3"
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP8
PG_STANDBY=$IP9
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234
 
# For OpenLDAP nodes only (IP4 and IP5)
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP4=IP_of_Node_4
IP5=IP_of_Node_5
IP6=IP_of_Node_6
IP7=IP_of_Node_7
IP8=IP_of_Node_8
IP9=IP_of_Node_9
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD

# For the OpenLDAP Server on IP4 only
MSIP=$IP6
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP5

# For the OpenLDAP Server on IP5 only
# MSIP=$IP7
# USE_LDAP_REMOTE_HOST=n
# LDAP_TYPE=2
# LDAP_SID=2
# LDAP_PEER=$IP4
# Set same password for both OpenLDAPs.
APIGEE_LDAPPW=LDAP_PASSWORD

התקנה באשכול של 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) בשני מרכזי הנתונים. במרכז הנתונים 1, קודם כול עליכם לרשום את צמתים של 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.160.124.192.160.124.1

    הצומת הראשון במדף/באזור הזמינות 1 בכל מרכז נתונים ישמש כשרת המקור.

    במודל הפריסה הזה, ההגדרה של Cassandra תיראה כך:

בטופולוגיות התקנה מפורטת רשימה של הטופולוגיות של Edge ומספרי הצמתים.

  1. התקנת צומת האשכול של Datastore בצומת 1, 2, 3, 7, 8 ו-9: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. מתקינים את Apigee Management Server עם רפליקציה של OpenLDAP בצומת 1 ובצומת 7: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. מתקינים את הנתב ואת מעבד ההודעות בצמתים 2, 3, 8 ו-9: 
    /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. התקנה של Apigee Analytics Qpid Server בצומת 4, 5, 10 ו-11: 
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. מתקינים את שרת Apigee Analytics Postgres בצמתים 6 ו-12: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. מפעילים מחדש את הרכיב של ממשק המשתמש הקלאסי בצמתים 1 ו-7: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    ההגדרה הזו חלה על ממשק המשתמש הקלאסי, ולא על ממשק המשתמש החדש של Edge, ששם הרכיב שלו הוא edge-management-ui.

  7. בודקים את ההתקנה כפי שמתואר במאמר בדיקת ההתקנה.
  8. מוסיפים את הארגון לפי ההוראות במאמר הוספת ארגון.

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

  • הגדרת OpenLDAP עם רפליקה בשני צמתים של OpenLDAP.
  • ציון המשתנה :observer בצומת אחד של ZooKeeper. בהתקנה אחת של מרכז נתונים, משמיטים את המאפיין הזה.
# Datacenter 1
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP6=IP_of_Node_6
IP7=IP_of_Node_7
IP8=IP_of_Node_8
IP9=IP_of_Node_9
IP12=IP_of_Node_12
HOSTIP=$(hostname -i)
MSIP=$IP1
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP7
APIGEE_LDAPPW=LDAP_PASSWORD
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.
# Optionally use Cassandra racks
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1 $IP7:2,1 $IP8:2,1 $IP9:2,1"
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP6
PG_STANDBY=$IP12
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234
 
# Datacenter 2
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP6=IP_of_Node_6
IP7=IP_of_Node_7
IP8=IP_of_Node_8
IP9=IP_of_Node_9
IP12=IP_of_Node_12
HOSTIP=$(hostname -i)
MSIP=$IP7
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=2
LDAP_PEER=$IP1
APIGEE_LDAPPW=LDAP_PASSWORD
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.
# Optionally use Cassandra racks
CASS_HOSTS="$IP7:2,1 $IP8:2,1 $IP9:2,1 $IP1:1,1 $IP2:1,1 $IP3:1,1"
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP6
PG_STANDBY=$IP12
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234