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

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

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

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

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

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

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

تثبيت واجهة مستخدم 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 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 أو اضبطه على الوضع المتساهِل. راجِع تثبيت أداة 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

تثبيت مستقل بعقدة 2

يمكنك الاطّلاع على منهجيات التثبيت للحصول على قائمة طوعيات 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. تثبيت مجموعة تخزين البيانات على العُقد 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. ثبِّت عقدة مجموعة Datastore على العقدة 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 Analytics على العقدتَين 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.

  • كاساندرا

    يجب أن تتضمّن جميع مراكز البيانات العدد نفسه من عقد 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. ثبِّت خادم Qpid في Apigee Analytics على العقدة 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. يمكنك إعداد مؤسستك على النحو الموضَّح في مقالة إعداد مؤسسة.

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

  • ضبط 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>"