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

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

توضّح هذه العملية كيفية ترقية عملية تثبيت حالية على الموقع الإلكتروني لخدمات قناة المطوّرين في 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

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

http://yourportal.com/buildInfo

قبل التثبيت

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

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

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

1. نسخة احتياطية من مثيل MySQL في Drupal
   لمزيد من المعلومات، يُرجى الاطّلاع على 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
      
      يجب ألا تكون هناك مسافة بين الخيار -p وكلمة المرور. تكون علامات الاقتباس المفردة حول كلمة المرور مطلوبة إذا كانت كلمة المرور تحتوي على رموز خاصة.
      
      يمكنك إعداد USERNAME وDATABASENAME عند تثبيت البوابة. ويكون كلاهما devportal تلقائيًا.
2. أنشئ نسخة احتياطية من دليل جذر الويب في Drupal بالكامل. إنّ الموقع التلقائي للتثبيت هو /var/www/html، ولكن قد يكون قد تم تغييره في وقت التثبيت.
3. نزِّل ملف DeveloperServices_x.y.z.tar "خدمات المطوّرين"، حيث يشير x.y.z إلى رقم إصدار البوابة.
   
   يمكنك تنزيل ملف من الرابط الذي أرسلته إليك شركة 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، تأكَّد من تفعيل وحدة "مدير تحديثات 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/devportal-update.tgz
   6. انتقِل إلى الدليل developer-update.
   7. شغِّل الأمر التالي لتثبيت التحديث:
      > ./install-update.sh
   8. أجِب عن الطلبات.

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