تثبيت مكوّنات 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، عليك ضبط جهاز التوجيه ليعمل كمستخدم لديه إذن الوصول إلى تلك المنافذ. By default, the Router runs as the user "apigee" which does not have access to privileged ports.

للحصول على معلومات حول كيفية ضبط مضيف افتراضي وجهاز توجيه للوصول إلى المنافذ التي تقل عن 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، الذي يثبِّت أيضًا OpenLDAP.

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

ms

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

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

r

تثبيت Edge Router فقط

mp

تثبيت Edge Message Processor فقط

rmp

ثبِّت Edge Router وMessage Processor.

ui

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

qs

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

ps

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

sax

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

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

mo

ثبِّت Monetization.

sa

تثبيت Edge المستقل، أي Cassandra وZooKeeper وخادم الإدارة وOpenLDAP وواجهة مستخدم Edge وجهاز التوجيه ومعالج الرسائل يؤدي هذا الخيار إلى حذف مكوّنات إحصاءات 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 (الإعداد التلقائي) لمزيد من المعلومات، يُرجى الاطّلاع على تفعيل مصادقة Cassandra.
  • عند إيقاف النسخ المتماثل الرئيسي-الاحتياطي في Postgres (الإعداد التلقائي) لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إعداد النسخ المتماثل الرئيسي-الاحتياطي في Postgres.
  • معالج الرسائل والموجّه على العقدة نفسها في حال تثبيت معالِجات الرسائل وأجهزة التوجيه على عُقد مختلفة، ثبِّت جميع معالِجات الرسائل أولاً، ثم جميع أجهزة التوجيه.

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

قبل أن تتمكّن من تثبيت مكوّنات Edge، عليك إجراء ما يلي:

  • يُرجى مراجعة متطلبات التثبيت للاطّلاع على المتطلبات الأساسية وقائمة الملفات المطلوبة قبل المتابعة في عملية التثبيت. تأكَّد من مراجعة المتطلبات قبل بدء عملية التثبيت.
  • أوقِف SELinux أو اضبطه على وضع السماح. اطّلِع على تثبيت أداة apigee-setup في 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. ثبِّت Analytics على العقدة 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. ثبِّت 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>"

تثبيت مجمّع من 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. ثبِّت Router وMessage Processor على العقدتَين 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. ثبِّت خادم Postgres في "إحصاءات Apigee" على العقدتَين 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. ثبِّت عقدة مجموعة Datastore على العقدة 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 على العقدتَين 6 و7: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  4. ثبِّت خادم Postgres في "إحصاءات Apigee" على العقدتَين 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" على العقدتَين 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

    يجب أن تحتوي جميع مراكز البيانات على العدد نفسه من عُقد 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 Management Server مع النسخ المتماثل لـ 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 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.

  • يضبط هذا الخيار OpenLDAP مع النسخ المتماثل عبر عقدتَي OpenLDAP.
  • تحدّد هذه المَعلمة معدِّل :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>"
 
# 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>"