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

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

# IP address or DNS name of nodes.
IP1=192.168.1.1  # Management Server, OpenLDAP, UI, ZooKeeper, Cassandra (IP address only; do not use a DNS name)
IP2=192.168.1.2  # ZooKeeper, Cassandra (IP address only; do not use a DNS name)
IP3=192.168.1.3  # ZooKeeper, Cassandra (IP address only; do not use a DNS name)
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.

# If you are using region names other than dc-1, dc-2 etc, set this property to map your region
# name to the appropriate dc-x format region name. This property is required by Management server
# to appropriately register Cassandra data stores based on Cassandra's data centers and regions.
REGION_MAPPING=":dc-1 :dc-2 ... :dc-x"

# 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 addresses of the Cassandra hosts (previously defined; do not use DNS names)
# Syntax is: IP_address:host_number,rack_number
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=IPofNewMaster
# PG_STANDBY=IPofOldMaster

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

# The following four properties are only effective for Management server:
# Cassandra JMX uname/pword required if you enabled Cassandra JMX authentication.
# CASS_JMX_USERNAME =
# CASS_JMX_PASSWORD =

# Cassandra JMX SSL truststore details if you have enabled SSL based JMX in Cassandra.
# JMX Truststore file should be readable by Apigee user
# CASS_JMX_TRUSTSTORE =
# CASS_JMX_TRUSTSTORE_PASS =

يتضمن الجدول التالي معلومات إضافية حول هذه المواقع:

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

يُرجى العِلم أنّه بالنسبة إلى تعريفات مضيفات Cassandra، استخدِم عناوين 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-#، ولكن يمكنك استخدام أي اسم للمنطقة.

REGION_MAPPING

إذا كنت تستخدم أسماء مناطق غير dc-1 وdc-2 وما إلى ذلك، اضبط هذه السمة لربط اسم منطقتك باسم المنطقة المناسب بتنسيق dc-x. يطلب خادم "الإدارة" تسجيل هذا الموقع الإلكتروني بشكل مناسب من متاجر "كاساندرا" المستندة إلى مراكز بيانات مناطق "كاساندرا".

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 بالترتيب نفسه على جميع عُقد Cassandra.

وتكون بنية كل إدخال في القائمة على النحو التالي:

IP_address[:data_center_number,rack_number]

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

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

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

للحصول على معلومات حول تحديد rack_number لمضيف Cassandra، يمكنك الاطّلاع على إضافة دعم رفّ Cassandra.

CASS_AUTH
CASS_USERNAME
CASS_PASSWORD

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

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

CONFIG_DELTA_LOG

تتحكّم السياسة CONFIG_DELTA_LOG في كيفية تسجيل التغييرات التي يتم إجراؤها على ملفات الإعداد. في حال ضبط CONFIG_DELTA_LOG=y، لا يتم تسجيل تغييرات الإعدادات الخاصة بالمكوِّن.

PG_USER
PG_PWD

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

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

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

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

PG_MASTER
PG_STANDBY

يمكنك ضبط هذا الخيار لتفعيل ميزة "الاحتفاظ بنسخة احتياطية من الشرائح الرئيسية" في Postgres على النحو التالي:

PG_MASTER=IPofNewMaster
PG_STANDBY=IPofOldMaster
SKIP_SMTP
SMTPHOST
SMTPUSER
SMTPPASSWORD
SMTPSSL
SMTPPORT
SMTPMAILFROM

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

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

يجب ملء الحقل "SMTPMAILFROM".

CASS_JMX_USERNAME اسم مستخدم Cassandra JMX مطلوبة في حال تفعيل مصادقة Cassandra JMX
CASS_JMX_PASSWORD كلمة مرور "كاساندرا JMX" مطلوبة في حال تفعيل مصادقة Cassandra JMX
CASS_JMX_TRUSTSTORE اسم مستخدم مخزن بيانات CAPS لطبقة المقابس الآمنة في Cassandra، في حال تفعيل JMX المستند إلى طبقة المقابس الآمنة في Cassandra يجب أن يكون ملف JMX Truststore قابلاً للقراءة من قِبل مستخدم Apigee.
CASS_JMX_TRUSTSTORE_PASS كلمة مرور مخزن بيانات طبقة المقابس الآمنة (SSL) في طبقة المقابس الآمنة (Castradia) في حال تفعيل طبقة المقابس الآمنة (JMX) المستندة إلى طبقة المقابس الآمنة في Cassandra

بالإضافة إلى السمات المدرَجة هنا، هناك خصائص لضبط Apigee mTLS. للحصول على مزيد من المعلومات، يُرجى الاطِّلاع على ضبط بروتوكول mgegee mTLS.