تثبيت مكوّنات Edge على عقدة

بعد تثبيت أداة Edge apigee-setup على عقدة، استخدِم أداة apigee-setup لتثبيت مكوّن واحد أو أكثر من مكوّنات Edge على العقدة.

تستخدم أداة apigee-setup أمرًا بالتنسيق التالي:

/opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

حيث component هو أحد مكونات Edge المطلوب تثبيته، وconfigFile هو ملف الإعداد الصامت الذي يحتوي على معلومات التثبيت. يجب أن يكون ملف الإعداد قابلاً للوصول إليه أو قراءته من قِبل المستخدم "apigee". على سبيل المثال، يمكنك إنشاء دليل جديد للملفات، أو وضعها في الدليل /usr/local أو /usr/local/share، أو في أي مكان آخر على العقدة يمكن للمستخدم "apigee" الوصول إليه.

على سبيل المثال، لتثبيت Edge Management Server، اتّبِع الخطوات التالية:

/opt/apigee/apigee-setup/bin/setup.sh -p ms -f /usr/local/myConfig

للحصول على معلومات حول تثبيت Edge apigee-setup، يُرجى الاطّلاع على تثبيت أداة apigee-setup في Edge.

اعتبارات التثبيت

أثناء كتابة ملف الإعدادات، ضَع في اعتبارك الخيارات التالية.

إعداد عملية النسخ المتماثل الرئيسية الاحتياطية في Postgres

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

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

اعتبارات RHEL 9.X/Rocky 9.X/Oracle 9.X symasldap 2.6.7

يتطلّب التثبيت المحلي SymasLDAP 2.6.7، وهو مضمّن في مستودع apigee-thirdparty-opdk. لإجراء عملية تثبيت سهلة، يُرجى إزالة المكتبة symasldap-compat.

بالنسبة إلى عمليات التثبيت التي تتضمّن 13 مضيفًا وعمليات التثبيت التي تتضمّن 12 مضيفًا مع مركزَي بيانات، يكون النسخ المتماثل من SymasLDAP مطلوبًا لأنّه تتوفّر عُقد متعددة تستضيف SymasLDAP.

تفعيل مصادقة Cassandra

يتم تثبيت Cassandra تلقائيًا بدون تفعيل المصادقة. وهذا يعني أنّه يمكن لأي شخص الوصول إلى Cassandra. يمكنك تفعيل المصادقة بعد تثبيت Edge أو كجزء من عملية التثبيت.

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

استخدام منفذ محمي عند إنشاء مضيف افتراضي

إذا أردت إنشاء مضيف افتراضي يربط جهاز التوجيه بمنفذ محمي، مثل أرقام المنافذ الأقل من 1000، عليك ضبط جهاز التوجيه ليعمل كمستخدم لديه إذن الوصول إلى هذه المنافذ. بشكلٍ تلقائي، يتم تشغيل "الموجّه" (Router) باسم المستخدم "apigee" الذي لا يمكنه الوصول إلى المنافذ ذات الامتيازات.

للحصول على معلومات حول كيفية ضبط مضيف افتراضي وجهاز توجيه للوصول إلى المنافذ التي تقلّ عن 1000، يُرجى الاطّلاع على إعداد مضيف افتراضي.

متطلبات جديدة تم تقديمها من خلال apigee-qpidd-4.52.01-X.X.X

بدءًا من الإصدار 4.52.01، تم تقديم متطلبات جديدة أثناء عملية التثبيت. ويستلزم ذلك تضمين السمتَين QPID_MGMT_USERNAME وQPID_MGMT_PASSWORD أثناء التثبيت. تأكَّد من إضافة هذه السمات مع القيم المناسبة في ملف الإعداد لتسهيل عملية التثبيت بنجاح.

تثبيت واجهة مستخدم Edge الجديدة

بعد إكمال عملية التثبيت الأولية، تنصح Apigee بتثبيت واجهة مستخدم Edge الجديدة، وهي واجهة مستخدم محسّنة للمطوّرين والمشرفين على Apigee Edge Private Cloud. (يتم تثبيت واجهة المستخدم الكلاسيكية تلقائيًا).

يُرجى العِلم أنّ واجهة مستخدم Edge تتطلّب إيقاف المصادقة الأساسية واستخدام IDP، مثل SAML أو LDAP.

لمزيد من المعلومات، يُرجى الاطّلاع على تثبيت واجهة مستخدم Edge الجديدة.

تحديد المكوّنات المطلوب تثبيتها

يسرد الجدول التالي الخيارات التي يمكنك تمريرها إلى الخيار -p في الأداة المساعدة apigee-service لتحديد المكوّنات التي سيتم تثبيتها على العقدة:

المكوّن الوصف

c

تثبيت Cassandra فقط

zk تثبيت ZooKeeper فقط

ds

ثبِّت ZooKeeper وCassandra.

ld

ثبِّت SymasLDAP فقط.

mt

ثبِّت Edge Management Server، الذي يثبِّت أيضًا SymasLDAP.

في حال ضبط USE_LDAP_REMOTE_HOST=y في ملف الإعداد، سيتم تخطّي عملية تثبيت SymasLDAP وسيستخدم "خادم الإدارة" برنامج SymasLDAP المثبَّت على عُقدة مختلفة.

ms

ثبِّت Edge Management Server، الذي يثبِّت أيضًا واجهة مستخدم Edge وSymasLDAP.

في حال ضبط USE_LDAP_REMOTE_HOST=y في ملف الإعداد، سيتم تخطّي عملية تثبيت SymasLDAP، وسيستخدم "خادم الإدارة" برنامج SymasLDAP المثبَّت على عُقدة مختلفة.

r

تثبيت جهاز التوجيه Edge فقط

mp

تثبيت "معالج رسائل Edge" فقط

rmp

ثبِّت Edge Router وMessage Processor.

ui

ثبِّت واجهة مستخدم Edge.

qs

ثبِّت Qpid Server فقط.

ps

ثبِّت خادم Postgres فقط.

pdb تثبيت قاعدة بيانات Postgres فقط: يتم استخدامها فقط عند تثبيت بوابة Apigee Developer Services (أو ببساطة، البوابة). راجِع مقالة تثبيت البوابة.

sax

ثبِّت مكوّنات الإحصاءات، أي Qpid وPostgres.

لا تستخدِم هذا الخيار إلا في مرحلتَي التطوير والاختبار، وليس في مرحلة الإنتاج.

sso ثبِّت وحدة Apigee SSO.

mo

تثبيت ميزة "تحقيق الربح"

sa

ثبِّت Edge بشكل مستقل، أي Cassandra وZooKeeper وManagement Server وSymasLDAP وEdge UI وRouter وMessage Processor. يستبعد هذا الخيار مكوّنات Edge Analytics: Qpid وPostgres.

لا تستخدِم هذا الخيار إلا في مرحلتَي التطوير والاختبار، وليس في مرحلة الإنتاج.

aio

ثبِّت جميع المكوّنات على عُقدة واحدة.

لا تستخدِم هذا الخيار إلا في مرحلتَي التطوير والاختبار، وليس في مرحلة الإنتاج.

dp

تثبيت البوابة

إنشاء ملف إعداد

يحتوي ملف الإعداد على جميع المعلومات اللازمة لتثبيت Edge. يمكنك غالبًا استخدام ملف الإعداد نفسه لتثبيت جميع المكوّنات في عملية تثبيت Edge.

ومع ذلك، عليك استخدام ملفات إعداد مختلفة أو تعديل ملف الإعداد في الحالات التالية:

  • أنت بصدد تثبيت عدة خوادم SymasLDAP وتحتاج إلى ضبط النسخ المتماثل كجزء من عملية تثبيت تتضمّن 13 عقدة. يجب أن يتضمّن كل ملف قيمًا مختلفة لكل من LDAP_SID وLDAP_PEER.
  • أنت بصدد إنشاء مراكز بيانات متعددة كجزء من عملية تثبيت 12 عقدة. يتطلّب كل مركز بيانات إعدادات مختلفة للسمات، مثل ZK_CLIENT_HOSTS وCASS_HOSTS.

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

اختبار متطلبات النظام بدون تنفيذ عملية تثبيت

يتيح Edge for Private Cloud استخدام السمة ENABLE_SYSTEM_CHECK=y للتحقّق من متطلبات وحدة المعالجة المركزية والذاكرة على جهاز كجزء من عملية التثبيت. ومع ذلك، في الإصدارات السابقة من Edge، كان هذا التحقّق يتطلّب منك إجراء عملية التثبيت فعليًا.

يمكنك الآن استخدام العلامة "-t" لإجراء هذا التحقّق بدون الحاجة إلى التثبيت. على سبيل المثال، للتحقّق من متطلبات النظام لعملية تثبيت "aio" بدون إجراء عملية التثبيت فعليًا، استخدِم الأمر التالي:

/opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile -t

يعرض هذا الأمر أي أخطاء في متطلبات النظام على الشاشة.

اطّلِع على متطلبات التثبيت للحصول على قائمة بمتطلبات النظام لجميع مكوّنات Edge.

ملفات سجلّ التثبيت

تكتب الأداة المساعدة setup.sh تلقائيًا معلومات السجلّ حول عملية التثبيت إلى:

/opt/apigee/var/log/apigee-setup/setup.log

إذا لم يكن لدى المستخدم الذي يشغّل أداة setup.sh إذن بالوصول إلى هذا الدليل، سيكتب السجلّ في الدليل /tmp كملف باسم setup_username.log.

إذا لم يكن لدى المستخدم إذن الوصول إلى /tmp، سيتعذّر تنفيذ الأداة setup.sh.

تثبيت مكوّنات Edge

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

تفترض جميع أمثلة التثبيت الموضّحة أدناه أنّك بصدد تثبيت ما يلي:

  • مع إيقاف مصادقة Cassandra (الإعداد التلقائي) لمزيد من المعلومات، يُرجى الاطّلاع على تفعيل مصادقة Cassandra.
  • مع إيقاف تكرار Postgres الرئيسي الاحتياطي (الإعداد التلقائي) لمزيد من المعلومات، راجِع إعداد عملية النسخ المتماثل الرئيسية الاحتياطية في Postgres.
  • معالج الرسائل وجهاز التوجيه على العقدة نفسها في حال تثبيت "معالجات الرسائل" و"أجهزة التوجيه" على عُقد مختلفة، عليك تثبيت جميع "معالجات الرسائل" أولاً، ثم جميع "أجهزة التوجيه".

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

قبل أن تتمكّن من تثبيت مكوّنات Edge، يجب استيفاء الشروط التالية:

  • راجِع متطلبات التثبيت للتعرّف على المتطلبات الأساسية وقائمة الملفات المطلوبة التي يجب الحصول عليها قبل المتابعة في عملية التثبيت. تأكَّد من مراجعة المتطلبات قبل بدء عملية التثبيت.
  • أوقِف SELinux أو اضبطه على وضع السماح. لمزيد من المعلومات، راجِع مقالة تثبيت أداة Edge apigee-setup.

التثبيت الشامل

  1. ثبِّت جميع المكوّنات على عقدة واحدة باستخدام الأمر:
    /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
  2. أعِد تشغيل مكوّن واجهة المستخدم الكلاسيكية بعد اكتمال عملية التثبيت:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    ينطبق ذلك على واجهة المستخدم الكلاسيكية، وليس على واجهة Edge الجديدة التي يكون اسم مكوّنها edge-management-ui.

  3. اختبِر عملية التثبيت كما هو موضّح في اختبار التثبيت.
  4. يمكنك إعداد مؤسستك كما هو موضّح في إعداد مؤسسة.

يمكنك مشاهدة فيديو حول عملية تثبيت Edge المتكاملة هنا.

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

# With SMTP
IP1=IP_or_DNS_name_of_Node_1
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
# Admin password must be at least 8 characters long and contain one uppercase
# letter, one lowercase letter, and one digit or special character
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
LDAP_TYPE=1
APIGEE_LDAPPW=LDAP_PASSWORD
MP_POD=gateway
REGION=dc-1
ZK_HOSTS="$IP1"
ZK_CLIENT_HOSTS="$IP1"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1"
# Default is postgres
PG_PWD=postgres
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234

عملية التثبيت المستقلة على عقدتَين

راجِع تصاميم التثبيت للاطّلاع على قائمة بتصاميم Edge وأرقام العُقد.

  1. تثبيت Standalone Gateway والعقدة 1
    /opt/apigee/apigee-setup/bin/setup.sh -p sa -f configFile
  2. ثبِّت "إحصاءات Google" على العُقدة 2:
    /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile
  3. أعِد تشغيل مكوّن واجهة المستخدم الكلاسيكية على العقدة 1:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    ينطبق ذلك على واجهة المستخدم الكلاسيكية، وليس على واجهة Edge الجديدة التي يكون اسم مكوّنها edge-management-ui.

  4. اختبِر عملية التثبيت كما هو موضّح في اختبار التثبيت.
  5. يمكنك إعداد مؤسستك كما هو موضّح في إعداد مؤسسة.

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

# With SMTP
IP1=IP_of_Node_1
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
LDAP_TYPE=1
APIGEE_LDAPPW=LDAP_PASSWORD
MP_POD=gateway
REGION=dc-1
ZK_HOSTS="$IP1"
ZK_CLIENT_HOSTS="$IP1"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1"
# Default is postgres
PG_PWD=postgres
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234

تثبيت 5 عُقد

راجِع تصاميم التثبيت للاطّلاع على قائمة بتصاميم Edge وأرقام العُقد.

  1. ثبِّت مجموعة Datastore على العُقد 1 و2 و3:
    /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. ثبِّت Management Server على العقدة 1:
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. ثبِّت "جهاز التوجيه" و"معالج الرسائل" على العقدتين 2 و3:
    /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. ثبِّت "إحصاءات Google" على العقدتين 4 و5:
    /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile
  5. أعِد تشغيل مكوّن واجهة المستخدم الكلاسيكية على العقدة 1:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    ينطبق ذلك على واجهة المستخدم الكلاسيكية، وليس على واجهة Edge الجديدة التي يكون اسم مكوّنها edge-management-ui.

  6. اختبِر عملية التثبيت كما هو موضّح في اختبار التثبيت.
  7. يمكنك إعداد مؤسستك كما هو موضّح في إعداد مؤسسة.

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

# With SMTP
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP4=IP_of_Node_4
IP5=IP_of_Node_5
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=1
APIGEE_LDAPPW=LDAP_PASSWORD
MP_POD=gateway
REGION=dc-1
ZK_HOSTS="$IP1 $IP2 $IP3"
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1 $IP2 $IP3"
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP4
PG_STANDBY=$IP5
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234

عملية التثبيت المجمّعة ذات 9 عُقد

راجِع تصاميم التثبيت للاطّلاع على قائمة بتصاميم Edge وأرقام العُقد.

  1. ثبِّت Datastore Cluster Node على العُقد 1 و2 و3:
    /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. ثبِّت خادم إدارة Apigee على العقدة 1:
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. ثبِّت "جهاز التوجيه" و"معالج الرسائل" على العقدتين 4 و5:
    /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. ثبِّت خادم Qpid في "إحصاءات Apigee" على العقدة 6 و7:
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. ثبِّت خادم Apigee Analytics Postgres على العقدة 8 و9:
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. أعِد تشغيل مكوّن واجهة المستخدم الكلاسيكية على العقدة 1:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    ينطبق ذلك على واجهة المستخدم الكلاسيكية، وليس على واجهة المستخدم الجديدة Edge التي يكون اسم المكوّن فيها edge-management-ui.

  7. اختبِر عملية التثبيت كما هو موضّح في اختبار التثبيت.
  8. يمكنك إعداد مؤسستك كما هو موضّح في إعداد مؤسسة.

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

# With SMTP
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP8=IP_of_Node_8
IP9=IP_of_Node_9
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt 
MSIP=$IP1 
USE_LDAP_REMOTE_HOST=n 
LDAP_TYPE=1
APIGEE_LDAPPW=LDAP_PASSWORD
MP_POD=gateway
REGION=dc-1 
ZK_HOSTS="$IP1 $IP2 $IP3" 
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" 
# Must use IP addresses for CASS_HOSTS, not DNS names.
# Optionally use Cassandra racks
CASS_HOSTS="$IP1 $IP2 $IP3" 
# Default is postgres
PG_PWD=postgres
SKIP_SMTP=n
PG_MASTER=$IP8
PG_STANDBY=$IP9
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234

تثبيت مجموعة من 13 عقدة

يوضّح هذا القسم ترتيب التثبيت لمجموعة من 13 عقدة. للحصول على قائمة بطُرق تنظيم Edge وأرقام العُقد، يُرجى الاطّلاع على طُرق تنظيم التثبيت.

يكون ترتيب التثبيت لمجموعة مؤلّفة من 13 عقدة على النحو التالي:

  1. ثبِّت Datastore Cluster Node على العُقد 1 و2 و3:
    /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. ثبِّت SymasLDAP على العقدتين 4 و5:
    /opt/apigee/apigee-setup/bin/setup.sh -p ld -f configFile
  3. ثبِّت Apigee Management Server على العقدتين 6 و7:
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  4. ثبِّت خادم Apigee Analytics Postgres على العقدة 8 و9:
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  5. ثبِّت "جهاز التوجيه" و"معالج الرسائل" على العقدتَين 10 و11:
    /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  6. ثبِّت خادم Apigee Analytics Qpid على العقدتَين 12 و13:
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  7. أعِد تشغيل مكوّن واجهة المستخدم الكلاسيكية على العقدتَين 6 و7:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    ينطبق ذلك على واجهة المستخدم الكلاسيكية، وليس على واجهة Edge الجديدة التي يكون اسم مكوّنها edge-management-ui.

  8. اختبِر عملية التثبيت كما هو موضّح في اختبار التثبيت.
  9. يمكنك إعداد مؤسستك كما هو موضّح في إعداد مؤسسة.

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

# For all nodes except IP4 and IP5
# (which are the SymasLDAP nodes)
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP4=IP_of_Node_4
IP5=IP_of_Node_5
IP6=IP_of_Node_6
IP7=IP_of_Node_7
IP8=IP_of_Node_8
IP9=IP_of_Node_9
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
# Management Server on IP6 only
MSIP=$IP6
USE_LDAP_REMOTE_HOST=y
LDAP_HOST=$IP4
LDAP_PORT=10389
# Management Server on IP7 only
# MSIP=$IP7
# USE_LDAP_REMOTE_HOST=y
# LDAP_HOST=$IP5
# LDAP_PORT=10389
# Use the same password for both SymasLDAP nodes
APIGEE_LDAPPW=LDAP_PASSWORD 
MP_POD=gateway
REGION=dc-1
ZK_HOSTS="$IP1 $IP2 $IP3"
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"
# Must use IP addresses for CASS_HOSTS, not DNS names.
# Optionally use Cassandra racks
CASS_HOSTS="$IP1 $IP2 $IP3"
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP8
PG_STANDBY=$IP9
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234
# For SymasLDAP nodes only (IP4 and IP5)
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP4=IP_of_Node_4
IP5=IP_of_Node_5
IP6=IP_of_Node_6
IP7=IP_of_Node_7
IP8=IP_of_Node_8
IP9=IP_of_Node_9
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD

# For the SymasLDAP Server on IP4 only
MSIP=$IP6
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP5

# For the SymasLDAP Server on IP5 only
# MSIP=$IP7
# USE_LDAP_REMOTE_HOST=n
# LDAP_TYPE=2
# LDAP_SID=2
# LDAP_PEER=$IP4
# Set same password for both SymasLDAPs.
APIGEE_LDAPPW=LDAP_PASSWORD

تثبيت مجموعة من 12 عقدة

قبل تثبيت Edge على بنية مجمّعة من 12 عقدة (مركزَي بيانات)، عليك معرفة كيفية ضبط خصائص ZooKeeper وCassandra في ملف الإعداد الصامت.

  • ZooKeeper

    بالنسبة إلى السمة ZK_HOSTS لكلا مركزَي البيانات، حدِّد عناوين IP أو أسماء نظام أسماء النطاقات (DNS) لجميع عقد ZooKeeper من كلا مركزَي البيانات، بالترتيب نفسه، وضع علامة :observer على أي عقد باستخدام المعدِّل. تُسمّى العُقد التي لا تتضمّن المعدِّل :observer "عُقد التصويت". يجب أن يكون لديك عدد فردي من "المصوّتين" في الإعدادات.

    في هذه البنية، يكون مضيف ZooKeeper على المضيف 9 هو المراقب:

    بالنسبة إلى السمة ZK_CLIENT_HOSTS لكل مركز بيانات، حدِّد عناوين IP أو أسماء نظام أسماء النطاقات لعُقد ZooKeeper فقط في مركز البيانات، بالترتيب نفسه، لجميع عُقد ZooKeeper في مركز البيانات. في مثال ملف الإعدادات الموضّح أدناه، تم وضع علامة :observer على العقدة 9 حتى يكون لديك خمسة مصوّتين: العقد 1 و2 و3 و7 و8.

  • Cassandra

    يجب أن يتضمّن كل مركز بيانات العدد نفسه من عُقد Cassandra.

    بالنسبة إلى CASS_HOSTS لكل مركز بيانات، تأكَّد من تحديد جميع عناوين IP الخاصة بـ Cassandra (وليس أسماء نظام أسماء النطاقات) لكلا مركزي البيانات. بالنسبة إلى مركز البيانات 1، أدرِج عقد Cassandra في مركز البيانات هذا أولاً. بالنسبة إلى مركز البيانات 2، أدرِج عقد Cassandra في مركز البيانات هذا أولاً. أدرِج عقد Cassandra بالترتيب نفسه لجميع عقد Cassandra في مركز البيانات.

    يجب أن تتضمّن جميع عقد Cassandra اللاحقة ":d,r". على سبيل المثال، ip:1,1 = مركز البيانات 1 وحامل الخادم/منطقة التوفّر 1، و ip:2,1 = مركز البيانات 2 وحامل الخادم/منطقة التوفّر 1.

    على سبيل المثال، "192.168.124.201:1,1 192.168.124.202:1,1 192.168.124.203:1,1 192.168.124.204:2,1 192.168.124.205:2,1 192.168.124.206:2,1"

    سيتم استخدام العقدة الأولى في الحزمة/منطقة التوفّر 1 في كل مركز بيانات كخادم أساسي.

    في نموذج النشر هذا، سيظهر إعداد Cassandra على النحو التالي:

راجِع تصاميم التثبيت للاطّلاع على قائمة بتصاميم Edge وأرقام العُقد.

  1. ثبِّت Datastore Cluster Node على العُقد 1 و2 و3 و7 و8 و9:
    /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. ثبِّت Apigee Management Server مع تكرار SymasLDAP على العقدة 1 و7:
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. ثبِّت "الموجّه" و"معالج الرسائل" على العُقد 2 و3 و8 و9:
    /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. ثبِّت خادم Apigee Analytics Qpid على العُقد 4 و5 و10 و11:
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. ثبِّت Apigee Analytics Postgres Server على العقدة 6 و12:
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. أعِد تشغيل مكوّن واجهة المستخدم الكلاسيكية على العقدتَين 1 و7:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    ينطبق ذلك على واجهة المستخدم الكلاسيكية، وليس على واجهة Edge الجديدة التي يكون اسم مكوّنها edge-management-ui.

  7. اختبِر عملية التثبيت كما هو موضّح في اختبار التثبيت.
  8. يمكنك إعداد مؤسستك كما هو موضّح في إعداد مؤسسة.

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

  • يضبط هذا البرنامج SymasLDAP مع إمكانية النسخ المتماثل على عُقدتَي SymasLDAP.
  • تحدّد هذه السمة المعدِّل :observer على إحدى عُقد ZooKeeper. في عملية تثبيت في مركز بيانات واحد، احذف هذا المعدِّل.
# Datacenter 1
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP6=IP_of_Node_6
IP7=IP_of_Node_7
IP8=IP_of_Node_8
IP9=IP_of_Node_9
IP12=IP_of_Node_12
HOSTIP=$(hostname -i)
MSIP=$IP1
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP7
APIGEE_LDAPPW=LDAP_PASSWORD
MP_POD=gateway-1
REGION=dc-1
ZK_HOSTS="$IP1 $IP2 $IP3 $IP7 $IP8 $IP9:observer"
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"
# Must use IP addresses for CASS_HOSTS, not DNS names.
# Optionally use Cassandra racks
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1 $IP7:2,1 $IP8:2,1 $IP9:2,1"
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP6
PG_STANDBY=$IP12
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234
# Datacenter 2
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP6=IP_of_Node_6
IP7=IP_of_Node_7
IP8=IP_of_Node_8
IP9=IP_of_Node_9
IP12=IP_of_Node_12
HOSTIP=$(hostname -i)
MSIP=$IP7
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=2
LDAP_PEER=$IP1
APIGEE_LDAPPW=LDAP_PASSWORD
MP_POD=gateway-2
REGION=dc-2
ZK_HOSTS="$IP1 $IP2 $IP3 $IP7 $IP8 $IP9:observer"
ZK_CLIENT_HOSTS="$IP7 $IP8 $IP9"
# Must use IP addresses for CASS_HOSTS, not DNS names.
# Optionally use Cassandra racks
CASS_HOSTS="$IP7:2,1 $IP8:2,1 $IP9:2,1 $IP1:1,1 $IP2:1,1 $IP3:1,1"
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP6
PG_STANDBY=$IP12
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234