إضافة عقدة جهاز توجيه أو معالج رسائل

يمكنك إضافة عقدة موجه أو معالج رسائل إلى تثبيت موجود. للحصول على قائمة متطلبات النظام لجهاز التوجيه أو معالج الرسائل، راجع متطلبات التثبيت.

إضافة جهاز توجيه

بعد تثبيت Edge على العقدة، استخدم الإجراء التالي لإضافة جهاز التوجيه:

  1. ثبِّت Edge على العقدة باستخدام إجراء على الإنترنت أو خارج الإنترنت كما هو موضَّح في دليل تثبيت Edge.
  2. في موجِّه الأوامر، شغِّل النص البرمجي "apigee-setup.sh": 
    /opt/apigee/apigee-setup/bin/setup.sh -p r -f configFile

    يحدِّد الخيار "-p r" كيفية تثبيت جهاز التوجيه. عرض تثبيت مكونات Edge على عقدة للحصول على معلومات حول إنشاء configFile.

  3. عند اكتمال عملية التثبيت، يعرض النص البرمجي المعرّف الفريد العالمي لجهاز التوجيه. إذا كنت إلى تحديد المعرّف الفريد العالمي لاحقًا، فيمكنك استخدام أمر cURL التالي على المضيف حيث جهاز التوجيه: 
    curl http://router_IP:8081/v1/servers/self
  4. إذا كنت تستخدم مصادقة Cassandra، يمكنك تفعيل جهاز التوجيه للاتصال بـ "كاساندرا": 
    /opt/apigee/apigee-service/bin/apigee-service edge-router store_cassandra_credentials -u username -p password

    لمزيد من المعلومات، يُرجى الاطِّلاع على تفعيل مصادقة Cassandra.

  5. للتحقّق من الإعدادات، يمكنك تشغيل الأمر curl التالي: 
    curl -v -u adminEmail:pword "http://ms_IP:8080/v1/servers?pod=pod_name"

    حيث pod_name هو البوابة أو اسم المجموعة المخصّصة. من المفترض أن تظهر لك أرقام التعريف الفريدة العالمية (UUID) لجميع أجهزة التوجيه، بما في ذلك جهاز التوجيه الذي أضفته للتو.

    إذا لم يظهر المعرّف الفريد العالمي لجهاز التوجيه في الإخراج، شغِّل أمر cURL التالي لإضافة فهو:

    curl -v -u adminEmail:pword \
  -X POST http://ms_IP:8080/v1/regions/region_name/pods/pod_name/servers \
  -d "action=add&uuid=router_UUID&type=router"

    استبدِل ms_IP بعنوان IP لخادم الإدارة. region_name باسم المنطقة التلقائي لـ dc-1 أو اسم منطقتك المخصصة pod_name يحمل اسم البوابة أو اسم اللوحة المخصّصة

  6. لاختبار الموجه، من المفترض أن يكون بإمكانك تقديم طلبات إلى واجهات برمجة التطبيقات من خلال عنوان IP أو DNS name الخاص بجهاز التوجيه. على سبيل المثال: 
    http://newRouter_IP:port/v1/apiPath

    على سبيل المثال، إذا أكملت البرنامج التعليمي الأول حيث أنشأت واجهة برمجة تطبيقات Weather: 

    http://newRouter_IP:port/v1/weather/forecastrss?w=12797282

إضافة معالج رسائل

بعد تثبيت Edge على العقدة، استخدم الإجراء التالي لإضافة رسالة المعالج:

  1. ثبِّت Edge على العقدة باستخدام إجراء على الإنترنت أو خارج الإنترنت كما هو موضَّح في دليل تثبيت Edge.
  2. في موجِّه الأوامر، شغِّل النص البرمجي "apigee-setup.sh": 
    /opt/apigee/apigee-setup/bin/setup.sh -p mp -f configFile

    يحدد الخيار -p mp كيفية تثبيت معالج الرسائل. راجع تثبيت مكونات Edge على عقدة للحصول على معلومات حول إنشاء configFile.

  3. عند اكتمال التثبيت، يعرض النص البرمجي المعرّف الفريد العالمي لمعالج الرسائل. يُرجى العِلم أنّ المعرّف الفريد العالمي (UUID) لا غنى عنه لإكمال عملية الإعداد. إذا كنت بحاجة إلى تحدّد المعرّف الفريد العالمي (UUID)، استخدِم الأمر curl التالي على المضيف حيث تثبيت معالج الرسائل: 
    curl http://mp_IP:8082/v1/servers/self
  4. بالنسبة إلى كل بيئة في كل مؤسسة في عملية التثبيت، استخدِم ما يلي: curl لربط معالج الرسائل بالبيئة: 
    curl -v -u adminEmail:pword \
  -H "Content-Type: application/x-www-form-urlencoded" -X POST
  "http://ms_IP:8080/v1/o/org_name/e/env_name/servers" \
  -d "action=add&uuid=mp_UUID"

    استبدل ms_IP بعنوان IP لخادم الإدارة org_name وenv_name مع المؤسسة والبيئة المرتبطة من خلال معالج الرسائل.

  5. للتحقّق من الإعدادات، يمكنك تشغيل الأمر curl التالي: 
    curl -v -u adminEmail:pword \
  "http://ms_IP:8080/v1/o/org_name/e/env_name/servers"

    حيث يكون org_name هو اسم مؤسستك، env_name هي البيئة. من المفترض أن تظهر لك المعرفات الفريدة العامة (UUID) لكل الرسائل. المعالِجات المرتبطة بالمؤسسة والبيئة، بما في ذلك معالِج الرسائل الذي أضفته للتو.

  6. إذا كنت تستخدم مصادقة Cassandra، ففعِّل "معالج الرسائل" للاتصال كاساندرا: 
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor store_cassandra_credentials -u username -p password

    لمزيد من المعلومات، يُرجى الاطِّلاع على تفعيل مصادقة Cassandra.

إعادة تشغيل أجهزة التوجيه

بعد إضافة جميع عُقد معالج الرسائل، ننصحك بإعادة تشغيل أجهزة التوجيه:

/opt/apigee/apigee-service/bin/apigee-service edge-router restart

إضافة كل من جهاز التوجيه ومعالج الرسائل

بعد تثبيت Edge على العقدة، استخدم الإجراء التالي لإضافة جهاز توجيه ورسالة معالِج البيانات في الوقت نفسه:

  1. في موجِّه الأوامر، شغِّل النص البرمجي "apigee-setup": 
    /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile

    يشير الخيار -p rmp إلى كيفية تثبيت جهاز التوجيه ومعالج الرسائل. عرض تثبيت مكونات Edge على عقدة من أجل معلومات حول إنشاء configFile.

  2. اتبع الإجراءات أعلاه لإعداد جهاز التوجيه ومعالج الرسائل.