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

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

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

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

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

• إذا كان التثبيت يستخدم Apache/MySQL أو Apache/MariaDB من أحد الأنظمة إلى 4.17.01، ثم استخدم الترقية بوابة باستخدام ملف .tar
• إذا كان التثبيت يستخدم Nginx/Postgres من إصدار 4.17.01 جديد تثبيت، ثم استخدِم ترقية بوابة باستخدام الأرباح لكل ألف مشاهدة (RPM).

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

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

• ls /opt
  في حال استخدام Nginx/Postgres، سيظهر لك الدليلان التاليان: /opt/apigee و/opt/nginx.
  
  في حالة استخدام Apache/MySQL أو Apache/MariaDB، يجب ألا تكون هذه الأدلة حاليًا.
• /opt/apigee/apigee-service/bin/apigee-all الحالة
  إذا كنت تستخدم Nginx/Postgres، فسيظهر لك الناتج التالي:
  
  + خدمة apigee حالة apigee-drupal-dev Portal
  حَسَنًا: apigee-drupal-devportal قيد التشغيل الآن
  + حالة apigee-lb لـ apigee-service
  apigee-service: apigee-lb: OK
  + حالة apigee-postgresql
  apigee-service: apigee-postgresql: OK
• apachectl -S
  في حال استخدام Apache/MySQL أو Apache/MariaDB، من المفترض أن يعرض هذا الأمر الويب الدليل الجذري للبوابة، بالتنسيق:
  
  *:80 192.168.56.102 (/etc/httpd/conf/vhosts/devportal.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 الأساسي أو في أي رموز ، فسيتم استبدال تعديلاتك. يتضمن هذا، من بين أمور أخرى، أي تغييرات التي تستخدمها إلى .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 sql-dump تنشئ نسخة من قاعدة البيانات. من دليل Drupal، اضغط على /var/www/html تلقائيًا، شغِّل الأمر:
      > drush sql-dump > /path/to/backup_dir/database-backup.sql
      
      استخدِم sql-dump للمساعدة في الفرش من أجل مزيد من المعلومات.
   2. الخيار 2: استخدام MySQLdump
      استخدام الأمر mysqldump لإنشاء نسخة من قاعدة البيانات:
      mysqldump -u USERNAME -p'password' DATABASENAME > /path/to/backup_dir/database-backup.sql
      
      يجب ألا تكون هناك مسافة بين الخيار -p وكلمة المرور. سرير مفرد تكون علامات الاقتباس حول كلمة المرور مطلوبة إذا كانت كلمة المرور تحتوي على رموز خاصة.
      
      يمكنك ضبط USERNAME وDATABASENAME. عند تثبيت البوابة. يكون كلاهما تلقائيًا بوابة مطوّري البرامج.
2. عليك إنشاء نسخة احتياطية من الدليل الجذري على الويب الخاص بمنصة Drupal بالكامل. موقع التثبيت التلقائي هو /var/www/html، ولكن يمكنك وقمت بتغييرها وقت التثبيت.
3. نزِّل خدمات قناة المطوّرين DeveloperServices_x.y.z.tar. ملف من ftp.apigee.com، حيث x.y.z مع رقم إصدار البوابة. أدخِل بيانات الاعتماد التي تلقّيتها عندما يُطلب منك ذلك. من Apigee.
   
   يمكنك تنزيل ملف من الرابط الذي تم إرساله إليك من خلال Apigee في متصفّح أو عن طريق نسخه ثم إضافته إلى أمر cURL التالي:
   &gt; curl -kOL <لصق الرابط here&gt;
   
   ملاحظة: إذا كانت البوابة على خادم بدون اتصال إنترنت خارجي، تنفيذ هذه الخطوة على خادم لديه حق الوصول.
   
   انتقِل إلى Apigee Edge Support. واختَر تسجيل الدخول إلى "بوابة الدعم" لطلب "قناة المطوّر". ملف tar. الخاص بترقية الخدمات إذا لم يكن لديك حساب على "بوابة الدعم"، اختَر سجِّل الدخول إلى "بوابة الدعم"، ثم في صفحة تسجيل الدخول، اختَر في بسرعة؟ يمكنك تقديم طلب دعم هنا.
4. بالنسبة إلى الترقية على خادم متصل بالإنترنت:
   1. استخرِج ملف ترقية البوابة:
      &gt; tar -xvf <tar file&gt;
      
      ينشئ استخراج الأوامر هذا دليلاً جديدًا باسم DeveloperServices-4.x.y.z.
   2. التغيير إلى DeveloperServices-4.x.y.z الدليل.
   3. نزِّل أحدث إصدار من Drupal باستخدام الأمر التالي:
      &gt; 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&gt;
      
      ينشئ استخراج الأوامر هذا دليلاً جديدًا باسم 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. شغِّل الأمر التالي لتثبيت التحديث:
      &gt; ./install-update.sh
   8. أجِب عن الطلبات.

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

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

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

1. عليك التغيير إلى دليل Drupal، /opt/apigee/apigee-drupal من خلال التلقائي:
   &gt; cd /opt/apigee/apigee-drupal
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 --تنظيف --dbname=devportal --host=localhost --username=apigee < /tmp/portal.dmp
3. عليك إنشاء نسخة احتياطية من الدليل الجذري على الويب الخاص بمنصة Drupal بالكامل. موقع التثبيت التلقائي هي /opt/apigee/apigee-drupal، ولكن ربما تكون قد غيرتها.
   
   إذا لم تكن متأكدًا من مكان هذا الدليل، فاستخدم الأمر حالة drush أو الإعداد > الوسائط > إدخال ملف في قائمة Drupal لتحديد مكان نظام الملفات العام ومسار نظام الملفات الخاص (في المرحلة التالية ).
4. أنشئ نسخة احتياطية من الملفات في /opt/apigee/data/apigee-drupal-devportal/private.
5. عطّل SELinux كما هو موضح في Install أداة Edge apigee-setup.
6. بالنسبة إلى الترقية على خادم متصل بالإنترنت:
   1. نزِّل ملف bootstrap_4.17.05.sh على Edge 4.17.05 من أجل /tmp/bootstrap_4.17.05.sh:
      > ضفيرة https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
   2. تثبيت أداة apigee-service في Edge 4.17.05 التبعيات:
      > sudo bash /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord
      
      حيث يشير uName:pWord إلى اسم المستخدم وكلمة المرور اللذين تلقيتهما منهما Apigee. إذا لم تستخدم pWord، سيُطلب منك إدخاله.
      
      بشكل تلقائي، تتحقّق أداة التثبيت من أنّك مثبّت Java 1.8. يمكنك استخدام صفحة "C" المتابعة بدون تثبيت Java.
7. بالنسبة إلى الترقية على خادم بلا اتصال بالإنترنت:
   1. أنشِئ مستودعًا محليًا للإصدار 4.17.05 كما هو موضَّح في قسم "إنشاء مستودع محلي في Apigee". بنسبة تثبيت Edge apigee-setup .
      ملاحظة: إذا كان لديك مستودع 4.17.01 حالي، يمكنك إضافة مستودع 4.17.05 له كما هو موضّح في "تعديل مستودع Apigee محلي" في تثبيت أداة Edge apigee-setup.
   2. لتثبيت خدمة apigee من ملف .tar:
      1. في العقدة مع المستودع المحلي، استخدم الأمر التالي لحزم Repo في ملف .tar واحد باسم /opt/apigee/data/apigee-mirror/apigee-4.17.05.tar.gz:
         > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
      2. انسخ ملف .tar إلى العقدة التي تريد تحديث Edge فيها. على سبيل المثال، انسخه إلى الدليل /tmp على العقدة الجديدة.
      3. في العقدة الجديدة، عليك إلغاء تنزيل الملف في دليل /tmp:
         &gt; 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 أداة إعداد apigee.
      2. في العقدة البعيدة، نزِّل ملف bootstrap_4.17.05.sh من أجل /tmp/bootstrap_4.17.05.sh:
         > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
         
         حيث يكون uName:pWord هو اسم المستخدم وكلمة المرور اللذين حددتهما أعلاه للمستودع، وremoteRepo هو عنوان IP أو اسم نظام أسماء النطاقات عقدة repo.
      3. في العقدة البعيدة، ثبّت أداة apigee-service في Edge، التبعيات:
         > sudo bash /tmp/bootstrap_4.17.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
         
         حيث يكون uName:pWord هو اسم المستخدم وكلمة المرور للمستودع.
8. استخدِم apigee-service من أجل: تعديل apigee-setup شركة الطاقة:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
9. شغِّل أداة التحديث على العُقدة لتحديث قاعدة بيانات Postgres:
   &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
   
   حيث يكون configFile هو ملف الإعداد الذي استخدمته لتثبيت قاعدة بيانات Postgres. والمتطلب الوحيد في ملف التهيئة هو أن تهيئة يجب أن يكون الملف قابلاً للوصول أو القراءة بواسطة "apigee" المستخدم.
10. بدء Postgres:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
11. شغِّل أداة التحديث على العُقدة لتحديث البوابة:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile
    
    حيث يكون configFile هو ملف الإعداد الذي استخدمته لتثبيت البوابة. إن الشرط الوحيد في ملف التهيئة هو أن يكون ملف التهيئة يجب أن تكون قابلة للوصول إليها أو قراءتها بواسطة "apigee" المستخدم.

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

/opt/apigee/apigee-drupal/wwwroot

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