Developer Services Portal v. 4.16.09
ここでは、オンプレミスの Apigee Developer Channel Services をアップグレードする方法を説明します。
デフォルトのインストール ディレクトリ
アップグレード プロセスでは、デベロッパー ポータルが /var/www/html にインストールされていることを前提としています。ポータルをデフォルトのディレクトリにインストールしていない場合は、以下の手順で示すパスを実際のインストール ディレクトリに置き換えてください。
インストール ディレクトリがわからない場合は、よく使用される Drush コマンドの説明に沿って確認できます。
サポートされるアップグレード バージョン
このアップグレード手順は、次のバージョンのポータルでサポートされています。
- pantheon-14.02.x
- pantheon-14.03.x
- pantheon-14.04.x
- pantheon-14.07.x
- pantheon-15-01.x
- OPDK-15-04.x
- OPDK-15-07.x
- OPDK-16-01.x
- OPDK-16-05.x
ポータルのバージョンを確認するには、ブラウザで次の URL を開きます。
http://yourportal.com/buildInfo
インストールの前に
既存のインストールの場合、Drupal コアまたはカスタム以外のモジュールのコードを変更していると、変更が上書きされます。これには、.htaccess に加えた変更などが含まれます。/sites ディレクトリ以外のものはすべて Drupal が所有していると想定する必要があります。このルールの例外は robots.txt です。このファイルがウェブルートに存在する場合は、保持されます。
インストールを続行する前に、Drupal ウェブのルート ディレクトリ全体のバックアップを作成します。デフォルトのインストール場所は /var/www/html ですが、インストール時に変更した可能性があります。以下で説明するインストール手順を完了したら、バックアップからカスタマイズを復元できます。
Apigee Developer Channel Services を新しいリリースにアップグレードする
- Drupal MySQL インスタンスのバックアップ。
詳細については、http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/ をご覧ください。- オプション 1: Drush を使用する
Drush コマンド sql-dump は、データベースのコピーを作成します。Drupal ディレクトリ（デフォルトでは /var/www/html）から、次のコマンドを実行します。
> drush sql-dump > /path/to/backup_dir/database-backup.sql
詳細については、drush help sql-dump を使用してください。 - オプション 2: MySQLdump を使用する
mysqldump コマンドを使用して、データベースのコピーを作成します。
mysqldump -u USERNAME -p'PASSWORD' DATABASENAME > /path/to/backup_dir/database-backup.sql
-p オプションとパスワードの間にスペースを入れないでください。パスワードに特殊文字が含まれている場合は、パスワードを単一引用符で囲む必要があります。
USERNAME と DATABASENAME は、ポータルのインストール時に設定します。デフォルトでは、どちらも devportal です。
- オプション 1: Drush を使用する
- Drupal のウェブルート ディレクトリ全体のバックアップを作成します。デフォルトのインストール場所は /var/www/html ですが、インストール時に変更されている可能性があります。
- デベロッパー チャネル サービスの DeveloperServices_x.y.z.tar ファイルをダウンロードします。ここで、x.y.z はポータルのバージョン番号に対応します。
Apigee から送信されたリンクからファイルをダウンロードするには、ブラウザを使用するか、リンクをコピーして次の cURL コマンドに追加します。
> curl -kOL <ここにリンクを貼り付け>
注: ポータルが外部インターネットに接続されていないサーバー上にある場合は、アクセス権のあるサーバーでこの手順を実行します。
http://community.apigee.com/content/apigee-customer-support に移動し、[Login to your Support Portal] を選択して、Developer Channel Services のアップグレード .tar ファイルをリクエストします。サポート ポータルのアカウントをお持ちでない場合は、[Login to your Support Portal] を選択し、ログインページで [In a hurry? こちらからサポート チケットを送信してください。 -
インターネット接続があるサーバーでアップグレードする場合:
- ポータルのアップグレード ファイルを抽出します。
> tar -xvf <tar file>
このコマンドを実行すると、DeveloperServices-4.x.y.z という名前の新しいディレクトリが作成されます。 - DeveloperServices-4.x.y.z ディレクトリに移動します。
- 次のコマンドを使用して、最新の Drupal バージョンをダウンロードします。
> drush dl drupal
このコマンドにより、drupal-x.y という名前のディレクトリが作成されます。ここで、x.y は Drupal の現在のバージョンに対応します。 - networked-update.sh スクリプトを実行します。
> ./networked-update.sh
ファイル権限によっては、sudo を使用してこのコマンドを実行するか、管理者として実行する必要があります。 - Drupal の更新に関する通知を受け取るには、Drupal Update Manager モジュールが有効になっていることを確認します。Drupal メニューから [Modules] を選択し、[Update manager] モジュールまで下にスクロールします。有効になっていない場合は、有効にします。
有効にすると、[Reports] > [Available Updates] メニュー項目を使用して、利用可能なアップデートを確認できます。
[Reports] > [Available Updates] > [Settings] メニュー項目を使用して、アップデートが利用可能になったときにメールを送信するようにモジュールを構成し、アップデートを確認する頻度を設定します。
- ポータルのアップグレード ファイルを抽出します。
-
インターネットに接続されていないサーバーでアップグレードする場合:
- デベロッパー チャンネル サービスの DeveloperServices_x.y.z.tar ファイルをダウンロードしたサーバーで、ポータルのアップグレード ファイルを抽出します。
> tar -xvf <tar file>
このコマンドを実行すると、DeveloperServices-4.x.y.z という名前の新しいディレクトリが作成されます。 - DeveloperServices-4.x.y.z ディレクトリに移動します。
- non-networked-update.sh スクリプトを実行します。
> ./non-networked-update.sh
ファイルへのアクセス許可によっては、sudo を使用してこのコマンドを実行するか、管理者として実行する必要があります。
このコマンドは、必要なすべてのアップデート ファイルをダウンロードして、devportal-update.tgz という名前の単一のファイルにパッケージ化し、選択した場所にファイルを書き込みます。 - devportal-update.tgz をターゲット サーバー（ポータルを実行しているサーバー）にコピーします。
注: devportal-update.tgz をターゲット サーバーのウェブルートにコピーしないでください。 - devportal-update.tgz ファイルを現在のディレクトリに解凍します。
> tar -xzf /path/to/devportal-update.tgz - developer-update ディレクトリに移動します。
- 次のコマンドを実行して、アップデートをインストールします。
> ./install-update.sh - プロンプトに回答します。
- デベロッパー チャンネル サービスの DeveloperServices_x.y.z.tar ファイルをダウンロードしたサーバーで、ポータルのアップグレード ファイルを抽出します。
これでアップグレードは完了です。