تحويل بوابة مستندة إلى tar إلى بوابة تستند إلى RPM

Edge for Private Cloud الإصدار 4.19.01

لا يتيح لك الإصدار 4.18.05 من بوابة Apigee Developer Services (أو ببساطة، البوابة) تحديث إصدار سابق من البوابة يستند إلى tar. يمكنك فقط تحديث إصدار البوابة المستند إلى RPM مباشرةً إلى الإصدار 4.18.05.

ومع ذلك، يمكنك تحويل إصدار مستند إلى tar من المدخل إلى مثيل مستند إلى 4.18.05 RPM من المدخل. كجزء من هذه العملية، يمكنك نقل MySQL/MariaDB من البوابة الحالية إلى قاعدة بيانات Postgres. بعد التحويل، تظلّ بوابتك قائمة على العائد لكل ألف ظهور.

يمكنك نقل العديد من الإصدارات السابقة من البوابة المستندة إلى tar إلى بوابة مستندة إلى RPM، بما في ذلك الإصدارَين 4.16.09 و4.17.01، وليس الإصدار 4.17.05 فقط. الشرط الوحيد هو أن تكون البوابة تعمل بنظام Drupal 7 أو إصدار أحدث. للتحقّق من إصدار Drupal، اختَر التقارير > تقارير الحالة في قائمة Drupal. يظهر إصدار Drupal في الصف الأول من الناتج.

في ما يلي الخطوات العامة التي يجب اتّباعها لنقل البيانات من بوابة مستندة إلى tar إلى بوابة مستندة إلى RPM:

• ثبِّت الإصدار 4.18.05 المستند إلى RPM من المدخل على عقدة جديدة.
• أنشئ قاعدة بيانات Postgres جديدة على البوابة المستندة إلى RPM.
• انقل قاعدة بيانات البوابة من البوابة المستندة إلى tar.
• انسخ جميع ملفات الملحقات من البوابة المستندة إلى tar إلى البوابة المستندة إلى RPM.
• عدِّل إدخالات نظام أسماء النطاقات لتوجيهها إلى البوابة الجديدة المستندة إلى RPM.

  يُرجى العِلم أنّ الإصدار المستند إلى RPM من البوابة يستخدم المنفذ 8079 تلقائيًا، بينما يستخدم الإصدار المستند إلى tar المنفذ 80. تأكَّد من استخدام رقم المنفذ الصحيح في إدخال نظام أسماء النطاقات. يمكنك الاطّلاع على ضبط منفذ HTTP الذي تستخدمه البوابة للحصول على معلومات حول استخدام منفذ مختلف.

دليل التثبيت التلقائي الجديد بعد التحويل

بعد تحديث عملية تثبيت تستخدم الآن Nginx/Postgres، تم تغيير الدليل الجذري من:

/opt/apigee/apigee-drupal

إلى:

/opt/apigee/apigee-drupal/wwwroot

إجراءات تحويل البوابة

لتحويل البوابة إلى تثبيت مستند إلى RPM:

1. ثبِّت الإصدار 4.18.05 من البوابة المستندة إلى RPM على عقدة مختلفة عن البوابة المستندة إلى tar.
2. على البوابة المستندة إلى RPM، أنشئ قاعدة بيانات Postgres جديدة. بعد ذلك، يمكنك نقل قاعدة البيانات من البوابة المستندة إلى tar إلى قاعدة البيانات الجديدة هذه:
   1. سجِّل الدخول إلى psql:

      psql -h localhost -p 5432 -U apigee

      أدخِل كلمة مرور Postgres كما هو محدّد في السمة PG_PWD في ملف إعدادات المدخل.

   2. أنشئ قاعدة بيانات Postgres جديدة:

      CREATE DATABASE newportaldb;

   3. اخرج من psql:

      \q

3. على البوابة المستندة إلى tar، أزِل الوحدات القديمة التي لم تعُد مستخدَمة:

   cd /var/www/html
   drush sql-query --db-prefix "DELETE from {system} where name = 'apigee_account' AND type = 'module';"
   drush sql-query --db-prefix "DELETE from {system} where name = 'apigee_checklist' AND type = 'module';"
   drush sql-query --db-prefix "DELETE from {system} where name = 'apigee_sso_ui' AND type = 'module';"

4. على البوابة المستندة إلى tar، ثبِّت وحدة Migrator Drupal واضبطها:
   1. cd /tmp 

   2. wget https://ftp.drupal.org/files/projects/dbtng_migrator-7.x-1.4.tar.gz 

   3. gunzip /tmp/dbtng_migrator-7.x-1.4.tar.gz 

   4. tar -xvf /tmp/dbtng_migrator-7.x-1.4.tar --directory /var/www/html/sites/all/modules 

   5. سجِّل الدخول إلى البوابة بصفتك مشرفًا.
   6. اختَر Modules (الوحدات) في قائمة Drupal.
   7. فعِّل وحدة DBTNG Migrator.
   8. احفظ الإعدادات.
5. في البوابة المستندة إلى tar، عدِّل /var/www/html/sites/default/settings.php لإضافة إعداد قاعدة بيانات ثانٍ يشير إلى قاعدة البيانات التي تم إنشاؤها حديثًا في البوابة المستندة إلى RPM. يُطلق على الإعدادات الحالية لقاعدة البيانات اسم "تلقائية". أدخِل اسمًا للإعدادات الجديدة "custom"، كما هو موضّح في المثال التالي:

   $databases = array (
     'default' =>
     array (
       'default' =>
       array (
         'database' => 'devportal',
         'username' => 'devportal',
         'password' => 'devportal',
         'host' => 'localhost',
         'port' => '',
         'driver' => 'mysql',
         'prefix' => '',
       ),
     ),
     'custom' =>
     array (
       'default' =>
       array (
         'database' => 'newportaldb',
         'username' => 'apigee',
         'password' => 'postgres',
         'host' => '192.168.168.100',
         'port' => '5432',
         'driver' => 'pgsql',
         'prefix' => '',
       )
     )
   );

   حيث يحدّد host وport عنوان IP ومنفذ خادم Postgres. يستخدم Postgres المنفذ 5432 للاتصالات.

6. على البوابة المستندة إلى tar، ثبِّت برنامج تشغيل Postgres:
   1. استخدِم Yum لتثبيت برنامج التشغيل:

      yum install php-pdo_pgsql

   2. عدِّل /etc/php.ini لإضافة السطر التالي في أي مكان في الملف:

      extension=pgsql.so

   3. أعِد تشغيل Apache:

      service httpd restart

7. على البوابة المستندة إلى tar، يمكنك نقل قاعدة بيانات البوابة إلى البوابة المستندة إلى RPM:
   1. سجِّل الدخول إلى البوابة بصفتك مشرفًا.
   2. اختَر Structure->Migrator (البنية->أداة نقل البيانات) في قائمة Drupal.
   3. اختَر قاعدة البيانات المصدر على البوابة المستندة إلى tar، وهي default، وقاعدة البيانات الوجهة، وهي custom، استنادًا إلى ملف settings.php الموضّح أعلاه.
   4. انقر على نقل البيانات. يتم نقل قاعدة البيانات المستندة إلى tar إلى قاعدة البيانات المستندة إلى RPM.
8. انسخ دليل sites من الخادم المستند إلى tar إلى الخادم المستند إلى RPM. تستند المسارات الموضّحة في الخطوات التالية إلى المسارات التلقائية. ويمكنك تعديلها حسب الحاجة لعملية التثبيت.
   1. في البوابة المستندة إلى tar، اجمَع الدليل /var/www/html/sites:

      cd /var/www/html/sites
      tar -cvzf /tmp/sites.tar.gz .

   2. انسخ /tmp/sites.tar.gz إلى /opt/apigee/apigee-drupal/wwwroot/sites على الخادم المستند إلى RPM.
   3. إلغاء تجميع دليل المواقع الإلكترونية، ولكن بدون استبدال الملفات المهمة
      1. احتفِظ بنسخة احتياطية من ملف settings.php:

         sudo cp /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.php
           /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.bak.php

      2. احتفِظ بنسخة احتياطية من دليل files الحالي:

         sudo mv /opt/apigee/apigee-drupal/wwwroot/sites/default/files
           /opt/apigee/apigee-drupal/wwwroot/sites/default/files_old

      3. احتفِظ بنسخة احتياطية من دليل sites الحالي:

         tar -cvzf /tmp/sites_old.tar.gz /opt/apigee/apigee-drupal/wwwroot/sites

      4. فكّ ضغط دليل sites من الخادم المستند إلى tar:

         gunzip /opt/apigee/apigee-drupal/wwwroot/sites/sites.tar.gz
         tar -xvf /opt/apigee/apigee-drupal/wwwroot/sites/sites.tar

      5. تأكَّد من أنّ الملفات المنسوخة لها ملكية صحيحة:

         chown -R apigee:apigee /opt/apigee/apigee-drupal/wwwroot/sites/

      6. استعادة ملف settings.php:

         sudo cp /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.bak.php
           /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.php

      7. نقل الملفات الخاصة إلى موقع جديد:

         cp -r /opt/apigee/apigee-drupal/wwwroot/sites/default/files/private/* /opt/apigee/data/apigee-drupal-devportal/private
         rm -rf /opt/apigee/apigee-drupal/wwwroot/sites/default/files/private
         chown -R apigee:apigee /opt/apigee/data/apigee-sap-drupal-devportal/private

9. في البوابة المستندة إلى tar، في حال تغيير المسار إلى دليل جذر الويب في البوابة المستندة إلى tar من المسار التلقائي ‎ /var/www/html: شغِّل drush status وابحث عن مسار files ومسار private files:

   cd /var/www/html
   drush status

   إذا لم تكن الملفات/الملفات الخاصة ضمن دليل sites، انسخها إلى الخادم المستند إلى RPM كما هو موضّح أعلاه.

10. في البوابة المستندة إلى RPM، عدِّل /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.php لضبط خصائص قاعدة البيانات التلقائية:

    vi /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.php

    اضبط وصف قاعدة البيانات التلقائي في settings.php:

    $databases = array (
      'default' =>
      array (
        'default' =>
        array (
          'database' => 'newportaldb',
          'username' => 'apigee',
          'password' => 'postgres',
          'host' => 'localhost', 'port' => '5432',
          'driver' => 'pgsql',
          'prefix' => '',
        )
      )
    );

    حيث يحدّد database قاعدة البيانات الجديدة التي أنشأتها، وusername وpassword كما تم تحديدهما لقاعدة البيانات المخصّصة على البوابة المستندة إلى tar، وprefix فارغ.

11. في البوابة المستندة إلى RPM، يحتوي الإصدار المستند إلى RPM من البوابة على عدد أقل من وحدات Drupal مقارنةً بالإصدار المستند إلى tar. بعد نقل البيانات إلى البوابة المستندة إلى RPM، عليك التحقّق من أي وحدات مفقودة وتثبيتها حسب الحاجة.
    1. ثبِّت Drupal missing_module المستخدَم لرصد الوحدات غير المتوفّرة:

       cd /opt/apigee/apigee-drupal/wwwroot
       drush dl missing_module
       drush en missing_module

    2. سجِّل الدخول إلى البوابة المستندة إلى RPM بصفتك مشرفًا.
    3. اختَر التقارير > تقارير الحالة في قائمة Drupal وابحث عن أي وحدات مفقودة.
    4. استخدِم هذا التقرير لتثبيت أي وحدات مفقودة، أو استخدِم الأوامر التالية:

       cd /opt/apigee/apigee-drupal/wwwroot
       drush dl <moduleA> <moduleB> ...
       drush en <moduleA> <moduleB> ...

    5. بعد تفعيل جميع الوحدات، تأكَّد من أنّ الملفات مملوكة لمستخدم apigee:

       chown -LR apigee:apigee /opt/apigee/apigee-drupal/wwwroot

       لمزيد من المعلومات حول أذونات الملفات، يُرجى الاطّلاع على https://www.drupal.org/node/244924.

12. على البوابة المستندة إلى RPM، شغِّل update.php في متصفّح لإزالة أي أخطاء في الوحدات غير المتوفّرة:
    1. سجِّل الدخول إلى البوابة المستندة إلى RPM بصفتك مشرفًا.
    2. في المتصفّح، انتقِل إلى عنوان URL التالي:

       http://portal_IP_or_DNS:8079/update.php

       حيث يمثّل portal_IP_or_DNS عنوان IP أو اسم النطاق للبوابة المستندة إلى RPM.

    3. اتّبِع التعليمات الظاهرة على الشاشة.
13. عدِّل إدخالات نظام أسماء النطاقات لتوجيهها إلى البوابة الجديدة المستندة إلى RPM.
    

    يُرجى العِلم أنّ الإصدار المستند إلى RPM من البوابة يستخدم المنفذ 8079 تلقائيًا، بينما يستخدم الإصدار المستند إلى tar المنفذ 80. تأكَّد من استخدام رقم المنفذ الصحيح في إدخال نظام أسماء النطاقات. يمكنك الاطّلاع على ضبط منفذ HTTP الذي تستخدمه البوابة للحصول على معلومات حول استخدام منفذ مختلف.

اكتملت عملية التحويل.