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

Edge for Private Cloud גרסה 4.16.09

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

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

> /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

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

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

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

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

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

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

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

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

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

קישור הנתב ליציאה מוגנת

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

כדי להפעיל את הנתב כמשתמש אחר:

  1. כמשתמש root, יוצרים את הקובץ /opt/apigee/etc/edge-router.d/RUN_USER.sh.
  2. מוסיפים את הרשומה הבאה לקובץ:
    RUN_USER=root
    אם לא רוצים להריץ את הנתב כמשתמש Root, צריך לציין משתמש עם גישה ליציאה.
  3. שומרים את הקובץ.
  4. אם ציינתם משתמש אחר שהוא לא root, צריך לשנות את הבעלים של הקובץ למשתמש הזה:
    > chown USER:USER /opt/apigee/etc/edge-router.d/RUN_USER.sh
  5. מפעילים מחדש את הנתב:
    > /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
APIGEE_ADMINPW

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

LICENSE_FILE

המיקום של קובץ הרישיון, שחייב להיות נגיש למשתמש apigee. לדוגמה, אפשר לאחסן אותו בספרייה ‎ /tmp ולהפעיל את הפקודה chmod 777 על הקובץ. הקובץ מועתק לספריית ההתקנה של Edge.

USE_LDAP_REMOTE_HOST
LDAP_HOST
LDAP_PORT

אם הערך של USE_LDAP_REMOTE_HOST הוא n, ‏ Edge מתקין באופן אוטומטי את OpenLDAP כשהוא מתקין את שרת הניהול.

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

אם אתם מתחברים לשרת OpenLDAP מרוחק, השתמשו ב-LDAP_HOST
וב-LDAP_PORT כדי לציין את כתובת ה-IP או את שם ה-DNS ואת מספר היציאה של המארח.

LDAP_TYPE
LDAP_SID
LDAP_PEER

מגדירים את LDAP_TYPE=1 ל-OpenLDAP בלי שכפול. ‫LDAP_TYPE=2 תואם ל-OpenLDAP עם רפליקציה.

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

אם מפעילים את הרפליקציה, צריך להגדיר את המאפיינים הבאים:

  • ‫LDAP_SID=1 – המזהה הייחודי של שרת ה-LDAP הזה. לכל צומת LDAP יש מזהה שונה. לדוגמה, מגדירים את הערך 2 עבור LDAP peer.
  • ‫LDAP_PEER=10.0.0.1 – כתובת IP או שם DNS של עמית LDAP.

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_USERNAME

CASS_PASSWORD

אם מפעילים את האימות של Cassandra, ‏ CASS_AUTH=y, אפשר להעביר את שם המשתמש והסיסמה של Cassandra באמצעות המאפיינים האלה.

PG_MASTER

PG_STANDBY

הגדרה להפעלת שכפול של Postgres master-standby, בפורמט:

PG_MASTER=IPorDNSofNewMaster

PG_STANDBY=IPorDNSofOldMaster

SKIP_SMTP
SMTPHOST
SMTPUSER
SMTPPASSWORD
SMTPSSL
SMTPPORT

מגדירים 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 נכשל.

התקנה של הכל במקום אחד

  1. מתקינים את כל הרכיבים בצומת אחד באמצעות הפקודה:
    > ‎/opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
  2. בודקים את ההתקנה לפי ההוראות שבקטע בדיקת ההתקנה.
  3. מגדירים את הארגון כמו שמתואר במאמר הגדרת ארגון.

למטה מוצג קובץ תצורה שקט לטופולוגיה הזו:

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

למטה מוצג קובץ תצורה שקט לטופולוגיה הזו:

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

למטה מוצג קובץ תצורה שקט לטופולוגיה הזו:

# 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 ומספרי הצמתים.

  1. מתקינים את Datastore Cluster Node בצמתים 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. מתקינים את שרת Postgres של Apigee Analytics בצמתים 8 ו-9:
    > ‎/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. בודקים את ההתקנה לפי ההוראות שבקטע בדיקת ההתקנה.
  7. מגדירים את הארגון כמו שמתואר במאמר הגדרת ארגון.

למטה מוצג קובץ תצורה שקט לטופולוגיה הזו:

# 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 ומספרי הצמתים.

  1. מתקינים את Datastore Cluster Node בצמתים 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. מתקינים את שרת Postgres של Apigee Analytics בצמתים 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 Server בצמתים 12 ו-13:
    > ‎/opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  7. בודקים את ההתקנה לפי ההוראות שבקטע בדיקת ההתקנה.
  8. מגדירים את הארגון כמו שמתואר במאמר הגדרת ארגון.

למטה מוצג קובץ תצורה שקט לטופולוגיה הזו:

# 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 ומספרי הצמתים.

  1. מתקינים את Datastore Cluster Node בצמתים 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. מתקינים את Apigee Analytics Qpid Server בצמתים 4, 5, 10 ו-11:
    > ‎/opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. מתקינים את Apigee Analytics Postgres Server בצומת 6 ו-12:
    > ‎/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. בודקים את ההתקנה לפי ההוראות שבקטע בדיקת ההתקנה.
  7. מגדירים את הארגון כמו שמתואר במאמר הגדרת ארגון.

בהמשך מוצג קובץ תצורה שקט לטופולוגיה הזו. שימו לב שבקובץ התצורה הזה:

  • הגדרת 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