Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

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 モードに設定するには、次のコマンドを実行します。
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 をインストールするには:

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

NOTE: RPM のインストールには root アクセスが必要ですが、Edge の構成は root アクセスなしで実行できます。

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

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

上記の説明に沿って SELinux を無効にします。
前述のように EPEL リポジトリを有効にします。
上記の説明に沿って、libdb4 のバージョンを確認します。
Oracle 7.x にインストールする場合は、次のコマンドを実行します。
```
sudo yum-config-manager --enable ol7_optional_latest
```

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

Edge bootstrap_4.19.06.sh ファイルを /tmp/bootstrap_4.19.06.sh にダウンロードします。
```
curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
```
Edge apigee-service ユーティリティと依存関係をインストールします。
```
sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord
```
ここで、uName:pWord は Apigee から受け取ったユーザー名とパスワードです。pWord を省略すると、入力するよう求められます。

デフォルトでは、インストーラは Java 1.8 がインストールされていることを確認します。インストールされていない場合は自動的にインストールします。JAVA_FIX オプションを使用して、Java のインストールを処理する方法を指定します。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*'
```
apigee-service を使用して apigee-setup ユーティリティをインストールします。
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
```
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 Edge リポジトリ: ローカルの Apigee リポジトリを作成するの説明に沿って作成します。
Yum リポジトリ（yum-utils や yum-plugin-priorities などのユーティリティ用）: 運用チームが設定できます。
Extra Packages for Enterprise Linux（EPEL）: 運用チームがこれを設定できる必要があります。

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

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

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

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

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

NOTE: RPM のインストールには root アクセスが必要ですが、Edge の構成は root アクセスなしで実行できます。
上記の説明に沿って SELinux を無効にします。
Edge bootstrap_4.19.06.sh ファイルを /tmp/bootstrap_4.19.06.sh にダウンロードします。
```
curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
```
Edge apigee-service ユーティリティと依存関係をインストールします。
```
sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord
```
ここで、uName:pWord は Apigee から受け取ったユーザー名とパスワードです。pWord を省略すると、入力するよう求められます。
ノードに apigee-mirror ユーティリティをインストールします。
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
```
注: 既存のリポジトリを 4.19.06 に更新する場合は、apigee-mirror のみを更新する必要があります。
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
```
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 ユーティリティをインストールする方法について説明します。
（省略可）ローカルリポジトリをホストする同じノードにローカルリポジトリから Edge をインストールする場合は、まず次のコマンドを実行する必要があります。
1. ローカルリポジトリから bootstrap_4.19.06.sh を実行して、apigee-service ユーティリティをインストールします。
```
sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.19.06.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 ファイルからインストールするには:

ローカルリポジトリがあるノードで、次のコマンドを使用して、ローカルリポジトリを /opt/apigee/data/apigee-mirror/apigee-4.19.06.tar.gz という名前の単一の .tar ファイルにパッケージ化します。
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
```
Edge をインストールする対象のノードに .tar ファイルをコピーします。たとえば、新しいノードの /tmp ディレクトリにコピーします。
新しいノードで、前述のように SELinux を無効にします。
新しいノードで、ローカルの Yum ユーティリティリポジトリと EPEL リポジトリにアクセスできることを確認します。
すべての外部インターネットリポジトリが無効になっていることを再確認します（インターネットアクセスできないマシンにインストールしているため、無効になっているはずです）。
```
sudo yum repolist
```
すべての外部リポジトリを無効にし、ローカルの Apigee リポジトリと内部リポジトリを有効にする必要があります。
新しいノードで、ローカルリポジトリから yum-utils と yum-plugin-priorities をインストールします。
```
sudo yum install yum-utils
sudo yum install yum-plugin-priorities
```
Yum ツールをインストールできるように、組織内の運用チームまたは他のグループがローカルリポジトリを設定する必要があります。
新しいノードで、前述のように libdb4 のバージョンを確認します。
Oracle 7.x にインストールする場合は、次のコマンドを実行します。
```
sudo yum-config-manager --enable ol7_optional_latest
```
AWS にインストールする場合は、次の yum-configure-manager コマンドを実行します。
```
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
```
新しいノードで、ファイルを /tmp ディレクトリに解凍します。
```
tar -xzf apigee-4.19.06.tar.gz
```
このコマンドにより、.tar ファイルを含むディレクトリに repos という名前の新しいディレクトリが作成されます。たとえば、/tmp/repos. です。
/tmp/repos から Edge apigee-service ユーティリティと依存関係をインストールします。
```
sudo bash /tmp/repos/bootstrap_4.19.06.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
コマンドに repos ディレクトリへのパスが含まれている点に注意してください。
apigee-service を使用して apigee-setup ユーティリティをインストールします。
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
```
apigee-setup を使用して、ノードに Edge コンポーネントをインストールして構成します。詳細については、ノードに Edge コンポーネントをインストールするをご覧ください。

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

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

リポジトリが存在するノードに Nginx ウェブサーバーをインストールします。
```
opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
```
デフォルトで、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
```
デフォルトでは、リポジトリに admin:admin のユーザー名とパスワードが必要です。これらの認証情報を変更するには、次の環境変数を設定します。
```
MIRROR_USERNAME=uName
MIRROR_PASSWORD=pWord
```
新しいノードに yum-utils と yum-plugin-priorities をインストールします。
```
sudo yum install yum-utils
sudo yum install yum-plugin-priorities
```
新しいノードで、前述のように SELinux を無効にします。
新しいノードで、ローカル EPEL リポジトリが有効になっていることを確認します。
新しいノードで、前述のように libdb4 のバージョンを確認します。
リモートノードで、Edge bootstrap_4.19.06.sh ファイルを /tmp/bootstrap_4.19.06.sh にダウンロードします。
```
curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
```
ここで、uName:pWord は上記で設定したリポジトリのユーザー名とパスワード、remoteRepo はリポジトリノードの IP アドレスまたは DNS 名です。
リモートノードで、Edge apigee-service ユーティリティと依存関係をインストールします。
```
sudo bash /tmp/bootstrap_4.19.06.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 install
```
apigee-setup を使用して、リモートノードに Edge コンポーネントをインストールして構成します。詳細については、ノードに Edge コンポーネントをインストールするをご覧ください。

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

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

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

Edge bootstrap_4.19.06.sh ファイルを /tmp/bootstrap_4.19.06.sh にダウンロードします。
```
curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
```
Edge bootstrap_4.19.06.sh ファイルを実行します。
```
sudo bash/tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord
```
ここで、uName:pWord は Apigee から受け取ったユーザー名とパスワードです。pWord を省略すると、入力を求めるメッセージが表示されます。

apigee-mirror を更新します。

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

同期を実行します。

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

リポジトリ全体を対象とする場合:

/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.06 リポジトリに Edge 4.16.0x/4.17.0x を追加または更新する

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

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

apigee-mirror ユーティリティのバージョン 4.19.06 がインストールされていることを確認します。
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror version
```
次のような結果が表示されます。ここで、xyz はビルド番号です。
```
apigee-mirror-4.19.06-0.0.xyz
```
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 リポジトリを更新する場合も、必要なバージョン番号を指定して同じコマンドを使用します。
/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 のバージョンごとに個別のディレクトリも含まれています。
リポジトリを .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 ファイルからインストールする場合は、リポジトリから正しい bootstrap ファイルを実行します。
```
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 ウェブサーバーを使用してリポジトリからインストールする」の残りの手順に従ってください。