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

Edge をノードにインストールするには、まず Edge apigee-setup ユーティリティをインストールします。対象が ノードが外部インターネット接続を利用できない環境では、Compute Engine の Apigee リポジトリのローカルコピーです。

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

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

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

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

  • SELinux を一時的に permissive モードに設定するには、次のコマンドを実行します。 command: <ph type="x-smartling-placeholder">
      </ph>
    • 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 を恒久的に無効にするか、permissive モードに設定するには: <ph type="x-smartling-placeholder">
      </ph>
    1. エディタで /etc/sysconfig/selinux を開きます。
    2. SELINUX=disabled または SELINUX=permissive を設定します。
    3. 編集内容を保存します。
    4. ノードを再起動します。
    5. 必要に応じて、Edge のインストール後にこの手順を繰り返して SELinux を再度有効にし、 SELINUX=enabled を設定します。

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

[Extra Packages for](追加パッケージ)を Enterprise Linux(EPEL)を使用して Edge をインストールまたは更新したり、ローカル リポジトリを作成したりできます。「 使用するコマンドは、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

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

RedHat 7.4 と CentOS 7.4 では、インストールする前に libdb4 RPM のバージョンを確認します。エッジ 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-utilsyum-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 は、送信元のユーザー名とパスワードです。 ApigeepWord を省略すると、入力を求められます。

    デフォルトでは、Java 1.8 がインストールされているかどうかが確認されます。そうでない場合、 自動的にインストールされます。JAVA_FIX オプションを使用して、処理方法を指定する Java のインストール。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 コンポーネントをインストールするをご覧ください。

トラブルシューティング

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

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 を実行して、ネットワーク接続をテストします。 command:

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 リポジトリを作成するには、外部インターネットを持つノードが必要です アクセスする必要があります。内部 IP アドレスを そのリポジトリを別のノードに移動したり、目的のために 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 は、送信元のユーザー名とパスワードです。 ApigeepWord を省略すると、入力を求められます。

  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 を含めて 確認できます。ダウンロードには約 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 をインストールする場合は、 作成するには、まず次のコマンドを実行する必要があります。 <ph type="x-smartling-placeholder">
      </ph>
    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 を .tar ファイルです。
  • ローカル リポジトリのあるノードにウェブサーバーをインストールし、他のノードがアクセスできるようにします。 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-utilsyum-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. 新しいノードで、ファイルを /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

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

  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 はサーバー名とポート 3939 として localhost を使用するように構成されています。宛先 次の値を変更します。 <ph type="x-smartling-placeholder">
      </ph>
    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-utilsyum-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 のインストールを維持する必要がある場合は、 すべてのバージョンを含むリポジトリを維持しますそのリポジトリから、任意のバージョンの VM を 。

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 ファイルにパッケージ化します。できないこと リポジトリの一部のみをパッケージ化できます。

ローカル リポジトリまたは .tar ファイルから Edge をインストールする場合は、必ず適切なブートストラップを実行してください。 アップロードできます。この例では、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://

    インストールを完了するには、「次を使用してリポジトリからインストールする」の残りの手順に沿って操作します。 ウェブサーバーをスキャンします」ご覧ください。