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

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

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

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

تفترض عملية الترقية أنّه قد تم تثبيت "بوابة المطوِّر" من خلال /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 Developer إلى إصدار جديد

1. نسخة احتياطية من مثيل Drupal MySQL
   لمزيد من المعلومات، يُرجى الانتقال إلى 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 إلى ملف، حيث يتوافق 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/devمدخل-update.tgz
   6. غيِّر إلى الدليل developer-update.
   7. نفِّذ الأمر التالي لتثبيت التحديث:
      > ./install-update.sh
   8. عليك الإجابة على الطلبات.

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