ترقية نظام التشغيل على مستوى كل عُقدة في Apigee Edge for Private Cloud

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

يوضّح هذا المستند طريقة بديلة لترقية نظام التشغيل (OS) للخوادم في مجموعة Apigee Edge للسحابة الخاصة. بدلاً من إعداد مركز بيانات جديد تمامًا وموازٍ، يتيح لك هذا الأسلوب الذي يعتمد على العُقد ترقية نظام التشغيل في مكانه، أي جهاز أو عقدة واحدة في كل مرة.

التوافق

قبل بدء ترقية نظام التشغيل على مستوى كل عقدة، تأكَّد من أنّ إصدار Apigee Edge for Private Cloud الحالي متوافق مع إصدار نظام التشغيل المستهدَف. للتأكّد من ذلك، يُرجى الرجوع إلى مصفوفة توافق نظام التشغيل.

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

قبل البدء في الترقية على مستوى كل عقدة، تأكَّد من إكمال المهام التالية:

إنشاء نسخة احتياطية من جميع العُقد

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

التأكّد من أنّ Edge قيد التشغيل

تأكَّد من أنّ Edge يعمل أثناء عملية التحديث باستخدام الأمر:

/opt/apigee/apigee-service/bin/apigee-all status

ترتيب استبدال العُقد

ننصحك بترقية العُقد بالترتيب المذكور أدناه، استنادًا إلى نوع المكوّن:

سيناريوهات إضافية

عند إجراء ترقية لنظام التشغيل على مستوى كل عقدة، إذا كانت أيّ من الإعدادات التالية متوفّرة في الإعداد الحالي، يُرجى مراعاة هذه الخطوات الإضافية:

  • apigee-mtls: في حال تفعيل apigee-mtls، لن يكون ترقية نظام التشغيل على مستوى كل عقدة (التحديث المتتابع) متاحًا في هذا الإعداد. لترقية الإصدار، يُرجى اتّباع دليل ترقية apigee-mtls.

Cassandra

عند استبدال Cassandra، ننصحك باستبدال العُقد غير الأساسية أولاً، ثم العُقد الأساسية.

في ما يلي الحالات الخاصة التي يجب أخذها في الاعتبار عند استخدام Cassandra:

  • Cassandra Native-mTLS: في حال تفعيل native-mTLS وفرضه، أزِل الفرض على العُقد المفعَّل عليها mTLS من خلال ضبط conf_cassandra_client_encryption_optional=true. لمزيد من المعلومات، يُرجى الاطّلاع على مستندات native-mTLS.
  • تفعيل التشفير بين عقد Cassandra: يُرجى الرجوع إلى تفعيل التشفير بين عقد Cassandra للتأكّد من تضمين شهادات عقد Cassandra الحالية في ملف truststore الخاص بالعقدة التي تم استبدالها حديثًا والعكس.

خطوات استبدال عقدة Cassandra:

  1. احتفِظ بنسخة احتياطية من العُقدة من خلال أخذ لقطات من الجهاز الافتراضي (إذا أمكن ذلك)، واحتفِظ بنسخة احتياطية من Apigee لـ Cassandra على جميع العُقد باستخدام الأمر التالي: 
    apigee-service apigee-cassandra backup
  2. اكتساب عقدة جديدة باستخدام نظام التشغيل الذي تمت ترقيته
  3. طبِّق المتطلبات الأساسية الخاصة بنظام التشغيل.
  4. نزِّل ملف Edge وشغِّله لتثبيت الأداة المساعدة apigee-service. يجب تشغيل run bootstrap للحصول على apigee-service وتثبيت apigee-setup.
  5. أدرِج عُقد البداية: 
    apigee-service apigee-cassandra configure -search conf_cassandra_seeds
  6. عدِّل ملف الإعداد عن طريق تغيير عنوان IP الحالي لعُقدة Cassandra واستبداله بعنوان IP جديد للعُقدة.

    CASS_HOSTS الحالية

    CASS_HOSTS="$IP1 $IP2 $IP3"

    تم تعديل CASS_HOSTS حديثًا

    CASS_HOSTS="$IP1 $IP4 $IP3"
  7. أعِد ضبط العُقد الحالية على المجموعة باستخدام عنوان IP الجديد والمعدَّل لعقدة Cassandra (باستثناء العقدة التي سيتم استبدالها). يُرجى استخدام مرجع ملف الإعداد. 
    /opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile
  8. أوقِف Cassandra وألغِ تسجيلها على العُقدة القديمة:
    1. أوقِف Cassandra على العقدة التي سيتم استبدالها: 
      apigee-service apigee-cassandra stop
    2. أدرِج رقم التعريف الفريد العالمي (UUID) لعقدة Cassandra التي سيتم إيقافها نهائيًا (في حال توفّر مراكز بيانات متعدّدة، يجب مراعاة ذلك): 
      apigee-adminapi.sh servers list -r dc-1 -p central -t application-datastore --admin AdminEmailID --pwd 'AdminPassword' --host localhost
    3. ألغِ تسجيل أنواع مستودع البيانات المرتبطة بمعرّف UUID الحالي في Cassandra: 
      curl -u AdminEmailID:'AdminPassword' -X POST http://MS_IP:8080/v1/servers -d "type=cache-datastore&type=user-settings-datastore&type=scheduler-datastore&type=audit-datastore&type=apimodel-datastore&type=application-datastore&type=edgenotification-datastore&type=identityzone-datastore&type=auth-datastore&region=dc-1&pod=central&uuid=old_cassandra_uuid&action=remove"
    4. احذف الخادم. 
      curl -u AdminEmailID:AdminPassword -X DELETE http://MS_IP:8080/v1/servers/old_cassandra_uuid
  9. جهِّز عقدة جديدة لمضيف apigee-cassandra. أضِف السطر التالي إلى ملف cassandra.properties ضمن /opt/apigee/customer/application/cassandra.properties (أنشئ الملف إذا لم يكن متوفّرًا) على عقدة Cassandra الجديدة: 
    conf_jvm_options_custom_settings=-Dcassandra.replace_address=IPOfOldCassandraNode -Dcassandra.allow_unsafe_replace=true
  10. تأكَّد من ضبط المالك والمجموعة على apigee:apigee في الملف cassandra.properties. إذا لزم الأمر، استخدِم الأمر التالي لتعديل المالك والمجموعة: 
    chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
  11. ثبِّت Cassandra وشغِّل عملية الإعداد على العُقدة التي تمت إضافتها حديثًا: 
    apigee-service apigee-cassandra install
     
    apigee-service apigee-cassandra setup -f updatedConfigFile
  12. بعد إعداد العُقدة الجديدة، أزِل الإعداد الإضافي الذي تمت إضافته إلى /opt/apigee/customer/application/cassandra.properties وأعِد تشغيل apigee-cassandra: 
    conf_jvm_options_custom_settings=-Dcassandra.replace_address=IPOfOldCassandraNode -Dcassandra.allow_unsafe_replace=true
     
    apigee-service apigee-cassandra restart
  13. تحقَّق من حالة العُقدة الجديدة المستبدَلة: 
    apigee-service apigee-cassandra status
     
    /opt/apigee/apigee-cassandra/bin/nodetool status
  14. أعِد إنشاء العقدة الجديدة التي تمت إضافتها إلى المجموعة: 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild -dc dc-1
  15. أعِد إعداد العُقد الحالية لخوادم Router وMessage-Processor وQpid وPostgres وManagement على التوالي من خلال تعديل عنوان IP لعقدة Cassandra الجديدة في ملف الإعداد: 
    /opt/apigee/apigee-setup/bin/setup.sh -p r|mp|qs|ps|ms|mo -f updatedConfigFile
  16. إزالة/إلغاء تثبيت Cassandra من العُقدة القديمة: 
    apigee-service apigee-cassandra uninstall
  17. كرِّر هذه الخطوات لعُقد Cassandra الأخرى في المجموعة.

Zookeeper

راجِع الخطوات أدناه لاستبدال عُقد Zookeeper. ننصحك باستبدال عُقد التابع أولاً ثم عُقد القائد ثانيًا لضمان الحفاظ على النصاب القانوني للمجموعة.

  1. احتفِظ بنسخة احتياطية من العُقدة من خلال أخذ لقطات من الجهاز الافتراضي (إذا أمكن)، واحتفِظ بنسخة احتياطية من Apigee لـ Zookeeper على جميع العُقد.
  2. أوقِف Zookeeper وألغِ تثبيته على العُقدة الحالية: 
    apigee-service apigee-zookeeper stop
     
    apigee-service apigee-zookeeper uninstall
  3. اكتساب عقدة جديدة باستخدام نظام التشغيل الذي تمت ترقيته
  4. طبِّق المتطلبات الأساسية الخاصة بنظام التشغيل.
  5. نزِّل برنامج bootstrap لإصدار Apigee المستخدَم، ثم شغِّل برنامج bootstrap للحصول على apigee-service وتثبيت apigee-setup.
  6. عدِّل ملف الإعداد عن طريق إزالة عناوين IP القديمة/المحذوفة للعُقد واستبدالها بعناوين IP جديدة للعُقد في Zookeeper. لمزيد من التفاصيل، يُرجى الاطّلاع على مرجع ملف الإعداد:

    إعدادات ZK الحالية

    ZK_HOSTS="$IP1 $IP2 $IP3"
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"

    تم تعديل إعدادات ZK

    ZK_HOSTS="$IP1 $IP4 $IP3"
ZK_CLIENT_HOSTS="$IP1 $IP4 $IP3"
  7. ثبِّت Zookeeper وأعدّها وابدأها على العقدة الجديدة باستخدام ملف الإعداد المعدَّل: 
    /opt/apigee/apigee-setup/bin/setup.sh -p zk -f updatedConfigFile
  8. أجرِ تغييرات على عقدة Zookeeper الحالية باستخدام updatedConfigFile: 
    /opt/apigee/apigee-setup/bin/setup.sh -p zk -f updatedConfigFile
  9. أعِد إعداد العُقد الحالية لخوادم Router وMessage-Processor وQpid وPostgres وManagement على التوالي من خلال تعديل عنوان IP لعقدة Zookeeper الجديدة في ملف الإعداد: 
    /opt/apigee/apigee-setup/bin/setup.sh -p r|mp|qs|ps|ms|mo -f updatedConfigFile
  10. كرِّر ذلك مع جميع عُقد Zookeeper.

Postgres

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

  • استبدِل أيًا من العُقد الاحتياطية الحالية بنظام التشغيل المستهدَف.
  • ترقية عقدة الاستعداد الجديدة إلى عقدة رئيسية
  • إيقاف الخادم الرئيسي القديم
  • واصِل استبدال العُقد الاحتياطية الإضافية.

قبل بدء عملية الاستبدال، يُنصح بإيقاف edge-qpid-server لتقليل أي فقدان محتمل لرسائل الإحصاءات.

apigee-service edge-qpid-server stop

وضع الاستعداد

  1. احصل على المعرّف الفريد العالمي (UUID) لعُقد edge-postgres-server: 
    curl http://pg_standby_ip:8084/v1/servers/self
  2. إيقاف Postgres: 
    apigee-service edge-postgres-server stop
     
    apigee-service apigee-postgresql stop
  3. أزِل خادم Postgres الاحتياطي الحالي من مجموعة "إحصاءات Google" باتّباع هذه الخطوات.
  4. ألغِ تثبيت apigee-postgres وpostgres-server: 
    apigee-service edge-postgres-server uninstall
     
    apigee-service apigee-postgresql uninstall
  5. اكتساب عقدة جديدة باستخدام نظام التشغيل الذي تمت ترقيته
  6. طبِّق المتطلبات الأساسية الخاصة بنظام التشغيل.
  7. نزِّل برنامج bootstrap لإصدار Apigee المستخدَم، ثم شغِّل برنامج bootstrap للحصول على apigee-service وتثبيت apigee-setup.
  8. اضبط عملية النسخ المتماثل الرئيسية الاحتياطية على الجهاز الرئيسي الحالي من خلال تعديل ملف الإعداد باستخدام EXISTING_PG_MASTER_IP وNEW_PG_STANDBY_IP. لمزيد من التفاصيل، يُرجى الاطّلاع على مرجع ملف الإعداد: 
    PG_MASTER=EXISTING_PG_MASTER_IP
     
    PG_STANDBY=NEW_PG_STANDBY_IP
     
    apigee-service apigee-postgresql setup-replication-on-master -f updatedConfigFile
  9. ثبِّت Postgres وأعدّها وابدأ تشغيلها باستخدام إعدادات الخادم الرئيسي والخادم الاحتياطي على عقدة الخادم الاحتياطي الجديدة: 
    PG_MASTER=EXISTING_PG_MASTER_IP
     
    PG_STANDBY=NEW_PG_STANDBY_IP
     
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f updatedConfigFile
  10. التحقّق من إعداد وضع الاستعداد: 
    apigee-service apigee-postgresql postgres-check-standby

رئيسي

  1. احصل على المعرّف الفريد العالمي (UUID) لعقدة Postgres الرئيسية الحالية: 
    curl http://pg_ip:8084/v1/servers/self
  2. ترقية عقدة الاستعداد لنظام التشغيل الجديد إلى عقدة رئيسية
  3. أوقِف Postgres على الخادم الرئيسي الحالي: 
    apigee-service apigee-postgresql stop
     
    apigee-service edge-postgres-server stop
  4. ترقية عقدة الاستعداد الجديدة إلى عقدة رئيسية: 
    apigee-service apigee-postgresql promote-standby-to-master EXISTING_PG_MASTER_IP
  5. أزِل عقدة رئيسية قديمة من مجموعات المستهلكين والإحصاءات.
  6. أضِف العقدة الرئيسية الجديدة إلى مجموعات المستهلكين والإحصاءات.
  7. في حال استخدام تحقيق الربح، عدِّل عقدة Postgres الرئيسية الجديدة واتّبِع الخطوات التالية.
  8. بعد استبدال العقدة الرئيسية، يمكن بدء edge-qpid-server باستخدام إعدادات محدَّثة للعقدة الرئيسية: 
    apigee-service edge-qpid-server start
  9. إذا كنت تستخدم ميزة تحقيق الربح، أعِد تشغيل خادم الإدارة ومعالج الرسائل أيضًا: 
    apigee-service edge-management-server restart
  10. أوقِف وألغِ تثبيت apigee-postgres وpostgres-server على الخادم الرئيسي القديم: 
    apigee-service edge-postgres-server uninstall
     
    apigee-service apigee-postgresql uninstall

إضافة جهاز احتياطي جديد

  1. اكتساب عقدة جديدة باستخدام نظام التشغيل الذي تمت ترقيته
  2. طبِّق المتطلبات الأساسية الخاصة بنظام التشغيل.
  3. نزِّل برنامج bootstrap لإصدار Apigee المستخدَم، ثم شغِّل برنامج bootstrap للحصول على apigee-service وتثبيت apigee-setup.
  4. إعداد عملية النسخ المتماثل الرئيسية الاحتياطية باستخدام عنوان IP الرئيسي الجديد وعنوان IP لعقدة الاستعداد الجديدة في ملف إعداد العقدة الرئيسية الجديدة وعقدة الاستعداد الجديدة لمزيد من التفاصيل، يُرجى الاطّلاع على مرجع ملف الإعداد: 
    apigee-service apigee-postgresql setup-replication-on-master -f updatedConfigFile
  5. ثبِّت وأعِد الإعداد على العُقدة الاحتياطية الجديدة: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f updatedConfigFile
  6. أضِف الجهاز الاحتياطي الجديد إلى مجموعات الإحصاءات باتّباع خطوات إعداد الجهاز الرئيسي والاحتياطي.

LDAP

سيؤدي استبدال عقدة LDAP إلى إيقاف "خادم الإدارة"، وسيتم اعتبار أي من واجهات برمجة التطبيقات الخاصة بالإدارة غير متاحة طوال مدة استبدال هذه العقدة.

  1. أوقِف "خادم الإدارة" على جميع العُقد: 
    apigee-service edge-management-server stop
  2. إيقاف عقدة LDAP الحالية:
    1. أخذ نسخة احتياطية أو لقطة على مستوى الجهاز الافتراضي لعقدة LDAP
    2. قبل إيقاف LDAP، احرص على تسجيل عدد بيانات LDAP التي يمكن التحقّق منها لاحقًا، على سبيل المثال: 
      ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" -D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w Secret123 | wc -l
    3. لإعداد وضع "نشط-غير نشط":
      1. حوِّل العقدة السلبية الحالية إلى عقدة نشطة من خلال إضافة ملف mark_writable.ldif إلى العقدة السلبية يتضمّن المحتوى التالي: 
        dn: olcDatabase={2}bdb,cn=config
changetype: modify
replace: olcReadOnly
olcReadOnly: FALSE
      2. نفِّذ الأمر التالي على العقدة غير النشطة لجعلها نشطة: 
        ldapmodify -a -x -w "$APIGEE_LDAPPW" -D "$CONFIG_BIND_DN" -H "ldap://:10389" -f mark_writable.ldif
      3. تابِع الخطوة (د) لإيقاف العُقد في وضع "نشط-نشط".
    4. في عملية إعداد Active-Active LDAP، أوقِف عملية النسخ المتماثل بين عقدتَي LDAP وعدِّل الإعدادات. اتّباع الخطوات الواردة في مستند إيقاف LDAP نهائيًا
    5. أوقِف بيانات LDAP واحتفِظ بنسخة احتياطية منها، ثم ألغِ تثبيت عقدة LDAP الحالية (تخطَّ هذه الخطوة إذا كنت تستخدم إعدادات نشطة-نشطة وتم تنفيذها من قبل): 
      apigee-service apigee-openldap stop
       
      apigee-service apigee-openldap backup
       
      apigee-service apigee-openldap uninstall
  3. اكتساب عقدة جديدة باستخدام نظام التشغيل الذي تمت ترقيته
  4. طبِّق المتطلبات الأساسية الخاصة بنظام التشغيل.
  5. نزِّل برنامج bootstrap لإصدار Apigee المستخدَم، ثم شغِّل برنامج bootstrap للحصول على apigee-service وتثبيت apigee-setup.
  6. إعداد عقدة LDAP جديدة:
    1. عدِّل configFile للعقدة الجديدة استنادًا إلى الإعداد، ويمكنك الرجوع إلى مرجع ملف إعداد Edge، استنادًا إلى الإعداد النشط فقط أو الإعداد النشط-النشط:
      • LDAP_TYPE
      • LDAP_PEER
      • LDAP_SID
      • USE_LDAP_REMOTE_HOST=y/n
    2. إعداد LDAP وبدء تشغيله على عقدة جديدة باستخدام updatedConfigFile: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ld -f updatedConfigFile
    3. احتفِظ بنسخة احتياطية من بيانات LDAP من العُقد القديمة (إذا كان يمكن تخطّي عملية الإعداد النشط/النشط):
      1. خذ نسخة احتياطية تجريبية على العقدة الجديدة، وذلك لإنشاء مجلد/مسار تلقائي للنسخة الاحتياطية: 
        apigee-service apigee-openldap backup
      2. انقل بياناتك المحفوظة احتياطيًا من العقدة القديمة إلى مجلد النسخة الاحتياطية الذي تم إنشاؤه.
      3. أوقِف apigee-openldap قبل استعادة البيانات: 
        apigee-service apigee-openldap stop
      4. استعادة النسخة الاحتياطية التي تم إنشاؤها من العُقدة القديمة: 
        apigee-service apigee-openldap restore backup_file

        على سبيل المثال:

        apigee-service apigee-openldap restore 2026.02.09,10.28.20
  7. كرِّر الخطوات السابقة لعُقدة LDAP الأخرى (في حال التفعيل المزدوج).
  8. أعِد إعداد خادم الإدارة وابدأ استخدامه مع إعدادات مضيف LDAP المعدَّلة: 
    /opt/apigee/apigee-setup/bin/setup.sh -p mt -f updatedConfigFile
  9. إعادة ضبط خدمة "الدخول المُوحَّد" (SSO) وبدء استخدامها (إذا كان ذلك منطبقًا): 
    apigee-service apigee-sso setup -f updatedConfigFile
     
    apigee-service apigee-sso restart
  10. (اختياري) اضبط دليل Active Directory الثاني على وضع القراءة فقط باتّباع خطوات المستندات.

Qpid

لاستبدال عقدة Qpid حالية بعقدة نظام تشغيل تمت ترقيتها، علينا التأكّد من تنفيذ الخطوات التالية:

  1. التوقّف عن تلقّي أي رسائل في قائمة انتظار العُقد الحالية من معالِجات الرسائل
  2. إفراغ الرسائل الحالية في قائمة الانتظار
  3. أوقِف العُقدة الحالية وأزِلها.

إيقاف العُقد الحالية للتأكّد من عدم فقدان أي رسائل، يتم اتّخاذ إجراءات إضافية على النحو التالي:

  1. إيقاف وسيط Qpid: 
    apigee-service apigee-qpidd stop
  2. حظر الزيارات الواردة على المنفذ 5672 من جميع "معالجات الرسائل": 
    iptables -A INPUT -p tcp --dport 5672 -s MP_IP -j DROP
  3. أعِد تشغيل وسيط Qpid لتفريغ الرسائل الحالية: 
    apigee-service apigee-qpidd start
  4. تأكَّد من إرسال جميع الرسائل في قائمة الانتظار إلى المستهلك قبل بدء إيقاف الخدمة.
  5. احصل على المعرّف الفريد العالمي (UUID) لعقدة edge-qpid-server: 
    curl http://qpid_node_ip:8083/v1/servers/self
  6. أكمِل خطوات إيقاف Qpid نهائيًا أو إزالته من "إحصاءات Google" لكل من apigee-qpidd وedge-qpid-server.
  7. أوقِف وألغِ تثبيت كل من apigee-qpidd وedge-qpid-server: 
    apigee-service apigee-qpidd stop
     
    apigee-service edge-qpid-server stop
     
    apigee-service apigee-qpidd uninstall
     
    apigee-service edge-qpid-server uninstall

إضافة عقدة جديدة:

  1. اكتساب عقدة جديدة باستخدام نظام التشغيل الذي تمت ترقيته
  2. طبِّق المتطلبات الأساسية الخاصة بنظام التشغيل.
  3. نزِّل برنامج bootstrap لإصدار Apigee المستخدَم، ثم شغِّل برنامج bootstrap للحصول على apigee-service وتثبيت apigee-setup.
  4. يمكنك إعداد خدمات Qpid وتشغيلها على العقدة الجديدة وإضافتها إلى مجموعات المستهلكين، باتّباع هذه الخطوات. اتّبِع الخطوات نفسها لإضافة مجموعات أخرى، مثل مجموعات تحقيق الربح.
  5. في حال تفعيل خدمة تحقيق الربح، أعِد تشغيل "خادم الإدارة" و"معالج الرسائل" باتّباع الخطوات التالية: 
    apigee-service edge-management-server restart
     
    apigee-service edge-message-processor restart
  6. كرِّر هذه الخطوة على جميع عُقد Qpid.

معالج الرسائل

  1. احصل على المعرّف الفريد العالمي (UUID) لعقدة edge-message-processor: 
    curl http://mp_ip:8082/v1/servers/self
  2. إيقاف عقدة "معالج الرسائل" وإلغاء تثبيتها
  3. في حال تفعيل خدمة تحقيق الربح، عليك إلغاء تثبيت edge-mint-message-processor.
  4. إلغاء تثبيت "معالج الرسائل": 
    apigee-service edge-message-processor uninstall
  5. اكتساب عقدة جديدة باستخدام نظام التشغيل الذي تمت ترقيته
  6. طبِّق المتطلبات الأساسية الخاصة بنظام التشغيل.
  7. نزِّل برنامج bootstrap لإصدار Apigee المستخدَم، ثم شغِّل برنامج bootstrap للحصول على apigee-service وتثبيت apigee-setup.
  8. أضِف "معالج الرسائل" وأعدّه وابدأ تشغيله في المجموعة، باتّباع الخطوات.
  9. في حال تفعيل ميزة تحقيق الربح، عليك إعداد خدمة تحقيق الربح مع "معالج الرسائل". لمزيد من المعلومات، يُرجى الرجوع إلى المستندات التالية.

جهاز التوجيه

  1. احصل على المعرّف الفريد العالمي (UUID) لعقدة edge-router: 
    curl http://router_ip:8081/v1/servers/self
  2. إيقاف إمكانية الوصول والتحقّق من إمكانية الوصول: 
    iptables -A INPUT -i eth0 -p tcp --dport 15999 -j REJECT
     
    curl -vvv -X GET http://router_ip:15999/v1/servers/self/reachable
  3. إيقاف وإلغاء تثبيت عقدة جهاز التوجيه
  4. إلغاء تثبيت جهاز التوجيه: 
    apigee-service edge-router uninstall
  5. اكتساب عقدة جديدة باستخدام نظام التشغيل الذي تمت ترقيته
  6. طبِّق المتطلبات الأساسية الخاصة بنظام التشغيل.
  7. نزِّل برنامج bootstrap لإصدار Apigee المستخدَم، ثم شغِّل برنامج bootstrap للحصول على apigee-service وتثبيت apigee-setup.
  8. إضافة جهاز توجيه وإعداده وبدء تشغيله إلى المجموعة

خادم الإدارة

خادم إدارة واحد فقط

  1. اكتساب عقدة جديدة باستخدام نظام التشغيل الذي تمت ترقيته
  2. طبِّق المتطلبات الأساسية الخاصة بنظام التشغيل.
  3. نزِّل برنامج bootstrap لإصدار Apigee المستخدَم، ثم شغِّل برنامج bootstrap للحصول على apigee-service وتثبيت apigee-setup.
  4. أضِف خادم الإدارة باستخدام عنوان IP المعدَّل وملف الإعداد الذي يمكن الرجوع إليه من هنا، ونفِّذ أمر الإعداد: 
    /opt/apigee/apigee-setup/bin/setup.sh -p mt -f updatedConfigFile
  5. أعِد إعداد واجهة المستخدم وأعِد تشغيلها باستخدام إعدادات IP الجديدة للإدارة. 
    /opt/apigee/apigee-setup/bin/setup.sh -p ui -f updatedConfigFile
  6. أعِد إعداد الدخول المُوحَّد (SSO) باستخدام إعدادات جديدة لعنوان IP الخاص بالإدارة (إذا كان ذلك منطبقًا): 
    /opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile
  7. إعادة إعداد واجهة المستخدم الجديدة (UE) باستخدام إعدادات جديدة لعنوان IP الخاص بالإدارة (إذا كان ذلك منطبقًا): 
    /opt/apigee/apigee-setup/bin/setup.sh -p ue -f updatedConfigFile
  8. في حال تفعيل ميزة تحقيق الربح:
    1. أعِد إعداد خدمة تحقيق الربح باستخدام إعدادات جديدة لعنوان IP الإداري (إذا كان ذلك منطبقًا)، مع الرجوع إلى مستندات إعدادات تحقيق الربح. 
      /opt/apigee/apigee-setup/bin/setup.sh -p mo -f updatedConfigFile
    2. أعِد تشغيل خادم الإدارة: 
      apigee-service edge-management-server restart
  9. أوقِف خادم الإدارة على العقدة الحالية أو القديمة، باتّباع الخطوات.
  10. في حال تفعيل تحقيق الربح، أزِل المعرّف الفريد العالمي لخادم الإدارة من مجموعات الإحصاءات. مثال: 
    curl -v -u AdminEmail:AdminPassword -X DELETE "http://localhost:8080/v1/analytics/groups/ax/mint_axgroup/servers?uuid=MS_UUID&type=consumer-server"
  11. إزالة "خادم إدارة تحقيق الربح": 
    apigee-service edge-mint-management-server uninstall

خوادم إدارة متعددة

  1. أوقِف أحد خوادم الإدارة باستخدام الخادم الآخر على العُقدة الحالية، باتّباع الخطوات.
  2. إيقاف خادم الإدارة وإلغاء تثبيته: 
    apigee-service edge-management-server stop
     
    apigee-service edge-management-server uninstall
  3. اكتساب عقدة جديدة باستخدام نظام التشغيل الذي تمت ترقيته
  4. طبِّق المتطلبات الأساسية الخاصة بنظام التشغيل.
  5. نزِّل برنامج bootstrap لإصدار Apigee المستخدَم، ثم شغِّل برنامج bootstrap للحصول على apigee-service وتثبيت apigee-setup.
  6. أضِف خادم الإدارة باستخدام عنوان IP المعدَّل وملف الإعداد الذي يمكن الرجوع إليه من هنا، ونفِّذ أمر الإعداد: 
    /opt/apigee/apigee-setup/bin/setup.sh -p mt -f updatedConfigFile
  7. إعادة إعداد واجهة المستخدم وإعادة تشغيلها باستخدام إعدادات عنوان IP المُعدَّلة للإدارة: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ui -f updatedConfigFile
  8. (في حال تفعيل الدخول المُوحَّد فقط) إعادة إعداد الدخول المُوحَّد وإعادة تشغيله باستخدام إعدادات عنوان IP المُعدَّلة للإدارة: 
    /opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile
  9. (فقط في حال تفعيل واجهة المستخدم الجديدة) إعادة إعداد واجهة المستخدم الجديدة وإعادة تشغيلها باستخدام إعدادات IP الإدارية المعدَّلة: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ue -f updatedConfigFile
  10. كرِّر هذه الخطوات لخادم الإدارة الآخر.

واجهة المستخدم/تجربة المستخدم

  1. أخذ نسخة احتياطية أو لقطة جهاز افتراضي لعقدة واجهة المستخدم
  2. إيقاف واجهة المستخدم وإلغاء تثبيتها: 
    apigee-service edge-ui stop
     
    apigee-service edge-ui uninstall
  3. (في حال استخدام واجهة المستخدم الجديدة فقط) أوقِف واجهة المستخدم الجديدة وألغِ تثبيتها: 
    apigee-service edge-management-ui stop
     
    apigee-service edge-management-ui uninstall
  4. اكتساب عقدة جديدة باستخدام نظام التشغيل الذي تمت ترقيته
  5. طبِّق المتطلبات الأساسية الخاصة بنظام التشغيل.
  6. نزِّل برنامج bootstrap لإصدار Apigee المستخدَم، ثم شغِّل برنامج bootstrap للحصول على apigee-service وتثبيت apigee-setup.
  7. اضبط edge-ui وشغِّله على العُقدة الجديدة، مع إعدادات IP المعدَّلة: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ui -f updatedConfigFile
  8. (في حال تفعيل الدخول المُوحَّد فقط) أعِد إعداد الدخول المُوحَّد وتشغيله باستخدام إعدادات عنوان IP الجديد لعقدة واجهة المستخدم حسب الاقتضاء: 
    /opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile
  9. (فقط في حال تفعيل واجهة المستخدم الجديدة) إعداد واجهة المستخدم الجديدة وتشغيلها على العقدة الجديدة، مع إعدادات IP محدَّثة: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ue -f updatedConfigFile
     
    apigee-service edge-management-ui configure-sso -f updatedConfigFile
     
    apigee-service edge-ui configure-sso -f updatedConfigFile

الدخول الموحد

  1. أخذ نسخة احتياطية أو لقطة جهاز افتراضي لعقدة واجهة المستخدم
  2. إيقاف خدمة الدخول المُوحَّد (SSO) وإلغاء تثبيتها: 
    apigee-service apigee-sso stop
     
    apigee-service apigee-sso uninstall
  3. اكتساب عقدة جديدة باستخدام نظام التشغيل الذي تمت ترقيته
  4. طبِّق المتطلبات الأساسية الخاصة بنظام التشغيل.
  5. نزِّل برنامج bootstrap لإصدار Apigee المستخدَم، ثم شغِّل برنامج bootstrap للحصول على apigee-service وتثبيت apigee-setup.
  6. أضِف الإعدادات والمفاتيح الخاصة بالدخول المُوحَّد باتّباع الدليل، مع مراعاة عنوان IP الجديد للعقدة.
  7. إعداد خدمة الدخول المُوحَّد وبدء استخدامها: 
    /opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile
  8. تعديل الإعدادات باستخدام عناوين IP الجديدة لعقدة الدخول المُوحَّد وإعادة ضبط الدخول المُوحَّد لواجهة المستخدم: 
    apigee-service edge-ui configure-sso -f updatedConfigFile
  9. (في حال استخدام واجهة المستخدم الجديدة) شغِّل configure-sso على عقدة واجهة المستخدم الجديدة، مع الرجوع إلى المستندات: 
    apigee-service edge-management-ui configure-sso -f updatedConfigFile
     
    apigee-service edge-ui configure-sso -f updatedConfigFile