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

Edge for Private Cloud v. 4.17.05

يظهر أدناه مثال على ملف إعداد صامت كامل لعملية تثبيت من 9 عُقد Edge. عدِّل هذا الملف حسب الضرورة لإجراء الضبط. استخدِم الخيار -f من أجل setup.sh لتضمين هذا الملف. ونعرض أدناه أيضًا أمثلة على ملفات الإعداد لكل من المخططات الهيكلية.

# 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/DNS

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

Administrative_EMAIL
APIGEE_ADMINPW

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

LICENSE_FILE

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

APIGEE_LDAPPW

يحدد كلمة مرور OpenLDAP.

USE_LDAP_REMOTE_STAR
LDAP_STAR
LDAP_PORT

في حال كان USE_LDAP_REMOTE_ توقف n، يثبّت Edge تلقائيًا تطبيق OpenLDAP عندما يثبّت خادم الإدارة.

اضبط USE_LDAP_REMOTE_STAR على 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 - اسم نظام أسماء النطاقات (DNS) أو نظام أسماء النطاقات لمحدّد LDAP.

على جميع الأجهزة

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

MP_POD

حدِّد اسم معالج البيانات ومجموعة أجهزة التوجيه. يكون الاسم تلقائيًا هو البوابة.

المنطقة

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

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

ZK_STARS

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

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

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

ZK_CLIENT_REWARDS

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

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

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

CASS_LMSNAME يمكنك اختياريًا كتابة اسم مجموعة Cassandra. الاسم التلقائي هو "Apigee".

CAS_ تلقائيًا

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

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

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

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

CASS_AUTH
CASS_Blogger

CAS_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
SMTPSENDER
SMTPUSER
SMTPPASSWORD
SMTPSSL
SMTPPORT
SMTPMailFROM

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

في حال لم تكن بيانات اعتماد مستخدم SMTP مطلوبة، يُرجى حذف SMTPUSER وSMTPPASSWORD.

يجب وجود SMTPMailFROM.