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

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

يتم تثبيت 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 ثبِّت وحدة الدخول المُوحَّد في 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

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

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

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

تُسجِّل الأداة setup.sh تلقائيًا معلومات السجلّ عن عملية التثبيت في:

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

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

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

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

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

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

  • مع إيقاف مصادقة 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. تثبيت مجموعة تخزين البيانات على العُقد 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>"

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

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

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