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

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

في ما يلي مثال على ملف إعداد صامت كامل لـ 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.
# 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/نظام أسماء النطاقات

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

ENABLE_SYSTEM_CHECK

إذا كان الحرف "y"، تأكَّد من أنّ النظام يستوفي متطلبات وحدة المعالجة المركزية (CPU) والذاكرة للمكوِّن قيد التثبيت. راجع التثبيت متطلبات المتطلبات لكل مكوّن.

القيمة التلقائية هي "n" لإيقاف التحقّق

ENABLE_DYNAMIC_HOSTIP

فإذا كان الخادم يحتوي على عدة بطاقات واجهة، فإن "اسم المضيف -i" يُرجع الأمر عناوين IP مفصولة بمسافات. تستخدم أداة تثبيت Edge تلقائيًا عنوان IP الأول. عرض العنوان، وقد لا يكون العنوان صحيحًا في جميع الحالات. كبديل، يمكنك ضبط السمة التالية في ملف إعدادات التثبيت

عند الضبط على "y"، تطلب منك أداة التثبيت اختيار عنوان IP لاستخدامه في التثبيت. القيمة التلقائية هي "n".

تنبيه: في حال ضبط الإعداد ENABLE_DYNAMIC_HOSTIP=y، تأكَّد من أنّ: إذا كان ملف السمة لا يعرض HOSTIP.

ADMIN_EMAIL
APIGEE_ADMINPW

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

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

LICENSE_FILE

موقع ملف الترخيص، والذي يجب أن يكون الوصول إليه من خلال "واجهة برمجة التطبيقات" المستخدم. على سبيل المثال، قم بتخزينه في دليل /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

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

المنطقة

اسم المنطقة. حسب الاصطلاح، تكون الأسماء عادةً بصيغة 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 فقط في مركز البيانات هذا. الاطّلاع على "تثبيت مجمّع لـ 12 مضيفًا" في تثبيت مكونات 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 مرتبة بطريقة (كما هو موضح في المثال أعلاه) بحيث تؤدي عُقد الجدول مركز البيانات في البداية. الاطّلاع على "تثبيت مجمّع لـ 12 مضيفًا" في تثبيت مكونات Edge على عقدة لمعرفة المزيد.

CASS_AUTH
CASS_USERNAME

CASS_PASSWORD

إذا قمت بتمكين مصادقة Cassandra، CASS_AUTH=y، فيمكنك تمرير مستخدم Cassandra الاسم وكلمة المرور باستخدام هذه الخصائص.

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

PG_USER
PG_PWD

بشكل تلقائي، تحتوي قاعدة بيانات PostgreSQL على مستخدمَين تم تحديدهما: "postgres" أو "apigee".

يتيح لك PG_USER تغيير اسم مستخدم "apigee" المستخدم. لا يمكنك تغيير اسم "عمليات الإرسال" المستخدم.

يمتلك كلا المستخدمَين كلمة مرور تلقائية هي "postgres". استخدم PG_PWD لضبط كلمة المرور على قيمة مختلفة لكلا المستخدمين عند التثبيت.

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

PG_MASTER

PG_STANDBY

يمكنك الضبط على تفعيل النسخ المماثل لخيار الاستعداد الرئيسي في Postgres، على النحو التالي:

PG_MASTER=IPorDNSofNewMaster

PG_STANDBY=IPorDNSofOldMaster

SKIP_SMTP
SMTPHOST
SMTPUSER
كلمة مرور SMTP
SMTPSSL
منفذ SMTP
SMTPmailFROM

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

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

SMTPmailFROM هو مطلوبة.