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

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

ここでは、オンプレミスの Apigee チャネル サービス インストールをアップグレードする方法を説明します。

正しい更新手順を決定する

ポータルのアップデート手順は現在のインストール環境によって異なります。

• Nginx/Postgres を使用している場合は、後述の RPM を使用してポータルをアップグレードするをご覧ください。
• Apache/MySQL または Apache/MariaDB を使用している場合は、tar ベースのポータルを RPM ベースのポータルに変換するをご覧ください。

現在のインストール タイプを確認する

現在のインストール タイプがわからない場合は、次のコマンドを使用して確認します。

• ls /opt

  Nginx/Postgres を使用している場合、ディレクトリの /opt/apigee と /opt/nginx が表示されます。

  Apache/MySQL または Apache/MariaDB を使用している場合、これらのディレクトリは存在しません。

• /opt/apigee/apigee-service/bin/apigee-all status

  Nginx/Postgres を使用している場合、次の出力が表示されます。

  + apigee-service
    apigee-drupal-devportal status
    OK: apigee-drupal-devportal is up and running
    + apigee-service apigee-lb status
    apigee-service: apigee-lb: OK
    + apigee-service apigee-postgresql status
    apigee-service: apigee-postgresql: OK

• apachectl -S

  Apache/MySQL または Apache/MariaDB を使用している場合、次の形式でポータルのウェブルート ディレクトリが返されます。

  *:80
    192.168.56.102
    (/etc/httpd/conf/vhosts/devportal.conf:1)

デフォルトのインストール ディレクトリ

アップグレード プロセスでは、デベロッパー ポータルが次の場所にインストールされていることを前提としています。

• 4.17.05 以降: /opt/apigee/apigee-drupal/wwwroot
• 4.17.05 より前: /opt/apigee/apigee-drupal（Nginx）または /var/www/html（Apache）

ポータルをデフォルト ディレクトリにインストールしなかった場合は、インストール ディレクトリを使用するように下記の手順を変更します。

サポートされているアップグレード バージョン

このアップグレード手順は、次のバージョンのポータルでサポートされています。

• OPDK-17-01.x
• OPDK-17-05.x

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

http://your_portal.com/buildInfo

更新する前に

既存の環境で Drupal コアまたはカスタム以外のモジュールのコードを変更している場合、これらの変更は上書きされます。これには、.htaccess に対して行った変更も含まれます。/sites ディレクトリの外にあるものは Drupal が所有していると想定してください。このルールの例外は robots.txt です。このファイルがウェブルートに存在する場合は保存されます。

インストールを開始する前に、Drupal ウェブルート ディレクトリ全体のバックアップを作成してください。以下で説明するインストール手順を行った後で、バックアップからカスタマイズを復元できます。

RPM を使用したポータルのアップグレード

ノードでポータルの RPM を更新する手順は次のとおりです。

1. Drupal ディレクトリに移動します。例: /opt/apigee/apigee-drupal/wwwroot

   cd /opt/apigee/apigee-drupal/wwwroot

   プロダクト バージョンのデフォルト ディレクトリについては、デフォルトのインストール ディレクトリをご覧ください。

2. Drupal データベース インスタンスをバックアップします。pg_dump コマンドで、データベースのコピーが作成されます。
   

   pg_dump --dbname=devportal --host=192.168.56.101
     --username=drupaladmin --password --format=c > /tmp/portal.dmp

   ここで

   • dbname には、ポータルのインストール構成ファイルの PG_NAME プロパティで指定されているデータベース名を指定します。
   • host には、ポータルノードの IP アドレスを指定します。
   • username には、ポータルのインストール構成ファイルの DRUPAL_PG_USER プロパティで指定された Postgres ユーザー名を指定します。
   • ポータルのインストール構成ファイルの DRUPAL_PG_PASS プロパティで定義されている Postgres ユーザーのパスワードの入力を求められます。

   後でバックアップから復元する場合は、次のコマンドを使用します。

   pg_restore --clean --dbname=devportal --host=localhost  --username=apigee < /tmp/portal.dmp

3. Drupal のウェブルート ディレクトリ全体をバックアップします。デフォルトのインストール先は /opt/apigee/apigee-drupal ですが、変更されている可能性もあります。
   このディレクトリの場所がわからない場合は、drush status コマンドか、Drupal メニューの [Configuration] > [Media] > [File] エントリを使用して、パブリック ファイル システムとプライベート ファイル システムのパスを確認します（後者は次のステップで使用します）。
4. /opt/apigee/data/apigee-drupal-devportal/private にあるファイルのバックアップをとります。
5. Drupal をメンテナンス モードに設定します。
   1. Drupal メニューで [Configuration] を選択します。
   2. [Configuration] ページの [Development] で [Maintenance mode] を選択します。
   3. [Put site into maintenance mode] ボックスを選択します。
   4. メンテナンス中にユーザーに表示するメッセージを入力します。
   5. [構成を保存] を選択します。
6. Edge apigee-setup ユーティリティのインストールの説明に従って、SELinux を無効にします。
7. /opt ディレクトリに移動します。

   cd /opt

8. インターネットに接続しているサーバーでアップグレードを行う場合:
   1. Edge 4.17.09 の bootstrap_4.17.09.sh ファイルを /tmp/bootstrap_4.17.09.sh にダウンロードします。

      curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh

   2. Edge 4.17.09 の apigee-service ユーティリティと依存関係をインストールします。

      sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName
        apigeepassword=pWord

      ここで、uName:pWord は Apigee から受け取ったユーザー名とパスワードです。pWord を省略すると、パスワードの入力を求められます。
      

      デフォルトでは、インストーラが Java 1.8 の有無を確認します。"C" オプションを使用すると、Java をインストールせずに続行できます。

9. インターネットに接続していないサーバーでアップグレードを行う場合:
   1. Edge apigee-setup ユーティリティのインストールの「ローカルに Apigee リポジトリを作成する」の手順で 4.17.09 リポジトリをローカルに作成します。
   2. .tar ファイルから apigee-service をインストールするには:
      1. ローカル リポジトリが存在するノードで次のコマンドを使用し、ローカル リポジトリを /opt/apigee/data/apigee-mirror/apigee-4.17.09.tar.gz という名前の単一の .tar ファイルにパッケージ化します。

         /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

      2. Edge を更新する対象のノードに .tar ファイルをコピーします。たとえば、新しいノードの /tmp ディレクトリにコピーします。
      3. 新しいノードで、tar ファイルを解凍し、/tmp ディレクトリに展開します。
         

         tar -xzf apigee-4.17.09.tar.gz

         このコマンドにより、.tar ファイルを含むディレクトリ内に repos という新しいディレクトリが作成されます。たとえば、/tmp/repos のようになります。

      4. /tmp/repos から Edge apigee-service ユーティリティと依存関係をインストールします。

         sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

         コマンドに repos ディレクトリへのパスが含まれている点に注意してください。

   3. Nginx ウェブサーバーを使用して apigee-service をインストールするには:
      1. Edge apigee-setup ユーティリティのインストールの「Nginx ウェブサーバーを使用してリポジトリからインストールする」の手順に沿って、Nginx ウェブサーバーを構成します。
      2. リモートノードで、Edge bootstrap_4.17.09.sh ファイルを /tmp/bootstrap_4.17.09.sh にダウンロードします。

         /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh
           -o /tmp/bootstrap_4.17.09.sh

         ここで、uName:pWord は上記でリポジトリに設定したユーザー名とパスワード、remoteRepo はリポジトリ ノードの IP アドレスまたは DNS 名です。

      3. リモートノードで、Edge apigee-service ユーティリティと dependencies:code

         sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939
           apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

         をインストールします。

         ここで、uName:pWord はリポジトリのユーザー名とパスワードです。

10. apigee-service を使用して apigee-setup ユーティリティを更新します。

    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

11. ノードで更新ユーティリティを実行して Postgres データベースを更新します。
    

    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

    ここで、configFile は Postgres データベースのインストールに使用した構成ファイルです。構成ファイルに関する唯一の要件として、構成ファイルが apigee ユーザーからアクセス可能または読み取り可能である必要があります。

12. Postgres を起動します。
    

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start

13. ノードで更新ユーティリティを実行してポータルを更新します。

    /opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile

    ここで、configFile はポータルのインストールに使用した構成ファイルです。構成ファイルに関する唯一の要件として、構成ファイルが apigee ユーザーからアクセス可能または読み取り可能である必要があります。

14. ブラウザ ウィンドウで次の URL を開き、Drupal の update.php スクリプトを実行します。

    http://portalIP_DNS:8079/update.php

15. Drupal をメンテナンス モードにします。
    1. Drupal メニューで [Configuration] を選択します。
    2. [Configuration] ページの [Development] で [Maintenance mode] を選択します。
    3. [Put site into maintenance mode] ボックスの選択を解除します。
    4. [構成を保存] を選択します。

アップデート後のルート ディレクトリは次のとおりです。

/opt/apigee/apigee-drupal/wwwroot

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