Developer Services ポータルのアップグレード

デベロッパー サービス ポータル v. 4.17.01

この手順では、オンプレミス インストールの既存の 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
  • OPDK-16-09.x

ポータルのバージョンを確認するには、ブラウザで次の URL を開きます。

http://yourportal.com/buildInfo

インストールの前に

既存のインストールでは、Drupal コアまたはカスタム以外のモジュールでコードを変更した場合、変更は上書きされます。これには、.htaccess に加えた変更も含まれます。 /sites ディレクトリの外部はすべて Drupal によって所有されていることを前提としています。robots.txt はこのルールの例外です。このファイルがウェブルートに存在する場合は、保持されます。

インストールに進む前に、Drupal のウェブルート ディレクトリ全体のバックアップを作成します。デフォルトのインストール場所は /var/www/html ですが、インストール時に変更される場合があります。以下で説明するインストール手順を行った後、バックアップからカスタマイズを復元できます。

Apigee デベロッパー チャネル サービスの新しいリリースへのアップグレード

  1. Drupal MySQL インスタンスのバックアップ。
    詳しくは、http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/ をご覧ください。
    1. オプション 1: Drush を使用する

      Drush コマンド sql-dump を使用して、データベースのコピーを作成します。Drupal ディレクトリ(デフォルトでは /var/www/html)から、次のコマンドを実行します。
      > drush sql-dump > /path/to/backup_dir/database-backup.sql

      詳細については、drush help sql-dump をご覧ください。
    2. オプション 2: MySQLdump を使用する
      mysqldump コマンドを使用してデータベースのコピーを作成します。
      mysqldump -u ユーザー名 -p'PASSWORD' DATABASENAME > /path/to/backup_dir/database-backup.sql

      -p オプションとパスワードの間にはスペースを入れないでください。パスワードに特殊文字が含まれる場合は、パスワードを一重引用符で囲む必要があります。

      ユーザー名データベース名は、ポータルのインストール時に設定します。デフォルトでは、どちらも devportal です。
  2. Drupal のウェブルート ディレクトリ全体のバックアップを作成します。デフォルトのインストール場所は /var/www/html ですが、インストール時に変更される場合があります。
  3. デベロッパー チャネル サービスの DeveloperServices_x.y.z.tar ファイルを ftp.apigee.com からダウンロードします。ここで、x.y.z はポータルのバージョン番号に対応します。プロンプトが表示されたら、Apigee から受け取った認証情報を入力します。

    ブラウザで Apigee から送信されたリンクからファイルをダウンロードできます。ファイルをコピーして次の cURL コマンドに追加することもできます。
    > curl -kOL <ここにリンクを貼り付けます>

    : ポータルが外部インターネット接続のないサーバー上にある場合は、アクセス可能なサーバーでこの手順を実行します。

    http://community.apigee.com/content/apigee-customer-support に移動し、[サポート ポータルにログイン] を選択して、デベロッパー チャネル サービスのアップグレード .tar ファイルをリクエストします。サポート ポータルのアカウントがない場合は、[Login to your Support Portal] を選択してから、ログインページで [In a hurry?こちらからサポート チケットを送信してください
  4. インターネットに接続しているサーバーでアップグレードする場合:
    1. ポータルのアップグレード ファイルを解凍します。
      > tar -xvf <tar ファイル>

      このコマンドを解凍すると、DeveloperServices-4.x.y.z という新しいディレクトリが作成されます。
    2. DeveloperServices-4.x.y.z ディレクトリに移動します。
    3. 次のコマンドを使用して、最新バージョンの Drupal をダウンロードします。
      > drush dl drupal

      このコマンドにより、drupal-x.y という名前のディレクトリが作成されます。ここで、x.y は Drupal の現在のバージョンに対応しています。
    4. networked-update.sh スクリプトを実行します。
      > ./networked-update.sh

      ファイルの権限に応じて、sudo を使用してこのコマンドを実行するか、管理者として実行する必要があります。
    5. Drupal のアップデート通知を受け取るには、Drupal アップデート マネージャー モジュールが有効になっていることを確認します。Drupal のメニューで [Modules] を選択し、[Updatemanager] モジュールまでスクロールします。有効になっていない場合は、有効にします。

      有効にした後は、[レポート] > [利用可能なアップデート] メニュー項目を使用して、利用可能なアップデートを確認できます。

      [レポート] > [利用可能なアップデート] > [設定] メニュー項目を使用して、アップデートが利用可能になったときにメールで通知するようにモジュールを構成し、アップデートを確認する頻度を設定します。
  5. インターネットに接続していないサーバーでアップグレードした場合:
    1. デベロッパー チャネル サービスの DeveloperServices_x.y.z.tar ファイルをダウンロードしたサーバーで、ポータル アップグレード ファイルを解凍します。
      > tar -xvf <tar ファイル>

      このコマンドにより、DeveloperServices-4.x.y.z という新しいディレクトリが作成されます。
    2. DeveloperServices-4.x.y.z ディレクトリに移動します。
    3. non-networked-update.sh スクリプトを実行します。
      > ./non-networked-update.sh

      ファイルの権限に応じて、sudo を使用してこのコマンドを実行するか、管理者として実行する必要があります。

      このコマンドは、必要なすべての更新ファイルをダウンロードして devportal-update.tgz という名前の単一のファイルにパッケージ化し、任意の場所にファイルを書き込みます。
    4. devportal-update.tgz を、ポータルを実行しているターゲット サーバーにコピーします。
      : devportal-update.tgz をターゲット サーバーのウェブルートにコピーしないでください。
    5. devportal-update.tgz ファイルを現在のディレクトリに展開します。
      > tar -xzf /path/to/devportal-update.tgz
    6. developer-update ディレクトリに移動します。
    7. 次のコマンドを実行してアップデートをインストールします。
      > ./install-update.sh
    8. 画面の指示に沿って操作します。

これでアップグレードは完了です。