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

Edge for Private Cloud v4.18.01

يظهر أدناه مثال على ملف إعداد صامت كامل لعملية تثبيت من 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)

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

# 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/DNS لا تستخدم ربط اسم المضيف بالإصدار 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 إذن، يثبِّت 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 - اسم نظام أسماء النطاقات (DNS) أو نظام أسماء النطاقات (DNS) لمتصفّح LDAP نفسه.
MP_POD حدِّد اسم معالج البيانات ومجموعة أجهزة التوجيه. يكون الاسم تلقائيًا هو البوابة.
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 مضيفًا. في تثبيت واحد لمركز البيانات، احذف هذا المعدِّل. ولمزيد من المعلومات، يُرجى الاطّلاع على التثبيت المجمّع لـ 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 بالترتيب نفسه في جميع عُقد 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 مضيفًا.

CASS_AUTH
CASS_USERNAME
CASS_PASSWORD

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

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

PG_USER
PG_PWD

تتضمّن قاعدة بيانات PostgreSQL تلقائيًا مستخدمَين محدّدَين: "postgres" و"apigee".

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

تحتوي قاعدة بيانات 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".