イントロダクション¶
このドキュメントでは、cygnus-ngsi エージェントのインストールおよび管理方法について詳しく説明します。
cygnus-ngsi は、構成された特定のサードパーティ製ストレージ内の永続的な Orion のコンテキストデータを管理し、そのようなデータの履歴ビューを作成するコネクタです。つまり、Orion はエンティティの属性に関する最後の値のみを格納します。古い値が必要な場合は、cygnus-ngsi を使用してサードパーティ製ストレージに値を渡して保持する必要があります。
cygnus-ngsi は Orion のサブスクリプション/通知機能を使用します。cygnus-ngsi に代わって Orion でサブスクリプションが行われ、これらのエンティティ属性のいずれかで更新が発生したときに通知を受けたいエンティティが詳述されています。
内部的には、cygnus-ngsi は Apache Flume をベースにしています。Apache Flume は cygnus-common を通して使用され、cygnus-ngsi はそれに依存します。実際、cygnus-ngsi は Flume エージェントであり、基本的にはデータを受け取るソース、Flume イベントに変換されたソースがデータを入れるチャネル、本体内のデータをサードパーティ製ストレージに保存するためにチャネルから Flume イベントを取得するシンクから構成されます。
現在の安定版リリースでは、Orion のコンテキストデータを次の場所に保持できます :
- HDFS, the Hadoop 分散ファイルシステム
- MySQL, よく知られているリレーショナルデータベースマネージャ
- CKAN, オープンデータプラットフォーム
- MongoDB, NoSQLドキュメント指向データベース
- STH Comet, MongoDBの上に構築された短期履歴データベースです
- Kafka, パブリック・サブスクライブ型メッセージブローカ
- DynamoDB, Amazon Web Services によるクラウドベースの NoSQL データベース
対象とする読者¶
このドキュメントは、すでに Orion Context Broker インスタンスを使用しており、Orion によって管理されているコンテキスト・データから履歴ビューを作成したい FIWARE ユーザを対象としています。この場合、cygnus-ngsi をインストールして管理する方法を学ぶためにこのドキュメントが必要になります。
cygnus-ngsi 用の新しいシンクを作成すること、または何らかの方法でそれを拡張することを目指している場合は、"ユーザ＆プログラマ・ガイド"を参照してください。
ドキュメントの構造¶
このイントロダクションとは別に、この"インストール＆管理ガイド"には主に cygnus-ngsi のインストール、設定、実行、テストに関するセクションが含まれています。FIWARE ユーザは、マルチテナントまたはパフォーマンスのヒントに関する有益な情報も確認します。さらに、インストールが成功したかどうかを知るのに役立つサニティチェック手順と、問題が発生したときに役立つようにするための診断手順も用意されています。
このドキュメントで扱われていないトピックについては、cygnus-common の関連するセクションが適用されることに注意することは非常に重要です。具体的には :
- ハードウェア要件
- Flume 環境設定
- log4j 構成
- プロセスとして実行
- 管理インターフェイス
- ログとアラーム