مرجع ملف إعداد Edge

الإصدار 4.18.05 من Edge for Private Cloud

في ما يلي مثال على ملف إعدادات كامل بدون إشعارات لتركيب Edge يتضمّن 9 عقد. عدِّل هذا الملف حسب الحاجة لضبط الإعدادات. استخدِم الخيار -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. 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.

# 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/DNS names of the Cassandra hosts (previously defined)
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/نظام أسماء النطاقات لا تستخدِم تعيين اسم مضيف إلى 127.0.0.1 أو عنوان IP‏ 127.0.0.1 عند تحديد عنوان IP للعقدة.
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 تلقائيًا عند تثبيت "خادم الإدارة".

اضبط USE_LDAP_REMOTE_HOST على y في حال الاتصال بخادم LDAP بعيد. لم يتم تثبيت OpenLDAP مع "خادم الإدارة".

إذا كنت تتصل بخادم OpenLDAP عن بُعد، استخدِم LDAP_HOST و LDAP_PORT لتحديد عنوان IP أو اسم نظام أسماء النطاقات ورقم المنفذ للمضيف.

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 أو اسم نظام أسماء النطاقات لخادم LDAP المعادل
MP_POD حدد اسم مجموعة معالج الرسائل وجهاز التوجيه. يكون الاسم تلقائيًا هو gateway.
REGION

اسم المنطقة وفقًا للاصطلاح، تكون الأسماء عادةً على شكل dc-# حيث يتوافق # مع قيمة عددية. على سبيل المثال، dc-1 وdc-2 وما إلى ذلك. يمكنك استخدام dc-1 ما لم يكن التركيب في بيئة متعددة مراكز البيانات.

في عملية تثبيت متعددة لمراكز البيانات، تكون القيمة dc-1 أو dc-2 أو غير ذلك، استنادًا إلى مركز البيانات الذي يتم تثبيته. ولا يقتصر الأمر على استخدام الأسماء فقط التي تكون بالشكل dc-#، بل يمكنك استخدام أي اسم للمنطقة.

ZK_HOSTS

عناوين IP أو أسماء نظام أسماء النطاقات لعُقد ZooKeeper. يجب إدراج عناوين IP أو أسماء نظام أسماء النطاقات بالترتيب نفسه في جميع عقد ZooKeeper.

استخدِم التنسيق نفسه لسمة HOSTIP كما في سمة ZK_HOSTS. بمعنى آخر، في حال تحديد عنوان IP للموقع الإلكتروني ZK_HOSTS، استخدِم عنوان IP للموقع الإلكتروني HOSTIP. وإذا كنت تستخدم نظام أسماء نطاقات، استخدِم اسم نظام أسماء نطاقات لكليهما.

في بيئة مركز بيانات متعددة، أدرِج جميع عُقد ZooKeeper من كلا مركزَي البيانات.

حدِّد المُعدِّل ‎:observer على عقد ZooKeeper فقط عند إنشاء مراكز بيانات متعددة كما هو موضّح في عملية التثبيت على 12 مضيفًا. في عملية تثبيت واحدة لمركز data center، احذف هذا المُعدِّل. لمزيد من المعلومات، يُرجى الاطّلاع على التثبيت المجمّع على 12 مضيفًا.

ZK_CLIENT_HOSTS

عناوين IP أو أسماء نظام أسماء النطاقات لعقد ZooKeeper التي يستخدمها مركز البيانات هذا يجب إدراج عناوين IP أو أسماء نظام أسماء النطاقات بالترتيب نفسه في جميع عقد ZooKeeper.

استخدِم التنسيق نفسه في السمة HOSTIP والسمة ZK_CLIENT_HOSTS. وهذا يعني أنّه إذا حدّدت عنوان IP لـ ZK_CLIENT_HOSTS، استخدِم عنوان IP لـ HOSTIP. إذا كنت تستخدم نظام أسماء النطاقات، استخدِم اسم نظام أسماء النطاقات لكلاهما.

في عملية تثبيت مركز بيانات واحد، تكون هذه هي العقد نفسها المحدّدة من قِبل ZK_HOSTS.

في بيئة مركز بيانات متعددة، أدرِج عُقد ZooKeeper فقط في مركز البيانات هذا. لمزيد من المعلومات، يُرجى الاطّلاع على التثبيت المجمّع على 12 مضيفًا.

CASS_CLUSTERNAME يمكنك اختياريًا تحديد اسم مجموعة Cassandra. الاسم التلقائي هو "Apigee".
CASS_HOSTS

عناوين IP (وليس أسماء نظام أسماء النطاقات) لعقد Cassandra سيتم استخدام أول عقدتَين كسجّلات بذرة. يجب إدراج عناوين IP بالترتيب نفسه في جميع وحدات Cassandra.

يمكن أن تحتوي عقد Cassandra على اللاحقة الاختيارية ":dc,ra" التي تحدِّد مركز البيانات والرفّ الخاص بعقدة Cassandra. لا تحدِّد هذا المُعدِّل إلا عند إنشاء مراكز بيانات متعدّدة كما هو موضّح في عملية التثبيت على 12 مضيفًا. في عملية تثبيت واحدة في مركز بيانات، تجنَّب استخدام هذا المُعدِّل.

على سبيل المثال، ‎192.168.124.201:1,1 = مركز البيانات 1 والرف/منطقة التوفّر 1، و ‎192.168.124.204:2,1 = مركز البيانات 2 والرف/منطقة التوفّر 1.

للتغلب على مشاكل جدار الحماية في بيئة مراكز بيانات متعددة، يجب ترتيب CASS_HOSTS بطريقة (كما هو موضّح في المثال أعلاه) بحيث يتم وضع عُقد مركز البيانات الحالي في البداية. لمزيد من المعلومات، يُرجى الاطّلاع على التثبيت المجمّع على 12 مضيفًا.

CASS_AUTH
CASS_USERNAME
CASS_PASSWORD

في حال تفعيل مصادقة Cassandra، CASS_AUTH=y، يمكنك ضبط اسم المستخدم وكلمة المرور لـ Cassandra باستخدام هذه السمات.

بعد اكتمال عملية التثبيت، تنصحك Apigee بإزالة كلمة المرور من ملف الإعدادات.

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