Edge for Private Cloud バージョン 4.16.09
ノードに Edge をインストールするには、まず Edge apigee-setup ユーティリティをインストールします。ノードに外部インターネット接続がない場合は、Apigee リポジトリのローカルコピーもインストールする必要があります。
/opt/apigee のシンボリック リンクの作成
Edge では、すべてのファイルが /opt/apigee ディレクトリにインストールされます。このディレクトリは変更できません。ただし、必要に応じて、/opt/apigee を別の場所にマッピングするシンボリック リンクを作成できます。
シンボリック リンクを作成する前に、まず「apigee」という名前のユーザーとグループを作成する必要があります。これは、Edge インストーラが作成するグループとユーザーと同じです。
シンボリック リンクを作成するには、bootstrap_4.16.09.sh ファイルをダウンロードする前に次の手順を実施します。これらの手順はすべて、root ユーザーとして行う必要があります。
- 「apigee」ユーザーとグループを作成します。
> groupadd -r apigee
> useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Apigee platform user" apigee - /opt/apigee から、目的のインストール ルートへのシンボリック リンクを作成します。
> ln -Ts /srv/myInstallDir /opt/apigee
ここで、/srv/myInstallDir は、Edge ファイルの目的の場所です。 - インストール ルートとシンボリック リンクの所有権を「apigee」ユーザーに変更します。
> chown -h apigee:apigee /srv/myInstallDir /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 を再度有効にします。
外部インターネット接続があるノードに Edge apigee-setup ユーティリティをインストールする
外部インターネット接続があるノードに Edge をインストールするには:
- Apigee リポジトリへのアクセスに使用する Apigee からユーザー名とパスワードを取得します。Apigee の FTP サイト用のユーザー名とパスワードがすでにある場合は、その認証情報を使用できます。
- ノードに root としてログインし、Edge RPM をインストールします。
注: RPM のインストールには root 権限が必要ですが、Edge の構成には root 権限は不要です。 - 上記のように SELinux を無効にします。
- Edge の bootstrap_4.16.09.sh ファイルを /tmp/bootstrap_4.16.09.sh にダウンロードします。
> curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh - Edge apigee-service ユーティリティと依存関係をインストールします。
> sudo bash /tmp/bootstrap_4.16.09.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*' - 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 リポジトリを作成した後、最新の Edge リリース ファイルでリポジトリを更新する必要が生じることがあります。以降のセクションでは、ローカル リポジトリの作成方法と更新方法について説明します。
ローカルに Apigee リポジトリを作成する
ローカルに Apigee リポジトリを作成するには:
- Apigee リポジトリへのアクセスに使用する Apigee からユーザー名とパスワードを取得します。Apigee の FTP サイト用のユーザー名とパスワードがすでにある場合は、その認証情報を使用できます。
- RedHat ノードまたは CentOS ノードに root としてログインし、Edge RPM をインストールします。
注: RPM のインストールには root 権限が必要ですが、Edge の構成には root 権限は不要です。 - yum-utils が最新バージョンであることを確認します。
> sudo yum update yum-utils - 上記のように SELinux を無効にします。
- Edge の bootstrap_4.16.09.sh ファイルを /tmp/bootstrap_4.16.09.sh にダウンロードします。
> curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh - Edge の apigee-service ユーティリティと依存関係をインストールします。
> sudo bash /tmp/bootstrap_4.16.09.sh apigeeuser=uName apigeepassword=pWord
ここで、uName:pWord は Apigee から受け取ったユーザー名とパスワードです。pWord を省略した場合は、入力するように求められます。 - apigee-mirror ユーティリティをノードにインストールします。
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
注: 既存のリポジトリを 4.16.09 に更新する場合は、次のように 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.16.09.sh を実行し、apigee-service ユーティリティをインストールします。
> sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.16.09.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.16.09.sh を実行し、apigee-service ユーティリティをインストールします。
ローカル リポジトリからリモートノードに apigee-setup をインストールする
ローカル リポジトリから Edge をインストールする方法は 2 つあります。次のいずれかの方法でご対応ください。
- リポジトリの .tar ファイルを作成し、その .tar ファイルをノードにコピーして、.tar ファイルから Edge をインストールします。
- ローカル リポジトリを持つノードにウェブサーバーをインストールし、他のノードからアクセスできるようにします。Apigee から提供されているウェブサーバーは Nginx ですが、他のウェブサーバーを使用してもかまいません。
.tar ファイルからインストールします。
- ローカル リポジトリがあるノードで、次のコマンドを使用して、ローカル リポジトリを /opt/apigee/data/apigee-mirror/apigee-4.16.09.tar.gz という名前の単一の.tar ファイルにパッケージ化します。
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package - Edge をインストールするノードに .tar ファイルをコピーします。たとえば、新しいノードの /tmp ディレクトリにコピーします。
- 新しいノードで、上記のように SELinux を無効にします。
- 新しいノードで、/tmp ディレクトリに tar ファイルを解凍します。
> tar -xzf apigee-4.16.09.tar.gz
このコマンドは、.tar ファイルを含むディレクトリに repos という新しいディレクトリを作成します。(例: /tmp/repos)。 - /tmp/repos から Edge apigee-service ユーティリティと依存関係をインストールします。
> sudo bash /tmp/repos/bootstrap_4.16.09.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.16.09.sh ファイルを /tmp/bootstrap_4.16.09.sh にダウンロードします。
> /usr/bin/curl http://uName:pWord@remoteRepo: repo.repo/remote_rap_4.16.09.sh. - リモートノードに Edge apigee-service ユーティリティと依存関係をインストールします。
> sudo bash /tmp/bootstrap_4.16.09.sh apigeerepohost=remoteRepo: 3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://pWord
: ユーザー名:名前 ここで、u は uWord です。 - リモートノードで、apigee-service を使用して apigee-setup ユーティリティをインストールします。
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install - apigee-setup を使用して、リモートノードに Edge コンポーネントをインストールして構成します。詳細については、ノードに Edge コンポーネントをインストールするをご覧ください。
ローカルの Apigee リポジトリを更新する
リポジトリを更新するには、最新の bootstrap_4.16.09.sh ファイルをダウンロードしてから、新たに同期を行う必要があります。
- Edge bootstrap_4.16.09.sh ファイルを /tmp/bootstrap_4.16.09.sh にダウンロードします。
> curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh - Edge の bootstrap_4.16.09.sh ファイルを実行します。
> sudo bash /tmp/bootstrap_4.16.09.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.16.09 リポジトリで Edge 4.16.01/4.16.05 を追加または更新する
4.16.09 リポジトリで Edge 4.16.01 と 4.16.05 のインストールを維持する必要がある場合は、すべてのバージョンを含むリポジトリを維持できます。そのリポジトリから、任意のバージョンの Edge をインストールできます。
4.16.09 リポジトリに 4.16.01/4.16.05 を追加するには:
- apigee-mirror ユーティリティのバージョン 4.16.09 がインストールされていることを確認します。
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version
次のような結果が表示されます。xyz はビルド番号です。
apigee-mirror-4.16.09-xyz. - apigee-mirror ユーティリティを使用して、Edge 4.16.01 または 4.16.05 をリポジトリにダウンロードします。コマンドの前に 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
repo4.16 を後で更新する場合は、同じコマンドを使用します。 - /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.16.09 と 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