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

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

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

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

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

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

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

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

      sudo setenforce 1
    • Linux 7.x オペレーティング システムの場合: 
      sudo setenforce 0

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

      sudo setenforce 1
    • Linux 6.x オペレーティング システムの場合: 
      sudo echo 0 > /selinux/enforce

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

      sudo echo 1 > /selinux/enforce
  • SELinux を完全に無効にするか、制限なしモードに設定するには:
    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 のバージョンによって異なります。

  • Red Hat Enterprise Linux（RHEL）8.0 の場合は、 RHEL 8 の前提条件をご覧ください。

  • Red Hat/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
  • Red Hat/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
  • AWS-2 の場合: 
    sudo amazon-linux-extras install epel -y
sudo yum-config-manager --enable epel

前提条件: 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 より後の場合はそれをアンインストールします。

RHEL 8 の前提条件

Red Hat Enterprise Linux（RHEL）8 を実行するサーバーに Edge をインストールする場合は、インストールの前に次の手順を行います。

  1. Extra Packages for Enterprise Linux（EPEL）を有効にします。 
    sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
  2. Postgres と NGINX を無効にします。 
    sudo dnf module disable postgresql
sudo dnf module disable nginx
  3. Python 2 をインストールし、シンボリック リンク 
    sudo dnf install -y python2
sudo ln -s /usr/bin/python2 /usr/bin/python
    を作成します。

外部インターネット接続があるノードに 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. RHEL 8 にインストールする場合は、RHEL 8 の前提条件の手順を行ってください。
  8. Oracle 7.x にインストールする場合は、次のコマンドを実行します。 
    sudo yum-config-manager --enable ol7_optional_latest
  9. 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
  10. Edge bootstrap_4.51.00.sh ファイルを /tmp/bootstrap_4.51.00.sh にダウンロードします。 
    curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
  11. Edge apigee-service ユーティリティと依存関係をインストールします。 
    sudo bash /tmp/bootstrap_4.51.00.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 ユーティリティをインストールすると、/etc/yum.repos.d/apigee.repo ファイルが作成され、Apigee リポジトリが定義されます。定義ファイルを表示するには、次のコマンドを使用します。

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

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

    sudo yum -v repolist 'apigee*'
  12. apigee-service を使用して apigee-setup ユーティリティをインストールします。
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  13. apigee-setup を使用して、ノードに Edge コンポーネントをインストールして構成します。詳細については、ノードに Edge コンポーネントをインストールするをご覧ください。

トラブルシューティング

外部インターネット接続があるノードにインストールしようとすると、次のエラーが発生する可能性があります。

Cannot open: https:// : @ software.apigee.com//apigee-repo-version.rpm

bootstrap.sh: Error: Repo configuration failed

error: package package_name is not installed

次の表に、これらのエラーの考えられる解決策を示します。

エラーの種類 考えられる解決策
パスワードに不正な文字が含まれています Apigee パスワードに特殊文字は使用しないでください。
接続に関する問題

次の ncat コマンドを実行して、ネットワーク接続をテストします。

nc -v software.apigee.com 443

次のようなメッセージが表示されます。

Connection to software.apigee.com 443 port [tcp/https] succeeded!

nc がインストールされていない場合は、次の telnet コマンドを実行します。

telnet software.apigee.com 443

コマンドが成功したら、Ctrl+C を使用して開いている接続を中止します。

いずれかのコマンドが失敗した場合、ネットワーク接続が制限されているか、接続されていません。ネットワーク管理者に確認してください。
認証情報が正しくない

ユーザー名とパスワードが正しいことを確認します。

たとえば、Apigee のユーザー名とパスワードで次のコマンドを試したときにエラーがないか確認します。

curl -i -u username:password https://software.apigee.com/apigee-repo.rpm
プロキシに関する問題 ローカル構成で下り（外向き）HTTP プロキシが使用されているが、同じ構成が yum パッケージ マネージャーに拡張されていない。環境変数を確認します。 
echo $http_proxy
echo $https_proxy

下り（外向き）HTTP プロキシの場合は、次のいずれかのオプションを使用します。

  • /etc/yum.conf で HTTP プロキシ構成を追加する
  • /etc/environment にグローバル HTTP プロキシ構成を追加する

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

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

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

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

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

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

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

  1. Apigee リポジトリへのアクセスに使用する Apigee のユーザー名とパスワードを取得します。Apigee の FTP サイト用のユーザー名とパスワードがすでにある場合は、その認証情報を使用できます。
  2. root としてノードにログインし、Edge RPM をインストールします。
  3. 前述のように SELinux を無効にします。
  4. Edge bootstrap_4.51.00.sh ファイルを /tmp/bootstrap_4.51.00.sh にダウンロードします。 
    curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
  5. Edge apigee-service ユーティリティと依存関係をインストールします。
    sudo bash /tmp/bootstrap_4.51.00.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.51.00.sh を実行して、apigee-service ユーティリティをインストールします。 
      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.51.00.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 ファイルから Edge をインストールします。
  • ローカル リポジトリを持つノードにウェブサーバーをインストールし、他のノードからアクセスできるようにします。Apigee から提供されているウェブサーバーは NGINX ですが、他のウェブサーバーを使用してもかまいません。

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

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

  1. ローカル リポジトリが存在するノードで次のコマンドを使用し、ローカル リポジトリを /opt/apigee/data/apigee-mirror/apigee-4.51.00.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. 新しいノードで、ローカル リポジトリから yum-utils と yum-plugin-priorities をインストールします。 
    sudo yum install yum-utils
sudo yum install 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. 新しいノードで、tar ファイルを解凍し、/tmp ディレクトリに展開します。 
    tar -xzf apigee-4.51.00.tar.gz

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

  11. /tmp/repos から Edge apigee-service ユーティリティと依存関係をインストールします。 
    sudo bash /tmp/repos/bootstrap_4.51.00.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.51.00.sh ファイルを /tmp/bootstrap_4.51.00.sh にダウンロードします。 
    curl http://uName:pWord@remoteRepo:3939/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh

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

  9. リモートノードで、Edge apigee-service ユーティリティと依存関係をインストールします。 
    sudo bash /tmp/bootstrap_4.51.00.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.51.00.sh ファイルをダウンロードしてから、新しい同期を実行する必要があります。

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

  1. Edge bootstrap_4.51.00.sh ファイルを /tmp/bootstrap_4.51.00.sh にダウンロードします。 
    curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
  2. Edge bootstrap_4.51.00.sh ファイルを実行します。 
    sudo bash/tmp/bootstrap_4.51.00.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.51.00 リポジトリで Edge 4.16.0x/4.17.0x を追加または更新する

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

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

  1. apigee-mirror ユーティリティのバージョン 4.51.00 がインストールされていることを次のように確認します。 
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version

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

    apigee-mirror-4.51.00-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 ファイルにパッケージ化されます。リポジトリの一部をパッケージ化することはできません。

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

  • .tar ファイルからインストールする場合は、次のコマンドで、リポジトリから正しいブートストラップ ファイルを実行します。
    sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

  • NGINX ウェブサーバーを使用してインストールする場合は、次のようにして、リポジトリから正しいブートストラップ ファイル（ 
    /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 ウェブサーバーを使用してリポジトリからインストールする」の残りの手順に従ってください。