Edge for Private Cloud v4.18.05
ここでは、オンプレミスの 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
ポータルのバージョンを確認するには、ブラウザで次の 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] を選択します。
- [Configuration] ページで、[Development] の下にある [Maintenance mode] を選択します。
- [Put site into maintenance mode] ボックスを選択します。
- メンテナンス中にユーザーに表示するメッセージを入力します。
- [Save configuration] を選択します。
- dge apigee-setup ユーティリティをインストールするの説明に沿って、SELinux を無効にします。
/opt
ディレクトリに移動します。cd /opt
- インターネットに接続しているサーバーでアップグレードを行う場合:
- Edge 4.18.05 の
bootstrap_4.18.05.sh
ファイルを/tmp/bootstrap_4.18.05.sh
にダウンロードします。curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
- Edge 4.18.05 の
apigee-service
ユーティリティと依存関係をインストールします。sudo bash /tmp/bootstrap_4.18.05.sh apigeeuser=uName apigeepassword=pWord
ここで、uName と pWord はそれぞれ Apigee から提供されたユーザー名とパスワードです。pWord を省略した場合、入力するように指示されます。
デフォルトでは、インストーラが Java 1.8 の有無を確認します。"C" オプションを使用すると、Java をインストールせずに続行できます。
- Edge 4.18.05 の
- インターネットに接続していないサーバーでアップグレードを行う場合:
- ローカルに Apigee リポジトリを作成するの手順に沿って、ローカルに 4.18.05 リポジトリを作成します。
- .tar ファイルから apigee-service をインストールするには:
- ローカル リポジトリのあるノードで次のコマンドを使用し、ローカル リポジトリを
/opt/apigee/data/apigee-mirror/apigee-4.18.05.tar.gz
という名前の単一の .tar ファイルにパッケージ化します。/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- Edge を更新するノードに .tar ファイルをコピーします。たとえば、新しいノードの
/tmp
ディレクトリにコピーします。 - 新しいノードで、tar ファイルを解凍し、/tmp ディレクトリに展開します。
tar -xzf apigee-4.18.05.tar.gz
このコマンドにより、repos という新しいディレクトリが作成されます。ディレクトリには .tar ファイルが含まれます。たとえば、/tmp/repos のようになります。
/tmp/repos
から Edgeapigee-service
ユーティリティと依存関係をインストールします。sudo bash /tmp/repos/bootstrap_4.18.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
コマンドに repos ディレクトリへのパスが含まれている点に注意してください。
- ローカル リポジトリのあるノードで次のコマンドを使用し、ローカル リポジトリを
- Nginx ウェブサーバーを使用して apigee-service をインストールするには:
- Edge apigee-setup ユーティリティのインストールの「Nginx ウェブサーバーを使用してリポジトリからインストールする」を参照し、Nginx ウェブサーバーを構成します。
- ートノードで、Edge の
bootstrap_4.18.05.sh
ファイルを/tmp/bootstrap_4.18.05.sh
にダウンロードします。/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
uName と pWord は、上記でリポジトリに設定したユーザー名とパスワードです。remoteRepo は、リポジトリのあるノードの IP アドレスまたは DNS 名です。
- リモートノードで、Edge
apigee-service
ユーティリティと依存関係をインストールします。sudo bash /tmp/bootstrap_4.18.05.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
- Postgre ノードで更新ユーティリティを実行します。
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
configFile は、Postgres データベースのインストールで使用された構成ファイルです。構成ファイルは、apigee ユーザーによってアクセス可能であり、読み取り可能である必要があります。
- Postgres データベースを更新します。
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
- ノードで更新ユーティリティを実行し、ポータルを更新します。
/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 を無効にして、メンテナンス モードに変更します。
- Drupal メニューで [Configuration] を選択します。
- [Configuration] ページで、[Development] の下にある [Maintenance mode] を選択します。
- [Put site into maintenance mode] ボックスをオフにします。
- [Save configuration] を選択します。
アップデート後のルート ディレクトリは次のとおりです。
/opt/apigee/apigee-drupal/wwwroot
これで、アップグレードが完了です。