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

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

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

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

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

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

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

Edge をインストールまたは更新する場合、またはローカル リポジトリを作成する場合は、Extra Packages for Enterprise Linux（EPEL）を有効にする必要があります。Red Hat Enterprise Linux（RHEL）9.x、Rocky Linux 9.x、または Oracle Linux 9.x の場合は、次のコマンドを実行します。

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

RHEL 9/Rocky 9/Oracle 9 の前提条件

Red Hat Enterprise Linux（RHEL）9、Rocky 9、または Oracle 9 を実行しているサーバーに Edge をインストールする場合は、インストールを行う前に次の手順を完了してください。

1. Extra Packages for Enterprise Linux（EPEL）を有効にします。

   sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm

2. Postgres と Nginx を無効にします。

   sudo dnf module disable postgresql
   sudo dnf module disable nginx

PostgreSQL と LDAP のインストール前の変更については、 PostgreSQL データベース のインストール前の要件 と SymasLDAP 2.6.10 のインストール前の変更をそれぞれご覧ください。

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

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

1. Apigee リポジトリへのアクセスに使用するユーザー名とパスワードを Apigee から取得します。 Apigee FTP サイトに既存の username:password がある場合は、その 認証情報を使用できます。
2. root としてノードにログインし、Edge RPM をインストールします。
   
3. SELinux を無効にします。
4. EPEL リポジトリを有効にします。
5. RHEL 9/Rocky 9/Oracle 9 にインストールする場合は、 RHEL 9/Rocky 9/Oracle 9 の前提条件の手順に沿って操作します。
6. Edge bootstrap_4.54.00.sh ファイルを /tmp/bootstrap_4.54.00.sh にダウンロードします。

   curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh

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

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

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

   Apigee Edge for Private Cloud 4.54.00 では、ノードに Java 17 と Java 21 の両方がインストールされているデュアル Java サポートが必要です。ブートストラップ スクリプトを実行する前に、Java 17 と Java 21 の両方をインストールする必要があります。インストーラは、両方の JDK バージョンがインストールされていることを確認するだけで、Java を自動的にインストールしません。

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

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

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

   sudo yum -v repolist 'apigee*'

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

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

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

トラブルシューティング

外部インターネット接続があるノードにインストールしようとすると、 次のいずれかまたは複数のエラーが発生することがあります。

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

bootstrap.sh: Error: Repo configuration failed

error: package package_name is not installed

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

nc -v software.apigee.com 443

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

telnet software.apigee.com 443

curl -i -u username:password https://software.apigee.com/apigee-repo.rpm

echo $http_proxy
echo $https_proxy

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

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

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

• Apigee Edge リポジトリ: ローカルに Apigee リポジトリを作成するで説明されているとおり。
• 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.54.00.sh ファイルを /tmp/bootstrap_4.54.00.sh にダウンロードします。

   curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh

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

   sudo bash /tmp/bootstrap_4.54.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 のみをダウンロードします。

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

      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.54.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 ファイルをノードにコピーして、 .tar ファイルから Edge をインストールします。
• ローカル リポジトリを持つノードにウェブサーバーをインストールし、他のノードからアクセスできるようにします。 Apigee から提供されているウェブサーバーは Nginx ですが、他のウェブサーバーを使用してもかまいません。

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

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

1. ローカル リポジトリがあるノードで、次のコマンドを使用して、ローカル リポジトリを /opt/apigee/data/apigee-mirror/apigee-4.54.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. apigee-service を使用して、apigee-setup ユーティリティをインストールします。

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

7. 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. 新しいノードで、EPEL リポジトリがローカルで有効になっていることを確認します。
5. 新しいノードで、上記の説明に従って libdb4 のバージョンを確認します。
6. リモートノードで、Edge apigee-service ユーティリティと依存関係をインストールします。

   sudo bash /tmp/bootstrap_4.54.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

   ここで、uName:pWord はリポジトリのユーザー名とパスワードです。

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

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

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

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

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

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

1. Edge bootstrap_4.54.00.sh ファイルを /tmp/bootstrap_4.54.00.sh にダウンロードします。

   curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh

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

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