تبدیل درگاه مبتنی بر tar به درگاه مبتنی بر RPM

Edge for Private Cloud نسخه ۴.۱۷.۰۹

نسخه ۴.۱۷.۰۹ درگاه «سرویس‌های توسعه‌دهنده» به شما اجازه نمی‌دهد نسخه قبلی درگاه را که مبتنی بر tar است به‌روز کنید. فقط می‌توانید نسخه مبتنی بر RPM درگاه را مستقیماً به نسخه ۴.۱۷.۰۹ به‌روز کنید.

بااین‌حال، می‌توانید نسخه مبتنی بر tar پورتال را به نمونه مبتنی بر RPM نسخه ۴.۱۷.۰۹ پورتال تبدیل کنید. به‌عنوان بخشی از این فرایند، MySQL/MariaDB پورتال موجود را به پایگاه داده Postgres منتقل می‌کنید. پس‌از تبدیل، درگاه شما به‌عنوان درگاه مبتنی بر «درآمد به‌ازای هر هزار بازدید» باقی می‌ماند.

می‌توانید بسیاری از نسخه‌های قبلی درگاه مبتنی بر tar را به درگاه مبتنی بر RPM منتقل کنید، ازجمله نسخه‌های ۴.۱۶.۰۹ و ۴.۱۷.۰۱، نه فقط نسخه ۴.۱۷.۰۵. تنها شرط این است که پرتال Drupal 7 یا بالاتر را اجرا کند. برای بررسی نسخه Drupal، در منو Drupal، گزارش‌ها > گزارش‌های وضعیت را انتخاب کنید. نسخه Drupal در ردیف اول خروجی نشان داده می‌شود.

مراحل سطح بالایی که برای انتقال از درگاه مبتنی بر tar به درگاه مبتنی بر RPM استفاده می‌کنید عبارتند از:

  • نسخه RPM-based 4.17.09 از درگاه Developer Service را در گره جدیدی نصب کنید.
  • پایگاه داده Postgres جدیدی در درگاه مبتنی بر RPM ایجاد کنید.
  • پایگاه داده درگاه را از درگاه مبتنی بر tar انتقال دهید.
  • همه فایل‌های جانبی را از درگاه مبتنی بر tar به درگاه مبتنی بر RPM کپی کنید.
  • ورودی‌های ساناد را به‌روز کنید تا به درگاه جدید مبتنی بر RPM اشاره کنند.

    توجه داشته باشید که نسخه مبتنی بر RPM پورتال به‌طور پیش‌فرض از درگاه ۸۰۷۹ استفاده می‌کند، درحالی‌که نسخه مبتنی بر tar از درگاه ۸۰ استفاده می‌کند. مطمئن شوید از شماره درگاه صحیح در ورودی ساناد استفاده می‌کنید. برای اطلاعات بیشتر درباره استفاده از درگاه متفاوت، به تنظیم درگاه 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. ایجاد پایگاه داده Postgred جدید:
      # 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 اشاره می‌کند. نام پیکربندی پایگاه داده فعلی default است. نام‌گذاری پیکربندی جدید سفارشی:
    $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' => '',
            )
          )
        );

    که در آن میزبان و درگاه نشانی IP و درگاه سرور Postgres را مشخص می‌کنند. Postgres از درگاه ۵۴۳۲ برای اتصالات استفاده می‌کند.
  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، پیش‌فرض، و پایگاه داده مقصد، سفارشی، را براساس فایل 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. Backup existing files directory:
        > 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. Unzip and untar the sites directory from the tar-based server:
        > 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. Move private files to new location:
        > 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


    اگر files/private files در دایرکتوری sites نیستند، آن‌ها را همان‌طور که در بالا نشان داده شده است در سرور مبتنی بر RPM کپی کنید.
  10. On the RPM-based portal, update /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.php to set the properties of the default database:
    > vi /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.php

    Set the default database description in 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. در مرورگر، به نشانی وب زیر بروید:
      http://{portal_IP_or_DNS}:8079/update.php

      که در آن portal_IP_or_DNS نشانی IP یا نام دامنه درگاه مبتنی بر RPM است.
    3. پیام‌واره‌های روی صفحه را دنبال کنید.
  13. ورودی‌های ساناد را به‌روز کنید تا به درگاه جدید مبتنی بر RPM شما اشاره کنند.

    توجه داشته باشید که نسخه مبتنی بر RPM پورتال به‌طور پیش‌فرض از درگاه ۸۰۷۹ استفاده می‌کند، درحالی‌که نسخه مبتنی بر tar از درگاه ۸۰ استفاده می‌کند. مطمئن شوید از شماره درگاه صحیح در ورودی ساناد استفاده می‌کنید. برای اطلاعات درباره استفاده از درگاه دیگر، تنظیم درگاه HTTP مورداستفاده پورتال را ببینید.

تبدیل کامل شد.