بعد التثبيت

بعد إكمال عملية تثبيت 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 لا يحتاج إلى تحويل حركة البيانات إليه، ننصحك بضبط الخادم على وضع القراءة فقط. ولإجراء ذلك، يُرجى اتّباع الخطوات التالية:

  1. أنشئ ملفًا mark_readonly.ldif على الخادم يتضمّن الأسطر التالية:
    dn: olcDatabase={2}mdb,cn=config
      changetype: modify
      replace: olcReadOnly
      olcReadOnly: TRUE
  2. نفِّذ الأمر التالي على الخادم لوضع علامة للقراءة فقط:
      ldapmodify -a -x -w "$APIGEE_LDAPPW" -D "$CONFIG_BIND_DN" -H "ldap://:10389" -f mark_readonly.ldif

في حال تعذُّر الخادم الأساسي، يمكنك العودة إلى استخدام الخادم الاحتياطي كخادم أساسي باتّباع الخطوات التالية:

  1. أنشئ ملفًا mark_writable.ldif على الخادم الاحتياطي يتضمّن السطر التالي:
      dn: olcDatabase={2}mdb,cn=config
      changetype: modify
      replace: olcReadOnly
      olcReadOnly: FALSE
  2. نفِّذ الأمر التالي على الخادم الاحتياطي:
      ldapmodify -a -x -w "$APIGEE_LDAPPW" -D "$CONFIG_BIND_DN" -H "ldap://:10389" -f mark_writable.ldif