ترقية البوابة

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

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

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

• إذا كان التثبيت يستخدم NGINX/Postgres، استخدِم يمكنك الاطّلاع أدناه على ترقية بوابة باستخدام مقياس RPM.
• إذا كان التثبيت يستخدم Apache/MySQL أو Apache/MariaDB، يُرجى الاطّلاع على تحويل بوابة تستند إلى tar إلى بوابة تستند إلى RPM.

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

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

• 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-devportal status
  OK: apigee-drupal-devportal is up and running
  + apigee-service apigee-lb status
  apigee-service: apigee-lb: OK
  + apigee-service apigee-postgresql status
  apigee-service: apigee-postgresql: OK

• apachectl -S

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

  *:80
  192.168.56.102 (/etc/httpd/conf/vhosts/devportal.conf:1)

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

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

• 4.17.05 والإصدارات الأحدث: /opt/apigee/apigee-drupal/wwwroot
• قبل 4.17.05: /opt/apigee/apigee-drupal (NGINX) أو /var/www/html (Apache)

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

إصدارات الترقية المعتمدة

يتوفر إجراء الترقية هذا على إصدارات البوابة OPDK-17-01.x والإصدارات الأحدث.

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

http://yourportal.com/buildInfo

قبل التحديث

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

قبل مواصلة عملية التثبيت، عليك إنشاء نسخة احتياطية من جذر الويب الخاص بمنصة Drupal بالكامل. الدليل. بعد تنفيذ خطوات التثبيت الموضحة أدناه، يمكنك استعادة عمليات التخصيص من النسخة الاحتياطية.

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

لتعديل قيمة RPM الخاصة بالبوابة على إحدى النقاط، اتّبِع الخطوات التالية:

1. يمكنك التغيير إلى دليل Drupal، /opt/apigee/apigee-drupal تلقائيًا:

   cd /opt/apigee/apigee-drupal

2. احتفِظ بنسخة احتياطية من مثيل قاعدة بيانات Drupal. ينشئ الأمر pg_dump نسخة من قاعدة البيانات:

   pg_dump --dbname=devportal --host=host_IP_address --username=drupaladmin
     --password --format=c > /tmp/portal.dmp

   المكان:

   • devportal هو اسم قاعدة البيانات كما هو محدد بواسطة الدالة السمة PG_NAME في ملف إعدادات تثبيت البوابة.
   • host_IP_address هو عنوان IP لعقدة البوابة.
   • drupaladmin هو اسم مستخدم Postgres الذي تستخدمه البوابة للوصول إلى قاعدة البيانات على النحو المحدّد في السمة DRUPAL_PG_USER في تثبيت البوابة ملف الإعداد.

   يُطلب منك إدخال كلمة مرور مستخدم Postgres كما هو موضح من خلال السمة DRUPAL_PG_PASS في ملف إعدادات تثبيت البوابة.

   إذا أردت في وقت لاحق استعادة البيانات من النسخة الاحتياطية، استخدِم الأمر التالي:

   pg_restore --clean --dbname=devportal --host=localhost  --username=apigee < /tmp/portal.dmp

3. عليك إنشاء نسخة احتياطية من الدليل الجذري على الويب الخاص بمنصة Drupal بالكامل. موقع التثبيت التلقائي يبلغ /opt/apigee/apigee-drupal، ولكن من المحتمل أنّك غيّرته.

   إذا لم تكن متأكدًا من مكان هذا الدليل، استخدِم الأمر drush status أو التهيئة > الوسائط > إدخال ملف في قائمة Drupal لتحديد مكان نظام الملفات العام ومسار نظام الملفات الخاص (في المرحلة التالية ).

4. يمكنك الاحتفاظ بنسخة احتياطية من الملفات في /opt/apigee/data/apigee-drupal-devportal/private.
5. ضبط Drupal على وضع الصيانة:
   1. اختَر الإعدادات في قائمة Drupal.
   2. في صفحة الإعدادات، اختَر وضع الصيانة. ضمن التطوير.
   3. اختَر المربع وضع الموقع الإلكتروني في وضع الصيانة.
   4. أدخِل رسالة تظهر للمستخدمين أثناء الصيانة.
   5. اختَر حفظ الإعداد.
6. إيقاف SELinux كما هو موضح في ثبِّت الأداة المساعدة لإعداد واجهة برمجة التطبيقات Edge على Edge.
7. التغيير إلى الدليل /opt:

   cd /opt

8. بالنسبة إلى الترقية على خادم متصل بالإنترنت:
   1. قم بتنزيل ملف Edge 4.51.00 bootstrap_4.51.00.sh إلى /tmp/bootstrap_4.51.00.sh:

      curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh

   2. تثبيت الأداة المساعدة والتبعيات Edge 4.51.00 apigee-service:

      sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

      عندما يكون uName وpWord هما اسم المستخدم وكلمة المرور اللذين تلقّيتهما من Apigee. إذا لم يتم حذف pWord، سيُطلب منك إدخاله.

      بشكل تلقائي، تتحقّق أداة التثبيت من أنّك مثبّت Java 1.8. يمكنك استخدام صفحة "C" المتابعة بدون تثبيت Java.

9. بالنسبة إلى الترقية على خادم بلا اتصال بالإنترنت:
   1. إنشاء مستودع 4.51.00 محلي كما هو موضّح في إنشاء مستودع Apigee محلي
   2. لتثبيت خدمة apigee من ملف .tar:
      1. في العقدة مع المستودع المحلي، استخدم الأمر التالي لحزم أمر repo في ملف .tar واحد باسم /opt/apigee/data/apigee-mirror/apigee-4.51.00.tar.gz:

         /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

      2. انسخ ملف .tar إلى العقدة التي تريد تحديث Edge فيها. على سبيل المثال، انسخه إلى دليل /tmp في العقدة الجديدة.
      3. في العقدة الجديدة، عليك إلغاء تنزيل الملف في دليل /tmp:

         tar -xzf apigee-4.51.00.tar.gz

         ينشئ هذا الأمر دليلاً جديدًا، باسم repos، في الدليل يحتوي على الملف .tar الملف. على سبيل المثال، /tmp/repos.

      4. تثبيت أداة Edge apigee-service والتبعيات من /tmp/repos:

         sudo bash /tmp/repos/bootstrap_4.51.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

         لاحظ أنك قمت بتضمين المسار إلى دليل repos في هذا الأمر.

   3. لتثبيت خدمة apigee باستخدام خادم ويب NGINX:
      1. اضبط خادم الويب NGINX كما هو موضح في "التثبيت من المستودع باستخدام خادم ويب NGINX" في تثبيت Edge أداة إعداد apigee.
      2. في العقدة البعيدة، نزِّل ملف Edge bootstrap_4.51.00.sh من أجل /tmp/bootstrap_4.51.00.sh:

         /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.51.00.sh
           -o /tmp/bootstrap_4.51.00.sh

         حيث uName وpWord هما اسم المستخدم وكلمة المرور اللذين أعددتهما أعلاه للمستودع، وremoteRepo هو عنوان IP أو اسم نظام أسماء النطاقات عقدة repo.

      3. في العقدة البعيدة، ثبّت أداة Edge apigee-service والتبعيات:

         sudo bash /tmp/bootstrap_4.51.00.sh apigeerepohost=remoteRepo:3939
           apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

         حيث يمثل uName وpWord اسم المستخدم وكلمة المرور في Repo.

10. استخدم apigee-service لتحديث أداة apigee-setup:

    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

11. شغِّل الأداة المساعدة update على عقدة Postgres:

    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

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