تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

في ما يلي مثال على ملف إعداد صامت كامل لـ Edge المكون من 9 نقاط التثبيت. عدِّل هذا الملف حسب الضرورة لضبط الإعدادات. استخدام الخيار -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="<custom-region-1>:dc-1 <custom-region-2>:dc-2 ... <custom-region-x>: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=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>"

# 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/نظام أسماء النطاقات	لا تستخدم تعيين اسم مضيف مع 127.0.0.1 أو عنوان IP 127.0.0.1 عندما تحديد عنوان IP للعقدة. لاحظ أنه بالنسبة إلى تعريفات مضيف Cassandra، استخدِم عناوين IP فقط. عدم استخدام DNS الأسماء.
`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`	حدد اسم مجموعة معالج الرسائل وجهاز التوجيه. بشكل افتراضي، يكون الاسم البوابة.
`REGION`	اسم المنطقة. حسب الاصطلاح، تكون الأسماء عادةً بصيغة dc-# حيث يتجاوب # إلى قيمة عدد صحيح. على سبيل المثال، dc-1 وdc-2 وما إلى ذلك. يمكنك استخدام dc-1 ما لم يتم التثبيت في بيئة مركز بيانات متعددة. في تثبيت مركز بيانات متعدد، تكون القيمة dc-1 أو dc-2، وما إلى ذلك وفقًا مركز البيانات الذي تقوم بتثبيته. ومع ذلك، لا يقتصر الأمر على استخدام الأسماء فقط في النموذج dc-#. يمكنك استخدام أي اسم للمنطقة.
`REGION_MAPPING`	إذا كنت تستخدم أسماء مناطق بخلاف dc-1 وdc-2 وما إلى ذلك، اضبط هذه السمة على "تعيين" اسم منطقتك إلى اسم المنطقة المناسب بتنسيق dc-x. يتطلب خادم الإدارة هذه السمة لتسجيل بيانات Cassandra بشكلٍ صحيح. المتاجر بناءً على مراكز بيانات ومناطق "كاساندرا".
`ZK_HOSTS`	عناوين IP أو أسماء نظام أسماء النطاقات لعُقد ZooKeeper. عناوين IP أو أسماء نظام أسماء النطاقات يجب إدراجه بالترتيب نفسه على جميع عُقد ZooKeeper. استخدِم التنسيق نفسه في `HOSTIP` الذي تستخدمه في `ZK_HOSTS` أي، إذا تحديد عنوان IP لـ `ZK_HOSTS`، استخدم عنوان IP من أجل `HOSTIP` إذا كنت تستخدم نظام أسماء النطاقات، ثم استخدم اسم DNS لكليهما. في بيئة مركز بيانات متعددة، أدرِج جميع عُقد 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`	بشكل اختياري، يمكنك تحديد اسم مجموعة كاساندرا. الاسم التلقائي هو "Apigee".
`CASS_HOSTS`	تحدِّد هذه السياسة قائمة مفصولة بفواصل لعُقد Cassandra. عناوين IP للمضيف (وليس أسماء نظام أسماء النطاقات)، وبشكل اختياري رقم مركز البيانات الخاص بها الرف الذي ينتمون إليه. بالنسبة إلى منهجيات الإنتاج، يجب أن تكون هناك ثلاث عُقد على الأقل في هذه القائمة. الأول يتم استخدام العُقدتين كـ "خوادم أوّلية". نتيجةً لذلك، يجب أن يتم إدراج عناوين IP في ملف نفس الترتيب على جميع عُقد كاساندرا. تكون صيغة كل إدخال في القائمة على النحو التالي: `IP_address`[:`data_center_number`,`rack_number`] يمكن أن تحدد عُقد كاساندرا مركز البيانات ورف عقدة كاساندرا بشكل اختياري. يجب تحديد مفتاح التعديل `data_center_number` عند الإنشاء فقط. مراكز بيانات متعددة كما هو موضح في عملية تثبيت لـ 12 مضيفًا. في مركز بيانات واحد التثبيت، فاحذف هذا المُعدّل. على سبيل المثال '192.168.124.201:1,1 = مركز البيانات 1 والرف/منطقة التوافر 1، و '192.168.124.204:2,1 = مركز البيانات 2 والرف/منطقة التوافر 1. للتغلب على مشاكل جدار الحماية في بيئة مراكز بيانات متعددة، `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". المستخدم. لا يمكنك تغيير اسم "postgres" المستخدم. بشكل تلقائي، تحتوي قاعدة بيانات PostgreSQL على مستخدمَين تم تحديدهما: "postgres" و"apigee". يمتلك كلا المستخدمَين كلمة مرور تلقائية هي "postgres". استخدِم `PG_PWD` لضبط وكلمة مرور بقيمة مختلفة لكلا المستخدمَين أثناء التثبيت. بعد اكتمال التثبيت، ينصحك Apigee بإزالة كلمة المرور من ملف التهيئة.
`PG_MASTER` `PG_STANDBY`	يمكنك الضبط على تفعيل النسخ المماثل لخيار الاستعداد الرئيسي في Postgres، على النحو التالي: PG_MASTER=`IPorDNSofNewMaster` PG_STANDBY=`IPorDNSofOldMaster` ملاحظة: تنصح Apigee بشدة باستخدام عنوان IP. بدلاً من أسماء المضيفين في `PG_MASTER` و`PG_STANDBY` الأساسية في ملف الإعداد الصامت. بالإضافة إلى ذلك، ينبغي أن تكون متسقًا في كلتا العُقدتين. إذا كنت تستخدم أسماء مضيفين بدلًا من عناوين IP، يجب أن تتأكد من أنّ المضيف يتم حل الأسماء بشكل صحيح باستخدام نظام أسماء النطاقات.
`SKIP_SMTP` `SMTPHOST` `SMTPUSER` `SMTPPASSWORD` `SMTPSSL` `SMTPPORT` `SMTPMAILFROM`	يمكنك ضبط بروتوكول SMTP حتى يتمكن Edge من إرسال رسائل إلكترونية لكلمات المرور المفقودة والإشعارات الأخرى. إذا لم تكن بيانات اعتماد مستخدم SMTP مطلوبة، احذف `SMTPUSER` `SMTPPASSWORD` يجب ملء الحقل "`SMTPMAILFROM`".
`CASS_JMX_USERNAME`	اسم مستخدم Cassandra JMX. مطلوب في حال تفعيل مصادقة Cassandra JMX.
`CASS_JMX_PASSWORD`	كلمة مرور Cassandra JMX. مطلوب في حال تفعيل مصادقة Cassandra JMX.
`CASS_JMX_TRUSTSTORE`	اسم مستخدم Cassandra JMX SSL Trustedstore، في حال تفعيل JMX المستند إلى طبقة المقابس الآمنة في Cassandra. يجب أن يكون ملف JMX Truststore قابلاً للقراءة لمستخدمي Apigee.
`CASS_JMX_TRUSTSTORE_PASS`	كلمة مرور Cassandra JMX SSLTruststore، في حال تفعيل JMX المستند إلى طبقة المقابس الآمنة في Cassandra

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