بعد إكمال عملية تثبيت Edge بنجاح، هناك بعض المهام الشائعة التي قد تحتاج إلى تنفيذها للتحقّق من صحة عملية التثبيت وضبط الإعدادات وتخصيص الإعدادات. وتشمل هذه المهام ما يلي:
المهمة | الوصف |
---|---|
استدعاء الأوامر على مكوّنات Edge | استخدِم الأداة المساعدة apigee-service لبدء كل مكوّن من مكوّنات Edge وإيقافه وإعادة تشغيله والحصول على حالته. |
ضبط مكوّنات Edge | استخدِم ملفات الخصائص لتغيير إعدادات مكوّنات Edge التلقائية. |
تشغيل apigee-validate | استدعِ نصوص الاختبار للتأكّد من نجاح عملية تثبيت كل مكوّن. |
ضبط إعدادات عناصر JVM المتعدّدة | حسِّن إعدادات ذاكرة Java لكل عقدة. |
إدارة سياسة كلمات مرور LDAP | تغيير كلمة مرور LDAP التلقائية وضبط إعدادات المصادقة المختلفة |
تثبيت apigee-monit على العُقدة | ثبِّت أداة تراقب المكوّنات على العقدة واستخدِمها، وحاوِل إعادة تشغيلها إذا تعذّر ذلك. |
تغيير كلمة مرور PostgreSQL التلقائية | تنصح Apigee بتغيير كلمة مرور PostgreSQL التلقائية بعد تثبيت Edge for Private Cloud للحفاظ على أمان بياناتك. |
إعداد مهام إزالة بيانات PostgreSQL | إزالة البيانات الزائدة التي تجمعها خدمة الإحصاءات |
إعداد عملية الإصلاح باستخدام أداة nodetool في Cassandra | صيانة دورية يجب إجراؤها على حلقة Cassandra لضمان الاتساق في جميع العُقد |
تفعيل ميزة "البدء التلقائي" | اطلب من Edge for Private Cloud إعادة التشغيل تلقائيًا أثناء إعادة التشغيل. |
تثبيت واجهة مستخدم Edge الجديدة | تنصح Apigee بتثبيت واجهة مستخدم Edge الجديدة، وهي واجهة مستخدم محسّنة للمطوّرين والمشرفين على Apigee Edge Private Cloud. |
يُرجى العِلم أنّ هذه المهام هي بعض المهام الأكثر شيوعًا التي تنفّذها عادةً بعد تثبيت Edge. للاطّلاع على عمليات ومهام إدارة إضافية، يُرجى الرجوع إلى كيفية ضبط Edge و العمليات.
تنشيط الأوامر على مكونات Edge
يثبّت Edge أدوات إدارة ضمن /opt/apigee/apigee-service/bin
يمكنك استخدامها لإدارة عملية تثبيت Edge. على سبيل المثال، يمكنك استخدام الأداة المساعدة apigee-all
لبدء جميع مكوّنات Edge أو إيقافها أو إعادة تشغيلها أو تحديد حالتها على العُقدة:
/opt/apigee/apigee-service/bin/apigee-all stop|start|restart|status|version
استخدِم أداة apigee-service
للتحكّم في المكوّنات الفردية وضبطها. تتضمّن الأداة المساعدة apigee-service
الصيغة التالية:
/opt/apigee/apigee-service/bin/apigee-service component_name action
حيث يحدّد component_name المكوّن. يجب أن يكون المكوّن على العقدة التي تنفّذ عليها apigee-service
. استنادًا إلى إعداداتك، يمكن أن تتضمّن قيم component_name ما يلي:
apigee-cassandra
(كاساندرا)apigee-openldap
(OpenLDAP)apigee-postgresql
(قاعدة بيانات PostgreSQL)apigee-qpidd
(Qbidd)apigee-sso
(الدخول الموحّد في Edge)apigee-zookeeper
(ZooKeeper)edge-management-server
(خادم الإدارة)edge-management-ui
(واجهة مستخدم Edge الجديدة)edge-message-processor
(معالج الرسائل)edge-postgres-server
(خادم Postgres)edge-qpid-server
(خادم Qbid)edge-router
(جهاز توجيه الحواف)edge-ui
(واجهة المستخدم الكلاسيكية)
بالإضافة إلى هذه المكوّنات، يمكنك أيضًا استدعاء apigee-service
على المكوّنين apigee-provision
وapigee-validate
استنادًا إلى إعداداتك.
على سبيل المثال، لإعادة تشغيل Edge Router، نفِّذ الأمر التالي:
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
يمكنك تحديد قائمة المكوّنات المثبَّتة على العقدة من خلال فحص الدليل /opt/apigee
. يحتوي هذا الدليل على دليل فرعي لكل مكوّن من مكوّنات Edge مثبَّت على العُقدة. يتم وضع البادئة التالية قبل كل دليل فرعي:
apigee
: أحد المكوّنات التابعة لجهة خارجية التي يستخدمها Edge. على سبيل المثال،apigee-cassandra
.-
edge
: أحد مكونات Edge من Apigee. على سبيل المثال،edge-management-server
. edge-mint
: أحد عناصر تحقيق الربح. على سبيل المثالedge-mint-management-server
.
تعتمد القائمة الكاملة للإجراءات الخاصة بأحد المكوّنات على المكوّن نفسه، ولكن تتيح جميع المكوّنات الإجراءات التالية:
start, stop, restart
status, version
backup, restore
install, uninstall
ضبط مكوّنات Edge
لضبط Edge بعد التثبيت، يمكنك استخدام مجموعة من ملفات .properties
وأدوات Edge. على سبيل المثال، لتكوين TLS/SSL على واجهة مستخدم Edge، عليك تعديل ملفات .properties
لضبط الخصائص اللازمة. تتطلّب التغييرات التي يتم إجراؤها على ملفات .properties
إعادة تشغيل مكوّن Edge المتأثر.
توجد الملفات .properties
في الدليل /opt/apigee/customer/application
.
يحتوي كل مكوّن على ملف .properties
خاص به في هذا الدليل.
على سبيل المثال، router.properties
وmanagement-server.properties
.
لضبط إحدى خصائص المكوّن، عدِّل ملف .properties
ذي الصلة، ثم أعِد تشغيل المكوّن:
/opt/apigee/apigee-service/bin/apigee-service component restart
على سبيل المثال:
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
عند تحديث Edge، تتم قراءة ملفات .properties
في الدليل /opt/apigee/customer/application
. وهذا يعني أنّ التحديث يحتفظ بأي سمات ضبطتها على المكوّن.
لمزيد من المعلومات حول إعداد Edge، يُرجى الاطّلاع على كيفية إعداد Edge.
تثبيت apigee-monit على العُقدة
بعد الانتهاء من تثبيت المكوّنات على عقدة، يمكنك اختياريًا إضافة أداة apigee-monit
. سيراقب apigee-monit
المكوّنات على العُقدة ويحاول إعادة تشغيلها في حال تعذّر ذلك.
لمزيد من المعلومات، يُرجى الاطّلاع على الإصلاح الذاتي باستخدام apigee-monit.
ضبط خادم SymasLDAP ليكون للقراءة فقط
إذا كان تثبيت Edge يتضمّن خادم SymasLDAP لا يحتاج إلى تحويل حركة البيانات إليه، ننصحك بضبط الخادم على وضع القراءة فقط. ولإجراء ذلك، يُرجى اتّباع الخطوات التالية:
- أنشئ ملفًا
mark_readonly.ldif
على الخادم يتضمّن الأسطر التالية:dn: olcDatabase={2}mdb,cn=config changetype: modify replace: olcReadOnly olcReadOnly: TRUE
- نفِّذ الأمر التالي على الخادم لوضع علامة للقراءة فقط:
ldapmodify -a -x -w "$APIGEE_LDAPPW" -D "$CONFIG_BIND_DN" -H "ldap://:10389" -f mark_readonly.ldif
في حال تعذُّر الخادم الأساسي، يمكنك العودة إلى استخدام الخادم الاحتياطي كخادم أساسي باتّباع الخطوات التالية:
- أنشئ ملفًا
mark_writable.ldif
على الخادم الاحتياطي يتضمّن السطر التالي:dn: olcDatabase={2}mdb,cn=config changetype: modify replace: olcReadOnly olcReadOnly: FALSE
- نفِّذ الأمر التالي على الخادم الاحتياطي:
ldapmodify -a -x -w "$APIGEE_LDAPPW" -D "$CONFIG_BIND_DN" -H "ldap://:10389" -f mark_writable.ldif