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

Edge for Private Cloud גרסה 4.16.09

אחרי שמתקינים את כלי השירות apigee-setup בצומת, משתמשים ב- להתקין את הכלי 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 משתמש.

לדוגמה, כדי להתקין את שרת ניהול הקצה:

> /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. צריך להגדיר את הנתב שיפעל כמשתמש עם גישה ליציאות האלה. כברירת מחדל, הנתב פועל בתור המשתמש "apigee" שאין לו גישה ליציאות שיש להן הרשאות.

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

  1. בתור הרמה הבסיסית (root), יוצרים את הקובץ /opt/apigee/etc/edge-router.d/RUN_USER.sh.
  2. מוסיפים את הרשומה הבאה לקובץ:
    RUN_USER=root
    אם אתם לא רוצים להפעיל את הנתב ברמה הבסיסית (root), צריך לציין משתמש עם גישה ליציאה.
  3. שומרים את הקובץ.
  4. אם ציינת משתמש שהוא לא הרמה הבסיסית (root), עליך לשנות את הבעלים של הקובץ למשתמש הזה:
    > צ'און USER:USER /opt/apigee/etc/edge-router.d/RUN_USER.sh
  5. הפעלה מחדש של הנתב:
    > /opt/apigee/apigee-service/bin/apigee-service edge-router מחדש

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

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

רכיב

תיאור

c

התקנת Cassandra בלבד.

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

DS

מתקינים אתzoKeeper ו-Cassandra.

ld

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

ms

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

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

r

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

מ'

צריך להתקין את מעבד ההודעות של Edge בלבד.

RP

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

ממשק משתמש

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

qs

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

PS

יש להתקין את Postgres Server בלבד.

סקסו

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

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

חודשית

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

sa

התקנת Edge עצמאית, כלומר Cassandra, zoKeeper, Management Server, OpenLDAP, ממשק משתמש קצה, נתב ומעבד הודעות. בחירה באפשרות הזו לא תכיל את רכיבי ניתוח הנתונים של 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

אין להשתמש במיפוי שם מארח ל-127.0.0.1 או בכתובת IP של 127.0.0.1 כאשר שמציין את כתובת ה-IP של צומת.

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.
  • LDAP_PEER=10.0.0.1 - שם IP או שם DNS של עמית LDAP.

BIND_ON_ALL_INTERFACES

אם מוגדר כ-y. ואז קישור הנתב/מעבד ההודעות (האזנה) בכל הממשקים (כתובות IP). אם המדיניות מוגדרת כ-n, אז קישור הנתב/מעבד ההודעות (האזנה) ממשק ה-IP, שהוחזר על ידי "שם המארח -i" ).

MP_POD

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

אזור

שם האזור. לפי המוסכמה, השמות בדרך כלל מופיעים בצורה dc-#, כאשר # תואמים למספר שלם. לדוגמה, dc-1 , dc-2 וכו'. ניתן להשתמש ב-dc-1 אלא אם מתקינים בסביבה של מרכז נתונים מרובים.

בהתקנה מרובים של מרכז נתונים, הערך הוא dc-1 או dc-2 וכו', בהתאם מרכז הנתונים שאתם מתקינים. עם זאת, אינך מוגבל להשתמש בשמות בלבד. בצורת dc-#. אפשר להשתמש בכל שם לאזור.

ZK_HOSTS

כתובות ה-IP או שמות ה-DNS של צמתים ב-ZooKeeper. כתובות ה-IP או שמות ה-DNS חייב להיות רשום באותו סדר בכל הצמתים של ZoomKeeper.

בסביבה של מרכז נתונים רב, הצגת רשימה של כל הצמתים של ZoomKeeper משני הנתונים שלנו.

יש לציין את הצירוף ' :observer' בצמתים של ZoomKeeper רק כאשר יצירת מרכזי נתונים מרובים, כפי שמתואר בהתקנה עם 12 מארחים. בנתונים בודדים במרכז ההתקנה, משמיטים את הצירוף הזה. הצגת אשכולות של 12 מארחים באשכולות להתקנה.

ZK_CLIENT_HOSTS

כתובות ה-IP או שמות ה-DNS של צמתים ב-ZooKeeper שמשמשים את מרכז הנתונים הזה. כתובת ה-IP כתובות או שמות DNS צריכים להיות רשומים באותו סדר בכל הצמתים של ZoomKeeper.

בהתקנה של מרכז נתונים יחיד, אלה אותם צמתים שצוינו על ידי ZK_HOSTS

בסביבה של מרכז נתונים מרובה, ציינו רק את הצמתים שלzoKeeper במרכז הנתונים הזה. הצגת אשכולות של 12 מארחים באשכולות להתקנה.

CASS_HOSTS

כתובות ה-IP (לא שמות DNS) של הצמתים של Cassandra. שני הצמתים הראשונים יהיו שמשמשים כשרתי מקור. כתובות ה-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, באופן הבא:

PG_MASTER=IPorDNSofNewMaster

PG_STANDBY=IPorDNSofOldMaster

SKIP_SMTP
SMTPHOST
SMTPUSER
סיסמה ל-SMTP
SMTPSSL
יציאת SMTP

מגדירים שרת SMTP כדי ש-Edge יוכל לשלוח אימיילים במקרה של סיסמאות שאבדו והתראות אחרות.

אם אין צורך בפרטי כניסה של משתמש ב-SMTP, משמיטים את הפרמטרים SMTPUSER ו-SMTPpassword.

סדר התקנת הרכיבים

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

כל דוגמת ההתקנה שבהמשך מבוססת על ההנחה שאתם מתקינים:

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

כברירת מחדל, הכלי 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. התקנת אשכול 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. בדוק את ההתקנה כפי שמתואר בעמוד בדיקת התקנה.
  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 Management בצומת 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 Server בצומת 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 Management Server בצומת 6 ו-7:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  4. התקנה של Apigee Analytics Postgres Server בצומת 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. בדוק את ההתקנה כפי שמתואר בעמוד בדיקת התקנה.
  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 בטופולוגיה של אשכולות a12 (בשני מרכזי נתונים), צריך להבין איך להגדיר את המאפיינים שלZoKeeper ושל Cassandra בקובץ התצורה השקט.

  • ZooKeeper

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

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

    במאפיין ZK_CLIENT_HOSTS של כל מרכז נתונים, מציינים את כתובות ה-IP או שמות ה-DNS של רק הצמתים של ZzooKeeper במרכז הנתונים, באותו סדר, בכל הצמתים שלzoKeeper במרכז הנתונים. בקובץ התצורה לדוגמה שמוצג למטה, צומת 9 מתויג עם מגביל ":observer" כך שיהיו לכם חמישה מצביעים: צמתים 1, 2, 3, 7 ו-8.
  • קסנדרה
    כל מרכזי הנתונים חייבים להיות בעלי אותו מספר של צומתי 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.168.124.205:2,1 192.168.124.206:2,1"

    הצומת הראשון במארז/באזור הזמינות 1 של כל מרכז נתונים ישמש בתור ערך הבסיס השרת.

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

כאן אפשר למצוא את רשימת טופולוגיות של Edge. באמצעות טופולוגיות ומספרי צמתים.

  1. התקנה של Datastore Cluster Node בצומת 1, 2, 3, 7, 8 ו-9:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. התקנת שרת ניהול של Apigee עם רפליקציית OpenLDAP בצומת 1 ו-7:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. התקנת הנתב ומעבד ההודעות בצמתים 2, 3, 8 ו-9:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. התקנה של Apigee Analytics Qpid Server בצומת 4, 5, 10 ו-11:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. התקנה של Apigee Analytics Postgres Server בצומת 6 ו-12:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. בדוק את ההתקנה כפי שמתואר בעמוד בדיקת התקנה.
  7. מצרפים את הארגון שלכם, כפי שמתואר במאמר הצטרפות לארגון.

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

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