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

Edge for Private Cloud، الإصدار 4.17.05

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

لا تستخدم تعيين اسم مضيف مع 127.0.0.1 أو عنوان IP 127.0.0.1 عندما تحديد عنوان IP للعقدة.

ADMIN_EMAIL
APIGEE_ADMINPW

يجب ألا تقل كلمة مرور مشرف النظام عن 8 أحرف وأن تحتوي على كلمة حرف كبير أو حرف واحد صغير أو رقم واحد أو رمز خاص واحد في حال حذف كلمة المرور، سيُطلب منك إدخالها.

LICENSE_FILE

موقع ملف الترخيص، والذي يجب أن يكون الوصول إليه من خلال "واجهة برمجة التطبيقات" المستخدم. على سبيل المثال، قم بتخزينه في دليل /tmp و أمر chmod 777 في الملف. تم نسخ الملف إلى دليل تثبيت Edge.

APIGEE_LDAPPW

تحدِّد كلمة مرور OpenLDAP.

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.

BIND_ON_ALL_INTERFACES

في حال الضبط على "y" ثم يربط جهاز التوجيه/معالج الرسائل (الاستماع) على جميع الواجهات (IP). في حال ضبط القيمة على "n"، يتم ربط الموجّه/معالج الرسائل (الاستماع) على واجهة معيّنة، وهي عنوان IP الذي يعرضه الأمر "hostname -i").

MP_POD

حدد اسم مجموعة معالج الرسائل وجهاز التوجيه. بشكل افتراضي، يكون الاسم البوابة.

المنطقة

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

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

ZK_HOSTS

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

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

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

ZK_CLIENT_HOSTS

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

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

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

CASS_CLUSTERNAME إذا أردت تحديد نوع المجموعة العنقودية كاساندرا، الاسم الافتراضي هو "Apigee".

CASS_HOSTS

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

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

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

للتغلب على مشكلات جدار الحماية في بيئة مراكز بيانات متعددة، ينبغي أن يكون CASS_HOSTS مرتبة بطريقة (كما هو موضح في المثال أعلاه) بحيث تؤدي عُقد الجدول مركز البيانات في البداية. لمعرفة مزيد من المعلومات، يُرجى الاطّلاع على مقالة تثبيت مكونات 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، على النحو التالي:

PG_MASTER=IPorDNSofNewMaster

PG_STANDBY=IPorDNSofOldMaster

SKIP_SMTP
SMTPHOST
SMTPUSER
SMTPPASSWORD
SMTPSSL
منفذ SMTP
SMTPMAILFROM

يمكنك ضبط بروتوكول SMTP حتى يتمكن Edge من إرسال رسائل إلكترونية لكلمات المرور المفقودة والإشعارات الأخرى.

إذا لم تكن بيانات اعتماد مستخدم SMTP مطلوبة، احذف SMTPUSER وSMTPpassword.

يجب تحديد SMTPMAILFROM.