بعد التثبيت

بعد تثبيت Edge بنجاح، هناك بعض المهام الشائعة التي قد تحتاج إلى تنفيذها للتحقّق من صحة التثبيت وضبط إعداداتك وتخصيص الإعدادات. وتشمل هذه المهام ما يلي:

مهمة الوصف
استدعاء أوامر على مكوّنات Edge يمكنك استخدام أداة apigee-service لبدء تشغيل كل مكوّن من مكوّنات Edge وإيقافه وإعادة تشغيله والحصول على حالة كل مكوّن من مكونات Edge.
ضبط مكونات Edge يمكنك استخدام ملفات الخصائص لتغيير إعدادات مكوّن Edge التلقائية.
تشغيل التحقّق من صحة apigee استدعِ النصوص البرمجية للاختبار للتأكد من نجاح تثبيت كل مكون.
إعدادات توليف JVM يمكنك تحسين إعدادات ذاكرة Java لكل عقدة.
إدارة سياسة كلمات المرور في LDAP غيِّر كلمة مرور LDAP التلقائية واضبِط إعدادات المصادقة المختلفة.
تثبيت apigee-monit على العقدة ثبِّت أداة تراقب المكوّنات على العقدة وتحاول إعادة تشغيلها في حال تعذّر ذلك.
تغيير كلمة مرور PostgreSQL التلقائية تنصح Apigee بتغيير كلمة مرور PostgreSQL التلقائية بعد تثبيت Edge for Private Cloud للحفاظ على أمان بياناتك.
إعداد مهام الإزالة النهائية لـ PostgreSQL قلِّل البيانات الزائدة التي يتم جمعها من خلال خدمة التحليلات.
إعداد إصلاح أداة إصلاح أدوات Cassandra يجب إجراء صيانة دورية على حلقة Cassandra لضمان الاتساق في جميع النقاط.
تفعيل البدء التلقائي عليك توجيه Edge إلى Private Cloud لإعادة التشغيل تلقائيًا أثناء إعادة التشغيل.
تثبيت واجهة مستخدم Edge الجديدة تنصح Apigee بتثبيت واجهة مستخدم Edge الجديدة، وهي واجهة مستخدم محسَّنة لمطوّري ومشرفي Apigee Edge for Private Cloud.

يُرجى العِلم أنّ هذه ليست سوى بعض المهام الأكثر شيوعًا التي يتم تنفيذها عادةً بعد تثبيت متصفّح Edge. للحصول على المزيد من مهام العمليات والإدارة، يمكنك الاطّلاع على كيفية إعداد Edge والعمليات.

استدعاء الأوامر على مكونات Edge

أدوات إدارة عمليات تثبيت Edge ضمن /opt/apigee/apigee-service/bin التي يمكنك استخدامها لإدارة تثبيت Edge. على سبيل المثال، يمكنك استخدام الأداة apigee-all لبدء تشغيل جميع مكونات Edge أو إيقافها أو إعادة تشغيلها أو تحديد حالة جميع مكونات 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، نفِّذ الأمر التالي:

/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.

ضبط خادم OpenLDAP ليكون للقراءة فقط

في حال كان تثبيت Edge يحتوي على خادم OpenLDAP لا يحتاج إلى تبديل حركة البيانات إليه، ننصحك بإعداد الخادم ليكون للقراءة فقط. ولإجراء ذلك، يُرجى اتّباع الخطوات التالية:

  1. أنشئ ملف mark_readonly.ldif على الخادم باستخدام الأسطر التالية: 
    dn: olcDatabase={2}bdb,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}bdb,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