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: OKapachectl -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.shuName と 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
これで、アップグレードが完了です。