将基于 tar 的门户转换为基于 RPM 的门户

Edge for Private Cloud v4.18.01

开发者服务门户的 4.18.01 版本不允许您更新之前基于 tar 的门户版本。您只能将基于 RPM 的门户版本直接更新到 4.18.01。

但是，您可以将基于 tar 的门户版本转换为基于 4.18.01 RPM 的门户实例。在此过程中，您需要将现有门户的 MySQL/MariaDB 迁移到 Postgres 数据库。转换后，您的门户仍是基于 RPM 的门户。

您可以将许多先前版本的基于 tar 的门户迁移到基于 RPM 的门户，包括 4.16.09 和 4.17.01 版本，而不仅仅是 4.17.05 版本。唯一的要求是门户运行 Drupal 7 或更高版本。如需查看您的 Drupal 版本，请在 Drupal 菜单中依次选择报告 > 状态报告。Drupal 的版本会显示在输出的第一行中。

从基于 tar 的门户迁移到基于 RPM 的门户的简要步骤如下：

• 在新节点上安装基于 RPM 的 4.18.01 版本的开发者服务门户。
• 在基于 RPM 的门户上创建新的 Postgres 数据库。
• 从基于 tar 的门户迁移门户数据库。
• 将所有附属文件从基于 tar 的门户复制到基于 RPM 的门户。
• 更新 DNS 条目，使其指向新的基于 RPM 的门户。
  
  请注意，基于 RPM 的门户版本默认使用端口 8079，而基于 tar 的版本使用端口 80。请确保在 DNS 条目中使用正确的端口号。如需了解如何使用其他端口，请参阅设置门户使用的 HTTP 端口。

转换后的新默认安装目录

更新现在使用 Nginx/Postgres 的安装后，根目录从以下位置更改：

/opt/apigee/apigee-drupal

更改为：

/opt/apigee/apigee-drupal/wwwroot

门户转换过程

如需将门户转换为基于 RPM 的安装，请执行以下操作：

1. 在与基于 tar 的门户不同的节点上安装基于 RPM 的 4.18.01 版开发者服务门户。
2. 在基于 RPM 的门户上，创建一个新的 Postgres 数据库。稍后，您将数据库从基于 tar 的门户迁移到此新数据库：
   1. 登录 psql：
      >psql -h localhost -p 5432 -U apigee
      
      输入门户配置文件中 PG_PWD 属性定义的 Postgres 密码。
   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. 在 Drupal 菜单中选择模块。
   7. 启用 DBTNG Migrator 模块。
   8. 保存配置。
5. 在基于 tar 的门户上，修改 /var/www/html/sites/default/settings.php，以添加指向基于 RPM 的门户上新创建的数据库的第二个数据库配置。当前数据库配置名为 default。将新配置命名为 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 指定 Postgres 服务器的 IP 地址和端口。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. 在 Drupal 菜单中选择结构 -> 迁移工具。
   3. 根据上面显示的 settings.php 文件，在基于 tar 的门户上选择源数据库 default，并选择目标数据库 custom。
   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 复制到基于 RPM 的服务器上的 /opt/apigee/apigee-drupal/wwwroot/sites。
   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. 从基于 tar 的服务器中解压缩 sites 目录：
         > 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 的门户上的 Web 根目录路径从默认路径 /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. 在浏览器中，前往以下网址：
       http://{portal_IP_or_DNS}:8079/update.php
       
       其中，portal_IP_or_DNS 是基于 RPM 的门户的 IP 地址或域名。
    3. 按照屏幕提示操作。
13. 更新 DNS 条目，使其指向新的基于 RPM 的门户。
    
    请注意，基于 RPM 的门户版本默认使用端口 8079，而基于 tar 的版本使用端口 80。请确保在 DNS 条目中使用正确的端口号。如需了解如何使用其他端口，请参阅设置门户使用的 HTTP 端口。

转换已完成。