تمت ترجمة هذه الصفحة بواسطة 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 =
    
    # Set up username and password to access Qpid broker's management console
    
    QPID_MGMT_USERNAME=qpid
    QPID_MGMT_PASSWORD=Apigee1234
    
    # FIPS_OS should be set to true when OPDK 4.53 or later is installed on 
    # FIPS enabled operating system
    FIPS_OS=false

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

الموقع	ملاحظة
أسماء عناوين IP/نظام أسماء النطاقات	لا تستخدِم تعيين اسم مضيف إلى 127.0.0.1 أو عنوان IP‏ 127.0.0.1 عند تحديد عنوان IP للعقدة. يُرجى ملاحظة أنّه بالنسبة إلى تعريفات مضيف Cassandra، استخدِم عناوين IP فقط، ولا تستخدِم أسماء نظام أسماء النطاقات.
`ENABLE_SYSTEM_CHECK`	إذا كانت الإجابة "نعم"، تأكَّد من أنّ النظام يستوفي متطلبات وحدة المعالجة المركزية والذاكرة للمكوّن الذي يتم تثبيته. اطّلِع على متطلبات التثبيت لمعرفة متطلبات كل مكوّن. القيمة التلقائية هي "n" لإيقاف التحقّق.
`ENABLE_DYNAMIC_HOSTIP`	إذا كان الخادم يحتوي على بطاقات واجهة متعددة، يعرض الأمر "hostname -i" قائمة بعناوين IP مفصولة بمسافات. وحسب الإعدادات التلقائية، تستخدم أداة تثبيت Edge أول عنوان IP تم عرضه، وقد لا يكون هذا العنوان صحيحًا في جميع الحالات. كخيار بديل، يمكنك ضبط السمة التالية في ملف إعدادات التثبيت. عند ضبط القيمة على "y"، سيطلب منك برنامج التثبيت اختيار عنوان IP لاستخدامه في عملية التثبيت. القيمة التلقائية هي "n". ملاحظة: في حال ضبط قيمة `ENABLE_DYNAMIC_HOSTIP=y`، تأكَّد من أنّ ملف موقعك الإلكتروني لا يضبط قيمة `HOSTIP`.
`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` يساوي 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`	حدِّد اسم مجموعة وحدات معالجة الرسائل وأجهزة التوجيه. يكون الاسم تلقائيًا هو gateway.
`REGION`	اسم المنطقة. وفقًا للاصطلاح، تكون الأسماء عادةً على شكل dc-# حيث يتوافق # مع قيمة عددية. على سبيل المثال، dc-1 وdc-2 وما إلى ذلك. يمكنك استخدام dc-1 ما لم يتم التثبيت في بيئة مركز بيانات متعددة. في عملية تثبيت متعددة لمراكز البيانات، تكون القيمة dc-1 أو dc-2 أو غير ذلك، استنادًا إلى مركز البيانات الذي يتم تثبيته. ومع ذلك، لا تقتصر على استخدام الأسماء فقط في شكل dc-#. يمكنك استخدام أي اسم للمنطقة.
`REGION_MAPPING`	إذا كنت تستخدم أسماء مناطق غير dc-1 وdc-2 وما إلى ذلك، اضبط هذه السمة لربط اسم منطقتك باسم المنطقة المناسب بتنسيق dc-x. يتطلّب خادم الإدارة هذه السمة لتسجيل ملفّات تخزين بيانات Cassandra بشكلٍ مناسب استنادًا إلى مراكز البيانات والمناطق في Cassandra.
`ZK_HOSTS`	عناوين IP أو أسماء نظام أسماء النطاقات لعُقد ZooKeeper. يجب إدراج عناوين IP أو أسماء نظام أسماء النطاقات بالترتيب نفسه في جميع عقد ZooKeeper. استخدِم التنسيق نفسه لسمة `HOSTIP` كما في سمة `ZK_HOSTS`. بمعنى آخر، في حال تحديد عنوان IP للموقع الإلكتروني `ZK_HOSTS`، استخدِم عنوان IP للموقع الإلكتروني `HOSTIP`. إذا كنت تستخدم نظام أسماء النطاقات، استخدِم اسم نظام أسماء النطاقات لكلاهما. في بيئة تتضمّن عدة مراكز بيانات، يجب إدراج جميع عقد ZooKeeper من كلا مركزَي البيانات. حدِّد المُعدِّل ‎:observer على عقد ZooKeeper فقط عند إنشاء مراكز بيانات متعددة كما هو موضّح في عملية التثبيت على 12 مضيفًا. في عملية تثبيت واحدة لمركز data center، احذف هذا المُعدِّل. لمزيد من المعلومات، يُرجى الاطّلاع على التثبيت المجمّع على 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 اختياريًا تحديد مركز البيانات والرف لعقدة Cassandra. حدِّد المُعدِّل `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. مطلوب إذا فعّلت مصادقة JMX في Cassandra.
`CASS_JMX_PASSWORD`	كلمة مرور JMX في Cassandra مطلوب إذا فعّلت مصادقة JMX في Cassandra.
`CASS_JMX_TRUSTSTORE`	اسم مستخدم Cassandra JMX SSL Trustedstore، في حال تفعيل JMX المستند إلى طبقة المقابس الآمنة في Cassandra. يجب أن يكون ملف JMX Truststore قابلاً للقراءة من قِبل مستخدم Apigee.
`CASS_JMX_TRUSTSTORE_PASS`	كلمة مرور ملف تخزين ثقة طبقة المقابس الآمنة (SSL) في JMX في Cassandra، إذا كنت قد فعّلت JMX المستند إلى طبقة المقابس الآمنة في Cassandra
`QPID_MGMT_USERNAME` `QPID_MGMT_PASSWORD`	توفِّر بيانات الاعتماد هذه إمكانية الوصول إلى وحدة تحكُّم إدارة الويب Qpid لوسيط Qpid. توفّر "وحدة تحكّم الويب" واجهة بسيطة وسهلة الاستخدام لإدارة ومراقبة وكيل Qpid.
`FIPS_OS`	يمكن أن تكون قيمة FIPS_OS صحيحة أو خطأ، مع القيمة التلقائية خطأ. اضبط هذا الخيار على true (صحيح) لإصدار Edge for Private Cloud 4.53.00 أو الإصدارات الأحدث على أنظمة التشغيل المزوّدة ببرنامج FIPS.

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