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

الإصدار 4.18.05 من Edge for Private Cloud

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

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

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

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

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

  • 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
  • OPDK-17-05.x
  • OPDK-17-09.x
  • OPDK-18-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.18.05 bootstrap_4.18.05.sh من أجل /tmp/bootstrap_4.18.05.sh: 
      curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
    2. ثبّت الأداة المساعدة والتبعيات apigee-service على Edge 4.18.05: 
      sudo bash /tmp/bootstrap_4.18.05.sh apigeeuser=uName apigeepassword=pWord

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

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

  9. بالنسبة إلى الترقية على خادم بلا اتصال بالإنترنت:
    1. أنشئ مستودعًا محليًا للإصدار 4.18.05 كما هو موضَّح في إنشاء مستودع Apigee محلي
    2. لتثبيت خدمة apigee من ملف .tar:
      1. في العقدة مع المستودع المحلي، استخدم الأمر التالي لحزم أمر repo في ملف .tar واحد باسم /opt/apigee/data/apigee-mirror/apigee-4.18.05.tar.gz: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
      2. انسخ ملف .tar إلى العقدة التي تريد تحديث Edge فيها. على سبيل المثال، انسخه إلى دليل /tmp في العقدة الجديدة.
      3. في العقدة الجديدة، عليك إلغاء تنزيل الملف في دليل /tmp: 
        tar -xzf apigee-4.18.05.tar.gz

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

      4. تثبيت أداة Edge apigee-service والتبعيات من /tmp/repos: 
        sudo bash /tmp/repos/bootstrap_4.18.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

    3. لتثبيت خدمة apigee باستخدام خادم ويب Nginx:
      1. قم بتهيئة خادم الويب Nginx كما هو موضح في "التثبيت من المستودع باستخدام خادم ويب Nginx" في تثبيت Edge أداة إعداد apigee.
      2. في العقدة البعيدة، نزِّل ملف Edge bootstrap_4.18.05.sh من أجل /tmp/bootstrap_4.18.05.sh: 
        /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.05.sh
  -o /tmp/bootstrap_4.18.05.sh

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

      3. في العقدة البعيدة، ثبّت أداة Edge apigee-service والتبعيات: 
        sudo bash /tmp/bootstrap_4.18.05.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. شغِّل أداة التحديث في عقدة Postgre: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

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

  12. عدِّل قاعدة بيانات Postgres: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  13. شغِّل أداة التحديث على العُقدة لتعديل البوابة: 
    /opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile

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

  14. يمكنك تشغيل نص Drupal النصي update.php من خلال فتح عنوان URL التالي في نافذة متصفّح: 
    http://portal_IP_DNS:8079/update.php
  15. إيقاف استخدام Drupal في وضع الصيانة:
    1. اختَر الإعدادات في قائمة Drupal.
    2. في صفحة الإعدادات، اختَر وضع الصيانة. ضمن التطوير.
    3. أزِل العلامة من المربّع وضع الموقع الإلكتروني في وضع الصيانة.
    4. اختَر حفظ الإعداد.

لاحظ أن الدليل الجذري بعد التحديث هو:

/opt/apigee/apigee-drupal/wwwroot

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