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

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

כלי השירות להגדרת apigee משתמש בפקודה באופן הבא:

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

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

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

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

למידע על התקנת Edge apigee-setup, ראו התקנת כלי ההתקנה של Edge apigee.

שיקולי התקנה

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

הגדרת רפליקות של מאסטר של המתנה ל-Postgres

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

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

הפעלת האימות של Cassandra

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

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

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

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

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

דרישות חדשות שנוספו על ידי apigee-qpidd-4.52.01-X.X.X

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

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

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

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

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

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

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

רכיב תיאור

c

התקנת Cassandra בלבד.
zk להתקין אתzoKeeper בלבד.

ds

מתקינים אתzoKeeper ואת 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 Router בלבד.

mp

צריך להתקין את Edge בלבד.

rmp

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

ui

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

qs

התקנת שרת Qpid בלבד.

ps

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

sax

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

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

mo

התקנת מונטיזציה.

sa

אפשר להתקין את Edge העצמאית, כלומר Cassandra, zoKeeper, Management Server, OpenLDAP, ממשק המשתמש של Edge, נתב ומעבד הודעות. האפשרות הזו לא כוללת את רכיבי ניתוח הנתונים של Edge: Qpid ו-Postgres.

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

aio

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

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

התקנת הפורטל.

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

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

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

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

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

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

Edge לענן הפרטי תומך במאפיין ENABLE_SYSTEM_CHECK=y כדי לבדוק את דרישות המעבד (CPU) והזיכרון במחשב כחלק מההתקנה. עם זאת, בגרסאות קודמות של 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 או להגדיר אותו למצב מתירני. למידע נוסף, ראו התקנת כלי השירות של Edge apigee-setup.

התקנה משולבת

  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.

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

# 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=pass1234

התקנה עצמאית עם 2 צמתים

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

  1. התקנת שער עצמאי וצומת 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. להצטרף לארגון כפי שמתואר במאמר איך מצרפים ארגון.

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

# 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=pass1234

התקנת 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. להצטרף לארגון כפי שמתואר במאמר איך מצרפים ארגון.

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

# 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=pass1234

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

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

  1. התקנת צומת האשכול של Datastore בצמתים 1, 2 ו-3: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. התקנת שרת הניהול של Apigee בצומת 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. התקנת שרת Apigee Analytics Qpid בצומת 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. להצטרף לארגון כפי שמתואר במאמר איך מצרפים ארגון.

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

# 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=pass1234

התקנת אשכולות של 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 בצומת 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. התקנת שרת Apigee Analytics Qpid בצומת 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. להצטרף לארגון כפי שמתואר במאמר איך מצרפים ארגון.

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

# 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=pass1234
 
# 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 צמתים (שני מרכזי נתונים), צריך להבין איך להגדיר את המאפיינים שלzo Keeper ו-Cassandra בקובץ התצורה השקט.

  • ZooKeeper

    עבור המאפיין ZK_HOSTS בשני מרכזי הנתונים, צריך לציין את כתובות ה-IP או את שמות ה-DNS של כל הצמתים שלzoKeeper משני מרכזי הנתונים, באותו סדר, ולסמן צמתים באמצעות הערך של :observer. צמתים ללא מגביל :observer נקראים 'מצביעים'. חייב להיות לך מספר אי-זוגי של "מצביעים" בהגדרה.

    בטופולוגיה הזו, המארח שלzoKeeper במארח 9 הוא הצופה:

    עבור המאפיין ZK_CLIENT_HOSTS בכל מרכז נתונים, צריך לציין את כתובות ה-IP או את שמות ה-DNS של הצמתים שלzoKeeper בלבד במרכז הנתונים, באותו סדר, בכל הצמתים שלzoKeeper במרכז הנתונים. בקובץ התצורה לדוגמה שמוצג למטה, צומת 9 מתויג עם הצירוף :observer כך שיהיו לך חמישה מצביעים: צמתים 1, 2, 3, 7 ו-8.

  • קסנדרה

    כל מרכזי הנתונים צריכים לכלול את אותו מספר צמתים של Cassandra.

    עבור CASS_HOSTS בכל מרכז נתונים, חשוב לציין את כל כתובות ה-IP של Cassandra (לא שמות DNS) בשני מרכזי הנתונים. ל-Data Center 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.1624.192.160.124.

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

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

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

  1. התקנת צומת האשכול של Datastore בצמתים 1, 2, 3, 7, 8 ו-9: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. התקנת שרת ניהול של Apigee עם רפליקות 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. התקנה של שרת ה-Qpid של Apigee Analytics בצמתים 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. להצטרף לארגון כפי שמתואר במאמר איך מצרפים ארגון.

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

  • הגדרת OpenLDAP עם שכפול בשני צומתי OpenLDAP.
  • המדיניות קובעת את הערך של :observer בצומת אחד שלzoKeeper. בהתקנה של מרכז נתונים אחד, משמיטים את ההתאמה.
# 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=pass1234
 
# 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=pass1234