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

الإصدار 4.17.01 من Developer Services Portal

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

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

تفترض عملية الترقية أنّه تم تثبيت "بوابة مخصّصة للمطوّرين" في /var/www/html. إذا لم تثبّت البوابة في الدليل التلقائي، عدِّل المسارات في الإجراء أدناه لاستخدام دليل التثبيت.

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

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

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

  • 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

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

http://yourportal.com/buildInfo

قبل التثبيت

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

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

ترقية خدمات قناة مطوّري Apigee إلى إصدار جديد

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

      ينشئ الأمر sql-dump في Drush نسخة من قاعدة البيانات. من دليل 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

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

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

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

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

    انتقِل إلى http://community.apigee.com/content/apigee-customer-support واختَر تسجيل الدخول إلى "بوابة الدعم" لطلب ملف ‎ .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، تأكَّد من تفعيل وحدة &quot;مدير تحديثات Drupal&quot; (Drupal Update manager). من قائمة Drupal، اختَر Modules (الوحدات) وانتقِل للأسفل إلى وحدة Update manager (مدير التحديثات). إذا لم يكن مفعَّلاً، فعِّله.

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

      استخدِم عنصر القائمة التقارير > التحديثات المتاحة > الإعدادات لضبط الوحدة لإرسال رسالة إلكترونية إليك عند توفّر تحديثات ولضبط معدّل تكرار البحث عن تحديثات.
  5. للترقية على خادم بدون اتصال بالإنترنت:
    1. على الخادم الذي نزّلت عليه ملف Developer Channel Services 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/devportal-update.tgz
    6. انتقِل إلى الدليل developer-update.
    7. نفِّذ الأمر التالي لتثبيت التحديث:
      > ./install-update.sh
    8. أجِب عن الطلبات.

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