デベロッパー サービス ポータル 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 を更新する手順は次のとおりです。
-
Drupal ディレクトリに移動します。例:
/opt/apigee/apigee-drupal/wwwroot
cd /opt/apigee/apigee-drupal/wwwroot
プロダクト バージョンのデフォルト ディレクトリについては、デフォルトのインストール ディレクトリをご覧ください。
- 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
- Drupal のウェブルート ディレクトリ全体をバックアップします。デフォルトのインストール先は /opt/apigee/apigee-drupal ですが、変更されている可能性もあります。
このディレクトリの場所がわからない場合は、drush status
コマンドか、Drupal メニューの [Configuration] > [Media] > [File] エントリを使用して、パブリック ファイル システムとプライベート ファイル システムのパスを確認します(後者は次のステップで使用します)。 /opt/apigee/data/apigee-drupal-devportal/private
にあるファイルのバックアップをとります。- Drupal をメンテナンス モードに設定します。
- Drupal メニューで [Configuration] を選択します。
- [Configuration] ページの [Development] で [Maintenance mode] を選択します。
- [Put site into maintenance mode] ボックスを選択します。
- メンテナンス中にユーザーに表示するメッセージを入力します。
- [構成を保存] を選択します。
- Edge apigee-setup ユーティリティのインストールの説明に従って、SELinux を無効にします。
/opt
ディレクトリに移動します。cd /opt
-
インターネットに接続しているサーバーでアップグレードを行う場合:
- 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
- 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 をインストールせずに続行できます。
- Edge 4.17.09 の
-
インターネットに接続していないサーバーでアップグレードを行う場合:
- Edge apigee-setup ユーティリティのインストールの「ローカルに Apigee リポジトリを作成する」の手順で 4.17.09 リポジトリをローカルに作成します。
-
.tar ファイルから apigee-service をインストールするには:
- ローカル リポジトリが存在するノードで次のコマンドを使用し、ローカル リポジトリを
/opt/apigee/data/apigee-mirror/apigee-4.17.09.tar.gz
という名前の単一の .tar ファイルにパッケージ化します。/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- Edge を更新する対象のノードに .tar ファイルをコピーします。たとえば、新しいノードの /tmp ディレクトリにコピーします。
- 新しいノードで、tar ファイルを解凍し、/tmp ディレクトリに展開します。
tar -xzf apigee-4.17.09.tar.gz
このコマンドにより、.tar ファイルを含むディレクトリ内に repos という新しいディレクトリが作成されます。たとえば、/tmp/repos のようになります。
/tmp/repos
から Edgeapigee-service
ユーティリティと依存関係をインストールします。sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
コマンドに repos ディレクトリへのパスが含まれている点に注意してください。
- ローカル リポジトリが存在するノードで次のコマンドを使用し、ローカル リポジトリを
-
Nginx ウェブサーバーを使用して apigee-service をインストールするには:
- Edge apigee-setup ユーティリティのインストールの「Nginx ウェブサーバーを使用してリポジトリからインストールする」の手順に沿って、Nginx ウェブサーバーを構成します。
- リモートノードで、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 名です。
- リモートノードで、Edge
apigee-service
ユーティリティと dependencies:codesudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
をインストールします。ここで、uName:pWord はリポジトリのユーザー名とパスワードです。
apigee-service
を使用してapigee-setup
ユーティリティを更新します。/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- ノードで更新ユーティリティを実行して Postgres データベースを更新します。
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
ここで、configFile は Postgres データベースのインストールに使用した構成ファイルです。構成ファイルに関する唯一の要件として、構成ファイルが apigee ユーザーからアクセス可能または読み取り可能である必要があります。
- Postgres を起動します。
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
- ノードで更新ユーティリティを実行してポータルを更新します。
/opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile
ここで、configFile はポータルのインストールに使用した構成ファイルです。構成ファイルに関する唯一の要件として、構成ファイルが apigee ユーザーからアクセス可能または読み取り可能である必要があります。
- ブラウザ ウィンドウで次の URL を開き、Drupal の
update.php
スクリプトを実行します。http://portalIP_DNS:8079/update.php
- Drupal をメンテナンス モードにします。
- Drupal メニューで [Configuration] を選択します。
- [Configuration] ページの [Development] で [Maintenance mode] を選択します。
- [Put site into maintenance mode] ボックスの選択を解除します。
- [構成を保存] を選択します。
アップデート後のルート ディレクトリは次のとおりです。
/opt/apigee/apigee-drupal/wwwroot
これでアップグレードは完了です。