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

بوابة خدمات المطوّرين، الإصدار 4.17.09

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

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

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

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

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

  • 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

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

http://your_portal.com/buildInfo

قبل التحديث

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

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

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

استخدِم الإجراء التالي لتعديل قيمة الأرباح لكل ألف مشاهدة (RPM) في البوابة على إحدى العُقد:

  1. انتقِل إلى دليل Drupal. مثلاً: /opt/apigee/apigee-drupal/wwwroot 

    cd /opt/apigee/apigee-drupal/wwwroot

    راجع دليل التثبيت الافتراضي للدليل الافتراضي لإصدار المنتج الخاص بك.

  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. يجب تنزيل ملف Edge 4.17.09 bootstrap_4.17.09.sh إلى /tmp/bootstrap_4.17.09.sh: 
      curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
    2. ثبّت الأداة المساعدة والتبعيات apigee-service على Edge 4.17.09: 
      sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName
  apigeepassword=pWord

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

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

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

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

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

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

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

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

      3. في العقدة البعيدة، ثبّت أداة Edge apigee-service dependencies:code 
        sudo bash /tmp/bootstrap_4.17.09.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. شغِّل أداة التحديث على العُقدة لتحديث قاعدة بيانات Postgres:
    /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 start
  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

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