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 ベースのポータルのデータベースをこの新しいデータベースに移行します。
- psql にログインします。
psql -h localhost -p 5432 -U apigee
ポータル構成ファイルの PG_PWD プロパティで定義されている Postgres パスワードを入力します。
- 新しい Postgres データベースを作成します。
CREATE DATABASE newportaldb;
- psql を終了します。
\q
- psql にログインします。
-
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 モジュールをインストールして構成します。
-
cd /tmp
-
wget https://ftp.drupal.org/files/projects/dbtng_migrator-7.x-1.4.tar.gz
-
gunzip /tmp/dbtng_migrator-7.x-1.4.tar.gz
-
tar -xvf /tmp/dbtng_migrator-7.x-1.4.tar --directory /var/www/html/sites/all/modules
- 管理者としてポータルにログインします。
- Drupal メニューで [Modules] を選択します。
- [DBTNG Migrator] モジュールを有効にします。
- 構成を保存します。
-
- 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 ドライバをインストールします。
- Yum を使用してドライバをインストールします。
yum install php-pdo_pgsql
/etc/php.ini
をエディタで開き、次の行をファイルの任意の場所に追加します。extension=pgsql.so
- Apache を再起動します。
service httpd restart
- Yum を使用してドライバをインストールします。
- tar ベースのポータルで、ポータル データベースを RPM ベースのポータルに移行します。
- 管理者としてポータルにログインします。
- Drupal メニューで [Structure] -> [Migrator] を選択します。
- 変換元データベースとして tar ベースのポータルのデータベース(
default
)を選択し、変換先となるデータベース(上記のsettings.php
ファイルに基づくとcustom
)を選択します。 - [移行] をクリックします。tar ベースのデータベースが RPM ベースのデータベースに移行されます。
- tar ベースサーバーの
sites
ディレクトリを RPM ベースサーバーにコピーします。以下の手順に示すパスはデフォルトのパスに基づいています。ご使用の環境に合わせてパスを変更してください。- tar ベースのポータルで、
/var/www/html/sites
ディレクトリをバンドルします。cd /var/www/html/sites
tar -cvzf /tmp/sites.tar.gz .
/tmp/sites.tar.gz
を RPM ベースサーバー上の/opt/apigee/apigee-drupal/wwwroot/sites
にコピーします。- sites ディレクトリのバンドルを解除します。ただし、重要なファイルは上書きしないでください。
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 から変更した場合のみ 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 ベースのポータルに移行したら、不足しているモジュールがないか確認し、必要に応じてそのモジュールをインストールします。
- 不足モジュールの検出に使用する Drupal
missing_module
をインストールします。cd /opt/apigee/apigee-drupal/wwwroot
drush dl missing_module
drush en missing_module
- 管理者として RPM ベースのポータルにログインします。
- Drupal メニューで [Reports] > [Status reports] を選択し、不足しているモジュールがないか確認します。
- このレポートを使用して、不足しているモジュールをインストールするか、次のコマンドを使用します。
cd /opt/apigee/apigee-drupal/wwwroot
drush dl <moduleA> <moduleB> ...
drush en <moduleA> <moduleB> ...
- すべてのモジュールを有効にした後、ファイルの所有者を「apigee」ユーザーにします。
chown -LR apigee:apigee /opt/apigee/apigee-drupal/wwwroot
ファイルの権限の詳細については、https://www.drupal.org/node/244924 をご覧ください。
- 不足モジュールの検出に使用する Drupal
- RPM ベースのポータルで、update.php をブラウザで実行し、不足モジュールに関するエラーを取り除きます。
- 管理者として RPM ベースのポータルにログインします。
- ブラウザで、次の URL に移動します。
http://portal_IP_or_DNS:8079/update.php
ここで、portal_IP_or_DNS は、RPM ベースのポータルの IP アドレスまたはドメイン名です。
- 画面の指示に沿って操作します。
- DNS エントリを更新して、新しい RPM ベースのポータルを指すようにします。
デフォルトのポート番号が 8079 であるのに対し、tar ベースのポータルはポート 80 を使用します。DNS エントリで必ず正しいポート番号を使用してください。別のポートを使用する方法については、ポータルで使用する HTTP ポートを設定するをご覧ください。
これで変換は完了です。