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

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

لا يتيح لك الإصدار 4.17.09 من بوابة "خدمات المطوّرين" تحديث إصدار سابق من البوابة يستند إلى ملف tar. يمكنك فقط تحديث إصدار البوابة المستند إلى RPM مباشرةً إلى الإصدار 4.17.09.

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

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

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

  • ثبِّت الإصدار 4.17.09 المستند إلى RPM من بوابة Developer Service على عقدة جديدة.
  • أنشئ قاعدة بيانات 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.17.09 المستند إلى RPM من بوابة Developer Service على عقدة مختلفة عن بوابتك المستندة إلى 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. يُطلق على إعداد قاعدة البيانات الحالي اسم "تلقائي". أدخِل اسمًا للإعدادات الجديدة المخصّصة:
    $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. انسخ دليل المواقع الإلكترونية من الخادم المستند إلى 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. احتفِظ بنسخة احتياطية من دليل الملفات الحالي:
        > sudo mv /opt/apigee/apigee-drupal/wwwroot/sites/default/files /opt/apigee/apigee-drupal/wwwroot/sites/default/files_old
      3. احتفِظ بنسخة احتياطية من دليل المواقع الإلكترونية الحالي:
        > tar -cvzf /tmp/sites_old.tar.gz /opt/apigee/apigee-drupal/wwwroot/sites
      4. فك ضغط دليل المواقع من الخادم المستند إلى 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' => '',
        )
      )
    );
    حيث تحدّد قاعدة البيانات قاعدة البيانات الجديدة التي أنشأتها، واسم المستخدم وكلمة المرور كما هو محدّد لقاعدة البيانات المخصّصة على البوابة المستندة إلى tar، والبادئة فارغة.
  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 الذي تستخدمه البوابة للحصول على معلومات حول استخدام منفذ مختلف.

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