Chuyển đổi cổng dựa trên tar sang cổng dựa trên RPM

Edge for Private Cloud phiên bản 4.18.01

Bản phát hành 4.18.01 của cổng Dịch vụ dành cho nhà phát triển không cho phép bạn cập nhật phiên bản dựa trên tar của cổng thông tin. Bạn chỉ có thể trực tiếp cập nhật phiên bản cổng thông tin dựa trên RPM đến 4.18.01.

Tuy nhiên, bạn có thể chuyển đổi phiên bản dựa trên tar của cổng thông tin sang phiên bản dựa trên 4.18.01 RPM của cổng thông tin. Trong quá trình này, bạn di chuyển MySQL/MariaDB của cổng thông tin hiện có sang Cơ sở dữ liệu Postgres. Sau khi chuyển đổi, cổng thông tin của bạn vẫn hoạt động như một cổng thông tin dựa trên RPM.

Bạn có thể di chuyển nhiều phiên bản trước đó của cổng thông tin dựa trên tar sang cổng dựa trên RPM, bao gồm cả các phiên bản 4.16.09 và 4.17.01 chứ không chỉ riêng bản 4.17.05. Yêu cầu duy nhất là cổng thông tin đang chạy Drupal 7 trở lên. Để kiểm tra phiên bản Drupal của bạn, hãy chọn Báo cáo > Báo cáo trạng thái trong trình đơn Drupal. Phiên bản Drupal xuất hiện ở hàng đầu tiên của đầu ra.

Các bước cấp cao mà bạn sử dụng để di chuyển từ cổng thông tin dựa trên tar sang cổng thông tin dựa trên RPM là:

  • Cài đặt phiên bản 4.18.01 dựa trên RPM của cổng Dịch vụ dành cho nhà phát triển trên nút mới.
  • Tạo cơ sở dữ liệu Postgres mới trên cổng thông tin dựa trên RPM.
  • Di chuyển cơ sở dữ liệu cổng thông tin từ cổng thông tin dựa trên tar.
  • Sao chép tất cả tệp phụ kiện từ cổng thông tin dựa trên tar sang cổng dựa trên RPM cổng thông tin.
  • Cập nhật các mục nhập DNS để trỏ đến cổng thông tin mới dựa trên RPM.

    Xin lưu ý rằng phiên bản dựa trên RPM của cổng thông tin sử dụng cổng 8079 theo mặc định, trong khi phiên bản dựa trên tar sử dụng cổng 80. Đảm bảo bạn sử dụng đúng số cổng trong mục nhập DNS. Hãy xem phần Đặt cổng HTTP mà cổng thông tin sử dụng để biết thông tin khi sử dụng một cổng khác.

Thư mục cài đặt mặc định mới sau lượt chuyển đổi

Sau khi cập nhật bản cài đặt hiện sử dụng Nginx/Postgres, thư mục gốc đã thay đổi từ:

/opt/apigee/apigee-drupal

đến:

/opt/apigee/apigee-drupal/wwwroot

Quy trình chuyển đổi cổng thông tin

Cách chuyển đổi cổng thông tin sang chế độ cài đặt dựa trên RPM:

  1. Cài đặt phiên bản 4.18.01 dựa trên RPM của cổng Dịch vụ dành cho nhà phát triển trên một nút khác từ cổng thông tin dựa trên tar.
  2. Trên cổng thông tin dựa trên RPM, hãy tạo một cơ sở dữ liệu Postgres mới. Sau đó, bạn di chuyển cơ sở dữ liệu từ cổng thông tin dựa trên tar đến cơ sở dữ liệu mới này:
    1. Đăng nhập vào psql:
      >psql -h localhost -p 5432 -U API

      Nhập mật khẩu Postgres của bạn theo xác định của thuộc tính PG_PWD trong cấu hình cổng thông tin .
    2. Tạo cơ sở dữ liệu Postgred mới:
      # TẠO CƠ SỞ DỮ LIỆU newportaldb;
    3. Thoát psql:
      # \q

  3. Trên cổng thông tin dựa trên tar, hãy xoá những mô-đun cũ không còn sử dụng nữa:
    > cd /var/www/html
    > drush sql-query --db-prefix "DELETE from {system} trong đó name = 'apigee_account' VÀ loại = 'module';"
    > drush sql-query --db-prefix "DELETE from {system} trong đó name = 'apigee_Danh sách kiểm tra' Loại AND = 'module';"
    > drush sql-query --db-prefix "DELETE from {system} trong đó name = 'apigee_sso_ui' VÀ type = 'module';"

  4. Trên cổng thông tin dựa trên tar, hãy Cài đặt và định cấu hình Migrator Drupal mô-đun:

    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. Đăng nhập vào cổng thông tin với tư cách là quản trị viên.
    6. Chọn Modules (Mô-đun) trong trình đơn Drupal.
    7. Bật mô-đun Trình di chuyển DBTNG.
    8. Lưu cấu hình.
  5. Trên cổng thông tin dựa trên tar, hãy chỉnh sửa /var/www/html/sites/default/settings.php thành thêm cấu hình cơ sở dữ liệu thứ hai trỏ đến cơ sở dữ liệu mới tạo trên cơ sở dữ liệu RPM cổng thông tin. Cấu hình cơ sở dữ liệu hiện tại được đặt tên là mặc định. Đặt tên cho cấu hình mới tùy chỉnh:
    $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' => '',
        )
      )
    );

    trong đó máy chủ lưu trữ và cổng chỉ định địa chỉ IP và cổng của máy chủ Postgres. Postgres sử dụng cổng 5432 cho các kết nối.
  6. Trên cổng thông tin dựa trên tar, hãy cài đặt trình điều khiển Postgres:
    1. Sử dụng Yum để cài đặt trình điều khiển:
      > cài đặt ngon lành php-pdo_pgsql
    2. Chỉnh sửa /etc/php.ini thành thêm dòng sau vào một vị trí bất kỳ trong tệp:
      extension=pgsql.so
    3. Khởi động lại Apache:
      > dịch vụ httpd khởi động lại
  7. Trên cổng thông tin dựa trên tar, di chuyển cơ sở dữ liệu cổng thông tin sang cơ sở dữ liệu dựa trên RPM cổng thông tin:
    1. Đăng nhập vào cổng thông tin với tư cách là quản trị viên.
    2. Chọn Structure (Cấu trúc) –> Misgrator (Trình di chuyển) trong trình đơn Drupal.
    3. Chọn cơ sở dữ liệu gốc trên cổng thông tin dựa trên tar, mặc định và cơ sở dữ liệu đích. custom, dựa trên Đã hiện tệp settings.php ở trên.
    4. Nhấp vào Di chuyển. Cơ sở dữ liệu dựa trên tar được di chuyển sang cơ sở dữ liệu dựa trên RPM cơ sở dữ liệu.
  8. Sao chép thư mục sites từ máy chủ dựa trên tar đến máy chủ dựa trên RPM.
    Đường dẫn hiển thị trong các bước sau dựa trên đường dẫn mặc định. Sửa đổi chúng nếu cần cho cài đặt của bạn.
    1. Trên cổng thông tin dựa trên tar, hãy đóng gói thư mục /var/www/html/sites:
      > cd /var/www/html/sites
      > tar -cvzf /tmp/sites.tar.gz .
    2. Sao chép /tmp/sites.tar.gz tới /opt/apigee/apigee-drupal/wwwroot/sites trên máy chủ dựa trên RPM.
    3. Bỏ nhóm thư mục trang web nhưng không ghi đè các tệp quan trọng.
      1. Sao lưu tệp settings.php:
        > Sudo cp /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.php /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.bak.php
      2. Sao lưu thư mục tệp hiện có:
        > lời nhắc xuất hiện /opt/apigee/apigee-drupal/wwwroot/sites/default/files /opt/apigee/apigee-drupal/wwwroot/sites/default/files_old
      3. Sao lưu thư mục trang web hiện có:
        > tar – cvzf /tmp/sites_old.tar.gz /opt/apigee/apigee-drupal/wwwroot/sites
      4. Giải nén và giải nén thư mục sites (trang web) từ thư mục dựa trên tar máy chủ:
        > gunzip /opt/apigee/apigee-drupal/wwwroot/sites/sites.tar.gz

        > tar -xvf /opt/apigee/apigee-drupal/wwwroot/sites/sites.tar
      5. Đảm bảo các tệp được sao chép có quyền sở hữu thích hợp:
        > chown -R apigee:apigee /opt/apigee/apigee-drupal/wwwroot/sites/
      6. Khôi phục tệp settings.php:
        > Sudo cp /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.bak.php /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.php
      7. Di chuyển các tệp riêng tư sang vị trí mới:
        > 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. Trên cổng thông tin dựa trên tar, chỉ khi bạn thay đổi đường dẫn đến thư mục gốc web thư mục trên cổng thông tin dựa trên tar từ đường dẫn mặc định của /var/www/html: chạy drush status và xem đường dẫn tệp và đường dẫn tệp riêng tư:
    > cd /var/www/html
    > trạng thái drush

    Nếu các tệp/tệp riêng tư không nằm trong thư mục trang web, hãy sao chép các tệp/tệp đó vào thư mục dựa trên RPM máy chủ như đã hiển thị ở trên.
  10. Trên cổng thông tin dựa trên RPM, hãy cập nhật /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.php để đặt các thuộc tính của cơ sở dữ liệu mặc định:
    > vi /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.php

    Đặt nội dung mô tả cơ sở dữ liệu mặc định trong settings.php:
    $databases = array (
      'default' =>
      array (
        'default' =>
        array (
          'database' => 'newportaldb',
          'username' => 'apigee',
          'password' => 'postgres',
          'host' => 'localhost', 'port' => '5432',
          'driver' => 'pgsql',
          'prefix' => '',
        )
      )
    );

    trong đó database chỉ định cơ sở dữ liệu mới mà bạn đã tạo, username và password được xác định cho cơ sở dữ liệu tuỳ chỉnh trên cổng thông tin dựa trên tar và tiền tố đang trống.
  11. Trên cổng thông tin dựa trên RPM, phiên bản dựa trên RPM của cổng chứa ít hơn Các mô-đun Drupal so với phiên bản dựa trên tar. Sau khi di chuyển sang cổng dựa trên RPM, bạn phải kiểm tra xem có mô-đun nào bị thiếu không và cài đặt chúng nếu cần.
    1. Cài đặt missing_module của Drupal dùng để phát hiện trường hợp bị thiếu mô-đun:
      > cd /opt/apigee/apigee-drupal/wwwroot
      > drush dl missing_module
      > drush en missing_module
    2. Đăng nhập vào cổng dựa trên RPM với tư cách là quản trị viên.
    3. Chọn Báo cáo > Báo cáo trạng thái trong trình đơn Drupal và kiểm tra bất kỳ mô-đun bị thiếu nào.
    4. Hãy dùng báo cáo đó để cài đặt các mô-đun còn thiếu hoặc dùng các lệnh sau:
      > cd /opt/apigee/apigee-drupal/wwwroot
      &gt; drush dl <moduleA> &lt;moduleB&gt; ...
      &gt; drush en <moduleA> &lt;moduleB&gt; ...
    5. Sau khi bạn bật tất cả các mô-đun, hãy đảm bảo các tệp thuộc quyền sở hữu của API người dùng:
      &gt; chown -LR apigee:apigee /opt/apigee/apigee-drupal/wwwroot

      Để biết thêm thông tin về quyền đối với tệp, hãy truy cập vào https://www.drupal.org/node/244924.
  12. Trên cổng thông tin dựa trên RPM, hãy chạy update.php trong trình duyệt để xóa mọi lỗi trên đó mô-đun bị thiếu:
    1. Đăng nhập vào cổng dựa trên RPM với tư cách là quản trị viên.
    2. Trong trình duyệt, hãy chuyển đến URL sau:
      http://{portal_IP_or_DNS}:8079/update.php

      trong đó portal_IP_or_DNS là địa chỉ IP hoặc tên miền của Cổng thông tin dựa trên RPM.
    3. Làm theo lời nhắc trên màn hình.
  13. Cập nhật các mục nhập DNS để trỏ đến cổng dịch vụ dựa trên RPM mới của bạn.

    Xin lưu ý rằng phiên bản dựa trên RPM của cổng thông tin sử dụng cổng 8079 theo mặc định, trong khi phiên bản dựa trên tar sử dụng cổng 80. Đảm bảo bạn sử dụng đúng số cổng trong mục nhập DNS. Hãy xem phần Đặt cổng HTTP mà cổng thông tin sử dụng để biết thông tin về thông qua một cổng khác.

Quá trình chuyển đổi đã hoàn tất.