Edge apigee-setup ユーティリティのインストール

Edge for Private Cloud v4.19.01

ノードに Edge をインストールするには、まず Edge apigee-setup ユーティリティをインストールします。ノードに外部インターネット接続がない場合は、Apigee リポジトリのローカルコピーもインストールする必要があります。

デフォルトのインストール ディレクトリ: /opt/apigee

Edge では、すべてのファイルが /opt/apigee ディレクトリにインストールされます。このディレクトリは変更できません。ただし、必要に応じて、/opt/apigee を別の場所にマッピングするシンボリック リンクを作成できます。詳細については、インストール要件をご覧ください。

前提条件: SELinux を無効にする

Edge apigee-setup ユーティリティまたは Edge コンポーネントをインストールする前に、SELinux を無効にするか、permissive モードに設定する必要があります。必要に応じて、Edge のインストール後に SELinux を再度有効にすることができます。

• 一時的に SELinux を permissive モードに設定するには、次のコマンドを実行します。
  1. Linux 6.x オペレーティング システムの場合:

     sudo echo 0 > /selinux/enforce

     Edge のインストール後に SELinux を再度有効にするには:

     sudo echo 1 > /selinux/enforce

  2. Linux 7.x オペレーティング システムの場合:

     sudo setenforce 0

     Edge のインストール後に SELinux を再度有効にするには:

     sudo setenforce 1

• SELinux を永続的に無効にするか、permissive モードに設定するには:
  1. エディタで /etc/sysconfig/selinux を開きます。
  2. SELINUX=disabled または SELINUX=permissive を設定
  3. 編集内容を保存します。
  4. ノードを再起動します。
  5. 必要に応じて、Edge のインストール後にこの手順を繰り返して SELINUX=enabled を設定し、SELinux を再度有効にします。

前提条件: EPEL リポジトリを有効にする

Edge のインストールや更新、またはローカル リポジトリの作成を行うには、Extra Packages for Enterprise Linux（EPEL）を有効にする必要があります。使用するコマンドは、RedHat/CentOS のバージョンによって異なります。

• RedHat/CentOS/Oracle 7.x の場合:

  wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
  sudo rpm -ivh epel-release-latest-7.noarch.rpm

• RedHat/CentOS/Oracle 6.x の場合:

  wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm
  sudo rpm -ivh epel-release-latest-6.noarch.rpm

前提条件: RedHat 7.4 および CentOS 7.4 で libdb4 ライブラリのバージョンを確認する

RedHat 7.4 と CentOS 7.4 では、インストールする前に libdb4 RPM のバージョンを確認します。Edge にはバージョン 4.8 が必要です。RedHat 7.4 と CentOS 7.4 の一部のバージョンでは新しいバージョンが付属しています。これより新しいバージョンがある場合は、アンインストールします。これにより、Edge インストーラによってバージョン 4.8 がインストールされます。

次のコマンドでバージョンを確認できます。

rpm -qa | grep libdb4

libdb4 RPM バージョンがバージョン 4.8 より新しい場合は、アンインストールします。

外部インターネット接続があるノードに Edge apigee-setup ユーティリティをインストールする

外部インターネット接続があるノードに Edge をインストールするには:

1. Apigee リポジトリへのアクセスに使用する Apigee からユーザー名とパスワードを取得します。Apigee の FTP サイト用の既存の username:password がある場合は、その認証情報を使用できます。
2. ノードに root としてログインし、Edge RPM をインストールします。
   
3. yum-utils と yum-plugin-priorities をインストールします。

   sudo yum install yum-utils
   sudo yum install yum-plugin-priorities

4. 上記のように SELinux を無効にします。
5. 上記のように EPEL リポジトリを有効にします。
6. 上記の手順に沿って libdb4 のバージョンを確認します。
7. Oracle 7.x にインストールする場合は、次のコマンドを実行します。

   sudo yum-config-manager --enable ol7_optional_latest

8. AWS にインストールする場合は、次の yum-configure-manager コマンドを実行します。

   yum update rh-amazon-rhui-client.noarch
   sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

9. Edge 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

10. Edge apigee-service ユーティリティと依存関係をインストールします。

    sudo bash /tmp/bootstrap_4.19.01.sh apigeeuser=uName apigeepassword=pWord

    ここで、uName:pWord は Apigee から受け取ったユーザー名とパスワードです。pWord を省略すると、入力するように求められます。

    デフォルトでは、Java 1.8 がインストールされているかどうかが確認されます。インストールされていない場合は、自動的にインストールされます。Java のインストールの処理方法を指定するには、JAVA_FIX オプションを使用します。JAVA_FIX は、以下の値を取ります。

    • I: OpenJDK 1.8 をインストールする（デフォルト）
    • C: Java をインストールせずに続行する
    • Q: 終了します。このオプションでは、Java をユーザー自身でインストールする必要があります。

    apigee-service ユーティリティをインストールすると、Apigee リポジトリを定義する /etc/yum.repos.d/apigee.repo ファイルが作成されます。定義ファイルを表示するには、次のコマンドを使用します。

    cat /etc/yum.repos.d/apigee.repo

    リポジトリの内容を表示するには、次のコマンドを使用します。

    sudo yum -v repolist 'apigee*'

11. apigee-service を使用して、apigee-setup ユーティリティをインストールします。
    

    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

12. apigee-setup を使用して、ノードに Edge コンポーネントをインストールして構成します。詳細については、ノードに Edge コンポーネントをインストールするをご覧ください。

外部インターネット接続がないノードに Edge apigee-setup ユーティリティをインストールする

Edge ノードがファイアウォールの内側にあるか、なんらかの方法でインターネットへのアクセスが禁止されている場合は、インストール時に必要なファイルを含む複数のリポジトリ（ミラー）を作成する必要があります。これらのミラーは、すべてのノードからアクセスできる必要があります。作成したノードは、ローカル ミラーにアクセスして Edge をインストールできます。

インターネットに接続していないノードに対する Apigee Edge のインストール プロセスでは、次のローカル リポジトリにアクセスする必要があります。

• Apigee Edge リポジトリ: ローカルに Apigee リポジトリを作成するの説明に従ってください。
• Yum リポジトリ（yum-utils や yum-plugin-priorities などのユーティリティ用）: これは運用チームが設定てくれます。
• Extra Packages for Enterprise Linux（EPEL）: 運用チームがこれをセットアップします。

ローカルに Apigee リポジトリを作成する

内部 Apigee リポジトリを作成するには、Edge RPM と依存関係をダウンロードできるように、外部のインターネットにアクセスできるノードが必要です。内部リポジトリを作成したら、そのリポジトリを別のノードに移動できます。また、そのノードから Edge ノードにアクセスしてインストールすることもできます。

ローカルに Apigee リポジトリを作成した後、最新の Edge リリース ファイルでの更新が必要になることがあります。以降のセクションでは、ローカルに Apigee リポジトリを作成する方法と、リポジトリを更新する方法について説明します。

ローカルに Apigee リポジトリを作成するには:

1. Apigee リポジトリへのアクセスに使用する Apigee からユーザー名とパスワードを取得します。Apigee の FTP サイト用のユーザー名とパスワードがすでにある場合は、その認証情報を使用できます。
2. ノードに root としてログインし、Edge RPM をインストールします。
   
3. 上記のように SELinux を無効にします。
4. Edge 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

5. Edge apigee-service ユーティリティと依存関係をインストールします。
   

   sudo bash /tmp/bootstrap_4.19.01.sh apigeeuser=uName apigeepassword=pWord

   ここで、uName:pWord は Apigee から受け取ったユーザー名とパスワードです。pWord を省略すると、入力するように求められます。

6. apigee-mirror ユーティリティをノードにインストールします。

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install

7. apigee-mirror ユーティリティを使用して、Apigee リポジトリを /opt/apigee/data/apigee-mirror/repos/ ディレクトリに同期します。

   リポジトリのサイズを最小限に抑えるには、--only-new-rpms を指定して最新の RPM のみをダウンロードします。ダウンロードには約 1.6 GB のディスク容量が必要です。

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

   古い RPM を含むリポジトリ全体をダウンロードする場合は、--only-new-rpms を省略します。完全にダウンロードするには、約 6 GB のディスク容量が必要です。

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

   これで、Apigee リポジトリのローカルコピーが作成されます。次のセクションでは、ローカル リポジトリから Edge apigee-setup ユーティリティをインストールする方法について説明します。

8. （省略可）ローカル リポジトリから、ローカル リポジトリをホストするのと同じノードに Edge をインストールする場合は、最初に次のコマンドを実行する必要があります。
   1. ローカル リポジトリから bootstrap_4.19.01.sh を実行して、apigee-service ユーティリティをインストールします。

      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.19.01.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos

   2. apigee-service を使用して apigee-setup ユーティリティをインストールします。

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

   3. apigee-setup を使用して、ノードに Edge コンポーネントをインストールして構成します。詳細については、ノードに Edge コンポーネントをインストールするをご覧ください。

ローカル リポジトリからリモートノードに apigee-setup をインストールする

ローカル リポジトリから Edge をインストールする方法は 2 つあります。次のいずれかの方法でご対応ください。

• リポジトリの .tar ファイルを作成し、その .tar ファイルをノードにコピーして、.tar ファイルから Edge をインストールします。
• ローカル リポジトリを持つノードにウェブサーバーをインストールし、他のノードからアクセスできるようにします。Apigee から提供されているウェブサーバーは Nginx ですが、他のウェブサーバーを使用してもかまいません。

.tar ファイルからインストールする

.tar ファイルからインストールするには:

1. ローカル リポジトリがあるノードで、次のコマンドを使用して、ローカル リポジトリを /opt/apigee/data/apigee-mirror/apigee-4.19.01.tar.gz という名前の単一の .tar ファイルにパッケージ化します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

2. Edge をインストールするノードに .tar ファイルをコピーします。たとえば、新しいノードの /tmp ディレクトリにコピーします。
3. 新しいノードで、上記のように SELinux を無効にします。
4. 新しいノードで、ローカルの Yum ユーティリティ リポジトリと EPEL リポジトリにアクセスできることを確認します。
5. すべての外部インターネット リポジトリが無効になっていることを再確認します（インターネットにアクセスできないマシンにインストールしているため、このような状況が該当します）。

   sudo yum repolist

   すべての外部リポジトリを無効にする必要がありますが、ローカルの Apigee リポジトリと内部リポジトリは有効にする必要があります。

6. 新しいノードで、ローカル リポジトリ

   sudo yum install yum-utils
   sudo yum install yum-plugin-priorities

   から yum-utils と yum-plugin-priorities をインストールします。

   Yum ツールをインストールできるように、運用チームまたは組織内の他のグループがローカル リポジトリを設定する必要があります。

7. 新しいノードで、上記のように libdb4 のバージョンを確認します。
8. Oracle 7.x にインストールする場合は、次のコマンドを実行します。

   sudo yum-config-manager --enable ol7_optional_latest

9. AWS にインストールする場合は、次の yum-configure-manager コマンドを実行します。

   sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

10. 新しいノードで、/tmp ディレクトリに tar ファイルを解凍します。

    tar -xzf apigee-4.19.01.tar.gz

    このコマンドにより、.tar ファイルを含むディレクトリに repos という新しいディレクトリが作成されます。たとえば、/tmp/repos. です。

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

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

    コマンドに repos ディレクトリへのパスが含まれている点に注意してください。

12. apigee-service を使用して apigee-setup ユーティリティをインストールします。

    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

13. apigee-setup を使用して、ノードに Edge コンポーネントをインストールして構成します。詳細については、ノードに Edge コンポーネントをインストールするをご覧ください。

Nginx ウェブサーバーを使用してリポジトリからインストールする

Nginx ウェブサーバーを使用してリポジトリからインストールするには:

1. リポジトリ ノードに Nginx ウェブサーバーをインストールします。
   

   opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig

2. デフォルトでは、Nginx は localhost というサーバー名とポート 3939 を使用するように構成されます。この値を変更するには、次の手順に従います。
   1. エディタで /opt/apigee/customer/application/mirror.properties を開きます。ファイルが存在しない場合は作成します。
   2. 必要に応じて次の値を設定します。

      conf_apigee_mirror_listen_port=3939
      conf_apigee_mirror_server_name=localhost

   3. Nginx を再起動します。

      /opt/nginx/scripts/apigee-nginx restart

3. デフォルトでは、リポジトリに admin:admin のユーザー名とパスワードが必要です。これらの認証情報を変更するには、次の環境変数を設定します。

   MIRROR_USERNAME=uName
   MIRROR_PASSWORD=pWord

4. 新しいノードで、yum-utils と yum-plugin-priorities をインストールします。

   sudo yum install yum-utils
   sudo yum install yum-plugin-priorities

5. 新しいノードで、上記のように SELinux を無効にします。
6. 新しいノードで、ローカルの EPEL リポジトリが有効になっていることを確認します。
7. 新しいノードで、上記のように libdb4 のバージョンを確認します。
8. リモートノードで、Edge bootstrap_4.19.01.sh ファイルを /tmp/bootstrap_4.19.01.sh にダウンロードします。

   curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh

   ここで、uName:pWord は、先ほどリポジトリに設定したユーザー名とパスワードです。remoteRepo は、リポジトリ ノードの IP アドレスまたは DNS 名です。

9. リモートノードで、Edge apigee-service ユーティリティと依存関係をインストールします。

   sudo bash /tmp/bootstrap_4.19.01.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 install

11. apigee-setup を使用して、リモートノードに Edge コンポーネントをインストールして構成します。詳細については、ノードに Edge コンポーネントをインストールするをご覧ください。

ローカルの Apigee リポジトリを更新する

リポジトリを更新するには、最新の bootstrap_4.19.01.sh ファイルをダウンロードしてから、新たに同期を行う必要があります。

リポジトリを更新するには:

1. Edge 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

2. Edge bootstrap_4.19.01.sh ファイルを実行します。

   sudo bash/tmp/bootstrap_4.19.01.sh apigeeuser=uName apigeepassword=pWord

   ここで、uName:pWord は Apigee から受け取ったユーザー名とパスワードです。pWord を省略すると、入力するように求められます。

3. apigee-mirror を更新します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update

4. 同期を実行します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

5. リポジトリ全体が必要な場合:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

ローカルの Apigee リポジトリをクリーンアップする

ローカル リポジトリのクリーンアップを行うと、/opt/apigee/data/apigee-mirror と /var/tmp/yum-apigee-* が削除されます。

ローカル リポジトリをクリーンアップするには、次のコマンドを使用します。

/opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean

4.19.01 リポジトリで Edge 4.16.0x/4.17.0x を追加または更新する

4.19.01 リポジトリで Edge 4.16.0x または 4.17.0x のインストールを維持する必要がある場合は、すべてのバージョンを含むリポジトリを維持できます。そのリポジトリから、任意のバージョンの Edge をインストールできます。

4.19.01 リポジトリに 4.16.0x/4.17.0x を追加するには:

1. apigee-mirror ユーティリティのバージョン 4.19.01 がインストールされていることを確認します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version

   次のような結果が表示されます。ここで、xyz はビルド番号です。

   apigee-mirror-4.19.01-0.0.xyz

2. apigee-mirror ユーティリティを使用して、Edge 4.16.0x/4.17.0x をリポジトリにダウンロードします。コマンドの前に目的のバージョンを指定する方法（

   apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

   ）に注目してください。

   同じコマンドを使用して、後で必要なバージョン番号を指定して 4.16.0x/4.17.0x リポジトリを更新します。

3. /opt/apigee/data/apigee-mirror/repos ディレクトリを調べて、ファイル構造を確認します。

   ls /opt/apigee/data/apigee-mirror/repos

   次のファイルとディレクトリが表示されます。

   apigee
   apigee-repo-1.0-6.x86_64.rpm
   bootstrap_4.16.01.sh
   bootstrap_4.16.05.sh
   bootstrap_4.17.01.sh
   bootstrap_4.17.05.sh
   bootstrap_4.17.09.sh
   bootstrap_4.18.01.sh
   bootstrap_4.18.05.sh
   bootstrap_4.19.01.sh
   thirdparty

   すべてのバージョンの Edge にブートストラップ ファイルがあることに注目してください。また、apigee ディレクトリには、Edge の各バージョンに対応する個別のディレクトリも含まれます。

4. リポジトリを .tar ファイルにパッケージ化するには、次のコマンドを使用します。
   

   apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

   このコマンドは、4.17.0x と 4.16.0x のすべてのリポジトリを同じ .tar ファイルにパッケージ化します。リポジトリの一部のみをパッケージ化することはできません。

ローカル リポジトリまたは .tar ファイルから Edge をインストールするには、次のいずれかのコマンドを使用して、正しい bootstrap ファイルを実行するだけです。この例では、Edge 4.17.01 をインストールします。

• .tar ファイルからインストールする場合は、次のようにしてリポジトリから正しいブートストラップ ファイルを実行します。
  

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

  インストールを完了させるには、上記の「.tar ファイルからインストールする」の残りの手順に従ってください。

• Nginx ウェブサーバーを使用してインストールする場合は、次のように、リポジトリから正しい bootstrap ファイルをダウンロードして実行します。

  /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
  sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

  インストールを完了させるには、上記の「Nginx ウェブサーバーを使用してリポジトリからインストールする」の残りの手順に従ってください。