Orion のインストール
> :warning: orion を本番環境で実行する場合は、高可用性 およびパフォーマンス・チューニングに関する情報もお読みください。
イントロダクション
推奨される手順は、公式の Docker Hub の Orion docker コンテナ を使用してインストールすることです。
ただし、Docker 化されたインフラストラクチャがない場合は、インストールすることをお勧めします。 CentOS8.x で RPM パッケージを使用します。 ソースからのビルドに興味がある場合は、このドキュメントを確認してください。
要件
- システムリソース : これらの推奨事項を参照
- オペレーティング・システム : CentOS/RedHat。リファレンス・オペレーティング・システムは CentOS 8.3.2011 ですが、それ以降の CentOS/RedHat 8.x バージョンでも動作します
- データベース : MongoDB は、Orion Context Broker をインストールするホストと同じホストで実行するか、ネットワーク経由でアクセス可能な別のホストで実行する必要があります。推奨される MongoDB のバージョンは 4.4 です。古いバージョンでは動作しますが、推奨しません
- RPM の依存関係 (これらのパッケージのいくつかは、公式の CentOS/RedHat リポジトリにはありませんが、EPEL にあります。EPEL リポジトリを設定する必要があります。http://fedoraproject.org/wiki/EPEL を参照してください) :
- contextBroker パッケージ (必須) は次のパッケージに依存しています : libstdc++, boost-thread, boost-filesystem, gnutls, libgcrypt, libcurl, openssl, logrotate, libuuid
インストール
利用可能なパッケージは2つあります :
- Nightly, 毎晩マスター・ブランチからビルドされます
- Release, "official" リリースの RPM。通常のリリース期間は 1-2 ヶ月です
タイプ (nightly or release) によって、パッケージのバージョンが異なります :
- Release パッケージ : contextBroker-X.Y.Z-1
- Nightly パッケージ : contextBroker-X.Y.Z-yyyy.mm.dd
Nightly パッケージのバージョンは常にリリース前になりますので、Nightly パッケージはテスト目的でのみ使用することをお勧めします。
この点から、Nightly ビルドを使用する場合は、別のバージョンのシステムがあることに注意してください。
yum の使用 (推奨)
FIWARE yum リポジトリを設定します (この記事で説明します)。そして、root として、以下を実行します :
yum install contextBroker
上記のコマンドは、yum キャッシュのために失敗することがあります。その場合は、yum clean all
を実行して再試行してください。
RPM ファイルの使用
FIWARE Files area から直接パッケージをダウンロードします。両方のタイプのパッケージを提供しています。
次に、rpm コマンドを使用してパッケージをインストールします (root として) :
rpm -i contextBroker-X.Y.Z-1.x86_64.rpm
以前のバージョンからのアップグレード
アップグレード手順は、インストールされている Orion バージョンからアップグレードするための アップグレードパス が、必要なバージョン番号を超えているかどうかによって異なります :
- MongoDB バージョンのアップグレード
- DB に格納されたデータの移行 (DB データモデルの変更による)
DB に格納されたデータの移行
アップグレードパスが 0.14.1, 0.19.0, 0.21.0, 1.3.0, 1.5.0 または 2.2.0 を超えている場合にのみ注意が必要です。それ以外の場合は、このセクションをスキップできます。DB が重要ではない場合 (例えばデバッグ/テスト環境)、アップグレードする前に DB をフラッシュすることもできます
- pre-0.14.1 のバージョンから 0.14.1 以降にアップグレード
- pre-0.19.0 のバージョンから 0.19.0 以降にアップグレード
- pre-0.21.0 のバージョンから 0.21.0 以降にアップグレード
- pre-1.3.0 のバージョンから 1.3.0 以降にアップグレード
- pre-1.5.0 のバージョンから 1.5.0 以降にアップグレード
- pre-2.2.0 のバージョンから 2.2.0 以降にアップグレード
アップグレードが複数のセグメントをカバーしている場合 (たとえば、0.13.0 を使用していて、0.19.0 にアップグレードする場合は、"0.14.1 以前のバージョンから 0.14.1 以降にアップグレードする" と "0.19.0 より前のバージョンから 0.19.0 以降にアップグレードする" が適用されます)。セグメントを順番に実行する必要があります (共通部分は1回だけ行われます。例えば、CB の停止、パッケージの削除、パッケージのインストール、CB の開始)。疑問がある場合は、StackOverflow を使用 して質問してください。質問に "fiware-orion" タグを含めることを忘れないでください。
標準アップグレード
yum を使用している場合は、以下でアップグレードを実行できます (root として) :
yum install contextBroker
上記のコマンドは、yum キャッシュのために失敗することがあります。その場合は、yum clean all
を実行 して再試行してください。
RPM ファイルを使用してアップグレードする場合は、まず FIWARE yum repository から新しいパッケージをダウンロードしてください。両方のタイプのパッケージを提供しています。
rpm コマンドを使用してパッケージをアップグレードします (root として) :
rpm -U contextBroker-X.Y.Z-1.x86_64.rpm