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

Edge for Private Cloud バージョン 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 を無効にするか、permissive モードに設定する必要があります。必要に応じて、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 のインストール処理方法を指定するには、JAVA_FIX オプションを使用します。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. RedHat ノードまたは CentOS ノードに root としてログインし、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 ファイルを解凍します。
    > 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 のリポジトリ:3939/bootstrap_4.16.05.sh

  6. リモートノードに、Edge apigee-service ユーティリティと依存関係をインストールします。
    > sudo bash /tmp/bootstrap_4.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
    リポジトリ名: u
  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-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-repo4 version-1.0-6.x86_64.rpm

    また、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 をインストールするには、次のいずれかのコマンドを使用して、正しい bootstrap ファイルを実行するだけです。

  • .tar ファイルからインストールする場合は、次のリポジトリから適切なブートストラップ ファイルを実行します。
    > 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_apigee/apigee.0X.sh