למטה מוצגת דוגמה לקובץ תצורה שקט לגמרי עבור Edge עם 9 צמתים
בתהליך ההתקנה. אפשר לערוך את הקובץ הזה לפי הצורך בהגדרות האישיות שלך. שימוש באפשרות -f
אל setup.sh
כדי לכלול את הקובץ הזה. לדוגמאות של קובצי תצורה
ספציפיים לכל טופולוגיה, אפשר לראות
התקנת רכיבי Edge.
# IP address or DNS name of nodes. IP1=192.168.1.1 # Management Server, OpenLDAP, UI, ZooKeeper, Cassandra (IP address only; do not use a DNS name) IP2=192.168.1.2 # ZooKeeper, Cassandra (IP address only; do not use a DNS name) IP3=192.168.1.3 # ZooKeeper, Cassandra (IP address only; do not use a DNS name) 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) # Specify "y" to check that the system meets the CPU and memory requirements # for the component being installed. See Installation Requirements for requirements # for each component. The default value is "n" to disable check. ENABLE_SYSTEM_CHECK=n # When "hostname -i" returns multiple IP addresses, # set to "y", to have the installer prompt you to select the IP address to use. ENABLE_DYNAMIC_HOSTIP=n # 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. # 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. # If you are using region names other than dc-1, dc-2 etc, set this property to map your region # name to the appropriate dc-x format region name. This property is required by Management server # to appropriately register Cassandra data stores based on Cassandra's data centers and regions. REGION_MAPPING="<custom-region-1>:dc-1 <custom-region-2>:dc-2 ... <custom-region-x>:dc-x" # 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. # Space-separated IP addresses of the Cassandra hosts (previously defined; do not use DNS names) # Syntax is: IP_address:host_number,rack_number 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='' # Postgres username and password as set when you installed Edge. # Default is apigee:postgres. PG_USER=apigee PG_PWD=postgres # 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. SMTPMAILFROM="My Company <myco@company.com>" # The following four properties are only effective for Management server: # Cassandra JMX uname/pword required if you enabled Cassandra JMX authentication. # CASS_JMX_USERNAME = # CASS_JMX_PASSWORD = # Cassandra JMX SSL truststore details if you have enabled SSL based JMX in Cassandra. # JMX Truststore file should be readable by Apigee user # CASS_JMX_TRUSTSTORE = # CASS_JMX_TRUSTSTORE_PASS =
בטבלה הבאה תוכלו למצוא מידע נוסף על המאפיינים האלה:
נכס | הערה |
---|---|
שמות IP/DNS | אין להשתמש במיפוי שם מארח ל-127.0.0.1 או בכתובת IP של 127.0.0.1 כאשר
שמציין את כתובת ה-IP של צומת.
לתשומת ליבכם: בהגדרות המארח של Cassandra, צריך להשתמש בכתובות IP בלבד. לא להשתמש ב-DNS שמות. |
ENABLE_SYSTEM_CHECK |
אם 'y', בודקים שהמערכת עומדת בדרישות המעבד והזיכרון לרכיב בתהליך התקנה. לעיון בקטע התקנה דרישות בנוגע לכל רכיב. ערך ברירת המחדל הוא 'n'. כדי להשבית את הבדיקה. |
ENABLE_DYNAMIC_HOSTIP |
אם לשרת יש מספר כרטיסי ממשק, השם המארח -i הפקודה מחזירה רשימה מופרדת ברווחים של כתובות IP. כברירת מחדל, מנהל ההתקנה של Edge משתמש בכתובת ה-IP הראשונה שהוחזרה, מה שעלול להיות לא נכון בכל המצבים. לחלופין, אפשר יכול להגדיר את המאפיין הבא בקובץ התצורה של ההתקנה. כאשר הערך מוגדר ל-"y", מנהל ההתקנה ינחה אתכם לבחור את כתובת ה-IP שבה אתם רוצים להשתמש להתקנה. ערך ברירת המחדל הוא 'n'. |
ADMIN_EMAIL APIGEE_ADMINPW
|
הסיסמה של מנהל המערכת חייבת להיות באורך של 8 תווים לפחות ולהכיל אחת אות גדולה, אות קטנה אחת, ספרה אחת או תו מיוחד אחד. אם משמיטים את התהליך הסיסמה הזו, תתבקשו להזין אותה. בסיום ההתקנה, מערכת Apigee ממליצה להסיר את הסיסמה מ- את קובץ התצורה. |
LICENSE_FILE |
המיקום של קובץ הרישיון, שחייב להיות נגיש ל-'apigee' משתמש. לדוגמה, אפשר לשמור אותו בספרייה .tmp ובקובץ chmod 777 שבקובץ. הקובץ מועתק לספריית ההתקנה של Edge. |
APIGEE_LDAPPW |
מציינת את הסיסמה של OpenLDAP. בסיום ההתקנה, מערכת Apigee ממליצה להסיר את הסיסמה מ- את קובץ התצורה. |
USE_LDAP_REMOTE_HOST |
אם הערך של הגדרת אם התחברת לשרת OpenLDAP מרוחק, יש להשתמש ב- |
LDAP_TYPE LDAP_SID LDAP_PEER
|
הגדרת אם הטופולוגיה של Edge משתמשת בשרת OpenLDAP יחיד, צריך לציין את הערך 1. אם ה-Edge שלך משתמש בצמתים מרובים של OpenLDAP, כמו בהתקנת ייצור עם 13 צמתים, לציין 2. אם מפעילים רפליקציה, צריך להגדיר את המאפיינים הבאים:
|
MP_POD |
מציינים את השם של מעבד ההודעות ויחידת הנתבים. כברירת מחדל, השם הוא שער. |
REGION |
שם האזור. לפי המוסכמה, השמות בדרך כלל מופיעים בצורה dc-#, כאשר # תואמים למספר שלם. לדוגמה, dc-1 , dc-2 וכו'. ניתן להשתמש ב-dc-1 אלא אם מתקינים בסביבה של מרכז נתונים מרובים. בהתקנה מרובים של מרכז נתונים, הערך הוא dc-1 או dc-2 וכו', בהתאם מרכז הנתונים שאתם מתקינים. עם זאת, אינך מוגבל להשתמש בשמות בלבד. בצורת dc-#. אפשר להשתמש בכל שם לאזור. |
REGION_MAPPING |
אם אתם משתמשים בשמות אזורים שאינם dc-1, dc-2 וכו', יש להגדיר את המאפיין הזה למיפוי שם האזור לשם האזור המתאים בפורמט dc-x. מאפיין זה נדרש על ידי שרת הניהול כדי לרשום כראוי נתוני Cassandra לפי מרכזי הנתונים והאזורים של Cassandra. |
ZK_HOSTS |
כתובות ה-IP או שמות ה-DNS של צמתים ב-ZooKeeper. כתובות ה-IP או שמות ה-DNS חייב להיות רשום באותו סדר בכל הצמתים של ZoomKeeper. צריך להשתמש באותו פורמט של בסביבה של מרכז נתונים רב, הצגת רשימה של כל הצמתים של ZoomKeeper משני הנתונים שלנו. יש לציין את המחרוזת ":observer" מקש מאפיין בצמתים של ZoomKeeper רק כאשר יצירת מרכזי נתונים מרובים, כפי שמתואר בהתקנה עם 12 מארחים. בנתונים בודדים במרכז ההתקנה, משמיטים את הצירוף הזה. מידע נוסף זמין במאמר הבא: התקנה באשכולות עם 12 מארחים. |
ZK_CLIENT_HOSTS |
כתובות ה-IP או שמות ה-DNS של צמתים ב-ZooKeeper שמשמשים את מרכז הנתונים הזה. כתובת ה-IP כתובות או שמות DNS צריכים להיות רשומים באותו סדר בכל הצמתים של ZoomKeeper. צריך להשתמש באותו פורמט של בהתקנה של מרכז נתונים יחיד, אלה אותם צמתים שצוינו על ידי
בסביבה של מרכז נתונים מרובה, ציינו רק את הצמתים שלzoKeeper במרכז הנתונים הזה. מידע נוסף זמין במאמר הבא: התקנה באשכולות עם 12 מארחים. |
CASS_CLUSTERNAME |
אפשר לציין את שם האשכול Cassandra. שם ברירת המחדל הוא Apigee. |
CASS_HOSTS |
מציין רשימה מופרדת בפסיקים של צמתים של Cassandra את כתובות ה-IP של המארח (לא שמות DNS), ואם רוצים, גם את מספר מרכז הנתונים שלהם היררכיה, שאליה הם שייכים. לטופולוגיות של ייצור, הרשימה הזו חייבת לכלול לפחות שלושה צמתים. הראשון שני צמתים משמשים כ"שרתי מקור". לכן, כתובות ה-IP צריכות להיות אותו סדר בכל הצמתים של Cassandra. התחביר של כל רשומה ברשימה הוא: IP_address[:data_center_number,rack_number] צמתים של Cassandra יכולים לציין את מרכז הנתונים והמארז של צומת Cassandra. צריך לציין את הצירוף data_center_number רק כשיוצרים את מרכזי נתונים מרובים, כפי שמתואר בהתקנה עם 12 מארחים. במרכז נתונים יחיד להתקין אותו, להשמיט את הצירוף הזה. לדוגמה: '192.168.124.201:1,1 = מרכז נתונים 1 ואזור מארז/זמינות 1, וגם '192.168.124.204:2,1 = מרכז נתונים 2 ואזור מארז/זמינות 1. בסביבה של מספר מרכזי נתונים, כדי להתגבר על בעיות בחומת האש, למידע על ציון הערך rack_number למארח של Cassandra, ראו: הוספת תמיכה במארז של Cassandra. |
CASS_AUTH CASS_USERNAME CASS_PASSWORD
|
אם מפעילים אימות של Cassandra, CASS_AUTH=y, אפשר להעביר את המשתמש של Cassandra באמצעות המאפיינים האלה. בסיום ההתקנה, מערכת Apigee ממליצה להסיר את הסיסמה מ- את קובץ התצורה. |
CONFIG_DELTA_LOG
|
|
PG_USER PG_PWD |
כברירת מחדל, במסד הנתונים של PostgreSQL מוגדרים שני משתמשים: 'postgres' וגם 'apigee'.
כברירת מחדל, במסד הנתונים של PostgreSQL מוגדרים שני משתמשים: 'postgres' ו-apigee.
לשני המשתמשים יש סיסמת ברירת מחדל 'postgres'. משתמשים ב- בסיום ההתקנה, מערכת Apigee ממליצה להסיר את הסיסמה מ- את קובץ התצורה. |
PG_MASTER PG_STANDBY
|
מוגדר להפעלת רפליקציית המתנה מאסטר ב-Postgres, באופן הבא: PG_MASTER=IPorDNSofNewMaster PG_STANDBY=IPorDNSofOldMaster |
SKIP_SMTP SMTPHOST SMTPUSER SMTPPASSWORD SMTPSSL SMTPPORT SMTPMAILFROM
|
מגדירים שרת SMTP כדי ש-Edge יוכל לשלוח אימיילים במקרה של סיסמאות שאבדו והתראות אחרות. אם אין צורך בפרטי כניסה למשתמש ב-SMTP, יש להשמיט את הערכים השדה |
CASS_JMX_USERNAME |
שם המשתמש של Cassandra JMX. חובה אם הפעלת אימות JMX של Cassandra. |
CASS_JMX_PASSWORD |
סיסמת JMX של Cassandra. חובה אם הפעלת אימות JMX של Cassandra. |
CASS_JMX_TRUSTSTORE |
שם המשתמש של Cassandra JMX truststore, אם הפעלת JMX מבוסס SSL ב-Cassandra. קובץ ה-JMX Truststore צריך להיות קריא למשתמש Apigee. |
CASS_JMX_TRUSTSTORE_PASS |
הסיסמה של Cassandra JMX truststore, אם הפעלת JMX מבוסס SSL ב-Cassandra. |
בנוסף למאפיינים המפורטים כאן, יש גם מאפיינים להגדרת mTLS של Apigee. מידע נוסף זמין במאמר הגדרת mTLS של Apigee.