تحديث Apigee Edge 4.52.02 إلى 4.53.00

تتيح Apigee ترقية Edge for Private Cloud مباشرةً من الإصدار 4.52.02 إلى الإصدار 4.53.00. توضّح هذه الصفحة كيفية إجراء هذه الترقيات.

للحصول على نظرة عامة على مسارات الترقية المتوافقة، يُرجى الاطّلاع على مصفوفة توافق الترقية لإصدارات Edge for Private Cloud.

المستخدمون الذين يمكنهم إجراء التحديث

يجب أن يكون المستخدم الذي يُجري التحديث هو المستخدم نفسه الذي ثبَّت Edge في الأصل، أو مستخدم لديه إذن وصول الجذر.

بعد تثبيت حِزم RPM في Edge، يمكن لأي مستخدم ضبطها.

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

يجب تحديث جميع مكوّنات Edge. لا يتوافق Edge مع الإعداد الذي يحتوي على مكوّنات من إصدارات متعددة.

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

تأكَّد من استيفاء المتطلبات الأساسية التالية قبل ترقية Apigee Edge:

  • الاحتفاظ بنسخة احتياطية من جميع العقد
    قبل التحديث، ننصحك بالاحتفاظ بنسخة احتياطية كاملة من جميع العقد لأسباب تتعلق بالأمان. اتّبِع الإجراء الخاص بالإصدار الحالي من Edge لإجراء عملية الاحتفاظ بنسخة احتياطية.

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

  • التأكّد من تشغيل Edge
    تأكَّد من تشغيل Edge أثناء عملية التحديث باستخدام الأمر التالي: 
    /opt/apigee/apigee-service/bin/apigee-all status
  • التحقّق من المتطلبات الأساسية لـ Cassandra
    إذا سبق لك الترقية من إصدار قديم من Edge for Private Cloud إلى الإصدار 4.52.02 وكنت تخطّط الآن للترقية إلى الإصدار 4.53.00، تأكَّد من إكمال الخطوات المطلوبة بعد الترقية لـ Cassandra. تم توضيح هذه الخطوات في مستندات ترقية الإصدار 4.52.02 ضمن الخطوات التي يجب اتّباعها بعد الترقية. إذا لم تكن متأكدًا مما إذا تم إكمال هذه الخطوات أثناء عملية الترقية السابقة، يُرجى إكمالها مرة أخرى قبل مواصلة الترقية إلى الإصدار 4.53.00.
  • ضبط مفاتيح موفِّر الهوية وشهاداته في Edge for Private Cloud 4.53.00

    في الإصدار 4.53.00 من Edge for Private Cloud، يتم الآن ضبط مفاتيح موفِّر الهوية وشهاداته المستخدَمة في مكوّن apigee-sso من خلال ملف تخزين مفاتيح. عليك تصدير المفتاح والشهادة اللذَين استخدمتهما سابقًا إلى ملف تخزين مفاتيح. اتّبِع الخطوات الواردة في قسم خطوات تحديث Apigee SSO من الإصدارات القديمة للاطّلاع على الخطوات التفصيلية قبل تحديث مكوّن الدخول المُوحَّد.

  • متطلبات Python
    تأكَّد من تثبيت Python 3 على جميع العقد، بما في ذلك عقد Cassandra، قبل محاولة الترقية.

نشر إعدادات الموقع تلقائيًا

إذا كنت قد ضبطت أيّ مواقع من خلال تعديل ملفات .properties في /opt/apigee/customer/application، سيحتفظ هذا التعديل بهذه القيم.

ترقية مطلوبة إلى Cassandra 4.0.13

يتضمّن الإصدار 4.53.00 من Apigee Edge for Private Cloud ترقية لنظام Cassandra إلى الإصدار 4.0.13.

عمليات الترقية والرجوع إلى إصدار سابق

  • عملية الترقية من Cassandra 3.11.X إلى Cassandra 4.0.X هي عملية سلسة. إنّ إصدار Cassandra 4.0.X الذي تم إصداره مع Edge for Private Cloud 4.53.00 متوافق مع مكوّنات وقت التشغيل والإدارة في Private Cloud 4.52.02.
  • لا يمكن التراجع المباشر عن التغييرات في Cassandra 4.0.X إلى 3.11.X. إنّ التراجع باستخدام النُسخ المكرّرة أو النُسخ الاحتياطية هو إجراء معقّد وقد يتضمّن وقتًا متوقّفًا و/أو فقدان البيانات. من الأفضل تحديد المشاكل وحلّها والترقية إلى Cassandra 4.0.X بدلاً من الرجوع إلى إصدار سابق.
  • من المهم التعرّف على إجراءات التراجع قبل محاولة الترقية. من المهم مراعاة الاختلافات الدقيقة في عملية التراجع أثناء الترقية لضمان توفّر مسارات التراجع المناسبة.

مركز بيانات واحد

إنّ ترقية Cassandra من الإصدار 3.11.X إلى الإصدار 4.0.X ضمن مركز بيانات واحد هي عملية سلسة، ولكنّ عملية التراجع معقدة وقد تؤدي إلى إيقاف الخدمة وفقدان البيانات. بالنسبة إلى أعباء العمل في مرحلة الإنتاج، ننصحك بشدة بإضافة مركز بيانات جديد يتضمّن عقد Cassandra على الأقل في مركز البيانات الجديد قبل بدء عملية الترقية. سيؤدي ذلك إلى تفعيل التراجع عن Cassandra بدون فقدان البيانات أو إيقاف زيارات واجهة برمجة التطبيقات. يمكن إيقاف مركز البيانات الإضافي هذا بعد انتهاء الترقية أو الوصول إلى نقطة التحقّق 2.

إذا لم تكن إضافة مركز بيانات جديد ممكنة ولكن لا تزال تريد الاحتفاظ بإمكانية التراجع، ستكون النُسخ الاحتياطية ضرورية لاستعادة Cassandra 3.11.X. ومع ذلك، من المحتمل أن تؤدي هذه الطريقة إلى توقُّف الخدمة وفقدان البيانات.

مراكز بيانات متعدّدة

يوفر تشغيل مراكز بيانات متعددة باستخدام Edge for Private Cloud 4.52.02 مزيدًا من المرونة في عمليات التراجع أثناء الترقية إلى Edge for Private Cloud 4.53.00.

  • تعتمد عمليات التراجع على توفّر مركز بيانات واحد على الأقل يعمل بإصدار Cassandra الأقدم (3.11.X).
  • إذا تمت ترقية مجموعة Cassandra بالكامل إلى الإصدار 4.0.X، يجب عدم الرجوع إلى الإصدار 3.11.X من Cassandra. يجب مواصلة استخدام الإصدار الأحدث من Cassandra مع المكوّنات الأخرى من Private Cloud 4.53.00 أو 4.52.02.
  1. ترقية مركز بيانات Cassandra واحد في كل مرة: ابدأ بترقية عقد Cassandra بشكلٍ فردي ضمن مركز بيانات واحد. أكمِل ترقية جميع عقد Cassandra في مركز بيانات واحد قبل الانتقال إلى مركز البيانات التالي.
  2. التوقف مؤقتًا والتحقّق من الصحة: بعد ترقية مركز بيانات واحد، يمكنك التوقف مؤقتًا للتأكّد من أنّ مجموعة "سحابة Google الخاصة"، وخصوصًا مركز البيانات الذي تمت ترقيته، تعمل بشكلٍ سليم.
  3. تذكَّر: لا يمكنك الرجوع إلى إصدار Cassandra السابق إلا إذا كان لديك مركز بيانات واحد على الأقل لا يزال يستخدم الإصدار الأقدم.
  4. الوقت الحسّاس: على الرغم من أنّه يمكنك إيقاف الإصدارات المختلطة مؤقتًا لفترة قصيرة (ننصح ببضع ساعات) للتحقّق من وظائفها، لا يمكنك البقاء في حالة استخدام إصدارات مختلطة إلى أجل غير مسمى. ويرجع ذلك إلى أنّ مجموعة Cassandra غير المتّسقة (التي تحتوي على عقد في إصدارات مختلفة) لها قيود تشغيلية.
  5. الاختبار الشامل: تنصح شركة Apigee بشدة بإجراء اختبار شامل للأداء والوظائف قبل ترقية مركز البيانات التالي. بعد ترقية جميع مراكز البيانات، يصبح من المستحيل الرجوع إلى الإصدار السابق.
عملية التراجع كعملية تتضمّن نقطتَي فحص
  1. نقطة التفتيش 1: الحالة الأولية، مع جميع المكوّنات في الإصدار 4.52.02. يمكن التراجع الكامل طالما أنّ مركز بيانات واحدًا على الأقل من مراكز بيانات Cassandra لا يزال يستخدم الإصدار الأقدم.
  2. نقطة التحقّق 2: بعد تحديث جميع عقد Cassandra في جميع مراكز البيانات يمكنك الرجوع إلى هذه الحالة، ولكن لا يمكنك الرجوع إلى نقطة التحقّق 1.
مثال

لنفترض أنّ لديك مجموعة تتضمّن مركزَي بيانات:

  1. حالة البدء: تعمل عقد Cassandra في كلتا نقطتَي التحكّم في البيانات بالإصدار 3.11.X. جميع العقد الأخرى تعمل بالإصدار 4.52.02 من Edge for Private Cloud. لنفترض أنّ هناك ثلاث عقد من Cassandra لكل مركز بيانات.
  2. ترقية DC-1: عليك ترقية عقد Cassandra الثلاث في DC-1 واحدة تلو الأخرى.
  3. الإيقاف المؤقت والتحقّق من الصحة: يمكنك إيقاف الإجراء مؤقتًا للتأكّد من أنّ المجموعة، وبشكل خاص "وحدة التحكّم في البيانات 1"، تعمل بشكل صحيح (تحقّق من الأداء والوظائف). يمكنك الرجوع إلى الحالة الأولية باستخدام عقد Cassandra في DC-2. يجب أن يكون هذا الإيقاف المؤقت مؤقتًا بسبب القيود المفروضة على مجموعة Cassandra ذات الإصدارات المختلطة.
  4. ترقية DC-2: عليك ترقية العقد الثلاث المتبقية من Cassandra في DC-2. سيصبح هذا هو نقطة الالتفاف الجديدة.
  5. ترقية المكوّنات الأخرى: يمكنك ترقية عقد الإدارة ووقت التشغيل والتحليلات كالمعتاد في جميع مراكز البيانات، عقدة واحدة ومركز بيانات واحد في كل مرة. في حال حدوث مشاكل، يمكنك الرجوع إلى حالة الخطوة 4.

المتطلّبات الأساسية لترقية Cassandra

يجب تشغيل Cassandra 3.11.16 مع Edge for Private Cloud 4.52.02 والتأكّد مما يلي:
  • تعمل المجموعة بأكملها بكامل طاقتها مع Cassandra 3.11.16.
  • تم ضبط استراتيجية التجميع على LeveledCompactionStrategy (شرط أساسي للترقية إلى الإصدار 4.52.02).
  • اكتملت جميع الخطوات التي يجب اتّخاذها بعد الترقية من الترقية الأولية إلى Cassandra 3.11.16 كجزء من الترقية إلى الإصدار 4.52.02. إذا لم يكن الأمر كذلك، يُرجى إعادة تنفيذ هذه الخطوات. لا ينطبق ذلك إلا في حال الترقية إلى الإصدار 4.52.02 من Private Cloud من إصدار قديم.

الخطوة 1: الاستعداد للترقية

تُضاف الخطوات أدناه إلى الملفات العادية التي تنشئها عادةً، مثل ملف الإعدادات العادي في Apigee لتفعيل ترقيات المكوّنات.

  1. يمكنك الاحتفاظ بنسخة احتياطية من Cassandra باستخدام Apigee.
  2. يمكنك أخذ لقطات شاشة للأجهزة الافتراضية لعقد Cassandra (إذا كان ذلك ممكنًا).
  3. تأكَّد من إمكانية الوصول إلى المنفذ 9042 من جميع مكوّنات Edge for Private Cloud، بما في ذلك خادم الإدارة ومعالج الرسائل وجهاز التوجيه وQpid وPostgres، إلى عقد Cassandra إذا لم يتم ضبطها من قبل. يُرجى الاطّلاع على متطلبات المنفذ للحصول على مزيد من المعلومات.

الخطوة 2: ترقية جميع عقد Cassandra

يجب تحديث جميع عقد Cassandra واحدة تلو الأخرى في كل مركز بيانات، مركز بيانات واحد في كل مرة. بين عمليات ترقية العقد في مركز بيانات، انتظِر بضع دقائق للتأكّد من أنّ العقدة التي تم تعديلها قد بدأت بالكامل وانضمت إلى المجموعة قبل المتابعة لترقية عقدة أخرى في مركز البيانات نفسه.

بعد ترقية جميع عقد Cassandra في مركز بيانات معيّن، انتظِر بعض الوقت (من 30 دقيقة إلى بضع ساعات) قبل المتابعة مع العقد في مركز البيانات التالي. خلال هذه الفترة، راجِع بدقة مركز البيانات الذي تم تعديله وتأكَّد من أنّ مقاييس الأداء والوظائف في مجموعة Apigee سليمة. هذه الخطوة ضرورية لضمان استقرار مركز البيانات الذي تمت ترقية Cassandra فيه إلى الإصدار 4.0.X، بينما تبقى بقية مكوّنات Apigee على الإصدار 4.52.02.

  1. لترقية عقدة Cassandra، شغِّل الأمر التالي: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. بعد تعديل عقدة، نفِّذ الأمر التالي على العقدة لإجراء بعض عمليات التحقّق قبل المتابعة: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
  3. سيؤدي ما سبق إلى عرض ما يلي تقريبًا: 
    Cassandra version is verified - [cqlsh 6.0.0 | Cassandra 4.0.13 | CQL spec 3.4.5 | Native protocol v5] 
Metadata is verified
  4. نفِّذ الأمر post_upgrade التالي على عقدة Cassandra: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
  5. شغِّل أوامر nodetool التالية من أجل إعادة إنشاء الفهارس على عقدة Cassandra: 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms api_products api_products_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_api_products_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_end_user app_end_user_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_family_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_type_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms maps maps_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_consumer_key_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_consumer_key_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_request_token_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_client_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_refresh_token_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_client_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_company_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_developer_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index cache cache_entries cache_entries_cache_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_operation_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_requesturi_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_responsecode_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_timestamp_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_user_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_active_rev
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_index_template
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_method_template
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_latest_rev
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_active
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_latest
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rel_ver
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_res_path
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_res_path
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_entity
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template_auth au_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index dek keys usecase_index
     إذا كنت تستخدم ميزة تحقيق الربح، يمكنك أيضًا تنفيذ أوامر إعادة إنشاء الفهارس التالية المرتبطة بمساحات مفاتيح تحقيق الربح: 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_created_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_updated_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_created_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_currency_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_dev_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_limit_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_prod_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_reason_code_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_sub_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_company_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_created_at_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_developer_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_lastmodified_at_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_env_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_job_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_class_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_group_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus org_triggers org_triggers_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_group_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_suite_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_to_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_org_id_idx

الخطوة 3: ترقية جميع العقد الإدارية

ترقية جميع عقد الإدارة في جميع المناطق واحدة تلو الأخرى:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

الخطوة 4: ترقية جميع عقد Runtime

ترقية جميع أجهزة التوجيه ووحدات معالجة الرسائل في جميع المناطق واحدة تلو الأخرى:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

الخطوة 5: ترقية جميع مكوّنات Edge for Private Cloud 4.53.00 المتبقية

ترقية جميع عقد edge-qpid-server وedge-postgres-server المتبقية في جميع المناطق واحدة تلو الأخرى

خطوات تحديث Apigee SSO من الإصدارات القديمة

في الإصدار 4.53.00 من Edge for Private Cloud، يتم الآن ضبط مفاتيح موفِّر الهوية والشهادات المستخدَمة في مكوّن apigee-sso من خلال ملف تخزين مفاتيح. عليك تصدير المفتاح والشهادة المستخدَمين سابقًا إلى ملف تخزين مفاتيح، وضبطه، ثم المتابعة في تحديث الدخول المُوحَّد كالمعتاد.

  1. حدِّد المفتاح الحالي والشهادة المستخدَمة لضبط موفِّر الهوية:

    1. يمكنك استرداد الشهادة من خلال البحث عن قيمة SSO_SAML_SERVICE_PROVIDER_CERTIFICATE في ملف إعدادات تثبيت الدخول المُوحَّد أو من خلال طلب البحث عن conf_login_service_provider_certificate في مكوّن apigee-sso.

      استخدِم الأمر التالي في عقدة الدخول المُوحَّد (SSO) لطلب البحث من apigee-sso عن مسار شهادة موفِّر الهوية (IdP). في الإخراج، ابحث عن القيمة في السطر الأخير. 

      apigee-service apigee-sso configure -search conf_login_service_provider_certificate

    2. يمكنك استرداد المفتاح من خلال البحث عن قيمة SSO_SAML_SERVICE_PROVIDER_KEY في ملف إعدادات تثبيت الدخول المُوحَّد أو من خلال طلب البحث عن conf_login_service_provider_key في مكوّن apigee-sso.

      استخدِم الأمر التالي في عقدة الدخول المُوحَّد (SSO) لطلب البحث من apigee-sso عن مسار مفتاح موفِّر الهوية (IdP). في الإخراج، ابحث عن القيمة في السطر الأخير.

      apigee-service apigee-sso configure -search conf_login_service_provider_key
  2. تصدير المفتاح والشهادة إلى ملف تخزين مفاتيح:
    1. تصدير المفتاح والشهادة إلى ملف تخزين مفاتيح بتنسيق PKCS12: 
      sudo openssl pkcs12 -export -clcerts -in <certificate_path> -inkey <key_path> -out <keystore_path> -name <alias>

      المَعلمات:

      • certificate_path: مسار ملف الشهادة الذي تم استرجاعه في الخطوة 1(أ).
      • key_path: مسار ملف المفتاح الخاص الذي تم استرجاعه في الخطوة 1(ب).
      • keystore_path: مسار ملف تخزين المفاتيح الذي تم إنشاؤه حديثًا ويحتوي على الشهادة والمفتاح الخاص
      • alias: الاسم المستعار المستخدَم لمفتاح التشفير وشهادة التشفير في ملف تخزين المفاتيح

      يُرجى الرجوع إلى مستندات OpenSSL للحصول على مزيد من التفاصيل.

    2. (اختياري) تصدير المفتاح والشهادة من ملف PKCS12 إلى ملف تخزين مفاتيح JKS: 
      sudo keytool -importkeystore -srckeystore <PKCS12_keystore_path> -srcstoretype PKCS12 -destkeystore <destination_keystore_path> -deststoretype JKS -alias <alias>

      المَعلمات:

      • PKCS12_keystore_path: مسار ملف تخزين مفاتيح PKCS12 الذي تم إنشاؤه في الخطوة 2(أ)، والذي يحتوي على الشهادة والمفتاح
      • destination_keystore_path: مسار ملف تخزين مفاتيح JKS الجديد الذي سيتم تصدير الشهادة والمفتاح إليه
      • alias: الاسم المستعار المستخدَم لمفتاح التشفير وشهادة التشفير ضمن ملف تخزين مفاتيح JKS

      3. يُرجى الرجوع إلى مستندات أداة keytool للحصول على مزيد من التفاصيل.

  3. غيِّر مالك ملف تخزين مفاتيح الخروج إلى المستخدم "apigee": 
    sudo chown apigee:apigee <keystore_file>
  4. أضِف السمات التالية في ملف إعدادات الدخول المُوحَّد في Apigee وعدِّلها باستخدام مسار ملف ملف تخزين المفاتيح وكلمة المرور ونوع ملف تخزين المفاتيح والاسم المعرِّف: 
    # Path to the keystore file
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PATH=${APIGEE_ROOT}/apigee-sso/source/conf/keystore.jks

# Keystore password
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PASSWORD=Secret123  # Password for accessing the keystore

# Keystore type
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_TYPE=JKS  # Type of keystore, e.g., JKS, PKCS12

# Alias within keystore that stores the key and certificate
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_ALIAS=service-provider-cert
  5. عدِّل برنامج الدخول المُوحَّد في Apigee على عقدة الدخول المُوحَّد كالمعتاد باستخدام الأمر التالي: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f /opt/silent.conf

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

يسرد هذا القسم اعتبارات متعلقة بواجهة مستخدم Edge. لمزيد من المعلومات، يُرجى الاطّلاع على واجهة مستخدم Edge الجديدة لـ Private Cloud.

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

بعد إكمال عملية التثبيت الأولي، تنصح شركة Apigee بتثبيت واجهة مستخدم Edge، وهي واجهة مستخدم محسّنة للمطوّرين والمشرفين على Apigee Edge for Private Cloud.

يُرجى العِلم أنّ واجهة مستخدم Edge تتطلّب إيقاف المصادقة الأساسية واستخدام IDP مثل SAML أو LDAP.

لمزيد من المعلومات، يُرجى الاطّلاع على تثبيت واجهة مستخدم Edge الجديدة.

التحديث باستخدام mTLS من Apigee

لتعديل Apigee mTLS، اتّبِع الخطوات التالية:

التراجع عن تحديث

في حال تعذّر إجراء التحديث، يمكنك محاولة حلّ المشكلة، ثم تنفيذ update.sh مرة أخرى. يمكنك إجراء التحديث عدة مرات وسيواصل التحديث من حيث توقف آخر مرة.

إذا كان العُطل يتطلّب إعادة التحديث إلى الإصدار السابق، يُرجى الاطّلاع على مقالة الرجوع إلى الإصدار 4.53.00 للحصول على تعليمات مفصّلة.

تسجيل معلومات التحديثات

تُسجِّل الأداة المساعدة update.sh معلومات السجلّ تلقائيًا في:

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

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

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

تحديث بدون توقّف

يتيح لك التحديث بدون إيقاف الخدمة أو التحديث التلقائي تحديث تثبيت Edge بدون إيقاف Edge.

لا يمكن إجراء التحديث بدون أي فترة إيقاف إلا من خلال إعداد 5 عقد أو أكثر.

إنّ مفتاح الترقية بدون أي وقت توقف هو إزالة كل جهاز توجيه، واحد تلو الآخر، من أداة توازن الحمولة. بعد ذلك، عليك تعديل "الموجّه" وأي مكوّنات أخرى على الجهاز نفسه الذي يعمل عليه "الموجّه"، ثم إضافة "الموجّه" مرة أخرى إلى "موازن الحمولة".

  1. عدِّل الأجهزة بالترتيب الصحيح للتركيب كما هو موضّح في ترتيب تحديث الأجهزة.
  2. عندما يحين وقت تعديل أجهزة التوجيه، اختَر أي جهاز توجيه واجعله غير قابل للوصول إليه، كما هو описан في تفعيل/إيقاف إمكانية الوصول إلى السيرفر (معالج الرسائل/جهاز التوجيه).
  3. عدِّل جهاز التوجيه المحدّد وجميع مكوّنات Edge الأخرى على الجهاز نفسه الذي يعمل عليه جهاز التوجيه. تعرض جميع إعدادات Edge جهاز توجيه ومعالج رسائل في العقدة نفسها.
  4. اجعل جهاز التوجيه متاحًا للاتصال به مرة أخرى.
  5. كرِّر الخطوات من 2 إلى 4 لأجهزة التوجيه المتبقية.
  6. واصِل عملية التحديث لأي أجهزة متبقية في عملية التثبيت.

يُرجى مراعاة ما يلي قبل التحديث وبعده:

استخدام ملف إعدادات صامت

يجب تمرير ملف إعدادات صامت إلى أمر التحديث. يجب أن يكون ملف الإعداد الصامت هو نفسه الملف الذي استخدمته لتثبيت Edge for Private Cloud 4.52.02.

التحديث إلى الإصدار 4.53.00 على عقدة متصلة بالإنترنت الخارجي

اتّبِع الإجراء التالي لتعديل مكوّنات Edge على عقدة:

  1. أوقِف أي مهام cron تم إعدادها لإجراء عملية إصلاح على Cassandra، إن توفّرت، إلى أن تكتمل عملية التحديث.
  2. سجِّل الدخول إلى عقدتك بصفتك مشرفًا لتثبيت حِزم RPM لنظام التشغيل Edge.
  3. أوقِف SELinux كما هو موضّح في مقالة تثبيت أداة إعداد apigee في Edge.
  4. في حال التثبيت على AWS، نفِّذ يليه yum-configure-manager الأوامر: 
    yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

  5. إذا كنت تستخدم حاليًا الإصدار 4.52.02 من Edge:

    1. نزِّل ملف bootstrap_4.53.00.sh في Edge إلى /tmp/bootstrap_4.53.00.sh: 
      curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
    2. ثبِّت الأداة apigee-service ومستلزماتها في Edge 4.53.00 من خلال تنفيذ الأمر التالي: 
      sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord

      حيث يكون uName:pWord هو اسم المستخدم وكلمة المرور اللذان تلقّيتَهما من Apigee. إذا حذفت pWord، سيُطلب منك إدخالها.

      يتحقّق برنامج التثبيت تلقائيًا من تثبيت Java 1.8. وإذا لم تفعل ذلك، سيقوم أداة التثبيت بتثبيته نيابةً عنك.

      استخدِم الخيار JAVA_FIX لتحديد كيفية التعامل مع عملية تثبيت Java. يمكن أن تأخذ JAVA_FIX القيم التالية:

      • I: تثبيت OpenJDK 1.8 (الإعداد التلقائي)
      • C: المتابعة بدون تثبيت Java
      • Q: إنهاء. بالنسبة إلى هذا الخيار، يجب تثبيت Java بنفسك.
    3. استخدِم apigee-service لتعديل الأداة apigee-setup، كما هو موضَّح في المثال التالي: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    4. عدِّل الأداة apigee-validate على "خادم الإدارة"، كما هو موضَّح في المثال التالي: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    5. عدِّل الأداة apigee-provision على "خادم الإدارة"، كما هو موضَّح في المثال التالي: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
    6. شغِّل الأداة update على العقد من خلال تنفيذ الأمر التالي: 
      /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

      اتّبِع الترتيب الموضّح في ترتيب تحديث الأجهزة.

      المكان:

      • component هو مكوّن Edge المطلوب تعديله. تشمل القيم المحتمَلة ما يلي:
        • cs: Cassandra
        • edge: جميع مكوّنات Edge باستثناء واجهة مستخدم Edge: خادم الإدارة، ومعالج الرسائل، وجهاز التوجيه، وخادم QPID، وخادم Postgres
        • ‫ldap: OpenLDAP
        • ‫ps: postgresql
        • qpid: qpidd
        • sso: الدخول المُوحَّد في Apigee (في حال تثبيت الدخول المُوحَّد)
        • ue: واجهة مستخدم Edge الجديدة
        • ui: واجهة مستخدم Edge الكلاسيكية
        • zk: حارس حديقة الحيوانات
      • configFile هو ملف الإعداد نفسه الذي استخدمته لتحديد مكونات Edge أثناء تثبيت الإصدار 4.52.02.

      يمكنك تشغيل update.sh على جميع المكوّنات من خلال ضبط component على "الكل"، ولكن فقط إذا كان لديك ملف تعريف تثبيت لجهاز Edge الكل في واحد. على سبيل المثال:

      /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
    7. أعِد تشغيل مكوّنات واجهة مستخدم Edge على جميع العقد التي تعمل عليها، إذا لم يسبق لك إجراء ذلك: 
      /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
    8. اختبِر التحديث من خلال تشغيل الأداة apigee-validate على "خادم التحكّم"، كما هو موضّح في اختبار عملية التثبيت.

إذا قرّرت لاحقًا إلغاء التحديث، استخدِم الإجراء الموضّح في مقالة الرجوع إلى الإصدار 4.53.00.

التحديث إلى الإصدار 4.53.00 من مستودع محلي

إذا كانت عقد Edge لديك محمية بجدار حماية أو إذا تم حظرها بطريقة أخرى من الوصول إلى ملف التجميع في Apigee عبر الإنترنت، يمكنك إجراء التحديث من ملف تجميع محلي أو نسخة طبق الأصل من ملف تجميع Apigee.

بعد إنشاء مستودع Edge على الجهاز، لديك خياران لتحديث Edge من المستودع على الجهاز:

  • أنشئ ملف ‎ .tar من المستودع، وانسخ ملف ‎ .tar إلى عقدة، ثم عدِّل Edge من ملف ‎.tar.
  • ثبِّت خادم ويب على العقدة التي تتضمّن المستودع المحلي حتى تتمكّن العقد الأخرى من الوصول إليه. توفّر Apigee خادم الويب Nginx لاستخدامك، أو يمكنك استخدام خادم الويب الخاص بك.

لتحديث الإصدار من مستودع 4.53.00 على الجهاز:

  1. أنشئ مستودعًا محليًا للإصدار 4.53.00 كما هو موضّح في مقالة "إنشاء مستودع Apigee محلي" على الرابط تثبيت أداة إعداد Edge apigee.
  2. لتثبيت apigee-service من ملف ‎ .tar:
    1. على العقدة التي تتضمّن المستودع المحلي، استخدِم الأمر التالي لحزمة المستودع المحلي في ملف ‎ .tar واحد باسم /opt/apigee/data/apigee-mirror/apigee-4.53.00.tar.gz: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. انسخ ملف ‎ .tar إلى العقدة التي تريد تحديث Edge عليها. على سبيل المثال، انسخها إلى الدليل /tmp في العقدة الجديدة.
    3. على العقدة الجديدة، فك ضغط الملف في الدليل /tmp: 
      tar -xzf apigee-4.53.00.tar.gz

      ينشئ هذا الأمر دليلاً جديدًا باسم repos في الدليل الذي يحتوي على ملف ‎ .tar. على سبيل المثال، /tmp/repos.

    4. ثبِّت أداة apigee-service وتبعياتها في Edge من /tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.53.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      يُرجى ملاحظة أنّك تضمّن المسار إلى دليل المستودعات في هذا الأمر.

  3. لتثبيت apigee-service باستخدام خادم الويب Nginx:
    1. اضبط خادم الويب Nginx كما هو موضّح في قسم "التثبيت من المستودع باستخدام خادم الويب Nginx" في مقالة تثبيت أداة Edge apigee-setup.
    2. في العقدة البعيدة، نزِّل ملف bootstrap_4.53.00.sh في Edge إلى /tmp/bootstrap_4.53.00.sh: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh

      حيث يكون uName:pWord هو اسم المستخدم وكلمة المرور اللذان ضبطتهما سابقًا للمستودع، وremoteRepo هو عنوان IP أو اسم نظام أسماء النطاقات الخاص بعقدة المستودع.

    3. في العقدة البعيدة، ثبِّت أداة apigee-setup وتبعياتها في Edge: 
      sudo bash /tmp/bootstrap_4.53.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      حيث يكون uName:pWord هو اسم المستخدم وكلمة المرور للملفّ الشخصي.

  4. استخدِم apigee-service لتعديل الأداة apigee-setup، كما هو موضَّح في المثال التالي: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. عدِّل الأداة apigee-validate على "خادم الإدارة"، كما هو موضَّح في المثال التالي: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. عدِّل الأداة apigee-provision على "خادم الإدارة"، كما هو موضَّح في المثال التالي: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. شغِّل الأداة update على العقد بالترتيب الموضّح في ترتيب تحديث الأجهزة: 
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    المكان:

    • component هو مكوّن Edge المطلوب تعديله. عادةً ما تعدّل المكوّنات التالية:
      • cs: Cassandra
      • edge: جميع مكوّنات Edge باستثناء واجهة مستخدم Edge: خادم الإدارة ومعالج الرسائل وجهاز التوجيه وخادم QPID وخادم Postgres
      • ‫ldap: OpenLDAP
      • ‫ps: postgresql
      • qpid: qpidd
      • sso: الدخول المُوحَّد في Apigee (في حال تثبيت الدخول المُوحَّد)
      • ue واجهة مستخدم Edge الجديدة
      • ui: واجهة مستخدم Edge الكلاسيكية
      • zk: حارس حديقة الحيوانات
    • configFile هو ملف الإعداد نفسه الذي استخدمته لتحديد مكوّنات Edge أثناء تثبيت الإصدار 4.50.00 أو 4.51.00.

    يمكنك تشغيل update.sh على جميع المكوّنات من خلال ضبط component على "الكل"، ولكن فقط إذا كان لديك ملف تعريف تثبيت لجهاز Edge الكل في واحد. على سبيل المثال:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
  8. أعِد تشغيل مكوّنات واجهة المستخدم على جميع العقد التي تعمل عليها، إذا لم يسبق لك إجراء ذلك: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. اختبِر التحديث من خلال تشغيل الأداة apigee-validate على "خادم التحكّم "، كما هو موضّح في اختبار عملية التثبيت.

إذا قرّرت لاحقًا إلغاء التحديث، استخدِم الإجراء الموضّح في مقالة الرجوع إلى الإصدار 4.53.00.

ترتيب تحديث الجهاز

من المهم ترتيب تحديث الأجهزة في عملية تثبيت Edge:

  • يجب تحديث جميع عقد Cassandra وZooKeeper قبل تحديث أي عقد أخرى.
  • في أي جهاز يحتوي على مكوّنات Edge متعددة (خادم الإدارة ومعالج الرسائل والموجّه وخادم QPID ولكن ليس خادم Postgres)، استخدِم الخيار -c edge لتعديل كلّها في الوقت نفسه.
  • إذا كانت إحدى الخطوات تحدّد أنّه يجب تنفيذها على أجهزة متعددة، نفِّذها في ترتيب الأجهزة المحدّد.
  • ما مِن خطوة منفصلة لتعديل ميزة "تحقيق الربح". ويتم تعديله عند تحديد الخيار -c edge.

ترقية مستقلة لعقدة واحدة

لترقية إعداد مستقل يتضمّن عقدة واحدة إلى الإصدار 4.53.00:

  1. تعديل جميع المكوّنات: 
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. (في حال تثبيت apigee-adminapi) عليك تحديث الأداة apigee-adminapi باتّباع الخطوات التالية: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

ترقية مستقلة لعقدتَين

عدِّل المكوّنات التالية لعملية تثبيت مستقلة تتضمّن عقدتَين:

اطّلِع على تصاميم التركيب للحصول على قائمة بتصاميم Edge وأرقام العقد.

  1. عدِّل Cassandra وZooKeeper على الجهاز 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. عدِّل Postgres على الجهاز 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. تعديل LDAP على الجهاز 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. عدِّل مكوّنات Edge على الجهازَين 2 و1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. تعديل Qpid على الجهاز 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. تعديل واجهة المستخدم على الجهاز 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (في حال تثبيت apigee-adminapi) عدِّل الأداة apigee-adminapi على الجهاز 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (في حال تثبيت Apigee SSO) عدِّل Apigee SSO على الجهاز 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    حيث يكون sso_config_file هو ملف الإعداد الذي أنشأته عند تثبيت خدمة الدخول المُوحَّد (SSO).

  9. أعِد تشغيل مكوّن واجهة مستخدم Edge على الجهاز 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

ترقية 5 عقد

عدِّل المكوّنات التالية لعملية تثبيت تتضمّن 5 عقد:

اطّلِع على تصاميم التركيب للحصول على قائمة بتصاميم Edge وأرقام العقد.

  1. عدِّل Cassandra وZooKeeper على الجهاز 1 و2 و3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. عدِّل Postgres على الجهاز 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. تعديل Postgres على الجهاز 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. تعديل LDAP على الجهاز 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. تعديل مكوّنات Edge على الأجهزة 4 و5 و1 و2 و3: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. عدِّل Qpid على الجهاز 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. عدِّل Qpid على الجهاز 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. تعديل واجهة مستخدم Edge:
    • واجهة المستخدم الكلاسيكية: إذا كنت تستخدم واجهة المستخدم الكلاسيكية، عدِّل العنصر ui على الجهاز 1، كما هو موضّح في المثال التالي: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    • واجهة مستخدم Edge الجديدة: إذا ثبّتْت واجهة مستخدم Edge الجديدة، عليك تحديث المكوّن ue على الجهاز المناسب (قد لا يكون الجهاز 1): 
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  9. (في حال تثبيت apigee-adminapi) عدِّل الأداة apigee-adminapi على الجهاز 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (في حال تثبيت Apigee SSO) عدِّل Apigee SSO على الجهاز 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    حيث يكون sso_config_file هو ملف الإعداد الذي أنشأته عند تثبيت خدمة الدخول المُوحَّد (SSO).

  11. إعادة تشغيل مكوّن واجهة المستخدم:
    • واجهة المستخدم الكلاسيكية: إذا كنت تستخدم واجهة المستخدم الكلاسيكية، أعِد تشغيل العنصر edge-ui على الجهاز 1، كما هو موضّح في المثال التالي: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • واجهة مستخدم Edge الجديدة: إذا ثبّتْت واجهة مستخدم Edge الجديدة، أعِد تشغيل العنصر edge-management-ui على الجهاز المناسب (قد لا يكون الجهاز 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

ترقية مجموعة تتضمّن 9 عقد

عدِّل المكوّنات التالية لتركيب مجموعة من 9 عقد:

اطّلِع على تصاميم التركيب للحصول على قائمة بتصاميم Edge وأرقام العقد.

  1. عدِّل Cassandra وZooKeeper على الجهاز 1 و2 و3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. تعديل Postgres على الجهاز 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. تعديل Postgres على الجهاز 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. تعديل LDAP على الجهاز 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. عدِّل مكوّنات Edge على الأجهزة 6 و7 و8 و9 و1 و4 و5 بهذا الترتيب: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. عدِّل Qpid على الجهازَين 6 و7: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. عدِّل واجهة المستخدم الجديدة (ue) أو واجهة المستخدم الكلاسيكية (ui) على الجهاز 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (في حال تثبيت apigee-adminapi) عدِّل الأداة apigee-adminapi على الجهاز 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (في حال تثبيت Apigee SSO) عدِّل Apigee SSO على الجهاز 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    حيث يكون sso_config_file هو ملف الإعداد الذي أنشأته عند تثبيت خدمة الدخول المُوحَّد (SSO).

  10. إعادة تشغيل مكوّن واجهة المستخدم:
    • واجهة المستخدم الكلاسيكية: إذا كنت تستخدم واجهة المستخدم الكلاسيكية، أعِد تشغيل العنصر edge-ui على الجهاز 1، كما هو موضّح في المثال التالي: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • واجهة مستخدم Edge الجديدة: إذا ثبّتْت واجهة مستخدم Edge الجديدة، أعِد تشغيل العنصر edge-management-ui على الجهاز المناسب (قد لا يكون الجهاز 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

ترقية مجموعة من 13 عقدة

عدِّل المكوّنات التالية لعملية تثبيت مجمّعة تتضمّن 13 عقدة:

اطّلِع على تصاميم التركيب للحصول على قائمة بتصاميم Edge وأرقام العقد.

  1. عدِّل Cassandra وZooKeeper على الأجهزة 1 و2 و3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. تعديل Postgres على الجهاز 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. تعديل Postgres على الجهاز 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. عدِّل LDAP على الجهازَين 4 و5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. عدِّل مكوّنات Edge على الأجهزة 12 و13 و8 و9 و6 و7 و10 و11 بهذا الترتيب: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. تعديل Qpid على الجهازَين 12 و13: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. عليك تحديث واجهة المستخدم الجديدة (ue) أو واجهة المستخدم الكلاسيكية (ui) على الجهازَين 6 و 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (في حال تثبيت apigee-adminapi) عدِّل الأداة apigee-adminapi على الجهازَين 6 و7: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (في حال تثبيت Apigee SSO) عدِّل Apigee SSO على الجهازَين 6 و7: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    حيث يكون sso_config_file هو ملف الإعداد الذي أنشأته عند تثبيت خدمة الدخول المُوحَّد (SSO).

  10. إعادة تشغيل مكوّن واجهة المستخدم:
    • واجهة المستخدم الكلاسيكية: إذا كنت تستخدم واجهة المستخدم الكلاسيكية، أعِد تشغيل العنصر edge-ui على الجهازَين 6 و7، كما هو موضّح في المثال التالي: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • واجهة مستخدم Edge الجديدة: إذا ثبّتْت واجهة مستخدم Edge الجديدة، أعِد تشغيل العنصر edge-management-ui على الجهازَين 6 و7: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

ترقية مجموعة تتألف من 12 عقدة

عدِّل المكوّنات التالية لعملية تثبيت مجمّعة تتضمّن 12 عقدة:

اطّلِع على تصاميم التركيب للحصول على قائمة بتصاميم Edge وأرقام العقد.

  1. تحديث Cassandra وZooKeeper:
    1. على الأجهزة 1 و2 و3 في مركز البيانات 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. على الأجهزة 7 و8 و9 في مركز البيانات 2 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. تعديل Postgres:
    1. الجهاز 6 في مركز البيانات 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    2. الجهاز 12 في مركز البيانات 2 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. تعديل LDAP:
    1. الجهاز 1 في مركز البيانات 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. الجهاز 7 في مركز البيانات 2 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. تعديل مكوّنات Edge:
    1. الأجهزة 4 و5 و6 و1 و2 و3 في مركز البيانات 1 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. الأجهزة 10 و11 و12 و7 و8 و9 في مركز البيانات 2 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. تعديل qpidd:
    1. الجهازان 4 و5 في مركز البيانات 1
      1. تعديل qpidd على الجهاز 4: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. تعديل qpidd على الجهاز 5: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. الجهازان 10 و11 في مركز البيانات 2
      1. تعديل qpidd على الجهاز 10: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. تعديل qpidd على الجهاز 11: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. يمكنك تحديث واجهة المستخدم الجديدة (ue) أو واجهة المستخدم الكلاسيكية (ui):
    1. الجهاز 1 في مركز البيانات 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
    2. الجهاز 7 في مركز البيانات 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  7. (في حال تثبيت apigee-adminapi) تعديل الأداة apigee-adminapi:
    1. الجهاز 1 في مركز البيانات 1: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
    2. الجهاز 7 في مركز البيانات 2: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (في حال تثبيت Apigee SSO) عدِّل Apigee SSO:
    1. الجهاز 1 في مركز البيانات 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    2. الجهاز 7 في مركز البيانات 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

      3. حيث يكون sso_config_file هو ملف الإعداد الذي أنشأته عند تثبيت خدمة الدخول المُوحَّد (SSO).

  9. يُرجى إعادة تشغيل مكوّن واجهة مستخدم Edge الجديدة (edge-management-ui) أو واجهة مستخدم Edge الكلاسيكية (edge-ui) على الجهازَين 1 و7: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

لإعداد غير عادي

إذا كانت لديك إعدادات غير عادية، عدِّل مكونات Edge بالترتيب التالي:

  1. ZooKeeper
  2. Cassandra
  3. ps
  4. LDAP
  5. Edge، أي الملف الشخصي "-c edge" على جميع العقد بالترتيب: العقد التي تحتوي على خادم Qpid، وخادم Edge Postgres، وخادم الإدارة، ومعالج الرسائل، وجهاز التوجيه.
  6. qpidd
  7. واجهة مستخدم Edge (سواء كانت واجهة مستخدم Edge الكلاسيكية أو الجديدة)
  8. apigee-adminapi
  9. Apigee SSO

بعد الانتهاء من التحديث، احرص على إعادة تشغيل مكوّن واجهة مستخدم Edge على جميع الأجهزة التي تعمل به.