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 コマンドは、Cloud Storage バケットのコピーを データベース:
   

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

   ここで

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

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

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

3. Drupal ウェブルート ディレクトリ全体のバックアップを作成します。デフォルトのインストール場所 /opt/apigee/apigee-drupal 変更した可能性があります。
   このディレクトリの場所がわからない場合は、drush status コマンドまたは [構成] >メディア >[File] エントリを確認します。 パブリック ファイル システムとプライベート ファイル システムのパスの場所（次の ステップ）。
4. /opt/apigee/data/apigee-drupal-devportal/private にファイルのバックアップを作成します。
5. Drupal をメンテナンス モードに設定します。 <ph type="x-smartling-placeholder">
   </ph>
   1. Drupal のメニューで [Configuration] を選択します。
   2. [構成] ページで、[メンテナンス] を選択します。 開発モード。
   3. [サイトをメンテナンス モードにする] ボックスを選択します。
   4. メンテナンス中にユーザーに表示されるメッセージを入力します。
   5. [設定を保存] を選択します。
6. SELinux を無効にする Edge apigee-setup ユーティリティをインストールします。
7. /opt ディレクトリに移動します。

   cd /opt

8. インターネットに接続されているサーバーでアップグレードを行う場合: <ph type="x-smartling-placeholder">
   </ph>
   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 は、 ApigeepWord を省略すると、入力を求められます。
      

      デフォルトでは、Java 1.8 がインストールされているかどうかが確認されます。こちらの 「C」Java をインストールせずに続行するオプションを選択できます。

9. インターネットに接続していないサーバーでアップグレードを行う場合: <ph type="x-smartling-placeholder">
   </ph>
   1. 「ローカルの Apigee リポジトリを作成する」の説明に沿って、ローカルに 4.17.09 リポジトリを作成する Edge をインストールする apigee-setup ユーティリティを実行します。
   2. .tar ファイルから apigee-service をインストールするには: <ph type="x-smartling-placeholder">
      </ph>
      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. 新しいノードで、ファイルを /tmp ディレクトリに展開します。
         

         tar -xzf apigee-4.17.09.tar.gz

         このコマンドを実行すると、.tar が含まれるディレクトリに repos という新しいディレクトリが作成されます 表示されます。例: /tmp/repos

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

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

         このコマンドには、Repo ディレクトリのパスが含まれています。

   3. Nginx ウェブサーバーを使用して apigee-service をインストールするには: <ph type="x-smartling-placeholder">
      </ph>
      1. 「 Nginx ウェブサーバー」Edge のインストール apigee-setup ユーティリティを実行します。
      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. ノードで update ユーティリティを実行してポータルを更新します。

    /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 を無効にし、メンテナンス モードに切り替えます。 <ph type="x-smartling-placeholder">
    </ph>
    1. Drupal のメニューで [Configuration] を選択します。
    2. [構成] ページで、[メンテナンス] を選択します。 開発モード。
    3. [Put site intoMaintenance mode] ボックスをオフにします。
    4. [設定を保存] を選択します。

更新後のルート ディレクトリは次のようになります。

/opt/apigee/apigee-drupal/wwwroot

これでアップグレードが完了しました。