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

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

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

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

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

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

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

  • 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-dev status
    OK: apigee-drupal-devstatus :apigee-drupal-devstatus: apigee-drupal-devstatus :apigee-drupal-devstatus: apigee-drupal-devstatus: apigee-drupal-devstatus :apigee-drupal-devstatus +



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

    *:80 192.168.56.102 (/etc/httpd/conf/vhosts/devمدخل.conf:1)

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

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

  • /opt/apigee/apigee-drupal (Nginx)
  • /var/www/html (Apache)

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

إذا كنت لا تعرف دليل التثبيت، يمكنك تحديده كما هو موضَّح في أوامر Drush الشائعة الاستخدام.

دليل التثبيت التلقائي الجديد بعد تحديث Nginx/Postgres من عملية تثبيت جديدة بالإصدار 4.17.01

بعد تحديث تثبيت جديد للإصدار 4.17.01 يستخدم Nginx/Postgres، تغير الدليل الجذري من:

/opt/apigee/apigee-drupal

 إلى:

/opt/apigee/apigee-drupal/wwwroot

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

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

  • pantheon-14.02.x
  • pantheon-14.03.x
  • pantheon-14.04.x
  • pantheon-14.07.x
  • pantheon-15-01.x
  • OPDK-15-04.x
  • OPDK-15-07.x
  • OPDK-16-01.x
  • OPDK-16-05.x
  • OPDK-16-09.x
  • OPDK-17-01.x

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

http://yourportal.com/buildInfo

قبل التحديث

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

قبل متابعة التثبيت، احتفظ بنسخة احتياطية من دليلك الأساسي على الويب في Drupal. بعد تنفيذ خطوات التثبيت الموضحة أدناه، يمكنك استعادة تخصيصاتك من النسخة الاحتياطية.

ترقية البوابة باستخدام ملف .tar

  1. احتفِظ بنسخة احتياطية من مثيل Drupal MySQL/MariaDB.
    لمزيد من المعلومات، يُرجى الانتقال إلى http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/
    1. الخيار 1: استخدام Drush

      ينشئ أمر Drush sql-dump نسخة من قاعدة البيانات. من دليل Drupal، /var/www/html بشكلٍ تلقائي، شغِّل الأمر:
      > drush sql-dump > /path/to/backup_dir/database-backup.sql

      استخدِم drush help sql-dump للحصول على مزيد من المعلومات.
    2. الخيار 2: استخدام MySQLdump
      استخدِم الأمر mysqldump لإنشاء نسخة من قاعدة البيانات:
      mysqldump -u username -p'password' DATABASENAME > /path/to/backup_dir/database-backup.sql

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

      يمكنك ضبط اسم المستخدم وDATABASENAME عند تثبيت البوابة. وبشكل تلقائي، يكون كلاهما بوابة مطوّري برامج.
  2. أنشِئ نسخة احتياطية من دليلك الأساسي على الويب في Drupal. الموقع التلقائي للتثبيت هو /var/www/html، ولكن يمكنك تغييره في وقت التثبيت.
  3. نزِّل ملف DeveloperServices_x.y.z.tar إلى الملف من ftp.apigee.com، حيث يتوافق x.y.z مع رقم إصدار البوابة. أدخِل بيانات الاعتماد التي تلقّيتها من Apigee عندما يُطلب منك ذلك.

    يمكنك تنزيل ملف من الرابط الذي تم إرساله إليك من خلال Apigee في متصفّح أو عن طريق نسخه ثم إضافته إلى أمر cURL التالي:
    > curl -kOL <paste link here>

    ملاحظة: إذا كانت البوابة الإلكترونية على خادم بدون اتصال خارجي بالإنترنت، يمكنك تنفيذ هذه الخطوة على خادم يمكن الوصول إليه.

    انتقِل إلى دعم Apigee Edge واختَر تسجيل الدخول إلى بوابة الدعم لطلب ملف .tar الخاص بالترقية إلى خدمات قناة قناة المطوِّر. إذا لم يكن لديك حساب على "بوابة الدعم"، اختَر تسجيل الدخول إلى "بوابة الدعم"، ثم اختَر هل بسرعة في صفحة تسجيل الدخول؟ يمكنك تقديم طلب دعم هنا.
  4. لترقية خادم متّصل بالإنترنت:
    1. استخرِج ملف ترقية البوابة:
      > tar -xvf <tar file>

      ينشئ استخراج الأوامر هذا دليلاً جديدًا باسم DeveloperServices-4.x.y.z.
    2. غيِّر إلى الدليل DeveloperServices-4.x.y.z إلى الدليل.
    3. نزِّل أحدث إصدار من Drupal باستخدام الأمر التالي:
      > drush dl drupal

      ينشئ هذا الأمر دليلاً باسم drupal-x.y، حيث يتجاوب x.y مع الإصدار الحالي من Drupal.
    4. شغِّل النص البرمجي networked-update.sh:
      > ./networked-update.sh

      استنادًا إلى أذونات الملفات، قد تحتاج إلى استخدام sudo لتشغيل هذا الأمر، أو تشغيله بصفتك مشرفًا.
    5. لتلقّي إشعارات بشأن تحديثات Drupal، تأكَّد من تفعيل وحدة مدير تحديثات Drupal. من قائمة Drupal، اختَر الوحدات وانتقِل للأسفل إلى وحدة مدير التحديثات. إذا لم يكن مفعَّلاً، عليك تفعيله.

      بعد تفعيل الميزة، يمكنك الاطّلاع على التحديثات المتاحة باستخدام عنصر القائمة التقارير > التحديثات المتوفّرة.

      يمكنك استخدام عنصر القائمة التقارير > التحديثات المتاحة > الإعدادات لضبط الوحدة لإرسال رسالة إلكترونية إليك عند توفّر تحديثات، ولضبط معدّل البحث عن التحديثات.
  5. لترقية خادم غير متصل بالإنترنت:
    1. على الخادم الذي نزَّلت عليه ملف DeveloperServices_x.y.z.tar، استخرِج ملف ترقية البوابة:
      > tar -xvf <tar file>

      ينشئ استخراج الأمر هذا دليلاً جديدًا يُسمى DeveloperServices-4.x.y.z.
    2. غيِّر إلى الدليل DeveloperServices-4.x.y.z إلى الدليل.
    3. شغِّل النص البرمجي non-networked-update.sh:
      > ./non-networked-update.sh

      استنادًا إلى أذونات الملفات، قد تحتاج إلى استخدام برنامج sudo لتشغيل هذا الأمر أو تشغيله بصفتك مشرفًا.

      يؤدي هذا الأمر إلى تنزيل جميع ملفات التحديث اللازمة ووضعها في ملف واحد باسم devportal-update.tgz وكتابة الملف في موقع من اختيارك.
    4. انسخ devportal-update.tgz إلى الخادم الهدف، أي الخادم المستهدف الذي تشغّل البوابة.
      ملاحظة: لا تنسخ devportal-update.tgz إلى جذر الويب للخادم الهدف.
    5. أزِل الملف devportal-update.tgz في الدليل الحالي:
      > tar -xzf /path/to/devمدخل-update.tgz
    6. غيِّر إلى الدليل developer-update.
    7. نفِّذ الأمر التالي لتثبيت التحديث:
      > ./install-update.sh
    8. عليك الإجابة على الطلبات.

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

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

استخدم الإجراء التالي لتحديث العائد لكل ألف ظهور للبوابة على أي عقدة:

  1. انتقِل إلى دليل Drupal، وهو /opt/apigee/apigee-drupal تلقائيًا:
    > cd /opt/apigee/apigee-drupal
  2. احتفِظ بنسخة احتياطية من مثيل قاعدة بيانات Drupal. ينشئ الأمر pg_dump نسخة من قاعدة البيانات:

    pg_dump --dbname=devمدخل --host=192.168.56.101 --username=drupaladmin --password --format=c > /tmp/مدخل.dmp

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

    إذا احتجت لاحقًا إلى الاستعادة من النسخة الاحتياطية، استخدِم الأمر:
    pg_restore --clean --dbname=dev عندما --host=localhost --username=apigee < /tmp/مدخل.dmp
  3. أنشِئ نسخة احتياطية من دليلك الأساسي على الويب في Drupal. الموقع التلقائي للتثبيت هو /opt/apigee/apigee-drupal، ولكن من المحتمل أنّك غيّرته.

    إذا لم تكن متأكدًا من موقع هذا الدليل، استخدِم الأمر drush status أو إدخال الضبط > الوسائط > ملف في قائمة Drupal لتحديد موقع نظام الملفات العام ومسار نظام الملفات الخاصة (للخطوة التالية).
  4. أنشِئ نسخة احتياطية من الملفات في /opt/apigee/data/apigee-drupal-devportal/private.
  5. أوقِف SELinux كما هو موضح في تثبيت الأداة المساعدة لإعداد واجهة Edge في Edge.
  6. لترقية خادم متّصل بالإنترنت:
    1. نزِّل ملف Edge 4.17.05 bootstrap_4.17.05.sh من أجل /tmp/bootstrap_4.17.05.sh:
      > curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/1shbootstrap_4
    2. ثبِّت الأداة المساعدة Edge 4.17.05 apigee-service والتبعيات:
      > sudo bash /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord

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

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

        ينشئ هذا الأمر دليلاً جديدًا باسم repos في الدليل الذي يحتوي على ملف .tar. على سبيل المثال /tmp/repos.
      4. عليك تثبيت الأداة المساعدة apigee-service الخاصة بخدمة Edge والتبعيات من /tmp/repos:
        > sudo bash /tmp/repos/bootstrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
        ملاحظة أنّك توفّر مسار الدليل إلى هذا الأمر repos.
    3. لتثبيت خدمة apigee باستخدام خادم الويب Nginx:
      1. اضبط خادم الويب Nginx كما هو موضّح في القسم "التثبيت من المخزن باستخدام خادم الويب Nginx" في تثبيت الأداة المساعدة لإعداد واجهة برمجة تطبيقات Edge.
      2. في العقدة البعيدة، نزِّل ملف Edge bootstrap_4.17.05.sh إلى /tmp/bootstrap_4.17.05.sh:
        > /usr/bin/curl http://uName:pWordName@remoteRepo. :3939/bootstrap_4.

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

  8. استخدِم apigee-service لتحديث الأداة apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  9. شغِّل الأداة المساعدة للتحديث في عُقدتك لتعديل قاعدة بيانات Postgres:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

    حيث يكون configFile هو ملف الإعداد الذي استخدمته لتثبيت قاعدة بيانات Postgres. الشرط الوحيد في ملف الإعداد هو أن يتمكن مستخدم "apigee" من الوصول إلى ملف الإعداد أو قراءته.
  10. بدء Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  11. شغِّل الأداة المساعدة للتحديث في العقدة لتحديث البوابة:
    > /opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile

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

لاحظ أن الدليل الجذري بعد التحديث أصبح الآن:

/opt/apigee/apigee-drupal/wwwroot

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