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

Edge for Private Cloud نسخه 4.17.09

در زیر نمونه ای از یک فایل پیکربندی کامل بی صدا برای نصب 9 گره Edge نشان داده شده است. این فایل را در صورت لزوم برای پیکربندی خود ویرایش کنید. برای قرار دادن این فایل از گزینه -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)

# 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.
# 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. 

# 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 (not DNS names) 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=

# 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>"

جدول زیر حاوی اطلاعات اضافی در مورد این خواص است:

ویژگی

توجه داشته باشید

نام های IP/DNS

هنگام تعیین آدرس IP یک گره از نگاشت نام میزبان به 127.0.0.1 یا آدرس IP 127.0.0.1 استفاده نکنید.

ENABLE_SYSTEM_CHECK

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

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

ENABLE_DYNAMIC_HOSTIP

اگر یک سرور دارای چندین کارت رابط باشد، دستور "hostname -i" فهرستی از آدرس‌های IP را که با فاصله از هم جدا شده است، برمی‌گرداند. به طور پیش فرض، نصب کننده Edge از اولین آدرس IP بازگردانده شده استفاده می کند که ممکن است در همه شرایط صحیح نباشد. به عنوان جایگزین، می توانید ویژگی زیر را در فایل پیکربندی نصب تنظیم کنید.

هنگامی که روی "y" تنظیم می شود، نصب کننده از شما می خواهد که آدرس IP را برای استفاده در نصب انتخاب کنید. مقدار پیش فرض "n" است.

احتیاط: اگر ENABLE_DYNAMIC_HOSTIP=y را تنظیم کرده اید، مطمئن شوید که فایل دارایی شما HOSTIP را تنظیم نمی کند.

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-# نیستید. می توانید از هر نامی برای منطقه استفاده کنید.

ZK_HOSTS

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

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

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

ZK_CLIENT_HOSTS

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

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

در یک محیط چند مرکز داده، فقط گره های ZooKeeper را در این مرکز داده فهرست کنید. برای اطلاعات بیشتر به "نصب خوشه ای 12 میزبانی" در Install Edge components on a node مراجعه کنید.

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

CASS_HOSTS

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

گره‌های کاساندرا می‌توانند پسوند اختیاری «:dc,ra» داشته باشند که مرکز داده و رک گره کاساندرا را مشخص می‌کند. این اصلاح کننده را فقط هنگام ایجاد چندین مرکز داده همانطور که در نصب 12 میزبان توضیح داده شده است، مشخص کنید. در یک نصب مرکز داده، آن اصلاح کننده را حذف کنید.

برای مثال '192.168.124.201:1,1 = مرکز داده 1 و رک/منطقه در دسترس 1، و '192.168.124.204:2,1 = مرکز داده 2 و رک/منطقه در دسترس بودن 1.

در یک محیط چند مرکز داده، برای غلبه بر مشکلات فایروال، CASS_HOSTS باید به روشی (همانطور که در مثال بالا نشان داده شده است) ترتیب داده شوند به طوری که گره های مرکز داده فعلی در ابتدا قرار گیرند. برای اطلاعات بیشتر به "نصب خوشه ای 12 میزبانی" در Install Edge components on a node مراجعه کنید.

CASS_AUTH
CASS_USERNAME

CASS_PASSWORD

اگر احراز هویت Cassandra را فعال کنید، CASS_AUTH=y، می توانید نام کاربری و رمز عبور Cassandra را با استفاده از این ویژگی ها ارسال کنید.

پس از اتمام نصب، Apigee توصیه می کند که رمز عبور را از فایل پیکربندی حذف کنید.

PG_USER
PG_PWD

به طور پیش فرض، پایگاه داده PostgreSQL دارای دو کاربر تعریف شده است: "postgres" و "apigee".

PG_USER به شما امکان می دهد نام کاربری کاربر "apigee" را تغییر دهید. شما نمی توانید نام کاربر "postgres" را تغییر دهید.

هر دو کاربر یک رمز عبور پیش فرض "postgres" دارند. از PG_PWD برای تنظیم رمز عبور روی مقدار متفاوتی برای هر دو کاربر در زمان نصب استفاده کنید.

پس از اتمام نصب، Apigee توصیه می کند که رمز عبور را از فایل پیکربندی حذف کنید.

PG_MASTER

PG_STANDBY

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

PG_MASTER= IPorDNSofNewMaster

PG_STANDBY= IPorDNSofOldMaster

SKIP_SMTP
SMTPHOST
SMTPUSER
SMTPPASSWORD
SMTPSSL
SMTPPORT
SMTPMAILFROM

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

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

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