تثبيت Edge Edgewayway

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

الإصدار 2.4.x من Edge Microgateway

الجمهور

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

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

  • يجب أن يكون لديك الإصدار 4.5 LTS أو إصدار أحدث من Node.js مثبّتًا على نظامك. يمكنك الاطّلاع على تعليمات Node.js الإضافية أدناه.
  • يتطلّب نظام التشغيل Windows تثبيت OpenSSL وإضافته إلى PATH.
  • إذا كنت تستخدم Apigee Edge Private Cloud لإجراء الإعدادات باستخدام Edge Microgateway، يجب أن يكون لديك الإصدار 4.16.01 أو إصدار أحدث من 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؟. 
    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، وكان لديك برنامج shell لا يتوافق مع علامة التلدة، عليك استبدال علامة التلدة بمتغير البيئة المناسب في الأوامر التي تشير إلى الدليل الرئيسي. على سبيل المثال: %USERPROFILE%/.edgemicro.

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

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

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

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

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

الخطوات الأولى

إذا كنت حديث العهد باستخدام Edge Microgateway، فإنّ إعداد 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