Edge for Private Cloud バージョン 4.17.09
ノードに 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 オペレーティング システムの場合:
> sudo echo 0 > /selinux/enforce
Edge のインストール後に SELinux を再度有効にするには:
> sudo echo 1 > /selinux/enforce
- Linux 7.x オペレーティング システムの場合:
> sudo setenforce 0
Edge のインストール後に SELinux を再度有効にするには:
> sudo 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/Oracle 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/Oracle 6.x の場合:
> wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; sudo rpm -ivh epel-release-latest-6.noarch.rpm
前提条件: RedHat 7.4 および CentOS 7.4 で libdb4 ライブラリのバージョンを確認する
RedHat 7.4 と CentOS 7.4 では、インストールする前に libdb4
RPM のバージョンを確認します。Edge にはバージョン 4.8 が必要です。RedHat 7.4 と CentOS 7.4 の一部のバージョンでは新しいバージョンが付属しています。
次のコマンドでバージョンを確認できます。
> rpm -qa | grep libdb
libdb4
RPM バージョンがバージョン 4.8 以降の場合は、次のコマンドを使用して RPM を置き換えます。
> rpm -Uvh --oldpackage libdb4-cxx-4.8.30-13.el7.x86_64.rpm libdb4-4.8.30-13.el7.x86_64.rpm
RPM をダウンロードする必要がある場合は、以下から入手できます。
- http://dl.fedoraproject.org/pub/epel/7/x86_64/Packages/l/libdb4-cxx-4.8.30-13.el7.x86_64.rpm
- http://dl.fedoraproject.org/pub/epel/7/x86_64/Packages/l/libdb4-4.8.30-13.el7.x86_64.rpm
外部インターネット接続があるノードに Edge apigee-setup ユーティリティをインストールする
外部インターネット接続があるノードに Edge をインストールするには:
- Apigee リポジトリへのアクセスに使用する Apigee からユーザー名とパスワードを取得します。Apigee の FTP サイト用のユーザー名とパスワードがすでにある場合は、その認証情報を使用できます。
- ノードに root としてログインし、Edge RPM をインストールします。
yum-utils
とyum-plugin-priorities
をインストールします。> sudo yum install yum-utils > sudo yum install yum-plugin-priorities
- 上記のように SELinux を無効にします。
- 上記のように EPEL リポジトリを有効にします。
- AWS にインストールする場合は、次の
yum-configure-manager
コマンドを実行します。> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
- Edge
bootstrap_4.17.09.sh
ファイルを/tmp/bootstrap_4.17.09.sh
にダウンロードします。> curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
- Edge apigee-service ユーティリティと依存関係をインストールします。
> sudo bash /tmp/bootstrap_4.17.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 RPM と依存関係をダウンロードできるように、外部のインターネットにアクセスできるノードが必要です。内部リポジトリを作成したら、そのリポジトリを別のノードに移動できます。また、そのノードから Edge ノードにアクセスしてインストールすることもできます。
ローカルの Edge リポジトリを作成した後、最新の Edge リリース ファイルでリポジトリを更新する必要が生じることがあります。以降のセクションでは、ローカル リポジトリの作成方法と更新方法について説明します。
ローカルに Apigee リポジトリを作成する
ローカルに Apigee リポジトリを作成するには:
- Apigee リポジトリへのアクセスに使用する Apigee からユーザー名とパスワードを取得します。Apigee の FTP サイト用のユーザー名とパスワードがすでにある場合は、その認証情報を使用できます。
- ノードに root としてログインし、Edge RPM をインストールします。
yum-utils
とyum-plugin-priorities
をインストールします。> sudo yum install yum-utils > sudo yum install yum-plugin-priorities
- 上記のように SELinux を無効にします。
- 上記のように EPEL リポジトリを有効にします。
- AWS にインストールする場合は、次の
yum-configure-manager
コマンドを実行します。
> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
- Edge
bootstrap_4.17.09.sh
ファイルを/tmp/bootstrap_4.17.09.sh
にダウンロードします。> curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
- Edge
apigee-service
ユーティリティと依存関係をインストールします。> sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord
ここで、uName:pWord は Apigee から受け取ったユーザー名とパスワードです。pWord を省略すると、入力するように求められます。
apigee-mirror
ユーティリティをノードにインストールします。> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
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.09.sh
を実行して、apigee-service
ユーティリティをインストールします。> sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.17.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 コンポーネントをインストールするをご覧ください。
- ローカル リポジトリから
ローカル リポジトリからリモートノードに apigee-setup をインストールする
ローカル リポジトリから Edge をインストールする方法は 2 つあります。次のいずれかの方法でご対応ください。
- リポジトリの .tar ファイルを作成し、その .tar ファイルをノードにコピーして、.tar ファイルから Edge をインストールします。
- ローカル リポジトリを持つノードにウェブサーバーをインストールし、他のノードからアクセスできるようにします。Apigee から提供されているウェブサーバーは Nginx ですが、他のウェブサーバーを使用してもかまいません。
.tar ファイルからインストールします。
- ローカル リポジトリがあるノードで、次のコマンドを使用して、ローカル リポジトリを
/opt/apigee/data/apigee-mirror/apigee-4.17.09.tar.gz
という名前の単一の .tar ファイルにパッケージ化します。> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- Edge をインストールするノードに .tar ファイルをコピーします。たとえば、新しいノードの
/tmp
ディレクトリにコピーします。 yum-utils
とyum-plugin-priorities
をインストールします。> sudo yum install yum-utils > sudo yum install yum-plugin-priorities
- 新しいノードで、上記のように SELinux を無効にします。
- 上記のように EPEL リポジトリを有効にします。
- 新しいノードで、/tmp ディレクトリに tar ファイルを解凍します。
> tar -xzf apigee-4.17.09.tar.gz
このコマンドにより、.tar ファイルを含むディレクトリに repos という新しいディレクトリが作成されます。たとえば、
/tmp/repos.
です。 /tmp/repos
から Edge apigee-service ユーティリティと依存関係をインストールします。> sudo bash /tmp/repos/bootstrap_4.17.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
yum-utils
とyum-plugin-priorities
をインストールします。> sudo yum install yum-utils > sudo yum install yum-plugin-priorities
- 新しいノードで、上記のように SELinux を無効にします。
- 上記のように EPEL リポジトリを有効にします。
- リモートノードで、Edge bootstrap_4.17.09.sh ファイルを
/tmp/bootstrap_4.17.09.sh
にダウンロードします。> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
ここで、uName:pWord は、先ほどリポジトリに設定したユーザー名とパスワードです。remoteRepo は、リポジトリ ノードの IP アドレスまたは DNS 名です。
- リモートノードで、Edge
apigee-service
ユーティリティと依存関係をインストールします。> sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
ここで、uName:pWord はリポジトリのユーザー名とパスワードです。
- リモートノードで、
apigee-service
を使用してapigee-setup
ユーティリティをインストールします。> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
apigee-setup
を使用して、リモートノードに Edge コンポーネントをインストールして構成します。詳細については、ノードに Edge コンポーネントをインストールするをご覧ください。
ローカルの Apigee リポジトリを更新する
リポジトリを更新するには、最新の bootstrap_4.17.09.sh ファイルをダウンロードしてから、新たに同期を行う必要があります。
- Edge bootstrap_4.17.09.sh ファイルを
/tmp/bootstrap_4.17.09.sh
にダウンロードします。> curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
- Edge
bootstrap_4.17.09.sh
ファイルを実行します。> sudo bash /tmp/bootstrap_4.17.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.17.09 リポジトリで Edge 4.16.0x/4.17.0x を追加または更新する
4.17.09 リポジトリで Edge 4.16.0x または 4.17.01/4.17.05 のインストールを維持する必要がある場合は、すべてのバージョンを含むリポジトリを維持できます。そのリポジトリから、任意のバージョンの Edge をインストールできます。
4.17.09 リポジトリに 4.16.0x/4.17.0x を追加するには:
apigee-mirror
ユーティリティのバージョン 4.17.09 がインストールされていることを確認します。> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version
次のような結果が表示されます。ここで、xyz はビルド番号です。
apigee-mirror-4.17.09-0.0.xyz
apigee-mirror
ユーティリティを使用して、Edge 4.16.0x/4.17.01/4.17/05 をリポジトリにダウンロードします。コマンドの前に目的のバージョンを指定する方法(> apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
)に注目してください。後で同じコマンドを使用して、必要なバージョン番号を指定して 4.16.0x/4.17.05 リポジトリを更新します。
/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 bootstrap_4.17.01.sh bootstrap_4.17.05.sh bootstrap_4.17.09.sh thirdparty
すべてのバージョンの Edge にブートストラップ ファイルがあることに注目してください。また、
apigee
ディレクトリには、Edge の各バージョンに対応する個別のディレクトリも含まれます。- リポジトリを .tar ファイルにパッケージ化するには、次のコマンドを使用します。
> apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
このコマンドは、4.17.0x と 4.16.0x のすべてのリポジトリを同じ .tar ファイルにパッケージ化します。リポジトリの一部のみをパッケージ化することはできません。
ローカル リポジトリまたは .tar ファイルから Edge をインストールするには、次のいずれかのコマンドを使用して、正しい bootstrap ファイルを実行するだけです。この例では、Edge 4.17.01 をインストールします。
- .tar ファイルからインストールする場合は、次のようにリポジトリから正しいブートストラップ ファイルを実行します。
> sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
インストールを完了させるには、上記の「.tar ファイルからインストールする」の残りの手順に従ってください。
- Nginx ウェブサーバーを使用してインストールする場合は、次のように、リポジトリから正しい bootstrap ファイルをダウンロードして実行します。
> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh > sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
インストールを完了するには、上記の「Nginx ウェブサーバーを使用してリポジトリからインストールする」の残りの手順に従ってください。