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

Edge for Private Cloud نسخه ۴.۱۷.۰۵

در زیر نمونه‌ای از فایل پیکربندی بی‌صدای کامل برای نصب 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)

# 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 (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=

# Set Postgres password. Default is postgres.
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/ساناد

هنگام مشخص کردن نشانی IP گره، از نام میزبانی که به 127.0.0.1 یا نشانی IP‏ 127.0.0.1 نگاشت شده است استفاده نکنید.

ADMIN_EMAIL
APIGEE_ADMINPW

گذرواژه سرپرست سیستم باید حداقل ۸ نویسه داشته باشد و شامل یک حرف بزرگ، یک حرف کوچک، یک رقم، یا یک نویسه خاص باشد. اگر گذرواژه را حذف کنید، از شما خواسته می‌شود آن را وارد کنید.

LICENSE_FILE

مکان فایل پروانه که باید برای کاربر «apigee» دردسترس باشد. برای مثال، آن را در دایرکتوری /tmp ذخیره کنید و chmod 777 را روی فایل اجرا کنید. فایل در فهرست نصب Edge کپی می‌شود.

APIGEE_LDAPPW

گذرواژه OpenLDAP را مشخص می‌کند.

USE_LDAP_REMOTE_HOST
LDAP_HOST
LDAP_PORT

اگر USE_LDAP_REMOTE_HOST برابر با n باشد، Edge هنگام نصب Management Server، به‌طور خودکار OpenLDAP را نصب می‌کند.

اگر به سرور LDAP راه دور متصل می‌شوید، USE_LDAP_REMOTE_HOST را روی y تنظیم کنید. OpenLDAP با «سرور مدیریت» نصب نشده است.

اگر به سرور OpenLDAP راه دور متصل می‌شوید، از LDAP_HOST
و LDAP_PORT برای مشخص کردن نشانی IP یا نام ساناد و شماره درگاه میزبان استفاده کنید.

LDAP_TYPE
LDAP_SID
LDAP_PEER

برای OpenLDAP بدون تکرار، LDAP_TYPE=1 را تنظیم کنید. LDAP_TYPE=2 با OpenLDAP با تکرار مطابقت دارد.

اگر توپولوژی Edge شما از یک سرور OpenLDAP استفاده می‌کند، عدد ۱ را مشخص کنید. اگر نصب Edge شما از چند گره OpenLDAP استفاده می‌کند، مثلاً در نصب تولیدی ۱۳ گره‌ای، ۲ را مشخص کنید.

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

  • LDAP_SID=1 - شناسه یکتا برای این سرور LDAP. هر گره LDAP از شناسه متفاوتی استفاده می‌کند. برای مثال، برای همتای LDAP روی ۲ تنظیم کنید.
  • LDAP_PEER=10.0.0.1 - IP یا نام ساناد همتای LDAP.

BIND_ON_ALL_INTERFACES

اگر روی «y» تنظیم شود، «رهیاب/پردازشگر پیام» به همه میاناهای (IP) متصل می‌شود (گوش می‌دهد). اگر روی «n» تنظیم شود، «رهیاب/پردازشگر پیام» به میانای خاصی متصل می‌شود (گوش می‌دهد)، IP برگردانده‌شده توسط فرمان «hostname -i»).

MP_POD

نام پاد «پردازشگر پیام» و «مسیریاب» را مشخص کنید. به‌طور پیش‌فرض، نام آن gateway است.

REGION

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

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

ZK_HOSTS

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

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

اصلاح‌کننده «:observer» را در گره‌های ZooKeeper فقط هنگام ایجاد چندین مرکز داده، همان‌طور که در نصب ۱۲ میزبان شرح داده شده است، مشخص کنید. در نصب مرکز داده تکی، آن اصلاح‌کننده را حذف کنید. برای اطلاعات بیشتر، به «نصب خوشه‌ای ۱۲ میزبان» در نصب مؤلفه‌های Edge در گره مراجعه کنید.

ZK_CLIENT_HOSTS

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

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

در محیط چند مرکز داده، فقط گره‌های ZooKeeper را در این مرکز داده فهرست کنید. برای اطلاعات بیشتر، به «نصب خوشه‌ای ۱۲ میزبان» در نصب مؤلفه‌های Edge در گره مراجعه کنید.

CASS_CLUSTERNAME درصورت تمایل، نام خوشه Cassandra را مشخص می‌کند. نام پیش‌فرض «Apigee» است.

CASS_HOSTS

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

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

برای مثال، «192.168.124.201:1,1» یعنی مرکز داده ۱ و قفسه/منطقه دردسترس ۱، و «192.168.124.204:2,1» یعنی مرکز داده ۲ و قفسه/منطقه دردسترس ۱.

In a multi-datacenter environment, to overcome firewall issues, CASS_HOSTS have to be ordered in a manner (as shown in above example) such that the nodes of the current datacenter are placed at the beginning. برای اطلاعات بیشتر، به «نصب خوشه‌ای ۱۲ میزبان» در نصب مؤلفه‌های Edge در گره مراجعه کنید.

CASS_AUTH
CASS_USERNAME

CASS_PASSWORD

اگر اصالت‌سنجی Cassandra را فعال کنید (CASS_AUTH=y)، می‌توانید نام کاربری و گذرواژه Cassandra را بااستفاده از این ویژگی‌ها ارسال کنید.

PG_PWD

به‌طور پیش‌فرض، پایگاه داده PostgreSQL دو کاربر تعریف‌شده دارد: «postgres» و «apigee». هر دو کاربر گذرواژه پیش‌فرض «postgres» دارند. از PG_PWD برای تنظیم گذرواژه روی مقدار دیگری برای هر دو کاربر در زمان نصب استفاده کنید.

PG_MASTER

PG_STANDBY

تنظیم برای فعال کردن تکرار Postgres master-standby، در فرم:

PG_MASTER=IPorDNSofNewMaster

PG_STANDBY=IPorDNSofOldMaster

SKIP_SMTP
SMTPHOST
SMTPUSER
SMTPPASSWORD
SMTPSSL
SMTPPORT
SMTPMAILFROM

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

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

SMTPMAILFROM الزامی است.