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

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

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

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

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

المتطلّبات الجديدة التي أدخلتها حزمة apigee-qpidd-4.52.01-X.X.X

اعتبارًا من الإصدار 4.52.01، تمّ إدخال متطلبات جديدة أثناء التثبيت. ويتطلّب ذلك تضمين السمتَين QPID_MGMT_USERNAME وQPID_MGMT_PASSWORD أثناء عملية التثبيت. تأكَّد من إضافة هذه السمات بالقيم المناسبة في ملف الإعداد لتسهيل عملية التثبيت بنجاح.

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

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

اطّلِع على متطلبات التثبيت للحصول على قائمة ب 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>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=Apigee1234

تركيب 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>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=Apigee1234

عملية التركيب المجمّعة التي تتضمّن 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. ثبِّت خادم Qpid في Apigee Analytics على العقدتَين 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>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=Apigee1234

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

في ما يلي نموذج لملف الضبط الصامت لهذه البنية. للحصول على مرجع كامل عن ملف الإعداد، يُرجى الاطّلاع على مرجع ملف إعدادات 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>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=Apigee1234
# 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>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=Apigee1234
# 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>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=Apigee1234