ترقية بوابة خدمات مطوِّري البرامج

الإصدار 4.18.01 من Edge for Private Cloud

يصف هذا الإجراء كيفية ترقية خدمات قناة المطوّرين الحالية في Apigee. التثبيت داخل المؤسسة.

تحديد الإجراء الصحيح للتحديث

يعتمد الإجراء الذي تستخدمه لتحديث البوابة على عملية التثبيت الحالية:

• إذا كان التثبيت يستخدم Nginx/Postgres، استخدِم ترقية البوابة باستخدام حِزم RPM أدناه.
• إذا كان التثبيت يستخدم Apache/MySQL أو Apache/MariaDB، اطّلِع على مقالة تحويل البوابة المستندة إلى tar إلى بوابة مستندة إلى RPM.

يعتمد تحديد نوع التثبيت الحالي

إذا لم تكن متأكدًا من نوع التثبيت الحالي، استخدِم الأمر التالي لتحديد فهو:

• ls /opt

  إذا كنت تستخدم Nginx/Postgres، ستظهر لك الدلائل التالية: /opt/apigee و/opt/nginx.

  إذا كنت تستخدم Apache/MySQL أو Apache/MariaDB، يجب ألا تكون هذه الدلائل متوفّرة.

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

  إذا كنت تستخدم Nginx/Postgres، سيظهر لك الإخراج التالي:

  + apigee-service
  apigee-drupal-devportal status
  OK: apigee-drupal-devportal is up and running
  + apigee-service apigee-lb status
  apigee-service: apigee-lb: OK
  + apigee-service apigee-postgresql status
  apigee-service: apigee-postgresql: OK

• apachectl -S

  إذا كنت تستخدم Apache/MySQL أو Apache/MariaDB، من المفترض أن يعرض هذا الأمر الدليل الجذر للبوابة على الويب، على النحو التالي:

  *:80
  192.168.56.102 (/etc/httpd/conf/vhosts/devportal.conf:1)

دليل التثبيت التلقائي

تفترض عملية الترقية أنّه تم تثبيت "بوابة المطوّرين" على:

• الإصدار 4.17.05 والإصدارات الأحدث: /opt/apigee/apigee-drupal/wwwroot
• قبل الإصدار 4.17.05: /opt/apigee/apigee-drupal (Nginx) أو /var/www/html (Apache)

إذا لم يتم تثبيت البوابة في الدليل التلقائي، عليك تعديل المسارات في الإجراء أدناه لاستخدام دليل التثبيت.

إصدارات الترقية المتوافقة

إجراء الترقية هذا متوافق مع الإصدارات التالية من البوابة:

• OPDK-17-01.x
• OPDK-17-05.x
• OPDK-17-09.x

لتحديد إصدار البوابة، افتح عنوان URL التالي في متصفّح:

http://yourportal.com/buildInfo

قبل التحديث

بالنسبة إلى عمليات التثبيت الحالية، إذا عدّلت أي رمز في نظام Drupal الأساسي أو في أي رموز ، فسيتم استبدال تعديلاتك. ويشمل ذلك، من بين أمور أخرى، أي تغييرات ربما أجريتها على .htaccess. يجب افتراض أنّ أي ملف خارج دليل /sites مملوك لخدمة Drupal. يُستثنى من هذه القاعدة robots.txt. إذا كان هذا الملف متوفّرًا في جذر الويب، سيتم الاحتفاظ به.

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

ترقية بوابة باستخدام RPM

لتعديل قيمة الأرباح لكل ألف مشاهدة (RPM) في البوابة على عقدة:

1. التغيير إلى دليل Drupal، /opt/apigee/apigee-drupal من خلال الافتراضي:

   cd /opt/apigee/apigee-drupal

2. احتفِظ بنسخة احتياطية من مثيل قاعدة بيانات Drupal. ينشئ الأمر pg_dump نسخة من قاعدة البيانات:

   pg_dump --dbname=devportal --host=192.168.56.101 --username=drupaladmin
     --password --format=c > /tmp/portal.dmp

   حيث:

   • dbname تحدِّد اسم قاعدة البيانات كما هو محدّد في سمة PG_NAME في ملف إعدادات تثبيت البوابة.
   • يحدد host عنوان IP لعقدة البوابة.
   • username تُحدِّد اسم مستخدم Postgres الذي تستخدمه البوابة للوصول إلى قاعدة البيانات على النحو المحدَّد من خلال سمة DRUPAL_PG_USER في ملف إعدادات تثبيت البوابة.
   • سيُطلب منك إدخال كلمة مرور مستخدم Postgres كما هو محدّد في سمة DRUPAL_PG_PASS في ملف إعدادات تثبيت البوابة.

   إذا أردت في وقت لاحق استعادة البيانات من النسخة الاحتياطية، استخدِم الأمر التالي:

   pg_restore --clean --dbname=devportal --host=localhost  --username=apigee < /tmp/portal.dmp

3. عليك إنشاء نسخة احتياطية من الدليل الجذري على الويب الخاص بمنصة Drupal بالكامل. موقع التثبيت التلقائي يبلغ /opt/apigee/apigee-drupal، ولكن من المحتمل أنّك غيّرته.

   إذا لم تكن متأكّدًا من موقع هذا الدليل، استخدِم الأمر drush status أو إدخال الإعداد > الوسائط > الملف في قائمة Drupal لتحديد موقع نظام الملفات العام ومسار نظام الملفات الخاص (للخطوة التالية).

4. يمكنك الاحتفاظ بنسخة احتياطية من الملفات في /opt/apigee/data/apigee-drupal-devportal/private.
5. ضبط Drupal على وضع الصيانة:
   1. اختَر الإعداد في قائمة Drupal.
   2. في صفحة الضبط، اختَر وضع الصيانة ضمن التطوير.
   3. اختَر المربع وضع الموقع الإلكتروني في وضع الصيانة.
   4. أدخِل رسالة تظهر للمستخدمين أثناء فترة الصيانة.
   5. اختَر حفظ الإعداد.
6. إيقاف SELinux كما هو موضح في ثبِّت الأداة المساعدة لإعداد واجهة برمجة التطبيقات Edge على Edge.
7. التغيير إلى الدليل /opt:

   > cd /opt

8. بالنسبة إلى الترقية على خادم متصل بالإنترنت:
   1. نزِّل ملف bootstrap_4.18.01.sh لإصدار Edge 4.18.01 إلى: /tmp/bootstrap_4.18.01.sh:

      curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh

   2. تثبيت أداة Edge 4.18.01 apigee-service والملحقات:

      sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

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

      بشكل تلقائي، تتحقّق أداة التثبيت من أنّك مثبّت Java 1.8. يمكنك استخدام الخيار "C" للمتابعة بدون تثبيت Java.

9. بالنسبة إلى الترقية على خادم بلا اتصال بالإنترنت:
   1. أنشئ مستودعًا محليًا من الإصدار 4.18.01 كما هو موضّح في مقالة "إنشاء مستودع Apigee محلي" على الرابط تثبيت أداة Edge apigee-setup.
   2. لتثبيت خدمة apigee من ملف .tar:
      1. على العقدة التي تتضمّن المستودع المحلي، استخدِم الأمر التالي لحزمة المستودع المحلي في ملف tar. واحد باسم /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz:

          /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

      2. انسخ ملف .tar إلى العقدة التي تريد تحديث Edge فيها. على سبيل المثال، انسخه إلى دليل /tmp في العقدة الجديدة.
      3. على العقدة الجديدة، فكِّ ضغط الملف إلى الدليل ‎/tmp:

         tar -xzf apigee-4.18.01.tar.gz

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

      4. تثبيت أداة Edge apigee-service والتبعيات من /tmp/repos:

         sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

         لاحظ أنك قمت بتضمين المسار إلى دليل repos في هذا الأمر.

   3. لتثبيت apigee-service باستخدام خادم الويب Nginx:
      1. قم بتهيئة خادم الويب Nginx كما هو موضح في "التثبيت من المستودع باستخدام خادم ويب Nginx" في تثبيت Edge أداة إعداد apigee.
      2. في العقدة البعيدة، نزِّل ملف Edge bootstrap_4.18.01.sh من أجل /tmp/bootstrap_4.18.01.sh:

         /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh
           -o /tmp/bootstrap_4.18.01.sh

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

      3. في العقدة البعيدة، ثبّت أداة Edge apigee-service dependencies:

         sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939
             apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

         حيث يمثّل uName:pWord اسم المستخدم وكلمة المرور الخاصَين بالمستودع.

10. استخدِم apigee-service لتحديث الأداة apigee-setup:

    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

11. شغِّل أداة التحديث في عقدة Postgre:

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

    حيث يكون configFile هو ملف الإعدادات الذي استخدمته لتثبيت "قاعدة بيانات Postgres". الشرط الوحيد في ملف الإعداد هو أن يكون ملف الإعداد قابلاً للوصول إليه أو للقراءة من قِبل مستخدم "apigee".

12. تعديل قاعدة بيانات Postgres:

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade

13. شغِّل أداة التحديث على عقدتك لتعديل البوابة:

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

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

14. يمكنك تشغيل نص Drupal النصي update.php من خلال فتح عنوان URL التالي في نافذة متصفّح:

    http://portalIP_DNS:8079/update.php

15. أوقِف وضع الصيانة في Drupal:
    1. اختَر الإعداد في قائمة Drupal.
    2. في صفحة الضبط، اختَر وضع الصيانة ضمن التطوير.
    3. أزِل العلامة من المربّع وضع الموقع في وضع الصيانة.
    4. انقر على حفظ الضبط.

يُرجى العِلم أنّ الدليل الجذر بعد التحديث هو:

/opt/apigee/apigee-drupal/wwwroot

اكتملت عملية الترقية الآن.