Edge for Private Cloud バージョン 4.17.01
ノードに Edge をインストールするには、まず Edge apigee-setup ユーティリティをインストールします。ノードに外部インターネット接続がない場合は、Apigee リポジトリのローカルコピーもインストールする必要があります。
デフォルトのインストール ディレクトリ: /opt/apigee
Edge では、すべてのファイルが /opt/apigee ディレクトリにインストールされます。このディレクトリは変更できません。ただし、必要に応じて、/opt/apigee を別の場所にマッピングするシンボリック リンクを作成できます。詳細については、インストール要件をご覧ください。
前提条件: SELinux を無効にする
Edge apigee-setup ユーティリティまたは Edge コンポーネントをインストールする前に、SELinux を無効にするか、permissive モードに設定する必要があります。必要に応じて、Edge のインストール後に SELinux を再度有効にすることができます。
- 一時的に SELinux を permissive モードに設定するには、次のコマンドを実行します。
- Linux 6.x オペレーティング システムの場合:
echo 0 > /selinux/enforce
Edge のインストール後に SELinux を再度有効にするには:
echo 1 > /selinux/enforce - Linux 7.x オペレーティング システムの場合:
setenforce 0
Edge のインストール後に SELinux を再度有効にするには、次のようにします。
setenforce 1
- Linux 6.x オペレーティング システムの場合:
- SELinux を完全に無効にするか、permissive モードに設定するには:
- エディタで /etc/sysconfig/selinux を開きます。
- SELINUX=disabled または SELINUX=permissive に設定する
- 編集内容を保存します。
- ノードを再起動します。
- 必要に応じて、Edge のインストール後にこの手順を繰り返して SELINUX=enabled に設定し、SELinux を再度有効にします。
前提条件: EPEL リポジトリを有効にする
Edge をインストールまたは更新するには、Extra Packages for Enterprise Linux(EPEL)を有効にする必要があります。使用するコマンドは、RedHat/CentOS のバージョンによって異なります。
- RedHat/CentOS 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 6.x の場合:
> wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; sudo rpm -ivh epel-release-latest-6.noarch.rpm
外部インターネット接続があるノードに Edge apigee-setup ユーティリティをインストールする
外部インターネット接続があるノードに Edge をインストールするには:
- Apigee リポジトリへのアクセスに使用する Apigee からユーザー名とパスワードを取得します。Apigee の FTP サイト用のユーザー名とパスワードがすでにある場合は、その認証情報を使用できます。
- ノードに root としてログインし、Edge RPM をインストールします。
注: RPM のインストールには root 権限が必要ですが、Edge の構成には root 権限は不要です。 - 上記のように SELinux を無効にします。
- 上記のように EPEL リポジトリを有効にします。
- Edge の bootstrap_4.17.01.sh ファイルを /tmp/bootstrap_4.17.01.sh にダウンロードします。
> curl https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh - Edge apigee-service ユーティリティと依存関係をインストールします。
> sudo bash /tmp/bootstrap_4.17.01.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*' - (CentOS-6.x と RedHat-6.x のみ) すべての Qpid ノードで次のコマンドを実行して、正しい Qpid バージョンをダウンロードします。
> yum install apigee-qpidd --disablerepo=epel - apigee-service を使用して apigee-setup ユーティリティをインストールします。
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install - apigee-setup を使用して、ノードに Edge コンポーネントをインストールして構成します。詳細については、ノードに Edge コンポーネントをインストールするをご覧ください。
外部インターネット接続がないノードに Edge apigee-setup ユーティリティをインストールする
Edge ノードがファイアウォールの内側にあるか、インターネット経由での Apigee リポジトリ アクセスが禁止されている場合は、Apigee リポジトリのローカル リポジトリ(ミラー)を作成する必要があります。そのミラーはすべてのノードからアクセスできる必要があります。作成されたノードは、そのローカル ミラーにアクセスして Edge をインストールできます。
内部 Apigee リポジトリを作成するには、Edge RPM と依存関係をダウンロードできるように、外部のインターネットにアクセスできるノードが必要です。内部リポジトリを作成したら、そのリポジトリを別のノードに移動できます。また、そのノードから Edge ノードにアクセスしてインストールすることもできます。
注: Apigee は、公開リポジトリでサードパーティの依存関係をすべてホストしているわけではありません。これらの依存関係は、一般公開されているリポジトリからダウンロードしてインストールする必要があります。
ローカルの Edge リポジトリを作成した後、最新の Edge リリース ファイルでリポジトリを更新する必要が生じることがあります。以降のセクションでは、ローカル リポジトリの作成方法と更新方法について説明します。
ローカルに Apigee リポジトリを作成する
ローカルに Apigee リポジトリを作成するには:
- Apigee リポジトリへのアクセスに使用する Apigee からユーザー名とパスワードを取得します。Apigee の FTP サイト用のユーザー名とパスワードがすでにある場合は、その認証情報を使用できます。
- RedHat ノードまたは CentOS ノードに root としてログインし、Edge RPM をインストールします。
注: RPM のインストールには root 権限が必要ですが、Edge の構成には root 権限は不要です。 - yum-utils が最新バージョンであることを確認します。
> sudo yum update yum-utils - 上記のように SELinux を無効にします。
- 上記のように EPEL リポジトリを有効にします。
- Edge の bootstrap_4.17.01.sh ファイルを /tmp/bootstrap_4.17.01.sh にダウンロードします。
> curl https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh - (CentOS-6.x と RedHat-6.x のみ) 次のコマンドを実行して、正しい Qpid バージョンをダウンロードします。
> yum install apigee-qpidd --disablerepo=epel - Edge apigee-service ユーティリティと依存関係をインストールします。
> sudo bash /tmp/bootstrap_4.17.01.sh apigeeuser=uName apigeepassword=pWord
ここで、uName:pWord は Apigee から受け取ったユーザー名とパスワードです。pWord を省略した場合は、入力するように求められます。 - apigee-mirror ユーティリティをノードにインストールします。
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
注: 既存のリポジトリを 4.17.01 に更新する場合は、次のように apigee-mirror を更新するだけで済みます。
> /opt/apigee/apigee-service/bin/apigee-service - 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 をインストールする場合は、最初に次のコマンドを実行する必要があります。
- ローカル リポジトリから bootstrap_4.17.01.sh を実行し、apigee-service ユーティリティをインストールします。
> sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos - apigee-service を使用して、apigee-setup ユーティリティをインストールします。
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install - apigee-setup を使用して、ノードに Edge コンポーネントをインストールして構成します。詳細については、ノードに Edge コンポーネントをインストールするをご覧ください。
- ローカル リポジトリから bootstrap_4.17.01.sh を実行し、apigee-service ユーティリティをインストールします。
ローカル リポジトリからリモートノードに apigee-setup をインストールする
ローカル リポジトリから Edge をインストールする方法は 2 つあります。次のいずれかの方法でご対応ください。
- リポジトリの .tar ファイルを作成し、その .tar ファイルをノードにコピーして、.tar ファイルから Edge をインストールします。
- ローカル リポジトリを持つノードにウェブサーバーをインストールし、他のノードからアクセスできるようにします。Apigee から提供されているウェブサーバーは Nginx ですが、他のウェブサーバーを使用してもかまいません。
.tar ファイルからインストールします。
- ローカル リポジトリがあるノードで、次のコマンドを使用して、ローカル リポジトリを /opt/apigee/data/apigee-mirror/apigee-4.17.01.tar.gz という名前の単一の.tar ファイルにパッケージ化します。
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package - Edge をインストールするノードに .tar ファイルをコピーします。たとえば、新しいノードの /tmp ディレクトリにコピーします。
- 新しいノードで、上記のように SELinux を無効にします。
- 新しいノードで、/tmp ディレクトリに tar ファイルを解凍します。
> tar -xzf apigee-4.17.01.tar.gz
このコマンドは、.tar ファイルを含むディレクトリに repos という新しいディレクトリを作成します。(例: /tmp/repos)。 - /tmp/repos から Edge apigee-service ユーティリティと依存関係をインストールします。
> sudo bash /tmp/repos/bootstrap_4.17.01.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 ウェブサーバーをインストールします。
> opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig - デフォルトでは、Nginx は localhost というサーバー名とポート 3939 を使用するように構成されます。この値を変更するには、次の手順に従います。
- エディタで /opt/apigee/customer/application/mirror.properties を開きます。ファイルが存在しない場合は作成します。
- 必要に応じて次の値を設定します。
conf_apigee_mirror_listen_port=3939
conf_apigee_mirror_server_name=localhost - Nginx を再起動します。
> /opt/nginx/scripts/apigee-nginx restart
- デフォルトでは、リポジトリに admin:admin のユーザー名とパスワードが必要です。これらの認証情報を変更するには、次の環境変数を設定します。
MIRROR_USERNAME=uName
MIRROR_PASSWORD=pWord - 新しいノードで、上記のように SELinux を無効にします。
- リモートノードで、Edge bootstrap_4.17.01.sh ファイルを /tmp/bootstrap_4.17.01.sh にダウンロードします。
> /usr/bin/curl http://uName:pWord@remoteRepo1: repo.Repo/remote_rap_4.17.01.sh. - リモートノードに、Edge apigee-service ユーティリティと依存関係をインストールします。
> sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://pWord
repo : ユーザー名 - リモートノードで、apigee-service を使用して apigee-setup ユーティリティをインストールします。
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install - apigee-setup を使用して、リモートノードに Edge コンポーネントをインストールして構成します。詳細については、ノードに Edge コンポーネントをインストールするをご覧ください。
ローカルの Apigee リポジトリを更新する
リポジトリを更新するには、最新の bootstrap_4.17.01.sh ファイルをダウンロードしてから、新たに同期を行う必要があります。
- Edge bootstrap_4.17.01.sh ファイルを /tmp/bootstrap_4.17.01.sh にダウンロードします。
> curl https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh - Edge の bootstrap_4.17.01.sh ファイルを実行します。
> sudo bash /tmp/bootstrap_4.17.01.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.17.01 リポジトリで Edge 4.16.01/4.16.05/4.16.09 を追加または更新する
Edge 4.16.0x のインストールを 4.17.01 リポジトリに維持する必要がある場合は、すべてのバージョンを含むリポジトリを維持できます。そのリポジトリから、任意のバージョンの Edge をインストールできます。
4.17.01 リポジトリに 4.16.0x を追加するには:
- apigee-mirror ユーティリティのバージョン 4.17.01 がインストールされていることを確認します。
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version
次のような結果が表示されます。ここで、xyz はビルド番号です。
apigee-mirror-4.17.01- - apigee-mirror ユーティリティを使用して、Edge 4.16.01/4.16.05/4.16.09 をリポジトリにダウンロードします。コマンドの前に apigeereleasever=4.16.01 または apigeereleasever=4.16.05 という接頭辞を付ける方法に注目してください。
> apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
repo.9.16 でこれと同じコマンドを使用して、version.9 の番号を後で更新する必要があります。 - /opt/apigee/data/apigee-mirror/repos ディレクトリを調べて、ファイル構造を確認します。
> ls /opt/apigee/data/apigee-mirror/repos
次のファイルとディレクトリが表示されます。
apigee apigee-repo-1.0-6.x86_64.rpm
また、apigee ディレクトリには、Edge の各バージョンに対応する個別のディレクトリも含まれています。 - リポジトリを .tar ファイルにパッケージ化するには、次のコマンドを使用します。
> apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
このコマンドは、4.17.01 と 4.16.0x の両方のリポジトリを同じ .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