تمت ترجمة هذه الصفحة بواسطة 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`	إذا كان الحرف "y"، تأكَّد من أنّ النظام يستوفي متطلبات وحدة المعالجة المركزية (CPU) والذاكرة للمكوِّن قيد التثبيت. اطّلِع على متطلبات التثبيت لمعرفة متطلبات كل مكوّن. القيمة التلقائية هي "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 بشكلٍ صحيح. المتاجر بناءً على مراكز بيانات ومناطق "كاساندرا".
`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`] يمكن أن تحدد عُقد كاساندرا مركز البيانات ورف عقدة كاساندرا بشكل اختياري. حدِّد المُعدِّل `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`	كلمة مرور JMX في Cassandra مطلوب في حال تفعيل مصادقة Cassandra JMX.
`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 أو false، وتكون القيمة التلقائية false. اضبط هذا الخيار على true (صحيح) لإصدار Edge for Private Cloud 4.53.00 أو الإصدارات الأحدث على أنظمة التشغيل المزوّدة ببرنامج FIPS.

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