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

بعد تثبيت الأداة apigee-setup في Edge على عقدة، استخدِم الأداة 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.

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

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

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

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

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

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

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

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

يُرجى العلم أنّ واجهة مستخدم Edge تتطلّب إيقاف المصادقة الأساسية واستخدام IDP مثل 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 Developer Services (أو البوابة ببساطة). يُرجى الاطّلاع على مقالة تثبيت البوابة.

sax

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

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

mo

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

sa

تثبيت Edge المستقل، أي Cassandra و ZooKeeper وManage Server وOpenLDAP وEdge UI وRouter ومعالج الرسائل. يحذف هذا الخيار مكوّنات تحليلات 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. يمكنك إعداد مؤسستك كما هو موضّح في مقالة إعداد مؤسسة.

في ما يلي ملف إعدادات صامت لهذه البنية. للحصول على مرجع كامل حولملف الإعداد، يُرجى الاطّلاع على مرجع ملف إعدادات 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>"

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

يظهر أدناه ملف تهيئة صامت لهذا المخطط. للحصول على مرجع كامل حولملف الإعداد، يُرجى الاطّلاع على مرجع ملف إعدادات 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>"

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

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

  1. تثبيت عقدة مجموعة تخزين البيانات على العقدة 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. تثبيت خادم Apigee Analytics Qpid على العقدة 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>"

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

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

# 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>"
 
# 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.

  • كاساندرا

    يجب أن يكون لجميع مراكز البيانات نفس عدد عُقد كاساندرا.

    بالنسبة إلى 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. ثبِّت خادم Qpid في Apigee Analytics على العقدة 4 و5 و10 و11: 
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. تثبيت خادم Apigee Analytics Postgres على العقدة 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>"
 
# 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>"