مرجع فایل پیکربندی لبه

در زیر نمونه ای از یک فایل پیکربندی کامل بی صدا برای نصب 9 گره Edge نشان داده شده است. این فایل را در صورت لزوم برای پیکربندی خود ویرایش کنید. برای قرار دادن این فایل از گزینه -f برای setup.sh استفاده کنید. برای مثال هایی از فایل های پیکربندی که مختص هر توپولوژی هستند، به نصب اجزای لبه مراجعه کنید.

# 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=":dc-1 :dc-2 ... :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=IPofNewMaster
# PG_STANDBY=IPofOldMaster

# 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 هنگام تعیین آدرس IP یک گره از نگاشت نام میزبان به 127.0.0.1 یا آدرس IP 127.0.0.1 استفاده نکنید.

توجه داشته باشید که برای تعاریف میزبان Cassandra، فقط از آدرس های IP استفاده کنید. از نام های DNS استفاده نکنید.

ENABLE_SYSTEM_CHECK

اگر "y" باشد، بررسی کنید که سیستم دارای نیازهای CPU و حافظه برای قطعه در حال نصب باشد. الزامات نصب را برای الزامات هر جزء ببینید.

مقدار پیش فرض "n" برای غیرفعال کردن بررسی است.

ENABLE_DYNAMIC_HOSTIP

اگر یک سرور دارای چندین کارت رابط باشد، دستور "hostname -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 را هنگام نصب سرور مدیریت نصب می کند.

اگر به سرور 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 را مشخص کنید.

اگر Replication را فعال کردید، ویژگی های زیر را تنظیم کنید:

  • LDAP_SID =1 - شناسه منحصر به فرد برای این سرور LDAP. هر گره LDAP از یک شناسه متفاوت استفاده می کند. به عنوان مثال، برای LDAP peer روی 2 تنظیم کنید.
  • LDAP_PEER =10.0.0.1 - نام IP یا DNS همتای LDAP.
MP_POD نام Message Processor and Router pod را مشخص کنید. به طور پیش فرض، نام دروازه است.
REGION

نام منطقه طبق قرارداد، نام ها معمولاً به شکل dc-# هستند که در آن # با یک مقدار صحیح مطابقت دارد. به عنوان مثال، dc-1، dc-2، و غیره. شما می توانید از dc-1 استفاده کنید مگر اینکه در یک محیط چند مرکز داده نصب کنید.

در نصب چند مرکز داده، مقدار dc-1 یا dc-2 و غیره بسته به اینکه کدام مرکز داده را نصب می کنید، است. با این حال، شما محدود به استفاده از نام ها به شکل dc-# نیستید. می توانید از هر نامی برای منطقه استفاده کنید.

REGION_MAPPING

اگر از نام های منطقه ای غیر از dc-1، dc-2 و غیره استفاده می کنید، این ویژگی را تنظیم کنید تا نام منطقه شما به نام منطقه با فرمت dc-x مناسب نگاشت شود. این ویژگی توسط سرور مدیریت برای ثبت مناسب فروشگاه های داده کاساندرا بر اساس مراکز داده و مناطق کاساندرا مورد نیاز است.

ZK_HOSTS

آدرس‌های IP یا نام‌های DNS گره‌های ZooKeeper. آدرس‌های IP یا نام‌های DNS باید به ترتیب در تمام گره‌های ZooKeeper فهرست شوند.

برای HOSTIP از همان قالبی که برای ZK_HOSTS استفاده می کنید استفاده کنید. یعنی اگر آدرس IP را برای ZK_HOSTS مشخص کنید از یک آدرس IP برای HOSTIP استفاده کنید. اگر از DNS استفاده می کنید، برای هر دو از یک نام DNS استفاده کنید.

در یک محیط چند مرکز داده، تمام گره های ZooKeeper را از هر دو مرکز داده فهرست کنید.

اصلاح کننده ":observer" را در گره های ZooKeeper فقط هنگام ایجاد چندین مرکز داده همانطور که در نصب 12 میزبانی توضیح داده شده است، مشخص کنید. در یک نصب مرکز داده، آن اصلاح کننده را حذف کنید. برای اطلاعات بیشتر، نصب خوشه‌ای 12 میزبان را ببینید.

ZK_CLIENT_HOSTS

آدرس‌های IP یا نام‌های DNS گره‌های ZooKeeper که توسط این مرکز داده استفاده می‌شود. آدرس‌های IP یا نام‌های DNS باید به ترتیب در تمام گره‌های ZooKeeper فهرست شوند.

برای HOSTIP از همان قالبی که برای ZK_CLIENT_HOSTS استفاده می‌کنید استفاده کنید. یعنی اگر آدرس IP را برای ZK_CLIENT_HOSTS مشخص کنید از یک آدرس IP برای HOSTIP استفاده کنید. اگر از DNS استفاده می کنید، برای هر دو از یک نام DNS استفاده کنید.

در یک نصب مرکز داده، اینها همان گره هایی هستند که توسط ZK_HOSTS مشخص شده است.

در یک محیط چند مرکز داده، فقط گره های ZooKeeper را در این مرکز داده فهرست کنید. برای اطلاعات بیشتر، نصب خوشه‌ای 12 میزبان را ببینید.

CASS_CLUSTERNAME به صورت اختیاری نام خوشه کاساندرا را مشخص کنید. نام پیش فرض "Apigee" است.
CASS_HOSTS

فهرستی از آدرس‌های IP میزبان گره‌های کاساندرا (نه نام‌های DNS) جدا شده با کاما و در صورت تمایل شماره مرکز داده و رکی که به آن تعلق دارند را مشخص می‌کند.

برای توپولوژی های تولید، باید حداقل سه گره در این لیست وجود داشته باشد. دو گره اول به عنوان "سرورهای بذر" استفاده می شوند. در نتیجه، آدرس های IP باید در تمام گره های Cassandra به یک ترتیب فهرست شوند.

نحو برای هر ورودی در لیست به شرح زیر است:

IP_address[:data_center_number,rack_number]

گره های کاساندرا می توانند به صورت اختیاری مرکز داده و رک گره کاساندرا را مشخص کنند. تغییر دهنده 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

تنظیم کنید تا Replication Master-standby Postgres به شکل زیر فعال شود:

PG_MASTER=IPofNewMaster
PG_STANDBY=IPofOldMaster
SKIP_SMTP
SMTPHOST
SMTPUSER
SMTPPASSWORD
SMTPSSL
SMTPPORT
SMTPMAILFROM

SMTP را پیکربندی کنید تا Edge بتواند برای رمزهای عبور گم شده و سایر اعلان‌ها ایمیل ارسال کند.

اگر اعتبار کاربری SMTP مورد نیاز نیست، SMTPUSER و SMTPPASSWORD را حذف کنید.

SMTPMAILFROM مورد نیاز است.

CASS_JMX_USERNAME نام کاربری Cassandra JMX. اگر احراز هویت Cassandra JMX را فعال کرده باشید، لازم است.
CASS_JMX_PASSWORD رمز عبور کاساندرا JMX. اگر احراز هویت Cassandra JMX را فعال کرده باشید، لازم است.
CASS_JMX_TRUSTSTORE اگر JMX مبتنی بر SSL را در Cassandra فعال کرده‌اید، نام کاربری ذخیره‌سازی اعتماد Cassandra JMX SSL. فایل JMX Truststore باید توسط کاربر Apigee قابل خواندن باشد.
CASS_JMX_TRUSTSTORE_PASS اگر JMX مبتنی بر SSL را در Cassandra فعال کرده‌اید، رمز عبور ذخیره‌سازی اعتماد SSL Cassandra JMX.

علاوه بر ویژگی های ذکر شده در اینجا، ویژگی هایی برای پیکربندی Apigee mTLS وجود دارد. برای اطلاعات بیشتر، پیکربندی Apigee mTLS را ببینید.