تثبيت Edge Edgewayway

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. المعلومات

Edge Microgateway، الإصدار 2.3.x

الجمهور

استعن بهذا الدليل إذا كنت بحاجة إلى تركيب أو إلغاء تثبيت Edge Microgateway.

المتطلبات الأساسية

  • يجب تثبيت الإصدار 4.5 من قناة الدعم الطويل الأمد (LTS) أو إصدار أحدث من Node.js على النظام لديك. يمكنك الاطّلاع على تعليمات Node.js الإضافية أدناه.
  • يتطلب نظام التشغيل Windows تثبيت OpenSSL وإضافته إلى PATH.
  • إذا كنت تستخدم Apigee Edge Private Cloud لضبطها باستخدام Edge Microgateway، يجب استخدام الإصدار 4.15.07 أو إصدار أحدث من Private Cloud.

تثبيت Node.js

يجب أن يكون لديك الإصدار 4.5 أو إصدار أحدث من Node.js على نظامك. ويمكنك التحقق من ذلك من خلال تنفيذ ما يلي:

node -v

وهناك العديد من الطرق للحصول على Node.js أو تحديثها. على سبيل المثال، يمكنك استخدام HomeBrew أو yum أو تنزيله مباشرةً من موقع Node.js الإلكتروني: https://nodejs.org/download.

تثبيت Edge Microgateway إذا كان لديك اتصال بالإنترنت

يوضّح هذا القسم طريقة تثبيت Edge Microgateway وضبط الإعدادات التلقائية.

  1. ثبِّت أحدث إصدار من Edge Microgateway باستخدام npm باستخدام الأمر التالي. يثبّت هذا الأمر البرنامج ويضع edgemicro تنفيذيًا في مسارك. لمعرفة المكان الذي يثبّت فيه الأمر التالي تثبيت Edge Microgateway، اطّلِع على القسم أين يتم تثبيت Edge Microgateway؟. 
    npm install edgemicro -g

    لتثبيت إصدار معيّن من Edge Microgateway، عليك تحديد رقم الإصدار في أمر التثبيت. إذا لم تحدّد رقم الإصدار، سيتم تثبيت أحدث إصدار. على سبيل المثال، لتثبيت الإصدار 2.3.1، استخدِم الأمر التالي. 

    npm install edgemicro@2.3.1 -g
  2. تحقَّق من رقم الإصدار. على سبيل المثال، في حال تثبيت الإصدار 2.3.5: 
    edgemicro --version
current nodejs version is v6.1.0
current edgemicro version is 2.3.5
  3. نفِّذ هذا الأمر لإنشاء ملف إعداد تلقائي في الدليل الرئيسي. 
    edgemicro init
  4. (اختياري) تم وضع ملف إعداد يُسمى ملف default.yaml في الدليل الرئيسي في دليل فرعي يُسمى .edgemicro. تحقَّق الآن للتأكد من توفّر هذا الملف: 
    ls ~/.edgemicro
default.yaml

    ملاحظة: في مستندات Edge Microgateway، نشير إلى الدليل الرئيسي بعلامة التلدة (~)، وهو اختصار UNIX. إذا كنت تستخدم نظام التشغيل Windows، وإذا كنت تشغّل واجهة أوامر لا تتيح رمز التلدة، ستحتاج إلى استبدال متغيّر البيئة المناسب بعلامة التلدة في الأوامر التي تشير إلى الدليل الرئيسي. على سبيل المثال: %USERPROFILE%/.edgemicro.

  5. اتّبِع الخطوات الواردة في تثبيت Edge Microgateway.

تشغيل Edge Microgateway على نظام التشغيل Windows كخدمة

يمكنك تشغيل Edge Microgateway على نظام التشغيل Windows كخدمة. للحصول على التفاصيل، يُرجى الاطّلاع على أفضل الممارسات للإدارة التشغيلية لنظام التشغيل Microgateway (edgemicro) على نظام التشغيل Windows على منتدى Apigee.

هل يمكنني تثبيت Edge Microgateway بدون الاتصال بالإنترنت؟

في المواقع الإلكترونية غير الجاهزة للوصول إلى الإنترنت، يمكن للمشرف تثبيت سجلّ npm الخاص بك والاحتفاظ به على شبكتك الداخلية. ولا ينطبق هذا الدليل على تعليمات إعداد سجلّ npm خاص، ولكن يمكنك البحث عن تعليمات مفيدة والعثور عليها. بعد تثبيت قاعدة بيانات المسجّلين الخاصة في npm، يمكنك اتّباع تعليمات التثبيت الواردة أعلاه.

البدء

إذا كنت مبتدئًا في استخدام Edge Microgateway، يُعدّ Installing Edge Microgateway أفضل مكان للبدء بعد إكمال عملية التثبيت. يشمل دليل الإعداد والضبط جميع الخطوات التي تحتاج إلى تنفيذها لتثبيت مثيل من Edge Microgateway وضبطه وبدء استخدامه واستخدامه.

أين يتم تثبيت Edge Microgateway؟

عند استخدام npm مع الخيار العام (npm install -g edgemicro)، يتم تثبيت البرنامج على [prefix]/lib/node_modules/edgemicro. يمكنك العثور على قيمة [prefix] باستخدام الأمر التالي:

npm config get prefix

قيمة [prefix] قابلة للضبط. راجع npm-folders للحصول على مزيد من المعلومات.

إلغاء تثبيت Edge Microgateway

إذا كنت بحاجة إلى إزالة Edge Microgateway:

  1. هل تريد حذف دليل التثبيت [prefix]/lib/node_modules/edgemicro أو أرشفته حيث تشير [prefix] إلى بادئة npm كما هو موضّح في القسم أين يتم تثبيت Edge Microgateway؟
  2. حذف ملفات السجلّ أو وضعها في الأرشيف وبشكل تلقائي، تكون ملفات edgemicro-*.log متوفّرة في /var/tmp/، ولكن هذا الموقع قابل للتهيئة. تحقَّق من ملف الإعداد إذا كان لديك شكوك، كما هو موضّح في "إدارة ملفات السجلّ".
  3. احذف ملفات ضبط وقت التشغيل وملفات ضبط ذاكرة التخزين المؤقت أو أرشفتها: 
    ~/.edgemicro/*.yaml