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

Edge for Private Cloud v. 4.16.05

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

/opt/apigee のシンボリック リンクの作成

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

シンボリック リンクを作成する前に、まず「apigee」という名前のユーザーとグループを作成する必要があります。これは、Edge インストーラによって作成されたグループおよびユーザーと同じです。

シンボリック リンクを作成するには、bootstrap_4.16.05.sh ファイルをダウンロードする前に次の手順を行います。これらの手順はすべて root として実行する必要があります。

1. 「apigee」ユーザーとグループを作成します。
   > groupadd -r apigee
   > useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Apigee platform user" apigee
2. /opt/apigee から目的のインストール ルートへのシンボリック リンクを作成します。
   > ln -Ts /srv/myInstallDir /opt/apigee
   ここで、/srv/myInstallDir は Edge ファイルの目的の場所です。
3. インストール ルートとシンボリック リンクの所有権を「apigee」ユーザーに変更します。
   > chown -h apigee:apigee /srv/myInstallDir /opt/apigee

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

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

• 一時的に SELinux を permissive モードに設定するには、次のコマンドを実行します。
  1. Linux 6.x オペレーティング システムの場合:
     echo 0 > /selinux/enforce
     
     Edge のインストール後、SELinux を再度有効にするには、次のようにします。
     echo 1 > /selinux/enforce
  2. Linux 7.x オペレーティング システムの場合:
     setenforce 0
     
     Edge のインストール後、SELinux を再度有効にするには、次のようにします。
     setenforce 1
• SELinux を完全に無効にするか、permissive モードに設定するには、次のコマンドを実行します。
  1. エディタで /etc/sysconfig/selinux を開きます。
  2. SELINUX=disabled または SELINUX=permissive を設定します。
  3. 編集内容を保存します。
  4. ノードを再起動します。
  5. 必要に応じて、Edge のインストール後にこの手順を繰り返して SELINUX=enabled を設定し、SELinux を再度有効にします。

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

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

1. Apigee リポジトリへのアクセスに使用するユーザー名とパスワードを Apigee から取得します。Apigee FTP サイトの既存のユーザー名とパスワードがある場合は、それらの認証情報を使用できます。
2. root としてノードにログインし、Edge RPM をインストールします。
   注: RPM のインストールには root アクセスが必要ですが、Edge の構成は root アクセスなしで実行できます。
3. 上記の説明に沿って SELinux を無効にします。
4. Edge の bootstrap_4.16.05.sh ファイルを /tmp/bootstrap_4.16.05.sh にダウンロードします。
   > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
5. Edge apigee-service ユーティリティと依存関係をインストールします。
   > sudo bash /tmp/bootstrap_4.16.05.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*'
6. apigee-service を使用して apigee-setup ユーティリティをインストールします。
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
7. apigee-setup を使用して、ノードに Edge コンポーネントをインストールして構成します。詳細については、ノードに Edge コンポーネントをインストールするをご覧ください。

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

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

注: Apigee は、すべてのサードパーティ依存関係を公開リポジトリでホストしているわけではありません。これらの依存関係は、一般公開されているリポジトリからダウンロードしてインストールする必要があります。

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

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

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

1. Apigee リポジトリへのアクセスに使用するユーザー名とパスワードを Apigee から取得します。Apigee FTP サイトの既存のユーザー名とパスワードがある場合は、それらの認証情報を使用できます。
2. root として RedHat または CentOS ノードにログインし、Edge RPM をインストールします。
   注: RPM のインストールには root アクセス権が必要ですが、Edge の構成は root アクセス権がなくても実行できます。
3. 最新バージョンの yum-utils がインストールされていることを確認します。
   > sudo yum update yum-utils
4. 上記の説明に沿って SELinux を無効にします。
5. Edge の bootstrap_4.16.05.sh ファイルを /tmp/bootstrap_4.16.05.sh にダウンロードします。
   > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
6. Edge apigee-service ユーティリティと依存関係をインストールします。
   > sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
   
   ここで、uName:pWord は Apigee から受け取ったユーザー名とパスワードです。pWord を省略すると、入力を求められます。
7. ノードに apigee-mirror ユーティリティをインストールします。
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
8. 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 ユーティリティをインストールする方法について説明します。
9. （省略可）ローカル リポジトリをホストする同じノードにローカル リポジトリから Edge をインストールする場合は、まず次のコマンドを実行する必要があります。
   1. ローカル リポジトリから bootstrap_4.16.05.sh を実行して、apigee-service ユーティリティをインストールします。
      > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.16.05.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 ファイルからインストールする:

1. ローカル リポジトリがあるノードで、次のコマンドを使用して、ローカル リポジトリを /opt/apigee/data/apigee-mirror/apigee-4.16.05.tar.gz という名前の単一の.tar ファイルにパッケージ化します。
   
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
2. Edge をインストールする対象のノードに .tar ファイルをコピーします。たとえば、新しいノードの /tmp ディレクトリにコピーします。
3. 新しいノードで、前述のように SELinux を無効にします。
4. 新しいノードで、ファイルを /tmp ディレクトリに解凍します。
   > tar -xzf apigee-4.16.05.tar.gz
   
   このコマンドにより、.tar ファイルを含むディレクトリに repos という名前の新しいディレクトリが作成されます。（例: /tmp/repos）。
5. /tmp/repos から Edge apigee-service ユーティリティと依存関係をインストールします。
   > sudo bash /tmp/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
   
   コマンドに repos ディレクトリへのパスが含まれている点に注意してください。
6. apigee-service を使用して、apigee-setup ユーティリティをインストールします。
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
7. apigee-setup を使用して、ノードに Edge コンポーネントをインストールして構成します。詳細については、ノードに Edge コンポーネントをインストールするをご覧ください。

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. 新しいノードで、前述のように SELinux を無効にします。
5. リモートノードで、Edge bootstrap_4.16.05.sh ファイルを /tmp/bootstrap_4.16.05.sh にダウンロードします。
   > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
   
   ここで、uName:pWord は、上記でリポジトリに設定したユーザー名とパスワードです。remoteRepo は、リポジトリノードの IP アドレスまたは DNS 名です。
6. リモートノードで、Edge apigee-service ユーティリティと依存関係をインストールします。
   > sudo bash /tmp/bootstrap_4.16.05.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.16.05.sh ファイルをダウンロードしてから、新しい同期を実行する必要があります。

1. Edge bootstrap_4.16.05.sh ファイルを /tmp/bootstrap_4.16.05.sh にダウンロードします。
   > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
2. 同期を実行します。
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
3. リポジトリ全体をダウンロードする場合:
   > /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.16.05 リポジトリに Edge 4.16.01 を追加または更新する

Edge 4.16.05 と 4.16.01 の両方のインストールを維持する必要がある場合は、両方のバージョンを含むリポジトリを維持できます。そのリポジトリから、Edge 4.16.05 または 4.16.01 をインストールできます。

4.15.05 リポジトリに 4.16.01 を追加するには:

1. apigee-mirror ユーティリティの 4.16.05 バージョンがインストールされていることを確認します。
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version
   
   次のような形式の結果が表示されます。xyz はビルド番号です。
   apigee-mirror-4.16.05-0.0.xyz
2. apigee-mirror ユーティリティを使用して、Edge 4.16.01 をリポジトリにダウンロードします。コマンドの先頭に apigeereleasever=4.16.01 を追加します。
   > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
   
   後で 4.16.01 リポジトリを更新する場合も、同じコマンドを使用します。
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 thirdparty
   
   両方のバージョンの Edge にブートストラップ ファイルがあることに注目してください。apigee ディレクトリには、Edge のバージョンごとに個別のディレクトリも含まれています。
4. リポジトリを .tar ファイルにパッケージ化するには、次のコマンドを使用します。
   > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
   
   このコマンドは、4.16.05 と 4.16.01 の両方のリポジトリを同じ .tar ファイルにパッケージ化します。リポジトリの一部のみをパッケージ化することはできません。

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

• .tar ファイルからインストールする場合は、リポジトリから正しい bootstrap ファイルを実行します。
  > sudo bash /tmp/repos/bootstrap_4.16.0X.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  インストールを完了させるには、上記の「.tar ファイルからインストールする」の残りの手順に従ってください。
• Nginx ウェブサーバーを使用してインストールする場合は、次のようにして、リポジトリから正しい bootstrap ファイルをダウンロードしてインストールします。
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.0X.sh -o /tmp/bootstrap_4.16.0X.sh
  > sudo bash /tmp/bootstrap_4.16.0X.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  
  インストールを完了させるには、上記の「Nginx ウェブサーバーを使用してリポジトリからインストールする」の残りの手順に従ってください。