此页面由 Cloud Translation API 翻译。

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

适用于私有云的 Edge v4.19.01

4.18.05 版 Apigee Developer Services 门户（简称为门户）不支持更新旧版基于 tar 版本的门户。您只能直接更新基于 RPM 的门户版本至 4.18.05。

不过，您可以将基于 tar 的门户版本转换为基于 4.18.05 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.05 版的新节点。
在基于 RPM 的门户上创建一个新的 Postgres 数据库。
从基于 tar 的门户迁移门户数据库。
从基于 tar 的门户将所有配件文件复制到基于 RPM 的。
更新 DNS 条目以指向基于 RPM 的新门户。
请注意，基于 RPM 的门户版本默认使用端口 8079，而基于 tar 的门户版本使用端口 80确保您在 DNS 条目中使用了正确的端口号。请参阅如需了解相关信息，请设置门户使用的 HTTP 端口另一个端口上的问题

新的默认安装目录位于转化

更新现在使用 Nginx/Postgres 的安装后，根目录已更改发件人：

/opt/apigee/apigee-drupal

to:

/opt/apigee/apigee-drupal/wwwroot

门户转换流程

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

将基于 RPM 的 4.18.05 版本的门户安装在与基于 tar 的不同节点上。
在基于 RPM 的门户上，创建一个新的 Postgres 数据库。稍后，您需要将数据库从基于 tar 的门户迁移到此新数据库： <ph type="x-smartling-placeholder">
1. 登录 psql：
```
psql -h localhost -p 5432 -U apigee
```
  输入门户配置中的 PG_PWD 属性所定义的 Postgres 密码文件。
2. 创建新的 Postgred 数据库：
```
CREATE DATABASE newportaldb;
```
3. 退出 psql：
```
\q
```

在基于 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';"

在基于 tar 的门户上，安装并配置 Migrator Drupal 模块： <ph type="x-smartling-placeholder">
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 菜单中选择 Modules。
7. 启用 DBTNG Migrator 模块。
8. 保存配置。

在基于 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 服务器。Postgres 使用端口 5432 进行连接。

在基于 tar 的门户上，安装 Postgres 驱动程序： <ph type="x-smartling-placeholder">
1. 使用 Yum 安装驱动程序：
```
yum install php-pdo_pgsql
```
2. 修改 /etc/php.ini 以将以下代码行添加到该文件中的任意位置：
```
extension=pgsql.so
```
3. 重启 Apache：
```
service httpd restart
```
在基于 tar 的门户上，将门户数据库迁移到基于 RPM 的门户门户： <ph type="x-smartling-placeholder">
1. 以管理员身份登录门户。
2. 在 Drupal 菜单中，依次选择 Structure->Migrator。
3. 在基于 tar 的门户 default 上选择您的源数据库，然后目标数据库 custom，基于显示的 settings.php 文件。
4. 点击迁移。基于 tar 的数据库迁移到基于 RPM 的数据库数据库。

将 sites 目录从基于 tar 的服务器复制到基于 RPM 的服务器。通过以下步骤中显示的路径基于默认路径。根据需要进行修改安装。

在基于 tar 的门户上，捆绑 /var/www/html/sites 目录：
```
cd /var/www/html/sites
tar -cvzf /tmp/sites.tar.gz .
```
将“/tmp/sites.tar.gz”复制到 /opt/apigee/apigee-drupal/wwwroot/sites（在基于 RPM 的服务器上）。

取消捆绑网站目录，但不覆盖重要文件。

备份 settings.php 文件：

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

备份现有的 files 目录：

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

备份现有的 sites 目录：

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

从基于 tar 的服务器中解压缩 sites 目录：

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

确保复制的文件具有正确的所有权：

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

恢复 settings.php 文件：

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

将私密文件移至新位置：

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

在基于 tar 的门户上（前提是您更改了网络根目录的路径）目录（位于基于 tar 的门户上的 /var/www/html 的默认路径下）：run drush status，然后查看 files 路径和 private files 路径：
```
cd /var/www/html
drush status
```
如果文件/私有文件不在 sites 目录下，请将它们复制到基于 RPM 的服务器，如上所示。

在基于 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 为空。

在基于 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. 选择报告 >状态报告，并检查任何缺失的模块。
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.
在基于 RPM 的门户上，在浏览器中运行 update.php 以移除所有错误缺失的模块： <ph type="x-smartling-placeholder">
1. 以管理员身份登录基于 RPM 的门户。
2. 在浏览器中，转到以下网址：
```
http://portal_IP_or_DNS:8079/update.php
```
  其中 portal_IP_or_DNS 是基于 RPM 的。
3. 按照屏幕提示操作。
更新 DNS 条目，使其指向基于 RPM 的新门户。

请注意，基于 RPM 的门户版本默认使用端口 8079，而基于 tar 的门户版本使用端口 80确保您在 DNS 条目中使用了正确的端口号。请参阅设置门户使用的 HTTP 端口，以了解其他端口

转换已完成。

对于基于 RPM 的新软件包，如果文件内容 settings.php 就是与基于 tar 的门户不同，您需要更新

/opt/apigee/apigee-drupal-devportal-opdk_version/source/conf/settings.php

并防止将其恢复为旧设置。

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

新的默认安装目录位于 转化

门户转换流程

新的默认安装目录位于转化