Edge for Private Cloud v4.19.01
この手順では、オンプレミス インストールで既存の Apigee Developer Services ポータル(略して「ポータル」)をアップグレードする方法について説明します。
正しいアップデート手順を決定する
ポータルのアップデート手順は現在のインストール環境によって異なります。
- 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
- OPDK-17-09.x
- OPDK-18-01.x
- OPDK-18-05.x
ポータルのバージョンを確認するには、ブラウザで次の URL を開きます。
http://yourportal.com/buildInfo
アップデート前の準備
既存のインストールでは、Drupal コアまたはカスタム以外のモジュールでコードを変更した場合、変更は上書きされます。これには、特に .htaccess
に加えた変更が含まれます。
/sites
ディレクトリ以外は Drupal が所有しているものと想定してください。このルールの例外は robots.txt
です。このファイルがウェブルートに存在する場合は、保持されます。
インストールに進む前に、Drupal のウェブルート ディレクトリ全体のバックアップを作成します。以下で説明するインストール手順を行った後、バックアップからカスタマイズを復元できます。
RPM を使用してポータルをアップグレードする
ノードのポータル RPM を更新するには:
- Drupal ディレクトリ(デフォルトでは
/opt/apigee/apigee-drupal
)に移動します。cd /opt/apigee/apigee-drupal
- Drupal データベース インスタンスをバックアップします。
pg_dump
コマンドは、データベースのコピーを作成します。pg_dump --dbname=devportal --host=host_IP_address --username=drupaladmin --password --format=c > /tmp/portal.dmp
ここで
- devportal は、ポータルのインストール構成ファイルの
PG_NAME
プロパティで指定されているデータベース名です。 - host_IP_address は、ポータルノードの IP アドレスです。
- drupaladmin は、ポータルのインストール構成ファイルの
DRUPAL_PG_USER
プロパティで指定されているデータベースにアクセスするためにポータルが使用する Postgres ユーザー名です。
ポータルのインストール構成ファイルの
DRUPAL_PG_PASS
プロパティで定義されている Postgres ユーザーのパスワードの入力を求められます。後でバックアップから復元する場合は、次のコマンドを使用します。
pg_restore --clean --dbname=devportal --host=localhost --username=apigee < /tmp/portal.dmp
- devportal は、ポータルのインストール構成ファイルの
- Drupal のウェブルート ディレクトリ全体のバックアップを作成します。デフォルトのインストール場所は
/opt/apigee/apigee-drupal
ですが、変更されている可能性もあります。このディレクトリの場所がわからない場合は、
drush status
コマンドを使用するか、Drupal のメニューで [Configuration] > [Media] > [File] エントリを使用して、公開ファイル システムとプライベート ファイル システムのパス(次のステップ用)の場所を特定します。 /opt/apigee/data/apigee-drupal-devportal/private
にあるファイルのバックアップを作成します。- Drupal をメンテナンス モードに設定します。
- Drupal のメニューで [Configuration] を選択します。
- [構成] ページの [開発] で、[メンテナンス モード] を選択します。
- [サイトをメンテナンス モードにする] チェックボックスをオンにします。
- メンテナンス中にユーザーに表示するメッセージを入力します。
- [構成を保存] を選択します。
- Edge apigee-setup ユーティリティのインストールの説明に従って、SELinux を無効にします。
/opt
ディレクトリに移動します。cd /opt
- インターネットに接続しているサーバーでアップグレードする場合:
- Edge 4.19.01 の
bootstrap_4.19.01.sh
ファイルを/tmp/bootstrap_4.19.01.sh
にダウンロードします。curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
- Edge 4.19.01 の
apigee-service
ユーティリティと依存関係をインストールします。sudo bash /tmp/bootstrap_4.19.01.sh apigeeuser=uName apigeepassword=pWord
ここで、uName と pWord は Apigee から取得したユーザー名とパスワードです。pWord を省略すると、入力するように求められます。
デフォルトでは、Java 1.8 がインストールされているかどうかが確認されます。「C」オプションを使用すると、Java をインストールせずに続行できます。
- Edge 4.19.01 の
- インターネットに接続していないサーバーでアップグレードする場合:
- ローカルに Apigee リポジトリを作成するの説明に沿って、4.19.01 リポジトリをローカルに作成します。
- .tar ファイルから apigee-service をインストールするには:
- ローカル リポジトリが存在するノードで、次のコマンドを使用して、ローカル リポジトリを
/opt/apigee/data/apigee-mirror/apigee-4.19.01.tar.gz
という名前の単一の .tar ファイルにパッケージ化します。/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- Edge を更新する対象のノードに .tar ファイルをコピーします。たとえば、新しいノードの
/tmp
ディレクトリにコピーします。 - 新しいノードで、/tmp ディレクトリに tar ファイルを解凍します。
tar -xzf apigee-4.19.01.tar.gz
このコマンドにより、.tar ファイルを含むディレクトリに repos という新しいディレクトリが作成されます。(例: /tmp/repos)。
/tmp/repos
から Edgeapigee-service
ユーティリティと依存関係をインストールします。sudo bash /tmp/repos/bootstrap_4.19.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
コマンドに repos ディレクトリへのパスが含まれている点に注意してください。
- ローカル リポジトリが存在するノードで、次のコマンドを使用して、ローカル リポジトリを
- Nginx ウェブサーバーを使用して apigee-service をインストールするには:
- Edge apigee-setup ユーティリティのインストールの「Nginx ウェブサーバーを使用してリポジトリからインストールする」の手順に沿って、Nginx ウェブサーバーを構成します。
- リモートノードで、Edge
bootstrap_4.19.01.sh
ファイルを/tmp/bootstrap_4.19.01.sh
にダウンロードします。/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
ここで、uName と pWord は、上記でリポジトリに設定したユーザー名とパスワードです。remoteRepo は、リポジトリ ノードの IP アドレスまたは DNS 名です。
- リモートノードで、Edge
apigee-service
ユーティリティと依存関係をインストールします。sudo bash /tmp/bootstrap_4.19.01.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」ユーザーからアクセス可能で、読み取り可能であることです。
- ノードで更新ユーティリティを実行してポータルを更新します。
/opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile
ここで、configFile はポータルのインストールに使用した構成ファイルです。構成ファイルに関する唯一の要件は、構成ファイルが「apigee」ユーザーからアクセス可能で、読み取り可能であることです。
- ブラウザ ウィンドウで次の URL を開き、Drupal の
update.php
スクリプトを実行します。http://portal_IP_DNS:8079/update.php
- メンテナンス モードを無効にします。
- Drupal のメニューで [Configuration] を選択します。
- [構成] ページの [開発] で、[メンテナンス モード] を選択します。
- [サイトをメンテナンス モードにする] チェックボックスをオフにします。
- [構成を保存] を選択します。
更新後のルート ディレクトリは次のようになります。
/opt/apigee/apigee-drupal/wwwroot
これでアップグレードは完了です。Apigee アップデート ユーティリティによって Drupal のバージョンがダウングレードされた場合は、Drupal アップグレード ユーティリティの再実行が必要になることがあります。詳細については、Drupal のアップグレードを再実行するをご覧ください。
Drupal のアップグレードを再度実行する
Apigee 更新ユーティリティを実行して Edge for Private Cloud をアップグレードした結果、実際に Drupal のバージョンがダウングレードされた場合は、Drupal のアップグレードを再インストールします。これは、Private Cloud の更新と更新の間に Drupal のみをアップグレードした場合に発生することがあります。
例:
- Drupal 7.59 を含む Edge for Private Cloud のバージョン 4.18.05 を実行していました。
- セキュリティ アップデートが必要なため、Drupal を 7.64 にアップグレードしました。
- Private Cloud を Drupal 7.61 を含む 4.19.01 にアップグレードします。
この例が示すように、Apigee アップデート ユーティリティで使用される Drupal のバージョンは、Drupal の最新のアップグレードを参照していない場合があります。そのため、Drupal のインストールを新しいバージョンに戻すには、Drupal のアップグレードを再実行する必要があります。