דף זה תורגם על ידי Cloud Translation API.

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

Edge for Private Cloud גרסה 4.16.05

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

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

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

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

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

> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f /tmp/myConfig

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

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

הגדרת Postgres רפליקציה למצופה מאסטר

כברירת מחדל, Edge מתקין את כל צמתי Postgres במצב master. אבל במערכות ייצור עם כמה צמתים של 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), עליך לשנות את הבעלים של הקובץ למשתמש הזה:
> צ'און USER:USER /opt/apigee/etc/edge-router.d/RUN_USER.sh
הפעלה מחדש של הנתב:
> /opt/apigee/apigee-service/bin/apigee-service edge-router מחדש

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

בטבלה הבאה מפורטות האפשרויות שאתם מעבירים לאפשרות -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 בלבד.
mp	צריך להתקין את מעבד ההודעות של Edge בלבד.
rmp	מתקינים את Edge Router ואת Message Processor.
ui	מתקינים את ממשק המשתמש של Edge.
qs	התקנת שרת Qpid בלבד.
ps	יש להתקין רק את Postgres Server.
sax	התקנת רכיבי ניתוח הנתונים, כלומר Qpid ו-Postgres. אפשר להשתמש באפשרות הזו לצורכי פיתוח ובדיקה בלבד, ולא לצורכי ייצור.
חודשית	מתקינים את התוסף Monetization.
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.

קובץ תצורה לדוגמה

בהמשך מוצגת דוגמה לקובץ תצורה מלא להתקנה של 9 צמתים של Edge. אפשר לערוך את הקובץ הזה לפי הצורך בהגדרות האישיות שלך. כדי לכלול את הקובץ הזה, משתמשים באפשרות -f כדי -f. הוצגו גם בהמשך מוצגים קובצי תצורה לדוגמה עבור כל אחת מהטופולוגיה של 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	מציינים את השם של מעבד ההודעות ויחידת הנתבים. כברירת מחדל, השם הוא gateway.
אזור	שם האזור. לפי המוסכמה, השמות בדרך כלל מופיעים בצורה 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 = datacenter 1 and rack/availability zone 1, וגם '192.168.124.204:2,1 = datacenter 2 and rack/availability zone 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 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 ייכשל.