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

Edge for Private Cloud - الإصدار 4.16.05

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

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

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

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

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

> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f /tmp/myConfig

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

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

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

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

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

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

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

يمكنك تفعيل مصادقة Cassandra كوقت تثبيت، وذلك باستخدام سمات ضِمن ملف الإعداد الصامت. أو يمكنك تفعيله بعد التثبيت.

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

ربط جهاز التوجيه بمنفذ محمي

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

لتشغيل جهاز التوجيه كمستخدم مختلف:

  1. كجذر، أنشئ الملف /opt/apigee/etc/edge-router.d/RUN_USER.sh.
  2. أضِف الإدخال التالي إلى الملف:
    RUN_USER=root
    إذا كنت لا تريد تشغيل جهاز التوجيه كجذر، حدِّد مستخدمًا لديه إذن الوصول إلى المنفذ.
  3. احفظ الملف.
  4. إذا حددت مستخدمًا بخلاف الجذر، فغيِّر مالك الملف إلى هذا المستخدم:
    > chown USER:USER /opt/apigee/etc/edge-router.d/RUN_USER.sh
  5. أعِد تشغيل جهاز التوجيه:
    > /opt/apigee/apigee-service/bin/apigee-service Edge-router إعادة تشغيل

تحديد المكونات المراد تثبيتها

يدرج الجدول التالي الخيارات التي تمررها إلى الخيار -p في الأداة المساعدة لخدمة apigee لتحديد المكونات المطلوب تثبيتها على العقدة:

المكوّن

الوصف

c

يجب تثبيت تطبيق Cassandra فقط.

zk تثبيت ZooKeeper فقط.

ds

تثبيت ZooKeeper وCassandra.

ld

تثبيت OpenLDAP فقط

ms

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

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

r

عليك تثبيت جهاز توجيه Edge فقط.

mp

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

دورة في الدقيقة

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

ui

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

qs

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

ps

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

ساكس

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

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

شهريًا

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

sa

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

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

Aio

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

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

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

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

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

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

مثال على ملف الإعداد

في ما يلي مثال على ملف إعداد صامت كامل لعملية تثبيت Edge من 9 عُقد. عدِّل هذا الملف حسب الضرورة من أجل الضبط. استخدِم الخيار -f من أجل setup.sh لتضمين هذا الملف. وفي ما يلي أيضًا أمثلة على ملفات الإعداد لكل طوبولوجيا على شبكة Edge.

# IP address or DNS name of nodes.
IP1=192.168.1.1  # Management Server, OpenLDAP, UI, ZooKeeper, Cassandra
IP2=192.168.1.2  # ZooKeeper, Cassandra
IP3=192.168.1.3  # ZooKeeper, Cassandra
IP4=192.168.1.4  # Router, Message Processor
IP5=192.168.1.5  # Router, Message Processor
IP6=192.168.1.6  # Qpid
IP7=192.168.1.7  # Qpid
IP8=192.168.1.8  # Postgres
IP9=192.168.1.9  # Postgres

# Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost.
HOSTIP=$(hostname -i)

# Set Edge sys admin credentials.
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=yourPassword    # If omitted, you are prompted for it.

# Location of Edge license file.
LICENSE_FILE=/tmp/license.txt

# Management Server information.
MSIP=$IP1    # IP or DNS name of Management Server node. 
# Specify the port the Management Server listens on for API calls.
# APIGEE_PORT_HTTP_MS=8080    # Default is 8080.

#
# OpenLDAP information.
#
# Set to y if you are connecting to a remote LDAP server. 
# If n, Edge installs OpenLDAP when it installs the Management Server.
USE_LDAP_REMOTE_HOST=n 

# If connecting to remote OpenLDAP server, specify the IP/DNS name and port.
# LDAP_HOST=$IP1    # IP or DNS name of OpenLDAP node.
# LDAP_PORT=10389   # Default is 10389.
APIGEE_LDAPPW=yourLdapPassword

# Specify OpenLDAP without replication, 1, or with replication, 2.
LDAP_TYPE=1 

# Set only if using replication.
# LDAP_SID=1    # Unique ID for this LDAP server. 
# LDAP_PEER=    # IP or DNS name of LDAP peer.

BIND_ON_ALL_INTERFACES=y 

# The Message Processor and Router pod.
MP_POD=gateway 

# The name of the region, corresponding to the data center name.
REGION=dc-1 # Use dc-1 unless installing in a 
            # multi-data center environment. 

# ZooKeeper information.
# See table below if installing in a multi-data center environment.
ZK_HOSTS="$IP1 $IP2 $IP3"         # IP/DNS names of all ZooKeeper nodes. 
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"  # IP/DNS names of all ZooKeeper nodes.

# Cassandra information.
CASS_CLUSTERNAME=Apigee    # Default name is Apigee.

# IP addresses of the Cassandra hosts separated by spaces.
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1"

# Set to enable Cassandra authentication.
# CASS_AUTH=y    # The default value is n.
# Cassandra uname/pword required if you enabled Cassandra authentication.
# CASS_USERNAME=
# CASS_PASSWORD=

# Use to enable Postgres master-standby replication
# when you have multiple Postgres nodes. 
# PG_MASTER=IPorDNSofNewMaster
# PG_STANDBY=IPorDNSofOldMaster

# SMTP information.
SKIP_SMTP=n       # Skip now and configure later by specifying "y".
SMTPHOST=smtp.gmail.com
SMTPUSER=your@email.com
SMTPPASSWORD=yourEmailPassword
SMTPSSL=y
SMTPPORT=465      # If no SSL, use a different port, such as 25.

يحتوي الجدول التالي على معلومات إضافية حول هذه الخصائص:

الموقع الإلكتروني

ملاحظة

أسماء بروتوكول الإنترنت/نظام أسماء النطاقات

لا تستخدِم تعيين اسم المضيف إلى 127.0.0.1 أو عنوان IP 127.0.0.1 عند تحديد عنوان IP لعقدة.

ADMIN_EMAIL
APIGEE_ADMINPW

يجب ألا تقل كلمة مرور مشرف النظام عن 8 أحرف وأن تتضمن حرفًا كبيرًا أو حرفًا صغيرًا أو رقمًا واحدًا أو رمزًا خاصًا. إذا حذفت كلمة المرور، سيُطلب منك إدخال كلمة المرور.

LICENSE_FILE

موقع ملف الترخيص، الذي يجب أن يتمكن مستخدم "apigee" من الوصول إليه. على سبيل المثال، قم بتخزينه في الدليل /tmp وchmod 777 في الملف. يتم نسخ الملف إلى دليل تثبيت Edge.

USE_LDAP_REMOTE_HOST
LDAP_HOST
LDAP_port

في حال ضبط USE_LDAP_REMOTE_HOST على n، يثبّت Edge تلقائيًا بروتوكول OpenLDAP عندما يثبّت خادم الإدارة.

قم بتعيين USE_LDAP_REMOTE_HOST على y إذا كنت تتصل بخادم LDAP بعيد. عدم تثبيت OpenLDAP مع خادم الإدارة.

في حال الاتصال بخادم OpenLDAP عن بُعد، استخدِم LDAP_HOST
وLDAP_port لتحديد عنوان IP أو اسم نظام أسماء النطاقات ورقم منفذ المضيف.

LDAP_TYPE
LDAP_SID
LDAP_PEER

عيِّن LDAP_TYPE=1 لبرنامج OpenLDAP بدون نسخ متماثل. يتجاوب LDAP_TYPE=2 مع OpenLDAP مع النسخ المماثل.

إذا كانت بنية Edge تستخدم خادم OpenLDAP واحد، حدِّد 1. إذا كان تثبيت Edge يستخدم عدة عُقد OpenLDAP، كما هو الحال في عملية تثبيت إنتاج 13 عقدة، حدِّد 2.

إذا مكنت النسخ المماثل، اضبط الخصائص التالية:

  • LDAP_SID=1 - المعرّف الفريد لخادم LDAP هذا. تستخدم كل عقدة LDAP معرّفًا مختلفًا. على سبيل المثال، يمكنك الضبط على 2 لنظير LDAP.
  • LDAP_PEER=10.0.0.1 - اسم IP أو اسم DNS لنظير LDAP.

BIND_ON_ALL_INTERFACES

في حال ضبط السياسة على "y"، سيتم ربط جهاز التوجيه/معالج الرسائل (الاستماع) إلى جميع الواجهات (IPs). في حال ضبط هذه السياسة على "n"، سيتم ربط (الاستماع) في جهاز التوجيه/معالج الرسائل على واجهة معيّنة، أي عنوان IP الذي يعرضه الأمر "hostname -i").

MP_POD

حدد اسم مجموعة معالج الرسائل وجهاز التوجيه. ويكون اسمها هو "البوابة" تلقائيًا.

المنطقة

اسم المنطقة حسب الاصطلاح، تكون الأسماء عادةً بالصيغة dc-# حيث يتجاوب # مع قيمة عدد صحيح. على سبيل المثال، dc-1 وdc-2 وما إلى ذلك. يمكنك استخدام dc-1 ما لم يتم تثبيتها في بيئة مركز بيانات متعددة.

في عملية تثبيت متعدّدة لمركز بيانات، تكون القيمة هي dc-1 أو dc-2 وما إلى ذلك وفقًا لمركز البيانات الذي تثبِّته. ومع ذلك، لا يُسمح لك باستخدام الأسماء فقط بالصيغة dc-#، بل يمكنك استخدام أي اسم للمنطقة.

ZK_HOSTS

عناوين IP أو أسماء نظام أسماء النطاقات لعُقد ZooKeeper. ويجب إدراج عناوين IP أو أسماء نظام أسماء النطاقات بالترتيب نفسه في جميع عُقد ZooKeeper.

في بيئة مركز بيانات متعدد، أدرِج جميع عُقد ZooKeeper من كلا مركزي البيانات.

حدِّد المعدِّل ":observer" في عُقد ZooKeeper فقط عند إنشاء مراكز بيانات متعددة كما هو موضّح في عملية تثبيت 12 مضيفًا. في عملية تثبيت واحدة لمركز بيانات، احذف هذا التعديل. راجِع التثبيت المجمّع لـ 12 مضيفًا لمزيد من المعلومات.

ZK_CLIENT_HOSTS

عناوين IP أو أسماء نظام أسماء النطاقات لعُقد ZooKeeper التي يستخدمها مركز البيانات هذا. يجب إدراج عناوين IP أو أسماء نظام أسماء النطاقات بالترتيب نفسه في جميع عُقد ZooKeeper.

في عملية تثبيت واحدة لمركز بيانات، تكون هذه العُقد نفسها كما هو محدَّد في ZK_HOSTS.

في بيئة مركز بيانات متعدد، أدرِج عُقد ZooKeeper فقط في مركز البيانات هذا. راجِع التثبيت المجمّع لـ 12 مضيفًا لمزيد من المعلومات.

CASS_HOSTS

عناوين IP (وليس أسماء نظام أسماء النطاقات) لعقد Cassandra. سيتم استخدام أول عقدتَين كخوادم أساسية. يجب إدراج عناوين IP بالترتيب نفسه في جميع عُقد Cassandra.

يمكن أن تحتوي عُقد Cassandra على لاحقة ":dc,ra" اختيارية تحدّد مركز البيانات ورف عقدة Cassandra. حدِّد هذا المعدِّل فقط عند إنشاء عدة مراكز بيانات كما هو موضّح في عملية تثبيت 12 مضيفًا. في عملية تثبيت واحدة لمركز بيانات، احذف هذا التعديل.

على سبيل المثال، "192.168.124.201:1,1 = مركز البيانات 1 والرف/منطقة التوفّر 1، و"192.168.124.204:2,1 = مركز البيانات 2 ومنطقة الرفّ/منطقة التوفُّر 1.

في بيئة مراكز بيانات متعددة، للتغلب على مشاكل جدار الحماية، يجب ترتيب CASS_HOSTS بطريقة (كما هو موضّح في المثال أعلاه) بحيث يتم وضع عُقد مركز البيانات الحالي في البداية. راجِع التثبيت المجمّع لـ 12 مضيفًا لمزيد من المعلومات.

CASS_AUTH
CASS_USERNAME

CASS_PASSWORD

إذا فعّلت مصادقة Cassandra، CASS_AUTH=y، يمكنك ضبط اسم المستخدم وكلمة المرور لـ Cassandra باستخدام هذه السمات.

PG_MASTER

PG_STANDBY

يتم التعيين لتمكين النسخ المماثل في وضع الاستعداد الرئيسي لـ Postgres في النموذج:

PG_MASTER=IPorDNSofNewMaster

PG_STANDBY=IPorDNSofOldMaster

SKIP_SMTP
SMTPHOST
SMTPUSER
SMTPpassword
SMTPSSL
SMTPport

يمكنك تهيئة SMTP حتى يتمكن Edge من إرسال الرسائل الإلكترونية لكلمات المرور المفقودة والإشعارات الأخرى.

إذا لم تكن بيانات اعتماد مستخدم بروتوكول نقل البريد البسيط (SMTP) مطلوبة، احذف SMTPUSER وSMTPpassword.

ترتيب تثبيت المكوّنات

ويستند ترتيب تثبيت المكوِّن إلى المخطط المطلوب.

تفترض جميع أمثلة التثبيت الموضحة أدناه أنك بصدد التثبيت:

  • عند إيقاف مصادقة Cassandra (تلقائيًا). راجع تفعيل مصادقة Cassandra لمزيد من المعلومات.
  • مع إيقاف النسخ المماثل في وضع الاستعداد الرئيسي لـ Postgres (تلقائي). لمزيد من المعلومات، يمكنك الاطّلاع على إعداد النسخ المماثل لوضع الاستعداد لـ Postgres.
  • معالج الرسائل وجهاز التوجيه في نفس العقدة. في حال تثبيت معالجات الرسائل وأجهزة التوجيه على عُقد مختلفة، عليك تثبيت جميع معالِجات الرسائل أولاً، ثم جميع أجهزة التوجيه.

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

بشكل افتراضي، تكتب الأداة setup.sh معلومات السجل حول التثبيت إلى:

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

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

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

التثبيت الشامل

  1. ثبِّت جميع المكوّنات في عقدة واحدة باستخدام الأمر:
    > /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
  2. احذف أي ملفات في /opt/nginx/conf.d:
    > rm -f /opt/nginx/conf.d/*
  3. أعِد تشغيل جهاز توجيه Edge:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service Edge-router إعادة تشغيل
  4. اختبِر التثبيت على النحو الموضَّح في قسم اختبار التثبيت.
  5. امنح مؤسستك إمكانية الوصول إلى الخدمة كما هو موضّح في القسم منح إمكانيّة الوصول إلى مؤسسة.

في ما يلي ملف إعداد صامت لهذا المخطط:

# With SMTP
IP1=IPorDNSnameOfNode
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
LDAP_TYPE=1
APIGEE_LDAPPW=secret
BIND_ON_ALL_INTERFACES=y
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"
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd    
# omit for no password
SMTPSSL=n
SMTPPORT=25

تثبيت مستقل لمضيفين

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

  1. ثبِّت البوابة المستقلة والعقدة 1
    > /opt/apigee/apigee-setup/bin/setup.sh -p sa -f configFile
  2. في العُقدة 1:
    1. احذف أي ملفات في /opt/nginx/conf.d:
      > rm -f /opt/nginx/conf.d/*
    2. أعِد تشغيل جهاز توجيه Edge:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service Edge-router إعادة تشغيل
  3. ثبِّت "إحصاءات Google" في العقدة 2:
    > /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile
  4. اختبِر التثبيت على النحو الموضَّح في قسم اختبار التثبيت.
  5. امنح مؤسستك إمكانية الوصول إلى الخدمة كما هو موضّح في القسم منح إمكانيّة الوصول إلى مؤسسة.

في ما يلي ملف إعداد صامت لهذا المخطط:

# With SMTP
IP1=IPorDNSnameOfNode1
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
LDAP_TYPE=1
APIGEE_LDAPPW=secret
BIND_ON_ALL_INTERFACES=y
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"
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd    
# omit for no password
SMTPSSL=n
SMTPPORT=25

تثبيت مجمّع من 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:
    1. ثبِّت جهاز التوجيه ومعالج الرسائل:
      > /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
    2. احذف أي ملفات في /opt/nginx/conf.d:
      > rm -f /opt/nginx/conf.d/*
    3. أعِد تشغيل جهاز توجيه Edge:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service Edge-router إعادة تشغيل
  4. ثبِّت "إحصاءات Google" على النقطتين 4 و5:
    > /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile
  5. اختبِر التثبيت على النحو الموضَّح في قسم اختبار التثبيت.
  6. امنح مؤسستك إمكانية الوصول إلى الخدمة كما هو موضّح في القسم منح إمكانيّة الوصول إلى مؤسسة.

في ما يلي ملف إعداد صامت لهذا المخطط:

# With SMTP
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP4=IPorDNSnameOfNode4
IP5=IPorDNSnameOfNode5
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com 
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt 
MSIP=$IP1 
USE_LDAP_REMOTE_HOST=n 
LDAP_TYPE=1
APIGEE_LDAPPW=secret 
BIND_ON_ALL_INTERFACES=y
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" 
PG_MASTER=$IP4
PG_STANDBY=$IP5
SKIP_SMTP=n
SMTPHOST=smtp.example.com 
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd       
# omit for no password 
SMTPSSL=n
SMTPPORT=25

تثبيت مجمّع يضم 9 مضيفين

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

  1. ثبِّت عقدة Datastore Cluster Node في العُقد 1 و2 و3:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. ثبِّت Apigee Management Server في العقدة رقم 1:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. في العُقدتَين 4 و5:
    1. ثبِّت جهاز التوجيه ومعالج الرسائل:
      > /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
    2. احذف أي ملفات في /opt/nginx/conf.d:
      > rm -f /opt/nginx/conf.d/*
    3. أعِد تشغيل جهاز توجيه Edge:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service Edge-router إعادة تشغيل
  4. ثبِّت Apigee Analytics Qpid Server على النقطتين 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. اختبِر التثبيت على النحو الموضَّح في قسم اختبار التثبيت.
  7. امنح مؤسستك إمكانية الوصول إلى الخدمة كما هو موضّح في القسم منح إمكانيّة الوصول إلى مؤسسة.

في ما يلي ملف إعداد صامت لهذا المخطط:

# With SMTP
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com 
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt 
MSIP=$IP1 
USE_LDAP_REMOTE_HOST=n 
LDAP_TYPE=1
APIGEE_LDAPPW=secret 
BIND_ON_ALL_INTERFACES=y
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" 
SKIP_SMTP=n
PG_MASTER=$IP8
PG_STANDBY=$IP9
SMTPHOST=smtp.example.com 
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd       
# omit for no password
SMTPSSL=n
SMTPPORT=25

تثبيت مجمّع يضم 13 مضيفًا

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

  1. ثبِّت عقدة Datastore Cluster Node في العُقد 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. ثبِّت خادم Apigee Analytics Postgres في العقدة رقم 8 و9:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  5. في العُقدتين 10 و11:
    1. ثبِّت جهاز التوجيه ومعالج الرسائل:
      > /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
    2. احذف أي ملفات في /opt/nginx/conf.d:
      > rm -f /opt/nginx/conf.d/*
    3. أعِد تشغيل جهاز توجيه Edge:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service Edge-router إعادة تشغيل
  6. ثبِّت Apigee Analytics Qpid Server على العُقدتين 12 و13:
    > /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  7. اختبِر التثبيت على النحو الموضَّح في قسم اختبار التثبيت.
  8. امنح مؤسستك إمكانية الوصول إلى الخدمة كما هو موضّح في القسم منح إمكانيّة الوصول إلى مؤسسة.

في ما يلي ملف إعداد صامت لهذا المخطط:

# For all components except OpenLDAP
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP4=IPorDNSnameOfNode4
IP5=IPorDNSnameOfNode5
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com 
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt 
# First Management Server on IP6
MSIP=$IP6 
USE_LDAP_REMOTE_HOST=y
LDAP_HOST=$IP4
LDAP_PORT=10389
# Second Management Server on IP7
# MSIP=$IP7
# USE_LDAP_REMOTE_HOST=y
# LDAP_HOST=$IP5
# LDAP_PORT=10389
# Same password for both OpenLDAPs.
APIGEE_LDAPPW=secret 
BIND_ON_ALL_INTERFACES=y
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" 
PG_MASTER=$IP8
PG_STANDBY=$IP9
SKIP_SMTP=n
SMTPHOST=smtp.example.com 
SMTPUSER=smtp@example.com  
# omit for no username
SMTPPASSWORD=smtppwd       
# omit for no password
SMTPSSL=n
SMTPPORT=25
# For OpenLDAP on IP4 and IP5
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP4=IPorDNSnameOfNode4
IP5=IPorDNSnameOfNode5
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@apigee.com 
APIGEE_ADMINPW=Secret123
# First OpenLDAP Server on IP4
MSIP=$IP6 
USE_LDAP_REMOTE_HOST=n 
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP5
# Second OpenLDAP Server on IP5
# MSIP=$IP7 
# USE_LDAP_REMOTE_HOST=n 
# LDAP_TYPE=2
# LDAP_SID=2
# LDAP_PEER=$IP4
# Set same password for both OpenLDAPs.
APIGEE_LDAPPW=secret 

تثبيت مجمّع يضم 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، أدخِل أولاً عُقد "كاساندرا" في مركز البيانات هذا. بالنسبة لمركز البيانات 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.202:1,1 192.168.124.203:1,1 192.168.124.204:2,1 192.120.12)



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

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

  1. ثبِّت عقدة Datastore Cluster Node في العُقد 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:
    1. ثبِّت جهاز التوجيه ومعالج الرسائل:
      > /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
    2. احذف أي ملفات في /opt/nginx/conf.d:
      > rm -f /opt/nginx/conf.d/*
    3. أعِد تشغيل جهاز توجيه Edge:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service Edge-router إعادة تشغيل
  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. اختبِر التثبيت على النحو الموضَّح في قسم اختبار التثبيت.
  7. امنح مؤسستك إمكانية الوصول إلى الخدمة كما هو موضّح في القسم منح إمكانيّة الوصول إلى مؤسسة.

في ما يلي ملف إعداد صامت لهذا المخطط. لاحظ أن ملف الإعداد هذا:

  • تُستخدَم لإعداد بروتوكول OpenLDAP مع النسخ المتماثل عبر عُقدتي OpenLDAP.
  • تحدِّد هذه العلامة المعدِّل ":observer" في عقدة ZooKeeper واحدة. في عملية تثبيت واحدة لمركز بيانات، احذف هذا التعديل.
# Datacenter 1
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9
IP12=IPorDNSnameOfNode12 
HOSTIP=$(hostname -i)
MSIP=$IP1
ADMIN_EMAIL=opdk@apigee.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP7
APIGEE_LDAPPW=secret
BIND_ON_ALL_INTERFACES=y
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.
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1 $IP7:2,1 $IP8:2,1 $IP9:2,1"
PG_MASTER=$IP6
PG_STANDBY=$IP12
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com 
# omit for no username
SMTPPASSWORD=smtppwd   
# omit for no password
SMTPSSL=n
SMTPPORT=25
# Datacenter 2
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP6=IPorDNSnameOfNode6
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9 
IP12=IPorDNSnameOfNode12
HOSTIP=$(hostname -i)
MSIP=$IP7
ADMIN_EMAIL=opdk@apigee.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=2
LDAP_PEER=$IP1
APIGEE_LDAPPW=secret
BIND_ON_ALL_INTERFACES=y
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.
CASS_HOSTS="$IP7:2,1 $IP8:2,1 $IP9:2,1 $IP1:1,1 $IP2:1,1 $IP3:1,1"
PG_MASTER=$IP6
PG_STANDBY=$IP12
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com 
# omit for no username
SMTPPASSWORD=smtppwd   
# omit for no password
SMTPSSL=n
SMTPPORT=25