تثبيت مكوّنات 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:

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

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

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

أثناء كتابة ملف التهيئة، ضع في اعتبارك الخيارات التالية.

إعداد ميزة "النسخ الاحتياطي للمشغّل الرئيسي" في Postgres

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

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

ملاحظات حول openldap 2.4 في RHEL 9.X/Rocky 9.X/Oracle 9.X

يتطلب التثبيت على الموقع الإلكتروني استخدام OpenLDAP 2.4، وهو مضمّن في مستودع apigee-thirdparty-opdk. لتسهيل عملية التثبيت، يُرجى إزالة مكتبة openldap-compat.

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

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

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

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

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

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

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

المتطلبات الجديدة التي طرحتها apigee-qpidd-4.52.01-X.X.X

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

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

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

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

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

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

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

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

c

تثبيت Cassandra فقط
zk تثبيت ZooKeeper فقط

ds

ثبِّت ZooKeeper وCassandra.

ld

ثبِّت OpenLDAP فقط.

mt

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

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

ms

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

في حال ضبط USE_LDAP_REMOTE_HOST=y في ملف الإعداد، يتم تخطي تثبيت OpenLDAP ويستخدم خادم الإدارة بروتوكول OpenLDAP المثبّت على عقدة مختلفة.

r

ثبِّت Edge Router فقط.

mp

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

rmp

ثبِّت Edge Router وMessage Processor.

ui

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

qs

ثبِّت Qpid Server فقط.

ps

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

sax

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

استخدِم هذا الخيار للتطوير والاختبار فقط، وليس للإصدار العلني.
sso ثبِّت وحدة الدخول المُوحَّد في Apigee.

mo

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

sa

تثبيت Edge بشكل مستقل، أي Cassandra وZooKeeper وخادم الإدارة وOpenLDAP وEdge UI وRouter وMessage Processor يحذف هذا الخيار مكوّنات تحليلات Edge: Qpid وPostgres.

استخدِم هذا الخيار للتطوير والاختبار فقط، وليس للإصدار العلني.

aio

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

استخدِم هذا الخيار للتطوير والاختبار فقط، وليس للإصدار العلني.
dp

ثبِّت البوابة.

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

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

ومع ذلك، ستحتاج إلى استخدام ملفات إعداد مختلفة، أو تعديل ملف الضبط، في الحالات التالية:

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

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

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

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

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

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

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

اطّلِع على متطلبات التثبيت للحصول على قائمة ب requirements النظام لجميع مكوّنات 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 أو اضبطه على الوضع المتساهِل. اطّلِع على تثبيت أداة إعداد apigee في Edge للحصول على المزيد من المعلومات.

التركيب الشامل

  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. تثبيت بوابة مستقلة والعقدة 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. يمكنك إعداد مؤسستك كما هو موضّح في مقالة إعداد مؤسسة.

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

# 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. ثبِّت "خادم الإدارة" على العقدة 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. يمكنك إعداد مؤسستك كما هو موضّح في مقالة إعداد مؤسسة.

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

# 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. ثبِّت عقدة "مجموعة أماكن تخزين البيانات" على العقدة 1 و2 و3: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. ثبِّت Apigee Management Server على العقدة 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 Analytics على العقدتَين 6 و7: 
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. ثبِّت خادم Postgres في Apigee Analytics على العقدتَين 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. ثبِّت عقدة "مجموعة أماكن تخزين البيانات" على العقدة 1 و2 و3: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. ثبِّت OpenLDAP على العقدتَين 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. ثبِّت خادم Postgres في Apigee Analytics على العقدتَين 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. ثبِّت خادم Qpid في Apigee Analytics على العقدتَين 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 OpenLDAP 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 OpenLDAP 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 OpenLDAP 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 OpenLDAP Server on IP4 only
MSIP=$IP6
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP5

# For the OpenLDAP 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 OpenLDAPs.
APIGEE_LDAPPW=LDAP_PASSWORD

عملية التركيب المجمّعة التي تتضمّن 12 عقدة

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

  • ZooKeeper

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

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

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

  • كاساندرا

    يجب أن تتضمّن جميع مراكز البيانات العدد نفسه من عقد 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" على العقدة 1 و2 و3 و7 و8 و9: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. ثبِّت "خادم إدارة Apigee" مع إعادة النسخ في OpenLDAP على العقدتَين 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. ثبِّت خادم Postgres في Apigee Analytics على العقدتَين 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.

  • ضبط OpenLDAP مع النسخ على مستوى عقدتَين من OpenLDAP
  • تُحدِّد مُعدِّل :observer في عقدة ZooKeeper واحدة. في عملية تثبيت واحدة لمركز data center، احذف هذا المُعدِّل.
# 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