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

بعد تثبيت أداة Edge apigee-setup على العقدة، استخدِم الأداة المساعدة apigee-setup لتثبيت مكوّن واحد أو أكثر من مكوّنات Edge على العقدة.

تستخدم الأداة المساعدة apigee-setup أمرًا بالصيغة:

/opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

حيث يكون component هو مكوّن Edge المطلوب تثبيته، وconfigFile هو ملف الإعداد الصامت الذي يحتوي على معلومات التثبيت. يجب أن يتمكن مستخدم "واجهة برمجة التطبيقات" من الوصول إلى ملف الإعداد أو قراءته. على سبيل المثال، يمكنك إنشاء دليل جديد للملفات، أو وضعها في الدليل /usr/local أو /usr/local/share، أو في أي مكان آخر على العقدة التي يمكن للمستخدم "apigee" الوصول إليها.

على سبيل المثال، لتثبيت خادم إدارة Edge:

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

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

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

عند كتابة ملف الإعداد، يجب مراعاة الخيارات التالية.

إعداد النسخ المماثل في وضع الاستعداد الرئيسي Postgres

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

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

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

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

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

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

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

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

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

بعد إكمال التثبيت الأولي، ينصح Apigee بتثبيت واجهة مستخدم Edge الجديدة، وهي واجهة مستخدم محسَّنة للمطوّرين ومشرفي Apigee Edge لـ 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 فقط.

mp

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

rmp

تثبيت جهاز توجيه Edge ومعالج الرسائل

ui

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

qs

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

ps

تثبيت خادم Postgres فقط.

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

sax

قم بتثبيت مكونات التحليلات، أي Qpid وPostgres.

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

sso ثبِّت وحدة الدخول الموحّد لخدمة Apigee.

mo

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

sa

يمكنك تثبيت Edge المستقل، أي Cassandra وطْوKeeper وخادم الإدارة وOpenLDAP وواجهة مستخدم Edge، وجهاز التوجيه، ومعالج الرسائل. يغفل هذا الخيار مكوّنَي إحصاءات Edge : Qpid وPostgres.

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

aio

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

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

dp

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

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

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

ومع ذلك، عليك استخدام ملفات إعداد مختلفة أو تعديل ملف الإعداد في الحالات التالية:

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

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

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

يتيح متصفّح Edge الخاص بخدمة Private Cloud السمة ENABLE_SYSTEM_CHECK=y للتحقّق من متطلبات الذاكرة ووحدة المعالجة المركزية (CPU) على الجهاز كجزء من عملية التثبيت. وفي الإصدارات السابقة من 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، يجب عليك:

تركيب شامل

  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 هنا.

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

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

تركيب مستقل من عُقدتَين

راجِع تصميمات التثبيت للحصول على قائمة بمخططات شبكة 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>"

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

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

# 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 في العقدة 6 و7:
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  4. ثبِّت خادم Apigee Analytics Postgres في العقدة 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. امنح مؤسستك إمكانية الوصول إلى الخدمة كما هو موضّح في القسم منح إمكانيّة الوصول إلى مؤسسة.

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

# 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، أدخِل أولاً عُقد "كاساندرا" في مركز البيانات هذا. بالنسبة لمركز البيانات 2، قم بإدراج عُقد 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.202:124."

    سيتم استخدام العقدة الأولى في منطقة الرفّ/منطقة التوفّر 1 من كل مركز بيانات كخادم أساسي.

    في نموذج النشر هذا، سيبدو إعداد Cassandra على النحو التالي:

راجِع تصميمات التثبيت للحصول على قائمة بمخططات شبكة Edge وأرقام العُقد.

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

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

  • تُستخدَم لإعداد بروتوكول 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>"