הפניה לקובץ תצורה של Edge

למטה מוצגת דוגמה לקובץ תצורה שקט לגמרי עבור 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 =
    
# Set up username and password to access Qpid broker's management console

QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=pass1234

בטבלה הבאה תוכלו למצוא מידע נוסף על המאפיינים האלה:

נכס הערה
שמות 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
LDAP_HOST
LDAP_PORT

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

הגדרת USE_LDAP_REMOTE_HOST כ-y אם מתחבר לשרת LDAP מרוחק. 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.
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.

צריך להשתמש באותו פורמט של HOSTIP שבו משתמשים כדי ZK_HOSTS. כלומר, אם מציינים את כתובת ה-IP של ZK_HOSTS. משתמשים בכתובת IP כדי HOSTIP. אם אתם משתמשים ב-DNS, ואז להשתמש בשם DNS בשניהם.

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

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

ZK_CLIENT_HOSTS

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

צריך להשתמש באותו פורמט של HOSTIP שבו משתמשים כדי ZK_CLIENT_HOSTS. כלומר, אם מציינים את כתובת ה-IP של ZK_CLIENT_HOSTS צריך להשתמש ב-IP כתובת של HOSTIP. אם המיקום משתמשים ב-DNS, ואז משתמשים בשם DNS בשניהם.

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

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

בסביבה של מספר מרכזי נתונים, כדי להתגבר על בעיות בחומת האש, CASS_HOSTS חייב להיות מסודר באופן (כפי שמוצג בדוגמה למעלה) כך שהצמתים של מרכזי הנתונים מוצבים בהתחלה. מידע נוסף זמין במאמר הבא: התקנה באשכולות עם 12 מארחים.

למידע על ציון הערך rack_number למארח של Cassandra, ראו: הוספת תמיכה במארז של Cassandra.

CASS_AUTH
CASS_USERNAME
CASS_PASSWORD

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

בסיום ההתקנה, מערכת Apigee ממליצה להסיר את הסיסמה מ- את קובץ התצורה.

CONFIG_DELTA_LOG

CONFIG_DELTA_LOG קובע איך השינויים ב קובצי התצורה נרשמים ביומן. אם מגדירים CONFIG_DELTA_LOG=y, שינויים בהגדרות של רכיב מסוים לא נרשמים ביומן.

PG_USER
PG_PWD

כברירת מחדל, במסד הנתונים של PostgreSQL מוגדרים שני משתמשים: 'postgres' וגם 'apigee'.

PG_USER מאפשר לשנות את שם המשתמש של 'apigee' משתמש. אי אפשר שינוי השם של Postgres משתמש.

כברירת מחדל, במסד הנתונים של PostgreSQL מוגדרים שני משתמשים: 'postgres' ו-apigee. לשני המשתמשים יש סיסמת ברירת מחדל 'postgres'. משתמשים ב-PG_PWD כדי להגדיר את לערך שונה עבור שני המשתמשים בזמן ההתקנה.

בסיום ההתקנה, מערכת Apigee ממליצה להסיר את הסיסמה מ- את קובץ התצורה.

PG_MASTER
PG_STANDBY

מוגדר להפעלת רפליקציית המתנה מאסטר ב-Postgres, באופן הבא:

PG_MASTER=IPorDNSofNewMaster
PG_STANDBY=IPorDNSofOldMaster
SKIP_SMTP
SMTPHOST
SMTPUSER
SMTPPASSWORD
SMTPSSL
SMTPPORT
SMTPMAILFROM

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

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

השדה SMTPMAILFROM הוא שדה חובה.

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.
QPID_MGMT_USERNAME
QPID_MGMT_PASSWORD
פרטי הכניסה האלה מעניקים גישה למתווך ה-Qpid Qpid Web Management Console מסוף ניהול האתרים מספק ממשק פשוט ואינטואיטיבי לניהול והשליטה של המתווך Qpid.

בנוסף למאפיינים המפורטים כאן, יש גם מאפיינים להגדרת mTLS של Apigee. מידע נוסף זמין במאמר הגדרת mTLS של Apigee.