このページは Cloud Translation API によって翻訳されました。

tar ベースのポータルを RPM ベースのポータルに変換する

4.18.05 リリースの Apigee Developer Services ポータル（略して「ポータル」）では、以前の tar ベースのポータルを更新することはできません。RPM ベースのポータルを直接 4.18.05 に更新する方法しかありません。

ただし、tar ベースのポータルを 4.18.05 RPM ベースのポータルインスタンスに変換できます。このプロセスの一環として、既存のポータルの MySQL/MariaDB を Postgres データベースに移行します。変換されたポータルは、RPM ベースのポータルとして残ります。

tar ベースのポータルは、4.17.05 だけでなく 4.16.09 や 4.17.01 など、旧バージョンの多くを RPM ベースのポータルに移行できます。唯一の要件は、そのポータルで Drupal 7 以降が実行されていることです。Drupal のバージョンを確認するには、Drupal メニューで [Reports] > [Status Reports] を選択します。Drupal のバージョンは出力の先頭行に表示されます。

tar ベースのポータルを RPM ベースのポータルに移行する大まかな手順は次のとおりです。

RPM ベースの 4.18.05 バージョンのポータルを新しいノードにインストールします。
RPM ベースのポータルで新しい Postgres データベースを作成します。
tar ベースのポータルからポータルデータベースを移行します。
tar ベースのポータルからすべてのアクセサリファイルを RPM ベースのポータルにコピーします。
新しい RPM ベースのポータルを指すように DNS エントリを更新します。
デフォルトのポート番号が 8079 であるのに対し、tar ベースのポータルはポート 80 を使用します。DNS エントリで必ず正しいポート番号を使用してください。別のポートを使用する方法については、ポータルで使用する HTTP ポートを設定するをご覧ください。

変換後の新しいデフォルトインストールディレクトリ

インストール済みのポータルを更新して Nginx/Postgres を使用するように変更すると、ルートディレクトリも変わります。変更前のディレクトリは以下のとおりです。

/opt/apigee/apigee-drupal

これを、次のように変更します。

/opt/apigee/apigee-drupal/wwwroot

ポータル変換手順

ポータルを RPM ベースのインストールに変換するには:

RPM ベースの 4.18.05 バージョンのポータルを tar ベースのポータルとは異なるノードにインストールします。
RPM ベースのポータルで、新しい Postgres データベースを作成します。後で、tar ベースのポータルのデータベースをこの新しいデータベースに移行します。
1. psql にログインします。
```
psql -h localhost -p 5432 -U apigee
```
  ポータル構成ファイルの PG_PWD プロパティで定義されている Postgres パスワードを入力します。
2. 新しい Postgres データベースを作成します。
```
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 モジュールをインストールして構成します。
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 ベースのポータルに新しく作成したデータベースを指す 2 つ目のデータベース構成を追加します。現在のデータベース構成の名前は「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 を使用します。
tar ベースのポータルで、Postgres ドライバをインストールします。
1. Yum を使用してドライバをインストールします。
```
yum install php-pdo_pgsql
```
2. /etc/php.ini をエディタで開き、次の行をファイルの任意の場所に追加します。
```
extension=pgsql.so
```
3. Apache を再起動します。
```
service httpd restart
```
tar ベースのポータルで、ポータルデータベースを RPM ベースのポータルに移行します。
1. 管理者としてポータルにログインします。
2. Drupal メニューで [Structure] -> [Migrator] を選択します。
3. 変換元データベースとして tar ベースのポータルのデータベース（default）を選択し、変換先となるデータベース（上記の settings.php ファイルに基づくと custom）を選択します。
4. [移行] をクリックします。tar ベースのデータベースが RPM ベースのデータベースに移行されます。
tar ベースサーバーの sites ディレクトリを 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. sites ディレクトリのバンドルを解除します。ただし、重要なファイルは上書きしないでください。
  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
```
（tar ベースのポータル上のウェブルートディレクトリのパスをデフォルトのパス /var/www/html から変更した場合のみ tar ベースのポータル: drush status を実行して files と private files のパスを確認します。
```
cd /var/www/html
drush status
```
files/private ファイルが 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 ベースのポータルに含まれる 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 メニューで [Reports] > [Status reports] を選択し、不足しているモジュールがないか確認します。
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 をブラウザで実行し、不足モジュールに関するエラーを取り除きます。
1. 管理者として RPM ベースのポータルにログインします。
2. ブラウザで、次の URL に移動します。
```
http://portal_IP_or_DNS:8079/update.php
```
  ここで、portal_IP_or_DNS は、RPM ベースのポータルの IP アドレスまたはドメイン名です。
3. 画面の指示に沿って操作します。
DNS エントリを更新して、新しい RPM ベースのポータルを指すようにします。

デフォルトのポート番号が 8079 であるのに対し、tar ベースのポータルはポート 80 を使用します。DNS エントリで必ず正しいポート番号を使用してください。別のポートを使用する方法については、ポータルで使用する HTTP ポートを設定するをご覧ください。

これで変換は完了です。

新しい RPM ベースのポータルのファイル settings.php の内容と、tar ベースのポータルのファイルの内容が異なる場合は、新しい設定でファイル

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

を更新して、古い設定に復元しないようにしてください。

tar ベースのポータルを RPM ベースのポータルに変換する

変換後の新しいデフォルト インストール ディレクトリ

ポータル変換手順

変換後の新しいデフォルトインストールディレクトリ